source: clfs-embedded/BOOK/final-system/common/busybox.xml@ 6f8b8bb

Last change on this file since 6f8b8bb was 00c8a02, checked in by Chris Staub <chris@…>, 18 years ago

Text updates

  • 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.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 fixes some issues that are related to the
33 headers we are using:</para>
34
35<screen os="p2"><userinput>patch -Np1 -i ../&busybox-fixes-patch;</userinput></screen>
36
37 <para os="a">Create the default configuration:</para>
38
39<screen os="b"><userinput>make defconfig</userinput></screen>
40
41 <note os="c">
42 <para>Below we are just telling Busybox to use the default configuration of
43 uClibc. For those for more adventureous, you can use make menuconfig, and
44 do a more custom build of your Busybox.</para>
45 </note>
46
47 <para os="d">We will need to edit the configuration file, to make sure everything gets
48 compiled and put into it's proper locations:</para>
49
50<screen os="e"><userinput>cp .config .config.orig
51sed -e "s:# USING_CROSS_COMPILER.*:USING_CROSS_COMPILER=y:" \
52 -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \
53 .config.orig > .config</userinput></screen>
54
55 <para os="f">Compile the package:</para>
56
57<screen os="g"><userinput>make CROSS="${CLFS_TARGET}-" PREFIX="${CLFS}" EXTRA_CFLAGS="${BUILD}" busybox</userinput></screen>
58
59 <para os="h">Install the package:</para>
60
61<screen os="i"><userinput>make 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 depmod.pl 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.