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