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

Last change on this file since 6280230 was 6280230, checked in by Andrew Bradford <andrew@…>, 11 years ago

busybox: 'make distclean' first

To ensure we have a clean directory prior to building.

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