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