X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=docs%2Fbusybox.sgml;h=b54d68ee58e01a469c842fa177156c92fc60e631;hb=8d441783817d909b7ba3c0148d7deb121e9791c8;hp=9c38979b7fee7098e7e6fb6f3458a394ae71bd28;hpb=8ce85ce4e3595ac15d4746adc3b5c920fe4db1e8;p=oweals%2Fbusybox.git diff --git a/docs/busybox.sgml b/docs/busybox.sgml index 9c38979b7..b54d68ee5 100644 --- a/docs/busybox.sgml +++ b/docs/busybox.sgml @@ -136,19 +136,30 @@ - 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, - freeramdisk, fsck.minix, grep, gunzip, gzip, halt, head, - hostid, hostname, id, init, insmod, kill, killall, length, ln, - loadacm, loadfont, loadkmap, logger, logname, ls, lsmod, - makedevs, mkdir, mkfifo, mkfs.minix, mknod, mkswap, mktemp, - more, mount, mt, mv, nc, nslookup, ping, poweroff, printf, ps, - pwd, reboot, renice, reset, rm, rmdir, rmmod, sed, setkeycodes, sh, sleep, - sort, swapoff, swapon, sync, syslogd, tail, tar, tee, telnet, - test, touch, tr, true, tty, umount, uname, uniq, update, - uptime, usleep, uudecode, uuencode, wc, which, whoami, yes, - zcat, [ + addgroup, adduser, adjtimex, ar, arping, ash, awk, basename, + bunzip2, busybox, bzcat, cal, cat, chgrp, chmod, chown, chroot, + chvt, clear, cmp, cp, cpio, crond, crontab, cut, date, dc, dd, + deallocvt, delgroup, deluser, df, dirname, dmesg, dos2unix, dpkg, + dpkg-deb, du, dumpkmap, dumpleases, dutmp, echo, egrep, env, expr, + false, fbset, fdflush, fdformat, fgrep, find, fold, free, freeramdisk, + fsck.minix, ftpget, ftpput, getopt, getty, grep, gunzip, gzip, + halt, hdparm, head, hexdump, hostid, hostname, httpd, hush, hwclock, + id, ifconfig, ifdown, ifup, inetd, init, insmod, ip, ipcalc, iplink, + iproute, iptunnel, kill, killall, klogd, lash, length, linuxrc, + ln, loadfont, loadkmap, logger, login, logname, logread, + losetup, ls, lsmod, makedevs, md5sum, mesg, minit, mkdir, mkfifo, + mkfs.minix, mknod, mkswap, mktemp, modprobe, more, mount, msh, + msvc, mt, mv, nameif, nc, netstat, nslookup, od, openvt, passwd, + patch, pidfilehack, pidof, ping, ping6, pivot_root, poweroff, + printf, ps, pwd, rdate, readlink, realpath, reboot, renice, reset, + rm, rmdir, rmmod, route, rpm, rpm2cpio, run-parts, sed, setkeycodes, + sha1sum, sleep, sort, start-stop-daemon, strings, stty, su, sulogin, + swapoff, swapon, sync, syslogd, tail, tar, tee, telnet, telnetd, + test, tftp, time, top, touch, tr, traceroute, true, tty, udhcpc, + udhcpd, umount, uname, uncompress, uniq, unix2dos, unzip, + uptime, usleep, uudecode, uuencode, vconfig, vi, vlock, watch, + watchdog, wc, wget, which, who, whoami, xargs, yes, zcat, [ + @@ -758,6 +769,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 +816,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 +860,7 @@ - Prints out a binary keyboard translation table to standard input. + Prints out a binary keyboard translation table to standard output. @@ -1050,7 +1099,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 +1348,7 @@ -c Write output to standard output + -d decompress @@ -1397,10 +1449,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 +1487,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 +1564,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 +1590,56 @@ action + - Valid actions include: sysinit, respawn, - askfirst, wait, once, and ctrlaltdel. + Valid actions include: sysinit, respawn, askfirst, wait, + once, and ctrlaltdel. + - 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. + 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. - Unrecognized actions (like initdefault) will - cause init to emit an error message, and then go - along with its business. + 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). + + + + Run repeatedly actions: + + + + '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. All actions are + run in the reverse order from how they appear in /etc/inittab. + + @@ -1627,6 +1711,7 @@ -k Make module autoclean-able. -v Verbose output -x Do not export externs + -L Prevent simultaneous loads of the same module @@ -1766,28 +1851,6 @@ - - loadacm - - - Usage: loadacm - - - - Load an acm from stdin. - - - - Example: - - - - - $ loadacm < /etc/i18n/acmname - - - - loadfont @@ -1840,7 +1903,7 @@ - Write MESSAGE to the system log. If MESSAGE is '-', log + Write MESSAGE to the system log. If MESSAGE is omitted, log stdin. @@ -1891,6 +1954,38 @@ + + logread + + + Usage: logread [OPTION]... + + + + Shows the messages from syslogd (using circular buffer). + + + + Options: + + + + + -f Output data as the log grows. + + + + + Example: + + + + + $ logread + + + + ls @@ -2211,7 +2306,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 +2473,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 +2749,7 @@ + -i Always prompt before removing each destinations -f Remove existing destinations, never prompt -r or -R Remove the contents of directories recursively @@ -2704,7 +2805,7 @@ - -a Try to remove all unused kernel modules + -a Remove all unused modules (recursively) @@ -2719,6 +2820,33 @@ + + run-parts + + + Usage: run-parts [-t] [-a ARG] [-u MASK] DIRECTORY + + + + Run a bunch of scripts in a directory. + + + + Options: + + + + + -t Test only. It only print the file to be executed, + without execute them. + -a ARG Pass ARG as an a argument to the programs executed. + -u MASK Set the umask to MASK before executing the programs. + + + + + + sed @@ -2990,7 +3118,9 @@ -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) + -C [size(KiB)] Log to a circular buffer. Read this buffer using 'logread' @@ -3326,7 +3456,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 +3524,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 +3717,18 @@ + + watchdog + + + Usage: watchdog device + + + + Periodically writes to watchdog device B. + + + wc @@ -3776,7 +3930,7 @@ MAINTAINER - Erik Andersen <andersee@debian.org> <andersen@lineo.com> + Erik Andersen <andersen@codepoet.org> @@ -3789,7 +3943,7 @@ - Erik Andersen <andersee@debian.org> + Erik Andersen <andersen@codepoet.org> @@ -3797,7 +3951,7 @@ - John Beppu <beppu@lineo.com> + John Beppu <beppu@codepoet.org> @@ -3853,7 +4007,7 @@ - Mark Whitley <markw@lineo.com> + Mark Whitley <markw@codepoet.org> @@ -3864,6 +4018,10 @@ Enrique Zanardi <ezanardi@ull.es> + + Vladimir Oleynik <dzo@simtreas.ru> + +