diff options
author | Eric Andersen <andersen@codepoet.org> | 2000-07-05 00:07:13 +0400 |
---|---|---|
committer | Eric Andersen <andersen@codepoet.org> | 2000-07-05 00:07:13 +0400 |
commit | 028fb625f53208a4d835f4a5ae034c3edc1ad051 (patch) | |
tree | 770e4c60d1c5fc2d465e6bbfd236049b37c95b24 /docs | |
parent | 5331025f796d1defe90c8dda1fe1481de95850e5 (diff) |
More doc updates
-Erik
Diffstat (limited to 'docs')
-rw-r--r-- | docs/busybox.pod | 274 | ||||
-rw-r--r-- | docs/busybox.sgml | 1265 |
2 files changed, 688 insertions, 851 deletions
diff --git a/docs/busybox.pod b/docs/busybox.pod index 5c2c59054..d1d6f7efd 100644 --- a/docs/busybox.pod +++ b/docs/busybox.pod @@ -237,12 +237,6 @@ Example: ------------------------------- -=item clear - -Clears the screen. - -------------------------------- - =item chvt Usage: chvt N @@ -251,6 +245,12 @@ Changes the foreground virtual terminal to /dev/ttyN ------------------------------- +=item clear + +Clears the screen. + +------------------------------- + =item cp Usage: cp [OPTION]... SOURCE DEST @@ -363,6 +363,14 @@ Example: ------------------------------- +=item deallocvt + +Usage: deallocvt N + +Deallocates unused virtual terminal /dev/ttyN + +------------------------------- + =item df Usage: df [filesystem ...] @@ -580,14 +588,6 @@ Example: ------------------------------- -=item deallocvt - -Usage: deallocvt N - -Deallocates unused virtual terminal /dev/ttyN - -------------------------------- - =item fsck.minix Usage: fsck.minix [B<-larvsmf>] /dev/name @@ -1187,25 +1187,6 @@ Example: ------------------------------- -=item nc - -Usage: nc [IP] [port] - -Netcat opens a pipe to IP:port - -Example: - - $ nc foobar.somedomain.com 25 - 220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600 - help - 214-Commands supported: - 214- HELO EHLO MAIL RCPT DATA AUTH - 214 NOOP QUIT RSET HELP - quit - 221 foobar closing connection - -------------------------------- - =item more Usage: more [file ...] @@ -1277,6 +1258,25 @@ Example: ------------------------------- +=item nc + +Usage: nc [IP] [port] + +Netcat opens a pipe to IP:port + +Example: + + $ nc foobar.somedomain.com 25 + 220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600 + help + 214-Commands supported: + 214- HELO EHLO MAIL RCPT DATA AUTH + 214 NOOP QUIT RSET HELP + quit + 221 foobar closing connection + +------------------------------- + =item nslookup Usage: nslookup [HOST] @@ -1476,23 +1476,6 @@ Example: ------------------------------- -=item 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. - -------------------------------- - =item sfdisk Usage: sfdisk [options] device ... @@ -1536,6 +1519,23 @@ You can disable all consistency checking with: ------------------------------- +=item 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. + +------------------------------- + =item sleep Usage: sleep N @@ -1567,27 +1567,15 @@ Example: ------------------------------- -=item sync - -Usage: sync - -Write all buffered filesystem blocks to disk. - -------------------------------- - -=item syslogd +=item swapoff -Usage: syslogd [OPTION]... +Usage: swapoff [OPTION] [device] -Linux system and kernel (provides klogd) logging utility. -Note that this version of syslogd/klogd ignores /etc/syslog.conf. +Stop swapping virtual memory pages on the given device. 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) + -a Stop swapping on all swap devices ------------------------------- @@ -1603,15 +1591,27 @@ Options: ------------------------------- -=item swapoff +=item sync -Usage: swapoff [OPTION] [device] +Usage: sync -Stop swapping virtual memory pages on the given device. +Write all buffered filesystem blocks to disk. + +------------------------------- + +=item syslogd + +Usage: syslogd [OPTION]... + +Linux system and kernel (provides klogd) logging utility. +Note that this version of syslogd/klogd ignores /etc/syslog.conf. Options: - -a Stop swapping on all swap devices + -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) ------------------------------- @@ -1666,28 +1666,21 @@ Example: ------------------------------- -=item test, [ +=item tee -Usage: test EXPRESSION -or [ EXPRESSION ] +Usage: tee [OPTION]... [FILE]... -Checks file types and compares values returning an exit -code determined by the value of EXPRESSION. +Copy standard input to each FILE, and also to standard output. + +Options: + + -a append to the given FILEs, do not overwrite Example: - $ test 1 -eq 2 - $ echo $? - 1 - $ test 1 -eq 1 - $ echo $? - 0 - $ [ -d /etc ] - $ echo $? - 0 - $ [ -d /junk ] - $ echo $? - 1 + $ echo "Hello" | tee /tmp/foo + $ cat /tmp/foo + Hello ------------------------------- @@ -1700,21 +1693,28 @@ computer over a network using the TELNET protocol. ------------------------------- -=item tee - -Usage: tee [OPTION]... [FILE]... - -Copy standard input to each FILE, and also to standard output. +=item test, [ -Options: +Usage: test EXPRESSION +or [ EXPRESSION ] - -a append to the given FILEs, do not overwrite +Checks file types and compares values returning an exit +code determined by the value of EXPRESSION. Example: - $ echo "Hello" | tee /tmp/foo - $ cat /tmp/foo - Hello + $ test 1 -eq 2 + $ echo $? + 1 + $ test 1 -eq 1 + $ echo $? + 0 + $ [ -d /etc ] + $ echo $? + 0 + $ [ -d /junk ] + $ echo $? + 1 ------------------------------- @@ -1783,45 +1783,6 @@ Example: ------------------------------- -=item 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 - $ - -------------------------------- - -=item 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 - -------------------------------- - =item umount Usage: umount [flags] filesystem|directory @@ -1918,6 +1879,45 @@ Example: ------------------------------- +=item 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 + $ + +------------------------------- + +=item 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 + +------------------------------- + =item wc Usage: wc [OPTION]... [FILE]... @@ -2063,4 +2063,4 @@ Enrique Zanardi <ezanardi@ull.es> =cut -# $Id: busybox.pod,v 1.52 2000/06/26 12:14:30 andersen Exp $ +# $Id: busybox.pod,v 1.53 2000/07/04 20:07:13 andersen Exp $ diff --git a/docs/busybox.sgml b/docs/busybox.sgml index ac3e7e749..49b82c37d 100644 --- a/docs/busybox.sgml +++ b/docs/busybox.sgml @@ -231,531 +231,368 @@ </sect1> -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> -<varlistentry><term><emphasis>chgrp - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: chgrp [OPTION]... GROUP FILE... - - -</para> - -<para> -Change the group membership of each FILE to GROUP. - - -</para> - -<para> -Options: - - -</para> - -<para> -<screen> - -R change files and directories recursively -</screen> - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ ls -l /tmp/foo - -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo - $ chgrp root /tmp/foo - $ ls -l /tmp/foo - -r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo -</screen> - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> -<varlistentry><term><emphasis>chmod - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: chmod [<emphasis>-R</emphasis>] MODE[,MODE]... FILE... - - -</para> - -<para> -Changes file access permissions for the specified -<literal>FILE(s)</literal> (or directories). Each MODE is defined by -combining the letters for WHO has access to the file, an OPERATOR for -selecting how the permissions should be changed, and a PERMISSION for -<literal>FILE(s)</literal> (or directories). - - -</para> - -<para> -WHO may be chosen from - - -</para> - -<para> -<screen> - u User who owns the file - g Users in the file's Group - o Other users not in the file's group - a All users -</screen> - - -</para> - -<para> -OPERATOR may be chosen from - - -</para> - -<para> -<screen> - + Add a permission - - Remove a permission - = Assign a permission -</screen> - - -</para> - -<para> -PERMISSION may be chosen from - - -</para> - -<para> -<screen> - r Read - w Write - x Execute (or access for directories) - s Set user (or group) ID bit - t Sticky bit (for directories prevents removing files by non-owners) -</screen> - - -</para> - -<para> -Alternately, permissions can be set numerically where the first three -numbers are calculated by adding the octal values, such as - - -</para> - -<para> -<screen> - 4 Read - 2 Write - 1 Execute -</screen> - - -</para> - -<para> -An optional fourth digit can also be used to specify - - -</para> - -<para> -<screen> - 4 Set user ID - 2 Set group ID - 1 Sticky bit -</screen> - - -</para> - -<para> -Options: - - -</para> - -<para> -<screen> - -R Change files and directories recursively. -</screen> - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ ls -l /tmp/foo - -rw-rw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo - $ chmod u+x /tmp/foo - $ ls -l /tmp/foo - -rwxrw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo* - $ chmod 444 /tmp/foo - $ ls -l /tmp/foo - -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo -</screen> - - -</para> - -<para> -------------------------------- - - -</para> -</listitem></varlistentry> -<varlistentry><term><emphasis>chown - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: chown [OPTION]... OWNER[<.|:>[GROUP] FILE... - - -</para> - -<para> -Changes the owner and/or group of each FILE to OWNER and/or GROUP. - - -</para> - -<para> -Options: - - -</para> - -<para> -<screen> - -R Changes files and directories recursively -</screen> - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ ls -l /tmp/foo - -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo - $ chown root /tmp/foo - $ ls -l /tmp/foo - -r--r--r-- 1 root andersen 0 Apr 12 18:25 /tmp/foo - $ chown root.root /tmp/foo - ls -l /tmp/foo - -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo -</screen> - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> -<varlistentry><term><emphasis>chroot - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: chroot NEWROOT [COMMAND...] - - -</para> - -<para> -Run COMMAND with root directory set to NEWROOT. - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ ls -l /bin/ls - lrwxrwxrwx 1 root root 12 Apr 13 00:46 /bin/ls -> /BusyBox - $ mount /dev/hdc1 /mnt -t minix - $ chroot /mnt - $ ls -l /bin/ls - -rwxr-xr-x 1 root root 40816 Feb 5 07:45 /bin/ls* -</screen> - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> -<varlistentry><term><emphasis>clear - -</emphasis></term> -<listitem><para></para> - -<para> -Clears the screen. - - -</para> - -<para> -------------------------------- - - -</para> + <sect1 id="chgrp"> + <title>chgrp</title> -</listitem></varlistentry> -<varlistentry><term><emphasis>chvt - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: chvt N - - -</para> + <para> + Usage: chgrp [OPTION]... GROUP FILE... + </para> -<para> -Changes the foreground virtual terminal to /dev/ttyN + <para> + Change the group membership of each FILE to GROUP. + </para> + <para> + Options: + </para> -</para> + <para> + <screen> + -R change files and directories recursively + </screen> + </para> -<para> -------------------------------- + <para> + Example: + </para> + <para> + <screen> + $ ls -l /tmp/foo + -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo + $ chgrp root /tmp/foo + $ ls -l /tmp/foo + -r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo + </screen> + </para> + </sect1> -</para> -</listitem></varlistentry> -<varlistentry><term><emphasis>cp -</emphasis></term> -<listitem><para></para> + <sect1 id="chmod"> + <title>chmod</title> -<para> -Usage: cp [OPTION]... SOURCE DEST + <para> + Usage: chmod [<emphasis>-R</emphasis>] MODE[,MODE]... FILE... + </para> + <para> + Changes file access permissions for the specified + <literal>FILE(s)</literal> (or directories). Each MODE is defined by + combining the letters for WHO has access to the file, an OPERATOR for + selecting how the permissions should be changed, and a PERMISSION for + <literal>FILE(s)</literal> (or directories). + </para> -</para> + <para> + WHO may be chosen from + </para> -<para> -<screen> - or: cp [OPTION]... SOURCE... DIRECTORY -</screen> + <para> + <screen> + u User who owns the file + g Users in the file's Group + o Other users not in the file's group + a All users + </screen> + </para> + <para> + OPERATOR may be chosen from + </para> -</para> + <para> + <screen> + + Add a permission + - Remove a permission + = Assign a permission + </screen> + </para> -<para> -Copies SOURCE to DEST, or multiple <literal>SOURCE(s)</literal> to -DIRECTORY. + <para> + PERMISSION may be chosen from + </para> + <para> + <screen> + r Read + w Write + x Execute (or access for directories) + s Set user (or group) ID bit + t Sticky bit (for directories prevents removing files by non-owners) + </screen> + </para> -</para> + <para> + Alternately, permissions can be set numerically where the first three + numbers are calculated by adding the octal values, such as + </para> -<para> -Options: + <para> + <screen> + 4 Read + 2 Write + 1 Execute + </screen> + </para> + <para> + An optional fourth digit can also be used to specify + </para> -</para> + <para> + <screen> + 4 Set user ID + 2 Set group ID + 1 Sticky bit + </screen> + </para> -<para> -<screen> - -a Same as -dpR - -d Preserves links - -p Preserves file attributes if possible - -R Copies directories recursively -</screen> + <para> + Options: + </para> + <para> + <screen> + -R Change files and directories recursively. + </screen> + </para> -</para> + <para> + Example: + </para> -<para> -------------------------------- + <para> + <screen> + $ ls -l /tmp/foo + -rw-rw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo + $ chmod u+x /tmp/foo + $ ls -l /tmp/foo + -rwxrw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo* + $ chmod 444 /tmp/foo + $ ls -l /tmp/foo + -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo + </screen> + </para> + </sect1> -</para> + + <sect1 id="chown"> + <title>chown</title> + <para> + Usage: chown [OPTION]... OWNER[<.|:>[GROUP] FILE... + </para> -</listitem></varlistentry> -<varlistentry><term><emphasis>cut + <para> + Changes the owner and/or group of each FILE to OWNER and/or GROUP. + </para> -</emphasis></term> -<listitem><para></para> + <para> + Options: + </para> -<para> -Usage: cut [OPTION]... [FILE]... + <para> + <screen> + -R Changes files and directories recursively + </screen> + </para> + <para> + Example: + </para> -</para> + <para> + <screen> + $ ls -l /tmp/foo + -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo + $ chown root /tmp/foo + $ ls -l /tmp/foo + -r--r--r-- 1 root andersen 0 Apr 12 18:25 /tmp/foo + $ chown root.root /tmp/foo + ls -l /tmp/foo + -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo + </screen> + </para> + </sect1> -<para> -Prints selected fields from each input FILE to standard output. -</para> + <sect1 id="chroot"> + <title>chroot</title> + <para> + Usage: chroot NEWROOT [COMMAND...] + </para> -<para> -Options: + <para> + Run COMMAND with root directory set to NEWROOT. + </para> + <para> + Example: + </para> -</para> + <para> + <screen> + $ ls -l /bin/ls + lrwxrwxrwx 1 root root 12 Apr 13 00:46 /bin/ls -> /BusyBox + $ mount /dev/hdc1 /mnt -t minix + $ chroot /mnt + $ ls -l /bin/ls + -rwxr-xr-x 1 root root 40816 Feb 5 07:45 /bin/ls* + </screen> + </para> + </sect1> -<para> -<screen> - -b LIST Output only bytes from LIST - -c LIST Output only characters from LIST - -d CHAR Use CHAR instead of tab as the field delimiter - -s Only output Lines if the include DELIM - -f N Print only these fields - -n Ignored -</screen> + <sect1 id="chvt"> + <title>chvt</title> + <para> + Usage: chvt N + </para> -</para> + <para> + Changes the foreground virtual terminal to /dev/ttyN + </para> + </sect1> -<para> -Example: -</para> -<para> -<screen> - $ echo "Hello world" | cut -f 1 -d ' ' - Hello - $ echo "Hello world" | cut -f 2 -d ' ' - world -</screen> + <sect1 id="clear"> + <title>clear</title> + <para> + Usage: clear + </para> -</para> + <para> + Clears the screen. + </para> + </sect1> -<para> -------------------------------- + <sect1 id="cp"> + <title>cp</title> -</para> + <para> + Usage: cp [OPTION]... SOURCE DEST + </para> -</listitem></varlistentry> -<varlistentry><term><emphasis>date + <para> + <screen> + or: cp [OPTION]... SOURCE... DIRECTORY + </screen> + </para> -</emphasis></term> -<listitem><para></para> + <para> + Copies SOURCE to DEST, or multiple <literal>SOURCE(s)</literal> to + DIRECTORY. + </para> -<para> -Usage: date [OPTION]... [+FORMAT] + <para> + Options: + </para> + <para> + <screen> + -a Same as -dpR + -d Preserves links + -p Preserves file attributes if possible + -R Copies directories recursively + </screen> + </para> + </sect1> -</para> -<para> -<screen> - or: date [OPTION] [MMDDhhmm[[CC]YY][.ss]] -</screen> + <sect1 id="cut"> + <title>cut</title> + <para> + Usage: cut [OPTION]... [FILE]... + </para> -</para> + <para> + Prints selected fields from each input FILE to standard output. + </para> -<para> -Displays the current time in the given FORMAT, or sets the system date. + <para> + Options: + </para> + <para> + <screen> + -b LIST Output only bytes from LIST + -c LIST Output only characters from LIST + -d CHAR Use CHAR instead of tab as the field delimiter + -s Only output Lines if the include DELIM + -f N Print only these fields + -n Ignored + </screen> + </para> -</para> + <para> + Example: + </para> -<para> -Options: + <para> + <screen> + $ echo "Hello world" | cut -f 1 -d ' ' + Hello + $ echo "Hello world" | cut -f 2 -d ' ' + world + </screen> + </para> + </sect1> -</para> -<para> -<screen> - -R Outputs RFC-822 compliant date string - -s Sets time described by STRING - -u Prints or sets Coordinated Universal Time -</screen> + <sect1 id="date"> + <title>date</title> + <para> + Usage: date [OPTION]... [+FORMAT] + </para> -</para> + <para> + <screen> + or: date [OPTION] [MMDDhhmm[[CC]YY][.ss]] + </screen> + </para> -<para> -Example: + <para> + Displays the current time in the given FORMAT, or sets the system date. + </para> + <para> + Options: + </para> -</para> + <para> + <screen> + -R Outputs RFC-822 compliant date string + -s Sets time described by STRING + -u Prints or sets Coordinated Universal Time + </screen> + </para> -<para> -<screen> - $ date - Wed Apr 12 18:52:41 MDT 2000 -</screen> + <para> + Example: + </para> + <para> + <screen> + $ date + Wed Apr 12 18:52:41 MDT 2000 + </screen> + </para> + </sect1> -</para> -<para> -------------------------------- +<!-- This is where I have stopped formatting stuff --> -</para> </listitem></varlistentry> <varlistentry><term><emphasis>dc @@ -869,6 +706,30 @@ Example: <para> ------------------------------- +</para> + +</listitem></varlistentry> +<varlistentry><term><emphasis>deallocvt + +</emphasis></term> +<listitem><para></para> + +<para> +Usage: deallocvt N + + +</para> + +<para> +Deallocates unused virtual terminal /dev/ttyN + + +</para> + +<para> +------------------------------- + + </para> @@ -1416,30 +1277,6 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>deallocvt - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: deallocvt N - - -</para> - -<para> -Deallocates unused virtual terminal /dev/ttyN - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> <varlistentry><term><emphasis>fsck.minix </emphasis></term> @@ -3064,51 +2901,6 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>nc - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: nc [IP] [port] - - -</para> - -<para> -Netcat opens a pipe to IP:port - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ nc foobar.somedomain.com 25 - 220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600 - help - 214-Commands supported: - 214- HELO EHLO MAIL RCPT DATA AUTH - 214 NOOP QUIT RSET HELP - quit - 221 foobar closing connection -</screen> - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> <varlistentry><term><emphasis>more </emphasis></term> @@ -3295,6 +3087,51 @@ Example: </para> </listitem></varlistentry> +<varlistentry><term><emphasis>nc + +</emphasis></term> +<listitem><para></para> + +<para> +Usage: nc [IP] [port] + + +</para> + +<para> +Netcat opens a pipe to IP:port + + +</para> + +<para> +Example: + + +</para> + +<para> +<screen> + $ nc foobar.somedomain.com 25 + 220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600 + help + 214-Commands supported: + 214- HELO EHLO MAIL RCPT DATA AUTH + 214 NOOP QUIT RSET HELP + quit + 221 foobar closing connection +</screen> + + +</para> + +<para> +------------------------------- + + +</para> + +</listitem></varlistentry> <varlistentry><term><emphasis>nslookup </emphasis></term> @@ -3860,47 +3697,6 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>sh - -</emphasis></term> -<listitem><para></para> - -<para> -Usage: sh - - -</para> - -<para> -lash -- the BusyBox LAme SHell (command interpreter) - - -</para> - -<para> -This command does not yet have proper documentation. - - -</para> - -<para> -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. - - -</para> - -<para> -------------------------------- - - -</para> - -</listitem></varlistentry> <varlistentry><term><emphasis>sfdisk </emphasis></term> @@ -3996,6 +3792,47 @@ You can disable all consistency checking with: </para> </listitem></varlistentry> +<varlistentry><term><emphasis>sh + +</emphasis></term> +<listitem><para></para> + +<para> +Usage: sh + + +</para> + +<para> +lash -- the BusyBox LAme SHell (command interpreter) + + +</para> + +<para> +This command does not yet have proper documentation. + + +</para> + +<para> +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. + + +</para> + +<para> +------------------------------- + + +</para> + +</listitem></varlistentry> <varlistentry><term><emphasis>sleep </emphasis></term> @@ -4079,19 +3916,33 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>sync +<varlistentry><term><emphasis>swapoff </emphasis></term> <listitem><para></para> <para> -Usage: sync +Usage: swapoff [OPTION] [device] </para> <para> -Write all buffered filesystem blocks to disk. +Stop swapping virtual memory pages on the given device. + + +</para> + +<para> +Options: + + +</para> + +<para> +<screen> + -a Stop swapping on all swap devices +</screen> </para> @@ -4103,20 +3954,19 @@ Write all buffered filesystem blocks to disk. </para> </listitem></varlistentry> -<varlistentry><term><emphasis>syslogd +<varlistentry><term><emphasis>swapon </emphasis></term> <listitem><para></para> <para> -Usage: syslogd [OPTION]... +Usage: swapon [OPTION] [device] </para> <para> -Linux system and kernel (provides klogd) logging utility. Note that this -version of syslogd/klogd ignores /etc/syslog.conf. +Start swapping virtual memory pages on the given device. </para> @@ -4129,10 +3979,7 @@ Options: <para> <screen> - -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) + -a Start swapping on all swap devices </screen> @@ -4145,33 +3992,19 @@ Options: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>swapon +<varlistentry><term><emphasis>sync </emphasis></term> <listitem><para></para> <para> -Usage: swapon [OPTION] [device] - - -</para> - -<para> -Start swapping virtual memory pages on the given device. - - -</para> - -<para> -Options: +Usage: sync </para> <para> -<screen> - -a Start swapping on all swap devices -</screen> +Write all buffered filesystem blocks to disk. </para> @@ -4183,19 +4016,20 @@ Options: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>swapoff +<varlistentry><term><emphasis>syslogd </emphasis></term> <listitem><para></para> <para> -Usage: swapoff [OPTION] [device] +Usage: syslogd [OPTION]... </para> <para> -Stop swapping virtual memory pages on the given device. +Linux system and kernel (provides klogd) logging utility. Note that this +version of syslogd/klogd ignores /etc/syslog.conf. </para> @@ -4208,7 +4042,10 @@ Options: <para> <screen> - -a Stop swapping on all swap devices + -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) </screen> @@ -4364,20 +4201,33 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>test, [ +<varlistentry><term><emphasis>tee </emphasis></term> <listitem><para></para> <para> -Usage: test EXPRESSION or [ EXPRESSION ] +Usage: tee [OPTION]... [FILE]... </para> <para> -Checks file types and compares values returning an exit code determined by -the value of EXPRESSION. +Copy standard input to each FILE, and also to standard output. + + +</para> + +<para> +Options: + + +</para> + +<para> +<screen> + -a append to the given FILEs, do not overwrite +</screen> </para> @@ -4390,18 +4240,9 @@ Example: <para> <screen> - $ test 1 -eq 2 - $ echo $? - 1 - $ test 1 -eq 1 - $ echo $? - 0 - $ [ -d /etc ] - $ echo $? - 0 - $ [ -d /junk ] - $ echo $? - 1 + $ echo "Hello" | tee /tmp/foo + $ cat /tmp/foo + Hello </screen> @@ -4439,33 +4280,20 @@ over a network using the TELNET protocol. </para> </listitem></varlistentry> -<varlistentry><term><emphasis>tee +<varlistentry><term><emphasis>test, [ </emphasis></term> <listitem><para></para> <para> -Usage: tee [OPTION]... [FILE]... - - -</para> - -<para> -Copy standard input to each FILE, and also to standard output. - - -</para> - -<para> -Options: +Usage: test EXPRESSION or [ EXPRESSION ] </para> <para> -<screen> - -a append to the given FILEs, do not overwrite -</screen> +Checks file types and compares values returning an exit code determined by +the value of EXPRESSION. </para> @@ -4478,9 +4306,18 @@ Example: <para> <screen> - $ echo "Hello" | tee /tmp/foo - $ cat /tmp/foo - Hello + $ test 1 -eq 2 + $ echo $? + 1 + $ test 1 -eq 1 + $ echo $? + 0 + $ [ -d /etc ] + $ echo $? + 0 + $ [ -d /junk ] + $ echo $? + 1 </screen> @@ -4678,32 +4515,29 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>uuencode +<varlistentry><term><emphasis>umount </emphasis></term> <listitem><para></para> <para> -Usage: uuencode [OPTION] [INFILE] REMOTEFILE - - -</para> - -<para> -Uuencode a file. +Usage: umount [flags] filesystem|directory </para> <para> -Options: +Flags: </para> <para> <screen> - -m use base64 encoding as of RFC1521 + -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) </screen> @@ -4717,12 +4551,7 @@ Example: <para> <screen> - $ uuencode busybox busybox - begin 755 busybox - M?T5,1@$!`0````````````(``P`!````L+@$"#0```!0N@,``````#0`(``& - ..... - $ uudecode busybox busybox > busybox.uu - $ + $ umount /dev/hdc1 </screen> @@ -4735,19 +4564,19 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>uudecode +<varlistentry><term><emphasis>uname </emphasis></term> <listitem><para></para> <para> -Usage: uudecode [OPTION] [FILE] +Usage: uname [OPTION]... </para> <para> -Uudecode a uuencoded file +Print certain system information. With no OPTION, same as <emphasis>-s</emphasis>. </para> @@ -4760,7 +4589,13 @@ Options: <para> <screen> - -o FILE direct output to FILE + -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 </screen> @@ -4774,9 +4609,8 @@ Example: <para> <screen> - $ uudecode -o busybox busybox.uu - $ ls -l busybox - -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox + $ uname -a + Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown </screen> @@ -4789,30 +4623,20 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>umount +<varlistentry><term><emphasis>uniq </emphasis></term> <listitem><para></para> <para> -Usage: umount [flags] filesystem|directory - - -</para> - -<para> -Flags: +Usage: uniq [OPTION]... [INPUT [OUTPUT]] </para> <para> -<screen> - -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) -</screen> +Discard all but one of successive identical lines from INPUT (or standard +input), writing to OUTPUT (or standard output). </para> @@ -4825,7 +4649,10 @@ Example: <para> <screen> - $ umount /dev/hdc1 + $ echo -e "a\na\nb\nc\nc\na" | sort | uniq + a + b + c </screen> @@ -4838,19 +4665,19 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>uname +<varlistentry><term><emphasis>update </emphasis></term> <listitem><para></para> <para> -Usage: uname [OPTION]... +Usage: update [options] </para> <para> -Print certain system information. With no OPTION, same as <emphasis>-s</emphasis>. +Periodically flushes filesystem buffers. </para> @@ -4863,28 +4690,9 @@ Options: <para> <screen> - -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 -</screen> - - -</para> - -<para> -Example: - - -</para> - -<para> -<screen> - $ uname -a - Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown + -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) </screen> @@ -4897,20 +4705,19 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>uniq +<varlistentry><term><emphasis>uptime </emphasis></term> <listitem><para></para> <para> -Usage: uniq [OPTION]... [INPUT [OUTPUT]] +Usage: uptime </para> <para> -Discard all but one of successive identical lines from INPUT (or standard -input), writing to OUTPUT (or standard output). +Tells how long the system has been running since boot. </para> @@ -4923,10 +4730,8 @@ Example: <para> <screen> - $ echo -e "a\na\nb\nc\nc\na" | sort | uniq - a - b - c + $ uptime + 1:55pm up 2:30, load average: 0.09, 0.04, 0.00 </screen> @@ -4939,34 +4744,33 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>update +<varlistentry><term><emphasis>usleep </emphasis></term> <listitem><para></para> <para> -Usage: update [options] +Usage: usleep N </para> <para> -Periodically flushes filesystem buffers. +Pauses for N microseconds. </para> <para> -Options: +Example: </para> <para> <screen> - -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) + $ usleep 1000000 + [pauses for 1 second] </screen> @@ -4979,19 +4783,33 @@ Options: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>uptime +<varlistentry><term><emphasis>uudecode </emphasis></term> <listitem><para></para> <para> -Usage: uptime +Usage: uudecode [OPTION] [FILE] </para> <para> -Tells how long the system has been running since boot. +Uudecode a uuencoded file + + +</para> + +<para> +Options: + + +</para> + +<para> +<screen> + -o FILE direct output to FILE +</screen> </para> @@ -5004,8 +4822,9 @@ Example: <para> <screen> - $ uptime - 1:55pm up 2:30, load average: 0.09, 0.04, 0.00 + $ uudecode -o busybox busybox.uu + $ ls -l busybox + -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox </screen> @@ -5018,19 +4837,33 @@ Example: </para> </listitem></varlistentry> -<varlistentry><term><emphasis>usleep +<varlistentry><term><emphasis>uuencode </emphasis></term> <listitem><para></para> <para> -Usage: usleep N +Usage: uuencode [OPTION] [INFILE] REMOTEFILE </para> <para> -Pauses for N microseconds. +Uuencode a file. + + +</para> + +<para> +Options: + + +</para> + +<para> +<screen> + -m use base64 encoding as of RFC1521 +</screen> </para> @@ -5043,8 +4876,12 @@ Example: <para> <screen> - $ usleep 1000000 - [pauses for 1 second] + $ uuencode busybox busybox + begin 755 busybox + M?T5,1@$!`0````````````(``P`!````L+@$"#0```!0N@,``````#0`(``& + ..... + $ uudecode busybox busybox > busybox.uu + $ </screen> |