From 215809234460de93e616cffac06f641e969db673 Mon Sep 17 00:00:00 2001 From: Eric Andersen Date: Fri, 7 Jul 2000 19:07:47 +0000 Subject: [PATCH] This patch finishes the cleanup of all the commands. It also cleans up the remaining chapters -- Matt Kraai -Erik --- docs/busybox.sgml | 3237 ++++++++++++++++++--------------------------- 1 file changed, 1298 insertions(+), 1939 deletions(-) diff --git a/docs/busybox.sgml b/docs/busybox.sgml index e0e023410..8d03c9d13 100644 --- a/docs/busybox.sgml +++ b/docs/busybox.sgml @@ -862,7 +862,7 @@ - Returns an exit code of FALSE (1). + Return an exit code of FALSE (1). @@ -1463,7 +1463,7 @@ - Loads MODULE into the kernel. + Load MODULE into the kernel. @@ -2352,1941 +2352,1300 @@ - -ps - - - - - -Usage: ps - - - - - -Report process status - - - - - -This version of ps accepts no options. - - - - - -Example: - - - - - - - $ ps - PID Uid Gid State Command - 1 root root S init - 2 root root S [kflushd] - 3 root root S [kupdate] - 4 root root S [kpiod] - 5 root root S [kswapd] - 742 andersen andersen S [bash] - 743 andersen andersen S -bash - 745 root root S [getty] - 2990 andersen andersen R ps - - - - - - -------------------------------- - - - - - -pwd - - - - - -Prints the full filename of the current working directory. - - - - - -Example: - - - - - - - $ pwd - /root - - - - - - -------------------------------- - - - - - -reboot - - - - - -Instructs the kernel to reboot the system. - - - - - -------------------------------- - - - - - -rm - - - - - -Usage: rm [OPTION]... FILE... - - - - - -Remove (unlink) the FILE(s). You may use '--' to -indicate that all following arguments are non-options. - - - - - -Options: - - - - - - - -f remove existing destinations, never prompt - -r or -R remove the contents of directories recursively - - - - - - -Example: - - - - - - - $ rm -rf /tmp/foo - - - - - - -------------------------------- - - - - - -rmdir - - - - - -Usage: rmdir [OPTION]... DIRECTORY... - - - - - -Remove the DIRECTORY(ies), if they are empty. - - - - - -Example: - - - - - - - # rmdir /tmp/foo - - - - - - -------------------------------- - - - - - -rmmod - - - - - -Usage: rmmod [OPTION]... [MODULE]... - - - - - -Unloads the specified kernel modules from the kernel. - - - - - -Options: - - - - - - - -a Try to remove all unused kernel modules. - - - - - - -Example: - - - - - - - $ rmmod tulip - - - - - - -------------------------------- - - - - - -sed - - - - - -Usage: sed [-n] -e script [file...] - - - - - -Allowed sed scripts come in the following form: - - - - - - - 'ADDR [!] COMMAND' - - - - - - - - where address ADDR can be: - NUMBER Match specified line number - $ Match last line - /REGEXP/ Match specified regexp - (! inverts the meaning of the match) - - - - - - - - and COMMAND can be: - s/regexp/replacement/[igp] - which attempt to match regexp against the pattern space - and if successful replaces the matched portion with replacement. - - - - - - - - aTEXT - which appends TEXT after the pattern space - - - - - - -Options: - - - - - - - -e add the script to the commands to be executed - -n suppress automatic printing of pattern space - - - - - - -This version of sed matches full regular expressions. - - - - - -Example: - - - - - - - $ echo "foo" | sed -e 's/f[a-zA-Z]o/bar/g' - bar - - - - - - -------------------------------- - - - - - -setkeycodes - - - - - -Usage: setkeycodes SCANCODE KEYCODE ... - - - - - -Set entries into the kernel's scancode-to-keycode map, allowing unusual -keyboards to generate usable keycodes. - - - - - -SCANCODE may be either xx or e0xx (hexadecimal), and KEYCODE is given in -decimal - - - - - -Example: - - - - - - - # setkeycodes e030 127 - - - - - - -------------------------------- - - - - - -sfdisk - - - - - -Usage: sfdisk [options] device ... - - - - - -device: something like /dev/hda or /dev/sda - - - - - -useful options: - - - - - - - -s [or --show-size]: list size of a partition - -c [or --id]: print or change partition Id - -l [or --list]: list partitions of each device - -d [or --dump]: idem, but in a format suitable for later input - -i [or --increment]: number cylinders etc. from 1 instead of from 0 - -uS, -uB, -uC, -uM: accept/report in units of sectors/blocks/cylinders/MB - -T [or --list-types]:list the known partition types - -D [or --DOS]: for DOS-compatibility: waste a little space - -R [or --re-read]: make kernel reread partition table - -N# : change only the partition with number # - -n : do not actually write to disk - -O file : save the sectors that will be overwritten to file - -I file : restore these sectors again - -v [or --version]: print version - -? [or --help]: print this message - - - - - - -dangerous options: - - - - - - - -g [or --show-geometry]: print the kernel's idea of the geometry - -x [or --show-extended]: also list extended partitions on output - - - - - - - - or expect descriptors for them on input - -L [or --Linux]: do not complain about things irrelevant for Linux - -q [or --quiet]: suppress warning messages - You can override the detected geometry using: - -C# [or --cylinders #]:set the number of cylinders to use - -H# [or --heads #]: set the number of heads to use - -S# [or --sectors #]: set the number of sectors to use - - - - - - -You can disable all consistency checking with: - - - - - - - -f [or --force]: do what I say, even if it is stupid - - - - - - -------------------------------- - - - - - -sh - - - - - -Usage: sh - - - - - -lash -- the BusyBox LAme SHell (command interpreter) - - - - - -This command does not yet have proper documentation. - - - - - -Use lash just as you would use any other shell. It properly handles pipes, -redirects, job control, can be used as the shell for scripts (#!/bin/sh), -and has a sufficient set of builtins to do what is needed. It does not -(yet) support Bourne Shell syntax. If you need things like -``if-then-else'', ``while'', and such, use ash or bash. If you just need a -very simple and extremely small shell, this will do the job. - - - - - -------------------------------- - - - - - -sleep - - - - - -Usage: sleep N - - - - - -Pause for N seconds. - - - - - -Example: - - - - - - - $ sleep 2 - [2 second delay results] - - - - - - -------------------------------- - - - - - -sort - - - - - -Usage: sort [-n] [-r] [FILE]... - - - - - -Sorts lines of text in the specified files - - - - - -Example: - - - - - - - $ echo -e "e\nf\nb\nd\nc\na" | sort - a - b - c - d - e - f - - - - - - -------------------------------- - - - - - -swapoff - - - - - -Usage: swapoff [OPTION] [device] - - - - - -Stop swapping virtual memory pages on the given device. - - - - - -Options: - - - - - - - -a Stop swapping on all swap devices - - - - - - -------------------------------- - - - - - -swapon - - - - - -Usage: swapon [OPTION] [device] - - - - - -Start swapping virtual memory pages on the given device. - - - - - -Options: - - - - - - - -a Start swapping on all swap devices - - - - - - -------------------------------- - - - - - -sync - - - - - -Usage: sync - - - - - -Write all buffered filesystem blocks to disk. - - - - - -------------------------------- - - - - - -syslogd - - - - - -Usage: syslogd [OPTION]... - - - - - -Linux system and kernel (provides klogd) logging utility. Note that this -version of syslogd/klogd ignores /etc/syslog.conf. - - - - - -Options: - - - - - - - -m NUM Interval between MARK lines (default=20min, 0=off) - -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) - - - - - - -------------------------------- - - - - - -tail - - - - - -Usage: tail [OPTION] [FILE]... - - - - - -Print last 10 lines of each FILE to standard output. With more than one -FILE, precede each with a header giving the file name. With no FILE, or -when FILE is -, read standard input. - - - - - -Options: - - - - - - - -n NUM Print last NUM lines instead of first 10 - -f Output data as the file grows. This version - of 'tail -f' supports only one file at a time. - - - - - - -Example: - - - - - - - $ tail -n 1 /etc/resolv.conf - nameserver 10.0.0.1 - - - - - - -------------------------------- - - - - - -tar - - - - - -Usage: tar -[cxtvO] [--exclude File] [-f tarFile] [FILE] ... - - - - - -Create, extract, or list files from a tar file. Note that this version of -tar treats hard links as separate files. - - - - - -Main operation mode: - - - - - - - c create - x extract - t list - - - - - - -File selection: - - - - - - - f name of tarfile or "-" for stdin - O extract to stdout - --exclude file to exclude - - - - - - -Informative output: - - - - - - - v verbosely list files processed - - - - - - -Example: - - - - - - - $ zcat /tmp/tarball.tar.gz | tar -xf - - $ tar -cf /tmp/tarball.tar /usr/local - - - - - - -------------------------------- - - - - - -tee - - - - - -Usage: tee [OPTION]... [FILE]... - - - - - -Copy standard input to each FILE, and also to standard output. - - - - - -Options: - - - - - - - -a append to the given FILEs, do not overwrite - - - - - - -Example: - - - - - - - $ echo "Hello" | tee /tmp/foo - $ cat /tmp/foo - Hello - - - - - - -------------------------------- - - - - - -telnet - - - - - -Usage: telnet host [port] - - - - - -Telnet is used to establish interactive communication with another computer -over a network using the TELNET protocol. - - - - - -------------------------------- - - - - - -test, [ - - - - - -Usage: test EXPRESSION or [ EXPRESSION ] - - - - - -Checks file types and compares values returning an exit code determined by -the value of EXPRESSION. - - - - - -Example: - - - - - - - $ test 1 -eq 2 - $ echo $? - 1 - $ test 1 -eq 1 - $ echo $? - 0 - $ [ -d /etc ] - $ echo $? - 0 - $ [ -d /junk ] - $ echo $? - 1 - - - - - - -------------------------------- - - - - - -touch - - - - - -Usage: touch [-c] file [file ...] - - - - - -Update the last-modified date on (or create) the selected file[s]. - - - - - -Example: - - - - - - - $ ls -l /tmp/foo - /bin/ls: /tmp/foo: No such file or directory - $ touch /tmp/foo - $ ls -l /tmp/foo - -rw-rw-r-- 1 andersen andersen 0 Apr 15 01:11 /tmp/foo - - - - - - -------------------------------- - - - - - -tr - - - - - -Usage: tr [-cds] STRING1 [STRING2] - - - - - -Translate, squeeze, and/or delete characters from standard input, writing -to standard output. - - - - - -Options: - - - - - - - -c take complement of STRING1 - -d delete input characters coded STRING1 - -s squeeze multiple output characters of STRING2 into one character - - - - - - -Example: - - - - - - - $ echo "gdkkn vnqkc" | tr [a-y] [b-z] - hello world - - - - - - -------------------------------- - - - - - -true - - - - - -Returns an exit code of TRUE (0) - - - - - -Example: - - - - - - - $ true - $ echo $? - 0 - - - - - - -------------------------------- - - - - - -tty - - - - - -Usage: tty - - - - - -Print the file name of the terminal connected to standard input. - - - - - -Options: - - - - - - - -s print nothing, only return an exit status - - - - - - -Example: - - - - - - - $ tty - /dev/tty2 - - - - - - -------------------------------- - - - - - -umount - - - - - -Usage: umount [flags] filesystem|directory - - - - - -Flags: - - - - - - - -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) - -l: Do not free loop device (if a loop device has been used) - - - - - - -Example: - - - - - - - $ umount /dev/hdc1 - - - - - - -------------------------------- - - - - - -uname - - - - - -Usage: uname [OPTION]... - - - - - -Print certain system information. With no OPTION, same as -s. - - - - - -Options: - - - - - - - -a print all information - -m the machine (hardware) type - -n print the machine's network node hostname - -r print the operating system release - -s print the operating system name - -p print the host processor type - -v print the operating system version - - - - - - -Example: - - - - - - - $ uname -a - Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown - - - - - - -------------------------------- - - - - - -uniq - - - - - -Usage: uniq [OPTION]... [INPUT [OUTPUT]] - - - - - -Discard all but one of successive identical lines from INPUT (or standard -input), writing to OUTPUT (or standard output). - - - - - -Example: - - - - - - - $ echo -e "a\na\nb\nc\nc\na" | sort | uniq - a - b - c - - - - - - -------------------------------- - - - - - -update - - - - - -Usage: update [options] - - - - - -Periodically flushes filesystem buffers. - - - - - -Options: - - - - - - - -S force use of sync(2) instead of flushing - -s SECS call sync this often (default 30) - -f SECS flush some buffers this often (default 5) - - - - - - -------------------------------- - - - - - -uptime - - - - - -Usage: uptime - - - - - -Tells how long the system has been running since boot. - - - - - -Example: - - - - - - - $ uptime - 1:55pm up 2:30, load average: 0.09, 0.04, 0.00 - - - - - - -------------------------------- - - - - - -usleep - - - - - -Usage: usleep N - - - - - -Pauses for N microseconds. - - - - - -Example: - - - - - - - $ usleep 1000000 - [pauses for 1 second] - - - - - - -------------------------------- - - - - - -uudecode - - - - - -Usage: uudecode [OPTION] [FILE] - - - - - -Uudecode a uuencoded file - - - - - -Options: - - - - - - - -o FILE direct output to FILE - - - - - - -Example: - - - - - - - $ uudecode -o busybox busybox.uu - $ ls -l busybox - -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox - - - - - - -------------------------------- - - - - - -uuencode - - - - - -Usage: uuencode [OPTION] [INFILE] REMOTEFILE - - - - - -Uuencode a file. - - - - - -Options: - - - - - - - -m use base64 encoding as of RFC1521 - - - - - - -Example: - - - - - - - $ uuencode busybox busybox - begin 755 busybox - M?T5,1@$!`0````````````(``P`!````L+@$"#0```!0N@,``````#0`(``& - ..... - $ uudecode busybox busybox > busybox.uu - $ - - - - - - -------------------------------- - - - - - -wc - - - - - -Usage: wc [OPTION]... [FILE]... - - - - - -Print line, word, and byte counts for each FILE, and a total line if more -than one FILE is specified. With no FILE, read standard input. - - - - - -Options: - - - - - - - -c print the byte counts - -l print the newline counts - -L print the length of the longest line - -w print the word counts - - - - - - -Example: - - - - - - - $ wc /etc/passwd - 31 46 1365 /etc/passwd - - - - - - -------------------------------- - - - - - -which - - - - - -Usage: which [COMMAND ...] - - - - - -Locates a COMMAND. - - - - - -Example: - - - - - - - $ which login - /bin/login - - - - - - -------------------------------- - - - - - -whoami - - - - - -Usage: whoami - - - - - -Prints the user name associated with the current effective user id. - - - - - -Example: - - - - - - - $ whoami - andersen - - - - - - -------------------------------- - - - - - -yes - - - - - -Usage: yes [OPTION]... [STRING]... - - - - - -Repeatedly outputs a line with all specified STRING(s), -or `y'. - - - - - -------------------------------- - - - - - -zcat - - - - - -This is essentially an alias for invoking ``gunzip -c'', where it decompresses the file in question and send the output to -stdout. - - - - - -------------------------------- - - - - - - - - -LIBC NSS - - - - - - - - -GNU Libc uses the Name Service Switch (NSS) to configure the behavior of -the C library for the local environment, and to configure how it reads -system data, such as passwords and group information. BusyBox has made it -Policy that it will never use NSS, and will never use libc calls that -make use of NSS. This allows you to run an embedded system without the need -for installing an /etc/nsswitch.conf file and without /lib/libnss_* -libraries installed. - - - - - -If you are using a system that is using a remote LDAP server for -authentication via GNU libc NSS, and you want to use BusyBox, then you will -need to adjust the BusyBox source. Chances are though, that if you have -enough space to install of that stuff on your system, then you probably -want the full GNU utilities. - - - - - - -SEE ALSO - - - - - - - - -textutils(1), shellutils(1), etc... - - - - - - -MAINTAINER - - - - - - - - -Erik Andersen <andersee@debian.org> <andersen@lineo.com> - - - - - - -AUTHORS - - - - - - - - -The following people have contributed code to BusyBox whether they know it -or not. - - - - - -Erik Andersen <andersee@debian.org> - - - - - -John Beppu <beppu@lineo.com> - - - - - -Brian Candler <B.Candler@pobox.com> - - - - - -Randolph Chung <tausq@debian.org> - - - - - -Dave Cinege <dcinege@psychosis.com> - - - - - -Karl M. Hegbloom <karlheg@debian.org> - - - - - -John Lombardo <john@deltanet.com> - - - - - -Glenn McGrath <bug1@netconnect.com.au> - - - - - -Bruce Perens <bruce@perens.com> - - - - - -Pavel Roskin <proski@gnu.org> - - - - - -Linus Torvalds <torvalds@transmeta.com> - - - - - -Charles P. Wright <cpwright@villagenet.com> - - - - - -Enrique Zanardi <ezanardi@ull.es> - - - - - - - - - + + ps + + + Usage: ps + + + + Report process status. This version of ps accepts no + options. + + + + Options: + + + + + + + + + Example: + + + + + $ ps + PID Uid Gid State Command + 1 root root S init + 2 root root S [kflushd] + 3 root root S [kupdate] + 4 root root S [kpiod] + 5 root root S [kswapd] + 742 andersen andersen S [bash] + 743 andersen andersen S -bash + 745 root root S [getty] + 2990 andersen andersen R ps + + + + + + pwd + + + Usage: pwd + + + + Print the full filename of the current working + directory. + + + + Example: + + + + + $ pwd + /root + + + + + + reboot + + + Usage: reboot + + + + Reboot the system. + + + + + rm + + + Usage: rm [OPTION]... FILE... + + + + Remove (unlink) the FILE(s). You may use '--' to + indicate that all following arguments are non-options. + + + + Options: + + + + + -f Remove existing destinations, never prompt + -r or -R Remove the contents of directories recursively + + + + + Example: + + + + + $ rm -rf /tmp/foo + + + + + + rmdir + + + Usage: rmdir DIRECTORY... + + + + Remove DIRECTORY(s) if they are empty. + + + + Example: + + + + + $ rmdir /tmp/foo + + + + + + rmmod + + + Usage: rmmod [OPTION]... [MODULE]... + + + + Unload MODULE(s) from the kernel. + + + + Options: + + + + + -a Try to remove all unused kernel modules + + + + + Example: + + + + + $ rmmod tulip + + + + + + sed + + + Usage: sed [OPTION]... SCRIPT [FILE]... + + + + Allowed sed scripts come in the following form: + + + + + ADDR [!] COMMAND + + + + + ADDR can be: + + + + + NUMBER Match specified line number + $ Match last line + /REGEXP/ Match specified regexp + + + + + ! inverts the meaning of the match + + + + COMMAND can be: + + + + + s/regexp/replacement/[igp] + which attempt to match regexp against the pattern space + and if successful replaces the matched portion with replacement. + aTEXT + which appends TEXT after the pattern space + + + + + This version of sed matches full regular expressions. + + + + Options: + + + + + -e Add the script to the commands to be executed + -n Suppress automatic printing of pattern space + + + + + Example: + + + + + $ echo "foo" | sed -e 's/f[a-zA-Z]o/bar/g' + bar + + + + + + setkeycodes + + + Usage: setkeycodes SCANCODE KEYCODE ... + + + + Set entries into the kernel's scancode-to-keycode map, + allowing unusual keyboards to generate usable keycodes. + + + + SCANCODE may be either xx or e0xx (hexadecimal), and + KEYCODE is given in decimal. + + + + Example: + + + + + $ setkeycodes e030 127 + + + + + + sfdisk + + + Usage: sfdisk [OPTION]... DEVICE + + + + Partition DEVICE. + + + + Options: + + + + + -s List size of a partition + -c Print or change partition Id + -l List partitions of each device + -d Idem, but in a format suitable for later input + -i Number cylinders etc. from 1 instead of from 0 + -uS Accept/report in units of sectors + -uB Accept/report in units of blocks + -uC Accept/report in units of cylinders + -uM Accept/report in units of MB + -T List the known partition types + -D For DOS-compatibility: waste a little space + -R Make kernel reread partition table + -N NUM Change only the partition with number NUM + -n Do not actually write to disk + -O FILE Save the sectors that will be overwritten to FILE + -I FILE Restore these sectors from FILE + + + + + Dangerous options: + + + + + -g Print the kernel's idea of the geometry + -x Also list extended partitions on output + or expect descriptors for them on input + -L Do not complain about things irrelevant for Linux + -q Suppress warning messages + + + + + You can override the detected geometry using: + + + + + -C NUM Set the number of cylinders to use + -H NUM Set the number of heads to use + -S NUM Set the number of sectors to use + + + + + You can disable all consistency checking with: + + + + + -f Do what I say, even if it is stupid + + + + + + sh + + + Usage: sh + + + + lash -- the BusyBox LAme SHell (command interpreter) + + + + This command does not yet have proper documentation. + + + + Use lash just as you would use any other shell. It + properly handles pipes, redirects, job control, can be + used as the shell for scripts (#!/bin/sh), and has a + sufficient set of builtins to do what is needed. It does + not (yet) support Bourne Shell syntax. If you need + things like ``if-then-else'', ``while'', and such, use + ash or bash. If you just need a very simple and + extremely small shell, this will do the job. + + + + + sleep + + + Usage: sleep N + + + + Pause for N seconds. + + + + Example: + + + + + $ sleep 2 + [2 second delay results] + + + + + + sort + + + Usage: sort [OPTION]... [FILE]... + + + + Sort lines of text in FILE(s). + + + + Options: + + + + + -n Compare numerically + -r Reverse after sorting + + + + + Example: + + + + + $ echo -e "e\nf\nb\nd\nc\na" | sort + a + b + c + d + e + f + + + + + + swapoff + + + Usage: swapoff [OPTION] [DEVICE] + + + + Stop swapping virtual memory pages on DEVICE. + + + + Options: + + + + + -a Stop swapping on all swap devices + + + + + + swapon + + + Usage: swapon [OPTION] [DEVICE] + + + + Start swapping virtual memory pages on the given device. + + + + Options: + + + + + -a Start swapping on all swap devices + + + + + + sync + + + Usage: sync + + + + Write all buffered filesystem blocks to disk. + + + + + syslogd + + + Usage: syslogd [OPTION]... + + + + Linux system and kernel (provides klogd) logging + utility. Note that this version of syslogd/klogd ignores + /etc/syslog.conf. + + + + Options: + + + + + -m NUM Interval between MARK lines (default=20min, 0=off) + -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) + + + + + Example: + + + + + + + + + + tail + + + Usage: tail [OPTION] [FILE]... + + + + Print last 10 lines of each FILE to standard output. + With more than one FILE, precede each with a header + giving the file name. With no FILE, or when FILE is -, + read stdin. + + + + Options: + + + + + -n NUM Print last NUM lines instead of last 10 + -f Output data as the file grows. This version + of 'tail -f' supports only one file at a time. + + + + + Example: + + + + + $ tail -n 1 /etc/resolv.conf + nameserver 10.0.0.1 + + + + + + tar + + + Usage: tar [MODE] [OPTION] [FILE]... + + + + + + + + MODE may be chosen from + + + + + c Create + x Extract + t List + + + + + Options: + + + + + f FILE Use FILE for tarfile (or stdin if '-') + O Extract to stdout + --exclude FILE Exclude FILE + v List files processed + + + + + Example: + + + + + $ zcat /tmp/tarball.tar.gz | tar -xf - + $ tar -cf /tmp/tarball.tar /usr/local + + + + + + tee + + + Usage: tee [OPTION]... [FILE]... + + + + Copy stdin to FILE(s), and also to stdout. + + + + Options: + + + + + -a Append to the given FILEs, do not overwrite + + + + + Example: + + + + + $ echo "Hello" | tee /tmp/foo + Hello + $ cat /tmp/foo + Hello + + + + + + telnet + + + Usage: telnet HOST [PORT] + + + + Establish interactive communication with another + computer over a network using the TELNET protocol. + + + + + test, [ + + + Usage: test EXPRESSION + + + + + or: [ EXPRESSION ] + + + Check file types and compare values returning an exit + code determined by the value of EXPRESSION. + + + + Example: + + + + + $ test 1 -eq 2 + $ echo $? + 1 + $ test 1 -eq 1 + $ echo $? + 0 + $ [ -d /etc ] + $ echo $? + 0 + $ [ -d /junk ] + $ echo $? + 1 + + + + + + touch + + + Usage: touch [OPTION]... FILE... + + + + Update the last-modified date on (or create) FILE(s). + + + + Options: + + + + + -c Do not create files + + + + + Example: + + + + + $ ls -l /tmp/foo + /bin/ls: /tmp/foo: No such file or directory + $ touch /tmp/foo + $ ls -l /tmp/foo + -rw-rw-r-- 1 andersen andersen 0 Apr 15 01:11 /tmp/foo + + + + + + tr + + + Usage: tr [OPTION]... STRING1 [STRING2] + + + + Translate, squeeze, and/or delete characters from stdin, + writing to stdout. + + + + Options: + + + + + -c Take complement of STRING1 + -d Delete input characters coded STRING1 + -s Squeeze multiple output characters of STRING2 into one character + + + + + Example: + + + + + $ echo "gdkkn vnqkc" | tr [a-y] [b-z] + hello world + + + + + + true + + + Usage: true + + + + Return an exit code of TRUE (1). + + + + Example: + + + + + $ true + $ echo $? + 0 + + + + + + tty + + + Usage: tty + + + + Print the file name of the terminal connected to stdin. + + + + Options: + + + + + -s Print nothing, only return an exit status + + + + + Example: + + + + + $ tty + /dev/tty2 + + + + + + umount + + + Usage: umount [OPTION]... DEVICE|DIRECTORY + + + + + + + + Options: + + + + + -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) + -l Do not free loop device (if a loop device has been used) + + + + + Example: + + + + + $ umount /dev/hdc1 + + + + + + uname + + + Usage: uname [OPTION]... + + + + Print certain system information. With no OPTION, same + as -s. + + + + Options: + + + + + -a Print all information + -m Print the machine (hardware) type + -n Print the machine's network node hostname + -r Print the operating system release + -s Print the operating system name + -p Print the host processor type + -v Print the operating system version + + + + + Example: + + + + + $ uname -a + Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown + + + + + + uniq + + + Usage: uniq [INPUT [OUTPUT]] + + + + Discard all but one of successive identical lines from + INPUT (or stdin), writing to OUTPUT (or stdout). + + + + Example: + + + + + $ echo -e "a\na\nb\nc\nc\na" | sort | uniq + a + b + c + + + + + + update + + + Usage: update [OPTION]... + + + + Periodically flush filesystem buffers. + + + + Options: + + + + + -S Force use of sync(2) instead of flushing + -s SECS Call sync this often (default 30) + -f SECS Flush some buffers this often (default 5) + + + + + + uptime + + + Usage: uptime + + + + Display how long the system has been running since boot. + + + + Example: + + + + + $ uptime + 1:55pm up 2:30, load average: 0.09, 0.04, 0.00 + + + + + + usleep + + + Usage: usleep N + + + + Pause for N microseconds. + + + + Example: + + + + + $ usleep 1000000 + [pauses for 1 second] + + + + + + uudecode + + + Usage: uudecode [OPTION] [FILE] + + + + Uudecode a uuencoded file. + + + + Options: + + + + + -o FILE Direct output to FILE + + + + + Example: + + + + + $ uudecode -o busybox busybox.uu + $ ls -l busybox + -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox + + + + + + uuencode + + + Usage: uuencode [OPTION] [INFILE] OUTFILE + + + + Uuencode a file. + + + + Options: + + + + + -m Use base64 encoding as of RFC1521 + + + + + Example: + + + + + $ uuencode busybox busybox + begin 755 busybox + M?T5,1@$!`0````````````(``P`!````L+@$"#0```!0N@,``````#0`(``& + ..... + $ uudecode busybox busybox > busybox.uu + $ + + + + + + wc + + + Usage: wc [OPTION]... [FILE]... + + + + Print line, word, and byte counts for each FILE, and a + total line if more than one FILE is specified. With no + FILE, read stdin. + + + + Options: + + + + + -c Print the byte counts + -l Print the newline counts + -L Print the length of the longest line + -w Print the word counts + + + + + Example: + + + + + $ wc /etc/passwd + 31 46 1365 /etc/passwd + + + + + + which + + + Usage: which [COMMAND]... + + + + Locate COMMAND(s). + + + + Example: + + + + + $ which login + /bin/login + + + + + + whoami + + + Usage: whoami + + + + Print the user name associated with the current + effective user id. + + + + Example: + + + + + $ whoami + andersen + + + + + + yes + + + Usage: yes [STRING]... + + + + Repeatedly output a line with all specified STRING(s), + or `y'. + + + + + zcat + + + Usage: zcat [OPTION]... FILE + + + + Uncompress FILE (or stdin if FILE is '-') to stdout. + + + + Options: + + + + + -t Test compressed file integrity + + + + + Example: + + + + + + + + + + + LIBC NSS + + + GNU Libc uses the Name Service Switch (NSS) to configure the + behavior of the C library for the local environment, and to + configure how it reads system data, such as passwords and group + information. BusyBox has made it Policy that it will never use + NSS, and will never use libc calls that make use of NSS. This + allows you to run an embedded system without the need for + installing an /etc/nsswitch.conf file and without /lib/libnss_* + libraries installed. + + + + If you are using a system that is using a remote LDAP server for + authentication via GNU libc NSS, and you want to use BusyBox, + then you will need to adjust the BusyBox source. Chances are + though, that if you have enough space to install of that stuff + on your system, then you probably want the full GNU utilities. + + + + + SEE ALSO + + + textutils(1), + shellutils(1), + etc... + + + + + MAINTAINER + + + Erik Andersen <andersee@debian.org> <andersen@lineo.com> + + + + + AUTHORS + + + The following people have contributed code to BusyBox whether + they know it or not. + + + + Erik Andersen <andersee@debian.org> + + + + John Beppu <beppu@lineo.com> + + + + Brian Candler <B.Candler@pobox.com> + + + + Randolph Chung <tausq@debian.org> + + + + Dave Cinege <dcinege@psychosis.com> + + + + Karl M. Hegbloom <karlheg@debian.org> + + + + John Lombardo <john@deltanet.com> + + + + Glenn McGrath <bug1@netconnect.com.au> + + + + Bruce Perens <bruce@perens.com> + + + + Pavel Roskin <proski@gnu.org> + + + + Linus Torvalds <torvalds@transmeta.com> + + + + Charles P. Wright <cpwright@villagenet.com> + + + + Enrique Zanardi <ezanardi@ull.es> + +