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


________________________________________________________________________________________________________