X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=docs%2Fbusybox.sgml;h=2d372506b190a3ccd2591b3c00e22b87f845c0ac;hb=4bcdd7214217bfdaa2c4015425d439686d5b8b0b;hp=9c38979b7fee7098e7e6fb6f3458a394ae71bd28;hpb=8ce85ce4e3595ac15d4746adc3b5c920fe4db1e8;p=oweals%2Fbusybox.git
diff --git a/docs/busybox.sgml b/docs/busybox.sgml
index 9c38979b7..2d372506b 100644
--- a/docs/busybox.sgml
+++ b/docs/busybox.sgml
@@ -137,8 +137,8 @@
ar, basename, cat, chgrp, chmod, chown, chroot, chvt, clear,
- cp, cut, date, dc, dd, deallocvt, df, dirname, dmesg, du,
- dumpkmap, dutmp, echo, false, fbset, fdflush, find, free,
+ cp, cut, date, dc, dd, deallocvt, df, dirname, dmesg, dpkg-deb,
+ du, dumpkmap, dutmp, echo, false, fbset, fdflush, find, free,
freeramdisk, fsck.minix, grep, gunzip, gzip, halt, head,
hostid, hostname, id, init, insmod, kill, killall, length, ln,
loadacm, loadfont, loadkmap, logger, logname, ls, lsmod,
@@ -758,6 +758,44 @@
+
+ dpkg-deb
+
+
+ Usage: dpkg-deb [OPTION] archive [directory]
+
+
+
+ Debian package archive (.deb) manipulation tool
+
+
+
+ Options:
+
+
+
+
+ -c List the contents of the filesystem tree archive portion of the package
+ -e Extracts the control information files from a package archive into the specified directory.
+ If no directory is specified then a subdirectory DEBIAN in the current directory is used.
+ -x Silently extracts the filesystem tree from a package archive into the specified directory.
+ -X Extracts the filesystem tree from a package archive into the specified directory, listing the files as it goes.
+ If required the specified directory (but not its parents) will be created.
+
+
+
+
+ Example:
+
+
+
+
+ dpkg-deb -e ./busybox_0.48-1_i386.deb
+ dpkg-deb -x ./busybox_0.48-1_i386.deb ./unpack_dir
+
+
+
+
du
@@ -767,7 +805,7 @@
Summarize the disk space used for each FILE or current
- directory. Disk space printed in units of 1k (i.e.
+ directory. Disk space printed in units of 1k (i.e.,
1024 bytes).
@@ -811,7 +849,7 @@
- Prints out a binary keyboard translation table to standard input.
+ Prints out a binary keyboard translation table to standard output.
@@ -1050,7 +1088,9 @@
-follow Dereference symbolic links
-name PATTERN File name (leading directories removed) matches PATTERN
- -print Print the full file name followed by a newline to stdout
+ -type X Filetype matches X (where X is one of: f,d,l,b,c,...)
+ -perm PERMS Permissions match any of (+NNN); all of (-NNN); or exactly (NNN)
+ -mtime TIME Modified time is greater than (+N); less than (-N); or exactly (N) days
@@ -1297,6 +1337,7 @@
-c Write output to standard output
+ -d decompress
@@ -1397,10 +1438,10 @@
- -s Short
- -i Addresses for the hostname
- -d DNS domain name
- -F FILE Use the contents of FILE to specify the hostname
+ -s Short
+ -i Addresses for the hostname
+ -d DNS domain name
+ -F, --file FILE Use the contents of FILE to specify the hostname
@@ -1435,6 +1476,7 @@
-g Print only the group ID
-u Print only the user ID
+ -n print a name instead of a number (with for -ug)
-r Print the real user ID instead of the effective ID (with -ug)
@@ -1511,19 +1553,18 @@
id
- WARNING: This field has a non-traditional
- meaning for BusyBox init! The id field is used
- by BusyBox init to specify the controlling tty
- for the specified process to run on. The
- contents of this field are appended to "/dev/"
- and used as-is. There is no need for this field
- to be unique, although if it isn't you may have
- strange results. If this field is left blank,
- it is completely ignored. Also note that if
- BusyBox detects that a serial console is in use,
- then all entries containing non-empty id fields
- will _not_ be run. BusyBox init does nothing
- with utmp. We don't need no stinkin' utmp.
+
+ WARNING: This field has a non-traditional meaning for BusyBox init!
+ The id field is used by BusyBox init to specify the controlling tty
+ for the specified process to run on. The contents of this field
+ are appended to "/dev/" and used as-is. There is no need for this
+ field to be unique, although if it isn't you may have strange
+ results. If this field is left blank, the controlling tty is set
+ to the console. Also note that if BusyBox detects that a serial
+ console is in use, then only entries whose controlling tty is
+ either the serial console or /dev/null will be run. BusyBox init
+ does nothing with utmp. We don't need no stinkin' utmp.
+
@@ -1538,24 +1579,56 @@
action
+
+
+ Valid actions include: sysinit, respawn, askfirst, wait,
+ once, and ctrlaltdel.
+
+
+
+
+ The available actions can be classified into two groups: actions
+ that are run only once, and actions that are re-run when the specified
+ process exits.
+
+
+
+ Run only-once actions:
+
+
+
+ 'sysinit' is the first item run on boot. init waits until all
+ sysinit actions are completed before continuing. Following the
+ completion of all sysinit actions, all 'wait' actions are run.
+ 'wait' actions, like 'sysinit' actions, cause init to wait until
+ the specified task completes. 'once' actions are asyncronous,
+ therefore, init does not wait for them to complete. 'ctrlaltdel'
+ actions are run immediately before init causes the system to reboot
+ (unmounting filesystems with a 'ctrlaltdel' action is a very good
+ idea).
+
+
- Valid actions include: sysinit, respawn,
- askfirst, wait, once, and ctrlaltdel.
+ Run repeatedly actions:
- askfirst acts just like respawn, but before
- running the specified process it displays the
- line "Please press Enter to activate this
- console." and then waits for the user to press
- enter before starting the specified process.
+ 'respawn' actions are run after the 'once' actions. When a process
+ started with a 'respawn' action exits, init automatically restarts
+ it. Unlike sysvinit, BusyBox init does not stop processes from
+ respawning out of control. The 'askfirst' actions acts just like
+ respawn, except that before running the specified process it
+ displays the line "Please press Enter to activate this console."
+ and then waits for the user to press enter before starting the
+ specified process.
- Unrecognized actions (like initdefault) will
- cause init to emit an error message, and then go
- along with its business.
+ Unrecognized actions (like initdefault) will cause init to emit an
+ error message, and then go along with its business. All actions are
+ run in the reverse order from how they appear in /etc/inittab.
+
@@ -1627,6 +1700,7 @@
-k Make module autoclean-able.
-v Verbose output
-x Do not export externs
+ -L Prevent simultaneous loads of the same module
@@ -1840,7 +1914,7 @@
- Write MESSAGE to the system log. If MESSAGE is '-', log
+ Write MESSAGE to the system log. If MESSAGE is omitted, log
stdin.
@@ -2211,7 +2285,7 @@
Creates a temporary file with its name based on
- TEMPLATE. TEMPLATE is any name with six `Xs' (i.e.
+ TEMPLATE. TEMPLATE is any name with six `Xs' (i.e.,
/tmp/temp.XXXXXX).
@@ -2378,7 +2452,12 @@
- Open a pipe to HOST:PORT.
+ or: nc -p PORT -l
+
+
+
+
+ Open a pipe to HOST:PORT or listen for a connection on PORT.
@@ -2649,6 +2728,7 @@
+ -i Always prompt before removing each destinations
-f Remove existing destinations, never prompt
-r or -R Remove the contents of directories recursively
@@ -2990,7 +3070,8 @@
-n Run as a foreground process
-K Do not start up the klogd process
-O FILE Use an alternate log file (default=/var/log/messages)
- -R HOST[:PORT] Log messages to HOST on PORT (default=514) over UDP.
+ -R HOST[:PORT] Log remotely to IP or hostname on PORT (default PORT=514/UDP)
+ -L Log locally as well as network logging (default is network only)
@@ -3326,7 +3407,7 @@
-a Unmount all file systems
-r Try to remount devices as read-only if mount is busy
- -f Force filesystem umount (i.e. unreachable NFS server)
+ -f Force filesystem umount (i.e., unreachable NFS server)
-l Do not free loop device (if a loop device has been used)
@@ -3394,6 +3475,18 @@
INPUT (or stdin), writing to OUTPUT (or stdout).
+
+ Options:
+
+
+
+
+ -c prefix lines by the number of occurrences
+ -d only print duplicate lines
+ -u only print unique lines
+
+
+
Example:
@@ -3575,6 +3668,18 @@
+
+ watchdog
+
+
+ Usage: watchdog device
+
+
+
+ Periodically writes to watchdog device B.
+
+
+
wc