499d398d08015e6d7b871e2753a479ad020eae0b
[oweals/busybox.git] / docs / busybox.net / index.html
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
8 <body text="#000000" alink="#660000" link="#660000" bgcolor="#dee2de" vlink="#660000">
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     </B></BIG></A>
34 </TD></TR>
35 <TR><TD BGCOLOR="#eeeee0">
36
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.
44 <p>
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.
50 <p>
51
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>. 
56 <p>
57 BusyBox is licensed under the 
58 <a href="http://www.gnu.org/copyleft/gpl.html">GNU GENERAL PUBLIC LICENSE</a>.
59 <p>
60
61
62 <h3> Screenshot </h3>
63
64 <p> Because everybody loves screenshots, a screenshot of BusyBox 
65 is now available <a href="screenshot.html">right here</a>.
66
67
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>.
71
72 <!-- Begin Latest News section -->
73
74 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
75     <A NAME="news">
76     <BIG><B>
77     Latest News
78     </B></BIG>
79     </A>
80 </TD></TR>
81 <TR><TD BGCOLOR="#eeeee0">
82
83 <ul>
84
85     <li> <b>7 July 2001 -- BusyBox 0.52 released</b>
86     <br>
87
88              I am very pleased to announce the immediate availability of
89              BusyBox 0.52 (the "new-and-improved rock-solid release").  This
90              release is the result of <em>many</em> hours of work and has tons
91              of bugfixes, optimizations, and cleanups.  This release adds
92              several new applets, including several new shells (such as hush, msh,
93              and ash).
94
95              <p>
96              The 
97              <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a> covers 
98              some of the more obvious details, but there are many many things that
99              are not mentioned, but have been improved in subtle ways.  As usual,
100              BusyBox 0.52 can be downloaded from 
101              <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
102              <p>Have Fun!
103              <p>
104
105
106         <li> <b>10 April 2001 - Graph of Busybox Growth </b>
107         <br> 
108         The illustrious Larry Doolittle has made a PostScript chart of the growth
109         of the Busybox tarball size over time. It is available for downloading /
110         viewing <a href= "busybox-growth.ps"> right here</a>.
111
112         <p> (Note that while the number of applets in Busybox has increased, you
113         can still configure Busybox to be as small as you want by selectively
114         turning off whichever applets you don't need.)
115         <p>
116
117     <li> <b>10 April 2001 -- BusyBox 0.51 released</b>
118     <br>
119
120              BusyBox 0.51 (the "rock-solid release") is now out there.  This
121              release adds only 2 new applets: env and vi.  The vi applet,
122              contributed by Sterling Huxley, is very functional, and is only
123              22k.  This release fixes 3 critical bugs in the 0.50 release.
124              There were 2 potential segfaults in lash (the busybox shell) in
125              the 0.50 release which are now fixed.  Another critical bug in
126              0.50 which is now fixed: syslogd from 0.50 could potentially
127              deadlock the init process and thereby break your entire system.
128              <p>
129
130              There are a number of improvements in this release as well.  For
131              one thing, the wget applet is greatly improved.  Dmitry Zakharov
132              added FTP support, and Laurence Anderson make wget fully RFC
133              compliant for HTTP 1.1.  The mechanism for including utility
134              functions in previous releases was clumsy and error prone.  Now
135              all utility functions are part of a new libbb library, which makes
136              maintaining utility functions much simpler.  And BusyBox now
137              compiles on itanium systems (thanks to the Debian itanium porters
138              for letting me use their system!).
139              <p>
140              You can read the 
141              <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a> for
142              complete details.  BusyBox 0.51 can be downloaded from 
143              <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
144              <p>Have Fun!
145              <p>
146
147     <li> <b>Busybox Boot-Floppy Image</b>
148
149     <p>Because you asked for it, we have made available a <a href=
150     "ftp://opensource.lineo.com/busybox/busybox.floppy.img"> Busybox boot floppy
151     image</a>. Here's how you use it:
152
153     <ol>
154
155             <li> <a href= "ftp://opensource.lineo.com/busybox/busybox.floppy.img">
156             Download the image</a>
157
158             <li> dd it onto a floppy like so: <tt> dd if=busybox.floppy.img
159             of=/dev/fd0 ; sync </tt>
160
161             <li> Pop it in a machine and boot up.
162
163     </ol>
164
165     <p> If you want to look at the contents of the initrd image, do this:
166
167     <pre>
168             mount ./busybox.floppy.img /mnt -o loop -t msdos        
169             cp /mnt/initrd.gz /tmp                          
170             umount /mnt           
171             gunzip /tmp/initrd.gz
172             mount /tmp/initrd /mnt -o loop -t minix
173     </pre>
174
175
176
177
178     <li> <b>Old News</b>
179     <br>
180              For the old news, visit <a href="http://busybox.lineo.com/oldnews.html">the old news page</a>.
181 </ul>
182
183
184 <!-- Begin Download section -->
185
186 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
187     <A NAME="download"><BIG><B>
188     Download
189     </B></BIG></A>
190 </TD></TR>
191 <TR><TD BGCOLOR="#eeeee0">
192 <ul>
193
194         <li> Source for the latest release can always be downloaded from 
195         <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
196
197         <li> A new snapshot of the source is made daily and is available as a GNU
198         gzipped tarball <a href="busybox.tar.gz"> right here</a>.
199
200         <li> BusyBox now has its own publically browsable
201         <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,  
202         anonymous
203         <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
204         for those that are actively contributing there is even 
205         <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
206
207 </ul>
208
209
210 <!-- Begin Docs section -->
211
212 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
213     <A NAME="docs"><BIG><B>
214     Documentation
215     </B></BIG></A>
216 </TD></TR>
217 <TR><TD BGCOLOR="#eeeee0">
218 Current documentation for BusyBox includes: 
219 <ul>
220     <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.html">BusyBox.html</a>.
221                 This is a list of the all the available commands in BusyBox with 
222                 complete usage information and examples of how to use each app.  I 
223                 have spent a <em>lot</em> of time updating these docs and trying to 
224                 make them fairly comprehensive.  If you find any errors (factual, 
225                 grammatical, whatever) please let me know.
226     <li> <a href="ftp://oss.lineo.com/busybox/README">README</a>.
227                 This is the README file included in the busybox source release.
228     <li> <a href="http://bugs.lineo.com/db/pa/lbusybox.html">BusyBox Bugs</a>.
229                 Need to report a bug?  Need to check if a bug has been filed?
230     <li> If you need more help, the BusyBox
231     <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a> is
232     a good place to start.
233 </ul>
234
235
236 <!-- Begin Links section -->
237
238 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
239     <A NAME="links">
240     <BIG><B>
241     Important Links
242     </B></BIG>
243     </A>
244 </TD></TR>
245 <TR><TD BGCOLOR="#eeeee0">
246
247 <ul> 
248
249     <li>  <A HREF="http://perens.com/FreeSoftware/">
250     Free Software from Bruce Perens</A><br>
251     The original idea for BusyBox, and all versions up to 0.26 were written 
252     by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>.  This is his BusyBox website.
253     <p>
254
255     <li>  <A HREF="http://freshmeat.net/projects/busybox/">
256     Freshmeat AppIndex record for BusyBox</A>
257     <p>
258     <li><a href="http://tinylogin.lineo.com/">TinyLogin</a>
259         is a nice embedded tool for handling authentication, changing passwords,
260         and similar tasks which nicely complements BusyBox.
261     <p>
262
263     <li><a href="http://cvs.uclinux.org/uClibc.html">uClibc</a>
264         is a C library for embedded systems.  You can actually statically link
265         a "Hello World" application under x86 that only takes 4k (as opposed to
266         200k under GNU libc).  It can do dynamic linking too and works nicely with
267         BusyBox to create very small embedded systems.
268     <p>
269
270     <li> <a href="http://opensource.lineo.com/software.html">Other cool embedded software</a>.
271     <p>
272
273     <li> <a href="http://opensource.lineo.com/">opensource.lineo.com</a>.
274     <p>
275
276     <li> <A HREF="http://www.lineo.com/">Lineo</A> is sponsoring BusyBox development.
277     <p>
278
279 </ul>
280
281
282 <!-- Begin Projects section -->
283
284 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
285     <A NAME="projects"><BIG><B>
286     Products/Projects Using BusyBox
287     </B></BIG></A>
288 </TD></TR>
289 <TR><TD BGCOLOR="#eeeee0">
290
291 <p> I know of the following products and/or projects that use BusyBox --
292 listed in the order I happen to add them to the web page:
293
294 <ul>
295     <li> <a href="http://www.lineo.com/products/embedix_linux/">Lineo Embedix Linux</a>
296     <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
297     <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
298     <li> <a href="http://linux-embedded.org/">LEM</a>
299     <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
300     <li> <a href="http://www.stormix.com/">Stormix Installer</a>
301     <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
302     <li> <a href="http://www.trinux.org/">Trinux</a>
303     <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
304     <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
305     <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
306     <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
307     <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
308     <li> <a href="http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
309     <li> <a href="http://www.adtran.com">AdTran - VPN/firewall VPN Linux Distribution</a> 
310     <li> <a href="http://mkcdrec.ota.be/">mkCDrec - make CD-ROM recovery</a>
311     <li> <a href="http://recycle.lbl.gov/~ldoolitt/bse/">Linux on nanoEngine</a>
312     <li> <a href="http://www.zelow.no/floppyfw/"> Floppyfw</a>
313
314     <li> <a href="http://midori.transmeta.com/"> Midori Linux</a> - <a href=
315         "http://www.wired.com/news/technology/0,1282,42399,00.html"> Article on
316         Midori Linux</a> on <a href= "http://www.wired.com"> Wired</a>. Quote from
317         Erik at the top of <a href=
318         "http://www.wired.com/news/technology/0,1282,42399-2,00.html"> this
319         page</a>
320
321     <li> <a href="http://www.ltsp.org/">Linux Terminal Server Project</a>
322     <li> <a href="http://www.devil-linux.org/">Devil-Linux</a>
323
324 </ul>
325
326 <p> Do you use BusyBox?  I'd love to know about it and I'd be happy to link to
327 you.
328
329
330
331 <!-- End of Table -->
332
333 </TD></TR>
334 </TABLE>
335
336
337
338 <!-- Footer -->
339 <HR>
340 <TABLE WIDTH="100%">
341     <TR>
342         <TD>
343             <font size="-1" face="arial, helvetica, sans-serif">
344             Mail all comments, insults, suggestions and bribes to 
345             <a href="mailto:andersen@lineo.com">Erik Andersen</a><BR>
346             The Busybox logo is copyright 1999,2000,2001, Erik Andersen.
347             </font>
348         </TD>
349
350         <TD>
351             <a href="http://www.vim.org"><img border=0 width=90 height=36
352             src="images/written.in.vi.png" 
353             alt="This site created with the vi editor"></a>
354         </TD>
355
356         <TD>
357             <a href="http://www.gimp.org/"><img border=0 width=90 height=36
358             src="images/gfx_by_gimp.png" alt="Graphics by GIMP"></a>
359         </TD>
360
361         <TD>
362             <a href="http://www.linuxtoday.com"><img width=90 height=36
363             src="images/ltbutton2.png" alt="Linux Today"></a>
364         </TD>
365
366         <TD>
367             <p><a href="http://slashdot.org"><img width=90 height=36
368             src="images/sdsmall.png" alt="Slashdot"></a>
369         </TD>
370
371         <TD>
372             <a href="http://freshmeat.net"><img width=90 height=36
373             src="images/fm.mini.png" alt="Freshmeat"></a>
374         </TD>
375
376     </TR>
377 </TABLE>
378
379
380 </CENTER>
381 </BODY>
382 </HTML>
383