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