b69c4ee7f2408c84b538c0e6e84011f24acec190
[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>
17                   <FONT FACE="lucida, helvetica" SIZE=+5>
18                   BUSYBOX
19                   </FONT>
20                 </TD>
21             </TR>
22       </TABLE>
23       <a href="/"><IMG SRC="images/busybox1.png" alt="BusyBox"
24       border="0" width="164" height="116"></a><BR>
25
26
27 <!-- Begin Introduction section -->
28
29
30 <TABLE WIDTH="95%" CELLSPACING=1 CELLPADDING=4 BORDER=1>
31 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
32     <A NAME="intro"> <BIG><B>
33     The Swiss Army Knife of Embedded Linux
34     </B></BIG></A>
35 </TD></TR>
36 <TR><TD BGCOLOR="#eeeee0">
37
38 BusyBox combines tiny versions of many common UNIX utilities into a single
39 small executable. It provides minimalist replacements for most of the utilities
40 you usually find in fileutils, shellutils, findutils, textutils, grep, gzip,
41 tar, etc. BusyBox provides a fairly complete POSIX environment for any small or
42 embedded system. The utilities in BusyBox generally have fewer options than
43 their full featured GNU cousins; however, the options that are included provide
44 the expected functionality and behave very much like their GNU counterparts.
45 <p>
46 BusyBox has been written with size-optimization and limited resources in mind.
47 It is also extremely modular so you can easily include or exclude commands (or
48 features) at compile time. This makes it easy to customize your embedded
49 systems. To create a working system, just add /dev, /etc, and a kernel.
50 <p>
51
52 BusyBox is maintained by 
53 <a href="http://codepoet.org/andersen/erik/erik.html">
54 Erik Andersen</a>, and licensed under the 
55 <a href="http://www.gnu.org/copyleft/gpl.html">GNU GENERAL PUBLIC LICENSE</a>.
56 <p>
57
58
59 <h3> Screenshot </h3>
60
61 <p> Because everybody loves screenshots, a screenshot of BusyBox 
62 is now available <a href="screenshot.html">right here</a>.
63
64
65 <H3>Mailing List Information</h3>
66 BusyBox now has a <a href="http://www.busybox.net/lists/busybox/">mailing list</a>!<br>
67 To subscribe, go and visit <a href="http://www.busybox.net/mailman/listinfo/busybox">this page</a>.
68
69 <H3>Sponsors</h3>
70 Please visit our sponsors and thank them for their support!  They have
71 provided money for equipment and bandwidth.  Next time you need help
72 with a project, consider these fine companies!
73 <ul>
74     <li><a href="http://opensource.se/">Öpensöurce AB</a><br>Embedded open source consulting in Europe.
75     <li><a href="http://www.codepoet-consulting.com">Codepoet Consulting</a><br>Custom Linux, embedded Linux, BusyBox, and uClibc development.
76 </ul>
77
78 Several individuals have also contributed.  If you have already contributed 
79 and would like your name added here, just let me know.  If you would like 
80 to be a BusyBox sponsor, email <a href="mailto:andersen@codepoet.org">Erik</a>.
81
82 <!-- Begin Latest News section -->
83
84 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
85     <A NAME="news">
86     <BIG><B>
87     Latest News
88     </B></BIG>
89     </A>
90 </TD></TR>
91 <TR><TD BGCOLOR="#eeeee0">
92
93 <ul>
94
95     <li> <b>3 January 2002 -- Welcome to busybox.net!</b>
96     <p>
97     
98     Thanks to the generosity of a number of busybox users, we have been
99     able to purchase busybox.net (which is where you are probably
100     reading this).  Right now, busybox.net and uclibc.org are both
101     living on my home system (at the end of my DSL line).   I
102     apologize for the abrupt move off of busybox.lineo.com.
103     Unfortunately, I no longer have the access needed to keep that
104     system updated (for example, you might notice the daily snapshots
105     there stopped some time ago).
106     
107     <p> 
108
109     Busybox.net is currently hosted on my home server, at the end of a
110     DSL line.  Unfortunately, the load on them is quite heavy.  To address 
111     this, I'm trying to make arrangements to get busybox.net co-located 
112     directly at an ISP.  To assist in the co-location effort, <a
113     href="http://www.codepoet.org/~markw">Mark Whitley</a> (author of
114     busybox sed, cut, and grep) has donated his <a
115     href="http://www.netwinder.org/">NetWinder</a> computer for hosting
116     busybox.net and uclibc.org.  Once this system is co-located, the
117     current speed problems should be completely eliminated.  Hopefully, 
118     too, some of you will volunteer to set up some mirror sites, to help 
119     to distribute the load a bit. 
120
121     <p>
122     <!-- 
123     <center>
124     Click here to help support busybox.net!
125     <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
126         <input type="hidden" name="cmd" value="_xclick">
127         <input type="hidden" name="business" value="andersen@codepoet.org">
128         <input type="hidden" name="item_name" value="Support Busybox">
129         <input type="hidden" name="image_url" value="https://codepoet-consulting.com/images/busybox2.jpg">
130         <input type="hidden" name="no_shipping" value="1">
131         <input type="image" src="images/donate.png" border="0" name="submit" alt="Make donation using PayPal">
132     </form>
133     </center>
134     -->
135
136     Since some people expressed concern over BusyBox donations, let me
137     assure you that no one is getting rich here.  All BusyBox and
138     uClibc donations will be spent paying for bandwidth and needed
139     hardware upgrades.  For example, Mark's NetWinder currently has
140     just 64Meg of memory. As demonstrated when google spidered the site
141     the other day, 64 Megs in not enough, so I'm going to be ordering
142     256Megs of ram and a larger hard drive for the box today.   So far,
143     donations received have been sufficient to cover almost all
144     expenses.  In the future, we may have co-location fees to worry
145     about, but for now we are ok.
146     A <b>HUGE thank-you</b> goes out to everyone that has
147     contributed!
148
149     <br>
150      -Erik
151
152     <p>
153     <li> <b>20 November 2001 -- BusyBox 0.60.2 released</b>
154     <p>
155
156     We am very pleased to announce that the BusyBox 0.60.2 (stable) is now
157     released to the world.  This one is primarily a bugfix release for the
158     stable series, and it should take care of most everyone's needs
159     till we can get the nice new stuff we have been working on in CVS ready to
160     release (with the wonderful new buildsystem).  The biggest change in this
161     release (beyond bugfixes) is the fact that msh (the minix shell) has been
162     re-worked by Vladimir N. Oleynik (vodz) and so it no longer crashes when
163     told to do complex things with backticks.
164     <p>
165     
166     This release has been tested on x86, ARM, and powerpc using glibc 2.2.4, 
167     libc5, and uClibc, so it should work with just about any Linux system you throw it at.  
168     See the <a href="http://www.busybox.net/downloads/Changelog">changelog</a> 
169     for <small>most of</small> the details.  The last release was
170     <em>very</em> solid for people, and this one should be even better.
171     <p>
172     As usual BusyBox 0.60.2 can be downloaded from 
173              <a href="http://www.busybox.net/downloads">http://www.busybox.net/downloads</a>.
174     <p>
175     Have Fun.<br> -Erik
176     <p>
177
178
179
180     <li> <b>Old News</b>
181     <br>
182              For the old news, visit <a href="http://www.busybox.net/oldnews.html">the old news page</a>.
183 </ul>
184
185
186 <!-- Begin Download section -->
187
188 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
189     <A NAME="download"><BIG><B>
190     Download
191     </B></BIG></A>
192 </TD></TR>
193 <TR><TD BGCOLOR="#eeeee0">
194 <ul>
195
196         <li> Source for the latest release can always be downloaded from 
197         <a href="http://www.busybox.net/downloads">http://www.busybox.net/downloads</a>.
198
199         <li> A new snapshot of the source is made daily and is available as a GNU
200         gzipped tarball <a href="busybox.tar.gz"> right here</a>.
201
202         <li> BusyBox now has its own publically browsable
203         <a href="http://www.busybox.net/cgi-bin/cvsweb/busybox/">CVS tree</a>,  
204         anonymous
205         <a href="http://www.busybox.net/cvs_anon.html">CVS access</a>, and
206         for those that are actively contributing there is even 
207         <a href="http://www.busybox.net/cvs_write.html">CVS write access</a>.
208
209 </ul>
210
211
212 <!-- Begin Docs section -->
213
214 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
215     <A NAME="docs"><BIG><B>
216     Documentation
217     </B></BIG></A>
218 </TD></TR>
219 <TR><TD BGCOLOR="#eeeee0">
220 Current documentation for BusyBox includes: 
221 <ul>
222     <li> <a href="http://www.busybox.net/downloads/BusyBox.html">BusyBox.html</a>.
223                 This is a list of the all the available commands in BusyBox with 
224                 complete usage information and examples of how to use each app.  I 
225                 have spent a <em>lot</em> of time updating these docs and trying to 
226                 make them fairly comprehensive.  If you find any errors (factual, 
227                 grammatical, whatever) please let me know.
228     <li> <a href="http://www.busybox.net/downloads/README">README</a>.
229                 This is the README file included in the busybox source release.
230     <li> <a href="http://bugs.busybox.net/db/pa/lbusybox.html">BusyBox Bugs</a>.
231                 Need to report a bug?  Need to check if a bug has been filed?
232     <li> If you need more help, the BusyBox
233     <a href="http://www.busybox.net/lists/busybox/">mailing list</a> is
234     a good place to start.
235 </ul>
236
237
238 <!-- Begin Links section -->
239
240 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
241     <A NAME="links">
242     <BIG><B>
243     Important Links
244     </B></BIG>
245     </A>
246 </TD></TR>
247 <TR><TD BGCOLOR="#eeeee0">
248
249 <ul> 
250
251     <li>  <A HREF="http://perens.com/FreeSoftware/">
252     Free Software from Bruce Perens</A><br>
253     The original idea for BusyBox, and all versions up to 0.26 were written 
254     by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>.  This is his BusyBox website.
255     <p>
256
257     <li>  <A HREF="http://freshmeat.net/projects/busybox/">
258     Freshmeat AppIndex record for BusyBox</A>
259     <p>
260     <li><a href="http://tinylogin.busybox.net/">TinyLogin</a>
261         is a nice embedded tool for handling authentication, changing passwords,
262         and similar tasks which nicely complements BusyBox.
263     <p>
264
265     <li><a href="http://udhcp.busybox.net/">udhcp</a>
266     is a tiny dhcp client and/or server which is ideal for embedded systems.
267     <p>
268
269     <li><a href="http://www.uclibc.org/">uClibc</a>
270         is a C library for embedded systems.  You can actually statically link
271         a "Hello World" application under x86 that only takes 4k (as opposed to
272         200k under GNU libc).  It can do dynamic linking too and works nicely with
273         BusyBox to create very small embedded systems.
274     <p>
275
276 </ul>
277
278
279 <!-- Begin Projects section -->
280
281 <TR><TD BGCOLOR="#ccccc0" ALIGN=center>
282     <A NAME="projects"><BIG><B>
283     Products/Projects Using BusyBox
284     </B></BIG></A>
285 </TD></TR>
286 <TR><TD BGCOLOR="#eeeee0">
287
288 <p> I know of the following products and/or projects that use BusyBox --
289 listed in the order I happen to add them to the web page:
290
291 <ul>
292     <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
293     <li> <a href="http://redhat.com/">Red Hat 7.2 installer</a>
294     <li> <a href="http://distro.ibiblio.org/pub/Linux/distributions/slackware/source/rootdsks/">Slackware Installer</a>
295     <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
296     <li> <a href="http://linux-embedded.org/">LEM</a>
297     <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
298     <li> <a href="http://www.stormix.com/">Stormix Installer</a>
299     <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
300     <li> <a href="http://www.trinux.org/">Trinux</a>
301     <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
302     <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
303     <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
304     <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
305     <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
306     <li> <a href="http://ibiblio.org/pub/Linux/system/recovery">Zdisk</a>
307     <li> <a href="http://www.adtran.com">AdTran - VPN/firewall VPN Linux Distribution</a> 
308     <li> <a href="http://mkcdrec.ota.be/">mkCDrec - make CD-ROM recovery</a>
309     <li> <a href="http://recycle.lbl.gov/~ldoolitt/bse/">Linux on nanoEngine</a>
310     <li> <a href="http://www.zelow.no/floppyfw/"> Floppyfw</a>
311
312     <li> <a href="http://midori.transmeta.com/"> Midori Linux</a> - <a href=
313         "http://www.wired.com/news/technology/0,1282,42399,00.html"> Article on
314         Midori Linux</a> on <a href= "http://www.wired.com"> Wired</a>. Quote from
315         Erik at the top of <a href=
316         "http://www.wired.com/news/technology/0,1282,42399-2,00.html"> this
317         page</a>
318
319     <li> <a href="http://www.ltsp.org/">Linux Terminal Server Project</a>
320     <li> <a href="http://www.devil-linux.org/">Devil-Linux</a>
321     <li> <a href="http://dutnux.sourceforge.net/">DutNux</a>
322     <li> <a href="http://www.cachier.com/">Cachier</a>
323     <li> <a href="http://www.microwerks.net/~hugo/mindi/">Mindi</a>
324     <li> <a href="http://www.tzi.de/~pharao90/ttylinux">ttylinux</a>
325     <li> <a href="http://www.partimage.org/">Partition Image</a>
326
327 </ul>
328
329 <p> Do you use BusyBox?  I'd love to know about it and I'd be happy to link to
330 you.
331
332
333
334 <!-- End of Table -->
335
336 </TD></TR>
337 </TABLE>
338
339
340
341 <!-- Footer -->
342 <HR>
343 <TABLE WIDTH="100%">
344     <TR>
345         <TD>
346             <font size="-1" face="arial, helvetica, sans-serif">
347             Mail all comments, insults, suggestions and bribes to 
348             <a href="mailto:andersen@codepoet.org">Erik Andersen</a><BR>
349             The Busybox logo is copyright 1999,2000,2001, Erik Andersen.
350             </font>
351         </TD>
352
353         <TD>
354             <a href="http://www.vim.org"><img border=0 width=90 height=36
355             src="images/written.in.vi.png" 
356             alt="This site created with the vi editor"></a>
357         </TD>
358
359         <TD>
360             <a href="http://www.gimp.org/"><img border=0 width=90 height=36
361             src="images/gfx_by_gimp.png" alt="Graphics by GIMP"></a>
362         </TD>
363
364         <TD>
365             <a href="http://www.linuxtoday.com"><img width=90 height=36
366             src="images/ltbutton2.png" alt="Linux Today"></a>
367         </TD>
368
369         <TD>
370             <p><a href="http://slashdot.org"><img width=90 height=36
371             src="images/sdsmall.png" alt="Slashdot"></a>
372         </TD>
373
374         <TD>
375             <a href="http://freshmeat.net"><img width=90 height=36
376             src="images/fm.mini.png" alt="Freshmeat"></a>
377         </TD>
378
379     </TR>
380 </TABLE>
381
382
383 </CENTER>
384 </BODY>
385 </HTML>
386