source: clfs-embedded/BOOK/final-system/common/busybox.xml @ 0ed1461

Last change on this file since 0ed1461 was 0ed1461, checked in by Joe Ciccone <jciccone@…>, 12 years ago

Correct the path to cross-tools when copying depmod.pl.

  • Property mode set to 100644
File size: 4.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-busybox" role="wrap">
9  <?dbhtml filename="busybox.html"?>
10
11  <title>Busybox-&busybox-version;</title>
12
13  <indexterm zone="ch-system-busybox">
14    <primary sortas="a-Busybox">Busybox</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>BusyBox combines tiny versions of many common UNIX utilities into a single small
21     executable. It provides replacements for most of the utilities you usually find in GNU
22     fileutils, shellutils, etc. The utilities in BusyBox generally have fewer options than
23     their full-featured GNU cousins; however, the options that are included provide the
24     expected functionality and behave very much like their GNU counterparts. BusyBox provides
25     a fairly complete environment for any small or embedded system.</para>
26
27  </sect2>
28
29  <sect2 role="installation">
30    <title>Installation of Busybox</title>
31
32    <para os="p1">The following patch contains a number of fixes to version
33    &busybox-version; by the Busybox developers:</para>
34
35<screen os="p2"><userinput>patch -Np1 -i ../&busybox-fixes-patch;</userinput></screen>
36
37    <para os="a">The following patch contains a default configuration for busybox:</para>
38
39<screen os="b"><userinput>patch -Np1 -i ../&busybox-config-patch;
40cp -v clfs/config .config</userinput></screen>
41
42    <note os="c">
43      <para>Currently we are just telling Busybox to use a generic
44      configuration. For those for more adventureous, you can use
45      <command>make menuconfig</command>, and create a custom or modified
46      configuration for your build.</para>
47    </note>
48
49    <para os="d">The following tells BusyBox to validate the configuration,
50    and makes sure all required options are defined:</para>
51
52<screen os="e"><userinput>make oldconfig</userinput></screen>
53
54    <para os="f">Compile the package:</para>
55
56<screen os="g"><userinput>make CROSS_COMPILE="${CLFS_TARGET}-"</userinput></screen>
57
58    <para os="h">Install the package:</para>
59
60<screen os="i"><userinput>make CROSS_COMPILE="${CLFS_TARGET}-" \
61  CONFIG_PREFIX="${CLFS}" install</userinput></screen>
62
63    <para os="j">If your going to build your kernel with modules, you will need to make
64    sure <command>depmod.pl</command> is available:</para>
65
66<screen os="k"><userinput>cp examples/depmod.pl ${CLFS}/cross-tools/bin
67chmod 755 ${CLFS}/cross-tools/bin/depmod.pl</userinput></screen>
68
69  </sect2>
70
71  <sect2 id="contents-busybox" role="content">
72    <title>Contents of Busybox</title>
73
74    <segmentedlist>
75      <segtitle>Installed programs</segtitle>
76
77      <seglistitem>
78        <seg>To be Written</seg>
79      </seglistitem>
80    </segmentedlist>
81
82<!--
83    <variablelist>
84      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
85      <?dbfo list-presentation="list"?>
86      <?dbhtml list-presentation="table"?>
87
88      <varlistentry id="bash">
89        <term><command>bash</command></term>
90        <listitem>
91          <para>A widely-used command interpreter; it performs many types of
92          expansions and substitutions on a given command line before executing
93          it, thus making this interpreter a powerful tool</para>
94          <indexterm zone="ch-system-bash bash">
95            <primary sortas="b-bash">bash</primary>
96          </indexterm>
97        </listitem>
98      </varlistentry>
99
100      <varlistentry id="bashbug">
101        <term><command>bashbug</command></term>
102        <listitem>
103          <para>A shell script to help the user compose and mail standard
104          formatted bug reports concerning <command>bash</command></para>
105          <indexterm zone="ch-system-bash bashbug">
106            <primary sortas="b-bashbug">bashbug</primary>
107          </indexterm>
108        </listitem>
109      </varlistentry>
110
111      <varlistentry id="sh">
112        <term><command>sh</command></term>
113        <listitem>
114          <para>A symlink to the <command>bash</command> program; when invoked
115          as <command>sh</command>, <command>bash</command> tries to mimic the
116          startup behavior of historical versions of <command>sh</command> as
117          closely as possible, while conforming to the POSIX standard as
118          well</para>
119          <indexterm zone="ch-system-bash sh">
120            <primary sortas="b-sh">sh</primary>
121          </indexterm>
122        </listitem>
123      </varlistentry>
124
125    </variablelist>
126-->
127  </sect2>
128
129</sect1>
Note: See TracBrowser for help on using the repository browser.