diff options
author | Eric Andersen <andersen@codepoet.org> | 2000-12-13 18:07:38 +0000 |
---|---|---|
committer | Eric Andersen <andersen@codepoet.org> | 2000-12-13 18:07:38 +0000 |
commit | 235f66dea39fb4eab6fbdba9ea1c7f9be1771250 (patch) | |
tree | 79ad054969f5397afd4486a845d31442c2e41b3f | |
parent | d0fa0a12f1ce40a9e0d73674ad2f5e4a294cdbb5 (diff) | |
download | busybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.tar.gz busybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.tar.bz2 busybox-w32-235f66dea39fb4eab6fbdba9ea1c7f9be1771250.zip |
A few more updates
-rw-r--r-- | Changelog | 1 | ||||
-rw-r--r-- | README | 50 | ||||
-rw-r--r-- | TODO | 35 |
3 files changed, 65 insertions, 21 deletions
@@ -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 | ||
@@ -11,17 +11,17 @@ the expected functionality and behave very much like their GNU counterparts. | |||
11 | BusyBox has been written with size-optimization and limited resources in mind. | 11 | BusyBox has been written with size-optimization and limited resources in mind. |
12 | It is also extremely modular so you can easily include or exclude commands (or | 12 | It is also extremely modular so you can easily include or exclude commands (or |
13 | features) at compile time. This makes it easy to customize your embedded | 13 | features) at compile time. This makes it easy to customize your embedded |
14 | systems. To create a working system, just add a kernel, a shell (such as ash), | 14 | systems. To create a working system, just add a kernel and an editor (such as |
15 | and an editor (such as elvis-tiny or ae). | 15 | e3 (http://www.sax.de/~adlibiti) or elvis-tiny). |
16 | 16 | ||
17 | BusyBox was originally written to support the Debian Rescue/Install disks, but | 17 | BusyBox was originally written to support the Debian Rescue/Install disks, but |
18 | it also makes an excellent environment for any small or embedded system. | 18 | it also makes an excellent environment for any small or embedded system. |
19 | 19 | ||
20 | As of version 0.20 there is a version number. : ) Also as of version 0.20, | 20 | As of version 0.20 there is now a version number. : ) Also as of version 0.20, |
21 | BusyBox is now modularized to easily allow you to build only the components you | 21 | BusyBox is now modularized to easily allow you to build only the components you |
22 | need, thereby reducing binary size. To turn off unwanted BusyBox components, | 22 | need, thereby reducing binary size. To turn off unwanted BusyBox components, |
23 | simply edit the file "Config.h" and comment out the components you do not | 23 | simply edit the file "Config.h" and comment out the components you do not need |
24 | need using C++ style (//) comments. | 24 | using C++ style (//) comments. |
25 | 25 | ||
26 | After the build is complete, a busybox.links file is generated. This is | 26 | After the build is complete, a busybox.links file is generated. This is |
27 | used by 'make install' to create symlinks to the busybox binary for all | 27 | used 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 | |||
30 | variable (i.e., make PREFIX="/tmp/foo" install) | 30 | variable (i.e., make PREFIX="/tmp/foo" install) |
31 | 31 | ||
32 | ---------------- | 32 | ---------------- |
33 | |||
33 | Getting help: | 34 | Getting help: |
35 | |||
34 | When you find you need help, you can check out the BusyBox mailing list | 36 | When you find you need help, you can check out the BusyBox mailing list |
35 | archives at http://opensource.lineo.com/lists/busybox/ or even join | 37 | archives at http://opensource.lineo.com/lists/busybox/ or even join |
36 | the mailing list if you are interested. | 38 | the mailing list if you are interested. |
37 | 39 | ||
38 | ---------------- | 40 | ---------------- |
41 | |||
39 | Bugs: | 42 | Bugs: |
40 | If you find bugs, follow the instructions at http://bugs.lineo.com/Reporting.html | 43 | |
41 | and submit a bug report. This way, we can be sure nothing falls through the | 44 | If you find bugs, please submit a bug report. Full instructions on how to |
42 | cracks... | 45 | report a bug are found at http://bugs.lineo.com/Reporting.html. |
46 | |||
47 | For the impatient: To submit a bug, simply send an email describing the problem | ||
48 | to 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 | |||
68 | Note the careful description and use of examples showing not only what BusyBox | ||
69 | does, but also a counter example showing what an equivalent GNU app does. Bug | ||
70 | reports lacking such detail may take a _long_ time to be fixed... Thanks for | ||
71 | understanding. | ||
43 | 72 | ||
44 | ---------------- | 73 | ---------------- |
74 | |||
45 | FTP: | 75 | FTP: |
76 | |||
46 | Source for the latest released version can always be downloaded from | 77 | Source 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 | |||
50 | CVS: | 82 | CVS: |
83 | |||
51 | BusyBox now has its own publicly browsable CVS tree at: | 84 | BusyBox 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: | |||
57 | For those that are actively contributing there is even CVS write access: | 90 | For 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 | ||
63 | Please feed suggestions, bug reports, insults, and bribes back to: | 95 | Please feed suggestions, bug reports, insults, and bribes back to: |
@@ -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 | 18 | Possible 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 | ||
26 | The Busybox lash shell needs to be taught Bourne shell grammer. This | ||
27 | is planned for the next release of Busybox. Look out ash, we are coming | ||
28 | for you... | ||
29 | |||
30 | ----------------------- | ||
31 | |||
28 | Running the following: | 32 | Running 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 | ||
33 | reveals the list of all external (i.e. libc) things that BusyBox depends on. | 37 | reveals the list of all external (i.e. libc) things that BusyBox depends on. |
34 | It would be a very nice thing to reduce this list to an absolute minimum, and | 38 | It would be a very nice thing to reduce this list to an absolute minimum, to |
35 | then create a microLibc to provide these functions. There is no good reason | 39 | reduce the footprint of busybox when staticly linking with libraries such as |
36 | for GNU libc to be so big. I'm sure it can be a lot better. | 40 | uClibc. |
37 | 41 | ||
38 | (BTW, this is more informative if BB_FEATURE_NFSMOUNT is turned off...) | 42 | ----------------------- |
43 | |||
44 | Currently, busybox bypasses libc NSS. Some folks might want that, | ||
45 | so perhaps adding in the option to choose whether to go to libc for | ||
46 | things like getpwnam() or whether to use the busybox version might | ||
47 | be nice. | ||
48 | |||
49 | ----------------------- | ||
39 | 50 | ||
40 | Most wanted list: | 51 | Most wanted list: |
41 | 52 | ||