48785fb1696c903a9d99b46dc2911548f7e76ee4
[oweals/busybox.git] / docs / busybox.net / index.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
2 "http://www.w3.org/TR/REC-html40/loose.dtd">
3
4 <html>
5   <head>
6     <meta name="generator" content=
7     "HTML Tidy for Linux/x86 (vers 1st February 2002), see www.w3.org">
8
9     <title>BusyBox</title>
10 <style type="text/css">
11  body {
12   background-color: #DEE2DE;
13   color: #000000;
14  }
15  :link { color: #660000 }
16  :visited { color: #660000 }
17  :active { color: #660000 }
18  div.c3 {text-align: center}
19  td.c2 {font-family: arial, helvetica, sans-serif; font-size: 80%}
20  td.c1 {font-family: lucida, helvetica; font-size: 248%}
21 </style>
22   </head>
23
24   <body>
25     <basefont face="lucida, helvetica, arial" size="3"> 
26
27     <div class="c3">
28       <table border="0" cellspacing="1" cellpadding="2">
29         <tr>
30           <td class="c1">BUSYBOX</td>
31         </tr>
32       </table>
33       <a href="/"><img src="images/busybox1.png" alt="BusyBox"
34       border="0" width="164" height="116"></a><br>
35        <!-- Begin Introduction section -->
36        
37
38       <table width="95%" cellspacing="1" cellpadding="4" border=
39       "1">
40         <tr>
41           <td bgcolor="#CCCCC0" align="center"><a name= "intro"><big>
42           <b>The Swiss Army Knife of Embedded Linux</b>
43           </big></a></td>
44         </tr>
45
46         <tr>
47           <td bgcolor="#EEEEE0">
48             BusyBox combines tiny versions of many common UNIX utilities
49             into a single small executable. It provides minimalist
50             replacements for most of the utilities you usually find in GNU
51             fileutils, shellutils, etc. The utilities in BusyBox generally
52             have fewer options than their full-featured GNU cousins;
53             however, the options that are included provide the expected
54             functionality and behave very much like their GNU counterparts.
55             BusyBox provides a fairly complete POSIX environment for any
56             small or embedded system.
57
58             <p>BusyBox has been written with size-optimization and
59             limited resources in mind. It is also extremely modular
60             so you can easily include or exclude commands (or
61             features) at compile time. This makes it easy to
62             customize your embedded systems. To create a working
63             system, just add /dev, /etc, and a kernel.</p>
64
65             <p>BusyBox is maintained by <a href=
66             "http://codepoet.org/andersen/erik/erik.html">Erik
67             Andersen</a>, and licensed under the <a href=
68             "http://www.gnu.org/copyleft/gpl.html">GNU GENERAL
69             PUBLIC LICENSE</a>.</p>
70
71             <h3>Screenshot</h3>
72
73             <p>Because everybody loves screenshots, a screenshot of
74             BusyBox is now available <a href=
75             "screenshot.html">right here</a>.</p>
76
77             <h3>Mailing List Information</h3>
78             BusyBox has a <a href="/lists/busybox/">mailing list</a>.<br>
79             To subscribe, go and visit <a href="/mailman/listinfo/busybox">this page</a>. 
80             <br> 
81             Before asking questions on the mailing list
82             you should probably first search the mailing list archives...
83             <form method="GET" action="http://www.google.com/custom">
84             <input type="hidden" name="domains" value="busybox.net">
85             <input type="hidden" name="sitesearch" value="busybox.net">
86             <a href="http://www.google.com"><img src="http://www.google.com/logos/Logo_25wht.gif" border="0" alt="Google" height="32" width="75" align="middle"></a>&nbsp;<input type="text" name="q" size="31" maxlength="255" value="">&nbsp;<input type="submit" name="sa" value="search the mailing list archives">...
87             </form>
88
89
90
91             <!-- Begin Latest News section -->
92           </td>
93         </tr>
94
95         <tr>
96           <td bgcolor="#CCCCC0" align="center"><a name=
97           "news"><big><b>Latest News</b></big></a></td>
98         </tr>
99
100         <tr>
101           <td bgcolor="#EEEEE0">
102             <ul>
103
104               <p>
105               <li><b>30 July 2003 -- BusyBox 1.0.0-pre2 released</b><p> 
106
107                 Here goes another pre release for the new BusyBox stable
108                 series.  The last prerelease (pre1) was given quite a lot of
109                 testing (thanks everyone!) which has helped turn up a number of
110                 bugs, and these problems have now been fixed.
111
112                 <p>
113
114                 Highlights of -pre2 include updating the 'ash' shell to sync up
115                 with the Debian 'dash' shell, a new 'hdparm' applet was added,
116                 init again supports pivot_root,  The 'reboot' 'halt' and
117                 'poweroff' applets can now be used without using busybox init.
118                 an ifconfig buffer overflow was fixed, losetup now allows
119                 read-write loop devices, uClinux daemon support was added, the
120                 'watchdog', 'fdisk', and 'kill' applets were rewritten, there were
121                 tons of doc updates, and there were many other bugs fixed.
122                 <p>
123                 
124                 If you have submitted a patch and it is not included in this
125                 release and Erik has not emailed you explaining why your patch
126                 was rejected, it is safe to say that he has lost your patch.
127                 That happens sometimes.   Please re-submit your patch to the
128                 BusyBox mailing list.
129                 <p>
130
131                 The point of the "-preX" versions is to get a larger group of
132                 people and vendors testing, so any problems that turn up can be
133                 fixed prior to the final 1.0.0 release.  The main feature that
134                 is still still on the TODO list before the final BusyBox 1.0.0
135                 release is adding module support for the new 2.6.x kernels.  If
136                 necessary, a -pre3 BusyBox release will happen on August 6th.
137                 Hopefully (i.e.  unless some horrible catastrophic problem
138                 turns up) the final BusyBox 1.0.0 release will be ready by
139                 then...
140                 <p>
141
142                 The <a href="downloads/Changelog">changelog</a> has all 
143                 the details.  As usual you can <a href="downloads">download busybox here</a>.
144
145                 <p>Have Fun!
146                 <p>
147
148
149
150               <p>
151               <li><b>Old News</b><br>
152                For the old news, visit <a href="oldnews.html">the
153               old news page</a>.</li>
154             </ul>
155           </td>
156         </tr>
157
158
159         <!-- Begin Sponsors section -->
160         <tr>
161           <td bgcolor="#CCCCC0" align="center"><a name=
162           "sponsors"><big><b>Sponsors</b></big></a></td>
163         </tr>
164
165         <tr>
166           <td bgcolor="#EEEEE0">
167             Please visit our sponsors and thank them for their
168             support! They have provided money for equipment and
169             bandwidth. Next time you need help with a project,
170             consider these fine companies! 
171
172
173             <ul>
174               <li><a href="http://www.penguru.net">Penguru Consulting</a><br>
175               Custom development for embedded Linux systems and multimedia platforms
176               </li>
177
178               <li><a href="http://opensource.se/">opensource.se</a><br>
179               Embedded open source consulting in Europe.
180               </li>
181
182               <li><a href="http://www.codepoet-consulting.com">Codepoet Consulting</a><br>
183               Custom Linux, embedded Linux, BusyBox, and uClibc
184               development.
185               </li>
186
187             </ul>
188             Several individuals have also contributed. If you have
189             already contributed and would like your name added
190             here, just let me know. If you would like to be a
191             BusyBox sponsor, email <a href=
192             "mailto:andersen@codepoet.org">Erik</a>. 
193           </td>
194         </tr>
195
196         <!-- Begin Download section -->
197         <p>
198         <tr>
199           <td bgcolor="#CCCCC0" align="center"><a name=
200           "download"><big><b>Download</b></big></a></td>
201         </tr>
202
203         <tr>
204           <td bgcolor="#EEEEE0">
205               Source for the latest release can always be
206               downloaded from <a href="downloads">http://www.busybox.net/downloads</a>.
207               <p>
208
209           BusyBox now has <b>two</b> CVS trees.  The "busybox-stable" tree
210           contains the older 0.60.x stable series.  The "busybox" tree contains
211           the latest 1.0.0-preX development version of busybox.<br>
212
213             <ul>
214                   <li><a href= "downloads/snapshots/">Daily Snapshots of the the latest 
215                     stable, and the latest development CVS source trees can be found right here</a>. 
216                   <br>
217                   </li><li><a href="/cgi-bin/cvsweb/busybox/">Click here to browse the CVS 
218                       tree for the 1.0.0-preX development version of BusyBox</a>
219                   </li><li><a href="/cgi-bin/cvsweb/busybox.stable/">Click here to browse
220                     the CVS tree for the stable 0.60.x version of BusyBox</a>.
221                     </li><li>Anonymous <a href="cvs_anon.html">CVS
222                     access</a> is available.
223                     </li><li>For those that are actively contributing there is
224                     even <a href="cvs_write.html">CVS write access</a>.</li>
225             </ul>
226           </td>
227         </tr>
228
229         <!-- Begin Docs section -->
230         <tr>
231           <td bgcolor="#CCCCC0" align="center"><a name=
232           "docs"><big><b>Documentation</b></big></a></td>
233         </tr>
234
235         <tr>
236           <td bgcolor="#EEEEE0">
237             Current documentation for BusyBox includes: 
238
239             <ul>
240               <li><a href=
241               "downloads/BusyBox.html">BusyBox.html</a>. This is a
242               list of the all the available commands in BusyBox
243               with complete usage information and examples of how
244               to use each app. I have spent a <em>lot</em> of time
245               updating these docs and trying to make them fairly
246               comprehensive. If you find any errors (factual,
247               grammatical, whatever) please let me know.</li>
248
249               <li><a href="downloads/README">README</a>. This is
250               the README file included in the busybox source
251               release.</li>
252
253               <li>If you need more help, the BusyBox <a href=
254               "lists/busybox/">mailing list</a> is a good place to
255               start.</li>
256             </ul>
257           </td>
258         </tr>
259
260         <!-- Begin Links section -->
261         <tr>
262           <td bgcolor="#CCCCC0" align="center"><a name=
263           "links"><big><b>Important Links</b></big></a></td>
264         </tr>
265
266         <tr>
267           <td bgcolor="#EEEEE0">
268             <ul>
269               <li><a href="http://perens.com/FreeSoftware/">Free
270               Software from Bruce Perens</a><br>
271                The original idea for BusyBox, and all versions up
272               to 0.26 were written by <a href=
273               "mailto:bruce@perens.com">Bruce Perens</a>. This is
274               his BusyBox website.</li>
275
276               <li><a href=
277               "http://freshmeat.net/projects/busybox/">Freshmeat
278               AppIndex record for BusyBox</a></li>
279
280               <li><a href=
281               "http://tinylogin.busybox.net/">TinyLogin</a> is a
282               nice embedded tool for handling authentication,
283               changing passwords, and similar tasks which nicely
284               complements BusyBox.</li>
285
286               <li><a href="http://udhcp.busybox.net/">udhcp</a> is
287               a tiny dhcp client and/or server which is ideal for
288               embedded systems.</li>
289
290               <li><a href="http://www.uclibc.org/">uClibc</a> is a
291               C library for embedded systems. You can actually
292               statically link a "Hello World" application under x86
293               that only takes 4k (as opposed to 200k under GNU
294               libc). It can do dynamic linking too and works nicely
295               with BusyBox to create very small embedded Linux systems.
296               </li>
297             </ul>
298           </td>
299         </tr>
300
301         <!-- Begin Projects section -->
302         <tr>
303           <td bgcolor="#CCCCC0" align="center"><a name=
304           "projects"><big><b>Products/Projects Using BusyBox</b></big></a></td>
305         </tr>
306
307         <tr>
308           <td bgcolor="#EEEEE0">
309             <p>I know of the following products and/or projects
310             that use BusyBox -- listed in the order I happen to add
311             them to the web page:</p>
312
313             <ul>
314             
315
316               <li><a href="/cgi-bin/cvsweb/buildroot/">buildroot</a> a configurable
317               means for building your own busybox/uClibc based system systems.
318
319               </li><li><a href=
320               "http://cvs.debian.org/boot-floppies/">
321               Debian installer (boot floppies) project</a>
322
323               </li><li><a href="http://redhat.com/">Red Hat 7.2
324               installer</a>
325
326               </li><li><a href=
327               "http://distro.ibiblio.org/pub/Linux/distributions/slackware/source/rootdsks/">
328               Slackware Installer</a>
329
330               </li><li><a href="http://www.gentoo.org/">Gentoo Linux install/boot CDs</a>
331               </li><li><a href="http://www.mandrake.com/">The Mandrake installer</a>
332
333               </li><li><a href="http://Leaf.SourceForge.net">Linux Embedded Appliance Firewall (the sucessor of the Linux Router Project) supporting all sorts of embedded Linux gateways, routers, wireless routers, and firewalls,</a>
334
335               </li><li><a href="http://linux-embedded.org/">LEM</a>
336
337               </li><li><a href=
338               "http://www.toms.net/rb/">tomsrtbt</a>
339
340               </li><li><a href="http://www.stormix.com/">Stormix
341               Installer</a>
342
343               </li><li><a href=
344               "http://www.emacinc.com/linux2_sbc.htm">EMAC Linux
345               2.0 SBC</a>
346
347               </li><li><a href="http://www.trinux.org/">Trinux</a>
348
349               </li><li><a href="http://oddas.sourceforge.net/">ODDAS
350               project</a>
351
352               </li><li><a href="http://byld.sourceforge.net/">Build Your
353               Linux Disk</a>
354
355               </li><li><a href=
356               "http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
357
358               </li><li><a href=
359               "http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
360
361               </li><li><a href="http://www.adtran.com">AdTran -
362               VPN/firewall VPN Linux Distribution</a>
363
364               </li><li><a href="http://mkcdrec.ota.be/">mkCDrec - make
365               CD-ROM recovery</a>
366
367               </li><li><a href=
368               "http://recycle.lbl.gov/~ldoolitt/bse/">Linux on
369               nanoEngine</a>
370
371               </li><li><a href=
372               "http://www.zelow.no/floppyfw/">Floppyfw</a>
373
374               </li><li><a href="http://midori.transmeta.com/">Midori
375               Linux</a> - <a href=
376               "http://www.wired.com/news/technology/0,1282,42399,00.html">
377               Article on Midori Linux</a> on <a href=
378               "http://www.wired.com">Wired</a>. Quote from Erik at
379               the top of <a href=
380               "http://www.wired.com/news/technology/0,1282,42399-2,00.html">
381               this page</a>
382
383               </li><li><a href="http://www.ltsp.org/">Linux Terminal
384               Server Project</a>
385
386               </li><li><a href=
387               "http://www.devil-linux.org/">Devil-Linux</a>
388
389               </li><li><a href=
390               "http://dutnux.sourceforge.net/">DutNux</a>
391
392               </li><li><a href=
393               "http://www.microwerks.net/~hugo/mindi/">Mindi</a>
394
395               </li><li><a href=
396               "http://www.tzi.de/~pharao90/ttylinux">ttylinux</a>
397
398               </li><li><a href="http://www.coyotelinux.com/">Coyote Linux</a>
399
400               </li><li><a href="http://www.partimage.org/">Partition
401               Image</a>
402
403               </li><li><a href="http://www.fli4l.de/">fli4l the on(e)-disk-router</a>
404
405               </li><li><a href="http://tinfoilhat.cultists.net/">Tinfoil
406               Hat Linux</a>
407
408               </li><li><a href="http://familiar.handhelds.org/">Familiar Linux</a> - a linux distribution for handheld computers
409               </li><li><a href="http://rescuecd.sourceforge.net/">Timo's Rescue CD Set</a>
410               </li><li><a href="http://sf.net/projects/netstation/">Netstation</a>
411               </li><li><a href="http://www.fiwix.org/">GNU/Fiwix Operating System</a>
412               </li><li><a href="http://www.softcraft.com/">Generations Linux</a>
413               </li><li><a href="http://systemimager.org/relatedprojects/">SystemImager / System Installation Suite</a>
414               </li><li><a href="http://www.bablokb.de/gendist/">GENDIST distribution generator</a>
415               </li><li><a href="http://diet-pc.sourceforge.net/">DIET-PC embedded Linux thin client distribution</a>
416               </li><li><a href="http://byzgl.sourceforge.net/">BYZantine Gnu/Linux</a>
417               </li><li><a href="http://dban.sourceforge.net/">Darik's Boot and Nuke</a>
418               </li><li><a href="http://www.timesys.com/">TimeSys real-time Linux</a>
419               </li><li><a href="http://movix.sf.net/">MoviX</a> -- boots from CD and automatically plays every video file on the CD
420               </li><li><a href="http://katamaran.sourceforge.net">katamaran</a>Linux, X11, xfce windowmanager, based on BusyBox
421               </li><li><a href="http://www.sourceforge.net/projects/simplygnustep">Prometheus SimplyGNUstep</a>
422               </li><li><a href="http://www.renyi.hu/~ekho/lowlife/">lowlife</a>A documentation project on how to make your own uClibc-based systems and floppy.
423               </li><li><a href="http://metadistros.hispalinux.es/">Metadistros</a>a project to allow you easily make Live-CD distributions.
424               </li><li><a href="http://salvare.sourceforge.net/">Salvare</a>More Linux than tomsrtbt but less than Knoppix, aims to provide a useful workstation as well as a rescue disk.
425               </li><li><a href="http://www.stresslinux.org/">stresslinux</a>minimal linux distribution running from a bootable cdrom or via PXE.
426               </li><li><a href="http://thinstation.sourceforge.net/">thinstation</a>convert standard PCs into full-featured diskless thinclients.
427               </li><li><a href="http://www.uhulinux.hu/">UHU-Linux Hungary</a>
428
429               </li><li><a href="http://tuxscreen.net">Tuxscreen Linux Phone</a>
430               </li><li><a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
431               </li><li><a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
432               </li><li><a href="http://www.isilver-inc.com/">I-Silver Linux appliance servers</a>
433               </li><li><a href="http://zaurus.sourceforge.net/">Sharp Zaurus PDA</a>
434               </li><li><a href="http://www.cyclades.com/">Cyclades-TS and other Cyclades products</a>
435               </li><li><a href="http://www.buffalo-technology.com/products/wireless/wbr-g54.htm">Buffalo WBR-G54 wireless router</a>
436               </li><li><a href="http://catalog.belkin.com/IWCatProductPage.process?Merchant_Id=&Section_Id=201522&pcount=&Product_Id=136493">Belkin 54g Wireless DSL/Cable Gateway Router</a>
437               </li><li><a href="http://www.linksys.com/products/product.asp?prid=508">Linksys WRT54G - Wireless-G Broadband Router</a>
438               </li><li><a href="http://www.dell.com/us/en/biz/topics/sbtopic_005_truemobile.htm">Dell TrueMobile 1184</a>
439
440
441             </ul>
442
443             <p>Do you use BusyBox? I'd love to know about it and
444             I'd be happy to link to you. <!-- End of Table -->
445             </p>
446           </td>
447         </tr>
448       </table>
449
450       <!-- Footer -->
451       <hr>
452       <table width="100%">
453         <tr>
454           <td class="c2">Mail all comments, insults, suggestions
455           and bribes to <a href="mailto:andersen@codepoet.org">Erik
456           Andersen</a><br>
457            The Busybox logo is copyright 1999-2002, Erik
458           Andersen.</td>
459
460           <td><a href="http://www.vim.org"><img border="0" width=
461           "90" height="36" src="images/written.in.vi.png" alt=
462           "This site created with the vi editor"></a></td>
463
464           <td><a href="http://www.gimp.org/"><img border="0" width=
465           "90" height="36" src="images/gfx_by_gimp.png" alt=
466           "Graphics by GIMP"></a></td>
467
468           <td><a href="http://www.linuxtoday.com"><img width="90"
469           height="36" src="images/ltbutton2.png" alt="Linux Today">
470           </a></td>
471
472           <td>
473             <p><a href="http://slashdot.org"><img width="90"
474             height="36" src="images/sdsmall.png" alt="Slashdot">
475             </a></p>
476           </td>
477
478           <td><a href="http://freshmeat.net"><img width="90"
479           height="36" src="images/fm.mini.png" alt="Freshmeat">
480           </a></td>
481         </tr>
482       </table>
483     </div>
484   </body>
485 </html>
486