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