Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / external / busybox / bdcc6fbd95e811f492559db53b29f4f2ff077c94 / . / docs / busybox.net / index.html
blob: f880ac915753b0cb7f9f246bdefc9d26077f6591 [file] [log] [blame]
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]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
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]8<body text="#000000" alink="#660000" link="#660000" bgcolor="#dee2de" vlink="#660000">
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]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 </font>
34 </A></B></BIG>
35</TD></TR>
36<TR><TD BGCOLOR="#eeeee0">
37
38BusyBox combines tiny versions of many common UNIX utilities into a single
39small executable. It provides minimalist replacements for most of the utilities
40you usually find in fileutils, shellutils, findutils, textutils, grep, gzip,
41tar, etc. BusyBox provides a fairly complete POSIX environment for any small
Pavel Roskin82c0ac72000-06-05 20:19:47 +0000[diff] [blame]42or embedded system. The utilities in BusyBox generally have fewer options than
Eric Andersen36fe1a32000-06-05 17:22:37 +0000[diff] [blame]43their full-featured GNU cousins; however, the options that are included provide
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]44the expected functionality and behave very much like their GNU counterparts.
45<p>
46BusyBox has been written with size-optimization and limited resources in mind.
47It is also extremely modular so you can easily include or exclude commands (or
48features) at compile time. This makes it easy to customize your embedded
49systems. To create a working system, just add a kernel, a shell (such as ash),
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]50and an editor (such as elvis-tiny or ae). For a really minimal system, just
51the the busybox shell (not a POSIX shell, but very small and quite usable).
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]52<p>
53
54BusyBox is now maintained by
55<a href="http://www.xmission.com/~andersen/erik/erik.html">
56Erik Andersen</a>, and its ongoing development is being sponsored by
57<a href="http://www.lineo.com/">Lineo</a>.
58<p>
59BusyBox is licensed under the
60<a href="http://www.gnu.org/copyleft/gpl.html">GNU GENERAL PUBLIC LICENSE</a>
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]61<p>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]62
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]63<H3>NEW!</h3>
64BusyBox now has a mailing list <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a>!
65To subscribe, go and visit <a href="http://opensource.lineo.com/mailman/listinfo/busybox">this page</a>.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]66
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]67<!-- Begin Latest News section -->
68
69<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
70 <A NAME="news">
71 <BIG><B>
72 Latest News</A>
73 </B></BIG>
74 </A>
75</TD></TR>
76<TR><TD BGCOLOR="#eeeee0">
77
78<ul>
79
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]80 <p> <li> <b>26 September 2000 -- BusyBox 0.47 released</b>
81 <br>
82
83 This release fixes lots of bugs (including an ugly bug in 0.46
84 syslogd that could fork-bomb your system). Added several new
85 apps: rdate, wget, getopt, dos2unix, unix2dos, reset, unrpm,
86 renice, xargs, and expr. syslogd now supports network logging.
87 There are the usual tar updates. Most apps now use getopt for
88 more correct option parsing.
89 See the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>
90 for complete details.
91
92
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]93 <p> <li> <b>11 July 2000 -- BusyBox 0.46 released</b>
94 <br>
95
96 This release fixes several bugs (including a ugly bug in tar,
97 and fixes for NFSv3 mount support). Added a dumpkmap to allow
98 people to dump a binary keymaps for use with 'loadkmap', and a
Matt Kraai9dd79792000-09-06 00:50:51 +0000[diff] [blame]99 completely reworked 'grep' and 'sed' which should behave better.
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]100 BusyBox shell can now also be used as a login shell.
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]101 See the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a>
102 for complete details.
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]103
104
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]105 <p> <li> <b>21 June 2000 -- BusyBox 0.45 released</b>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]106 <br>
107
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]108 This release has been slow in coming, but is very solid at this
109 point. BusyBox now supports libc5 as well as GNU libc. This
110 release provides the following new apps: cut, tr, insmod, ar,
Matt Kraai17c88512000-09-06 03:59:49 +0000[diff] [blame]111 mktemp, setkeycodes, md5sum, uuencode, uudecode, which, and
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]112 telnet. There are bug fixes for just about every app as well (see
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]113 the <a href="ftp://oss.lineo.com/busybox/Changelog">changelog</a> for
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]114 details).
115 <p>
116 Also, some exciting infrastructure news! Busybox now has its own
117 <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a>,
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]118 publically browsable
119 <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,
120 anonymous
121 <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
122 for those that are actively contributing there is even
123 <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
124 I think this will be a huge help to the ongoing development of BusyBox.
125 <p>
126 Also, for the curious, there is no 0.44 release. Somehow 0.44 got announced
127 a few weeks ago prior to its actually being released. To avoid any confusion
128 we are just skipping 0.44.
129 <p>
130 Many thanks go out to the many people that have contributed to this release
131 of BusyBox (esp. Pavel Roskin)!
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]132
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]133
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]134
135 <p> <li> <b>Old News</b>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]136 <br>
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]137 For the old news, visit <a href="http://busybox.lineo.com/oldnews.html">the old news page</a>.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]138</ul>
139
140
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]141<!-- Begin Download section -->
142
143<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
144 <A NAME="download"><BIG><B>
145 Download
146 </A></B></BIG>
147</TD></TR>
148<TR><TD BGCOLOR="#eeeee0">
149<ul>
150 <li> Source for the latest release can always be downloaded from
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]151 <a href="ftp://oss.lineo.com/busybox">ftp://oss.lineo.com/busybox</a>.
Eric Andersen4a971ae2000-06-22 01:27:11 +0000[diff] [blame]152 <li> BusyBox now has its own publically browsable
153 <a href="http://opensource.lineo.com/cgi-bin/cvsweb/busybox/">CVS tree</a>,
154 anonymous
155 <a href="http://opensource.lineo.com/cvs_anon.html">CVS access</a>, and
156 for those that are actively contributing there is even
157 <a href="http://opensource.lineo.com/cvs_write.html">CVS write access</a>.
158</ul>
159
160
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]161<!-- Begin Docs section -->
162
163<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
164 <A NAME="docs"><BIG><B>
165 Documentation
166 </A></B></BIG>
167</TD></TR>
168<TR><TD BGCOLOR="#eeeee0">
169Current documentation for BusyBox includes:
170<ul>
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]171 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.html">BusyBox.html</a>.
172 This is a list of the all the available commands in BusyBox with
173 complete usage information and examples of how to use each app. I
174 have spent a <em>lot</em> of time updating these docs and trying to
175 make them fairly comprehensive. If you find any errors (factual,
176 grammatical, whatever) please let me know.
177 <li> <a href="ftp://oss.lineo.com/busybox/BusyBox.pdf">BusyBox.pdf</a>.
178 This is basically the same document, but in pdf format.
Eric Andersen3312b0b2000-07-07 19:23:10 +0000[diff] [blame]179 <li> <a href="http://bugs.lineo.com/db/pa/lbusybox.html">BusyBoxBugs</a>.
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]180 Need to report a bug? Need to check if a bug has been filed?
Eric Andersenaec27bc2000-07-11 18:18:40 +0000[diff] [blame]181 <li> If you need more help, the BusyBox
182 <a href="http://opensource.lineo.com/lists/busybox/">mailing list</a> is
183 a good place to start.
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]184</ul>
185
186
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]187<!-- Begin Projects section -->
188
189<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
Eric Andersen3312b0b2000-07-07 19:23:10 +0000[diff] [blame]190 <A NAME="projects"><BIG><B>
Eric Andersen8fbaeec2000-07-11 23:05:38 +0000[diff] [blame]191 Products/Projects using BusyBox
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]192 </A></B></BIG>
193</TD></TR>
194<TR><TD BGCOLOR="#eeeee0">
Eric Andersen97426e02000-07-11 23:06:48 +0000[diff] [blame]195I know of the following products and/or projects that use BusyBox -- listed
196in the order I happen to add them to the web page:
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]197<ul>
Matt Kraaida9841e2000-07-11 16:09:01 +0000[diff] [blame]198 <li> <a href="http://www.lineo.com/products/embedix_linux/">Lineo Embedix Linux</a>
Eric Andersenbdcc6fb2000-09-26 06:15:12 +0000[diff] [blame^]199 <li> <a href="http://cvs.debian.org/boot-floppies/">Debian installer (boot floppies) project</a>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]200 <li> <a href="http://www.linuxrouter.org/">Linux Router Project </a>
201 <li> <a href="http://linux-embedded.org/">LEM</a>
202 <li> <a href="http://www.toms.net/rb/">tomsrtbt</a>
Eric Andersene511e7c2000-05-25 00:18:59 +0000[diff] [blame]203 <li> <a href="http://www.stormix.com/">Stormix Installer</a>
204 <li> <a href="http://www.emacinc.com/linux2_sbc.htm">EMAC Linux 2.0 SBC</a>
Eric Andersen53310252000-07-04 19:42:23 +0000[diff] [blame]205 <li> <a href="http://www.trinux.org/">Trinux</a>
Eric Andersenbb39a312000-08-11 18:13:21 +0000[diff] [blame]206 <li> <a href="http://oddas.sourceforge.net/">ODDAS project</a>
Eric Andersen68fda242000-07-11 23:03:40 +0000[diff] [blame]207 <li> <a href="http://www.kerbango.com/">The Kerbango Internet Radio</a>
Eric Andersenec8d60f2000-07-21 17:22:19 +0000[diff] [blame]208 <li> <a href="http://www.linuxmagic.com/vpn/">LinuxMagic VPN Firewall</a>
Eric Andersenfd50c3d2000-09-01 22:24:03 +0000[diff] [blame]209 <li> <a href="http://byld.sourceforge.net/">Build Your Linux Disk</a>
Eric Andersenb4c3c592000-09-13 23:06:41 +0000[diff] [blame]210 <li> <a href="http://homepages.ihug.co.nz/~ichi/baslinux.html">BasicLinux</a>
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]211
212</ul>
213Do you use BusyBox? I'd love to know about it and I'd be happy to link to you.
214
215
216
217<!-- Begin Links section -->
218
219<TR><TD BGCOLOR="#ccccc0" ALIGN=center>
220 <A NAME="links">
221 <BIG><B>
222 Important Links</A>
223 </B></BIG>
224 </A>
225</TD></TR>
226<TR><TD BGCOLOR="#eeeee0">
227
228<ul>
229
230 <li> <A HREF="http://perens.com/FreeSoftware/">
231 Free Software from Bruce Perens</A><br>
232 The original idea for BusyBox, and all versions up to 0.26 were written
233 by <A HREF="mailto:bruce@perens.com">Bruce Perens</a>. This is his BusyBox website.
234 <p>
235
236 <li> <A HREF="http://freshmeat.net/appindex/1999/04/11/923859921.html">
237 Freshmeat AppIndex record for BusyBox</A>
238 <p>
239
Eric Andersen766c0122000-06-21 22:43:07 +0000[diff] [blame]240 <li> <a href="http://opensource.lineo.com/software.html">Other cool embedded software</a>.
241 <p>
242
243 <li> <a href="http://opensource.lineo.com/">opensource.lineo.com</a>.
244 <p>
245
Erik Andersen330fd2b2000-05-19 05:35:19 +0000[diff] [blame]246 <li> <A HREF="http://www.lineo.com/">Lineo</A> is sponsoring BusyBox development.
247 <p>
248
249</ul>
250
251
252
253
254<!-- End of Table -->
255
256</TD></TR>
257</TABLE>
258</P>
259
260
261
262<!-- Footer -->
263<HR>
264<TABLE WIDTH="100%">
265 <TR>
266 <TD>
267 <font size="-1" face="arial, helvetica, sans-serif">
268 Mail all comments, insults, suggestions and bribes to
269 <a href="mailto:andersen@lineo.com">Erik Andersen</a><BR>
270 The Busybox logo is copyright 1999,2000, Erik Andersen.
271 </font>
272 </TD>
273
274 <TD>
275 <a href="http://www.vim.org"><img border=0 width=88 height=32
276 src="images/anim.written.in.vi.gif"
277 alt="This site created with the vi editor"></a>
278 </TD>
279
280 <TD>
281 <a href="http://www.gimp.org/"><img border=0 width=88 height=38
282 src="images/gfx_by_gimp.gif" alt="Graphics by GIMP"></a>
283 </TD>
284
285 <TD>
286 <a href="http://www.linuxtoday.com"><img width=90 height=36
287 src="images/ltbutton2.jpg" alt="Linux Today"></a>
288 </TD>
289
290 <TD>
291 <p><a href="http://slashdot.org"><img width=90 height=36
292 src="images/sdsmall.gif" alt="Slashdot"></a>
293 </TD>
294
295 <TD>
296 <a href="http://freshmeat.net"><img width=90 height=36
297 src="images/fm.mini.jpg" alt="Freshmeat"></a>
298 </TD>
299
300 </TR>
301</TABLE>
302
303
304</BODY>
305</HTML>
306