Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / busybox / e3a94f7d08615e7d957118eb90c9b28d74d111f4 / . / docs / busybox.net / index.html
blob: cb93235c3651fe3b413f189a1a01da672e7f3764 [file] [log] [blame]
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
2
3<HTML>
4<HEAD>
5<TITLE>BusyBox</TITLE>
6</HEAD>
7
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]8<body text="#000000" alink="#660000" link="#660000" bgcolor="#dee2de" vlink="#660000">
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]9
10<basefont face="lucida, helvetica, arial" size="3">
11
12
13<CENTER>
14 <TABLE BORDER=0 CELLSPACING=1 CELLPADDING=2>
15 <TR>
16 <td bgcolor="#000000">
17 <FONT FACE="lucida, helvetica" COLOR="#ccccc0">
18 <B>B&nbsp;u&nbsp;s&nbsp;y&nbsp;B&nbsp;o&nbsp;x</B>
19 </FONT>
20 </TD>
21 </TR>
22 </TABLE>
23 <a href="/"><IMG SRC="images/busybox2.jpg" alt="BusyBox" border="0" width="360" height="230"</a><BR>
24
25
26<!-- Begin Introduction section -->
27
28
29<TABLE WIDTH=95% CELLSPACING=1 CELLPADDING=4 BORDER=1>
30<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
31 <A NAME="intro"> <BIG><B>
32 The Swiss Army Knife of Embedded Linux
33 </font>
34 </A></B></BIG>
35</TD></TR>
36<TR><TD BGCOLOR="#eeeee0">
37
38BusyBox combines tiny versions of many common UNIX utilities into a single
39small executable. It provides minimalist replacements for most of the utilities
40you usually find in fileutils, shellutils, findutils, textutils, grep, gzip,
41tar, etc. BusyBox provides a fairly complete POSIX environment for any small
Pavel Roskin82c0ac72000-06-05 20:19:47 +0000[diff] [blame]42or embedded system. The utilities in BusyBox generally have fewer options than
Eric Andersen36fe1a32000-06-05 17:22:37 +0000[diff] [blame]43their full-featured GNU cousins; however, the options that are included provide
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]44the expected functionality and behave very much like their GNU counterparts.
45<p>
46BusyBox has been written with size-optimization and limited resources in mind.
47It is also extremely modular so you can easily include or exclude commands (or
48features) at compile time. This makes it easy to customize your embedded
49systems. To create a working system, just add a kernel, a shell (such as ash),
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]50and an editor (such as elvis-tiny or ae). For a really minimal system, just
51the the busybox shell (not a POSIX shell, but very small and quite usable).
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]52<p>
53
54BusyBox is now maintained by
55<a href="http://www.xmission.com/~andersen/erik/erik.html">
56Erik Andersen</a>, and its ongoing development is being sponsored by
57<a href="http://www.lineo.com/">Lineo</a>.
58<p>
59BusyBox is licensed under the
60<a href="http://www.gnu.org/copyleft/gpl.html">GNU GENERAL PUBLIC LICENSE</a>
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]61<p>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]62
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]63<H3>NEW!</h3>
64BusyBox now has a mailing list <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a>!
65To subscribe, go and visit <a href="http://opensource.lineo.com/mailman/listinfo/busybox">this page</a>.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]66
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]67<!-- Begin Latest News section -->
68
69<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
70 <A NAME="news">
71 <BIG><B>
72 Latest News</A>
73 </B></BIG>
74 </A>
75</TD></TR>
76<TR><TD BGCOLOR="#eeeee0">
77
78<ul>
79
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]80 <p> <li> <b>13 December 2000 -- BusyBox 0.48 released</b>
81 <br>
82
83 This release fixes lots and lots of bugs. This has had some very
84 rigorous testing, and looks very, very clean. The usual tar
85 update of course: tar no longer breaks hardlinks, tar -xzf is
86 optionally supported, and the LRP folks will be pleased to know
87 that 'tar -X' and 'tar --exclude' are both now in. Applets are
Matt Kraaie3a94f72000-12-13 19:50:48 +0000[diff] [blame^]88 now looked up using a binary search making lash (the busybox
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]89 shell) much faster. For the new debian-installer (for Debian
90 woody) a .udeb can now be generated.
91 <p>
Matt Kraaie3a94f72000-12-13 19:50:48 +0000[diff] [blame^]92 The curious can get a list of some of the more interesting changes by reading
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]93 the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
94 <p>
95 Many thanks go out to the many many people that have contributed to
96 this release, especially Matt Kraai, Larry Doolittle, and Kent Robotti.
97
98
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]99 <p> <li> <b>26 September 2000 -- BusyBox 0.47 released</b>
100 <br>
101
102 This release fixes lots of bugs (including an ugly bug in 0.46
103 syslogd that could fork-bomb your system). Added several new
104 apps: rdate, wget, getopt, dos2unix, unix2dos, reset, unrpm,
105 renice, xargs, and expr. syslogd now supports network logging.
106 There are the usual tar updates. Most apps now use getopt for
107 more correct option parsing.
108 See the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>
109 for complete details.
110
111
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]112 <p> <li> <b>Old News</b>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]113 <br>
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]114 For the old news, visit <a href="http://busybox.lineo.com/oldnews.html">the old news page</a>.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]115</ul>
116
117
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]118<!-- Begin Download section -->
119
120<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
121 <A NAME="download"><BIG><B>
122 Download
123 </A></B></BIG>
124</TD></TR>
125<TR><TD BGCOLOR="#eeeee0">
126<ul>
127 <li> Source for the latest release can always be downloaded from
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]128 <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]129 <li> BusyBox now has its own publically browsable
130 <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,
131 anonymous
132 <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
133 for those that are actively contributing there is even
134 <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
135</ul>
136
137
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]138<!-- Begin Docs section -->
139
140<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
141 <A NAME="docs"><BIG><B>
142 Documentation
143 </A></B></BIG>
144</TD></TR>
145<TR><TD BGCOLOR="#eeeee0">
146Current documentation for BusyBox includes:
147<ul>
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]148 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.html">BusyBox.html</a>.
149 This is a list of the all the available commands in BusyBox with
150 complete usage information and examples of how to use each app. I
151 have spent a <em>lot</em> of time updating these docs and trying to
152 make them fairly comprehensive. If you find any errors (factual,
153 grammatical, whatever) please let me know.
154 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.pdf">BusyBox.pdf</a>.
155 This is basically the same document, but in pdf format.
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]156 <li> <a href="ftp://oss.lineo.com/busybox/README">README</a>.
157 This is the README file included in the busybox source release.
Eric Andersen3312b0b2000-07-07 19:23:10 +0000[diff] [blame]158 <li> <a href="http://bugs.lineo.com/db/pa/lbusybox.html">BusyBoxBugs</a>.
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]159 Need to report a bug? Need to check if a bug has been filed?
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]160 <li> If you need more help, the BusyBox
161 <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a> is
162 a good place to start.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]163</ul>
164
165
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]166<!-- Begin Projects section -->
167
168<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
Eric Andersen3312b0b2000-07-07 19:23:10 +0000[diff] [blame]169 <A NAME="projects"><BIG><B>
Mark Whitley5022d0e2000-11-17 22:07:08 +0000[diff] [blame]170 Products/Projects Using BusyBox
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]171 </A></B></BIG>
172</TD></TR>
173<TR><TD BGCOLOR="#eeeee0">
Mark Whitley5022d0e2000-11-17 22:07:08 +0000[diff] [blame]174
175<p> I know of the following products and/or projects that use BusyBox --
176listed in the order I happen to add them to the web page:
177
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]178<ul>
Matt Kraaida9841e2000-07-11 16:09:01 +0000[diff] [blame]179 <li> <a href="http://www.lineo.com/products/embedix_linux/">Lineo Embedix Linux</a>
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]180 <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]181 <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
182 <li> <a href="http://linux-embedded.org/">LEM</a>
183 <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
Eric Andersene511e7c2000-05-25 00:18:59 +0000[diff] [blame]184 <li> <a href="http://www.stormix.com/">Stormix Installer</a>
185 <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
Eric Andersen53310252000-07-04 19:42:23 +0000[diff] [blame]186 <li> <a href="http://www.trinux.org/">Trinux</a>
Eric Andersenbb39a312000-08-11 18:13:21 +0000[diff] [blame]187 <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
Eric Andersen68fda242000-07-11 23:03:40 +0000[diff] [blame]188 <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
Eric Andersenec8d60f2000-07-21 17:22:19 +0000[diff] [blame]189 <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
Eric Andersenfd50c3d2000-09-01 22:24:03 +0000[diff] [blame]190 <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
Eric Andersenb4c3c592000-09-13 23:06:41 +0000[diff] [blame]191 <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
Eric Andersen8045c082000-11-14 22:57:46 +0000[diff] [blame]192 <li> <a href="http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
Mark Whitley5022d0e2000-11-17 22:07:08 +0000[diff] [blame]193 <li> <a href="http://www.adtran.com">AdTran - VPN/firewall VPN Linux Distribution</a>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]194
195</ul>
Mark Whitley5022d0e2000-11-17 22:07:08 +0000[diff] [blame]196
197<p> Do you use BusyBox? I'd love to know about it and I'd be happy to link to
198you.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]199
200
201
202<!-- Begin Links section -->
203
204<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
205 <A NAME="links">
206 <BIG><B>
207 Important Links</A>
208 </B></BIG>
209 </A>
210</TD></TR>
211<TR><TD BGCOLOR="#eeeee0">
212
213<ul>
214
215 <li> <A HREF="http://perens.com/FreeSoftware/">
216 Free Software from Bruce Perens</A><br>
217 The original idea for BusyBox, and all versions up to 0.26 were written
218 by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>. This is his BusyBox website.
219 <p>
220
221 <li> <A HREF="http://freshmeat.net/appindex/1999/04/11/923859921.html">
222 Freshmeat AppIndex record for BusyBox</A>
223 <p>
224
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]225 <li> <a href="http://opensource.lineo.com/software.html">Other cool embedded software</a>.
226 <p>
227
228 <li> <a href="http://opensource.lineo.com/">opensource.lineo.com</a>.
229 <p>
230
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]231 <li> <A HREF="http://www.lineo.com/">Lineo</A> is sponsoring BusyBox development.
232 <p>
233
234</ul>
235
236
237
238
239<!-- End of Table -->
240
241</TD></TR>
242</TABLE>
243</P>
244
245
246
247<!-- Footer -->
248<HR>
249<TABLE WIDTH="100%">
250 <TR>
251 <TD>
252 <font size="-1" face="arial, helvetica, sans-serif">
253 Mail all comments, insults, suggestions and bribes to
254 <a href="mailto:andersen@lineo.com">Erik Andersen</a><BR>
255 The Busybox logo is copyright 1999,2000, Erik Andersen.
256 </font>
257 </TD>
258
259 <TD>
260 <a href="http://www.vim.org"><img border=0 width=88 height=32
261 src="images/anim.written.in.vi.gif"
262 alt="This site created with the vi editor"></a>
263 </TD>
264
265 <TD>
266 <a href="http://www.gimp.org/"><img border=0 width=88 height=38
267 src="images/gfx_by_gimp.gif" alt="Graphics by GIMP"></a>
268 </TD>
269
270 <TD>
271 <a href="http://www.linuxtoday.com"><img width=90 height=36
272 src="images/ltbutton2.jpg" alt="Linux Today"></a>
273 </TD>
274
275 <TD>
276 <p><a href="http://slashdot.org"><img width=90 height=36
277 src="images/sdsmall.gif" alt="Slashdot"></a>
278 </TD>
279
280 <TD>
281 <a href="http://freshmeat.net"><img width=90 height=36
282 src="images/fm.mini.jpg" alt="Freshmeat"></a>
283 </TD>
284
285 </TR>
286</TABLE>
287
288
289</BODY>
290</HTML>
291