More doc updates for BusyBox, with fixes to apps for bugs revealed

while trying to write docs . :-)
 -Erik

1 files changed, 0 insertions, 1025 deletions

diff --git a/docs/CommandList b/docs/CommandList
deleted file mode 100644
index 03c74bb87..000000000
--- a/docs/CommandList
+++ /dev/null
@@ -1,1025 +0,0 @@
-The following document includes a continuous description of the current
-commands, functions and utilities included in the busybox.
-
-John Cooper       
-johnc@lineo.com
-
-_______________________________________________________________________________________________________
-
-
-
-
-                    BusyBox 0.38, Functions and the Arguments they Support 
-
-
-New Apps that have been added to BusyBox since this document was written:
-    ping, hostname, mkfifo, free, tail, du, tee, head, sort, uniq, lsmod, rmmod, fbset, and loadacm.
-
-
-
-______________________________________________________________________________________________________
-
-
-
-
-
-cat [file]        
-              	Display file contents to standard output.
-
-
-
-
-_______________________________________________________________________________________________________
-
-
-
-
-
-chmod [-R] Mode,[Mode] file
-
-              	Change file access permissions (mode) of one or more files.
-
-	-R    	Follows the directory tree from the current location thru all sub-directories,
-
-		applying changes.
-
-              	Mode =  u  User
-
-                        g  Group
-
-                        o  Other
-
-                        a  All
-
-	      	Permission =  	r  Read
-
-                            	w  Write
-
-                            	s  Set user (or group) ID
-
-                            	t  Sticky bit file cannot be removed by other
-
-                               	   than the owner.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-chown [option] owner[group]file
-
- 		Change owner and (or) group of file to owner and (or) group.	
-
-                Only the current owner or a priveleged user may change an owner.
-
-	-R 	Follows the directory tree from the current location thru all sub-directories, applying
-
-		changes.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-chgrp [option] newgroup file
-
- 		Change group of file or files  to new group name or ID number located in /etc/group.
-
-                Only the current owner or a priveleged user may change the group name or ID 
-
-	-R  	Follows the directory tree from the current location thru all sub-directories,
-
-		applying changes.
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-chroot NEWROOT [Command...]                  (System Admin Command)
-
-		Run command with root directory set to NEWROOT.  Only the current owner or a priveleged	
-
-                user may use this command.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-clear
-
-		Clear screen.
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-cp [option] fileA fileB
-
-	Copy fileA to fileB or fileA to directory maintaining fileA name.
-
-		-a	archive		Maintain file attributes whenever possible. Same as -dpR
-
-		-d	no dereference	Maintain hard link relationships between fileA and fileB.
-
- 					No dereference of symbolic links.
-
-		-p	maintain file	Maintain all file attributes and information including owner 
-
-                        attributes      group permissions and time information.
-
-		-R      recursive	Copies directories recursively
-
-
-
-
-
-_________________________________________________________________________________________________________
-
-
-
-
-
-date [option [+format] [date]
-
-date [option] [MMDDhhmm[[CC]YY][.SS]]
-
-	Display the current system date and time.
-
-		-R	RFC-822 string	Output an RFC-822 compliant date string.
-
-		-s	set DATE	Set date where date is entered in MMDDhhmm etc. format.
-
-		-u	universal	Print or set Coordinated Universal Time.
-
-
-
-
-
-_______________________________________________________________________________________________________
-
-
-
-
-
-
-dd [if=name] [of=name] [bs=n] [count=n]
-
-
-	Copy a file, converting and formatting according to options.  Most useful when copying from
-
-	physical input and output devices.
-
-		if=fileA  (instead of standard input)
-
-		of=fileB  (instead of standard output)
-
-		bs=n      Read and write N Bytes at a time.
-
-		count=n   Copy only n input blocks.
-
-	Bytes may be suffixed by k for x1024, b for x512 and w for x2.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-df
-
-
-	Display filesystem, number of blocks used, number of blocks available, number of blocks in use,
-
-        and mount point.
-        
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-dmesg [-c] [-n level] [-s bufsize]            (System Admin Command)
-
-
-	Display system control messages.  Stored in the kernel ring buffer are all messages since the
-
-        last system boot, or the most recent if the buffer had been full.
-
-
-		-c		Clear buffer after printing messages.
-		
-		-n level 	Set the level of system message to be displayed on the console.
-
-		-s bufsize      Display the size of the kernel ring buffer.
-        
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-find [PATH] [EXPRESSION]
-
-	Search for files in the current directory, and all subdirectories for patterns that match
-
-	expression.  Expressions may consist of the following.
-
-		-follow		Dereference symbolic links.
-
-		-name PATTERN	Find files that match PATTERN. Metacharacters should be escaped or  
-
-				quoted.
-
-		-print		Print full file name, followed by a newline, to standard out.
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-chvt N
-
-	Change foreground virtual terminal to /dev/ttyN.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-deallocvt N
-
-	Deallocate unused virtual terminal /dev/ttyN.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-fsck.minix [-larvsmf] /dev/name
-
-	Perform a consistency check for minix filesystems.
-
-		-l	List filenames.
-
-		-r	Perform interactive repairs. 
-
-		-a	Perform automatic repairs
-
-		-v	Verbose
-
-		-s	Output superblock information
-
-		-m	Activates minix-like "mode not cleared" warnings.
-
-		-f 	Force file system check.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-mkfs.minix [-c | -l filename ] [-nXX] [-iXX] /dev/name [blocks]
-
-	Make a minix file system.
-
-		-c	Check device for bad blocks.
-
-		-n	[ 14|30 ] Specify max length of filenames.
-
-		-i	Specify number of inodes for filesystem.
-
-		-l filename
-
-			Read the bad blocks list from filename.
-
-		-v	Make a minix version 2 filesystem.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-grep [OPTIONS] PATTERN [FILE]
-
-	Search for PATTERN in each FILE or from standard input.
-
-		-h	Suppress prefixing filename on output.
-
-		-i	Ignore case distinctions.
-
-		-n	Print line number with output lines.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-init
-
-	The parent of all processes.  Only to be run by the kernel.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-kill [ -s sigspec | -signum | -sigspec ] [pid | job ]  or
-
-kill -l [ exitstatus ]
-
-	Currently no information help page for this command
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-ln [option] TARGET... LINK_NAME|DIRECTORY
-
-	Create a link named LINK_NAME or DIRECTORY to TARGET.
-
-		-s	Make symbolic links instead of hard links.
-
-		-f	Remove existing destination files.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-ls [ -1acdelnpuxACF ] [FILENAMES]
-
-	List contents of directories.
-
-		-1 	Single entry per column of output.
-
-		-a	All files including hidden files beginning with a ..	
-
-		-c	Files are listed by status change time.
-
-		-d	List directories, not there contents.
-
-		-e	List both full date and full time
-
-		-l	List in long format including permissions, owner, size
-
-			modification time etc.	
-
-		-n	Similar to -l, except use group ID and user ID instead
-
-			of owner and group names.
-
-		-p	Directories are marked with a /.
-
-		-u	Display files sorted by file access time.
-
-		-x	Display files across the screen in rows.
-
-		-A	Display hidden and all other files except . and ...
-
-		-C	(Default, display files in columns)
-
-		-F	Tag files by type by appending:
-
-				/ to directories
-	
-				* to executables
-
-				@ to symbolic links
-
-				| to fifo's
-
-				= to sockets
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-mkdir [OPTION] directory
-
-	Create directories if they do not already exist.  You must have write permission to create
-
-	directories. Default mode can be modified by users umask.
-
-		-m	Used to set permission mode. (See chmod description)
-
-		-p	Make parent directories if they don't already exist.  Return error code if
-
-			they already exist.
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-mknod NAME TYPE MAJOR MINOR
-
-Make block or character special files.
-
-TYPEs include:
-        b:      Make a block (buffered) device.
-        c or u: Make a character (un-buffered) device.
-        p:      Make a named pipe. Major and minor are ignored for named pipes.
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-mkswap [-c] [ -v0|-v1 ] device [block-count]
-
-	Prepare a disk partition to be used as a swap partition.
-
-		-c	Check for read-ability.
-
-		-v0	Make version 0 swap [max 128 megs]
-
-		-v1	Make version 1 swap [big |] default for
-
-			kernels > 2.1.117.
-
-		block-count
-
-			Number of blocks to use. (Default is the entire 
-
-			partition).
-
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-more [file]
-
-	Display file one screen page at a time.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-mount [flags]
-
-mount [flags] device directory [-o options, more options ]
-
-	Mount a filesystem for file access.
-
-		-a	Mount all file systems in fstab.
-
-		-o option
-
-			async/sync:  	Writes are asynchronous/synchronous.
-
-			dev/nodev:   	Allow use of special device files
-
-				     	/disallow them.
-
-			exec/noexec:	Allow use of executable files
-
-					/disallow them.
-
-			suid/nosuid:	Allow set-user-id-root programs
-
-					/disallow them.
-
-			remount:	Remount a currently-mounted filesystem
-
-					changing it's flags.
-
-			ro/rw:		Mount for read-only/read-write.
-
-			(There are more flags specific to each filesystem.
-
-			 See the written documentation for those.)
-
-		-r	Mount the filesystem read only.
-
-		-t FILESYSTEM TYPE
-
-			Specify the filesystem type.
-
-		-w	Mount for reading and writing default
-
-		
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-mv fileA fileB    or
-
-mv fileA dirA
-
-	Move fileA to fileB.  (Renames fileA to fileB)
-
-	Move fileA to dirA    (Moves fileA into dirA)
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-ps
-
-	Report process status.  No options are currently supported.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-pwd
-
-	Print working directory  
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-reboot
-
-	Reboot system.  No options are currently supported.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-rm [option] file
-
-	Remove or unlink the files.
-
-		-f	Remove existing destinations.  Never prompt.
-
-		-r or -R  Remove contents of directories recursively.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-rmdir [OPTION] ... directory
-
-	Remove directories if they are empty.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-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 expresions.
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-sleep N
-
-	Pause for N seconds.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-tar -[cxtvOf] [tarFileName] [file]
-
-	Create, extract or list files from a tar file.
-
-		c=create
-		
-		x=extract
-
-		t=list contents
-
-		v=verbose
-
-		O=extract to stdout
-
-		f=tarfile or "-" for standard input
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-swapon device
-
-	Start swapping virtual memory pages on the given device.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-swapoff device
-
-	Stop swapping virtual memory pages on the given device.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-sync
-
-	Write all buffered filesystem blocks to disk.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-touch [-c] file [file...]
-
-	Update the last modified date on given file(s).
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-true
-
-	A null command that returns a successful 0 exit status code. (See false)
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-false
-
-	A null command that returns an unsuccessful or non-zero exit status.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-uname [option]
-
-	Print certain system information.  With no option, same as -s.
-
-		-a	Display all information
-
-		-m	Display machine hardware type.
-
-		-n	Display machine network node hostname.
-
-		-r	Display OS release
-
-		-s	Display OS Name.
-
-		-p	Display Host processor type.
-
-		-v	Display OS Version.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-umount [flags] filesystem | directory
-
-	Unmounts designated filesystem previously mounted on device.
-
-		-a	Unmount all file systems.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-update
-
-cvs update [options] files
-
-	Incorporates recent changes from the repository into files in your working directory.  No 
-
-	options are currently supported.
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-zcat [options] files
-
-	Usage: zcat [OPTION]... FILE
-
-	Uncompress FILE (or standard input if FILE is '-').
-	(When invoked as zcat, defaults to having -c turned on)
-
-	Options:
-		-c      Write output to standard output
-		-t      Test compressed file integrity
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-gunzip  (Same as zcat, but without the "-c" option.)
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-gzip [OPTION]... FILE
-
-	Compress FILE with maximum compression.
-	When FILE is -, reads standard input.  Implies -c.
-
-	Options:
-		-c      Write output to standard output instead of FILE.gz
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-
-loadfont   
-
-	No information available with --help.
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-loadkmap
-
-	No information available with --help
-
-
-
-
-
-________________________________________________________________________________________________________
-
-
-
-
-
-linuxrc
-
-	No information available with --help
-
-
-
-
-
-________________________________________________________________________________________________________
-