fix/shorten some usage strings

This commit is contained in:
Denis Vlasenko 2006-12-17 17:27:56 +00:00
parent 10f7dd1ea1
commit 7cdc54ff59

View File

@ -520,14 +520,15 @@ USE_FEATURE_DATE_ISOFMT( \
USE_DEVFSD_FG_NP("[-fg][-np]" )
#define devfsd_full_usage \
"Optional daemon for managing devfs permissions and old device name symlinks.\n" \
"\nOptions:\n" \
" mntpnt The mount point where devfs is mounted.\n\n" \
" -v Print the protocol version numbers for devfsd\n" \
" and the kernel-side protocol version and exits." \
USE_DEVFSD_FG_NP( "\n\n -fg Run the daemon in the foreground.\n\n" \
" -np Exit after parsing the configuration file\n" \
" and processing synthetic REGISTER events.\n" \
" Do not poll for events.")
"\nOptions:" \
"\n mntpnt The mount point where devfs is mounted." \
"\n -v Print the protocol version numbers for devfsd." \
"\n and the kernel-side protocol version and exits." \
USE_DEVFSD_FG_NP( \
"\n -fg Run the daemon in the foreground." \
"\n -np Exit after parsing the configuration file" \
"\n and processing synthetic REGISTER events." \
"\n Do not poll for events.")
#define df_trivial_usage \
"[-" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILESYSTEM ...]"
@ -538,7 +539,8 @@ USE_FEATURE_DATE_ISOFMT( \
"\n -h print sizes in human readable format (e.g., 1K 243M 2G )\n" \
" -m print sizes in megabytes\n" \
" -k print sizes in kilobytes(default)") \
SKIP_FEATURE_HUMAN_READABLE("\n -k ignored")
SKIP_FEATURE_HUMAN_READABLE( \
"\n -k ignored")
#define df_example_usage \
"$ df\n" \
"Filesystem 1k-blocks Used Available Use% Mounted on\n" \
@ -789,8 +791,7 @@ USE_FEATURE_DATE_ISOFMT( \
" STRING : REGEXP anchored pattern match of REGEXP in STRING\n" \
" match STRING REGEXP same as STRING : REGEXP\n" \
" substr STRING POS LENGTH substring of STRING, POS counted from 1\n" \
" index STRING CHARS index in STRING where any CHARS is found,\n" \
" or 0\n" \
" index STRING CHARS index in STRING where any CHARS is found, or 0\n" \
" length STRING length of STRING\n" \
" quote TOKEN interpret TOKEN as a string, even if\n" \
" it is a keyword like 'match' or an\n" \
@ -852,7 +853,7 @@ USE_FEATURE_DATE_ISOFMT( \
" -l List partition table(s)\n" \
" -u Give Start and End in sector (instead of cylinder) units\n" \
" -s PARTITION Give partition size(s) in blocks\n" \
" -b 2048: (for certain MO disks) use 2048-byte sectors\n" \
" -b 2048 (for certain MO disks) use 2048-byte sectors\n" \
" -C CYLINDERS Set the number of cylinders\n" \
" -H HEADS Set the number of heads\n" \
" -S SECTORS Set the number of sectors\n" \
@ -1059,10 +1060,14 @@ USE_FEATURE_DATE_ISOFMT( \
" -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" \
USE_FEATURE_GREP_EGREP_ALIAS("\n -E PATTERN is an extended regular expression") \
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")
USE_FEATURE_GREP_EGREP_ALIAS( \
"\n -E PATTERN is an extended regular expression") \
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")
#define grep_example_usage \
"$ grep root /etc/passwd\n" \
@ -1113,7 +1118,8 @@ USE_FEATURE_DATE_ISOFMT( \
#define hdparm_trivial_usage \
"[options] [device] .."
#define hdparm_full_usage \
USE_FEATURE_HDPARM_GET_IDENTITY(" If no device name is specified try to read from stdin.\n") \
USE_FEATURE_HDPARM_GET_IDENTITY( \
" If no device name is specified try to read from stdin.\n") \
"\nOptions:\n" \
" -a get/set fs readahead\n" \
" -A set drive read-lookahead flag (0/1)\n" \
@ -1121,13 +1127,16 @@ USE_FEATURE_DATE_ISOFMT( \
" -B set Advanced Power Management setting (1-255)\n" \
" -c get/set IDE 32-bit IO setting\n" \
" -C check IDE power mode status\n" \
USE_FEATURE_HDPARM_HDIO_GETSET_DMA(" -d get/set using_dma flag\n") \
USE_FEATURE_HDPARM_HDIO_GETSET_DMA( \
" -d get/set using_dma flag\n") \
" -D enable/disable drive defect-mgmt\n" \
" -f flush buffer cache for device on exit\n" \
" -g display drive geometry\n" \
" -h display terse usage information\n" \
USE_FEATURE_HDPARM_GET_IDENTITY(" -i display drive identification\n") \
USE_FEATURE_HDPARM_GET_IDENTITY(" -I detailed/current information directly from drive\n") \
USE_FEATURE_HDPARM_GET_IDENTITY( \
" -i display drive identification\n") \
USE_FEATURE_HDPARM_GET_IDENTITY( \
" -I detailed/current information directly from drive\n") \
" -k get/set keep_settings_over_reset flag (0/1)\n" \
" -K set drive keep_features_over_reset flag (0/1)\n" \
" -L set drive doorlock (0/1) (removable harddisks only)\n" \
@ -1138,17 +1147,21 @@ USE_FEATURE_DATE_ISOFMT( \
" -q change next setting quietly\n" \
" -Q get/set DMA tagged-queuing depth (if supported)\n" \
" -r get/set readonly flag (DANGEROUS to set)\n" \
USE_FEATURE_HDPARM_HDIO_SCAN_HWIF(" -R register an IDE interface (DANGEROUS)\n") \
USE_FEATURE_HDPARM_HDIO_SCAN_HWIF( \
" -R register an IDE interface (DANGEROUS)\n") \
" -S set standby (spindown) timeout\n" \
" -t perform device read timings\n" \
" -T perform cache read timings\n" \
" -u get/set unmaskirq flag (0/1)\n" \
USE_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF(" -U un-register an IDE interface (DANGEROUS)\n") \
USE_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF( \
" -U un-register an IDE interface (DANGEROUS)\n") \
" -v defaults; same as -mcudkrag for IDE drives\n" \
" -V display program version and exit immediately\n" \
USE_FEATURE_HDPARM_HDIO_DRIVE_RESET(" -w perform device reset (DANGEROUS)\n") \
USE_FEATURE_HDPARM_HDIO_DRIVE_RESET( \
" -w perform device reset (DANGEROUS)\n") \
" -W set drive write-caching flag (0/1) (DANGEROUS)\n" \
USE_FEATURE_HDPARM_HDIO_TRISTATE_HWIF(" -x tristate device for hotswap (0/1) (DANGEROUS)\n") \
USE_FEATURE_HDPARM_HDIO_TRISTATE_HWIF( \
" -x tristate device for hotswap (0/1) (DANGEROUS)\n") \
" -X set IDE xfer mode (DANGEROUS)\n" \
" -y put IDE drive in standby mode\n" \
" -Y put IDE drive to sleep\n" \
@ -1161,12 +1174,12 @@ USE_FEATURE_DATE_ISOFMT( \
"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\n" \
"Options:\n" \
" -n NUM Print first NUM lines instead of first 10" \
"Options:" \
"\n -n NUM Print first NUM lines instead of first 10" \
USE_FEATURE_FANCY_HEAD( \
"\n -c NUM output the first NUM bytes\n" \
" -q never output headers giving file names\n" \
" -v always output headers giving file names" )
"\n -c NUM output the first NUM bytes" \
"\n -q never output headers giving file names" \
"\n -v always output headers giving file names")
#define head_example_usage \
"$ head -n 2 /etc/passwd\n" \
"root:x:0:0:root:/root:/bin/bash\n" \
@ -1226,9 +1239,12 @@ USE_FEATURE_DATE_ISOFMT( \
" -p PORT Server port (default 80)\n" \
" -i Assume that we are started from inetd\n" \
" -f Do not daemonize\n" \
USE_FEATURE_HTTPD_SETUID(" -u USER[:GRP] Set uid/gid after binding to port\n") \
USE_FEATURE_HTTPD_BASIC_AUTH(" -r REALM Authentication Realm for Basic Authentication\n") \
USE_FEATURE_HTTPD_AUTH_MD5(" -m PASS Crypt PASS with md5 algorithm\n") \
USE_FEATURE_HTTPD_SETUID( \
" -u USER[:GRP] Set uid/gid after binding to port\n") \
USE_FEATURE_HTTPD_BASIC_AUTH( \
" -r REALM Authentication Realm for Basic Authentication\n") \
USE_FEATURE_HTTPD_AUTH_MD5( \
" -m PASS Crypt PASS with md5 algorithm\n") \
" -h HOME Specifies http HOME directory (default ./)\n" \
" -e STRING HTML encode STRING\n" \
" -d STRING URL decode STRING"
@ -1249,7 +1265,8 @@ USE_FEATURE_DATE_ISOFMT( \
#define id_full_usage \
"Print information for USERNAME or the current user\n\n" \
"Options:\n" \
USE_SELINUX(" -c prints only the security context\n") \
USE_SELINUX( \
" -c 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" \
@ -1263,16 +1280,19 @@ USE_FEATURE_DATE_ISOFMT( \
#define ifconfig_full_usage \
"configure a network interface\n\n" \
"Options:\n" \
USE_FEATURE_IPV6(" [add <address>[/<prefixlen>]]\n") \
USE_FEATURE_IPV6(" [del <address>[/<prefixlen>]]\n") \
USE_FEATURE_IPV6( \
" [add <address>[/<prefixlen>]]\n") \
USE_FEATURE_IPV6( \
" [del <address>[/<prefixlen>]]\n") \
" [[-]broadcast [<address>]] [[-]pointopoint [<address>]]\n" \
" [netmask <address>] [dstaddr <address>]\n" \
USE_FEATURE_IFCONFIG_SLIP(" [outfill <NN>] [keepalive <NN>]\n") \
" " USE_FEATURE_IFCONFIG_HW("[hw ether <address>] ") \
"[metric <NN>] [mtu <NN>]\n" \
USE_FEATURE_IFCONFIG_SLIP( \
" [outfill <NN>] [keepalive <NN>]\n") \
" " USE_FEATURE_IFCONFIG_HW("[hw ether <address>] ") "[metric <NN>] [mtu <NN>]\n" \
" [[-]trailers] [[-]arp] [[-]allmulti]\n" \
" [multicast] [[-]promisc] [txqueuelen <NN>] [[-]dynamic]\n" \
USE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ(" [mem_start <NN>] [io_addr <NN>] [irq <NN>]\n") \
USE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ( \
" [mem_start <NN>] [io_addr <NN>] [irq <NN>]\n") \
" [up|down] ..."
#define ifup_trivial_usage \
@ -1453,7 +1473,8 @@ USE_FEATURE_DATE_ISOFMT( \
" -v verbose output\n" \
" -q quiet output\n" \
" -L Lock to prevent simultaneous loads of a module\n" \
USE_FEATURE_INSMOD_LOAD_MAP(" -m Output load map to stdout\n") \
USE_FEATURE_INSMOD_LOAD_MAP( \
" -m Output load map to stdout\n") \
" -o NAME Set internal module name to NAME\n" \
" -x do not export externs"
@ -1732,36 +1753,53 @@ USE_FEATURE_DATE_ISOFMT( \
USE_SELINUX("K") "] [filenames...]"
#define ls_full_usage \
"List directory contents\n\n" \
"Options:\n" \
" -1 list files in a single column\n" \
" -A do not list implied . and ..\n" \
" -a do not hide entries starting with .\n" \
" -C list entries by columns\n" \
USE_FEATURE_LS_TIMESTAMPS(" -c with -l: show ctime\n") \
USE_FEATURE_LS_COLOR(" --color[={always,never,auto}] to control coloring\n") \
" -d list directory entries instead of contents\n" \
USE_FEATURE_LS_TIMESTAMPS(" -e list both full date and full time\n") \
USE_FEATURE_LS_FILETYPES(" -F append indicator (one of */=@|) to entries\n") \
" -i list the i-node for each file\n" \
" -l use a long listing format\n" \
" -n list numeric UIDs and GIDs instead of names\n" \
USE_FEATURE_LS_FILETYPES(" -p append indicator (one of /=@|) to entries\n") \
USE_FEATURE_LS_FOLLOWLINKS(" -L list entries pointed to by symbolic links\n") \
USE_FEATURE_LS_RECURSIVE(" -R list subdirectories recursively\n") \
USE_FEATURE_LS_SORTFILES(" -r sort the listing in reverse order\n") \
USE_FEATURE_LS_SORTFILES(" -S sort the listing by file size\n") \
" -s list the size of each file, in blocks\n" \
USE_FEATURE_AUTOWIDTH(" -T NUM assume Tabstop every NUM columns\n") \
USE_FEATURE_LS_TIMESTAMPS(" -t with -l: show modification time\n") \
USE_FEATURE_LS_TIMESTAMPS(" -u with -l: show access time\n") \
USE_FEATURE_LS_SORTFILES(" -v sort the listing by version\n") \
USE_FEATURE_AUTOWIDTH(" -w NUM assume the terminal is NUM columns wide\n") \
" -x list entries by lines instead of by columns\n" \
USE_FEATURE_LS_SORTFILES(" -X sort the listing by extension\n") \
"Options:" \
"\n -1 list files in a single column" \
"\n -A do not list implied . and .." \
"\n -a do not hide entries starting with ." \
"\n -C list entries by columns" \
USE_FEATURE_LS_TIMESTAMPS( \
"\n -c with -l: show ctime") \
USE_FEATURE_LS_COLOR( \
"\n --color[={always,never,auto}] control coloring") \
"\n -d list directory entries instead of contents" \
USE_FEATURE_LS_TIMESTAMPS( \
"\n -e list both full date and full time") \
USE_FEATURE_LS_FILETYPES( \
"\n -F append indicator (one of */=@|) to entries") \
"\n -i list the i-node for each file" \
"\n -l use a long listing format" \
"\n -n list numeric UIDs and GIDs instead of names" \
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") \
USE_FEATURE_LS_RECURSIVE( \
"\n -R list subdirectories recursively") \
USE_FEATURE_LS_SORTFILES( \
"\n -r sort the listing in reverse order") \
USE_FEATURE_LS_SORTFILES( \
"\n -S sort the listing by file size") \
"\n -s list the size of each file, in blocks" \
USE_FEATURE_AUTOWIDTH( \
"\n -T NUM assume Tabstop every NUM columns") \
USE_FEATURE_LS_TIMESTAMPS( \
"\n -t with -l: show modification time") \
USE_FEATURE_LS_TIMESTAMPS( \
"\n -u with -l: show access time") \
USE_FEATURE_LS_SORTFILES( \
"\n -v sort the listing by version") \
USE_FEATURE_AUTOWIDTH( \
"\n -w NUM assume the terminal is NUM columns wide") \
"\n -x list entries by lines instead of by columns" \
USE_FEATURE_LS_SORTFILES( \
"\n -X sort the listing by extension") \
USE_FEATURE_HUMAN_READABLE( \
" -h print sizes in human readable format (e.g., 1K 243M 2G )\n") \
USE_SELINUX(" -k print security context\n") \
USE_SELINUX(" -K print security context in long format\n")
"\n -h print sizes in human readable format (e.g., 1K 243M 2G)") \
USE_SELINUX( \
"\n -k print security context") \
USE_SELINUX( \
"\n -K print security context in long format")
#define lsattr_trivial_usage \
"[-Radlv] [files...]"
@ -1975,8 +2013,7 @@ USE_FEATURE_MDEV_CONFIG( \
"Options:\n" \
" -c Check for read-ability\n" \
" -v0 Make version 0 swap [max 128 Megs]\n" \
" -v1 Make version 1 swap [big!] (default for kernels >\n" \
" 2.1.117)\n" \
" -v1 Make version 1 swap [big!] (default for kernels > 2.1.117)\n" \
" block-count Number of block to use (default is entire partition)"
#define mktemp_trivial_usage \
@ -2179,15 +2216,16 @@ USE_FEATURE_MDEV_CONFIG( \
"Netcat opens a pipe to IP:port" USE_NC_EXTRA(" or file") \
NC_OPTIONS_STR \
USE_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" \
" -f file use file (ala /dev/ttyS0) instead of network" \
"\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" \
) \
USE_NC_SERVER( \
"\n -l listen mode, for inbound connects\n" \
USE_NC_EXTRA(" (use -l twice with -e for persistent server)\n") \
" -p PORT local port number" \
"\n -l listen mode, for inbound connects" \
USE_NC_EXTRA( \
"\n (use -l twice with -e for persistent server)") \
"\n -p PORT local port number" \
)
#define nc_notes_usage "" \
@ -2293,7 +2331,7 @@ USE_FEATURE_MDEV_CONFIG( \
"changes the password for the current user.\n" \
"Options:\n" \
" -a Define which algorithm shall be used for the password\n" \
" (Choices: des, md5, sha1)\n" \
" (Choices: des, md5)\n" /* ", sha1)" */ \
" -d Delete the password for the specified user account\n" \
" -l Locks (disables) the specified user account\n" \
" -u Unlocks (re-enables) the specified user account"
@ -2320,14 +2358,19 @@ USE_FEATURE_MDEV_CONFIG( \
"Lists the PIDs of all processes with names that match the\n" \
"names on the command line.\n" \
USAGE_PIDOF \
USE_FEATURE_PIDOF_SINGLE("\n -s display only a single PID") \
USE_FEATURE_PIDOF_OMIT("\n -o omit given pid.") \
USE_FEATURE_PIDOF_OMIT("\n Use %PPID to omit the parent pid of pidof itself")
USE_FEATURE_PIDOF_SINGLE( \
"\n -s display only a single PID") \
USE_FEATURE_PIDOF_OMIT( \
"\n -o omit given pid.") \
USE_FEATURE_PIDOF_OMIT( \
"\n Use %PPID to omit the parent pid of pidof itself")
#define pidof_example_usage \
"$ pidof init\n" \
"1\n" \
USE_FEATURE_PIDOF_OMIT("$ pidof /bin/sh\n20351 5973 5950\n") \
USE_FEATURE_PIDOF_OMIT("$ pidof /bin/sh -o %PPID\n20351 5950")
USE_FEATURE_PIDOF_OMIT( \
"$ pidof /bin/sh\n20351 5973 5950\n") \
USE_FEATURE_PIDOF_OMIT( \
"$ pidof /bin/sh -o %PPID\n20351 5950")
#ifndef CONFIG_FEATURE_FANCY_PING
#define ping_trivial_usage "host"
@ -2338,9 +2381,9 @@ USE_FEATURE_MDEV_CONFIG( \
#define ping_full_usage \
"Send ICMP ECHO_REQUEST packets to network hosts.\n\n" \
"Options:\n" \
" -c COUNT Send only COUNT pings\n" \
" -c CNT Send only CNT pings\n" \
" -s SIZE Send SIZE data bytes in packets (default=56)\n" \
" -I IPADDR Use IPADDR as source address\n" \
" -I IP Use IP as source address\n" \
" -q Quiet mode, only displays output at start\n" \
" and when finished"
#endif
@ -2362,7 +2405,7 @@ USE_FEATURE_MDEV_CONFIG( \
#define ping6_full_usage \
"Send ICMP ECHO_REQUEST packets to network hosts.\n\n" \
"Options:\n" \
" -c COUNT Send only COUNT pings\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"
@ -2429,8 +2472,10 @@ USE_FEATURE_MDEV_CONFIG( \
#define ps_full_usage \
"Report process status\n" \
USAGE_PS \
USE_SELINUX("\n -c show SE Linux context") \
USE_FEATURE_PS_WIDE("\n w wide output")
USE_SELINUX( \
"\n -c show SE Linux context") \
USE_FEATURE_PS_WIDE( \
"\n w wide output")
#endif /* ENABLE_DESKTOP */
@ -2481,7 +2526,8 @@ USE_FEATURE_MDEV_CONFIG( \
USE_FEATURE_READLINK_FOLLOW("[-f] ") "FILE"
#define readlink_full_usage \
"Displays the value of a symbolic link." \
USE_FEATURE_READLINK_FOLLOW("\n\nOptions:\n" \
USE_FEATURE_READLINK_FOLLOW( \
"\n\nOptions:\n" \
" -f canonicalize by following all symlinks")
#define readprofile_trivial_usage \
@ -2541,7 +2587,7 @@ USE_FEATURE_MDEV_CONFIG( \
"Options:\n" \
" -i always prompt before removing each destination\n" \
" -f remove existing destinations, never prompt\n" \
" -r or -R remove the contents of directories recursively"
" -r,-R remove the contents of directories recursively"
#define rm_example_usage \
"$ rm -rf /tmp/foo\n"
@ -2724,11 +2770,14 @@ USE_FEATURE_MDEV_CONFIG( \
#define sleep_example_usage \
"$ sleep 2\n" \
"[2 second delay results]\n" \
USE_FEATURE_FANCY_SLEEP("$ sleep 1d 3h 22m 8s\n" \
USE_FEATURE_FANCY_SLEEP( \
"$ sleep 1d 3h 22m 8s\n" \
"[98528 second delay results]\n")
#define sort_trivial_usage \
"[-nru" USE_FEATURE_SORT_BIG("gMcszbdfimSTokt] [-o outfile] [-k start[.offset][opts][,end[.offset][opts]] [-t char") "] [FILE]..."
"[-nru" \
USE_FEATURE_SORT_BIG("gMcszbdfimSTokt] [-o outfile] [-k start[.offset][opts][,end[.offset][opts]] [-t char") \
"] [FILE]..."
#define sort_full_usage \
"Sorts lines of text in the specified files\n\n" \
"Options:\n" \
@ -2740,19 +2789,20 @@ USE_FEATURE_MDEV_CONFIG( \
" -g general numerical sort\n" \
" -i ignore unprintable characters\n" \
" -k specify sort key\n" \
" -M sort month\n" \
) \
" -M sort month\n") \
" -n sort numbers\n" \
USE_FEATURE_SORT_BIG( \
" -o output to file\n" \
" -k sort by key\n" \
" -t use key separator other than whitespace\n" \
) \
" -t use key separator other than whitespace\n") \
" -r reverse sort order\n" \
USE_FEATURE_SORT_BIG(" -s stable (don't sort ties alphabetically)\n") \
USE_FEATURE_SORT_BIG( \
" -s stable (don't sort ties alphabetically)\n") \
" -u suppress duplicate lines" \
USE_FEATURE_SORT_BIG("\n -z input terminated by nulls, not newlines\n") \
USE_FEATURE_SORT_BIG(" -mST ignored for GNU compatibility") \
USE_FEATURE_SORT_BIG( \
"\n -z input terminated by nulls, not newlines\n") \
USE_FEATURE_SORT_BIG( \
" -mST ignored for GNU compatibility") \
""
#define sort_example_usage \
"$ echo -e \"e\\nf\\nb\\nd\\nc\\na\" | sort\n" \
@ -2798,12 +2848,13 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
#define stat_full_usage \
"display file (default) or filesystem status.\n\n" \
"Options:\n" \
USE_FEATURE_STAT_FORMAT(" -c fmt use the specified format\n") \
USE_FEATURE_STAT_FORMAT( \
" -c fmt use the specified format\n") \
" -f display filesystem status\n" \
" -L,-l dereference links\n" \
" -t display info in terse form\n" \
" -t display info in terse form" \
USE_FEATURE_STAT_FORMAT( \
"\nValid format sequences for files:\n" \
"\n\nValid format sequences for files:\n" \
" %a Access rights in octal\n" \
" %A Access rights in human readable form\n" \
" %b Number of blocks allocated (see %B)\n" \
@ -2842,7 +2893,7 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
" %s Block size (for faster transfers)\n" \
" %S Fundamental block size (for block counts)\n" \
" %t Type in hex\n" \
" %T Type in human readable form\n" \
" %T Type in human readable form" \
)
#define strings_trivial_usage \
@ -2959,11 +3010,11 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
" -l n Sets the local log level of messages to n\n" \
" -S Make logging output smaller" \
USE_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)") \
USE_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 logging (default is network only)") \
"\n -R HOST[:PORT] Log to IP or hostname on PORT (default PORT=514/UDP)" \
"\n -L Log locally and via network logging (default is network only)") \
USE_FEATURE_IPC_SYSLOG( \
"\n -C [size(KiB)] Log to a circular buffer (read the buffer using logread)")
#define syslogd_example_usage \
@ -2977,10 +3028,12 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
"With more than one FILE, precede each with a header giving the\n" \
"file name. With no FILE, or when FILE is -, read standard input.\n\n" \
"Options:\n" \
USE_FEATURE_FANCY_TAIL(" -c N[kbm] output the last N bytes\n") \
USE_FEATURE_FANCY_TAIL( \
" -c N[kbm] output the last N bytes\n") \
" -n N[kbm] print last N lines instead of last 10\n" \
" -f output data as the file grows" \
USE_FEATURE_FANCY_TAIL( "\n -q never output headers giving file names\n" \
USE_FEATURE_FANCY_TAIL( \
"\n -q never output headers giving file names\n" \
" -s SEC wait SEC seconds between reads with -f\n" \
" -v always output headers giving file names\n\n" \
"If the first character of N (bytes or lines) is a '+', output begins with\n" \
@ -2999,21 +3052,25 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
#define tar_full_usage \
"Create, extract, or list files from a tar file.\n\n" \
"Options:\n" \
USE_FEATURE_TAR_CREATE(" c create\n") \
USE_FEATURE_TAR_CREATE( \
" c create\n") \
" x extract\n" \
" t list\n" \
"\nArchive format selection:\n" \
USE_FEATURE_TAR_GZIP(" z Filter the archive through gzip\n") \
USE_FEATURE_TAR_BZIP2(" j Filter the archive through bzip2\n") \
USE_FEATURE_TAR_LZMA(" a Filter the archive through lzma\n") \
USE_FEATURE_TAR_COMPRESS(" Z Filter the archive through compress\n") \
USE_FEATURE_TAR_GZIP( \
" z Filter the archive through gzip\n") \
USE_FEATURE_TAR_BZIP2( \
" j Filter the archive through bzip2\n") \
USE_FEATURE_TAR_LZMA( \
" a Filter the archive through lzma\n") \
USE_FEATURE_TAR_COMPRESS( \
" Z Filter the archive through compress\n") \
"\nFile selection:\n" \
" f name of TARFILE or \"-\" for stdin\n" \
" O extract to stdout\n" \
USE_FEATURE_TAR_FROM( \
" exclude file to exclude\n" \
" X file with names to exclude\n" \
) \
" X file with names to exclude\n") \
" C change to directory DIR before operation\n" \
" v verbosely list files processed"
#define tar_example_usage \
@ -3252,12 +3309,15 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
"[flags] FILESYSTEM|DIRECTORY"
#define umount_full_usage \
"Unmount file systems\n" \
"\nFlags:\n" " -a Unmount all file systems" \
USE_FEATURE_MTAB_SUPPORT(" in /etc/mtab\n -n Don't erase /etc/mtab entries") \
"\nFlags:" \
"\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" \
"\n -l Lazy umount (detach filesystem)" \
"\n -f Force umount (i.e., unreachable NFS server)" \
USE_FEATURE_MOUNT_LOOP("\n -D Do not free loop device (if a loop device has been used)")
USE_FEATURE_MOUNT_LOOP( \
"\n -D Do not free loop device (if a loop device has been used)")
#define umount_example_usage \
"$ umount /dev/hdc1\n"
@ -3463,10 +3523,13 @@ USE_FEATURE_START_STOP_DAEMON_FANCY( \
#define xargs_full_usage \
"Executes COMMAND on every item given by standard input.\n\n" \
"Options:\n" \
USE_FEATURE_XARGS_SUPPORT_CONFIRMATION(" -p Prompt the user about whether to run each command\n") \
USE_FEATURE_XARGS_SUPPORT_CONFIRMATION( \
" -p Prompt the user about whether to run each command\n") \
" -r Do not run command for empty read lines\n" \
USE_FEATURE_XARGS_SUPPORT_TERMOPT(" -x Exit if the size is exceeded\n") \
USE_FEATURE_XARGS_SUPPORT_ZERO_TERM(" -0 Input filenames are terminated by a null character\n") \
USE_FEATURE_XARGS_SUPPORT_TERMOPT( \
" -x Exit if the size is exceeded\n") \
USE_FEATURE_XARGS_SUPPORT_ZERO_TERM( \
" -0 Input filenames are terminated by a null character\n") \
" -t Print the command line on stderr before executing it"
#define xargs_example_usage \
"$ ls | xargs gzip\n" \