1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
8 <body text="#000000" alink="#660000" link="#660000" bgcolor="#dee2de" vlink="#660000">
10 <basefont face="lucida, helvetica, arial" size="3">
14 <TABLE BORDER=0 CELLSPACING=1 CELLPADDING=2>
16 <td bgcolor="#000000">
17 <FONT FACE="lucida, helvetica" COLOR="#ccccc0">
18 <B>B u s y B o x</B>
23 <a href="/"><IMG SRC="images/busybox2.jpg" alt="BusyBox" border="0" width="360" height="230"></a><BR>
26 <!-- Begin Introduction section -->
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
35 <TR><TD BGCOLOR="#eeeee0">
37 BusyBox combines tiny versions of many common UNIX utilities into a single
38 small executable. It provides minimalist replacements for most of the utilities
39 you usually find in fileutils, shellutils, findutils, textutils, grep, gzip,
40 tar, etc. BusyBox provides a fairly complete POSIX environment for any small or
41 embedded system. The utilities in BusyBox generally have fewer options than
42 their full featured GNU cousins; however, the options that are included provide
43 the expected functionality and behave very much like their GNU counterparts.
45 BusyBox has been written with size-optimization and limited resources in mind.
46 It is also extremely modular so you can easily include or exclude commands (or
47 features) at compile time. This makes it easy to customize your embedded
48 systems. To create a working system, just add /dev, a kernel, and a shell.
49 For a really minimal system, you can even use the busybox shell (not Bourne compatible, but very small and quite usable), and the busybox vi editor.
52 BusyBox is now maintained by
53 <a href="http://codepoet.org/andersen/erik/erik.html">
54 Erik Andersen</a>, and its ongoing development is being sponsored by
55 <a href="http://www.lineo.com/">Lineo</a>.
57 BusyBox is licensed under the
58 <a href="http://www.gnu.org/copyleft/gpl.html">GNU GENERAL PUBLIC LICENSE</a>.
64 <p> Because everybody loves screenshots, a screenshot of BusyBox
65 is now available <a href="screenshot.html">right here</a>.
68 <H3>Mailing List Information</h3>
69 BusyBox now has a <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a>!
70 To subscribe, go and visit <a href="http://opensource.lineo.com/mailman/listinfo/busybox">this page</a>.
72 <!-- Begin Latest News section -->
74 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
81 <TR><TD BGCOLOR="#eeeee0">
85 <li> <b>10 April 2001 - Graph of Busybox Growth </b>
87 The illustrious Larry Doolittle has made a PostScript chart of the growth
88 of the Busybox tarball size over time. It is available for downloading /
89 viewing <a href= "busybox-growth.ps"> right here</a>.
91 <p> (Note that while the number of applets in Busybox has increased, you
92 can still configure Busybox to be as small as you want by selectively
93 turning off whichever applets you don't need.)
96 <li> <b>10 April 2001 -- BusyBox 0.51 released</b>
99 BusyBox 0.51 (the "rock-solid release") is now out there. This
100 release adds only 2 new applets: env and vi. The vi applet,
101 contributed by Sterling Huxley, is very functional, and is only
102 22k. This release fixes 3 critical bugs in the 0.50 release.
103 There were 2 potential segfaults in lash (the busybox shell) in
104 the 0.50 release which are now fixed. Another critical bug in
105 0.50 which is now fixed: syslogd from 0.50 could potentially
106 deadlock the init process and thereby break your entire system.
109 There are a number of improvements in this release as well. For
110 one thing, the wget applet is greatly improved. Dmitry Zakharov
111 added FTP support, and Laurence Anderson make wget fully RFC
112 compliant for HTTP 1.1. The mechanism for including utility
113 functions in previous releases was clumsy and error prone. Now
114 all utility functions are part of a new libbb library, which makes
115 maintaining utility functions much simpler. And BusyBox now
116 compiles on itanium systems (thanks to the Debian itanium porters
117 for letting me use their system!).
120 <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a> for
121 complete details. BusyBox 0.51 can be downloaded from
122 <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
126 <li> <b>Busybox Boot-Floppy Image</b>
128 <p>Because you asked for it, we have made available a <a href=
129 "ftp://opensource.lineo.com/busybox/busybox.floppy.img"> Busybox boot floppy
130 image</a>. Here's how you use it:
134 <li> <a href= "ftp://opensource.lineo.com/busybox/busybox.floppy.img">
135 Download the image</a>
137 <li> dd it onto a floppy like so: <tt> dd if=busybox.floppy.img
138 of=/dev/fd0 ; sync </tt>
140 <li> Pop it in a machine and boot up.
144 <p> If you want to look at the contents of the initrd image, do this:
147 mount ./busybox.floppy.img /mnt -o loop -t msdos
148 cp /mnt/initrd.gz /tmp
150 gunzip /tmp/initrd.gz
151 mount /tmp/initrd /mnt -o loop -t minix
155 <li> <b>15 March 2001 -- BusyBox 0.50 released</b>
158 This release adds several new applets including ifconfig, route, pivot_root, stty,
159 and tftp, and also fixes tons of bugs. Tab completion in the
160 shell is now working very well, and the shell's environment variable
161 expansion was fixed. Tons of other things were fixed or made
162 smaller. For a fairly complete overview, see the
163 <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
165 lash (the busybox shell) is still with us, fixed up a bit so it
166 now behaves itself quite nicely. It really is quite usable as
167 long as you don't expect it to provide Bourne shell grammer.
168 Standard things like pipes, redirects, command line editing, and
169 environment variable expansion work great. But we have found that
170 this shell, while very usable, does not provide an extensible
171 framework for adding in full Bourne shell behavior. So the first order of
172 business as we begin working on the next BusyBox release will be to merge in the new shell
173 currently in progress at
174 <a href="http://doolittle.faludi.com/~larry/parser.html">Larry Doolittle's website</a>.
178 <li> <b>27 January 2001 -- BusyBox 0.49 released</b>
181 Several new applets, lots of bug fixes, cleanups, and many smaller
182 things made nicer. Several cleanups and improvements to the shell.
183 For a list of the most interesting changes
184 you might want to look at the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
186 Special thanks go out to Matt Kraai and Larry Doolittle for all their
187 work on this release, and for keeping on top of things while I've been
190 <em>Special Note</em><br>
192 BusyBox 0.49 was supposed to have replaced lash, the BusyBox
193 shell, with a new shell that understands full Bourne shell/Posix shell grammer.
194 Well, that simply didn't happen in time for this release. A new
195 shell that will eventually replace lash is already under
196 construction. This new shell is being developed by Larry
197 Doolittle, and could use all of our help. Please see the work in
198 progress on <a href="http://doolittle.faludi.com/~larry/parser.html">Larry's website</a>
199 and help out if you can. This shell will be included in the next
203 <li> <b>13 December 2000 -- BusyBox 0.48 released</b>
206 This release fixes lots and lots of bugs. This has had some very
207 rigorous testing, and looks very, very clean. The usual tar
208 update of course: tar no longer breaks hardlinks, tar -xzf is
209 optionally supported, and the LRP folks will be pleased to know
210 that 'tar -X' and 'tar --exclude' are both now in. Applets are
211 now looked up using a binary search making lash (the busybox
212 shell) much faster. For the new debian-installer (for Debian
213 woody) a .udeb can now be generated.
215 The curious can get a list of some of the more interesting changes by reading
216 the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>.
218 Many thanks go out to the many many people that have contributed to
219 this release, especially Matt Kraai, Larry Doolittle, and Kent Robotti.
225 For the old news, visit <a href="http://busybox.lineo.com/oldnews.html">the old news page</a>.
229 <!-- Begin Download section -->
231 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
232 <A NAME="download"><BIG><B>
236 <TR><TD BGCOLOR="#eeeee0">
239 <li> Source for the latest release can always be downloaded from
240 <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
242 <li> A new snapshot of the source is made daily and is available as a GNU
243 gzipped tarball <a href="busybox.tar.gz"> right here</a>.
245 <li> BusyBox now has its own publically browsable
246 <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,
248 <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
249 for those that are actively contributing there is even
250 <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
255 <!-- Begin Docs section -->
257 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
258 <A NAME="docs"><BIG><B>
262 <TR><TD BGCOLOR="#eeeee0">
263 Current documentation for BusyBox includes:
265 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.html">BusyBox.html</a>.
266 This is a list of the all the available commands in BusyBox with
267 complete usage information and examples of how to use each app. I
268 have spent a <em>lot</em> of time updating these docs and trying to
269 make them fairly comprehensive. If you find any errors (factual,
270 grammatical, whatever) please let me know.
271 <li> <a href="ftp://oss.lineo.com/busybox/README">README</a>.
272 This is the README file included in the busybox source release.
273 <li> <a href="http://bugs.lineo.com/db/pa/lbusybox.html">BusyBox Bugs</a>.
274 Need to report a bug? Need to check if a bug has been filed?
275 <li> If you need more help, the BusyBox
276 <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a> is
277 a good place to start.
281 <!-- Begin Links section -->
283 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
290 <TR><TD BGCOLOR="#eeeee0">
294 <li> <A HREF="http://perens.com/FreeSoftware/">
295 Free Software from Bruce Perens</A><br>
296 The original idea for BusyBox, and all versions up to 0.26 were written
297 by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>. This is his BusyBox website.
300 <li> <A HREF="http://freshmeat.net/projects/busybox/">
301 Freshmeat AppIndex record for BusyBox</A>
303 <li><a href="http://tinylogin.lineo.com/">TinyLogin</a>
304 is a nice embedded tool for handling authentication, changing passwords,
305 and similar tasks which nicely complements BusyBox.
308 <li><a href="http://cvs.uclinux.org/uClibc.html">uClibc</a>
309 is a C library for embedded systems. You can actually statically link
310 a "Hello World" application under x86 that only takes 4k (as opposed to
311 200k under GNU libc). It can do dynamic linking too and works nicely with
312 BusyBox to create very small embedded systems.
315 <li> <a href="http://opensource.lineo.com/software.html">Other cool embedded software</a>.
318 <li> <a href="http://opensource.lineo.com/">opensource.lineo.com</a>.
321 <li> <A HREF="http://www.lineo.com/">Lineo</A> is sponsoring BusyBox development.
327 <!-- Begin Projects section -->
329 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
330 <A NAME="projects"><BIG><B>
331 Products/Projects Using BusyBox
334 <TR><TD BGCOLOR="#eeeee0">
336 <p> I know of the following products and/or projects that use BusyBox --
337 listed in the order I happen to add them to the web page:
340 <li> <a href="http://www.lineo.com/products/embedix_linux/">Lineo Embedix Linux</a>
341 <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
342 <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
343 <li> <a href="http://linux-embedded.org/">LEM</a>
344 <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
345 <li> <a href="http://www.stormix.com/">Stormix Installer</a>
346 <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
347 <li> <a href="http://www.trinux.org/">Trinux</a>
348 <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
349 <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
350 <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
351 <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
352 <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
353 <li> <a href="http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
354 <li> <a href="http://www.adtran.com">AdTran - VPN/firewall VPN Linux Distribution</a>
355 <li> <a href="http://mkcdrec.ota.be/">mkCDrec - make CD-ROM recovery</a>
356 <li> <a href="http://recycle.lbl.gov/~ldoolitt/bse/">Linux on nanoEngine</a>
357 <li> <a href="http://www.zelow.no/floppyfw/"> Floppyfw</a>
359 <li> <a href="http://midori.transmeta.com/"> Midori Linux</a> - <a href=
360 "http://www.wired.com/news/technology/0,1282,42399,00.html"> Article on
361 Midori Linux</a> on <a href= "http://www.wired.com"> Wired</a>. Quote from
362 Erik at the top of <a href=
363 "http://www.wired.com/news/technology/0,1282,42399-2,00.html"> this
366 <li> <a href="http://www.ltsp.org/">Linux Terminal Server Project</a>
367 <li> <a href="http://www.devil-linux.org/">Devil-Linux</a>
371 <p> Do you use BusyBox? I'd love to know about it and I'd be happy to link to
376 <!-- End of Table -->
388 <font size="-1" face="arial, helvetica, sans-serif">
389 Mail all comments, insults, suggestions and bribes to
390 <a href="mailto:andersen@lineo.com">Erik Andersen</a><BR>
391 The Busybox logo is copyright 1999,2000,2001, Erik Andersen.
396 <a href="http://www.vim.org"><img border=0 width=90 height=36
397 src="images/written.in.vi.png"
398 alt="This site created with the vi editor"></a>
402 <a href="http://www.gimp.org/"><img border=0 width=90 height=36
403 src="images/gfx_by_gimp.png" alt="Graphics by GIMP"></a>
407 <a href="http://www.linuxtoday.com"><img width=90 height=36
408 src="images/ltbutton2.png" alt="Linux Today"></a>
412 <p><a href="http://slashdot.org"><img width=90 height=36
413 src="images/sdsmall.png" alt="Slashdot"></a>
417 <a href="http://freshmeat.net"><img width=90 height=36
418 src="images/fm.mini.png" alt="Freshmeat"></a>