X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=include%2Fusage.h;h=a17f5b18965b2f158b783e10341015a3c7267b15;hb=3734b946bfef55c8f63d367422da5c7aa7b972db;hp=4e520655853fc9ac0d5a4fb72ab193becd31303c;hpb=f8138d1f91c913166bffb0077a0fe06831a77ecf;p=oweals%2Fbusybox.git diff --git a/include/usage.h b/include/usage.h index 4e5206558..a17f5b189 100644 --- a/include/usage.h +++ b/include/usage.h @@ -12,9 +12,9 @@ #define __BB_USAGE_H__ #define addgroup_trivial_usage \ - "[-g GID] group_name [user_name]" + "[-g GID]"USE_FEATURE_ADDUSER_TO_GROUP(" [user_name]")" group_name" #define addgroup_full_usage \ - "Add a group to the system" \ + "Add a group to the system"USE_FEATURE_ADDUSER_TO_GROUP(" or add an user to a group") \ "\n\nOptions:\n" \ " -g GID Specify gid" @@ -23,13 +23,13 @@ #define adduser_full_usage \ "Add a user to the system" \ "\n\nOptions:\n" \ - " -h DIR Assign home directory DIR\n" \ - " -g GECOS Assign gecos field GECOS\n" \ - " -s SHELL Assign login shell SHELL\n" \ - " -G Add the user to existing group GROUP\n" \ + " -h DIR Home directory\n" \ + " -g GECOS GECOS field\n" \ + " -s SHELL Login shell\n" \ + " -G GROUP Add user to existing group\n" \ " -S Create a system user (ignored)\n" \ " -D Do not assign a password (logins still possible via ssh)\n" \ - " -H Do not create the home directory" + " -H Do not create home directory" #define adjtimex_trivial_usage \ "[-q] [-o offset] [-f frequency] [-p timeconstant] [-t tick]" @@ -37,10 +37,10 @@ "Read and optionally set system timebase parameters.\n" \ "See adjtimex(2)." \ "\n\nOptions:\n" \ - " -q Quiet mode - do not print\n" \ + " -q Quiet\n" \ " -o offset Time offset, microseconds\n" \ " -f frequency Frequency adjust, integer kernel units (65536 is 1ppm)\n" \ - " (positive values make the system clock run fast)\n" \ + " (positive values make the system clock run faster)\n" \ " -t tick Microseconds per tick, usually 10000\n" \ " -p timeconstant" @@ -53,14 +53,14 @@ " -p Extract to stdout\n" \ " -t List\n" \ " -x Extract\n" \ - " -v Verbosely list files processed" + " -v Verbose" #define arp_trivial_usage \ "\n" \ "[-vn] [-H type] [-i if] -a [hostname]\n" \ "[-v] [-i if] -d hostname [pub]\n" \ "[-v] [-H type] [-i if] -s hostname hw_addr [temp]\n" \ - "[-v] [-H type] [-i if] -s hostname hw_addr [netmask nm] pub\n" \ + "[-v] [-H type] [-i if] -s hostname hw_addr [netmask nm] pub\n" \ "[-v] [-H type] [-i if] -Ds hostname ifa [netmask nm] pub\n" #define arp_full_usage \ "Manipulate the system ARP cache" \ @@ -81,14 +81,14 @@ "Ping hosts by ARP requests/replies" \ "\n\nOptions:\n" \ " -f Quit on first ARP reply\n" \ - " -q Be quiet\n" \ + " -q Quiet\n" \ " -b Keep broadcasting, don't go unicast\n" \ " -D Duplicated address detection mode\n" \ " -U Unsolicited ARP mode, update your neighbours\n" \ " -A ARP answer mode, update your neighbours\n" \ " -c count Stop after sending count ARP request packets\n" \ " -w timeout Time to wait for ARP reply, in seconds\n" \ - " -i device Outgoing interface name, default is eth0\n" \ + " -I device Outgoing interface name, default is eth0\n" \ " -s sender Set specific sender IP address\n" \ " target Target IP address of ARP request" @@ -102,9 +102,9 @@ "[OPTION]... [program-text] [FILE ...]" #define awk_full_usage \ "Options:\n" \ - " -v var=val Assign value 'val' to variable 'var'\n" \ + " -v var=val Set variable\n" \ " -F sep Use 'sep' as field separator\n" \ - " -f progname Read program source from file 'progname'" + " -f filename Read program from file" #define basename_trivial_usage \ "FILE [SUFFIX]" @@ -152,16 +152,16 @@ "[-jy] [[month] year]" #define cal_full_usage \ "Display a calendar" \ - "\n\nOptions:\n" \ - " -j Use julian dates\n" \ - " -y Display the entire year" + "\n\nOptions:" \ + "\n -j Use julian dates" \ + "\n -y Display the entire year" #define cat_trivial_usage \ "[-u] [FILE]..." #define cat_full_usage \ "Concatenate FILE(s) and print them to stdout" \ - "\n\nOptions:\n" \ - " -u Ignored since unbuffered i/o is always used" + "\n\nOptions:" \ + "\n -u Use unbuffered i/o (ignored)" #define cat_example_usage \ "$ cat /proc/uptime\n" \ "110716.72 17.67" @@ -198,24 +198,22 @@ " -R Recursively list subdirectories\n" \ " -v Set the file's version/generation number" -#define chgrp_trivial_usage \ - "[-Rh"USE_DESKTOP("cvf")"]... GROUP FILE..." -#define chgrp_full_usage \ - "Change the group membership of each FILE to GROUP" \ - "\n\nOptions:\n" \ - " -R Changes files and directories recursively\n" \ - " -h Do not dereference symbolic links" \ - USE_DESKTOP( \ - "\n -c List changed files" \ - "\n -v List all files" \ - "\n -f Hide errors" \ - ) -#define chgrp_example_usage \ - "$ ls -l /tmp/foo\n" \ - "-r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo\n" \ - "$ chgrp root /tmp/foo\n" \ - "$ ls -l /tmp/foo\n" \ - "-r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo\n" +#define chcon_trivial_usage \ + "[OPTIONS] CONTEXT FILE...\n" \ + " chcon [OPTIONS] [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE...\n" \ + " chcon [OPTIONS] --reference=RFILE FILE...\n" +#define chcon_full_usage \ + "Change the security context of each FILE to CONTEXT\n" \ + "\n -v, --verbose Verbose" \ + "\n -c, --changes Report changes made" \ + "\n -h, --no-dereference Affect symlinks instead of their targets" \ + "\n -f, --silent, --quiet Suppress most error messages" \ + "\n --reference=RFILE Use RFILE's group instead of using a CONTEXT value" \ + "\n -u, --user=USER Set user USER in the target security context" \ + "\n -r, --role=ROLE Set role ROLE in the target security context" \ + "\n -t, --type=TYPE Set type TYPE in the target security context" \ + "\n -l, --range=RANGE Set range RANGE in the target security context" \ + "\n -R, --recursive Recurse subdirectories" \ #define chmod_trivial_usage \ "[-R"USE_DESKTOP("cvf")"] MODE[,MODE]... FILE..." @@ -223,7 +221,7 @@ "Each MODE is one or more of the letters ugoa, one of the\n" \ "symbols +-= and one or more of the letters rwxst" \ "\n\nOptions:" \ - "\n -R Changes files and directories recursively" \ + "\n -R Recurse directories" \ USE_DESKTOP( \ "\n -c List changed files" \ "\n -v List all files" \ @@ -239,13 +237,38 @@ "$ ls -l /tmp/foo\n" \ "-r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo\n" +#define chgrp_trivial_usage \ + "[-RhLHP"USE_DESKTOP("cvf")"]... GROUP FILE..." +#define chgrp_full_usage \ + "Change the group membership of each FILE to GROUP" \ + "\n\nOptions:" \ + "\n -R Recurse directories" \ + "\n -h Affect symlinks instead of symlink targets" \ + "\n -L Traverse all symlinks to directories" \ + "\n -H Traverse symlinks on command line only" \ + "\n -P Do not traverse symlinks (default)" \ + USE_DESKTOP( \ + "\n -c List changed files" \ + "\n -v Verbose" \ + "\n -f Hide errors" \ + ) +#define chgrp_example_usage \ + "$ ls -l /tmp/foo\n" \ + "-r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo\n" \ + "$ chgrp root /tmp/foo\n" \ + "$ ls -l /tmp/foo\n" \ + "-r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo\n" + #define chown_trivial_usage \ - "[-Rh"USE_DESKTOP("cvf")"]... OWNER[<.|:>[GROUP]] FILE..." + "[-RhLHP"USE_DESKTOP("cvf")"]... OWNER[<.|:>[GROUP]] FILE..." #define chown_full_usage \ "Change the owner and/or group of each FILE to OWNER and/or GROUP" \ "\n\nOptions:" \ - "\n -R Changes files and directories recursively" \ - "\n -h Do not dereference symbolic links" \ + "\n -R Recurse directories" \ + "\n -h Affect symlinks instead of symlink targets" \ + "\n -L Traverse all symlinks to directories" \ + "\n -H Traverse symlinks on command line only" \ + "\n -P Do not traverse symlinks (default)" \ USE_DESKTOP( \ "\n -c List changed files" \ "\n -v List all files" \ @@ -269,7 +292,7 @@ "Change the process state and run specified program" \ "\n\nOptions:\n" \ " -u user[:grp] Set uid and gid\n" \ - " -U user[:grp] Set environment variables UID and GID\n" \ + " -U user[:grp] Set environment variables UID and GID\n" \ " -e dir Set environment variables as specified by files\n" \ " in the directory: file=1st_line_of_file\n" \ " -/ dir Chroot to dir\n" \ @@ -312,7 +335,7 @@ " -s n Limit the stack segment per process to n bytes\n" \ " -l n Limit the locked physical pages per process to n bytes\n" \ " -a n Limit the total of all segments per process to n bytes\n" \ - " -o n Limit the number of open file descriptors per process to n\n" \ + " -o n Limit the number of open file descriptors per process to n\n" \ " -p n Limit the number of processes per uid to n\n" \ "Options controlling file sizes:\n" \ " -f n Limit output file sizes to n bytes\n" \ @@ -354,13 +377,13 @@ "Clear screen" #define cmp_trivial_usage \ - "[-l] [-s] FILE1 [FILE2]" + "[-l] [-s] FILE1 [FILE2" USE_DESKTOP(" [SKIP1 [SKIP2]") "]]" #define cmp_full_usage \ "Compares FILE1 vs stdin if FILE2 is not specified" \ "\n\nOptions:\n" \ " -l Write the byte numbers (decimal) and values (octal)\n" \ " for all differing bytes\n" \ - " -s Quiet mode - do not print" + " -s Quiet" #define comm_trivial_usage \ "[-123] FILE1 FILE2" @@ -382,19 +405,38 @@ #define bbsh_full_usage \ "The bbsh shell (command interpreter)" +#define chrt_trivial_usage \ + "[OPTION]... [prio] [pid | command [arg]...]" +#define chrt_full_usage \ + "manipulate real-time attributes of a process" \ + "\n\nOptions:\n" \ + " -p operate on pid\n" \ + " -r set scheduling policy to SCHED_RR\n" \ + " -f set scheduling policy to SCHED_FIFO\n" \ + " -o set scheduling policy to SCHED_OTHER\n" \ + " -m show min and max priorities" + +#define chrt_example_usage \ + "$ chrt -r 4 sleep 900; x=$!\n" \ + "$ chrt -f -p 3 $x\n" \ + "You need CAP_SYS_NICE privileges to set scheduling attributes of a process" + #define cp_trivial_usage \ "[OPTION]... SOURCE DEST" #define cp_full_usage \ "Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY" \ - "\n\nOptions:\n" \ - " -a Same as -dpR\n" \ - " -d,-P Preserve links\n" \ - " -H,-L Dereference all symlinks (implied by default)\n" \ - " -p Preserve file attributes if possible\n" \ - " -f Force, overwrite\n" \ - " -i Interactive, prompt before overwrite\n" \ - " -R,-r Copy directories recursively\n" \ - " -l,-s Create (sym)links" + "\n\nOptions:" \ + "\n -a Same as -dpR" \ + USE_SELINUX( \ + "\n -c Preserves security context" \ + ) \ + "\n -d,-P Preserve links" \ + "\n -H,-L Dereference all symlinks (default)" \ + "\n -p Preserve file attributes if possible" \ + "\n -f Force overwrite" \ + "\n -i Prompt before overwrite" \ + "\n -R,-r Recurse directories" \ + "\n -l,-s Create (sym)links" #define cpio_trivial_usage \ "-[dimtuv][F cpiofile]" @@ -410,7 +452,7 @@ " F Input from file" #define crond_trivial_usage \ - "-d[#] -c -f -b" + "-d[#] -c crondir -f -b" #define crond_full_usage \ " -d [#] -l [#] -S -L logfile -f -b -c dir\n" \ " -d num Debug level\n" \ @@ -424,14 +466,21 @@ #define crontab_trivial_usage \ "[-c dir] {file|-}|[-u|-l|-e|-d user]" #define crontab_full_usage \ - " File replace crontab from file\n" \ - " - replace crontab from stdin\n" \ - " -u user specify user\n" \ - " -l [user] list crontab for user\n" \ - " -e [user] edit crontab for user\n" \ - " -d [user] delete crontab for user\n" \ - " -c dir specify crontab directory" - + " file [opts] Replace crontab from file\n" \ + " - [opts] Replace crontab from stdin\n" \ + " -u user Specify user\n" \ + " -l [user] List crontab for user\n" \ + " -e [user] Edit crontab for user\n" \ + " -d [user] Delete crontab for user\n" \ + " -c dir Specify crontab directory" + +#define cryptpw_trivial_usage \ + "[-a des|md5] [string]" +#define cryptpw_full_usage \ + "Outputs crypted string.\n" \ + "If string isn't supplied on cmdline, reads it from stdin.\n" \ + "\nOptions:" \ + "\n -a Algorithm to use (default: md5)" #define cut_trivial_usage \ "[OPTION]... [FILE]..." @@ -497,7 +546,7 @@ #define dd_trivial_usage \ "[if=FILE] [of=FILE] " USE_FEATURE_DD_IBS_OBS("[ibs=N] [obs=N] ") "[bs=N] [count=N] [skip=N]\n" \ - " [seek=N]" USE_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync]") + " [seek=N]" USE_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync]") #define dd_full_usage \ "Copy a file with converting and formatting" \ "\n\nOptions:\n" \ @@ -529,9 +578,10 @@ "Deallocate unused virtual terminal /dev/ttyN" #define delgroup_trivial_usage \ - "GROUP" + USE_FEATURE_DEL_USER_FROM_GROUP("[USER] ")"GROUP" #define delgroup_full_usage \ - "Delete group GROUP from the system" + "Delete group GROUP from the system" \ + USE_FEATURE_DEL_USER_FROM_GROUP(" or user USER from group GROUP") #define deluser_trivial_usage \ "USER" @@ -631,13 +681,13 @@ " -c Config filename\n" \ " -t TTL in seconds\n" \ " -p Listening port\n" \ - " -i Listening iface ip (default all)\n" \ + " -i Listening ip (default all)\n" \ " -d Daemonize" #define dos2unix_trivial_usage \ "[option] [FILE]" #define dos2unix_full_usage \ - "Convert FILE from dos format to unix format. When no option\n" \ + "Convert FILE from dos format to unix format. When no option\n" \ "is given, the input is converted to the opposite output format.\n" \ "When no file is given, use stdin for input and stdout for output." \ "\n\nOptions:\n" \ @@ -680,8 +730,8 @@ " bytes." \ "\n\nOptions:\n" \ " -a Show sizes of files in addition to directories\n" \ - " -H Follow symbolic links that are FILE command line args\n" \ - " -L Follow all symbolic links encountered\n" \ + " -H Follow symlinks that are FILE command line args\n" \ + " -L Follow all symlinks encountered\n" \ " -d N Limit output to directories (and files with -a) of depth < N\n" \ " -c Output a grand total\n" \ " -l Count sizes many times if hard linked\n" \ @@ -735,7 +785,7 @@ " -y Assume 'yes' to all questions\n" \ " -c Check for bad blocks and add them to the badblock list\n" \ " -f Force checking even if filesystem is marked clean\n" \ - " -v Be verbose\n" \ + " -v Verbose\n" \ " -b superblock Use alternative superblock\n" \ " -B blocksize Force blocksize when looking for superblock\n" \ " -j journal Set location of the external journal\n" \ @@ -755,7 +805,7 @@ #define echo_example_usage \ "$ echo \"Erik is cool\"\n" \ "Erik is cool\n" \ - USE_FEATURE_FANCY_ECHO("$ echo -e \"Erik\\nis\\ncool\"\n" \ + USE_FEATURE_FANCY_ECHO("$ echo -e \"Erik\\nis\\ncool\"\n" \ "Erik\n" \ "is\n" \ "cool\n" \ @@ -822,26 +872,20 @@ " (EXPRESSION) Value of EXPRESSION\n\n" \ "Beware that many operators need to be escaped or quoted for shells.\n" \ "Comparisons are arithmetic if both ARGs are numbers, else\n" \ - "lexicographical. Pattern matches return the string matched between\n" \ + "lexicographical. Pattern matches return the string matched between\n" \ "\\( and \\) or null; if \\( and \\) are not used, they return the number\n" \ "of characters matched or 0." -#if 0 /* bloaty */ #define fakeidentd_trivial_usage \ - "[-b ip] [STRING]" + "[-fiw] [-b ADDR] [STRING]" #define fakeidentd_full_usage \ - "Return a set string to auth requests" \ - "\n\nOptions:\n" \ - " -b Bind to ip address\n" \ - " STRING The ident answer string (default is nobody)" -#else /* inetd-only */ -#define fakeidentd_trivial_usage \ - "[username]" -#define fakeidentd_full_usage \ - "Return a (faked) ident response.\n" \ - "This applet is meant to run from inetd.\n" \ - "Optional argument is the username to return (default is 'nobody')." -#endif + "Provide fake ident (auth) service" \ + "\n\nOptions:" \ + "\n -f Run in foreground" \ + "\n -i Inetd mode" \ + "\n -w Inetd 'wait' mode" \ + "\n -b ADDR Bind to specified address" \ + "\n STRING Ident answer string (default is 'nobody')" #define false_trivial_usage \ "" @@ -895,38 +939,59 @@ #define find_trivial_usage \ "[PATH...] [EXPRESSION]" #define find_full_usage \ - "Search for files in a directory hierarchy. The default PATH is\n" \ - "the current directory; default EXPRESSION is '-print'\n" \ - "\nEXPRESSION may consist of:\n" \ - " -follow Dereference symbolic links\n" \ - " -name PATTERN File name (leading directories removed) matches PATTERN\n" \ - " -print Print (default and assumed)" \ + "Search for files in a directory hierarchy. The default PATH is\n" \ + "the current directory, default EXPRESSION is '-print'\n" \ + "\nEXPRESSION may consist of:" \ + "\n -follow Dereference symlinks" \ + USE_FEATURE_FIND_XDEV( \ + "\n -xdev Don't descend directories on other filesystems") \ + USE_FEATURE_FIND_MAXDEPTH( \ + "\n -maxdepth N Descend at most N levels. -maxdepth 0 applies" \ + "\n tests/actions to command line arguments only") \ + "\n -name PATTERN File name (w/o directory name) matches PATTERN" \ + USE_FEATURE_FIND_PATH( \ + "\n -path PATTERN Path matches PATTERN") \ + USE_FEATURE_FIND_REGEX( \ + "\n -regex PATTERN Path matches regex PATTERN") \ + USE_FEATURE_FIND_TYPE( \ + "\n -type X File type is X (X is one of: f,d,l,b,c,...)") \ + USE_FEATURE_FIND_PERM( \ + "\n -perm NNN Permissions match any of (+NNN), all of (-NNN)," \ + "\n or exactly (NNN)") \ + USE_FEATURE_FIND_MTIME( \ + "\n -mtime DAYS Modified time is greater than (+N), less than (-N)," \ + "\n or exactly (N) days") \ + USE_FEATURE_FIND_MMIN( \ + "\n -mmin MINS Modified time is greater than (+N), less than (-N)," \ + "\n or exactly (N) minutes") \ + USE_FEATURE_FIND_NEWER( \ + "\n -newer FILE Modified time is more recent than FILE's") \ + USE_FEATURE_FIND_INUM( \ + "\n -inum N File has inode number N") \ + USE_FEATURE_FIND_USER( \ + "\n -user NAME File is owned by user NAME (numeric user ID allowed)") \ + USE_FEATURE_FIND_GROUP( \ + "\n -group NAME File belongs to group NAME (numeric group ID allowed)") \ + USE_FEATURE_FIND_DEPTH( \ + "\n -depth Process directory name after traversing it") \ + USE_FEATURE_FIND_SIZE( \ + "\n -size N[bck] File size is N (c:bytes,k:kbytes,b:512 bytes(def.))." \ + "\n +/-N: file size is bigger/smaller than N") \ + "\n -print Print (default and assumed)" \ USE_FEATURE_FIND_PRINT0( \ - "\n -print0 Delimit output with null characters rather than" \ - "\n newlines" \ - ) USE_FEATURE_FIND_TYPE( \ - "\n -type X Filetype matches X (where X is one of: f,d,l,b,c,...)" \ - ) USE_FEATURE_FIND_PERM( \ - "\n -perm PERMS Permissions match any of (+NNN); all of (-NNN);" \ - "\n or exactly (NNN)" \ - ) USE_FEATURE_FIND_MTIME( \ - "\n -mtime DAYS Modified time is greater than (+N); less than (-N);" \ - "\n Or exactly (N) days" \ - ) USE_FEATURE_FIND_MMIN( \ - "\n -mmin MINS Modified time is greater than (+N); less than (-N);" \ - "\n or exactly (N) minutes" \ - ) USE_FEATURE_FIND_NEWER( \ - "\n -newer FILE Modified time is more recent than FILE's" \ - ) USE_FEATURE_FIND_INUM( \ - "\n -inum N File has inode number N" \ - ) USE_FEATURE_FIND_EXEC( \ - "\n -exec CMD Execute CMD with all instances of {} replaced by the" \ - "\n files matching EXPRESSION" \ - ) USE_DESKTOP( \ - "\n -size N File size is N" \ - "\n -prune Stop traversing current subtree" \ - "\n (expr) Group" \ - ) + "\n -print0 Delimit output with null characters rather than" \ + "\n newlines") \ + USE_FEATURE_FIND_CONTEXT ( \ + "\n -context File has specified security context") \ + USE_FEATURE_FIND_EXEC( \ + "\n -exec CMD ARG ; Execute CMD with all instances of {} replaced by the" \ + "\n matching files") \ + USE_FEATURE_FIND_PRUNE( \ + "\n -prune Stop traversing current subtree") \ + USE_FEATURE_FIND_DELETE( \ + "\n -delete Delete files, turns on -depth option") \ + USE_FEATURE_FIND_PAREN( \ + "\n (EXPR) Group an expression") \ #define find_example_usage \ "$ find / -name passwd\n" \ @@ -961,7 +1026,7 @@ "$ freeramdisk /dev/ram2\n" #define fsck_trivial_usage \ - "[-ANPRTV] [ -C fd ] [-t fstype] [fs-options] [filesys ...]" + "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys ...]" #define fsck_full_usage \ "Check and repair filesystems" \ "\n\nOptions:\n" \ @@ -1019,6 +1084,9 @@ " -6 When using port/proto only search IPv6 space\n" \ " -SIGNAL When used with -k, this signal will be used to kill" +#define getenforce_trivial_usage +#define getenforce_full_usage + #define getopt_trivial_usage \ "[OPTIONS]..." #define getopt_full_usage \ @@ -1037,22 +1105,27 @@ "#!/bin/sh\n" \ "GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \\\n" \ " -n 'example.busybox' -- \"$@\"`\n" \ - "if [ $? != 0 ] ; then exit 1 ; fi\n" \ + "if [ $? != 0 ]; then exit 1; fi\n" \ "eval set -- \"$GETOPT\"\n" \ - "while true ; do\n" \ + "while true; do\n" \ " case $1 in\n" \ - " -a|--a-long) echo \"Option a\" ; shift ;;\n" \ - " -b|--b-long) echo \"Option b, argument '$2'\" ; shift 2 ;;\n" \ + " -a|--a-long) echo \"Option a\"; shift;;\n" \ + " -b|--b-long) echo \"Option b, argument '$2'\"; shift 2;;\n" \ " -c|--c-long)\n" \ " case \"$2\" in\n" \ - " \"\") echo \"Option c, no argument\"; shift 2 ;;\n" \ - " *) echo \"Option c, argument '$2'\" ; shift 2 ;;\n" \ - " esac ;;\n" \ - " --) shift ; break ;;\n" \ - " *) echo \"Internal error!\" ; exit 1 ;;\n" \ + " \"\") echo \"Option c, no argument\"; shift 2;;\n" \ + " *) echo \"Option c, argument '$2'\"; shift 2;;\n" \ + " esac;;\n" \ + " --) shift; break;;\n" \ + " *) echo \"Internal error!\"; exit 1;;\n" \ " esac\n" \ "done\n" +#define getsebool_trivial_usage \ + "-a or getsebool boolean..." +#define getsebool_full_usage \ + " -a Show all SELinux booleans" + #define getty_trivial_usage \ "[OPTIONS]... baud_rate,... line [termtype]" #define getty_full_usage \ @@ -1071,36 +1144,39 @@ " -H login_host Log login_host into the utmp file as the hostname" #define grep_trivial_usage \ - "[-rihHnqvso" \ + "[-HhrilLnqvso" \ + USE_DESKTOP("w") \ + "eF" \ USE_FEATURE_GREP_EGREP_ALIAS("E") \ USE_FEATURE_GREP_CONTEXT("ABC") \ "] PATTERN [FILEs...]" #define grep_full_usage \ "Search for PATTERN in each FILE or standard input" \ - "\n\nOptions:\n" \ - " -H Prefix output lines with filename where match was found\n" \ - " -h Suppress the prefixing filename on output\n" \ - " -r Recurse subdirectories\n" \ - " -i Ignore case distinctions\n" \ - " -l List names of files that match\n" \ - " -L List names of files that do not match\n" \ - " -n Print line number with output lines\n" \ - " -q Be quiet. Returns 0 if PATTERN was found, 1 otherwise\n" \ - " -v Select non-matching lines\n" \ - " -s Suppress file open/read error messages\n" \ - " -c Only print count of matching lines\n" \ - " -f Read PATTERN from file\n" \ - " -o Show only the part of a line that matches PATTERN\n" \ - " -e PATTERN is a regular expression\n" \ - " -F PATTERN is a set of newline-separated strings" \ + "\n\nOptions:" \ + "\n -H Prefix output lines with filename where match was found" \ + "\n -h Suppress the prefixing filename on output" \ + "\n -r Recurse subdirectories" \ + "\n -i Ignore case distinctions" \ + "\n -l List names of files that match" \ + "\n -L List names of files that do not match" \ + "\n -n Print line number with output lines" \ + "\n -q Quiet. Returns 0 if PATTERN was found, 1 otherwise" \ + "\n -v Select non-matching lines" \ + "\n -s Suppress file open/read error messages" \ + "\n -c Only print count of matching lines" \ + "\n -o Show only the part of a line that matches PATTERN" \ + "\n -m MAX Match up to MAX times per file" \ + USE_DESKTOP( \ + "\n -w Match whole words only") \ + "\n -F PATTERN is a set of newline-separated strings" \ USE_FEATURE_GREP_EGREP_ALIAS( \ "\n -E PATTERN is an extended regular expression") \ + "\n -e PTRN Pattern to match" \ + "\n -f FILE Read pattern from file" \ USE_FEATURE_GREP_CONTEXT( \ - "\n -A Print NUM lines of trailing context") \ - USE_FEATURE_GREP_CONTEXT( \ - "\n -B Print NUM lines of leading context") \ - USE_FEATURE_GREP_CONTEXT( \ - "\n -C Print NUM lines of output context") + "\n -A Print NUM lines of trailing context" \ + "\n -B Print NUM lines of leading context" \ + "\n -C Print NUM lines of output context") \ #define grep_example_usage \ "$ grep root /etc/passwd\n" \ @@ -1127,7 +1203,7 @@ "[OPTION]... [FILE]..." #define gzip_full_usage \ "Compress FILE(s) with maximum compression.\n" \ - "When FILE is '-' or unspecified, reads standard input. Implies -c." \ + "When FILE is '-' or unspecified, reads standard input. Implies -c." \ "\n\nOptions:\n" \ " -c Write output to standard output instead of FILE.gz\n" \ " -d Decompress\n" \ @@ -1140,7 +1216,7 @@ "-rw-rw-r-- 1 andersen andersen 554058 Apr 14 17:49 /tmp/busybox.tar.gz\n" #define halt_trivial_usage \ - "[-d] [-n] [-f]" + "[-d delay] [-n] [-f]" #define halt_full_usage \ "Halt the system" \ "\n\nOptions:\n" \ @@ -1256,14 +1332,14 @@ "sage\n" #define httpd_trivial_usage \ - "[-c ]" \ - " [-p ]" \ + "[-c conffile]" \ + " [-p port]" \ " [-i] [-f]" \ USE_FEATURE_HTTPD_SETUID(" [-u user[:grp]]") \ - USE_FEATURE_HTTPD_BASIC_AUTH(" [-r ]") \ + USE_FEATURE_HTTPD_BASIC_AUTH(" [-r realm]") \ USE_FEATURE_HTTPD_AUTH_MD5(" [-m pass]") \ " [-h home]" \ - " [-d/-e ]" + " [-d/-e string]" #define httpd_full_usage \ "Listen for incoming http server requests" \ "\n\nOptions:\n" \ @@ -1282,15 +1358,18 @@ " -d STRING URL decode STRING" #define hwclock_trivial_usage \ - "[-r|--show] [-s|--hctosys] [-w|--systohc] [-l|--localtime] [-u|--utc]" + "[-r|--show] [-s|--hctosys] [-w|--systohc]" \ + " [-l|--localtime] [-u|--utc]" \ + " [-f FILE]" #define hwclock_full_usage \ - "Query and set the hardware clock (RTC)" \ + "Query and set a hardware clock (RTC)" \ "\n\nOptions:\n" \ " -r Read hardware clock and print result\n" \ " -s Set the system time from the hardware clock\n" \ " -w Set the hardware clock to the current system time\n" \ " -u The hardware clock is kept in coordinated universal time\n" \ - " -l The hardware clock is kept in local time" + " -l The hardware clock is kept in local time\n" \ + " -f FILE Use the specified clock (e.g. /dev/rtc2)" #define id_trivial_usage \ "[OPTIONS]... [USERNAME]" @@ -1298,7 +1377,8 @@ "Print information for USERNAME or the current user" \ "\n\nOptions:\n" \ USE_SELINUX( \ - " -c Prints only the security context\n") \ + " -Z prints only the security context\n" \ + ) \ " -g Prints only the group ID\n" \ " -u Prints only the user ID\n" \ " -n Print a name instead of a number\n" \ @@ -1308,27 +1388,27 @@ "uid=1000(andersen) gid=1000(andersen)\n" #define ifconfig_trivial_usage \ - USE_FEATURE_IFCONFIG_STATUS("[-a]") " [
]" + USE_FEATURE_IFCONFIG_STATUS("[-a]") " interface [address]" #define ifconfig_full_usage \ "Configure a network interface" \ "\n\nOptions:\n" \ USE_FEATURE_IPV6( \ - " [add
[/]]\n") \ + " [add ADDRESS[/PREFIXLEN]]\n") \ USE_FEATURE_IPV6( \ - " [del
[/]]\n") \ - " [[-]broadcast [
]] [[-]pointopoint [
]]\n" \ - " [netmask
] [dstaddr
]\n" \ + " [del ADDRESS[/PREFIXLEN]]\n") \ + " [[-]broadcast [ADDRESS]] [[-]pointopoint [ADDRESS]]\n" \ + " [netmask ADDRESS] [dstaddr ADDRESS]\n" \ USE_FEATURE_IFCONFIG_SLIP( \ - " [outfill ] [keepalive ]\n") \ - " " USE_FEATURE_IFCONFIG_HW("[hw ether
] ") "[metric ] [mtu ]\n" \ + " [outfill NN] [keepalive NN]\n") \ + " " USE_FEATURE_IFCONFIG_HW("[hw ether ADDRESS] ") "[metric NN] [mtu NN]\n" \ " [[-]trailers] [[-]arp] [[-]allmulti]\n" \ - " [multicast] [[-]promisc] [txqueuelen ] [[-]dynamic]\n" \ + " [multicast] [[-]promisc] [txqueuelen NN] [[-]dynamic]\n" \ USE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ( \ - " [mem_start ] [io_addr ] [irq ]\n") \ + " [mem_start NN] [io_addr NN] [irq NN]\n") \ " [up|down] ..." #define ifup_trivial_usage \ - "<-ahinv> " + "[-ahinv] ifaces..." #define ifup_full_usage \ "Options:\n" \ " -a De/configure all interfaces automatically\n" \ @@ -1340,7 +1420,7 @@ " -f Force de/configuration" #define ifdown_trivial_usage \ - "<-ahinv> " + "[-ahinv] ifaces..." #define ifdown_full_usage \ "Options:\n" \ " -a De/configure all interfaces automatically\n" \ @@ -1367,11 +1447,11 @@ #define init_notes_usage \ "This version of init is designed to be run only by the kernel.\n" \ "\n" \ -"BusyBox init doesn't support multiple runlevels. The runlevels field of\n" \ +"BusyBox init doesn't support multiple runlevels. The runlevels field of\n" \ "the /etc/inittab file is completely ignored by BusyBox init. If you want\n" \ "runlevels, use sysvinit.\n" \ "\n" \ -"BusyBox init works just fine without an inittab. If no inittab is found,\n" \ +"BusyBox init works just fine without an inittab. If no inittab is found,\n" \ "it has the following default behavior:\n" \ "\n" \ " ::sysinit:/etc/init.d/rcS\n" \ @@ -1395,13 +1475,13 @@ "\n" \ " WARNING: This field has a non-traditional meaning for BusyBox init!\n" \ " The id field is used by BusyBox init to specify the controlling tty for\n" \ -" the specified process to run on. The contents of this field are\n" \ -" appended to \"/dev/\" and used as-is. There is no need for this field to\n" \ -" be unique, although if it isn't you may have strange results. If this\n" \ -" field is left blank, the controlling tty is set to the console. Also\n" \ +" the specified process to run on. The contents of this field are\n" \ +" appended to \"/dev/\" and used as-is. There is no need for this field to\n" \ +" be unique, although if it isn't you may have strange results. If this\n" \ +" field is left blank, the controlling tty is set to the console. Also\n" \ " note that if BusyBox detects that a serial console is in use, then only\n" \ " entries whose controlling tty is either the serial console or /dev/null\n" \ -" will be run. BusyBox init does nothing with utmp. We don't need no\n" \ +" will be run. BusyBox init does nothing with utmp. We don't need no\n" \ " stinkin' utmp.\n" \ "\n" \ " :\n" \ @@ -1419,35 +1499,35 @@ "\n" \ " Run only-once actions:\n" \ "\n" \ -" 'sysinit' is the first item run on boot. init waits until all\n" \ -" sysinit actions are completed before continuing. Following the\n" \ +" 'sysinit' is the first item run on boot. init waits until all\n" \ +" sysinit actions are completed before continuing. Following the\n" \ " completion of all sysinit actions, all 'wait' actions are run.\n" \ " 'wait' actions, like 'sysinit' actions, cause init to wait until\n" \ -" the specified task completes. 'once' actions are asynchronous,\n" \ -" therefore, init does not wait for them to complete. 'restart' is\n" \ -" the action taken to restart the init process. By default this should\n" \ +" the specified task completes. 'once' actions are asynchronous,\n" \ +" therefore, init does not wait for them to complete. 'restart' is\n" \ +" the action taken to restart the init process. By default this should\n" \ " simply run /sbin/init, but can be a script which runs pivot_root or it\n" \ -" can do all sorts of other interesting things. The 'ctrlaltdel' init\n" \ +" can do all sorts of other interesting things. The 'ctrlaltdel' init\n" \ " actions are run when the system detects that someone on the system\n" \ -" console has pressed the CTRL-ALT-DEL key combination. Typically one\n" \ +" console has pressed the CTRL-ALT-DEL key combination. Typically one\n" \ " wants to run 'reboot' at this point to cause the system to reboot.\n" \ " Finally the 'shutdown' action specifies the actions to taken when\n" \ -" init is told to reboot. Unmounting filesystems and disabling swap\n" \ +" init is told to reboot. Unmounting filesystems and disabling swap\n" \ " is a very good here.\n" \ "\n" \ " Run repeatedly actions:\n" \ "\n" \ -" 'respawn' actions are run after the 'once' actions. When a process\n" \ +" 'respawn' actions are run after the 'once' actions. When a process\n" \ " started with a 'respawn' action exits, init automatically restarts\n" \ -" it. Unlike sysvinit, BusyBox init does not stop processes from\n" \ -" respawning out of control. The 'askfirst' actions acts just like\n" \ +" it. Unlike sysvinit, BusyBox init does not stop processes from\n" \ +" respawning out of control. The 'askfirst' actions acts just like\n" \ " respawn, except that before running the specified process it\n" \ " displays the line \"Please press Enter to activate this console.\"\n" \ " and then waits for the user to press enter before starting the\n" \ " specified process.\n" \ "\n" \ " Unrecognized actions (like initdefault) will cause init to emit an\n" \ -" error message, and then go along with its business. All actions are\n" \ +" error message, and then go along with its business. All actions are\n" \ " run in the order they appear in /etc/inittab.\n" \ "\n" \ " :\n" \ @@ -1498,8 +1578,8 @@ "\n\nOptions:\n" \ " -f Force module to load into the wrong kernel version\n" \ " -k Make module autoclean-able\n" \ - " -v Verbose output\n" \ - " -q Quiet output\n" \ + " -v Verbose\n" \ + " -q Quiet\n" \ " -L Lock to prevent simultaneous loads of a module\n" \ USE_FEATURE_INSMOD_LOAD_MAP( \ " -m Output load map to stdout\n") \ @@ -1507,7 +1587,7 @@ " -x Do not export externs" #define install_trivial_usage \ - "[-cgmops] [sources] " + "[-cgmops] [sources] dest|directory" #define install_full_usage \ "Copy files and set attributes" \ "\n\nOptions:\n" \ @@ -1517,29 +1597,44 @@ " -m Set permission modes\n" \ " -o Set ownership\n" \ " -p Preserve date\n" \ - " -s Strip symbol tables" - + " -s Strip symbol tables" \ + USE_SELINUX( \ + "\n -Z Set security context of copy" \ + ) +/* would need to make the " | " optional depending on more than one selected */ #define ip_trivial_usage \ - "[OPTIONS] {address | link | route | tunnel | rule} {COMMAND}" + "[OPTIONS] {" \ + USE_FEATURE_IP_ADDRESS("address | ") \ + USE_FEATURE_IP_ROUTE("route | ") \ + USE_FEATURE_IP_LINK("link | ") \ + USE_FEATURE_IP_TUNNEL("tunnel | ") \ + USE_FEATURE_IP_RULE("rule") \ + "} {COMMAND}" #define ip_full_usage \ "ip [OPTIONS] OBJECT {COMMAND}\n" \ - "where OBJECT := {link | addr | route | tunnel |rule}\n" \ + "where OBJECT := {" \ + USE_FEATURE_IP_ADDRESS("address | ") \ + USE_FEATURE_IP_ROUTE("route | ") \ + USE_FEATURE_IP_LINK("link | ") \ + USE_FEATURE_IP_TUNNEL("tunnel | ") \ + USE_FEATURE_IP_RULE("rule") \ + "}\n" \ "OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }" #define ipaddr_trivial_usage \ "{ {add|del} IFADDR dev STRING | {show|flush}\n" \ - " [ dev STRING ] [ to PREFIX ] }" + " [dev STRING] [to PREFIX] }" #define ipaddr_full_usage \ "ipaddr {add|delete} IFADDR dev STRING\n" \ - "ipaddr {show|flush} [ dev STRING ] [ scope SCOPE-ID ]\n" \ - " [ to PREFIX ] [ label PATTERN ]\n" \ + "ipaddr {show|flush} [dev STRING] [scope SCOPE-ID]\n" \ + " [to PREFIX] [label PATTERN]\n" \ " IFADDR := PREFIX | ADDR peer PREFIX\n" \ - " [ broadcast ADDR ] [ anycast ADDR ]\n" \ - " [ label STRING ] [ scope SCOPE-ID ]\n" \ - " SCOPE-ID := [ host | link | global | NUMBER ]" + " [broadcast ADDR] [anycast ADDR]\n" \ + " [label STRING] [scope SCOPE-ID]\n" \ + " SCOPE-ID := [host | link | global | NUMBER]" #define ipcalc_trivial_usage \ - "[OPTION]...
[[/]] [NETMASK]" + "[OPTION]... ADDRESS[[/]NETMASK] [NETMASK]" #define ipcalc_full_usage \ "Calculate IP network settings from a IP address" \ "\n\nOptions:" \ @@ -1579,44 +1674,44 @@ " -u Summary" #define iplink_trivial_usage \ - "{ set DEVICE { up | down | arp { on | off } | show [ DEVICE ] }" + "{ set DEVICE { up | down | arp { on | off } | show [DEVICE] }" #define iplink_full_usage \ - "iplink set DEVICE { up | down | arp { on | off } |\n" \ + "iplink set DEVICE { up | down | arp | multicast { on | off } |\n" \ " dynamic { on | off } |\n" \ " mtu MTU }\n" \ - "iplink show [ DEVICE ]" + "iplink show [DEVICE]" #define iproute_trivial_usage \ "{ list | flush | { add | del | change | append |\n" \ " replace | monitor } ROUTE }" #define iproute_full_usage \ "iproute { list | flush } SELECTOR\n" \ - "iproute get ADDRESS [ from ADDRESS iif STRING ]\n" \ - " [ oif STRING ] [ tos TOS ]\n" \ + "iproute get ADDRESS [from ADDRESS iif STRING]\n" \ + " [oif STRING] [tos TOS]\n" \ "iproute { add | del | change | append | replace | monitor } ROUTE\n" \ - " SELECTOR := [ root PREFIX ] [ match PREFIX ] [ proto RTPROTO ]\n" \ - " ROUTE := [ TYPE ] PREFIX [ tos TOS ] [ proto RTPROTO ]" + " SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n" \ + " ROUTE := [TYPE] PREFIX [tos TOS] [proto RTPROTO]" #define iprule_trivial_usage \ - "{[ list | add | del ] RULE}" + "{[list | add | del] RULE}" #define iprule_full_usage \ - "iprule [ list | add | del ] SELECTOR ACTION\n" \ - " SELECTOR := [ from PREFIX ] [ to PREFIX ] [ tos TOS ] [ fwmark FWMARK ]\n" \ - " [ dev STRING ] [ pref NUMBER ]\n" \ - " ACTION := [ table TABLE_ID ] [ nat ADDRESS ]\n" \ - " [ prohibit | reject | unreachable ]\n" \ - " [ realms [SRCREALM/]DSTREALM ]\n" \ - " TABLE_ID := [ local | main | default | NUMBER ]" + "iprule [list | add | del] SELECTOR ACTION\n" \ + " SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n" \ + " [dev STRING] [pref NUMBER]\n" \ + " ACTION := [table TABLE_ID] [nat ADDRESS]\n" \ + " [prohibit | reject | unreachable]\n" \ + " [realms [SRCREALM/]DSTREALM]\n" \ + " TABLE_ID := [local | main | default | NUMBER]" #define iptunnel_trivial_usage \ - "{ add | change | del | show } [ NAME ]\n" \ - " [ mode { ipip | gre | sit } ]\n" \ - " [ remote ADDR ] [ local ADDR ] [ ttl TTL ]" + "{ add | change | del | show } [NAME]\n" \ + " [mode { ipip | gre | sit }]\n" \ + " [remote ADDR] [local ADDR] [ttl TTL]" #define iptunnel_full_usage \ - "iptunnel { add | change | del | show } [ NAME ]\n" \ - " [ mode { ipip | gre | sit } ] [ remote ADDR ] [ local ADDR ]\n" \ - " [ [i|o]seq ] [ [i|o]key KEY ] [ [i|o]csum ]\n" \ - " [ ttl TTL ] [ tos TOS ] [ [no]pmtudisc ] [ dev PHYS_DEV ]" + "iptunnel { add | change | del | show } [NAME]\n" \ + " [mode { ipip | gre | sit }] [remote ADDR] [local ADDR]\n" \ + " [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n" \ + " [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]" #define kill_trivial_usage \ "[-l] [-signal] process-id [process-id ...]" @@ -1683,7 +1778,7 @@ " reached" #define setarch_trivial_usage \ - " [args ...]" + "personality program [args ...]" #define setarch_full_usage \ "Personality may be:\n" \ " linux32 Set 32bit uname emulation\n" \ @@ -1695,7 +1790,7 @@ "Create a link named LINK_NAME or DIRECTORY to the specified TARGET.\n" \ "You may use '--' to indicate that all following arguments are non-options." \ "\n\nOptions:\n" \ - " -s Make symbolic links instead of hard links\n" \ + " -s Make symlinks instead of hardlinks\n" \ " -f Remove existing destination files\n" \ " -n No dereference symlinks - treat like normal file\n" \ " -b Make a backup of the target (if exists) before link operation\n" \ @@ -1705,6 +1800,10 @@ "$ ls -l /tmp/ls\n" \ "lrwxrwxrwx 1 root root 7 Apr 12 18:39 ls -> BusyBox*\n" +#define load_policy_trivial_usage \ + "[FILE]" +#define load_policy_full_usage + #define loadfont_trivial_usage \ "< font" #define loadfont_full_usage \ @@ -1722,7 +1821,7 @@ #define logger_trivial_usage \ "[OPTION]... [MESSAGE]" #define logger_full_usage \ - "Write MESSAGE to the system log. If MESSAGE is omitted, log stdin." \ + "Write MESSAGE to the system log. If MESSAGE is omitted, log stdin." \ "\n\nOptions:\n" \ " -s Log to stderr as well as the system log\n" \ " -t TAG Log using the specified tag (defaults to user name)\n" \ @@ -1765,14 +1864,14 @@ #define losetup_notes_usage \ "No arguments will display all current associations.\n" \ "One argument (losetup /dev/loop1) will display the current association\n" \ - "(if any), or disassociate it (with -d). The display shows the offset\n" \ + "(if any), or disassociate it (with -d). The display shows the offset\n" \ "and filename of the file the loop device is currently bound to.\n\n" \ "Two arguments (losetup /dev/loop1 file.img) create a new association,\n" \ - "with an optional offset (-o 12345). Encryption is not yet supported.\n\n" + "with an optional offset (-o 12345). Encryption is not yet supported.\n\n" #define ls_trivial_usage \ "[-1Aa" USE_FEATURE_LS_TIMESTAMPS("c") "Cd" \ - USE_FEATURE_LS_TIMESTAMPS("e") USE_FEATURE_LS_FILETYPES("F") "iln" \ + USE_FEATURE_LS_TIMESTAMPS("e") USE_FEATURE_LS_FILETYPES("F") "iln" \ USE_FEATURE_LS_FILETYPES("p") USE_FEATURE_LS_FOLLOWLINKS("L") \ USE_FEATURE_LS_RECURSIVE("R") USE_FEATURE_LS_SORTFILES("rS") "s" \ USE_FEATURE_AUTOWIDTH("T") USE_FEATURE_LS_TIMESTAMPS("tu") \ @@ -1801,7 +1900,7 @@ USE_FEATURE_LS_FILETYPES( \ "\n -p Append indicator (one of /=@|) to entries") \ USE_FEATURE_LS_FOLLOWLINKS( \ - "\n -L List entries pointed to by symbolic links") \ + "\n -L List entries pointed to by symlinks") \ USE_FEATURE_LS_RECURSIVE( \ "\n -R List subdirectories recursively") \ USE_FEATURE_LS_SORTFILES( \ @@ -1827,7 +1926,9 @@ USE_SELINUX( \ "\n -k Print security context") \ USE_SELINUX( \ - "\n -K Print security context in long format") + "\n -K Print security context in long format") \ + USE_SELINUX( \ + "\n -Z Print security context and permission") #define lsattr_trivial_usage \ "[-Radlv] [files...]" @@ -1882,8 +1983,8 @@ " b Block special device file\n" \ " p Fifo (named pipe)\n" \ "uid is the user id for the target file, gid is the group id for the\n" \ - "target file. The rest of the entries (major, minor, etc) apply to\n" \ - "to device special files. A '-' may be used for blank entries." + "target file. The rest of the entries (major, minor, etc) apply to\n" \ + "to device special files. A '-' may be used for blank entries." #define makedevs_example_usage \ "For example:\n" \ " \n" \ @@ -1902,6 +2003,15 @@ "/dev/hda[0-15]\n" #endif +#define matchpathcon_trivial_usage \ + "[-n] [-N] [-f file_contexts_file] [-p prefix] [-V]" +#define matchpathcon_full_usage \ + " -n Do not display path" \ + "\n -N Do not use translations" \ + "\n -f Use alternate file_context file" \ + "\n -p Use prefix to speed translations" \ + "\n -V Verify file context on disk matches defaults" + #define md5sum_trivial_usage \ "[OPTION] [FILEs...]" \ USE_FEATURE_MD5_SHA1_SUM_CHECK("\n or: md5sum [OPTION] -c [FILE]") @@ -1938,15 +2048,15 @@ USE_FEATURE_MDEV_EXEC( \ "Optionally, that can be followed (on the same line) by a special character\n" \ "and a command line to run after creating/before deleting the corresponding\n" \ - "device(s). The environment variable $MDEV indicates the active device node\n" \ - "(which is useful if it's a regex match). For example:\n\n" \ + "device(s). The environment variable $MDEV indicates the active device node\n" \ + "(which is useful if it's a regex match). For example:\n\n" \ " hdc root:cdrom 660 *ln -s $MDEV cdrom\n\n" \ "The special characters are @ (run after creating), $ (run before deleting),\n" \ - "and * (run both after creating and before deleting). The commands run in\n" \ + "and * (run both after creating and before deleting). The commands run in\n" \ "the /dev directory, and use system() which calls /bin/sh.\n\n" \ ) \ - "Config file parsing stops on the first matching line. If no config\n"\ - "entry is matched, devices are created with default 0:0 660. (Make\n"\ + "Config file parsing stops on the first matching line. If no config\n"\ + "entry is matched, devices are created with default 0:0 660. (Make\n"\ "the last line match .* to override this.)\n\n" \ ) @@ -1963,7 +2073,11 @@ "Create the DIRECTORY(ies) if they do not already exist" \ "\n\nOptions:\n" \ " -m Set permission mode (as in chmod), not rwxrwxrwx - umask\n" \ - " -p No error if existing, make parent directories as needed" + " -p No error if existing, make parent directories as needed" \ + USE_SELINUX( \ + "\n -Z Set security context" \ + ) + #define mkdir_example_usage \ "$ mkdir /tmp/foo\n" \ "$ mkdir /tmp/foo\n" \ @@ -1997,18 +2111,21 @@ " -N num Number of inodes to create\n" \ " -o os Set the 'creator os' field\n" \ " -O features Dir_index/filetype/has_journal/journal_dev/sparse_super\n" \ - " -q Quiet execution\n" \ + " -q Quiet\n" \ " -r rev Set filesystem revision\n" \ " -S Write superblock and group descriptors only\n" \ " -T fs-type Set usage type (news/largefile/largefile4)\n" \ - " -v Verbose execution" + " -v Verbose" #define mkfifo_trivial_usage \ "[OPTIONS] name" #define mkfifo_full_usage \ "Create a named pipe (identical to 'mknod name p')" \ "\n\nOptions:\n" \ - " -m Create the pipe using the specified mode (default a=rw)" + " -m Create the pipe using the specified mode (default a=rw)" \ + USE_SELINUX( \ + "\n -Z Set security context" \ + ) #define mkfs_minix_trivial_usage \ "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]" @@ -2030,7 +2147,11 @@ "\n\nTYPEs include:\n" \ " b: Make a block (buffered) device\n" \ " c or u: Make a character (un-buffered) device\n" \ - " p: Make a named pipe. MAJOR and MINOR are ignored for named pipes" + " p: Make a named pipe. MAJOR and MINOR are ignored for named pipes" \ + USE_SELINUX( \ + "\n -Z Set security context" \ + ) + #define mknod_example_usage \ "$ mknod /dev/fd0 b 2 0\n" \ "$ mknod -m 644 /tmp/pipe p\n" @@ -2065,10 +2186,10 @@ "Options:\n" \ " -k Make module autoclean-able\n" \ " -n Just show what would be done\n" \ - " -q Quiet output\n" \ + " -q Quiet\n" \ " -r Remove module (stacks) or do autoclean\n" \ " -s Report via syslog instead of stderr\n" \ - " -v Verbose output" + " -v Verbose" #define modprobe_notes_usage \ "modprobe can (un)load a stack of modules, passing each module options (when\n" \ "loading). modprobe uses a configuration file to determine what option(s) to\n" \ @@ -2139,8 +2260,8 @@ #define mount_trivial_usage \ "[flags] DEVICE NODE [-o options,more-options]" #define mount_full_usage \ - "Mount a filesystem. Filesystem autodetection requires /proc be mounted." \ - "\n\nOptions:\n" \ + "Mount a filesystem. Filesystem autodetection requires /proc be mounted." \ + "\n\nOptions:\n" \ " -a Mount all filesystems in fstab\n" \ USE_FEATURE_MTAB_SUPPORT( \ " -f \"Fake\" Add entry to mount table but don't mount it\n" \ @@ -2189,8 +2310,8 @@ "[-q] <[-d] DIR | -x DEVICE>" #define mountpoint_full_usage \ "mountpoint checks if the directory is a mountpoint" \ - "\n\nOptions:\n" \ - " -q Be more quiet\n" \ + "\n\nOptions:\n" \ + " -q Quiet\n" \ " -d Print major/minor device number of the filesystem\n" \ " -x Print major/minor device number of the blockdevice" #define mountpoint_example_usage \ @@ -2233,6 +2354,8 @@ " or\n" \ "$ nameif -c /etc/my_mactab_file\n" \ +#if !ENABLE_DESKTOP + #if ENABLE_NC_SERVER || ENABLE_NC_EXTRA #define NC_OPTIONS_STR "\n\nOptions:" #else @@ -2249,7 +2372,7 @@ "\n -e Exec rest of command line after connect" \ "\n -i SECS Delay interval for lines sent" \ "\n -w SECS Timeout for connect" \ - "\n -f file Use file (ala /dev/ttyS0) instead of network" \ + "\n -f FILE Use file (ala /dev/ttyS0) instead of network" \ ) \ USE_NC_SERVER( \ "\n -l Listen mode, for inbound connects" \ @@ -2275,20 +2398,51 @@ "quit\n" \ "221 foobar closing connection\n" +#else /* DESKTOP nc - much more compatible with nc 1.10 */ + +#define nc_trivial_usage \ + "[-options] hostname port - connect" \ + USE_NC_SERVER("\nnc [-options] -l -p port [hostname] [port] - listen") +#define nc_full_usage \ + USE_NC_SERVER( \ + "-l Listen mode, for inbound connects\n" \ + ) \ + "-n Do not do DNS resolution" \ + "\n-s addr Local address" \ + "\n-p port Local port" \ + "\n-u UDP mode" \ + "\n-v Verbose (cumulative: -vv)" \ + "\n-w secs Timeout for connects and final net reads" \ + USE_NC_EXTRA( \ + "\n-i sec Delay interval for lines sent" /* ", ports scanned" */ \ + "\n-o file Hex dump of traffic" \ + "\n-z Zero-I/O mode (scanning)" \ + ) \ + "\n-e prog [args] Program to exec after connect (must be last)" \ +/* "\n-r Randomize local and remote ports" */ +/* "\n-g gateway Source-routing hop point[s], up to 8" */ +/* "\n-G num Source-routing pointer: 4, 8, 12, ..." */ +/* "\nport numbers can be individual or ranges: lo-hi [inclusive]" */ + +#endif + #define netstat_trivial_usage \ - "[-laenrtuwx]" + "[-laentuwxr"USE_FEATURE_NETSTAT_WIDE("W")"]" #define netstat_full_usage \ "Display networking information" \ - "\n\nOptions:\n" \ - " -l Display listening server sockets\n" \ - " -a Display all sockets (default: connected)\n" \ - " -e Display other/more information\n" \ - " -n Don't resolve names\n" \ - " -r Display routing table\n" \ - " -t Tcp sockets\n" \ - " -u Udp sockets\n" \ - " -w Raw sockets\n" \ - " -x Unix sockets" + "\n\nOptions:" \ + "\n -l Display listening server sockets" \ + "\n -a Display all sockets (default: connected)" \ + "\n -e Display other/more information" \ + "\n -n Don't resolve names" \ + "\n -t Tcp sockets" \ + "\n -u Udp sockets" \ + "\n -w Raw sockets" \ + "\n -x Unix sockets" \ + "\n -r Display routing table" \ + USE_FEATURE_NETSTAT_WIDE( \ + "\n -W Display with no column truncation" \ + ) #define nice_trivial_usage \ "[-n ADJUST] [COMMAND [ARG] ...]" @@ -2345,10 +2499,10 @@ "[-aBbcDdeFfHhIiLlOovXx] [FILE]" #define od_full_usage \ "Write an unambiguous representation, octal bytes by default, of FILE\n" \ - "to standard output. With no FILE, or when FILE is -, read standard input." + "to standard output. With no FILE, or when FILE is -, read standard input." #define openvt_trivial_usage \ - " [ARGS...]" + "VTNUM COMMAND [ARGS...]" #define openvt_full_usage \ "Start a command on a new virtual terminal" #define openvt_example_usage \ @@ -2366,8 +2520,17 @@ " -l Locks (disables) the specified user account\n" \ " -u Unlocks (re-enables) the specified user account" +#define chpasswd_trivial_usage \ + "[--md5|--encrypt]" +#define chpasswd_full_usage \ + "Read user:password information from stdin\n" \ + "and update /etc/passwd accordingly." \ + "\n\nOptions:" \ + "\n -e, --encrypt Supplied passwords are in encrypted form" \ + "\n -m, --md5 Use MD5 encryption instead of DES" + #define patch_trivial_usage \ - "[-p] [-i ]" + "[-p num] [-i diff]" #define patch_full_usage \ " -p NUM Strip NUM leading components from file names\n" \ " -i DIFF Read DIFF instead of stdin" @@ -2391,7 +2554,7 @@ USE_FEATURE_PIDOF_SINGLE( \ "\n -s Display only a single PID") \ USE_FEATURE_PIDOF_OMIT( \ - "\n -o Omit given pid") \ + "\n -o PID Omit given pid") \ USE_FEATURE_PIDOF_OMIT( \ "\n Use %PPID to omit the parent pid of pidof itself") #define pidof_example_usage \ @@ -2407,17 +2570,32 @@ "host" #define ping_full_usage \ "Send ICMP ECHO_REQUEST packets to network hosts" +#define ping6_trivial_usage \ + "host" +#define ping6_full_usage \ + "Send ICMP ECHO_REQUEST packets to network hosts" #else #define ping_trivial_usage \ "[OPTION]... host" #define ping_full_usage \ "Send ICMP ECHO_REQUEST packets to network hosts" \ "\n\nOptions:\n" \ - " -c CNT Send only CNT pings\n" \ - " -s SIZE Send SIZE data bytes in packets (default=56)\n" \ - " -I IP Use IP as source address\n" \ - " -q Quiet mode, only displays output at start\n" \ - " and when finished" + " -4, -6 Force IPv4 or IPv6 hostname resolution\n" \ + " -c CNT Send only CNT pings\n" \ + " -s SIZE Send SIZE data bytes in packets (default=56)\n" \ + " -I iface/IP Use interface or IP address as source\n" \ + " -q Quiet, only displays output at start\n" \ + " and when finished" +#define ping6_trivial_usage \ + "[OPTION]... host" +#define ping6_full_usage \ + "Send ICMP ECHO_REQUEST packets to network hosts" \ + "\n\nOptions:\n" \ + " -c CNT Send only CNT pings\n" \ + " -s SIZE Send SIZE data bytes in packets (default=56)\n" \ + " -I iface/IP Use interface or IP address as source\n" \ + " -q Quiet, only displays output at start\n" \ + " and when finished" #endif #define ping_example_usage \ "$ ping localhost\n" \ @@ -2427,23 +2605,6 @@ "--- debian ping statistics ---\n" \ "1 packets transmitted, 1 packets received, 0% packet loss\n" \ "round-trip min/avg/max = 20.1/20.1/20.1 ms\n" - -#ifndef CONFIG_FEATURE_FANCY_PING6 -#define ping6_trivial_usage \ - "host" -#define ping6_full_usage \ - "Send ICMP ECHO_REQUEST packets to network hosts" -#else -#define ping6_trivial_usage \ - "[OPTION]... host" -#define ping6_full_usage \ - "Send ICMP ECHO_REQUEST packets to network hosts" \ - "\n\nOptions:\n" \ - " -c CNT Send only CNT pings\n" \ - " -s SIZE Send SIZE data bytes in packets (default=56)\n" \ - " -q Quiet mode, only displays output at start\n" \ - " and when finished" -#endif #define ping6_example_usage \ "$ ping6 ip6-localhost\n" \ "PING ip6-localhost (::1): 56 data bytes\n" \ @@ -2460,7 +2621,7 @@ "the new root file system" #define poweroff_trivial_usage \ - "[-d] [-n] [-f]" + "[-d delay] [-n] [-f]" #define poweroff_full_usage \ "Halt and shut off power" \ "\n\nOptions:\n" \ @@ -2507,7 +2668,7 @@ "Report process status\n" \ USAGE_PS \ USE_SELINUX( \ - "\n -c Show SE Linux context") \ + "\n -Z Show SE Linux context") \ USE_FEATURE_PS_WIDE( \ "\n w Wide output") @@ -2526,6 +2687,15 @@ " 745 root root S [getty]\n" \ " 2990 andersen andersen R ps\n" +#define pscan_trivial_usage \ + "[-p MIN_PORT] [-P MAX_PORT] [-t TIMEOUT] [-T MIN_RTT] HOST" +#define pscan_full_usage \ + "Scan a host, print all open ports" \ + "\n\nOptions:" \ + "\n -p Scan from this port (default 1)" \ + "\n -P Scan up to this port (default 1024)" \ + "\n -t Timeout (default 5000 ms)" \ + "\n -T Minimum rtt (default 5 ms, increase for congested hosts)" \ #define pwd_trivial_usage \ "" @@ -2559,7 +2729,7 @@ #define readlink_trivial_usage \ USE_FEATURE_READLINK_FOLLOW("[-f] ") "FILE" #define readlink_full_usage \ - "Display the value of a symbolic link" \ + "Display the value of a symlink" \ USE_FEATURE_READLINK_FOLLOW( \ "\n\nOptions:\n" \ " -f Canonicalize by following all symlinks") @@ -2568,11 +2738,11 @@ "[OPTIONS]..." #define readprofile_full_usage \ "Options:\n" \ - " -m (Default: /boot/System.map)\n" \ - " -p (Default: /proc/profile)\n" \ - " -M Set the profiling multiplier to \n" \ + " -m mapfile (Default: /boot/System.map)\n" \ + " -p profile (Default: /proc/profile)\n" \ + " -M mult Set the profiling multiplier to mult\n" \ " -i Print only info about the sampling step\n" \ - " -v Print verbose data\n" \ + " -v Verbose\n" \ " -a Print all symbols, even if count is 0\n" \ " -b Print individual histogram-bin counts\n" \ " -s Print individual counters within functions\n" \ @@ -2580,12 +2750,12 @@ " -n Disable byte order auto-detection" #define realpath_trivial_usage \ - "pathname ..." + "pathname ..." #define realpath_full_usage \ "Return the absolute pathnames of given argument" #define reboot_trivial_usage \ - "[-d] [-n] [-f]" + "[-d delay] [-n] [-f]" #define reboot_full_usage \ "Reboot the system" \ "\n\nOptions:\n" \ @@ -2594,7 +2764,7 @@ " -f Force reboot (don't go through init)" #define renice_trivial_usage \ - "{{-n INCREMENT} | PRIORITY} [[ -p | -g | -u ] ID ...]" + "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID ...]" #define renice_full_usage \ "Change priority of running processes" \ "\n\nOptions:\n" \ @@ -2613,10 +2783,26 @@ #define resize_full_usage \ "Resize the screen" +#define restorecon_trivial_usage \ + "[-iFnrRv] [-e excludedir]... [-o filename] [-f filename | pathname]" +#define restorecon_full_usage \ + "Reset security contexts of files in pathname\n" \ + "\n -i Ignore files that do not exist" \ + "\n -f filename File with list of files to process. Use - for stdin" \ + "\n -e directory Directory to exclude" \ + "\n -R,-r Recurse directories" \ + "\n -n Don't change any file labels" \ + "\n -o filename Save list of files with incorrect context" \ + "\n -v Verbose" \ + "\n -vv Show changed labels" \ + "\n -F Force reset of context to match file_context" \ + "\n for customizable files, or the user section," \ + "\n if it has changed" + #define rm_trivial_usage \ "[OPTION]... FILE..." #define rm_full_usage \ - "Remove (unlink) the FILE(s). You may use '--' to\n" \ + "Remove (unlink) the FILE(s). You may use '--' to\n" \ "indicate that all following arguments are non-options." \ "\n\nOptions:\n" \ " -i Always prompt before removing each destination\n" \ @@ -2668,14 +2854,43 @@ #define rpm2cpio_full_usage \ "Output a cpio archive of the rpm file" +#define runcon_trivial_usage \ + "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \ + " runcon CONTEXT COMMAND [args]" +#define runcon_full_usage \ + "runcon [-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \ + "runcon CONTEXT COMMAND [args]\n" \ + "Run a program in a different security context\n\n" \ + " CONTEXT Complete security context\n" \ + " -c, --compute Compute process transition context before modifying\n" \ + " -t, --type=TYPE Type (for same role as parent)\n" \ + " -u, --user=USER User identity\n" \ + " -r, --role=ROLE Role\n" \ + " -l, --range=RNG Levelrange" \ + #define run_parts_trivial_usage \ - "[-t] [-a ARG] [-u MASK] DIRECTORY" + "[-t] "USE_FEATURE_RUN_PARTS_FANCY("[-l] ")"[-a ARG] [-u MASK] DIRECTORY" #define run_parts_full_usage \ "Run a bunch of scripts in a directory" \ "\n\nOptions:\n" \ " -t Prints what would be run, but does not actually run anything\n" \ " -a ARG Pass ARG as an argument for every program invoked\n" \ - " -u MASK Set the umask to MASK before executing every program" + " -u MASK Set the umask to MASK before executing every program" \ +USE_FEATURE_RUN_PARTS_FANCY("\n -l Prints names of all matching files even when they are not executable") + +#define run_parts_example_usage \ + "$ run-parts -a start /etc/init.d\n" \ + "$ run-parts -a stop=now /etc/init.d\n\n" \ + "Let's assume you have a script foo/dosomething:\n" \ + "#!/bin/sh\n" \ + "for i in $*; do eval $i; done; unset i\n" \ + "case \"$1\" in\n" \ + "start*) echo starting something;;\n" \ + "stop*) set -x; shutdown -h $stop;;\n" \ + "esac\n\n" \ + "Running this yields:\n" \ + "$run-parts -a stop=+4m foo/\n" \ + "+ shutdown -h +4m" #define runlevel_trivial_usage \ "[utmp]" @@ -2717,13 +2932,16 @@ "\n" \ "If no -e or -f is given, the first non-option argument is taken as the sed\n" \ "script to interpret. All remaining arguments are names of input files; if no\n" \ - "input files are specified, then the standard input is read. Source files\n" \ + "input files are specified, then the standard input is read. Source files\n" \ "will not be modified unless -i option is given." #define sed_example_usage \ "$ echo \"foo\" | sed -e 's/f[a-zA-Z]o/bar/g'\n" \ "bar\n" +#define selinuxenabled_trivial_usage +#define selinuxenabled_full_usage + #define seq_trivial_usage \ "[first [increment]] last" #define seq_full_usage \ @@ -2741,6 +2959,35 @@ "\n\nOptions:\n" \ " -r Reset output to /dev/console" +#define setenforce_trivial_usage \ + "[Enforcing | Permissive | 1 | 0]" +#define setenforce_full_usage + +#define setfiles_trivial_usage \ + "[-dnpqsvW] [-e dir]... [-o filename] [-r alt_root_path]" \ + USE_FEATURE_SETFILES_CHECK_OPTION( \ + " [-c policyfile] spec_file" \ + ) \ + " pathname" + +#define setfiles_full_usage \ + "Reset file contexts under pathname according to spec_file" \ + USE_FEATURE_SETFILES_CHECK_OPTION( \ + "\n -c file Check the validity of the contexts against the specified binary policy" \ + ) \ + "\n -d Show which specification matched each file" \ + "\n -l Log changes in file labels to syslog" \ + "\n -n Don't change any file labels" \ + "\n -q Suppress warnings" \ + "\n -r dir Use an altenate root path" \ + "\n -e dir Exclude directory" \ + "\n -F Force reset of context to match file_context for customizable files" \ + "\n -o file Save list of files with incorrect context" \ + "\n -s Take a list of files from standard input (instead of command line)" \ + "\n -v Show changes in file labels, if type or role are changing" \ + "\n -vv Show changes in file labels, if type, role, or user are changing" \ + "\n -W Display warnings about entries that had no matching files" + #define setkeycodes_trivial_usage \ "SCANCODE KEYCODE ..." #define setkeycodes_full_usage \ @@ -2760,7 +3007,7 @@ "program [arg ...]" #define setsid_full_usage \ "Run any program in a new session by calling setsid() before\n" \ - "exec'ing the rest of its arguments. See setsid(2) for details." + "exec'ing the rest of its arguments. See setsid(2) for details." #define lash_trivial_usage \ "[FILE]...\n" \ @@ -2769,11 +3016,11 @@ "The BusyBox LAme SHell (command interpreter)" #define lash_notes_usage \ "This command does not yet have proper documentation.\n\n" \ - "Use lash just as you would use any other shell. It properly handles pipes,\n" \ + "Use lash just as you would use any other shell. It properly handles pipes,\n" \ "redirects, job control, can be used as the shell for scripts, and has a\n" \ - "sufficient set of builtins to do what is needed. It does not (yet) support\n" \ - "Bourne Shell syntax. If you need things like \"if-then-else\", \"while\", and such\n" \ - "use ash or bash. If you just need a very simple and extremely small shell,\n" \ + "sufficient set of builtins to do what is needed. It does not (yet) support\n" \ + "Bourne Shell syntax. If you need things like \"if-then-else\", \"while\", and such\n" \ + "use ash or bash. If you just need a very simple and extremely small shell,\n" \ "this will do the job." #define last_trivial_usage \ @@ -2794,6 +3041,20 @@ " -s Don't output anything, status code shows success\n" \ " -w Warn about improperly formatted SHA1 checksum lines") +#define slattach_trivial_usage \ + "[-cehmLF] [-s speed] [-p protocol] DEVICEs" +#define slattach_full_usage \ + "Attach network interface(s) to serial line(s)\n" \ + "\nOptions:" \ + "\n -p Set protocol (slip, cslip, slip6, clisp6 or adaptive)" \ + "\n -s Set line speed" \ + "\n -e Exit after initializing device" \ + "\n -h Exit when the carrier is lost" \ + "\n -c Execute a command when the line is hung up" \ + "\n -m Do NOT initialize the line in raw 8 bits mode" \ + "\n -L Enable 3-wire operation" \ + "\n -F Disable RTS/CTS flow control" \ + #define sleep_trivial_usage \ USE_FEATURE_FANCY_SLEEP("[") "N" USE_FEATURE_FANCY_SLEEP("]...") #define sleep_full_usage \ @@ -2854,6 +3115,17 @@ ) \ "" +#define split_trivial_usage \ + "[OPTION] [INPUT [PREFIX]]" +#define split_full_usage \ + "Options:" \ + "\n -b n[k|m] Split by bytes" \ + "\n -l n Split by lines" \ + "\n -a n Use n letters as suffix" +#define split_example_usage \ + "$ split TODO foo\n" \ + "$ cat TODO | split -a 2 -l 2 TODO_\n" + #define start_stop_daemon_trivial_usage \ "[OPTIONS] [--start|--stop] ... [-- arguments...]" #define start_stop_daemon_full_usage \ @@ -2861,21 +3133,21 @@ "\n\nOptions:" \ "\n -S|--start Start" \ "\n -K|--stop Stop" \ - "\n -a|--startas Starts process specified by pathname" \ + "\n -a|--startas pathname Starts process specified by pathname" \ "\n -b|--background Force process into background" \ - "\n -u|--user | Stop this user's processes" \ - "\n -x|--exec Program to either start or check" \ + "\n -u|--user username|uid Stop this user's processes" \ + "\n -x|--exec executable Program to either start or check" \ "\n -m|--make-pidfile Create the -p file and enter pid in it" \ - "\n -n|--name Stop processes with this name" \ - "\n -p|--pidfile Save or load pid using a pid-file" \ - "\n -q|--quiet Be quiet" \ + "\n -n|--name process-name Stop processes with this name" \ + "\n -p|--pidfile pid-file Save or load pid using a pid-file" \ + "\n -q|--quiet Quiet" \ USE_FEATURE_START_STOP_DAEMON_FANCY( \ "\n -o|--oknodo Exit status 0 if nothing done" \ - "\n -v|--verbose Be verbose" \ - "\n -N|--nicelevel Add N to process's nice level" \ + "\n -v|--verbose Verbose" \ + "\n -N|--nicelevel N Add N to process's nice level" \ ) \ - "\n -s|--signal Signal to send (default TERM)" \ - "\n -U|--chuid | Start process with this name" + "\n -s|--signal signal Signal to send (default TERM)" \ + "\n -c|--chuid user[:[group]] Change to specified user/group" #define stat_trivial_usage \ "[OPTION] FILE..." @@ -2887,6 +3159,9 @@ " -f Display filesystem status\n" \ " -L,-l Dereference links\n" \ " -t Display info in terse form" \ + USE_SELINUX( \ + "\n -Z Print security context" \ + ) \ USE_FEATURE_STAT_FORMAT( \ "\n\nValid format sequences for files:\n" \ " %a Access rights in octal\n" \ @@ -2902,7 +3177,7 @@ " %h Number of hard links\n" \ " %i Inode number\n" \ " %n File name\n" \ - " %N Quoted file name with dereference if symbolic link\n" \ + " %N Quoted file name with dereference if symlink\n" \ " %o I/O block size\n" \ " %s Total size, in bytes\n" \ " %t Major device type in hex\n" \ @@ -2921,17 +3196,20 @@ " %c Total file nodes in file system\n" \ " %d Free file nodes in file system\n" \ " %f Free blocks in file system\n" \ + USE_SELINUX( \ + " %C Security context in SELinux\n" \ + ) \ " %i File System ID in hex\n" \ " %l Maximum length of filenames\n" \ " %n File name\n" \ - " %s Block size (for faster transfers)\n" \ + " %s Block size (for faster transfer)\n" \ " %S Fundamental block size (for block counts)\n" \ " %t Type in hex\n" \ " %T Type in human readable form" \ ) #define strings_trivial_usage \ - "[-afo] [-n length] [file ... ]" + "[-afo] [-n length] [file ...]" #define strings_full_usage \ "Display printable strings in a binary file" \ "\n\nOptions:" \ @@ -3029,7 +3307,7 @@ "sysctl [-n] variable ...\n" \ "sysctl [-n] -w variable=value ...\n" \ "sysctl [-n] -a\n" \ - "sysctl [-n] -p (default /etc/sysctl.conf)\n" \ + "sysctl [-n] -p file (default /etc/sysctl.conf)\n" \ "sysctl [-n] -A\n" #define syslogd_trivial_usage \ @@ -3038,7 +3316,6 @@ "System logging utility.\n" \ "Note that this version of syslogd ignores /etc/syslog.conf." \ "\n\nOptions:" \ - "\n -m MIN Minutes between MARK lines (default=20, 0=off)" \ "\n -n Run as foreground process" \ "\n -O FILE Use an alternate log file (default=/var/log/messages)" \ "\n -l n Sets the local log level of messages to n" \ @@ -3052,6 +3329,7 @@ USE_FEATURE_IPC_SYSLOG( \ "\n -C[size(KiB)] Log to a shared mem buffer (read the buffer using logread)") /* NB: -Csize shouldn't have space (because size is optional) */ +/* "\n -m MIN Minutes between MARK lines (default=20, 0=off)" */ #define syslogd_example_usage \ "$ syslogd -R masterlog:514\n" \ "$ syslogd -R 192.168.1.1:601\n" @@ -3108,7 +3386,7 @@ " exclude File to exclude\n" \ " X File with names to exclude\n") \ " C Change to directory DIR before operation\n" \ - " v Verbosely list files processed" + " v Verbose" #define tar_example_usage \ "$ zcat /tmp/tarball.tar.gz | tar -xf -\n" \ "$ tar -cf /tmp/tarball.tar /usr/local\n" @@ -3152,7 +3430,7 @@ " -l USER Attempt an automatic login with the USER argument\n" \ " HOST The official name, alias or the IP address of the\n" \ " remote host\n" \ - " PORT The remote port number to connect to. If it is not\n" \ + " PORT The remote port number to connect to. If it is not\n" \ " specified, the default telnet (23) port is used." #else #define telnet_trivial_usage \ @@ -3195,6 +3473,45 @@ "$ echo $?\n" \ "1\n" +#define tcpsvd_trivial_usage \ + "[-hEv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] ip port prog..." +/* with not-implemented options: */ +/* "[-hpEvv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] [-i dir|-x cdb] [-t sec] ip port prog..." */ +#define tcpsvd_full_usage \ + "Creates TCP socket, binds it to ip:port and listens on it\n" \ + "for incoming connections. For each connection it runs prog." \ + "\n" \ + "\nip IP to listen on. '0' = all" \ + "\nport Port to listen on" \ + "\nprog [arg] Program to run" \ + "\n-l name Local hostname (else looks up local hostname in DNS)" \ + "\n-u user[:group] Change to user/group after bind" \ + "\n-c n Handle up to n connections simultaneously" \ + "\n-b n Allow a backlog of approximately n TCP SYNs" \ + "\n-C n[:msg] Allow only up to n connections from the same IP" \ + "\n New connections from this IP address are closed" \ + "\n immediately. 'msg' is written to the peer before close" \ + "\n-h Look up peer's hostname" \ + "\n-E Do not set up environment variables" \ + "\n-v Verbose" + +#define udpsvd_trivial_usage \ + "[-hEv] [-c n] [-u user] [-l name] ip port prog" +#define udpsvd_full_usage \ + "Creates UDP socket, binds it to ip:port and listens on it\n" \ + "for incoming packets. For each packet it runs prog\n" \ + "(redirecting all further packets with same peer ip:port to it)." \ + "\n" \ + "\nip IP to listen on. '0' = all" \ + "\nport Port to listen on" \ + "\nprog [arg] Program to run" \ + "\n-l name Local hostname (else looks up local hostname in DNS)" \ + "\n-u user[:group] Change to user/group after bind" \ + "\n-c n Handle up to n connections simultaneously" \ + "\n-h Look up peer's hostname" \ + "\n-E Do not set up environment variables" \ + "\n-v Verbose" + #define tftp_trivial_usage \ "[OPTION]... HOST [PORT]" #define tftp_full_usage \ @@ -3214,10 +3531,10 @@ #define time_trivial_usage \ "[OPTION]... COMMAND [ARGS...]" #define time_full_usage \ - "Run the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \ + "Run the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \ "COMMAND's resource usage information is displayed." \ "\n\nOptions:\n" \ - " -v Display verbose resource usage information" + " -v Verbose" #define top_trivial_usage \ "[-b] [-n count] [-d seconds]" @@ -3265,18 +3582,16 @@ " -d Set SO_DEBUG options to socket\n" \ " -n Print hop addresses numerically rather than symbolically\n" \ " -r Bypass the normal routing tables and send directly to a host\n" \ - " -v Verbose output\n" \ - " -m max_ttl Set the max time-to-live (max number of hops)\n" \ - " -p port# Set the base UDP port number used in probes\n" \ + " -v Verbose\n" \ + " -m max_ttl Max time-to-live (max number of hops)\n" \ + " -p port# Base UDP port number used in probes\n" \ " (default is 33434)\n" \ - " -q nqueries Set the number of probes per 'ttl' to nqueries\n" \ - " (default is 3)\n" \ - " -s src_addr Use the following IP address as the source address\n" \ - " -t tos Set the type-of-service in probe packets to the following value\n" \ - " (default 0)\n" \ - " -w wait Set the time (in seconds) to wait for a response to a probe\n" \ + " -q nqueries Number of probes per 'ttl' (default 3)\n" \ + " -s src_addr IP address to use as the source address\n" \ + " -t tos Type-of-service in probe packets (default 0)\n" \ + " -w wait Time in seconds to wait for a response to a probe\n" \ " (default 3 sec)\n" \ - " -g Specify a loose source route gateway (8 maximum)" + " -g Specify a loose source route gateway (8 max)" #define true_trivial_usage \ @@ -3292,8 +3607,9 @@ "" #define tty_full_usage \ "Print the file name of the terminal connected to standard input" \ + USE_INCLUDE_SUSv2( \ "\n\nOptions:\n" \ - " -s Print nothing, only return an exit status" + " -s Print nothing, only return an exit status") #define tty_example_usage \ "$ tty\n" \ "/dev/tty2\n" @@ -3309,7 +3625,8 @@ "Adjust filesystem options on ext[23] filesystems" #define udhcpc_trivial_usage \ - "[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n[-p pidfile] [-r IP] [-s script]" + "[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n" \ + " [-p pidfile] [-r IP] [-s script]" #define udhcpc_full_usage \ " -V,--vendorclass=CLASSID Set vendor class identifier\n" \ " -i,--interface=INTERFACE Interface to use (default: eth0)\n" \ @@ -3328,7 +3645,7 @@ " -v,--version Display version" \ #define udhcpd_trivial_usage \ - "[configfile]\n" \ + "[configfile]" \ #define udhcpd_full_usage \ "" @@ -3338,7 +3655,8 @@ #define umount_full_usage \ "Unmount file systems" \ "\n\nOptions:\n" \ - "\n -a Unmount all file systems" USE_FEATURE_MTAB_SUPPORT(" in /etc/mtab") \ + USE_FEATURE_UMOUNT_ALL( \ + "\n -a Unmount all file systems" USE_FEATURE_MTAB_SUPPORT(" in /etc/mtab")) \ USE_FEATURE_MTAB_SUPPORT( \ "\n -n Don't erase /etc/mtab entries") \ "\n -r Try to remount devices as read-only if mount is busy" \ @@ -3352,7 +3670,7 @@ #define uname_trivial_usage \ "[OPTION]..." #define uname_full_usage \ - "Print certain system information. With no OPTION, same as -s." \ + "Print certain system information. With no OPTION, same as -s." \ "\n\nOptions:\n" \ " -a Print all information\n" \ " -m The machine (hardware) type\n" \ @@ -3366,7 +3684,7 @@ "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n" #define uncompress_trivial_usage \ - "[-c] [-f] [ name ... ]" + "[-c] [-f] [name...]" #define uncompress_full_usage \ "Uncompress .Z file[s]" \ "\n\nOptions:\n" \ @@ -3393,9 +3711,9 @@ #define unix2dos_trivial_usage \ "[option] [FILE]" #define unix2dos_full_usage \ - "Convert FILE from unix format to dos format. When no option\n" \ + "Convert FILE from unix format to dos format. When no option\n" \ "is given, the input is converted to the opposite output format.\n" \ - "When no file is given, use stdin for input and stdout for output." \ + "When no file is given, use stdin/stdout." \ "\n\nOptions:\n" \ " -u Output will be in UNIX format\n" \ " -d Output will be in DOS format" @@ -3409,7 +3727,7 @@ " -n Never overwrite existing files (default)\n" \ " -o Overwrite files without prompting\n" \ " -p Send output to stdout\n" \ - " -q Be quiet\n" \ + " -q Quiet\n" \ " -x Exclude these files\n" \ " -d Extract files into this directory" @@ -3430,20 +3748,19 @@ "[pauses for 1 second]\n" #define uudecode_trivial_usage \ - "[FILE]..." + "[-o outfile] [infile]" #define uudecode_full_usage \ - "Uudecode a file" \ - "\n\nOptions:\n" \ - " -o FILE Direct output to FILE" + "Uudecode a file\n" \ + "NB: finds outfile name in uuencoded source unless -o is given" #define uudecode_example_usage \ "$ uudecode -o busybox busybox.uu\n" \ "$ ls -l busybox\n" \ "-rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox\n" #define uuencode_trivial_usage \ - "[OPTION] [INFILE] REMOTEFILE" + "[-m] [infile] stored_filename" #define uuencode_full_usage \ - "Uuencode a file" \ + "Uuencode a file to stdout" \ "\n\nOptions:\n" \ " -m Use base64 encoding per RFC1521" #define uuencode_example_usage \ @@ -3458,12 +3775,12 @@ #define vconfig_full_usage \ "Create and remove virtual ethernet devices" \ "\n\nOptions:\n" \ - " add [interface-name] [vlan_id]\n" \ - " rem [vlan-name]\n" \ - " set_flag [interface-name] [flag-num] [0 | 1]\n" \ - " set_egress_map [vlan-name] [skb_priority] [vlan_qos]\n" \ - " set_ingress_map [vlan-name] [skb_priority] [vlan_qos]\n" \ - " set_name_type [name-type]" + " add [interface-name] [vlan_id]\n" \ + " rem [vlan-name]\n" \ + " set_flag [interface-name] [flag-num] [0 | 1]\n" \ + " set_egress_map [vlan-name] [skb_priority] [vlan_qos]\n" \ + " set_ingress_map [vlan-name] [skb_priority] [vlan_qos]\n" \ + " set_name_type [name-type]" #define vi_trivial_usage \ "[OPTION] [FILE]..." @@ -3475,12 +3792,12 @@ #define vlock_trivial_usage \ "[OPTIONS]" #define vlock_full_usage \ - "Lock a virtual terminal. A password is required to unlock." \ + "Lock a virtual terminal. A password is required to unlock." \ "\n\nOptions:\n" \ " -a Lock all VTs" #define watch_trivial_usage \ - "[-n ] [-t] COMMAND..." + "[-n seconds] [-t] COMMAND..." #define watch_full_usage \ "Execute a program periodically" \ "\n\nOptions:\n" \ @@ -3493,7 +3810,7 @@ "Mon Dec 17 10:31:44 GMT 2000" #define watchdog_trivial_usage \ - "[-t ] [-F] DEV" + "[-t seconds] [-F] DEV" #define watchdog_full_usage \ "Periodically write to watchdog device DEV" \ "\n\nOptions:\n" \ @@ -3504,7 +3821,7 @@ "[OPTION]... [FILE]..." #define wc_full_usage \ "Print 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." \ + "more than one FILE is specified. With no FILE, read standard input." \ "\n\nOptions:\n" \ " -c Print the byte counts\n" \ " -l Print the newline counts\n" \ @@ -3515,14 +3832,15 @@ " 31 46 1365 /etc/passwd\n" #define wget_trivial_usage \ - "[-c|--continue] [-q|--quiet] [-O|--output-document file]\n" \ + "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document file]\n" \ " [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \ " [-U|--user-agent agent] url" #define wget_full_usage \ "Retrieve files via HTTP or FTP" \ "\n\nOptions:\n" \ - " -c Continue retrieval of aborted transfers\n" \ - " -q Quiet mode - do not print\n" \ + " -s Spider mode - only check file existence\n" \ + " -c Continue retrieval of aborted transfer\n" \ + " -q Quiet\n" \ " -P Set directory prefix to DIR\n" \ " -O Save to filename ('-' for stdout)\n" \ " -U Adjust 'User-Agent' field\n" \ @@ -3578,9 +3896,9 @@ #define zcip_full_usage \ "Manage a ZeroConf IPv4 link-local address" \ "\n\nOptions:\n" \ - " -f foreground mode\n" \ - " -q quit after address (no daemon)\n" \ - " -r 169.254.x.x request this address first\n" \ - " -v verbose" + " -f Foreground mode\n" \ + " -q Quit after address (no daemon)\n" \ + " -r 169.254.x.x Request this address first\n" \ + " -v Verbose" #endif /* __BB_USAGE_H__ */