busybox/usage.c
Glenn L McGrath 06aeb6c417 ar.c now uses a linked list to process headers, uses getopt, new internal function extractAr(srcFD, dstFd, filename) to make it easily accessable to other busybox functions.
moved copySubFile from ar.c to utilities.c

modified dd.c to use fullWrite

modified copyFile in utilities.c to use copySubFile
2000-08-25 03:50:10 +00:00

1328 lines
34 KiB
C

#include "internal.h"
#if defined BB_AR
const char ar_usage[] =
"ar [[-ov] -tpv archive] filenames \n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nExtract or list files from an ar archive.\n\n"
"Options:\n"
"\t-o\t\tpreserve original dates\n"
"\t-p\t\textract to stdout\n"
"\t-t\t\tlist\n"
"\t-x\t\textract\n"
"\t-v\t\tverbosely list files processed\n"
#endif
;
#endif
#if defined BB_BASENAME
const char basename_usage[] =
"basename FILE [SUFFIX]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nStrips directory path and suffixes from FILE.\n"
"If specified, also removes any trailing SUFFIX.\n"
#endif
;
#endif
#if defined BB_CAT
const char cat_usage[] =
"cat [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nConcatenates FILE(s) and prints them to stdout.\n"
#endif
;
#endif
#if defined BB_CHMOD_CHOWN_CHGRP
const char chgrp_usage[] =
"chgrp [OPTION]... GROUP FILE...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nChange the group membership of each FILE to GROUP.\n"
"\nOptions:\n\t-R\tChanges files and directories recursively.\n"
#endif
;
#endif
#if defined BB_CHMOD_CHOWN_CHGRP
const char chmod_usage[] =
"chmod [-R] MODE[,MODE]... FILE...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nEach MODE is one or more of the letters ugoa, one of the symbols +-= and\n"
"one or more of the letters rwxst.\n\n"
"\nOptions:\n\t-R\tChanges files and directories recursively.\n"
#endif
;
#endif
#if defined BB_CHMOD_CHOWN_CHGRP
const char chown_usage[] =
"chown [OPTION]... OWNER[<.|:>[GROUP] FILE...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nChange the owner and/or group of each FILE to OWNER and/or GROUP.\n"
"\nOptions:\n\t-R\tChanges files and directories recursively.\n"
#endif
;
#endif
#if defined BB_CHROOT
const char chroot_usage[] =
"chroot NEWROOT [COMMAND...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nRun COMMAND with root directory set to NEWROOT.\n"
#endif
;
#endif
#if defined BB_CHVT
const char chvt_usage[] =
"chvt N\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nChanges the foreground virtual terminal to /dev/ttyN\n"
#endif
;
#endif
#if defined BB_CLEAR
const char clear_usage[] =
"clear\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nClear screen.\n"
#endif
;
#endif
#if defined BB_CP_MV
const char cp_usage[] =
"cp [OPTION]... SOURCE DEST\n"
" or: cp [OPTION]... SOURCE... DIRECTORY\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCopies SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.\n"
"\n"
"\t-a\tSame as -dpR\n"
"\t-d\tPreserves links\n"
"\t-p\tPreserves file attributes if possible\n"
"\t-f\tforce (implied; ignored) - always set\n"
"\t-R\tCopies directories recursively\n"
#endif
;
#endif
#if defined BB_CUT
const char cut_usage[] =
"cut [OPTION]... [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints selected fields from each input FILE to standard output.\n\n"
"Options:\n"
"\t-b LIST\tOutput only bytes from LIST\n"
"\t-c LIST\tOutput only characters from LIST\n"
"\t-d CHAR\tUse CHAR instead of tab as the field delimiter\n"
"\t-s\tOutput only the lines containing delimiter\n"
"\t-f N\tPrint only these fields\n"
"\t-n\tIgnored\n"
#endif
;
#endif
#if defined BB_DATE
const char date_usage[] =
"date [OPTION]... [+FORMAT]\n"
" or: date [OPTION] [MMDDhhmm[[CC]YY][.ss]]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDisplays the current time in the given FORMAT, or sets the system date.\n"
"\nOptions:\n\t-R\tOutputs RFC-822 compliant date string\n"
"\t-s\tSets time described by STRING\n"
"\t-u\tPrints or sets Coordinated Universal Time\n"
#endif
;
#endif
#if defined BB_DC
const char dc_usage[] =
"dc expression ...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nThis is a Tiny RPN calculator that understands the\n"
"following operations: +, -, /, *, and, or, not, eor.\n"
"i.e. 'dc 2 2 add' -> 4, and 'dc 8 8 \\* 2 2 + /' -> 16\n"
#endif
;
#endif
#if defined BB_DD
const char dd_usage[] =
"dd [if=FILE] [of=FILE] [bs=N] [count=N] [skip=N] [seek=N]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCopy a file, converting and formatting according to options\n\n"
"\tif=FILE\tread from FILE instead of stdin\n"
"\tof=FILE\twrite to FILE instead of stdout\n"
"\tbs=N\tread and write N bytes at a time\n"
"\tcount=N\tcopy only N input blocks\n"
"\tskip=N\tskip N input blocks\n"
"\tseek=N\tskip N output blocks\n"
"\n"
"Numbers may be suffixed by w (x2), k (x1024), b (x512), or M (x1024^2)\n"
#endif
;
#endif
#if defined BB_DEALLOCVT
const char deallocvt_usage[] =
"deallocvt N\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDeallocate unused virtual terminal /dev/ttyN\n"
#endif
;
#endif
#if defined BB_DF
const char df_usage[] =
"df [filesystem ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint the filesystem space used and space available.\n"
#endif
;
#endif
#if defined BB_DIRNAME
const char dirname_usage[] =
"dirname [FILENAME ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nStrips non-directory suffix from FILENAME\n"
#endif
;
#endif
#if defined BB_DMESG
const char dmesg_usage[] =
"dmesg [-c] [-n LEVEL] [-s SIZE]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints or controls the kernel ring buffer\n\n"
"Options:\n"
"\t-c\t\tClears the ring buffer's contents after printing\n"
"\t-n LEVEL\tSets console logging level\n"
"\t-s SIZE\t\tUse a buffer of size SIZE\n"
#endif
;
#endif
#if defined BB_DU
const char du_usage[] =
"du [OPTION]... [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSummarizes disk space used for each FILE and/or directory.\n"
"Disk space is printed in units of 1024 bytes.\n\n"
"Options:\n"
"\t-l\tcount sizes many times if hard linked\n"
"\t-s\tdisplay only a total for each argument\n"
#endif
;
#endif
#if defined BB_DUMPKMAP
const char dumpkmap_usage[] =
"dumpkmap\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints out a binary keyboard translation table to standard input.\n"
#endif
;
#endif
#if defined BB_DUTMP
const char dutmp_usage[] =
"dutmp [FILE]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDump utmp file format (pipe delimited) from FILE\n"
"or stdin to stdout. (i.e. 'dutmp /var/run/utmp')\n"
#endif
;
#endif
#if defined BB_ECHO
const char echo_usage[] =
"echo [-neE] [ARG ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints the specified ARGs to stdout\n\n"
"Options:\n"
"\t-n\tsuppress trailing newline\n"
"\t-e\tinterpret backslash-escaped characters (i.e. \\t=tab etc)\n"
"\t-E\tdisable interpretation of backslash-escaped characters\n"
#endif
;
#endif
#if defined BB_TRUE_FALSE
const char false_usage[] =
"false\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nReturn an exit code of FALSE (1).\n"
#endif
;
#endif
#if defined BB_FDFLUSH
const char fdflush_usage[] =
"fdflush DEVICE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nForces floppy disk drive to detect disk change\n"
#endif
;
#endif
#if defined BB_FIND
const char find_usage[] =
"find [PATH...] [EXPRESSION]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSearch for files in a directory hierarchy. The default PATH is\n"
"the current directory; default EXPRESSION is '-print'\n\n"
"\nEXPRESSION may consist of:\n"
"\t-follow\t\tDereference symbolic links.\n"
"\t-name PATTERN\tFile name (leading directories removed) matches PATTERN.\n"
"\t-print\t\tprint the full file name followed by a newline to stdout.\n"
#endif
;
#endif
#if defined BB_FREE
const char free_usage[] =
"free\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDisplays the amount of free and used system memory\n"
#endif
;
#endif
#if defined BB_FREERAMDISK
const char freeramdisk_usage[] =
"freeramdisk DEVICE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nFrees all memory used by the specified ramdisk.\n"
#endif
;
#endif
#if defined BB_FSCK_MINIX
const char fsck_minix_usage[] =
"Usage: fsck.minix [-larvsmf] /dev/name\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPerforms a consistency check for MINIX filesystems.\n\n"
"Options:\n"
"\t-l\tLists all filenames\n"
"\t-r\tPerform interactive repairs\n"
"\t-a\tPerform automatic repairs\n"
"\t-v\tverbose\n"
"\t-s\tOutputs super-block information\n"
"\t-m\tActivates MINIX-like \"mode not cleared\" warnings\n"
"\t-f\tForce file system check.\n\n"
#endif
;
#endif
#if defined BB_GREP
const char grep_usage[] =
"grep [-ihHnqvs] pattern [files...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSearch for PATTERN in each FILE or standard input.\n\n"
"Options:\n"
"\t-H\tprefix output lines with filename where match was found\n"
"\t-h\tsuppress the prefixing filename on output\n"
"\t-i\tignore case distinctions\n"
"\t-n\tprint line number with output lines\n"
"\t-q\tbe quiet. Returns 0 if result was found, 1 otherwise\n"
"\t-v\tselect non-matching lines\n"
"\t-s\tsuppress file open/read error messages\n\n"
#endif
;
#endif
#if defined BB_GUNZIP
const char gunzip_usage[] =
"gunzip [OPTION]... FILE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nUncompress FILE (or standard input if FILE is '-').\n\n"
"Options:\n"
"\t-c\tWrite output to standard output\n"
"\t-t\tTest compressed file integrity\n"
#endif
;
#endif
#if defined BB_GZIP
const char gzip_usage[] =
"gzip [OPTION]... FILE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCompress FILE with maximum compression.\n"
"When FILE is '-', reads standard input. Implies -c.\n\n"
"Options:\n"
"\t-c\tWrite output to standard output instead of FILE.gz\n"
#endif
;
#endif
#if defined BB_HALT
const char halt_usage[] =
"halt\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nHalt the system.\n"
#endif
;
#endif
#if defined BB_HEAD
const char head_usage[] =
"head [OPTION] [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint first 10 lines of each FILE to standard output.\n"
"With more than one FILE, precede each with a header giving the\n"
"file name. With no FILE, or when FILE is -, read standard input.\n\n"
"Options:\n" "\t-n NUM\t\tPrint first NUM lines instead of first 10\n"
#endif
;
#endif
#if defined BB_HOSTID
const char hostid_usage[] =
"hostid\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint out a unique 32-bit identifier for the machine.\n"
#endif
;
#endif
#if defined BB_HOSTNAME
const char hostname_usage[] =
"hostname [OPTION] {hostname | -F file}\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nGet or set the hostname or DNS domain name. If a hostname is given\n"
"(or a file with the -F parameter), the host name will be set.\n\n"
"Options:\n"
"\t-s\t\tShort\n"
"\t-i\t\tAddresses for the hostname\n"
"\t-d\t\tDNS domain name\n"
"\t-F FILE\t\tUse the contents of FILE to specify the hostname\n"
#endif
;
#endif
#if defined BB_ID
const char id_usage[] =
"id [OPTIONS]... [USERNAME]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint information for USERNAME or the current user\n\n"
"Options:\n"
"\t-g\tprints only the group ID\n"
"\t-u\tprints only the user ID\n"
"\t-r\tprints the real user ID instead of the effective ID (with -ug)\n\n"
#endif
;
#endif
#if defined BB_INSMOD
const char insmod_usage[] =
"insmod [OPTION]... MODULE [symbol=value]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nLoads the specified kernel modules into the kernel.\n\n"
"Options:\n"
"\t-f\tForce module to load into the wrong kernel version.\n"
"\t-k\tMake module autoclean-able.\n"
"\t-v\tverbose output\n" "\t-x\tdo not export externs\n"
#endif
;
#endif
#if defined BB_KILL
const char kill_usage[] =
"kill [-signal] process-id [process-id ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSend a signal (default is SIGTERM) to the specified process(es).\n\n"
"Options:\n" "\t-l\tList all signal names and numbers.\n\n"
#endif
;
#endif
#if defined BB_KILLALL
const char killall_usage[] =
"killall [-signal] process-name [process-name ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSend a signal (default is SIGTERM) to the specified process(es).\n\n"
"Options:\n" "\t-l\tList all signal names and numbers.\n\n"
#endif
;
#endif
#if defined BB_LENGTH
const char length_usage[] =
"length STRING\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints out the length of the specified STRING.\n"
#endif
;
#endif
#if defined BB_LN
const char ln_usage[] =
"ln [OPTION] TARGET... LINK_NAME|DIRECTORY\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreate a link named LINK_NAME or DIRECTORY to the specified TARGET\n"
"\nYou may use '--' to indicate that all following arguments are non-options.\n\n"
"Options:\n"
"\t-s\tmake symbolic links instead of hard links\n"
"\t-f\tremove existing destination files\n"
"\t-n\tno dereference symlinks - treat like normal file\n"
#endif
;
#endif
#if defined BB_LOADACM
const char loadacm_usage[] =
"loadacm\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nLoads an acm from standard input.\n"
#endif
;
#endif
#if defined BB_LOADFONT
const char loadfont_usage[] =
"loadfont\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"Loads a console font from standard input.\n"
#endif
;
#endif
#if defined BB_LOADKMAP
const char loadkmap_usage[] =
"loadkmap\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nLoads a binary keyboard translation table from standard input.\n"
#endif
;
#endif
#if defined BB_LOGGER
const char logger_usage[] =
"logger [OPTION]... [MESSAGE]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nWrite MESSAGE to the system log. If MESSAGE is '-', log stdin.\n\n"
"Options:\n"
"\t-s\tLog to stderr as well as the system log.\n"
"\t-t\tLog using the specified tag (defaults to user name).\n"
"\t-p\tEnter the message with the specified priority.\n"
"\t\tThis may be numerical or a ``facility.level'' pair.\n"
#endif
;
#endif
#if defined BB_LOGNAME
const char logname_usage[] =
"logname\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint the name of the current user.\n"
#endif
;
#endif
#if defined BB_LS
const char ls_usage[] =
"ls [-1a"
#ifdef BB_FEATURE_LS_TIMESTAMPS
"c"
#endif
"d"
#ifdef BB_FEATURE_LS_TIMESTAMPS
"e"
#endif
"ln"
#ifdef BB_FEATURE_LS_FILETYPES
"p"
#endif
#ifdef BB_FEATURE_LS_TIMESTAMPS
"u"
#endif
"xAC"
#ifdef BB_FEATURE_LS_FILETYPES
"F"
#endif
#ifdef BB_FEATURE_LS_RECURSIVE
"R"
#endif
"] [filenames...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nList directory contents\n\n"
"Options:\n"
"\t-a\tdo not hide entries starting with .\n"
#ifdef BB_FEATURE_LS_TIMESTAMPS
"\t-c\twith -l: show ctime (the time of last\n"
"\t\tmodification of file status information)\n"
#endif
"\t-d\tlist directory entries instead of contents\n"
#ifdef BB_FEATURE_LS_TIMESTAMPS
"\t-e\tlist both full date and full time\n"
#endif
"\t-l\tuse a long listing format\n"
"\t-n\tlist numeric UIDs and GIDs instead of names\n"
#ifdef BB_FEATURE_LS_FILETYPES
"\t-p\tappend indicator (one of /=@|) to entries\n"
#endif
#ifdef BB_FEATURE_LS_TIMESTAMPS
"\t-u\twith -l: show access time (the time of last\n"
"\t\taccess of the file)\n"
#endif
"\t-x\tlist entries by lines instead of by columns\n"
"\t-A\tdo not list implied . and ..\n"
"\t-C\tlist entries by columns\n"
#ifdef BB_FEATURE_LS_FILETYPES
"\t-F\tappend indicator (one of */=@|) to entries\n"
#endif
#ifdef BB_FEATURE_LS_RECURSIVE
"\t-R\tlist subdirectories recursively\n"
#endif
#endif
;
#endif
#if defined BB_LSMOD
const char lsmod_usage[] =
"lsmod\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nList the currently loaded kernel modules.\n"
#endif
;
#endif
#if defined BB_MAKEDEVS
const char makedevs_usage[] =
"makedevs NAME TYPE MAJOR MINOR FIRST LAST [s]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreates a range of block or character special files\n\n"
"TYPEs include:\n"
"\tb:\tMake a block (buffered) device.\n"
"\tc or u:\tMake a character (un-buffered) device.\n"
"\tp:\tMake a named pipe. MAJOR and MINOR are ignored for named pipes.\n\n"
"FIRST specifies the number appended to NAME to create the first device.\n"
"LAST specifies the number of the last item that should be created.\n"
"If 's' is the last argument, the base device is created as well.\n\n"
"For example:\n"
"\tmakedevs /dev/ttyS c 4 66 2 63 -> ttyS2-ttyS63\n"
"\tmakedevs /dev/hda b 3 0 0 8 s -> hda,hda1-hda8\n"
#endif
;
#endif
#if defined BB_MD5SUM
const char md5sum_usage[] =
"md5sum [OPTION] [FILE]...\n"
"or: md5sum [OPTION] -c [FILE]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint or check MD5 checksums.\n\n"
"Options:\n"
"With no FILE, or when FILE is -, read standard input.\n\n"
"\t-b\tread files in binary mode\n"
"\t-c\tcheck MD5 sums against given list\n"
"\t-t\tread files in text mode (default)\n"
"\t-g\tread a string\n"
"\nThe following two options are useful only when verifying checksums:\n"
"\t-s,\tdon't output anything, status code shows success\n"
"\t-w,\twarn about improperly formated MD5 checksum lines\n"
#endif
;
#endif
#if defined BB_MKDIR
const char mkdir_usage[] =
"mkdir [OPTION] DIRECTORY...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreate the DIRECTORY(ies), if they do not already exist\n\n"
"Options:\n"
"\t-m\tset permission mode (as in chmod), not rwxrwxrwx - umask\n"
"\t-p\tno error if existing, make parent directories as needed\n"
#endif
;
#endif
#if defined BB_MKFIFO
const char mkfifo_usage[] =
"mkfifo [OPTIONS] name\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreates a named pipe (identical to 'mknod name p')\n\n"
"Options:\n"
"\t-m\tcreate the pipe using the specified mode (default a=rw)\n"
#endif
;
#endif
#if defined BB_MKFS_MINIX
const char mkfs_minix_usage[] =
"mkfs.minix [-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nMake a MINIX filesystem.\n\n"
"Options:\n"
"\t-c\t\tCheck the device for bad blocks\n"
"\t-n [14|30]\tSpecify the maximum length of filenames\n"
"\t-i INODES\tSpecify the number of inodes for the filesystem\n"
"\t-l FILENAME\tRead the bad blocks list from FILENAME\n"
"\t-v\t\tMake a Minix version 2 filesystem\n\n"
#endif
;
#endif
#if defined BB_MKNOD
const char mknod_usage[] =
"mknod [OPTIONS] NAME TYPE MAJOR MINOR\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreate a special file (block, character, or pipe).\n\n"
"Options:\n"
"\t-m\tcreate the special file using the specified mode (default a=rw)\n\n"
"TYPEs include:\n"
"\tb:\tMake a block (buffered) device.\n"
"\tc or u:\tMake a character (un-buffered) device.\n"
"\tp:\tMake a named pipe. MAJOR and MINOR are ignored for named pipes.\n"
#endif
;
#endif
#if defined BB_MKSWAP
const char mkswap_usage[] =
"mkswap [-c] [-v0|-v1] device [block-count]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrepare a disk partition to be used as a swap partition.\n\n"
"Options:\n" "\t-c\t\tCheck for read-ability.\n"
"\t-v0\t\tMake version 0 swap [max 128 Megs].\n"
"\t-v1\t\tMake version 1 swap [big!] (default for kernels > 2.1.117).\n"
"\tblock-count\tNumber of block to use (default is entire partition).\n"
#endif
;
#endif
#if defined BB_MKTEMP
const char mktemp_usage[] =
"mktemp [-q] TEMPLATE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreates a temporary file with its name based on TEMPLATE.\n"
"TEMPLATE is any name with six `Xs' (i.e. /tmp/temp.XXXXXX).\n"
#endif
;
#endif
#if defined BB_MORE
const char more_usage[] =
"more [FILE ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nMore is a filter for viewing FILE one screenful at a time.\n"
#endif
;
#endif
#if defined BB_MOUNT
const char mount_usage[] =
"mount [flags] device directory [-o options,more-options]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nMount a filesystem\n\n"
"Flags:\n"
"\t-a:\t\tMount all filesystems in fstab.\n"
#ifdef BB_MTAB
"\t-f:\t\t\"Fake\" mount. Add entry to mount table but don't mount it.\n"
"\t-n:\t\tDon't write a mount table entry.\n"
#endif
"\t-o option:\tOne of many filesystem options, listed below.\n"
"\t-r:\t\tMount the filesystem read-only.\n"
"\t-t fs-type:\tSpecify the filesystem type.\n"
"\t-w:\t\tMount for reading and writing (default).\n"
"\n"
"Options for use with the \"-o\" flag:\n"
"\tasync/sync:\tWrites are asynchronous / synchronous.\n"
"\tatime/noatime:\tEnable / disable updates to inode access times.\n"
"\tdev/nodev:\tAllow use of special device files / disallow them.\n"
"\texec/noexec:\tAllow use of executable files / disallow them.\n"
#if defined BB_FEATURE_MOUNT_LOOP
"\tloop:\t\tMounts a file via loop device.\n"
#endif
"\tsuid/nosuid:\tAllow set-user-id-root programs / disallow them.\n"
"\tremount:\tRe-mount a currently-mounted filesystem, changing its flags.\n"
"\tro/rw:\t\tMount for read-only / read-write.\n"
"\nThere are EVEN MORE flags that are specific to each filesystem.\n"
"You'll have to see the written documentation for those.\n"
#endif
;
#endif
#if defined BB_MT
const char mt_usage[] =
"mt [-f device] opcode value\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nControl magnetic tape drive operation\n"
"\nAvailable Opcodes:\n\n"
"bsf bsfm bsr bss datacompression drvbuffer eof eom erase\n"
"fsf fsfm fsr fss load lock mkpart nop offline ras1 ras2\n"
"ras3 reset retension rew rewoffline seek setblk setdensity\n"
"setpart tell unload unlock weof wset\n"
#endif
;
#endif
#if defined BB_CP_MV
const char mv_usage[] =
"mv SOURCE DEST\n"
" or: mv SOURCE... DIRECTORY\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nRename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.\n"
#endif
;
#endif
#if defined BB_NC
const char nc_usage[] =
"nc [IP] [port]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nNetcat opens a pipe to IP:port\n"
#endif
;
#endif
#if defined BB_NSLOOKUP
const char nslookup_usage[] =
"nslookup [HOST]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nQueries the nameserver for the IP address of the given HOST\n"
#endif
;
#endif
#if defined BB_PING
#if defined BB_FEATURE_SIMPLE_PING
const char ping_usage[] =
"ping host\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSend ICMP ECHO_REQUEST packets to network hosts\n"
#endif
;
#else /* ! defined BB_FEATURE_SIMPLE_PING */
const char ping_usage[] =
"ping [OPTION]... host\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSend ICMP ECHO_REQUEST packets to network hosts.\n\n"
"Options:\n"
"\t-c COUNT\tSend only COUNT pings.\n"
"\t-s SIZE\t\tSend SIZE data bytes in packets (default=56).\n"
"\t-q\t\tQuiet mode, only displays output at start\n"
"\t\t\tand when finished.\n"
#endif
;
#endif
#endif
#if defined BB_POWEROFF
const char poweroff_usage[] =
"poweroff\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nHalt the system and request that the kernel shut off the power.\n"
#endif
;
#endif
#if defined BB_PRINTF
const char printf_usage[] =
"printf FORMAT [ARGUMENT...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nFormats and prints ARGUMENT(s) according to FORMAT,\n"
"Where FORMAT controls the output exactly as in C printf.\n"
#endif
;
#endif
#if defined BB_PS
const char ps_usage[] =
"ps\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nReport process status\n"
"\nThis version of ps accepts no options.\n"
#endif
;
#endif
#if defined BB_PWD
const char pwd_usage[] =
"pwd\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint the full filename of the current working directory.\n"
#endif
;
#endif
#if defined BB_RDATE
const char rdate_usage[] =
"rdate [OPTION] HOST\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nGet and possibly set the system date and time from a remote HOST.\n"
"Options:\n"
"\t-s\tSet the system date and time (default).\n"
"\t-p\tPrint the date and time.\n"
#endif
;
#endif
#if defined BB_REBOOT
const char reboot_usage[] =
"reboot\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nReboot the system.\n"
#endif
;
#endif
#if defined BB_RENICE
const char renice_usage[] =
"renice priority pid [pid ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nChanges priority of running processes. Allowed priorities range\n"
"from 20 (the process runs only when nothing else is running) to 0\n"
"(default priority) to -20 (almost nothing else ever gets to run).\n"
#endif
;
#endif
#if defined BB_RESET
const char reset_usage[] =
"reset\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nResets the screen.\n"
#endif
;
#endif
#if defined BB_RM
const char rm_usage[] =
"rm [OPTION]... FILE...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nRemove (unlink) the FILE(s). You may use '--' to\n"
"indicate that all following arguments are non-options.\n\n"
"Options:\n"
"\t-f\t\tremove existing destinations, never prompt\n"
"\t-r or -R\tremove the contents of directories recursively\n"
#endif
;
#endif
#if defined BB_RMDIR
const char rmdir_usage[] =
"rmdir [OPTION]... DIRECTORY...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nRemove the DIRECTORY(ies), if they are empty.\n"
#endif
;
#endif
#if defined BB_RMMOD
const char rmmod_usage[] =
"rmmod [OPTION]... [MODULE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nUnloads the specified kernel modules from the kernel.\n\n"
"Options:\n"
"\t-a\tTry to remove all unused kernel modules.\n"
#endif
;
#endif
#if defined BB_SED
const char sed_usage[] =
"sed [-Vhnef] pattern [files...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\n"
"-n\t\tsuppress automatic printing of pattern space\n"
"-e script\tadd the script to the commands to be executed\n"
"-f scriptfile\tadd the contents of script-file to the commands to be executed\n"
"-h\t\tdisplay this help message\n"
"\n"
"If no -e or -f is given, the first non-option argument is taken as the\n"
"sed script to interpret. All remaining arguments are names of input\n"
"files; if no input files are specified, then the standard input is read.\n"
#endif
;
#endif
#if defined BB_SETKEYCODES
const char setkeycodes_usage[] =
"setkeycodes SCANCODE KEYCODE ...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSet entries into the kernel's scancode-to-keycode map,\n"
"allowing unusual keyboards to generate usable keycodes.\n\n"
"SCANCODE may be either xx or e0xx (hexadecimal),\n"
"and KEYCODE is given in decimal\n"
#endif
;
#endif
#if defined BB_SH
const char shell_usage[] =
"sh [FILE]...\n"
" or: sh -c command [args]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nlash: The BusyBox command interpreter (shell).\n\n"
#endif
;
#endif
#if defined BB_SLEEP
const char sleep_usage[] =
"sleep N\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPause for N seconds.\n"
#endif
;
#endif
#if defined BB_SORT
const char sort_usage[] =
"sort [-n]"
#ifdef BB_FEATURE_SORT_REVERSE
" [-r]"
#endif
" [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nSorts lines of text in the specified files\n"
#endif
;
#endif
#if defined BB_SWAPONOFF
const char swapoff_usage[] =
"swapoff [OPTION] [device]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nStop swapping virtual memory pages on the given device.\n\n"
"Options:\n"
"\t-a\tStop swapping on all swap devices\n"
#endif
;
#endif
#if defined BB_SWAPONOFF
const char swapon_usage[] =
"swapon [OPTION] [device]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nStart swapping virtual memory pages on the given device.\n\n"
"Options:\n"
"\t-a\tStart swapping on all swap devices\n"
#endif
;
#endif
#if defined BB_SYNC
const char sync_usage[] =
"sync\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nWrite all buffered filesystem blocks to disk.\n"
#endif
;
#endif
#if defined BB_SYSLOGD
const char syslogd_usage[] =
"syslogd [OPTION]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nLinux system and kernel (provides klogd) logging utility.\n"
"Note that this version of syslogd/klogd ignores /etc/syslog.conf.\n\n"
"Options:\n"
"\t-m NUM\t\tInterval between MARK lines (default=20min, 0=off)\n"
"\t-n\t\tRun as a foreground process\n"
#ifdef BB_FEATURE_KLOGD
"\t-K\t\tDo not start up the klogd process\n"
#endif
"\t-O FILE\t\tUse an alternate log file (default=/var/log/messages)\n"
#ifdef BB_FEATURE_REMOTE_LOG
"\t-R HOST[:PORT]\t\tLog remotely to IP or hostname on PORT (default PORT=514/UDP)\n"
#endif
#endif
;
#endif
#if defined BB_TAIL
const char tail_usage[] =
"tail [OPTION] [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint last 10 lines of each FILE to standard output.\n"
"With more than one FILE, precede each with a header giving the\n"
"file name. With no FILE, or when FILE is -, read standard input.\n\n"
"Options:\n"
#ifndef BB_FEATURE_SIMPLE_TAIL
"\t-c=N[kbm]\toutput the last N bytes\n"
#endif
"\t-n NUM\t\tPrint last NUM lines instead of first 10\n"
"\t\t\tAlso can be -NUM or +NUM.\n"
"\t-f\t\tOutput data as the file grows.\n"
#ifndef BB_FEATURE_SIMPLE_TAIL
"\t-q\t\tnever output headers giving file names\n"
"\t-s SEC\t\tWait SEC seconds between reads with -f\n"
"\t-v\t\talways output headers giving file names\n\n"
"If the first character of N (bytes or lines) is a `+', output begins with \n"
"the Nth item from the start of each file, otherwise, print the last N items\n"
"in the file. N bytes may be suffixed by k (x1024), b (x512), or m (1024^2).\n"
//#else
// "\nIf the first character of N (bytes or lines) is a `+', output begins with \n"
// "the Nth item from the start of each file.\n"
#endif
#endif
;
#endif
#if defined BB_TAR
const char tar_usage[] =
#ifdef BB_FEATURE_TAR_CREATE
"tar -[cxtvO] "
#else
"tar -[xtvO] "
#endif
#if defined BB_FEATURE_TAR_EXCLUDE
"[--exclude File] "
#endif
"[-f tarFile] [FILE(s)] ...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCreate, extract, or list files from a tar file. Note that\n"
"this version of tar treats hard links as separate files.\n\n"
"Main operation mode:\n"
#ifdef BB_FEATURE_TAR_CREATE
"\tc\t\tcreate\n"
#endif
"\tx\t\textract\n"
"\tt\t\tlist\n"
"\nFile selection:\n"
"\tf\t\tname of tarfile or \"-\" for stdin\n"
"\tO\t\textract to stdout\n"
#if defined BB_FEATURE_TAR_EXCLUDE
"\texclude\t\tfile to exclude\n"
#endif
"\nInformative output:\n"
"\tv\t\tverbosely list files processed\n"
#endif
;
#endif
#if defined BB_TEE
const char tee_usage[] =
"tee [OPTION]... [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nCopy standard input to each FILE, and also to standard output.\n\n"
"Options:\n" "\t-a\tappend to the given FILEs, do not overwrite\n"
#endif
;
#endif
#if defined BB_TELNET
const char telnet_usage[] =
"telnet host [port]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nTelnet is used to establish interactive communication with another\n"
"computer over a network using the TELNET protocol.\n"
#endif
;
#endif
#if defined BB_TEST
const char test_usage[] =
"test EXPRESSION\n"
"or [ EXPRESSION ]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nChecks file types and compares values returning an exit\n"
"code determined by the value of EXPRESSION.\n"
#endif
;
#endif
#if defined BB_TOUCH
const char touch_usage[] =
"touch [-c] file [file ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nUpdate the last-modified date on the given file[s].\n\n"
"Options:\n"
"\t-c\tDo not create any files\n"
#endif
;
#endif
#if defined BB_TR
const char tr_usage[] =
"tr [-cds] STRING1 [STRING2]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nTranslate, squeeze, and/or delete characters from\n"
"standard input, writing to standard output.\n\n"
"Options:\n"
"\t-c\ttake complement of STRING1\n"
"\t-d\tdelete input characters coded STRING1\n"
"\t-s\tsqueeze multiple output characters of STRING2 into one character\n"
#endif
;
#endif
#if defined BB_TRUE_FALSE
const char true_usage[] =
"true\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nReturn an exit code of TRUE (0).\n"
#endif
;
#endif
#if defined BB_TTY
const char tty_usage[] =
"tty\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint the file name of the terminal connected to standard input.\n\n"
"Options:\n"
"\t-s\tprint nothing, only return an exit status\n"
#endif
;
#endif
#if defined BB_UMOUNT
const char umount_usage[] =
"umount [flags] filesystem|directory\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"Unmount file systems\n"
"\nFlags:\n" "\t-a:\tUnmount all file systems"
#ifdef BB_MTAB
" in /etc/mtab\n\t-n:\tDon't erase /etc/mtab entries\n"
#else
"\n"
#endif
"\t-r:\tTry to remount devices as read-only if mount is busy\n"
#if defined BB_FEATURE_MOUNT_FORCE
"\t-f:\tForce filesystem umount (i.e. unreachable NFS server)\n"
#endif
#if defined BB_FEATURE_MOUNT_LOOP
"\t-l:\tDo not free loop device (if a loop device has been used)\n"
#endif
#endif
;
#endif
#if defined BB_UNAME
const char uname_usage[] =
"uname [OPTION]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint certain system information. With no OPTION, same as -s.\n\n"
"Options:\n"
"\t-a\tprint all information\n"
"\t-m\tthe machine (hardware) type\n"
"\t-n\tprint the machine's network node hostname\n"
"\t-r\tprint the operating system release\n"
"\t-s\tprint the operating system name\n"
"\t-p\tprint the host processor type\n"
"\t-v\tprint the operating system version\n"
#endif
;
#endif
#if defined BB_UNIQ
const char uniq_usage[] =
"uniq [OPTION]... [INPUT [OUTPUT]]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDiscard all but one of successive identical lines from INPUT\n"
"(or standard input), writing to OUTPUT (or standard output).\n"
#endif
;
#endif
#if defined BB_UPDATE
const char update_usage[] =
"update [options]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPeriodically flushes filesystem buffers.\n\n"
"Options:\n"
"\t-S\tforce use of sync(2) instead of flushing\n"
"\t-s SECS\tcall sync this often (default 30)\n"
"\t-f SECS\tflush some buffers this often (default 5)\n"
#endif
;
#endif
#if defined BB_UPTIME
const char uptime_usage[] =
"uptime\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nDisplay the time since the last boot.\n"
#endif
;
#endif
#if defined BB_USLEEP
const char usleep_usage[] =
"usleep N\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPause for N microseconds.\n"
#endif
;
#endif
#if defined BB_UUDECODE
const char uudecode_usage[] =
"uudecode [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nUudecode a file that is uuencoded.\n\n"
"Options:\n"
"\t-o FILE\tdirect output to FILE\n"
#endif
;
#endif
#if defined BB_UUENCODE
const char uuencode_usage[] =
"uuencode [OPTION] [INFILE] REMOTEFILE\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nUuencode a file.\n\n"
"Options:\n"
"\t-m\tuse base64 encoding as of RFC1521\n"
#endif
;
#endif
#if defined BB_WC
const char wc_usage[] =
"wc [OPTION]... [FILE]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrint line, word, and byte counts for each FILE, and a total line if\n"
"more than one FILE is specified. With no FILE, read standard input.\n\n"
"Options:\n"
"\t-c\tprint the byte counts\n"
"\t-l\tprint the newline counts\n"
"\t-L\tprint the length of the longest line\n"
"\t-w\tprint the word counts\n"
#endif
;
#endif
#if defined BB_WHICH
const char which_usage[] =
"which [COMMAND ...]\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nLocates a COMMAND.\n"
#endif
;
#endif
#if defined BB_WHOAMI
const char whoami_usage[] =
"whoami\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nPrints the user name associated with the current effective user id.\n"
#endif
;
#endif
#if defined BB_YES
const char yes_usage[] =
"yes [OPTION]... [STRING]...\n"
#ifndef BB_FEATURE_TRIVIAL_HELP
"\nRepeatedly outputs a line with all specified STRING(s), or `y'.\n"
#endif
;
#endif