mirror of
https://github.com/sheumann/hush.git
synced 2024-12-22 14:30:31 +00:00
29ec116037
Attached a start for POSIX conformance documentation for busybox (see TODO file and discussion last week). A table of all options as defined by POSIX and as implemented by busybox (see for a FreeBSD example http://people.freebsd.org/~schweikh/posix-utilities.html). Only the tools that are stand-alone applets are documented (not ash built-ins as 'read'), as there are multiple shells. When there are two versions (echo) the stand-alone version was checked. I think this may be the wrong way to go, as most users will probably use the built-in version - but which shell? The table was auto-generated by running, for each POSIX utility, latest git allyesconfig* "busybox <tool> --help" and parsing the output, and comparing that to tool options extracted from its man page at http://www.opengroup.org/onlinepubs/9699919799/. This means that it the usage string is not correct, the table is also wrong. I noticed that for 'kill', for example, the usage string does not mention the -s, -q, -o options. For each option is set whether it exists in busybox and if it is, is it compliant to the standard. Of course, checking compliance can only be done manually - a process which will probably take some time (see 'cat' for example). I didn't post the auto-generation script (python, ugly) because the table will now change manually; I can post it if there is anyone interested. As for the tools not implemented by busybox at all, I think most of them are indeed fairly esotetic. Some I was suprised to see missing are link, file, newgrp, unlink. * Well, almost allyesconfig - but nothing very POSIX-y was disabled. Signed-off-by: David Krakov <krakov@gmail.org> Signed-off-by: Mike Frysinger <vapier@gentoo.org> |
||
|---|---|---|
| .. | ||
| cgi | ||
| .gitignore | ||
| autodocifier.pl | ||
| busybox_footer.pod | ||
| busybox_header.pod | ||
| contributing.txt | ||
| ctty.htm | ||
| draft-coar-cgi-v11-03-clean.html | ||
| ifupdown_design.txt | ||
| keep_data_small.txt | ||
| logging_and_backgrounding.txt | ||
| mdev.txt | ||
| new-applet-HOWTO.txt | ||
| nofork_noexec.txt | ||
| posix_conformance.txt | ||
| Serial-Programming-HOWTO.txt | ||
| sigint.htm | ||
| style-guide.txt | ||
| tar_pax.txt | ||