Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / busybox / ac21e93a3fcac80d33cae6a69ef395fc74ba597b / . / docs / busybox.net / index.html
blob: 7352c1bc0e97f195595ee30335cd8f8901498c66 [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,
Eric Andersen8ec10a92001-01-27 09:33:39 +0000[diff] [blame]41tar, etc. BusyBox provides a fairly complete POSIX environment for any small or
42embedded system. The utilities in BusyBox generally have fewer options than
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
Eric Andersen8ec10a92001-01-27 09:33:39 +0000[diff] [blame]48features) at compile time. This makes it easy to customize your embedded
49systems. To create a working system, just add /dev, a kernel, and an editor,
50such as nano, e3, or elvis-tiny. For a really minimal system, you can even use
51the busybox shell (not Bourne compatible, but very small and quite usable).
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]52<p>
53
54BusyBox is now maintained by
Eric Andersen537d1652001-01-25 22:00:37 +0000[diff] [blame]55<a href="http://codepoet.org/andersen/erik/erik.html">
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]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
Mark Whitleyac21e932001-01-30 23:37:15 +0000[diff] [blame^]63<h3> Screenshot </h3>
64
65<p> Because everybody loves screenshots, a <a href="screenshot.html">
66screenshot</a> of BusyBox is now available <a href="screenshot.html"> right
67here</a>
68
Eric Andersen8ec10a92001-01-27 09:33:39 +0000[diff] [blame]69<H3>Mailing List Information</h3>
Matt Kraai8677d7b2000-12-15 15:41:03 +0000[diff] [blame]70BusyBox now has a <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a>!
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]71To 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]72
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]73<!-- Begin Latest News section -->
74
75<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
76 <A NAME="news">
77 <BIG><B>
78 Latest News</A>
79 </B></BIG>
80 </A>
81</TD></TR>
82<TR><TD BGCOLOR="#eeeee0">
83
84<ul>
85
Eric Andersen8ec10a92001-01-27 09:33:39 +0000[diff] [blame]86 <p> <li> <b>27 January 2001 -- BusyBox 0.49 released</b>
87 <br>
88
89 Several new applets, lots of bug fixes, cleanups, and many smaller
90 things made nicer. Several cleanups and improvements to the shell.
91 For a list of the most interesting changes
92 you might want to look at the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
93 <p>
94 Special thanks go out to Matt Kraai and Larry Doolittle for all their
95 work on this release, and for keeping on top of things while I've been
96 out of town.
97 <p>
98 <em>Special Note</em><br>
99
100 BusyBox 0.49 was supposed to have replaced lash, the BusyBox
101 shell, with a new shell that understands full Bourne shell/Posix shell grammer.
102 Well, that simply didn't happen in time for this release. A new
103 shell that will eventually replace lash is already under
104 construction. This new shell is being developed by Larry
105 Doolittle, and could use all of our help. Please see the work in
106 progress on <a href="http://doolittle.faludi.com/~larry/parser.html">Larry's website</a>
107 and help out if you can. This shell will be included in the next
108 release of BusyBox.
109
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]110 <p> <li> <b>13 December 2000 -- BusyBox 0.48 released</b>
111 <br>
112
113 This release fixes lots and lots of bugs. This has had some very
114 rigorous testing, and looks very, very clean. The usual tar
115 update of course: tar no longer breaks hardlinks, tar -xzf is
116 optionally supported, and the LRP folks will be pleased to know
117 that 'tar -X' and 'tar --exclude' are both now in. Applets are
Matt Kraaie3a94f72000-12-13 19:50:48 +0000[diff] [blame]118 now looked up using a binary search making lash (the busybox
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]119 shell) much faster. For the new debian-installer (for Debian
120 woody) a .udeb can now be generated.
121 <p>
Matt Kraaie3a94f72000-12-13 19:50:48 +0000[diff] [blame]122 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]123 the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
124 <p>
125 Many thanks go out to the many many people that have contributed to
126 this release, especially Matt Kraai, Larry Doolittle, and Kent Robotti.
127
128
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]129 <p> <li> <b>Old News</b>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]130 <br>
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]131 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]132</ul>
133
134
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]135<!-- Begin Download section -->
136
137<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
138 <A NAME="download"><BIG><B>
139 Download
140 </A></B></BIG>
141</TD></TR>
142<TR><TD BGCOLOR="#eeeee0">
143<ul>
Mark Whitley8ba1b112001-01-25 23:29:58 +0000[diff] [blame]144
145 <li> Source for the latest release can always be downloaded from
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]146 <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
Mark Whitley8ba1b112001-01-25 23:29:58 +0000[diff] [blame]147
148 <li> A new snapshot of the source is made daily and is available as a GNU
149 gzipped tarball <a href="busybox.tar.gz"> right here</a>.
150
151 <li> BusyBox now has its own publically browsable
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]152 <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,
153 anonymous
154 <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
155 for those that are actively contributing there is even
156 <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
Mark Whitley8ba1b112001-01-25 23:29:58 +0000[diff] [blame]157
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]158</ul>
159
160
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]161<!-- Begin Docs section -->
162
163<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
164 <A NAME="docs"><BIG><B>
165 Documentation
166 </A></B></BIG>
167</TD></TR>
168<TR><TD BGCOLOR="#eeeee0">
169Current documentation for BusyBox includes:
170<ul>
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]171 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.html">BusyBox.html</a>.
172 This is a list of the all the available commands in BusyBox with
173 complete usage information and examples of how to use each app. I
174 have spent a <em>lot</em> of time updating these docs and trying to
175 make them fairly comprehensive. If you find any errors (factual,
176 grammatical, whatever) please let me know.
177 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.pdf">BusyBox.pdf</a>.
178 This is basically the same document, but in pdf format.
Eric Andersen43622002000-12-13 18:30:13 +0000[diff] [blame]179 <li> <a href="ftp://oss.lineo.com/busybox/README">README</a>.
180 This is the README file included in the busybox source release.
Eric Andersen3312b0b2000-07-07 19:23:10 +0000[diff] [blame]181 <li> <a href="http://bugs.lineo.com/db/pa/lbusybox.html">BusyBoxBugs</a>.
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame]182 Need to report a bug? Need to check if a bug has been filed?
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]183 <li> If you need more help, the BusyBox
184 <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a> is
185 a good place to start.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]186</ul>
187
188
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]189<!-- Begin Links section -->
190
191<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
192 <A NAME="links">
193 <BIG><B>
194 Important Links</A>
195 </B></BIG>
196 </A>
197</TD></TR>
198<TR><TD BGCOLOR="#eeeee0">
199
200<ul>
201
202 <li> <A HREF="http://perens.com/FreeSoftware/">
203 Free Software from Bruce Perens</A><br>
204 The original idea for BusyBox, and all versions up to 0.26 were written
205 by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>. This is his BusyBox website.
206 <p>
207
208 <li> <A HREF="http://freshmeat.net/appindex/1999/04/11/923859921.html">
209 Freshmeat AppIndex record for BusyBox</A>
210 <p>
211
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]212 <li> <a href="http://opensource.lineo.com/software.html">Other cool embedded software</a>.
213 <p>
214
215 <li> <a href="http://opensource.lineo.com/">opensource.lineo.com</a>.
216 <p>
217
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]218 <li> <A HREF="http://www.lineo.com/">Lineo</A> is sponsoring BusyBox development.
219 <p>
220
221</ul>
222
223
Eric Andersen1b622ff2000-12-14 15:43:57 +0000[diff] [blame]224<!-- Begin Projects section -->
225
226<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
227 <A NAME="projects"><BIG><B>
228 Products/Projects Using BusyBox
229 </A></B></BIG>
230</TD></TR>
231<TR><TD BGCOLOR="#eeeee0">
232
233<p> I know of the following products and/or projects that use BusyBox --
234listed in the order I happen to add them to the web page:
235
236<ul>
237 <li> <a href="http://www.lineo.com/products/embedix_linux/">Lineo Embedix Linux</a>
238 <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
239 <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
240 <li> <a href="http://linux-embedded.org/">LEM</a>
241 <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
242 <li> <a href="http://www.stormix.com/">Stormix Installer</a>
243 <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
244 <li> <a href="http://www.trinux.org/">Trinux</a>
245 <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
246 <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
247 <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
248 <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
249 <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
250 <li> <a href="http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
251 <li> <a href="http://www.adtran.com">AdTran - VPN/firewall VPN Linux Distribution</a>
Eric Andersen1b622ff2000-12-14 15:43:57 +0000[diff] [blame]252 <li> <a href="http://mkcdrec.ota.be/">mkCDrec - make CD-ROM recovery</a>
Mark Whitley0bc20ca2001-01-25 23:00:12 +0000[diff] [blame]253 <li> <a href="http://recycle.lbl.gov/~ldoolitt/bse/">Linux on nanoEngine</a>
Eric Andersen1b622ff2000-12-14 15:43:57 +0000[diff] [blame]254</ul>
255
256<p> Do you use BusyBox? I'd love to know about it and I'd be happy to link to
257you.
258
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]259
260
261<!-- End of Table -->
262
263</TD></TR>
264</TABLE>
265</P>
266
267
268
269<!-- Footer -->
270<HR>
271<TABLE WIDTH="100%">
272 <TR>
273 <TD>
274 <font size="-1" face="arial, helvetica, sans-serif">
275 Mail all comments, insults, suggestions and bribes to
276 <a href="mailto:andersen@lineo.com">Erik Andersen</a><BR>
277 The Busybox logo is copyright 1999,2000, Erik Andersen.
278 </font>
279 </TD>
280
281 <TD>
282 <a href="http://www.vim.org"><img border=0 width=88 height=32
283 src="images/anim.written.in.vi.gif"
284 alt="This site created with the vi editor"></a>
285 </TD>
286
287 <TD>
288 <a href="http://www.gimp.org/"><img border=0 width=88 height=38
289 src="images/gfx_by_gimp.gif" alt="Graphics by GIMP"></a>
290 </TD>
291
292 <TD>
293 <a href="http://www.linuxtoday.com"><img width=90 height=36
294 src="images/ltbutton2.jpg" alt="Linux Today"></a>
295 </TD>
296
297 <TD>
298 <p><a href="http://slashdot.org"><img width=90 height=36
299 src="images/sdsmall.gif" alt="Slashdot"></a>
300 </TD>
301
302 <TD>
303 <a href="http://freshmeat.net"><img width=90 height=36
304 src="images/fm.mini.jpg" alt="Freshmeat"></a>
305 </TD>
306
307 </TR>
308</TABLE>
309
310
311</BODY>
312</HTML>
313