aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Andersen <andersen@codepoet.org>2000-12-13 18:07:38 +0000
committerEric Andersen <andersen@codepoet.org>2000-12-13 18:07:38 +0000
commit235f66dea39fb4eab6fbdba9ea1c7f9be1771250 (patch)
tree79ad054969f5397afd4486a845d31442c2e41b3f
parentd0fa0a12f1ce40a9e0d73674ad2f5e4a294cdbb5 (diff)
downloadbusybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.tar.gz
busybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.tar.bz2
busybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.zip
A few more updates
-rw-r--r--Changelog1
-rw-r--r--README50
-rw-r--r--TODO35
3 files changed, 65 insertions, 21 deletions
diff --git a/Changelog b/Changelog
index 8676c0349..0cc773676 100644
--- a/Changelog
+++ b/Changelog
@@ -51,6 +51,7 @@
51 * Matt Kraai -- logger now logs all arguments, not just the first 51 * Matt Kraai -- logger now logs all arguments, not just the first
52 * Gennady Feldman -- syslogd no longer logs to localhost if compiled 52 * Gennady Feldman -- syslogd no longer logs to localhost if compiled
53 for remote logging... 53 for remote logging...
54 * Richard June <rjune@ims1.imagestream-is.com> -- support for 'gzip -d'
54 * various artists -- Other good stuff that I forgot to document. 55 * various artists -- Other good stuff that I forgot to document.
55 56
56 57
diff --git a/README b/README
index 29ba11cee..5ffa6c1b6 100644
--- a/README
+++ b/README
@@ -11,17 +11,17 @@ the expected functionality and behave very much like their GNU counterparts.
11BusyBox has been written with size-optimization and limited resources in mind. 11BusyBox has been written with size-optimization and limited resources in mind.
12It is also extremely modular so you can easily include or exclude commands (or 12It is also extremely modular so you can easily include or exclude commands (or
13features) at compile time. This makes it easy to customize your embedded 13features) at compile time. This makes it easy to customize your embedded
14systems. To create a working system, just add a kernel, a shell (such as ash), 14systems. To create a working system, just add a kernel and an editor (such as
15and an editor (such as elvis-tiny or ae). 15e3 (http://www.sax.de/~adlibiti) or elvis-tiny).
16 16
17BusyBox was originally written to support the Debian Rescue/Install disks, but 17BusyBox was originally written to support the Debian Rescue/Install disks, but
18it also makes an excellent environment for any small or embedded system. 18it also makes an excellent environment for any small or embedded system.
19 19
20As of version 0.20 there is a version number. : ) Also as of version 0.20, 20As of version 0.20 there is now a version number. : ) Also as of version 0.20,
21BusyBox is now modularized to easily allow you to build only the components you 21BusyBox is now modularized to easily allow you to build only the components you
22need, thereby reducing binary size. To turn off unwanted BusyBox components, 22need, thereby reducing binary size. To turn off unwanted BusyBox components,
23simply edit the file "Config.h" and comment out the components you do not 23simply edit the file "Config.h" and comment out the components you do not need
24need using C++ style (//) comments. 24using C++ style (//) comments.
25 25
26After the build is complete, a busybox.links file is generated. This is 26After the build is complete, a busybox.links file is generated. This is
27used by 'make install' to create symlinks to the busybox binary for all 27used by 'make install' to create symlinks to the busybox binary for all
@@ -30,24 +30,57 @@ forest into `pwd`/_install unless you have defined the PREFIX environment
30variable (i.e., make PREFIX="/tmp/foo" install) 30variable (i.e., make PREFIX="/tmp/foo" install)
31 31
32---------------- 32----------------
33
33Getting help: 34Getting help:
35
34When you find you need help, you can check out the BusyBox mailing list 36When you find you need help, you can check out the BusyBox mailing list
35archives at http://opensource.lineo.com/lists/busybox/ or even join 37archives at http://opensource.lineo.com/lists/busybox/ or even join
36the mailing list if you are interested. 38the mailing list if you are interested.
37 39
38---------------- 40----------------
41
39Bugs: 42Bugs:
40If you find bugs, follow the instructions at http://bugs.lineo.com/Reporting.html 43
41and submit a bug report. This way, we can be sure nothing falls through the 44If you find bugs, please submit a bug report. Full instructions on how to
42cracks... 45report a bug are found at http://bugs.lineo.com/Reporting.html.
46
47For the impatient: To submit a bug, simply send an email describing the problem
48to submit@bugs.lineo.com. Bug reports should look something like this:
49
50 To: submit@bugs.lineo.com
51 From: diligent@testing.linux.org
52 Subject: /bin/true doesn't work
53
54 Package: busybox
55 Version: 0.48
56
57 When I invoke '/bin/true' it doesn't work. I expected it to return
58 a "0" but it returned a "1" instead. Here is the transcript:
59 $ /bin/true ; echo $?
60 1
61 With GNU /bin/true, I get the following output:
62 $ /bin/true ; echo $?
63 0
64 I am using Debian 2.2r2, kernel version 2.2.18, and the latest
65 uClibc from CVS. Thanks for the wonderful program!
66 -Diligent
67
68Note the careful description and use of examples showing not only what BusyBox
69does, but also a counter example showing what an equivalent GNU app does. Bug
70reports lacking such detail may take a _long_ time to be fixed... Thanks for
71understanding.
43 72
44---------------- 73----------------
74
45FTP: 75FTP:
76
46Source for the latest released version can always be downloaded from 77Source for the latest released version can always be downloaded from
47 ftp://ftp.lineo.com/pub/busybox. 78 ftp://ftp.lineo.com/pub/busybox.
48 79
49---------------- 80----------------
81
50CVS: 82CVS:
83
51BusyBox now has its own publicly browsable CVS tree at: 84BusyBox now has its own publicly browsable CVS tree at:
52 http://opensource.lineo.com/cgi-bin/cvsweb/busybox/ 85 http://opensource.lineo.com/cgi-bin/cvsweb/busybox/
53 86
@@ -57,7 +90,6 @@ Anonymous CVS access is available. For instructions, check out:
57For those that are actively contributing there is even CVS write access: 90For those that are actively contributing there is even CVS write access:
58 http://opensource.lineo.com/cvs_write.html 91 http://opensource.lineo.com/cvs_write.html
59 92
60
61---------------- 93----------------
62 94
63Please feed suggestions, bug reports, insults, and bribes back to: 95Please feed suggestions, bug reports, insults, and bribes back to:
diff --git a/TODO b/TODO
index 0756fd091..55b32df96 100644
--- a/TODO
+++ b/TODO
@@ -6,36 +6,47 @@ around to it some time. If you have any good ideas, please let me know.
6* login/sulogin/passwd/getty/etc are part of tinylogin, and so are not 6* login/sulogin/passwd/getty/etc are part of tinylogin, and so are not
7 needed or wanted in busybox (or else I'd have to link to libcrypt). 7 needed or wanted in busybox (or else I'd have to link to libcrypt).
8 8
9* Networking apps are probably going to be split out some time soon into a 9* Networking apps are going to be split out to a new package called netkit-tiny
10 separate package (named perhaps netkit-tiny?). This would remove the 10 before the next release of Busybox. This will remove the following items
11 following items from BusyBox: hostid, hostname, nc, nslookup, telnet, and 11 from BusyBox: hostid, hostname, nc, nslookup, telnet, and ping. nfs
12 ping. nfs mounting and syslogd (network logging) will remain in BusyBox. 12 mounting and syslogd (network logging) will remain in BusyBox.
13 13
14 -Erik 14 -Erik
15 15
16----------- 16-----------
17 17
18* dnsdomainname 18Possible apps to include some time:
19* traceroute/netstat 19
20* hwclock 20* hwclock
21* stty 21* stty
22* tftp
23* ftp
24* group/commonize strings, remove dups (for i18n, l10n) 22* group/commonize strings, remove dups (for i18n, l10n)
25 23
26----------------------- 24-----------------------
27 25
26The Busybox lash shell needs to be taught Bourne shell grammer. This
27is planned for the next release of Busybox. Look out ash, we are coming
28for you...
29
30-----------------------
31
28Running the following: 32Running the following:
29 33
30 rm -f busybox && make LDFLAGS+=-nostdlib 2>&1 | \ 34 rm -f busybox && make LDFLAGS+=-nostdlib 2>&1 | \
31 sed -ne 's/.*undefined reference to `\(.*\)..*/\1/gp' | sort | uniq 35 sed -ne 's/.*undefined reference to `\(.*\)..*/\1/gp' | sort | uniq
32 36
33reveals the list of all external (i.e. libc) things that BusyBox depends on. 37reveals the list of all external (i.e. libc) things that BusyBox depends on.
34It would be a very nice thing to reduce this list to an absolute minimum, and 38It would be a very nice thing to reduce this list to an absolute minimum, to
35then create a microLibc to provide these functions. There is no good reason 39reduce the footprint of busybox when staticly linking with libraries such as
36for GNU libc to be so big. I'm sure it can be a lot better. 40uClibc.
37 41
38(BTW, this is more informative if BB_FEATURE_NFSMOUNT is turned off...) 42-----------------------
43
44Currently, busybox bypasses libc NSS. Some folks might want that,
45so perhaps adding in the option to choose whether to go to libc for
46things like getpwnam() or whether to use the busybox version might
47be nice.
48
49-----------------------
39 50
40Most wanted list: 51Most wanted list:
41 52