#define acpid_trivial_usage \
"[-d] [-c CONFDIR] [-l LOGFILE] [-e PROC_EVENT_FILE] [EVDEV_EVENT_FILE...]"
-
#define acpid_full_usage "\n\n" \
"Listen to ACPI events and spawn specific helpers on event arrival\n" \
"\nOptions:" \
- "\n -d Do not daemonize and log to stderr" \
+ "\n -d Don't daemonize, log to stderr" \
"\n -c DIR Config directory [/etc/acpi]" \
"\n -e FILE /proc event file [/proc/acpi/event]" \
"\n -l FILE Log file [/var/log/acpid]" \
"\n -h DIR Home directory" \
"\n -g GECOS GECOS field" \
"\n -s SHELL Login shell" \
- "\n -G GROUP Add user to existing group" \
+ "\n -G GRP Add user to existing group" \
"\n -S Create a system user" \
- "\n -D Do not assign a password" \
- "\n -H Do not create home directory" \
+ "\n -D Don't assign a password" \
+ "\n -H Don't create home directory" \
"\n -u UID User id" \
#define adjtimex_trivial_usage \
#define ash_full_usage ""
#define hush_trivial_usage NOUSAGE_STR
#define hush_full_usage ""
+#define lash_trivial_usage NOUSAGE_STR
+#define lash_full_usage ""
#define msh_trivial_usage NOUSAGE_STR
#define msh_full_usage ""
#define awk_trivial_usage \
- "[OPTION]... [program-text] [FILE...]"
+ "[OPTIONS] [AWK_PROGRAM] [FILE]..."
#define awk_full_usage "\n\n" \
"Options:" \
- "\n -v var=val Set variable" \
- "\n -F sep Use sep as field separator" \
- "\n -f file Read program from file" \
+ "\n -v VAR=VAL Set variable" \
+ "\n -F SEP Use SEP as field separator" \
+ "\n -f FILE Read program from file" \
#define basename_trivial_usage \
"FILE [SUFFIX]"
#define basename_full_usage "\n\n" \
- "Strip directory path and suffixes from FILE.\n" \
- "If specified, also remove any trailing SUFFIX."
+ "Strip directory path and .SUFFIX from FILE\n"
#define basename_example_usage \
"$ basename /usr/local/bin/foo\n" \
"foo\n" \
"$ basename /foo/bar.txt .txt\n" \
"bar"
+#define beep_trivial_usage \
+ "-f freq -l length -d delay -r repetitions -n"
+#define beep_full_usage "\n\n" \
+ "Options:" \
+ "\n -f Frequency in Hz" \
+ "\n -l Length in ms" \
+ "\n -d Delay in ms" \
+ "\n -r Repetitions" \
+ "\n -n Start new tone" \
+
#define fbsplash_trivial_usage \
"-s IMGFILE [-c] [-d DEV] [-i INIFILE] [-f CMD]"
#define fbsplash_full_usage "\n\n" \
- "Options:\n" \
+ "Options:" \
"\n -s Image" \
"\n -c Hide cursor" \
"\n -d Framebuffer device (default /dev/fb0)" \
#define brctl_trivial_usage \
"COMMAND [BRIDGE [INTERFACE]]"
#define brctl_full_usage "\n\n" \
- "Manage ethernet bridges.\n" \
+ "Manage ethernet bridges\n" \
"\nCommands:" \
IF_FEATURE_BRCTL_SHOW( \
"\n show Show a list of bridges" \
) \
#define bunzip2_trivial_usage \
- "[OPTION]... [FILE]"
+ "[OPTIONS] [FILE]"
#define bunzip2_full_usage "\n\n" \
- "Uncompress FILE (or standard input if FILE is '-' or omitted)\n" \
+ "Uncompress FILE (or standard input)\n" \
"\nOptions:" \
"\n -c Write to standard output" \
"\n -f Force" \
#define bzip2_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define bzip2_full_usage "\n\n" \
- "Compress FILE(s) with bzip2 algorithm.\n" \
- "When FILE is '-' or unspecified, reads standard input. Implies -c.\n" \
+ "Compress FILEs (or standard input) with bzip2 algorithm.\n" \
"\nOptions:" \
"\n -c Write to standard output" \
"\n -d Decompress" \
"Hello world!\n"
#define lzop_trivial_usage \
- "[-cfvd123456789CF] [file..]"
+ "[-cfvd123456789CF] [FILE]..."
#define lzop_full_usage "\n\n" \
" -c Write to standard output" \
"\n -f Force" \
"\n -1..9 Compression level" \
#define lzopcat_trivial_usage \
- "[-vCF] [file..]"
+ "[-vCF] [FILE]..."
#define lzopcat_full_usage "\n\n" \
" -v Verbose" \
"\n -F Don't store or verify checksum" \
#define unlzop_trivial_usage \
- "[-cfvCF] [file..]"
+ "[-cfvCF] [FILE]..."
#define unlzop_full_usage "\n\n" \
" -c Write to standard output" \
"\n -f Force" \
"Uncompress to stdout"
#define unlzma_trivial_usage \
- "[OPTION]... [FILE]"
+ "[OPTIONS] [FILE]"
#define unlzma_full_usage "\n\n" \
- "Uncompress FILE (or standard input if FILE is '-' or omitted)\n" \
+ "Uncompress FILE (or standard input)\n" \
"\nOptions:" \
"\n -c Write to standard output" \
"\n -f Force" \
#define cat_trivial_usage \
"[-u] [FILE]..."
#define cat_full_usage "\n\n" \
- "Concatenate FILE(s) and print them to stdout\n" \
+ "Concatenate FILEs and print them to stdout\n" \
"\nOptions:" \
"\n -u Use unbuffered i/o (ignored)" \
"\n a Append mode only" \
"\n c Enable compress" \
"\n D Write dir contents synchronously" \
- "\n d Do not backup with dump" \
+ "\n d Don't backup with dump" \
"\n i Cannot be modified (immutable)" \
"\n j Write all data to journal first" \
"\n s Zero disk storage when deleted" \
"\n -r,--role=ROLE security context" \
"\n -t,--type=TYPE" \
"\n -l,--range=RANGE" \
- "\n -R,--recursive Recurse subdirectories" \
+ "\n -R,--recursive Recurse" \
) \
IF_NOT_FEATURE_CHCON_LONG_OPTIONS( \
"\n -v Verbose" \
"\n -r ROLE" \
"\n -t TYPE" \
"\n -l RNG" \
- "\n -R Recurse subdirectories" \
+ "\n -R Recurse" \
)
#define chmod_trivial_usage \
"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 Recurse directories" \
+ "\n -R Recurse" \
IF_DESKTOP( \
"\n -c List changed files" \
"\n -v List all files" \
#define chgrp_full_usage "\n\n" \
"Change the group membership of each FILE to GROUP\n" \
"\nOptions:" \
- "\n -R Recurse directories" \
+ "\n -R Recurse" \
"\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)" \
+ "\n -P Don't traverse symlinks (default)" \
IF_DESKTOP( \
"\n -c List changed files" \
"\n -v Verbose" \
#define chown_full_usage "\n\n" \
"Change the owner and/or group of each FILE to OWNER and/or GROUP\n" \
"\nOptions:" \
- "\n -R Recurse directories" \
+ "\n -R Recurse" \
"\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)" \
+ "\n -P Don't traverse symlinks (default)" \
IF_DESKTOP( \
"\n -c List changed files" \
"\n -v List all files" \
"\n a SIGXCPU after N seconds" \
#define chroot_trivial_usage \
- "NEWROOT [COMMAND...]"
+ "NEWROOT [PROG [ARGS]]"
#define chroot_full_usage "\n\n" \
- "Run COMMAND with root directory set to NEWROOT"
+ "Run PROG with root directory set to NEWROOT"
#define chroot_example_usage \
"$ ls -l /bin/ls\n" \
"lrwxrwxrwx 1 root root 12 Apr 13 00:46 /bin/ls -> /BusyBox\n" \
#define bbconfig_full_usage "\n\n" \
"Print the config file which built busybox"
-#define bbsh_trivial_usage \
- "[FILE]...\n" \
- "or: bbsh -c command [args]..."
-#define bbsh_full_usage "\n\n" \
- "The bbsh shell (command interpreter)"
-
#define chrt_trivial_usage \
- "[OPTION]... [prio] [pid | command [arg]...]"
+ "[OPTIONS] [PRIO] [PID | PROG [ARGS]]"
#define chrt_full_usage "\n\n" \
"Manipulate real-time attributes of a process\n" \
"\nOptions:" \
"You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
#define cp_trivial_usage \
- "[OPTION]... SOURCE DEST"
+ "[OPTIONS] SOURCE DEST"
#define cp_full_usage "\n\n" \
"Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY\n" \
"\nOptions:" \
"\n -p Preserve file attributes if possible" \
"\n -f Force overwrite" \
"\n -i Prompt before overwrite" \
- "\n -R,-r Recurse directories" \
+ "\n -R,-r Recurse" \
"\n -l,-s Create (sym)links" \
#define cpio_trivial_usage \
#define cryptpw_full_usage "\n\n" \
"Crypt the PASSWORD using crypt(3)\n" \
"\nOptions:" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
"\n -P,--password-fd=NUM Read password from fd NUM" \
/* "\n -s,--stdin Use stdin; like -P0" */ \
"\n -m,--method=TYPE Encryption method TYPE" \
"\n -S,--salt=SALT" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -P NUM Read password from fd NUM" \
/* "\n -s Use stdin; like -P0" */ \
"\n -m TYPE Encryption method TYPE" \
#define mkpasswd_full_usage "\n\n" \
"Crypt the PASSWORD using crypt(3)\n" \
"\nOptions:" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
"\n -P,--password-fd=NUM Read password from fd NUM" \
/* "\n -s,--stdin Use stdin; like -P0" */ \
"\n -m,--method=TYPE Encryption method TYPE" \
"\n -S,--salt=SALT" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -P NUM Read password from fd NUM" \
/* "\n -s Use stdin; like -P0" */ \
"\n -m TYPE Encryption method TYPE" \
#define cttyhack_full_usage ""
#define cut_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define cut_full_usage "\n\n" \
"Print selected fields from each input FILE to standard output\n" \
"\nOptions:" \
"world\n"
#define date_trivial_usage \
- "[OPTION]... [+FMT] [TIME]"
+ "[OPTIONS] [+FMT] [TIME]"
#define date_full_usage "\n\n" \
"Display time (using +FMT), or set time\n" \
"\nOptions:" \
+ IF_NOT_LONG_OPTS( \
+ "\n [-s] TIME Set time to TIME" \
"\n -u Work in UTC (don't convert to local time)" \
- "\n -R Output RFC-822 compliant date string" \
+ "\n -R Output RFC-2822 compliant date string" \
+ ) IF_LONG_OPTS( \
+ "\n [-s,--set] TIME Set time to TIME" \
+ "\n -u,--utc Work in UTC (don't convert to local time)" \
+ "\n -R,--rfc-2822 Output RFC-2822 compliant date string" \
+ ) \
IF_FEATURE_DATE_ISOFMT( \
"\n -I[SPEC] Output ISO-8601 compliant date string" \
"\n SPEC='date' (default) for date only," \
"\n 'hours', 'minutes', or 'seconds' for date and" \
"\n time to the indicated precision" \
- ) \
- "\n -d TIME Display TIME, not 'now'" \
+ ) IF_NOT_LONG_OPTS( \
"\n -r FILE Display last modification time of FILE" \
- "\n [-s] TIME Set time to TIME" \
+ "\n -d TIME Display TIME, not 'now'" \
+ ) IF_LONG_OPTS( \
+ "\n -r,--reference FILE Display last modification time of FILE" \
+ "\n -d,--date TIME Display TIME, not 'now'" \
+ ) \
IF_FEATURE_DATE_ISOFMT( \
- "\n -D FMT Use FMT for str->date conversion" \
+ "\n -D FMT Use FMT for -d TIME conversion" \
) \
"\n" \
- "\nRecognized formats for TIME:" \
+ "\nRecognized TIME formats:" \
"\n hh:mm[:ss]" \
"\n [YYYY.]MM.DD-hh:mm[:ss]" \
"\n YYYY-MM-DD hh:mm[:ss]" \
- "\n MMDDhhmm[[YY]YY][.ss]" \
+ "\n [[[[[YY]YY]MM]DD]hh]mm[.ss]" \
#define date_example_usage \
"$ date\n" \
"\n -fg Run in foreground" \
"\n -np Exit after parsing the configuration file" \
"\n and processing synthetic REGISTER events," \
- "\n do not poll for events" \
+ "\n don't poll for events" \
)
#define df_trivial_usage \
"\n -d Daemonize" \
#define dos2unix_trivial_usage \
- "[option] [FILE]"
+ "[OPTION] [FILE]"
#define dos2unix_full_usage "\n\n" \
- "Convert FILE from dos to unix format.\n" \
+ "Convert FILE in-place from DOS to Unix format.\n" \
+ "When no file is given, use stdin/stdout.\n" \
+ "\nOptions:" \
+ "\n -u dos2unix" \
+ "\n -d unix2dos" \
+
+#define unix2dos_trivial_usage \
+ "[OPTION] [FILE]"
+#define unix2dos_full_usage "\n\n" \
+ "Convert FILE in-place from Unix to DOS format.\n" \
"When no file is given, use stdin/stdout.\n" \
"\nOptions:" \
"\n -u dos2unix" \
#define dumpleases_full_usage "\n\n" \
"Display DHCP leases granted by udhcpd\n" \
"\nOptions:" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
"\n -f,--file=FILE Leases file to load" \
"\n -r,--remaining Interpret lease times as time remaining" \
"\n -a,--absolute Interpret lease times as expire time" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -f FILE Leases file to load" \
"\n -r Interpret lease times as time remaining" \
"\n -a Interpret lease times as expire time" \
#define ed_full_usage ""
#define env_trivial_usage \
- "[-iu] [-] [name=value]... [command]"
+ "[-iu] [-] [name=value]... [PROG [ARGS]]"
#define env_full_usage "\n\n" \
- "Print the current environment or run a program after setting\n" \
- "up the specified environment\n" \
+ "Print the current environment or run PROG after setting up\n" \
+ "the specified environment\n" \
"\nOptions:" \
"\n -, -i Start with an empty environment" \
"\n -u Remove variable from the environment" \
#define expand_trivial_usage \
"[-i] [-t NUM] [FILE|-]"
#define expand_full_usage "\n\n" \
- "Convert tabs to spaces, writing to standard output.\n" \
+ "Convert tabs to spaces, writing to standard output\n" \
"\nOptions:" \
IF_FEATURE_EXPAND_LONG_OPTIONS( \
- "\n -i,--initial Do not convert tabs after non blanks" \
+ "\n -i,--initial Don't convert tabs after non blanks" \
"\n -t,--tabs=N Tabstops every N chars" \
) \
IF_NOT_FEATURE_EXPAND_LONG_OPTIONS( \
- "\n -i Do not convert tabs after non blanks" \
+ "\n -i Don't convert tabs after non blanks" \
"\n -t Tabstops every N chars" \
)
#define expr_trivial_usage \
"EXPRESSION"
#define expr_full_usage "\n\n" \
- "Print the value of EXPRESSION to standard output.\n" \
- "\n" \
+ "Print the value of EXPRESSION to standard output\n" \
+ "\n" \
"EXPRESSION may be:\n" \
" ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2\n" \
" ARG1 & ARG2 ARG1 if neither argument is null or 0, otherwise 0\n" \
"\n -i Inetd mode" \
"\n -w Inetd 'wait' mode" \
"\n -b ADDR Bind to specified address" \
- "\n STRING Ident answer string (default is 'nobody')" \
+ "\n STRING Ident answer string (default: nobody)" \
#define false_trivial_usage \
""
"1\n"
#define fbset_trivial_usage \
- "[options] [mode]"
+ "[OPTIONS] [MODE]"
#define fbset_full_usage "\n\n" \
"Show and modify frame buffer settings"
#define blkid_trivial_usage \
""
#define blkid_full_usage "\n\n" \
- "Print UUIDs of all filesystems."
+ "Print UUIDs of all filesystems"
#define findfs_trivial_usage \
"LABEL=label or UUID=uuid"
#define findfs_full_usage "\n\n" \
- "Find a filesystem device based on a label or UUID."
+ "Find a filesystem device based on a label or UUID"
#define findfs_example_usage \
"$ findfs LABEL=MyDevice"
IF_FEATURE_FIND_MAXDEPTH( \
"\n -maxdepth N Descend at most N levels. -maxdepth 0 applies" \
"\n tests/actions to command line arguments only") \
- "\n -mindepth N Do not act on first N levels" \
+ "\n -mindepth N Don't act on first N levels" \
"\n -name PATTERN File name (w/o directory name) matches PATTERN" \
"\n -iname PATTERN Case insensitive -name" \
IF_FEATURE_FIND_PATH( \
IF_FEATURE_FIND_CONTEXT ( \
"\n -context File has specified security context") \
IF_FEATURE_FIND_EXEC( \
- "\n -exec CMD ARG ; Execute CMD with all instances of {} replaced by the" \
+ "\n -exec CMD ARG ; Run CMD with all instances of {} replaced by the" \
"\n matching files") \
IF_FEATURE_FIND_PRUNE( \
"\n -prune Stop traversing current subtree") \
"$ find / -name passwd\n" \
"/etc/passwd\n"
+#define flash_lock_trivial_usage \
+ "MTD_DEVICE OFFSET SECTORS"
+#define flash_lock_full_usage "\n\n" \
+ "Lock part or all of an MTD device. If SECTORS is -1, then all sectors\n" \
+ "will be locked, regardless of the value of OFFSET"
+
+#define flash_unlock_trivial_usage \
+ "MTD_DEVICE"
+#define flash_unlock_full_usage "\n\n" \
+ "Unlock an MTD device"
+
#define flash_eraseall_trivial_usage \
"[-jq] MTD_DEVICE"
#define flash_eraseall_full_usage "\n\n" \
#define ftpd_trivial_usage \
"[-wvS] [-t N] [-T N] [DIR]"
#define ftpd_full_usage "\n\n" \
- "FTP server\n" \
+ "Anonymous FTP server\n" \
"\n" \
"ftpd should be used as an inetd service.\n" \
"ftpd's line for inetd.conf:\n" \
"\n DIR Change root to this directory" \
#define ftpget_trivial_usage \
- "[options] remote-host local-file remote-file"
+ "[OPTIONS] HOST LOCAL_FILE REMOTE_FILE"
#define ftpget_full_usage "\n\n" \
"Retrieve a remote file via FTP\n" \
"\nOptions:" \
)
#define ftpput_trivial_usage \
- "[options] remote-host remote-file local-file"
+ "[OPTIONS] HOST REMOTE_FILE LOCAL_FILE"
#define ftpput_full_usage "\n\n" \
"Store a local file on a remote machine via FTP\n" \
"\nOptions:" \
)
#define fuser_trivial_usage \
- "[options] FILE or PORT/PROTO"
+ "[OPTIONS] FILE or PORT/PROTO"
#define fuser_full_usage "\n\n" \
"Find processes which use FILEs or PORTs\n" \
"\nOptions:" \
#define getenforce_full_usage ""
#define getopt_trivial_usage \
- "[OPTIONS]..."
+ "[OPTIONS]"
#define getopt_full_usage "\n\n" \
- "Parse command options\n" \
- IF_GETOPT_LONG( \
+ "Options:" \
+ IF_LONG_OPTS( \
"\n -a,--alternative Allow long options starting with single -" \
"\n -l,--longoptions=longopts Long options to be recognized" \
"\n -n,--name=progname The name under which errors are reported" \
"\n -T,--test Test for getopt(1) version" \
"\n -u,--unquoted Don't quote the output" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -a Allow long options starting with single -" \
"\n -l longopts Long options to be recognized" \
"\n -n progname The name under which errors are reported" \
"Open a tty, prompt for a login name, then invoke /bin/login\n" \
"\nOptions:" \
"\n -h Enable hardware (RTS/CTS) flow control" \
- "\n -i Do not display /etc/issue before running login" \
- "\n -L Local line, do not do carrier detect" \
+ "\n -i Don't display /etc/issue before running login" \
+ "\n -L Local line, don't do carrier detect" \
"\n -m Get baud rate from modem's CONNECT status message" \
"\n -w Wait for a CR or LF before sending /etc/issue" \
- "\n -n Do not prompt the user for a login name" \
- "\n -f issue_file Display issue_file instead of /etc/issue" \
- "\n -l login_app Invoke login_app instead of /bin/login" \
- "\n -t timeout Terminate after timeout if no username is read" \
- "\n -I initstring Init string to send before anything else" \
- "\n -H login_host Log login_host into the utmp file as the hostname" \
+ "\n -n Don't prompt the user for a login name" \
+ "\n -f ISSUE_FILE Display ISSUE_FILE instead of /etc/issue" \
+ "\n -l LOGIN Invoke LOGIN instead of /bin/login" \
+ "\n -t SEC Terminate after SEC if no username is read" \
+ "\n -I INITSTR Send INITSTR before anything else" \
+ "\n -H HOST Log HOST into the utmp file as the hostname" \
#define grep_trivial_usage \
"[-HhrilLnqvso" \
IF_FEATURE_GREP_EGREP_ALIAS("E") \
IF_FEATURE_GREP_CONTEXT("ABC") \
IF_EXTRA_COMPAT("z") \
- "] PATTERN [FILEs...]"
+ "] PATTERN [FILE]..."
#define grep_full_usage "\n\n" \
"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 -r Recurse" \
"\n -i Ignore case distinctions" \
"\n -l List names of files that match" \
- "\n -L List names of files that do not match" \
+ "\n -L List names of files that don't match" \
"\n -n Print line number with output lines" \
"\n -q Quiet. Return 0 if PATTERN is found, 1 otherwise" \
"\n -v Select non-matching lines" \
#define fgrep_full_usage ""
#define gunzip_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define gunzip_full_usage "\n\n" \
"Uncompress FILEs (or standard input)\n" \
"\nOptions:" \
"-rw-rw-r-- 1 andersen andersen 1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar\n"
#define gzip_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define gzip_full_usage "\n\n" \
"Compress FILEs (or standard input)\n" \
"\nOptions:" \
)
#define hdparm_trivial_usage \
- "[options] [device] .."
+ "[OPTIONS] [DEVICE]"
#define hdparm_full_usage "\n\n" \
"Options:" \
"\n -a Get/set fs readahead" \
"\n -z Re-read partition table" \
#define head_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define head_full_usage "\n\n" \
- "Print 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" \
+ "Print first 10 lines of each FILE (or standard input) to standard output.\n" \
+ "With more than one FILE, precede each with a header giving the file name.\n" \
"\nOptions:" \
"\n -n NUM Print first NUM lines instead of first 10" \
IF_FEATURE_FANCY_HEAD( \
#define hexdump_trivial_usage \
"[-bcCdefnosvx" IF_FEATURE_HEXDUMP_REVERSE("R") "] FILE..."
#define hexdump_full_usage "\n\n" \
- "Display file(s) or standard input in a user specified format\n" \
+ "Display FILEs or standard input in a user specified format\n" \
"\nOptions:" \
"\n -b One-byte octal display" \
"\n -c One-byte character display" \
"Print out a unique 32-bit identifier for the machine"
#define hostname_trivial_usage \
- "[OPTION] [hostname | -F FILE]"
+ "[OPTIONS] [HOSTNAME | -F FILE]"
#define hostname_full_usage "\n\n" \
"Get or set hostname or DNS domain name\n" \
"\nOptions:" \
"\n -i Addresses for the hostname" \
"\n -d DNS domain name" \
"\n -f Fully qualified domain name" \
- "\n -F FILE Use the contents of FILE to specify the hostname" \
+ "\n -F FILE Use FILE's content as hostname" \
#define hostname_example_usage \
"$ hostname\n" \
"sage\n"
+#define dnsdomainname_trivial_usage NOUSAGE_STR
+#define dnsdomainname_full_usage ""
+
#define httpd_trivial_usage \
"[-ifv[v]]" \
" [-c CONFFILE]" \
"Listen for incoming HTTP requests\n" \
"\nOptions:" \
"\n -i Inetd mode" \
- "\n -f Do not daemonize" \
+ "\n -f Don't daemonize" \
"\n -v[v] Verbose" \
"\n -c FILE Configuration file (default httpd.conf)" \
"\n -p [IP:]PORT Bind to ip:port (default *:80)" \
"\n -f FILE Use specified device (e.g. /dev/rtc2)" \
#define id_trivial_usage \
- "[OPTIONS]... [USER]"
+ "[OPTIONS] [USER]"
#define id_full_usage "\n\n" \
"Print information about USER or the current user\n" \
"\nOptions:" \
" # ifenslave -c bond0 eth0\n" \
#define ifplugd_trivial_usage \
- "[options]"
+ "[OPTIONS]"
#define ifplugd_full_usage "\n\n" \
- "Network interface plug detection daemon.\n\n" \
- "Options:\n" \
- "\n -n Do not daemonize" \
- "\n -s Do not log to syslog" \
+ "Network interface plug detection daemon\n" \
+ "\nOptions:" \
+ "\n -n Don't daemonize" \
+ "\n -s Don't log to syslog" \
"\n -i IFACE Interface" \
"\n -f/-F Treat link detection error as link down/link up" \
"\n (otherwise exit on error)" \
- "\n -a Do not up interface automatically" \
+ "\n -a Don't up interface automatically" \
"\n -M Monitor creation/destruction of interface" \
"\n (otherwise it must exist)" \
"\n -r PROG Script to run" \
"\n a File is accessed" \
"\n c File is modified" \
"\n e Metadata changed" \
- "\n w Writtable file is closed" \
- "\n 0 Unwrittable file is closed" \
+ "\n w Writable file is closed" \
+ "\n 0 Unwritable file is closed" \
"\n r File is opened" \
"\n D File is deleted" \
"\n M File is moved" \
/* 2.6 style insmod has no options and required filename
* (not module name - .ko can't be omitted) */
#define insmod_trivial_usage \
- IF_FEATURE_2_4_MODULES("[OPTION]... MODULE ") \
+ IF_FEATURE_2_4_MODULES("[OPTIONS] MODULE ") \
IF_NOT_FEATURE_2_4_MODULES("FILE ") \
"[symbol=value]..."
#define insmod_full_usage "\n\n" \
"\n -m Output load map to stdout" \
) \
"\n -o NAME Set internal module name to NAME" \
- "\n -x Do not export externs" \
+ "\n -x Don't export externs" \
)
/* -v, -b, -c are ignored */
" SCOPE-ID := [host | link | global | NUMBER]" \
#define ipcalc_trivial_usage \
- "[OPTION]... ADDRESS[[/]NETMASK] [NETMASK]"
+ "[OPTIONS] ADDRESS[[/]NETMASK] [NETMASK]"
#define ipcalc_full_usage "\n\n" \
"Calculate IP network settings from a IP address\n" \
"\nOptions:" \
"[-a|k|s|u] [-C TTY]"
#define kbd_mode_full_usage "\n\n" \
"Report or set the keyboard mode\n" \
- "\nOptions set mode:" \
+ "\nOptions:" \
"\n -a Default (ASCII)" \
"\n -k Medium-raw (keyboard)" \
"\n -s Raw (scancode)" \
#define kill_trivial_usage \
"[-l] [-SIG] PID..."
#define kill_full_usage "\n\n" \
- "Send a signal (default is TERM) to given PIDs\n" \
+ "Send a signal (default: TERM) to given PIDs\n" \
"\nOptions:" \
"\n -l List all signal names and numbers" \
/* "\n -s SIG Yet another way of specifying SIG" */ \
#define killall_trivial_usage \
"[-l] [-q] [-SIG] process-name..."
#define killall_full_usage "\n\n" \
- "Send a signal (default is TERM) to given processes\n" \
+ "Send a signal (default: TERM) to given processes\n" \
"\nOptions:" \
"\n -l List all signal names and numbers" \
/* "\n -s SIG Yet another way of specifying SIG" */ \
- "\n -q Do not complain if no processes were killed" \
+ "\n -q Don't complain if no processes were killed" \
#define killall_example_usage \
"$ killall apache\n"
#define killall5_trivial_usage \
"[-l] [-SIG] [-o PID]..."
#define killall5_full_usage "\n\n" \
- "Send a signal (default is TERM) to all processes outside current session\n" \
+ "Send a signal (default: TERM) to all processes outside current session\n" \
"\nOptions:" \
"\n -l List all signal names and numbers" \
- "\n -o PID Do not signal this PID" \
+ "\n -o PID Don't signal this PID" \
/* "\n -s SIG Yet another way of specifying SIG" */ \
#define klogd_trivial_usage \
"5\n"
#define less_trivial_usage \
- "[-EMNmh~I?] [FILE...]"
+ "[-EMNmh~I?] [FILE]..."
#define less_full_usage "\n\n" \
"View a file or list of files. The position within files can be\n" \
"changed, and files can be manipulated in various ways.\n" \
"\nOptions:" \
"\n -E Quit once the end of a file is reached" \
- "\n -M,-m Display a status line containing the line numbers" \
+ "\n -M,-m Display status line with line numbers" \
"\n and percentage through the file" \
- "\n -N Prefix line numbers to each line" \
+ "\n -N Prefix line number to each line" \
"\n -I Ignore case in all searches" \
"\n -~ Suppress ~s displayed past the end of the file" \
" linux64 Set 64bit uname emulation" \
#define ln_trivial_usage \
- "[OPTION] TARGET... LINK_NAME|DIRECTORY"
+ "[OPTIONS] TARGET... LINK|DIRECTORY"
#define ln_full_usage "\n\n" \
- "Create a link named LINK_NAME or DIRECTORY to the specified TARGET.\n" \
- "Use '--' to indicate that all following arguments are non-options.\n" \
+ "Create a link LINK or DIRECTORY/TARGET to the specified TARGET(s)\n" \
"\nOptions:" \
"\n -s Make symlinks instead of hardlinks" \
"\n -f Remove existing destination files" \
"$ loadkmap < /etc/i18n/lang-keymap\n"
#define logger_trivial_usage \
- "[OPTION]... [MESSAGE]"
+ "[OPTIONS] [MESSAGE]"
#define logger_full_usage "\n\n" \
"Write MESSAGE to the system log. If MESSAGE is omitted, log stdin.\n" \
"\nOptions:" \
#define login_full_usage "\n\n" \
"Begin a new session on the system\n" \
"\nOptions:" \
- "\n -f Do not authenticate (user already authenticated)" \
+ "\n -f Don't authenticate (user already authenticated)" \
"\n -h Name of the remote host" \
"\n -p Preserve environment" \
"root\n"
#define logread_trivial_usage \
- "[OPTION]..."
+ "[OPTIONS]"
#define logread_full_usage "\n\n" \
"Show messages in syslogd's circular buffer\n" \
"\nOptions:" \
"losetup -f will show the first loop free loop device\n\n"
#define lpd_trivial_usage \
- "SPOOLDIR [HELPER [ARGS...]]"
+ "SPOOLDIR [HELPER [ARGS]]"
#define lpd_full_usage "\n\n" \
"SPOOLDIR must contain (symlinks to) device nodes or directories" \
"\nwith names matching print queue names. In the first case, jobs are" \
"\n -s Short display" \
#define lpr_trivial_usage \
- "-P queue[@host[:port]] -U USERNAME -J TITLE -Vmh [FILE...]"
+ "-P queue[@host[:port]] -U USERNAME -J TITLE -Vmh [FILE]..."
/* -C CLASS exists too, not shown.
* CLASS is supposed to be printed on banner page, if one is requested */
#define lpr_full_usage "\n\n" \
IF_FEATURE_AUTOWIDTH("T") IF_FEATURE_LS_TIMESTAMPS("tu") \
IF_FEATURE_LS_SORTFILES("v") IF_FEATURE_AUTOWIDTH("w") "x" \
IF_FEATURE_LS_SORTFILES("X") IF_FEATURE_HUMAN_READABLE("h") "k" \
- IF_SELINUX("K") "] [filenames...]"
+ IF_SELINUX("K") "] [FILE]..."
#define ls_full_usage "\n\n" \
"List directory contents\n" \
"\nOptions:" \
"\n -Z List security context and permission") \
#define lsattr_trivial_usage \
- "[-Radlv] [files...]"
+ "[-Radlv] [FILE]..."
#define lsattr_full_usage "\n\n" \
"List file attributes on an ext2 fs\n" \
"\nOptions:" \
"\n -R Recursively list subdirectories" \
- "\n -a Do not hide entries starting with ." \
+ "\n -a Don't hide entries starting with ." \
"\n -d List directory entries instead of contents" \
"\n -l List long flag names" \
"\n -v List the file's version/generation number" \
#endif
#define makemime_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define makemime_full_usage "\n\n" \
- "Create MIME-encoded message\n" \
- "\nOptions:" \
- "\n -C Charset" \
- "\n -e Transfer encoding. Ignored. base64 is assumed" \
+ "Create multipart MIME-encoded message from FILEs\n" \
+/* "Transfer encoding is base64, disposition is inline (not attachment)\n" */ \
+ "\nOptions:" \
+ "\n -o FILE Output. Default: stdout" \
+ "\n -a HDR Add header. Examples:" \
+ "\n \"From: user@host.org\", \"Date: `date -R`\"" \
+ "\n -c CT Content type. Default: text/plain" \
+ "\n -C CS Charset. Default: " CONFIG_FEATURE_MIME_CHARSET \
+/* "\n -e ENC Transfer encoding. Ignored. base64 is assumed" */ \
"\n" \
- "\nOther options are silently ignored." \
+ "\nOther options are silently ignored" \
#define man_trivial_usage \
- "[OPTION]... [MANPAGE]..."
+ "[OPTIONS] [MANPAGE]..."
#define man_full_usage "\n\n" \
"Format and display manual page\n" \
"\nOptions:" \
#define matchpathcon_trivial_usage \
"[-n] [-N] [-f file_contexts_file] [-p prefix] [-V]"
#define matchpathcon_full_usage "\n\n" \
- " -n Do not display path" \
- "\n -N Do not use translations" \
+ " -n Don't display path" \
+ "\n -N Don't 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...]" \
- IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: md5sum [OPTION] -c [FILE]")
+ "[OPTIONS] [FILE]..." \
+ IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: md5sum [OPTIONS] -c [FILE]")
#define md5sum_full_usage "\n\n" \
"Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums" \
IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"^D\n"
#define sha1sum_trivial_usage \
- "[OPTION] [FILEs...]" \
- IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha1sum [OPTION] -c [FILE]")
+ "[OPTIONS] [FILE]..." \
+ IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha1sum [OPTIONS] -c [FILE]")
#define sha1sum_full_usage "\n\n" \
- "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+ "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums" \
IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \
"\n -c Check sums against given list" \
)
#define sha256sum_trivial_usage \
- "[OPTION] [FILEs...]" \
- IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha256sum [OPTION] -c [FILE]")
+ "[OPTIONS] [FILE]..." \
+ IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha256sum [OPTIONS] -c [FILE]")
#define sha256sum_full_usage "\n\n" \
- "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+ "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA256 checksums" \
IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \
"\n -c Check sums against given list" \
)
#define sha512sum_trivial_usage \
- "[OPTION] [FILEs...]" \
- IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha512sum [OPTION] -c [FILE]")
+ "[OPTIONS] [FILE]..." \
+ IF_FEATURE_MD5_SHA1_SUM_CHECK("\n or: sha512sum [OPTIONS] -c [FILE]")
#define sha512sum_full_usage "\n\n" \
- "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
+ "Print" IF_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA512 checksums" \
IF_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
"\nOptions:" \
"\n -c Check sums against given list" \
"It uses /etc/mdev.conf with lines\n" \
"[-]DEVNAME UID:GID PERM" \
IF_FEATURE_MDEV_RENAME(" [>|=PATH]") \
- IF_FEATURE_MDEV_EXEC(" [@|$|*COMMAND]") \
+ IF_FEATURE_MDEV_EXEC(" [@|$|*PROG]") \
) \
#define mdev_notes_usage "" \
"\n -X Disable special meaning of NUL and Ctrl-X from stdin" \
#define mkdir_trivial_usage \
- "[OPTION] DIRECTORY..."
+ "[OPTIONS] DIRECTORY..."
#define mkdir_full_usage "\n\n" \
"Create DIRECTORY\n" \
"\nOptions:" \
- "\n -m Set permission mode (as in chmod), not rwxrwxrwx - umask" \
- "\n -p No error if existing, make parent directories as needed" \
+ "\n -m Mode" \
+ "\n -p No error if exists; make parent directories as needed" \
IF_SELINUX( \
"\n -Z Set security context" \
)
"/tmp/foo/bar/baz: No such file or directory\n" \
"$ mkdir -p /tmp/foo/bar/baz\n"
-#define mke2fs_trivial_usage \
- "[-c|-l filename] [-b block-size] [-f fragment-size] [-g blocks-per-group] " \
- "[-i bytes-per-inode] [-j] [-J journal-options] [-N number-of-inodes] [-n] " \
- "[-m reserved-blocks-percentage] [-o creator-os] [-O feature[,...]] [-q] " \
- "[r fs-revision-level] [-E extended-options] [-v] [-F] [-L volume-label] " \
- "[-M last-mounted-directory] [-S] [-T filesystem-type] " \
- "device [blocks-count]"
-#define mke2fs_full_usage "\n\n" \
- " -b size Block size in bytes" \
- "\n -c Check for bad blocks before creating" \
- "\n -E opts Set extended options" \
- "\n -f size Fragment size in bytes" \
- "\n -F Force (ignore sanity checks)" \
- "\n -g num Number of blocks in a block group" \
- "\n -i ratio The bytes/inode ratio" \
- "\n -j Create a journal (ext3)" \
- "\n -J opts Set journal options (size/device)" \
- "\n -l file Read bad blocks list from file" \
- "\n -L lbl Set the volume label" \
- "\n -m percent Percent of fs blocks to reserve for admin" \
- "\n -M dir Set last mounted directory" \
- "\n -n Do not actually create anything" \
- "\n -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" \
- "\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" \
-
#define mkfifo_trivial_usage \
"[OPTIONS] name"
#define mkfifo_full_usage "\n\n" \
"\n -Z Set security context" \
)
+#define mkfs_ext2_trivial_usage \
+ "[-Fn] " \
+ /* "[-c|-l filename] " */ \
+ "[-b BLK_SIZE] " \
+ /* "[-f fragment-size] [-g blocks-per-group] " */ \
+ "[-i INODE_RATIO] [-I INODE_SIZE] " \
+ /* "[-j] [-J journal-options] [-N number-of-inodes] " */ \
+ "[-m RESERVED_PERCENT] " \
+ /* "[-o creator-os] [-O feature[,...]] [-q] " */ \
+ /* "[r fs-revision-level] [-E extended-options] [-v] [-F] " */ \
+ "[-L LABEL] " \
+ /* "[-M last-mounted-directory] [-S] [-T filesystem-type] " */ \
+ "BLOCKDEV [KBYTES]"
+#define mkfs_ext2_full_usage "\n" \
+ "\n -b BLK_SIZE Block size, bytes" \
+/* "\n -c Check device for bad blocks" */ \
+/* "\n -E opts Set extended options" */ \
+/* "\n -f size Fragment size in bytes" */ \
+ "\n -F Force" \
+/* "\n -g num Number of blocks in a block group" */ \
+ "\n -i RATIO Max number of files is filesystem_size / RATIO" \
+ "\n -I BYTES Inode size (min 128)" \
+/* "\n -j Create a journal (ext3)" */ \
+/* "\n -J opts Set journal options (size/device)" */ \
+/* "\n -l file Read bad blocks list from file" */ \
+ "\n -L LBL Volume label" \
+ "\n -m PERCENT Percent of blocks to reserve for admin" \
+/* "\n -M dir Set last mounted directory" */ \
+ "\n -n Dry run" \
+/* "\n -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" */ \
+/* "\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" */ \
+
#define mkfs_minix_trivial_usage \
- "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]"
+ "[-c | -l filename] [-nXX] [-iXX] BLOCKDEV [KBYTES]"
#define mkfs_minix_full_usage "\n\n" \
"Make a MINIX filesystem\n" \
"\nOptions:" \
"\n -v Make version 2 filesystem" \
#define mkfs_vfat_trivial_usage \
- "[-v] [-n LABEL] FILE_OR_DEVICE [SIZE_IN_KB]"
+ "[-v] [-n LABEL] BLOCKDEV [KBYTES]"
/* Accepted but ignored:
"[-c] [-C] [-I] [-l bad-block-file] [-b backup-boot-sector] "
"[-m boot-msg-file] [-i volume-id] "
"-rw------- 1 andersen andersen 0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
#define modprobe_trivial_usage \
- "[-knqrsv] MODULE [symbol=value...]"
+ IF_MODPROBE_SMALL("[-qfwrsv] MODULE [symbol=value...]") \
+ IF_NOT_MODPROBE_SMALL("[-" \
+ IF_FEATURE_2_4_MODULES("k")"nqrsv" \
+ IF_FEATURE_MODPROBE_BLACKLIST("b")"] MODULE [symbol=value...]")
#define modprobe_full_usage "\n\n" \
"Options:" \
+ IF_MODPROBE_SMALL( \
+ "\n -q Quiet" \
+ "\n -f Force" \
+ "\n -w Wait for unload" \
+ "\n -r Remove module (stacks) or do autoclean" \
+ "\n -s Report via syslog instead of stderr" \
+ "\n -v Verbose" \
+ ) \
+ IF_NOT_MODPROBE_SMALL( \
IF_FEATURE_2_4_MODULES( \
"\n -k Make module autoclean-able" \
) \
"\n -v Verbose" \
IF_FEATURE_MODPROBE_BLACKLIST( \
"\n -b Apply blacklist to module names too" \
- )
+ ) \
+ )
#define modprobe_notes_usage \
"modprobe can (un)load a stack of modules, passing each module options (when\n" \
" from the command line\n"
#define more_trivial_usage \
- "[FILE...]"
+ "[FILE]..."
#define more_full_usage "\n\n" \
"View FILE or standard input one screenful at a time"
#define mount_trivial_usage \
"[flags] DEVICE NODE [-o OPT,OPT]"
#define mount_full_usage "\n\n" \
- "Mount a filesystem. Filesystem autodetection requires /proc be mounted.\n" \
+ "Mount a filesystem. Filesystem autodetection requires /proc.\n" \
"\nOptions:" \
"\n -a Mount all filesystems in fstab" \
IF_FEATURE_MOUNT_FAKE( \
IF_NOT_FEATURE_MTAB_SUPPORT( \
"\n -f Dry run" \
) \
+ ) \
+ IF_FEATURE_MOUNT_HELPERS( \
+ "\n -i Don't run mount helper" \
) \
IF_FEATURE_MTAB_SUPPORT( \
"\n -n Don't update /etc/mtab" \
"setpart tell unload unlock weof wset" \
#define mv_trivial_usage \
- "[OPTION]... SOURCE DEST\n" \
- "or: mv [OPTION]... SOURCE... DIRECTORY"
+ "[OPTIONS] SOURCE DEST\n" \
+ "or: mv [OPTIONS] SOURCE... DIRECTORY"
#define mv_full_usage "\n\n" \
"Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY\n" \
"\nOptions:" \
#define nameif_full_usage "\n\n" \
"Rename network interface while it in the down state\n" \
"\nOptions:" \
- "\n -c FILE Use configuration file (default is /etc/mactab)" \
+ "\n -c FILE Use configuration file (default: /etc/mactab)" \
"\n -s Use syslog (LOCAL0 facility)" \
"\n IFNAME MACADDR new_interface_name interface_mac_address" \
#define nc_trivial_usage \
IF_NC_EXTRA("[-iN] [-wN] ")IF_NC_SERVER("[-l] [-p PORT] ") \
- "["IF_NC_EXTRA("-f FILENAME|")"IPADDR PORTNUM]"IF_NC_EXTRA(" [-e COMMAND]")
+ "["IF_NC_EXTRA("-f FILENAME|")"IPADDR PORT]"IF_NC_EXTRA(" [-e PROG]")
#define nc_full_usage "\n\n" \
"Open a pipe to IP:port" IF_NC_EXTRA(" or file") \
NC_OPTIONS_STR \
IF_NC_EXTRA( \
- "\n -e Exec rest of command line after connect" \
- "\n -i SECS Delay interval for lines sent" \
- "\n -w SECS Timeout for connect" \
+ "\n -e PROG Run PROG after connect" \
+ "\n -i SEC Delay interval for lines sent" \
+ "\n -w SEC Timeout for connect" \
"\n -f FILE Use file (ala /dev/ttyS0) instead of network" \
) \
IF_NC_SERVER( \
"\n -l Listen mode, for inbound connects" \
IF_NC_EXTRA( \
"\n (use -l twice with -e for persistent server)") \
- "\n -p PORT Local port number" \
+ "\n -p PORT Local port" \
)
#define nc_notes_usage "" \
#else /* DESKTOP nc - much more compatible with nc 1.10 */
#define nc_trivial_usage \
- "[-options] hostname port - connect" \
+ "[OPTIONS] HOST PORT - connect" \
IF_NC_SERVER("\n" \
- "nc [-options] -l -p port [hostname] [port] - listen")
+ "nc [OPTIONS] -l -p PORT [HOST] [PORT] - listen")
#define nc_full_usage "\n\n" \
"Options:" \
- "\n -e prog [args] Program to exec after connect (must be last)" \
+ "\n -e PROG Run PROG after connect (must be last)" \
IF_NC_SERVER( \
"\n -l Listen mode, for inbound connects" \
) \
"\n -n Don't do DNS resolution" \
- "\n -s addr Local address" \
- "\n -p port Local port" \
+ "\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" \
+ "\n -v Verbose" \
+ "\n -w SEC Timeout for connects and final net reads" \
IF_NC_EXTRA( \
- "\n -i sec Delay interval for lines sent" /* ", ports scanned" */ \
- "\n -o file Hex dump of traffic" \
+ "\n -i SEC Delay interval for lines sent" /* ", ports scanned" */ \
+ "\n -o FILE Hex dump traffic" \
"\n -z Zero-I/O mode (scanning)" \
) \
/* "\n -r Randomize local and remote ports" */
/* "\n -G num Source-routing pointer: 4, 8, 12, ..." */
/* "\nport numbers can be individual or ranges: lo-hi [inclusive]" */
+/* -e PROG can take ARGS too: "nc ... -e ls -l", but we don't document it
+ * in help text: nc 1.10 does not allow that. We don't want to entice
+ * users to use this incompatibility */
+
#endif
#define netstat_trivial_usage \
)
#define nice_trivial_usage \
- "[-n ADJUST] [COMMAND [ARG]...]"
+ "[-n ADJUST] [PROG [ARGS]]"
#define nice_full_usage "\n\n" \
- "Run a program with modified scheduling priority\n" \
+ "Run PROG with modified scheduling priority\n" \
"\nOptions:" \
- "\n -n ADJUST Adjust the scheduling priority by ADJUST" \
+ "\n -n ADJUST Adjust priority by ADJUST" \
#define nmeter_trivial_usage \
"format_string"
#define nmeter_full_usage "\n\n" \
"Monitor system in real time\n\n" \
"Format specifiers:\n" \
- "%Nc or %[cN] Monitor CPU. N - bar size, default 10\n" \
+ " %Nc or %[cN] Monitor CPU. N - bar size, default 10\n" \
" (displays: S:system U:user N:niced D:iowait I:irq i:softirq)\n" \
- "%[niface] Monitor network interface 'iface'\n" \
- "%m Monitor allocated memory\n" \
- "%[mf] Monitor free memory\n" \
- "%[mt] Monitor total memory\n" \
- "%s Monitor allocated swap\n" \
- "%f Monitor number of used file descriptors\n" \
- "%Ni Monitor total/specific IRQ rate\n" \
- "%x Monitor context switch rate\n" \
- "%p Monitor forks\n" \
- "%[pn] Monitor # of processes\n" \
- "%b Monitor block io\n" \
- "%Nt Show time (with N decimal points)\n" \
- "%Nd Milliseconds between updates (default=1000)\n" \
- "%r Print <cr> instead of <lf> at EOL" \
+ " %[niface] Monitor network interface 'iface'\n" \
+ " %m Monitor allocated memory\n" \
+ " %[mf] Monitor free memory\n" \
+ " %[mt] Monitor total memory\n" \
+ " %s Monitor allocated swap\n" \
+ " %f Monitor number of used file descriptors\n" \
+ " %Ni Monitor total/specific IRQ rate\n" \
+ " %x Monitor context switch rate\n" \
+ " %p Monitor forks\n" \
+ " %[pn] Monitor # of processes\n" \
+ " %b Monitor block io\n" \
+ " %Nt Show time (with N decimal points)\n" \
+ " %Nd Milliseconds between updates (default:1000)\n" \
+ " %r Print <cr> instead of <lf> at EOL" \
#define nmeter_example_usage \
"nmeter '%250d%t %20c int %i bio %b mem %m forks%p'"
#define nohup_trivial_usage \
- "COMMAND [ARGS]"
+ "PROG [ARGS]"
#define nohup_full_usage "\n\n" \
- "Run a command immune to hangups, with output to a non-tty"
+ "Run PROG immune to hangups, with output to a non-tty"
#define nohup_example_usage \
"$ nohup make &"
"[-aBbcDdeFfHhIiLlOovXx] " IF_DESKTOP("[-t TYPE] ") "[FILE]"
#define od_full_usage "\n\n" \
"Write an unambiguous representation, octal bytes by default, of FILE\n" \
- "to standard output. With no FILE or when FILE is -, read standard input."
+ "(or standard input) to standard output."
#define openvt_trivial_usage \
- "[-c NUM] [-sw] [COMMAND [ARGS]]"
+ "[-c N] [-sw] [PROG [ARGS]]"
#define openvt_full_usage "\n\n" \
- "Start COMMAND on a new virtual terminal\n" \
+ "Start PROG on a new virtual terminal\n" \
"\nOptions:" \
- "\n -c Use specified VT" \
+ "\n -c N Use specified VT" \
"\n -s Switch to the VT" \
-/* "\n -l Run COMMAND as login shell (by prepending '-')" */ \
- "\n -w Wait for COMMAND to exit" \
+/* "\n -l Run PROG as login shell (by prepending '-')" */ \
+ "\n -w Wait for PROG to exit" \
#define openvt_example_usage \
"openvt 2 /bin/ash\n"
"[-n maxtokens] [-m mintokens] [-d delims] [-f flags] file ..."
#define passwd_trivial_usage \
- "[OPTION] [name]"
+ "[OPTIONS] [USER]"
#define passwd_full_usage "\n\n" \
- "Change user's password. If no name is specified,\n" \
+ "Change USER's password. If no USER is specified,\n" \
"changes the password for the current user.\n" \
"\nOptions:" \
"\n -a Algorithm to use for password (choices: des, md5)" /* ", sha1)" */ \
"\n -u Unlock (re-enable) account" \
#define chpasswd_trivial_usage \
- IF_GETOPT_LONG("[--md5|--encrypted]") IF_NOT_GETOPT_LONG("[-m|-e]")
+ IF_LONG_OPTS("[--md5|--encrypted]") IF_NOT_LONG_OPTS("[-m|-e]")
#define chpasswd_full_usage "\n\n" \
- "Read user:password information from stdin " \
- "and update /etc/passwd accordingly.\n" \
+ "Read user:password from stdin and update /etc/passwd\n" \
"\nOptions:" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
"\n -e,--encrypted Supplied passwords are in encrypted form" \
"\n -m,--md5 Use MD5 encryption instead of DES" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -e Supplied passwords are in encrypted form" \
"\n -m Use MD5 encryption instead of DES" \
)
#define patch_trivial_usage \
- "[-p NUM] [-i DIFF] [-R]"
+ "[-p NUM] [-i DIFF] [-R] [-N]"
#define patch_full_usage "\n\n" \
" -p NUM Strip NUM leading components from file names" \
"\n -i DIFF Read DIFF instead of stdin" \
"\n -R Reverse patch" \
+ "\n -N Ignore already applied patches" \
#define patch_example_usage \
"$ patch -p1 < example.diff\n" \
"$ patch -p0 -i example.diff"
#define pgrep_trivial_usage \
- "[-flnovx] pattern"
+ "[-flnovx] [-s SID|-P PPID|PATTERN]"
#define pgrep_full_usage "\n\n" \
- "Display process(es) selected by regex pattern\n" \
+ "Display process(es) selected by regex PATTERN\n" \
"\nOptions:" \
"\n -l Show command name too" \
"\n -f Match against entire command line" \
"\n -n Show the newest process only" \
"\n -o Show the oldest process only" \
- "\n -v Negate the matching" \
+ "\n -v Negate the match" \
"\n -x Match whole name (not substring)" \
+ "\n -s Match session ID (0 for current)" \
+ "\n -P Match parent process ID" \
#if (ENABLE_FEATURE_PIDOF_SINGLE || ENABLE_FEATURE_PIDOF_OMIT)
#define pidof_trivial_usage \
- "[OPTION] [NAME...]"
+ "[OPTIONS] [NAME...]"
#define USAGE_PIDOF "\n\nOptions:"
#else
#define pidof_trivial_usage \
"Send ICMP ECHO_REQUEST packets to network hosts"
#else
#define ping_trivial_usage \
- "[OPTION]... host"
+ "[OPTIONS] HOST"
#define ping_full_usage "\n\n" \
"Send ICMP ECHO_REQUEST packets to network hosts\n" \
"\nOptions:" \
"\n -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 -W timeout Seconds to wait for the first response (default:10)" \
+ "\n -s SIZE Send SIZE data bytes in packets (default:56)" \
+ "\n -I IFACE/IP Use interface or IP address as source" \
+ "\n -W SEC Seconds to wait for the first response (default:10)" \
"\n (after all -c CNT packets are sent)" \
- "\n -w deadline Seconds until ping exits (default:infinite)" \
+ "\n -w SEC Seconds until ping exits (default:infinite)" \
"\n (can exit earlier with -c CNT)" \
"\n -q Quiet, only displays output at start" \
"\n and when finished" \
#define ping6_trivial_usage \
- "[OPTION]... host"
+ "[OPTIONS] HOST"
#define ping6_full_usage "\n\n" \
"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 -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" \
"the new root file system"
#define pkill_trivial_usage \
- "[-l] | [-fnovx] [-signal] pattern"
+ "[-l|-SIGNAL] [-fnovx] [-s SID|-P PPID|PATTERN]"
#define pkill_full_usage "\n\n" \
- "Send a signal to process(es) selected by regex pattern\n" \
+ "Send a signal to process(es) selected by regex PATTERN\n" \
"\nOptions:" \
"\n -l List all signals" \
"\n -f Match against entire command line" \
"\n -n Signal the newest process only" \
"\n -o Signal the oldest process only" \
- "\n -v Negate the matching" \
+ "\n -v Negate the match" \
"\n -x Match whole name (not substring)" \
+ "\n -s Match session ID (0 for current)" \
+ "\n -P Match parent process ID" \
#define popmaildir_trivial_usage \
"[OPTIONS] Maildir [connection-helper ...]"
"\n -s Skip authorization" \
"\n -T Get messages with TOP instead with RETR" \
"\n -k Keep retrieved messages on the server" \
- "\n -t timeout Set network timeout" \
- IF_FEATURE_POPMAILDIR_DELIVERY( \
+ "\n -t timeout Network timeout" \
+ IF_FEATURE_POPMAILDIR_DELIVERY( \
"\n -F \"program arg1 arg2 ...\" Filter by program. May be multiple" \
"\n -M \"program arg1 arg2 ...\" Deliver by program" \
- ) \
+ ) \
"\n -R size Remove old messages on the server >= size (in bytes). Ignored" \
"\n -Z N1-N2 Remove messages from N1 to N2 (dangerous). Ignored" \
- "\n -L size Do not retrieve new messages >= size (in bytes). Ignored" \
+ "\n -L size Don't retrieve new messages >= size (in bytes). Ignored" \
"\n -H lines Type specified number of lines of a message. Ignored"
#define popmaildir_example_usage \
"$ popmaildir -k ~/Maildir -- nc pop.drvv.ru 110 [<password_file]\n" \
"\n -f Force power off (don't go through init)" \
#define printenv_trivial_usage \
- "[VARIABLES...]"
+ "[VARIABLE...]"
#define printenv_full_usage "\n\n" \
"Print all or part of environment.\n" \
"If no environment VARIABLE specified, print them all."
"Report process status\n" \
"\nOptions:" \
"\n -o col1,col2=header Select columns for display" \
+ IF_FEATURE_SHOW_THREADS( \
+ "\n -T Show threads" \
+ )
#else /* !ENABLE_DESKTOP */
#define readahead_trivial_usage \
"[FILE]..."
#define readahead_full_usage "\n\n" \
- "Preload FILE(s) in RAM cache so that subsequent reads for those" \
- "files do not block on disk I/O"
+ "Preload FILEs to RAM"
#define readlink_trivial_usage \
- IF_FEATURE_READLINK_FOLLOW("[-f] ") "FILE"
+ IF_FEATURE_READLINK_FOLLOW("[-fnv] ") "FILE"
#define readlink_full_usage "\n\n" \
"Display the value of a symlink" \
IF_FEATURE_READLINK_FOLLOW( "\n" \
"\nOptions:" \
- "\n -f Canonicalize by following all symlinks") \
+ "\n -f Canonicalize by following all symlinks" \
+ "\n -n Don't add newline" \
+ "\n -v Verbose" \
+ ) \
#define readprofile_trivial_usage \
- "[OPTIONS]..."
+ "[OPTIONS]"
#define readprofile_full_usage "\n\n" \
"Options:" \
"\n -m mapfile (Default: /boot/System.map)" \
"\n -f Force reboot (don't go through init)" \
#define reformime_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define reformime_full_usage "\n\n" \
"Parse MIME-encoded message\n" \
"\nOptions:" \
"\n -g Process group id(s)" \
"\n -u Process user name(s) and/or id(s)" \
+#define scriptreplay_trivial_usage \
+ "timingfile [typescript [divisor]]"
+#define scriptreplay_full_usage "\n\n" \
+ "Play back typescripts, using timing information"
+
#define reset_trivial_usage \
""
#define reset_full_usage "\n\n" \
"[-iFnrRv] [-e excludedir]... [-o filename] [-f filename | pathname]"
#define restorecon_full_usage "\n\n" \
"Reset security contexts of files in pathname\n" \
- "\n -i Ignore files that do not exist" \
+ "\n -i Ignore files that don't exist" \
"\n -f file File with list of files to process. Use - for stdin" \
"\n -e directory Directory to exclude" \
- "\n -R,-r Recurse directories" \
+ "\n -R,-r Recurse" \
"\n -n Don't change any file labels" \
"\n -o file Save list of files with incorrect context" \
"\n -v Verbose" \
"\n if it has changed" \
#define rm_trivial_usage \
- "[OPTION]... FILE..."
+ "[OPTIONS] FILE..."
#define rm_full_usage "\n\n" \
- "Remove (unlink) the FILE(s). Use '--' to\n" \
- "indicate that all following arguments are non-options.\n" \
+ "Remove (unlink) FILEs\n" \
"\nOptions:" \
"\n -i Always prompt before removing" \
"\n -f Never prompt" \
"$ rm -rf /tmp/foo\n"
#define rmdir_trivial_usage \
- "[OPTION]... DIRECTORY..."
+ "[OPTIONS] DIRECTORY..."
#define rmdir_full_usage "\n\n" \
- "Remove the DIRECTORY, if it is empty.\n" \
+ "Remove the DIRECTORY, if it is empty\n" \
"\nOptions:" \
- IF_FEATURE_RMDIR_LONG_OPTIONS( \
+ IF_FEATURE_RMDIR_LONG_OPTIONS( \
"\n -p|--parents Include parents" \
- "\n -ignore-fail-on-non-empty" \
- ) \
- IF_NOT_FEATURE_RMDIR_LONG_OPTIONS( \
+ "\n --ignore-fail-on-non-empty" \
+ ) \
+ IF_NOT_FEATURE_RMDIR_LONG_OPTIONS( \
"\n -p Include parents" \
- )
+ )
#define rmdir_example_usage \
"# rmdir /tmp/foo\n"
#define rmmod_trivial_usage \
- "[OPTION]... [MODULE]..."
+ "[OPTIONS] [MODULE]..."
#define rmmod_full_usage "\n\n" \
"Unload the specified kernel modules from the kernel\n" \
"\nOptions:" \
"[-a | -l | -u] [-d DEV] [-m MODE] [-s SEC | -t TIME]"
#define rtcwake_full_usage "\n\n" \
"Enter a system sleep state until specified wakeup time\n" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
"\n -a,--auto Read clock mode from adjtime" \
"\n -l,--local Clock is set to local time" \
"\n -u,--utc Clock is set to UTC time" \
"\n -s,--seconds=SEC Set the timeout in SEC seconds from now" \
"\n -t,--time=TIME Set the timeout to TIME seconds from epoch" \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
"\n -a Read clock mode from adjtime" \
"\n -l Clock is set to local time" \
"\n -u Clock is set to UTC time" \
)
#define runcon_trivial_usage \
- "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
- " runcon CONTEXT COMMAND [args]"
+ "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] PROG [ARGS]\n" \
+ " runcon CONTEXT PROG [ARGS]"
#define runcon_full_usage "\n\n" \
- "Run a program in a different security context\n" \
+ "Run PROG in a different security context\n" \
"\n CONTEXT Complete security context\n" \
IF_FEATURE_RUNCON_LONG_OPTIONS( \
"\n -c,--compute Compute process transition context before modifying" \
#define runlevel_trivial_usage \
"[utmp]"
#define runlevel_full_usage "\n\n" \
- "Find the current and previous system runlevel.\n\n" \
+ "Find the current and previous system runlevel\n" \
+ "\n" \
"If no utmp file exists or if no runlevel record can be found,\n" \
"print \"unknown\""
#define runlevel_example_usage \
"$ rx /tmp/foo\n"
#define script_trivial_usage \
- "[-afq] [-c COMMAND] [OUTFILE]"
+ "[-afq" IF_SCRIPTREPLAY("t") "] [-c PROG] [OUTFILE]"
#define script_full_usage "\n\n" \
"Options:" \
"\n -a Append output" \
- "\n -c Run COMMAND, not shell" \
+ "\n -c Run PROG, not shell" \
"\n -f Flush output after each write" \
"\n -q Quiet" \
+ IF_SCRIPTREPLAY( \
+ "\n -t Send timing to stderr" \
+ )
#define sed_trivial_usage \
- "[-efinr] pattern [files...]"
+ "[-efinr] SED_CMD [FILE]..."
#define sed_full_usage "\n\n" \
"Options:" \
- "\n -e script Add the script to the commands to be executed" \
- "\n -f scriptfile Add scriptfile contents to the" \
- "\n commands to be executed" \
- "\n -i Edit files in-place" \
- "\n -n Suppress automatic printing of pattern space" \
- "\n -r Use extended regular expression syntax" \
+ "\n -e CMD Add CMD to sed commands to be executed" \
+ "\n -f FILE Add FILE contents to sed commands to be executed" \
+ "\n -i Edit files in-place" \
+ "\n -n Suppress automatic printing of pattern space" \
+ "\n -r Use extended regex syntax" \
"\n" \
"\nIf no -e or -f is given, the first non-option argument is taken as the sed" \
- "\nscript to interpret. All remaining arguments are names of input files; if no" \
+ "\ncommand to interpret. All remaining arguments are names of input files; if no" \
"\ninput files are specified, then the standard input is read. Source files" \
"\nwill not be modified unless -i option is given." \
#define selinuxenabled_full_usage ""
#define sendmail_trivial_usage \
- "[OPTIONS] [rcpt]..."
+ "[OPTIONS] [RECIPIENT_EMAIL]..."
#define sendmail_full_usage "\n\n" \
- "Send an email\n" \
+ "Read email from stdin and send it\n" \
"\nStandard options:" \
- "\n -t Read recipients from message body, add them to those on cmdline" \
- "\n -f sender Sender. REQUIRED!" \
- "\n -o options various options. -oi IMPLIED! others are IGNORED!" \
+ "\n -t Read additional recipients from message body" \
+ "\n -f sender Sender (required)" \
+ "\n -o options Various options. -oi implied, others are ignored" \
+ "\n -i -oi synonym. implied and ignored" \
"\n" \
"\nBusybox specific options:" \
"\n -w seconds Network timeout" \
- "\n -H 'prog args' Run connection helper" \
+ "\n -H 'PROG ARGS' Run connection helper" \
"\n Examples:" \
"\n -H 'exec openssl s_client -quiet -tls1 -starttls smtp" \
"\n -connect smtp.gmail.com:25' <email.txt" \
"\n -S server[:port] Server" \
"\n -au<username> Username for AUTH LOGIN" \
"\n -ap<password> Password for AUTH LOGIN" \
- "\n -am<method> Authentication method. Ignored. login is implied." \
+ "\n -am<method> Authentication method. Ignored. LOGIN is implied" \
"\n" \
"\nOther options are silently ignored; -oi -t is implied" \
+ IF_MAKEMIME( \
+ "\nUse makemime applet to create message with attachments" \
+ )
#define seq_trivial_usage \
"[-w] [-s SEP] [FIRST [INC]] LAST"
"\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 -r dir Use an alternate 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" \
"and will not be affected by keyboard signals (Ctrl-C etc).\n" \
"See setsid(2) for details." \
-#define lash_trivial_usage \
- "[FILE]...\n" \
- "or: sh -c command [args]..."
-#define lash_full_usage "\n\n" \
- "lash is deprecated, please use hush"
-
#define last_trivial_usage \
""IF_FEATURE_LAST_FANCY("[-HW] [-f file]")
#define last_full_usage "\n\n" \
"\n -s Display raw scan-codes" \
#define slattach_trivial_usage \
- "[-cehmLF] [-s speed] [-p protocol] DEVICEs"
+ "[-cehmLF] [-s SPEED] [-p PROTOCOL] DEVICE"
#define slattach_full_usage "\n\n" \
"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 -p PROT Set protocol (slip, cslip, slip6, clisp6 or adaptive)" \
+ "\n -s SPD 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 -c PROG Run PROG 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 split_trivial_usage \
- "[OPTION] [INPUT [PREFIX]]"
+ "[OPTIONS] [INPUT [PREFIX]]"
#define split_full_usage "\n\n" \
"Options:" \
"\n -b n[k|m] Split by bytes" \
) \
#define stat_trivial_usage \
- "[OPTION] FILE..."
+ "[OPTIONS] FILE..."
#define stat_full_usage "\n\n" \
"Display file (default) or filesystem status\n" \
"\nOptions:" \
) \
#define strings_trivial_usage \
- "[-afo] [-n length] [file...]"
+ "[-afo] [-n LEN] [FILE]..."
#define strings_full_usage "\n\n" \
"Display printable strings in a binary file\n" \
"\nOptions:" \
"\n -a Scan whole file (default)" \
"\n -f Precede strings with filenames" \
- "\n -n N At least N characters form a string (default 4)" \
+ "\n -n LEN At least LEN characters form a string (default 4)" \
"\n -o Precede strings with decimal offsets" \
#define stty_trivial_usage \
"\n [SETTING] See manpage" \
#define su_trivial_usage \
- "[OPTION]... [-] [username]"
+ "[OPTIONS] [-] [username]"
#define su_full_usage "\n\n" \
"Change user id or become root\n" \
"\nOptions:" \
"\n -p, -m Preserve environment" \
- "\n -c Command to pass to 'sh -c'" \
- "\n -s Shell to use instead of default shell" \
+ "\n -c CMD Command to pass to 'sh -c'" \
+ "\n -s SH Shell to use instead of default shell" \
#define sulogin_trivial_usage \
- "[OPTION]... [tty-device]"
+ "[OPTIONS] [TTY]"
#define sulogin_full_usage "\n\n" \
"Single user login\n" \
"\nOptions:" \
- "\n -t Timeout" \
+ "\n -t N Timeout" \
#define sum_trivial_usage \
- "[rs] [files...]"
+ "[-rs] [FILE]..."
#define sum_full_usage "\n\n" \
"Checksum and count the blocks in a file\n" \
"\nOptions:" \
"up: if service isn't running, start it. If service stops, restart it\n" \
"once: like 'up', but if service stops, don't restart it\n" \
"down: send TERM and CONT signals. If ./run exits, start ./finish\n" \
- " if it exists. After it stops, do not restart service\n" \
+ " if it exists. After it stops, don't restart service\n" \
"exit: send TERM and CONT signals to service and log service. If they exit,\n" \
" runsv exits too\n" \
"pause, cont, hup, alarm, interrupt, quit, 1, 2, term, kill: send\n" \
#define svlogd_trivial_usage \
"[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
#define svlogd_full_usage "\n\n" \
- "Continuously read log data from standard input, optionally " \
- "filter log messages, and write the data to one or more automatically " \
+ "Continuously read log data from standard input, optionally\n" \
+ "filter log messages, and write the data to one or more automatically\n" \
"rotated logs" \
#define swapoff_trivial_usage \
) \
#define switch_root_trivial_usage \
- "[-c /dev/console] NEW_ROOT NEW_INIT [ARG...]"
+ "[-c /dev/console] NEW_ROOT NEW_INIT [ARGS]"
#define switch_root_full_usage "\n\n" \
"Free initramfs and switch to another root fs:\n" \
"chroot to NEW_ROOT, delete all in /, move NEW_ROOT to /,\n" \
#define sync_trivial_usage \
""
#define sync_full_usage "\n\n" \
- "Write all buffered filesystem blocks to disk"
+ "Write all buffered blocks to disk"
+
+#define fsync_trivial_usage \
+ "[OPTIONS] FILE..."
+#define fsync_full_usage \
+ "Write files' buffered blocks to disk\n" \
+ "\nOptions:" \
+ "\n -d Avoid syncing metadata"
#define sysctl_trivial_usage \
- "[OPTIONS]... [VALUE]..."
+ "[OPTIONS] [VALUE]..."
#define sysctl_full_usage "\n\n" \
"Configure kernel parameters at runtime\n" \
"\nOptions:" \
"sysctl [-n] [-e] -A\n"
#define syslogd_trivial_usage \
- "[OPTION]..."
+ "[OPTIONS]"
#define syslogd_full_usage "\n\n" \
"System logging utility.\n" \
"Note that this version of syslogd ignores /etc/syslog.conf.\n" \
"\nOptions:" \
"\n -n Run in foreground" \
- "\n -O FILE Log to given file (default=/var/log/messages)" \
+ "\n -O FILE Log to given file (default:/var/log/messages)" \
"\n -l n Set local log level" \
"\n -S Smaller logging output" \
IF_FEATURE_ROTATE_LOGFILE( \
- "\n -s SIZE Max size (KB) before rotate (default=200KB, 0=off)" \
- "\n -b NUM Number of rotated logs to keep (default=1, max=99, 0=purge)") \
+ "\n -s SIZE Max size (KB) before rotate (default:200KB, 0=off)" \
+ "\n -b NUM Number of rotated logs to keep (default:1, max=99, 0=purge)") \
IF_FEATURE_REMOTE_LOG( \
"\n -R HOST[:PORT] Log to IP or hostname on PORT (default PORT=514/UDP)" \
"\n -L Log locally and via network (default is network only if -R)") \
IF_FEATURE_IPC_SYSLOG( \
"\n -C[size(KiB)] Log to shared mem buffer (read it using logread)") \
/* NB: -Csize shouldn't have space (because size is optional) */
-/* "\n -m MIN Minutes between MARK lines (default=20, 0=off)" */
+/* "\n -m MIN Minutes between MARK lines (default:20, 0=off)" */
#define syslogd_example_usage \
"$ syslogd -R masterlog:514\n" \
#define tac_trivial_usage \
"[FILE]..."
#define tac_full_usage "\n\n" \
- "Concatenate FILE(s) and print them in reverse"
+ "Concatenate FILEs and print them in reverse"
#define tail_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define tail_full_usage "\n\n" \
- "Print 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" \
+ "Print last 10 lines of each FILE (or standard input) to standard output.\n" \
+ "With more than one FILE, precede each with a header giving the file name.\n" \
"\nOptions:" \
IF_FEATURE_FANCY_TAIL( \
- "\n -c N[kbm] Output the last N bytes") \
+ "\n -c N[kbm] Output last N bytes") \
"\n -n N[kbm] Print last N lines instead of last 10" \
"\n -f Output data as the file grows" \
IF_FEATURE_FANCY_TAIL( \
IF_FEATURE_SEAMLESS_BZ2("j") IF_FEATURE_SEAMLESS_LZMA("a") \
IF_FEATURE_SEAMLESS_Z("Z") "xtvO] " \
IF_FEATURE_TAR_FROM("[-X FILE] ") \
- "[-f TARFILE] [-C DIR] [FILE(s)]..."
+ "[-f TARFILE] [-C DIR] [FILE]..."
#define tar_full_usage "\n\n" \
- "Create, extract, or list files from a tar file\n" \
+ IF_FEATURE_TAR_CREATE("Create, extract, ") \
+ IF_NOT_FEATURE_TAR_CREATE("Extract ") \
+ "or list files from a tar file\n" \
"\nOptions:" \
IF_FEATURE_TAR_CREATE( \
"\n c Create") \
"$ tar -cf /tmp/tarball.tar /usr/local\n"
#define taskset_trivial_usage \
- "[-p] [mask] [pid | command [arg]...]"
+ "[-p] [MASK] [PID | PROG [ARGS]]"
#define taskset_full_usage "\n\n" \
"Set or get CPU affinity\n" \
"\nOptions:" \
"pid 1's current affinity mask: 3\n"
#define tee_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define tee_full_usage "\n\n" \
"Copy standard input to each FILE, and also to standard output\n" \
"\nOptions:" \
- "\n -a Append to the given FILEs, do not overwrite" \
+ "\n -a Append to the given FILEs, don't overwrite" \
"\n -i Ignore interrupt signals (SIGINT)" \
#define tee_example_usage \
#endif
#define telnetd_trivial_usage \
- "[OPTION]"
+ "[OPTIONS]"
#define telnetd_full_usage "\n\n" \
"Handle incoming telnet connections" \
IF_NOT_FEATURE_TELNETD_STANDALONE(" via inetd") "\n" \
"\nOptions:" \
"\n -l LOGIN Exec LOGIN on connect" \
- "\n -f issue_file Display issue_file instead of /etc/issue" \
+ "\n -f ISSUE_FILE Display ISSUE_FILE instead of /etc/issue" \
"\n -K Close connection as soon as login exits" \
"\n (normally wait until all programs close slave pty)" \
IF_FEATURE_TELNETD_STANDALONE( \
"\n -p PORT Port to listen on" \
- "\n -b ADDR Address to bind to" \
+ "\n -b ADDR[:PORT] Address to bind to" \
"\n -F Run in foreground" \
- "\n -i Run as inetd subservice" \
+ "\n -i Run as inetd service" \
+ IF_FEATURE_TELNETD_INETD_WAIT( \
+ "\n -w SEC Run as inetd service in wait mode, linger time SEC" \
+ "\n -S Log to syslog (implied by -i or without -F and -w)" \
+ ) \
)
/* "test --help" does not print help (POSIX compat), only "[ --help" does.
"filter show [ dev STRING ] [ root | parent CLASSID ]"
#define tcpsvd_trivial_usage \
- "[-hEv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] ip port prog..."
+ "[-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..." */
+/* "[-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 "\n\n" \
- "Create TCP socket, bind it to ip:port and listen\n" \
+ "Create TCP socket, bind to IP:PORT and listen\n" \
"for incoming connection. Run PROG for each connection.\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" \
+ "\n IP IP to listen on. '0' = all" \
+ "\n PORT Port to listen on" \
+ "\n PROG [ARGS] Program to run" \
+ "\n -l NAME Local hostname (else looks up local hostname in DNS)" \
+ "\n -u USER[:GRP] 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 Don't set up environment variables" \
+ "\n -v Verbose" \
#define udpsvd_trivial_usage \
- "[-hEv] [-c n] [-u user] [-l name] ip port prog"
+ "[-hEv] [-c N] [-u USER] [-l NAME] IP PORT PROG"
#define udpsvd_full_usage "\n\n" \
- "Create UDP socket, bind it to ip:port and wait\n" \
+ "Create UDP socket, bind to IP:PORT and wait\n" \
"for incoming packets. Run PROG for each packet,\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" \
+ "redirecting all further packets with same peer ip:port to it.\n" \
+ "\n IP IP to listen on. '0' = all" \
+ "\n PORT Port to listen on" \
+ "\n PROG [ARGS] Program to run" \
+ "\n -l NAME Local hostname (else looks up local hostname in DNS)" \
+ "\n -u USER[:GRP] Change to user/group after bind" \
+ "\n -c N Handle up to N connections simultaneously" \
+ "\n -h Look up peer's hostname" \
+ "\n -E Don't set up environment variables" \
+ "\n -v Verbose" \
#define tftp_trivial_usage \
- "[OPTION]... HOST [PORT]"
+ "[OPTIONS] HOST [PORT]"
#define tftp_full_usage "\n\n" \
"Transfer a file from/to tftp server\n" \
"\nOptions:" \
#define tftpd_trivial_usage \
"[-cr] [-u USER] [DIR]"
#define tftpd_full_usage "\n\n" \
- "Transfer a file on tftp client's request.\n" \
+ "Transfer a file on tftp client's request\n" \
"\n" \
"tftpd should be used as an inetd service.\n" \
"tftpd's line for inetd.conf:\n" \
"\n -u Access files as USER" \
#define time_trivial_usage \
- "[OPTION]... COMMAND [ARGS...]"
+ "[OPTIONS] PROG [ARGS]"
#define time_full_usage "\n\n" \
- "Run the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \
- "COMMAND's resource usage information is displayed.\n" \
+ "Run PROG. When it finishes, its resource usage is displayed.\n" \
"\nOptions:" \
"\n -v Verbose" \
"Defaults: SECS: 10, SIG: TERM." \
#define top_trivial_usage \
- "[-b] [-nCOUNT] [-dSECONDS]"
+ "[-b] [-nCOUNT] [-dSECONDS]" IF_FEATURE_TOPMEM(" [-m]")
#define top_full_usage "\n\n" \
"Provide a view of process activity in real time.\n" \
"Read the status of all processes from /proc each SECONDS\n" \
"and show the status for however many processes will fit on the screen." \
#define touch_trivial_usage \
- "[-c] FILE [FILE...]"
+ "[-c] [-d DATE] FILE [FILE]..."
#define touch_full_usage "\n\n" \
"Update the last-modified date on the given FILE[s]\n" \
"\nOptions:" \
- "\n -c Do not create any files" \
+ "\n -c Don't create files" \
+ "\n -d DT Date/time to use" \
#define touch_example_usage \
"$ ls -l /tmp/foo\n" \
"\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 (default 33434)" \
"\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)" \
#define tunctl_trivial_usage \
"[-f device] ([-t name] | -d name)" IF_FEATURE_TUNCTL_UG(" [-u owner] [-g group] [-b]")
#define tunctl_full_usage "\n\n" \
- "Create or delete tun interfaces" \
+ "Create or delete tun interfaces\n" \
"\nOptions:" \
"\n -f name tun device (/dev/net/tun)" \
"\n -t name Create iface 'name'" \
"\n -d name Delete iface 'name'" \
-IF_FEATURE_TUNCTL_UG( \
+ IF_FEATURE_TUNCTL_UG( \
"\n -u owner Set iface owner" \
"\n -g group Set iface group" \
"\n -b Brief output" \
-)
+ )
#define tunctl_example_usage \
"# tunctl\n" \
"# tunctl -d tun0\n"
#define tune2fs_trivial_usage \
- "[-c max-mounts-count] [-e errors-behavior] [-g group] " \
- "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " \
- "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " \
- "[-r reserved-blocks-count] [-u user] [-C mount-count] " \
- "[-L volume-label] [-M last-mounted-dir] [-O [^]feature[,...]] " \
- "[-T last-check-time] [-U UUID] device"
+/* "[-c max-mounts-count] [-e errors-behavior] [-g group] " */ \
+/* "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " */ \
+/* "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " */ \
+/* "[-r reserved-blocks-count] [-u user] [-C mount-count] " */ \
+ "[-L LABEL] " \
+/* "[-M last-mounted-dir] [-O [^]feature[,...]] " */ \
+/* "[-T last-check-time] [-U UUID] " */ \
+ "BLOCKDEV"
#define tune2fs_full_usage "\n\n" \
"Adjust filesystem options on ext[23] filesystems"
"[-Cfbnqtvo] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n" \
" [-p pidfile] [-r IP] [-s script] [-O dhcp-option]..." IF_FEATURE_UDHCP_PORT(" [-P N]")
#define udhcpc_full_usage "\n\n" \
- IF_GETOPT_LONG( \
+ IF_LONG_OPTS( \
" -V,--vendorclass=CLASSID Vendor class identifier" \
"\n -i,--interface=INTERFACE Interface to use (default eth0)" \
"\n -H,-h,--hostname=HOSTNAME Client hostname" \
"\n -p,--pidfile=file Create pidfile" \
"\n -r,--request=IP IP address to request" \
"\n -s,--script=file Run file at DHCP events (default "CONFIG_UDHCPC_DEFAULT_SCRIPT")" \
- "\n -t,--retries=N Send up to N request packets" \
- "\n -T,--timeout=N Try to get a lease for N seconds (default 3)" \
+ "\n -t,--retries=N Send up to N discover packets" \
+ "\n -T,--timeout=N Pause between packets (default 3 seconds)" \
"\n -A,--tryagain=N Wait N seconds (default 20) after failure" \
"\n -O,--request-option=OPT Request DHCP option OPT (cumulative)" \
- "\n -o,--no-default-options Do not request any options (unless -O is also given)" \
+ "\n -o,--no-default-options Don't request any options (unless -O is also given)" \
"\n -f,--foreground Run in foreground" \
USE_FOR_MMU( \
"\n -b,--background Background if lease is not immediately obtained" \
"\n -a,--arping Use arping to validate offered address" \
) \
) \
- IF_NOT_GETOPT_LONG( \
+ IF_NOT_LONG_OPTS( \
" -V CLASSID Vendor class identifier" \
"\n -i INTERFACE Interface to use (default: eth0)" \
"\n -H,-h HOSTNAME Client hostname" \
"\n -T N Try to get a lease for N seconds (default 3)" \
"\n -A N Wait N seconds (default 20) after failure" \
"\n -O OPT Request DHCP option OPT (cumulative)" \
- "\n -o Do not request any options (unless -O is also given)" \
+ "\n -o Don't request any options (unless -O is also given)" \
"\n -f Run in foreground" \
USE_FOR_MMU( \
"\n -b Background if lease is not immediately obtained" \
#define uname_trivial_usage \
"[-amnrspv]"
#define uname_full_usage "\n\n" \
- "Print system information.\n" \
+ "Print system information\n" \
"\nOptions:" \
"\n -a Print all" \
"\n -m The machine (hardware) type" \
#define unexpand_trivial_usage \
"[-f][-a][-t NUM] [FILE|-]"
#define unexpand_full_usage "\n\n" \
- "Convert spaces to tabs, writing to standard output.\n" \
+ "Convert spaces to tabs, writing to standard output\n" \
"\nOptions:" \
IF_FEATURE_UNEXPAND_LONG_OPTIONS( \
"\n -a,--all Convert all blanks" \
"b\n" \
"c\n"
-#define unix2dos_trivial_usage \
- "[option] [FILE]"
-#define unix2dos_full_usage "\n\n" \
- "Convert FILE from unix to dos format.\n" \
- "When no file is given, use stdin/stdout.\n" \
- "\nOptions:" \
- "\n -u dos2unix" \
- "\n -d unix2dos" \
-
#define unzip_trivial_usage \
"[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]"
#define unzip_full_usage "\n\n" \
"$\n"
#define vconfig_trivial_usage \
- "COMMAND [OPTIONS]..."
+ "COMMAND [OPTIONS]"
#define vconfig_full_usage "\n\n" \
"Create and remove virtual ethernet devices\n" \
"\nOptions:" \
"\n set_name_type [name-type]" \
#define vi_trivial_usage \
- "[OPTION] [FILE]..."
+ "[OPTIONS] [FILE]..."
#define vi_full_usage "\n\n" \
"Edit FILE\n" \
"\nOptions:" \
IF_FEATURE_VI_COLON( \
"\n -c Initial command to run ($EXINIT also available)") \
IF_FEATURE_VI_READONLY( \
- "\n -R Read-only - do not write to the file") \
+ "\n -R Read-only - don't write to the file") \
"\n -H Short help regarding available features" \
#define vlock_trivial_usage \
"\nOptions:" \
"\n -a Lock all VTs" \
+#define volname_trivial_usage \
+ "[DEVICE]"
+#define volname_full_usage "\n\n" \
+ "Show CD volume name of the DEVICE (default /dev/cdrom)"
+
#define watch_trivial_usage \
- "[-n seconds] [-t] COMMAND..."
+ "[-n seconds] [-t] PROG [ARGS]"
#define watch_full_usage "\n\n" \
- "Execute a program periodically\n" \
+ "Run PROG periodically\n" \
"\nOptions:" \
"\n -n Loop period in seconds (default 2)" \
"\n -t Don't print header" \
"\nUse 500ms to specify period in milliseconds" \
#define wc_trivial_usage \
- "[OPTION]... [FILE]..."
+ "[OPTIONS] [FILE]..."
#define wc_full_usage "\n\n" \
"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.\n" \
"\n -Y Use proxy ('on' or 'off')" \
#define which_trivial_usage \
- "[COMMAND...]"
+ "[COMMAND]..."
#define which_full_usage "\n\n" \
"Locate a COMMAND"
#define which_example_usage \
"Print the user name associated with the current effective user id"
#define xargs_trivial_usage \
- "[OPTIONS] [COMMAND] [ARGS...]"
+ "[OPTIONS] [PROG [ARGS]]"
#define xargs_full_usage "\n\n" \
- "Execute COMMAND on every item given by standard input\n" \
+ "Run PROG on every item given by standard input\n" \
"\nOptions:" \
IF_FEATURE_XARGS_SUPPORT_CONFIRMATION( \
"\n -p Ask user whether to run each command") \
- "\n -r Do not run command if input is empty" \
+ "\n -r Don't run command if input is empty" \
IF_FEATURE_XARGS_SUPPORT_ZERO_TERM( \
"\n -0 Input is separated by NUL characters") \
"\n -t Print the command on stderr before execution" \
"\n -e[STR] STR stops input processing" \
- "\n -n N Pass no more than N args to COMMAND" \
+ "\n -n N Pass no more than N args to PROG" \
"\n -s N Pass command line of no more than N bytes" \
IF_FEATURE_XARGS_SUPPORT_TERMOPT( \
"\n -x Exit if size is exceeded") \
"$ find . -name '*.c' -print | xargs rm\n"
#define yes_trivial_usage \
- "[OPTION]... [STRING]..."
+ "[OPTIONS] [STRING]"
#define yes_full_usage "\n\n" \
- "Repeatedly output a line with all specified STRING(s), or 'y'"
+ "Repeatedly output a line with STRING, or 'y'"
#define zcat_trivial_usage \
"FILE"
"Uncompress to stdout"
#define zcip_trivial_usage \
- "[OPTIONS] ifname script"
+ "[OPTIONS] IFACE SCRIPT"
#define zcip_full_usage "\n\n" \
"Manage a ZeroConf IPv4 link-local address\n" \
"\nOptions:" \