#define addgroup_full_usage \
"Add a group to the system"USE_FEATURE_ADDUSER_TO_GROUP(" or add an user to a group") \
"\n\nOptions:\n" \
- " -g GID Specify gid"
+ " -g GID Group id"
#define adduser_trivial_usage \
"[OPTIONS] user_name"
" -g GECOS GECOS field\n" \
" -s SHELL Login shell\n" \
" -G GROUP Add user to existing group\n" \
- " -S Create a system user (ignored)\n" \
- " -D Do not assign a password (logins still possible via ssh)\n" \
+ " -S Create a system user\n" \
+ " -D Do not assign a password\n" \
" -H Do not create home directory"
#define adjtimex_trivial_usage \
" -q Quiet\n" \
" -o offset Time offset, microseconds\n" \
" -f frequency Frequency adjust, integer kernel units (65536 is 1ppm)\n" \
- " (positive values make the system clock run faster)\n" \
+ " (positive values make clock run faster)\n" \
" -t tick Microseconds per tick, usually 10000\n" \
" -p timeconstant"
"\n -d Delete a specified entry" \
"\n -v Verbose" \
"\n -n Don't resolve names" \
- "\n -i if Specify network interface (e.g. eth0)" \
+ "\n -i if Network interface (e.g. eth0)" \
"\n -D Read <hwaddr> from given device" \
- "\n -A, -p Specify protocol family" \
- "\n -H hwtype Specify hardware address type"
+ "\n -A, -p Protocol family" \
+ "\n -H hwtype Hardware address type"
#define arping_trivial_usage \
- "[-fqbDUA] [-c count] [-w timeout] [-i device] [-s sender] target"
+ "[-fqbDUA] [-c count] [-w timeout] [-I dev] [-s sender] target"
#define arping_full_usage \
"Ping hosts by ARP requests/replies" \
"\n\nOptions:\n" \
" -q Quiet\n" \
" -b Keep broadcasting, don't go unicast\n" \
" -D Duplicated address detection mode\n" \
- " -U Unsolicited ARP mode, update your neighbours\n" \
- " -A ARP answer mode, update your neighbours\n" \
- " -c count Stop after sending count ARP request packets\n" \
+ " -U Unsolicited ARP mode, update your neighbors\n" \
+ " -A ARP answer mode, update your neighbors\n" \
+ " -c N Stop after sending N ARP requests\n" \
" -w timeout Time to wait for ARP reply, in seconds\n" \
- " -I device Outgoing interface name, default is eth0\n" \
- " -s sender Set specific sender IP address\n" \
- " target Target IP address of ARP request"
+ " -I dev Interface to use (default eth0)\n" \
+ " -s sender Sender IP address\n" \
+ " target Target IP address"
#define ash_trivial_usage \
"[FILE]...\n" \
"The ash shell (command interpreter)"
#define awk_trivial_usage \
- "[OPTION]... [program-text] [FILE ...]"
+ "[OPTION]... [program-text] [FILE...]"
#define awk_full_usage \
"Options:\n" \
" -v var=val Set variable\n" \
- " -F sep Use 'sep' as field separator\n" \
- " -f filename Read program from file"
+ " -F sep Use sep as field separator\n" \
+ " -f file Read program from file"
#define basename_trivial_usage \
"FILE [SUFFIX]"
" -c Write output to standard output\n" \
" -f Force"
+#define bzip2_trivial_usage \
+ "[OPTION]... [FILE]..."
+#define bzip2_full_usage \
+ "Compress FILE(s) with bzip2 algorithm.\n" \
+ "When FILE is '-' or unspecified, reads standard input. Implies -c." \
+ "\n\nOptions:" \
+ "\n -c Write output to standard output instead of FILE.bz2" \
+ "\n -d Decompress" \
+ "\n -f Force" \
+ "\n -1..-9 Compression level"
+
#define busybox_notes_usage \
"Hello world!\n"
" -v Set the file's version/generation number"
#define chcon_trivial_usage \
- "[OPTIONS] CONTEXT FILE...\n" \
- " chcon [OPTIONS] [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE...\n" \
- " chcon [OPTIONS] --reference=RFILE FILE...\n"
+ "[OPTIONS] CONTEXT FILE..." \
+ "\n chcon [OPTIONS] [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE..." \
+ USE_FEATURE_CHCON_LONG_OPTIONS( \
+ "\n chcon [OPTIONS] --reference=RFILE FILE..." \
+ )
#define chcon_full_usage \
"Change the security context of each FILE to CONTEXT\n" \
- "\n -v, --verbose Verbose" \
- "\n -c, --changes Report changes made" \
- "\n -h, --no-dereference Affect symlinks instead of their targets" \
- "\n -f, --silent, --quiet Suppress most error messages" \
+ USE_FEATURE_CHCON_LONG_OPTIONS( \
+ "\n -v,--verbose Verbose" \
+ "\n -c,--changes Report changes made" \
+ "\n -h,--no-dereference Affect symlinks instead of their targets" \
+ "\n -f,--silent,--quiet Suppress most error messages" \
"\n --reference=RFILE Use RFILE's group instead of using a CONTEXT value" \
- "\n -u, --user=USER Set user USER in the target security context" \
- "\n -r, --role=ROLE Set role ROLE in the target security context" \
- "\n -t, --type=TYPE Set type TYPE in the target security context" \
- "\n -l, --range=RANGE Set range RANGE in the target security context" \
- "\n -R, --recursive Recurse subdirectories" \
+ "\n -u,--user=USER Set user USER in the target security context" \
+ "\n -r,--role=ROLE Set role ROLE in the target security context" \
+ "\n -t,--type=TYPE Set type TYPE in the target security context" \
+ "\n -l,--range=RANGE Set range RANGE in the target security context" \
+ "\n -R,--recursive Recurse subdirectories" \
+ ) \
+ SKIP_FEATURE_CHCON_LONG_OPTIONS( \
+ "\n -v Verbose" \
+ "\n -c Report changes made" \
+ "\n -h Affect symlinks instead of their targets" \
+ "\n -f Suppress most error messages" \
+ "\n -u USER Set user USER in the target security context" \
+ "\n -r ROLE Set role ROLE in the target security context" \
+ "\n -t TYPE Set type TYPE in the target security context" \
+ "\n -l RNG Set range RNE in the target security context" \
+ "\n -R Recurse subdirectories" \
+ )
+
#define chmod_trivial_usage \
"[-R"USE_DESKTOP("cvf")"] MODE[,MODE]... FILE..."
"The bbsh shell (command interpreter)"
#define chrt_trivial_usage \
- "[OPTION]... [prio] [pid | command [arg]...]"
+ "[OPTION]... [prio] [pid | command [arg]...]"
#define chrt_full_usage \
- "manipulate real-time attributes of a process" \
- "\n\nOptions:\n" \
- " -p operate on pid\n" \
- " -r set scheduling policy to SCHED_RR\n" \
- " -f set scheduling policy to SCHED_FIFO\n" \
- " -o set scheduling policy to SCHED_OTHER\n" \
- " -m show min and max priorities"
+ "manipulate real-time attributes of a process" \
+ "\n\nOptions:\n" \
+ " -p operate on pid\n" \
+ " -r set scheduling policy to SCHED_RR\n" \
+ " -f set scheduling policy to SCHED_FIFO\n" \
+ " -o set scheduling policy to SCHED_OTHER\n" \
+ " -m show min and max priorities"
#define chrt_example_usage \
- "$ chrt -r 4 sleep 900; x=$!\n" \
- "$ chrt -f -p 3 $x\n" \
- "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
+ "$ chrt -r 4 sleep 900; x=$!\n" \
+ "$ chrt -f -p 3 $x\n" \
+ "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
#define cp_trivial_usage \
"[OPTION]... SOURCE DEST"
" -d [#] -l [#] -S -L logfile -f -b -c dir\n" \
" -d num Debug level\n" \
" -l num Log level (8 - default)\n" \
- " -S Log to syslogd (default)\n" \
+ " -S Log to syslog (default)\n" \
" -L file Log to file\n" \
" -f Run in foreground\n" \
" -b Run in background (default)\n" \
#define crontab_full_usage \
" file [opts] Replace crontab from file\n" \
" - [opts] Replace crontab from stdin\n" \
- " -u user Specify user\n" \
+ " -u user User\n" \
" -l [user] List crontab for user\n" \
" -e [user] Edit crontab for user\n" \
" -d [user] Delete crontab for user\n" \
- " -c dir Specify crontab directory"
+ " -c dir Crontab directory"
#define cryptpw_trivial_usage \
"[-a des|md5] [string]"
USE_FEATURE_DATE_ISOFMT( \
" -I[TIMESPEC] Outputs an ISO-8601 compliant date/time string\n" \
" TIMESPEC='date' (or missing) for date only,\n" \
- " 'hours', 'minutes', or 'seconds' for date and,\n" \
+ " 'hours', 'minutes', or 'seconds' for date and\n" \
" time to the indicated precision\n" \
" -D hint Use 'hint' as date format, via strptime()\n" \
) \
- " -s Sets time described by STRING\n" \
+ " -s STRING Sets time described by STRING\n" \
" -r FILE Displays the last modification time of FILE\n" \
" -u Prints or sets Coordinated Universal Time"
#define date_example_usage \
"Wed Apr 12 18:52:41 MDT 2000\n"
#define dc_trivial_usage \
- "expression ..."
+ "expression..."
#define dc_full_usage \
"This is a Tiny RPN calculator that understands the\n" \
"following operations: +, add, -, sub, *, mul, /, div, %, mod, " \
#define devfsd_trivial_usage \
"mntpnt [-v]" \
- USE_DEVFSD_FG_NP("[-fg][-np]" )
+ USE_DEVFSD_FG_NP("[-fg][-np]")
#define devfsd_full_usage \
"Manage devfs permissions and old device name symlinks" \
"\n\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" \
+ "\n and the kernel-side protocol version and exit" \
USE_DEVFSD_FG_NP( \
- "\n -fg Run the daemon in the foreground" \
+ "\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")
+/* -k is accepted but ignored for !HUMAN_READABLE,
+ * but we won't mention this (unimportant) */
+#if ENABLE_FEATURE_HUMAN_READABLE || ENABLE_FEATURE_DF_INODE
+#define DF_HAS_OPTIONS(x) x
+#else
+#define DF_HAS_OPTIONS(x)
+#endif
#define df_trivial_usage \
- "[-" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILESYSTEM ...]"
+ DF_HAS_OPTIONS("[-") \
+ USE_FEATURE_HUMAN_READABLE("hmk") USE_FEATURE_DF_INODE("i") \
+ DF_HAS_OPTIONS("] ") "[FILESYSTEM...]"
#define df_full_usage \
- "Print the filesystem space used and space available" \
- "\n\nOptions:\n" \
+ "Print filesystem usage statistics" \
+ DF_HAS_OPTIONS("\n\nOptions:") \
USE_FEATURE_HUMAN_READABLE( \
- "\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")
+ "\n -h Human readable (e.g. 1K 243M 2G)" \
+ "\n -m 1024*1024 blocks" \
+ "\n -k 1024 blocks" \
+ ) \
+ USE_FEATURE_DF_INODE( \
+ "\n -i Inodes" \
+ )
#define df_example_usage \
"$ df\n" \
"Filesystem 1k-blocks Used Available Use% Mounted on\n" \
#define dmesg_full_usage \
"Print or control the kernel ring buffer" \
"\n\nOptions:\n" \
- " -c Clears the ring buffer's contents after printing\n" \
- " -n LEVEL Sets console logging level\n" \
- " -s SIZE Use a buffer of size SIZE"
+ " -c Clear ring buffer after printing\n" \
+ " -n LEVEL Set console logging level\n" \
+ " -s SIZE Buffer size"
#define dnsd_trivial_usage \
"[-c config] [-t seconds] [-p port] [-i iface-ip] [-d]"
#define dumpleases_full_usage \
"Display DHCP leases granted by udhcpd" \
"\n\nOptions:\n" \
- " -f, --file=FILENAME Leases file to load\n" \
- " -r, --remaining Interpret lease times as time remaining\n" \
- " -a, --absolute Interpret lease times as expire time"
+ USE_GETOPT_LONG( \
+ " -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" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -f FILE Leases file to load\n" \
+ " -r Interpret lease times as time remaining\n" \
+ " -a Interpret lease times as expire time" \
+ )
#define e2fsck_trivial_usage \
"[-panyrcdfvstDFSV] [-b superblock] [-B blocksize] " \
" -L file Set badblocks list"
#define echo_trivial_usage \
- USE_FEATURE_FANCY_ECHO("[-neE] ") "[ARG ...]"
+ USE_FEATURE_FANCY_ECHO("[-neE] ") "[ARG...]"
#define echo_full_usage \
"Print the specified ARGs to stdout" \
USE_FEATURE_FANCY_ECHO( \
" -i iface Use interface ifname instead of the default \"eth0\"\n" \
" -p pass Append the four or six byte password PW to the packet"
+#define expand_trivial_usage \
+ "[-i] [-t NUM] [FILE|-]"
+#define expand_full_usage \
+ "Convert tabs to spaces, writing to standard output." \
+ "\n\nOptions:" \
+ USE_FEATURE_EXPAND_LONG_OPTIONS( \
+ "\n -i,--initial Do not convert tabs after non blanks" \
+ "\n -t,--tabs=N Tabstops every N chars" \
+ ) \
+ SKIP_FEATURE_EXPAND_LONG_OPTIONS( \
+ "\n -i Do not convert tabs after non blanks" \
+ "\n -t Tabstops every N chars" \
+ )
+
#define expr_trivial_usage \
"EXPRESSION"
#define expr_full_usage \
"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" \
- " ARG1 < ARG2 ARG1 is less than ARG2\n" \
- " ARG1 <= ARG2 ARG1 is less than or equal to ARG2\n" \
- " ARG1 = ARG2 ARG1 is equal to ARG2\n" \
- " ARG1 != ARG2 ARG1 is unequal to ARG2\n" \
- " ARG1 >= ARG2 ARG1 is greater than or equal to ARG2\n" \
- " ARG1 > ARG2 ARG1 is greater than ARG2\n" \
- " ARG1 + ARG2 Sum of ARG1 and ARG2\n" \
- " ARG1 - ARG2 Difference of ARG1 and ARG2\n" \
- " ARG1 * ARG2 Product of ARG1 and ARG2\n" \
- " ARG1 / ARG2 Quotient of ARG1 divided by ARG2\n" \
- " ARG1 % ARG2 Remainder of ARG1 divided by ARG2\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" \
+ " ARG1 < ARG2 1 if ARG1 is less than ARG2, else 0. Similarly:\n" \
+ " ARG1 <= ARG2\n" \
+ " ARG1 = ARG2\n" \
+ " ARG1 != ARG2\n" \
+ " ARG1 >= ARG2\n" \
+ " ARG1 > ARG2\n" \
+ " ARG1 + ARG2 Sum of ARG1 and ARG2. Similarly:\n" \
+ " ARG1 - ARG2\n" \
+ " ARG1 * ARG2\n" \
+ " ARG1 / ARG2\n" \
+ " ARG1 % ARG2\n" \
" 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" \
"\n -maxdepth N Descend at most N levels. -maxdepth 0 applies" \
"\n tests/actions to command line arguments only") \
"\n -name PATTERN File name (w/o directory name) matches PATTERN" \
+ "\n -iname PATTERN Case insensitive -name" \
USE_FEATURE_FIND_PATH( \
"\n -path PATTERN Path matches PATTERN") \
USE_FEATURE_FIND_REGEX( \
"$ freeramdisk /dev/ram2\n"
#define fsck_trivial_usage \
- "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys ...]"
+ "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys...]"
#define fsck_full_usage \
"Check and repair filesystems" \
"\n\nOptions:\n" \
#define fsck_minix_full_usage \
"Perform a consistency check for MINIX filesystems" \
"\n\nOptions:\n" \
- " -l Lists all filenames\n" \
+ " -l List all filenames\n" \
" -r Perform interactive repairs\n" \
" -a Perform automatic repairs\n" \
" -v Verbose\n" \
- " -s Outputs super-block information\n" \
- " -m Activates MINIX-like \"mode not cleared\" warnings\n" \
+ " -s Output super-block information\n" \
+ " -m Activate MINIX-like \"mode not cleared\" warnings\n" \
" -f Force file system check"
#define ftpget_trivial_usage \
#define ftpget_full_usage \
"Retrieve a remote file via FTP" \
"\n\nOptions:\n" \
- " -c, --continue Continue a previous transfer\n" \
- " -v, --verbose Verbose\n" \
- " -u, --username Username to be used\n" \
- " -p, --password Password to be used\n" \
- " -P, --port Port number to be used"
+ USE_GETOPT_LONG( \
+ " -c,--continue Continue previous transfer\n" \
+ " -v,--verbose Verbose\n" \
+ " -u,--username Username\n" \
+ " -p,--password Password\n" \
+ " -P,--port Port number" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -c Continue previous transfer\n" \
+ " -v Verbose\n" \
+ " -u Username\n" \
+ " -p Password\n" \
+ " -P Port number" \
+ )
#define ftpput_trivial_usage \
"[options] remote-host remote-file local-file"
#define ftpput_full_usage \
"Store a local file on a remote machine via FTP" \
"\n\nOptions:\n" \
- " -v, --verbose Verbose\n" \
- " -u, --username Username to be used\n" \
- " -p, --password Password to be used\n" \
- " -P, --port Port number to be used"
+ USE_GETOPT_LONG( \
+ " -v,--verbose Verbose\n" \
+ " -u,--username Username\n" \
+ " -p,--password Password\n" \
+ " -P,--port Port number" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -v Verbose\n" \
+ " -u Username\n" \
+ " -p Password\n" \
+ " -P Port number" \
+ )
#define fuser_trivial_usage \
"[options] file OR port/proto"
"[OPTIONS]..."
#define getopt_full_usage \
"Parse command options\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" \
- " -o, --options=optstring Short options to be recognized\n" \
- " -q, --quiet Disable error reporting by getopt(3)\n" \
- " -Q, --quiet-output No normal output\n" \
- " -s, --shell=shell Set shell quoting conventions\n" \
- " -T, --test Test for getopt(1) version\n" \
- " -u, --unquoted Do not quote the output"
+ USE_GETOPT_LONG( \
+ " -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" \
+ " -o,--options=optstring Short options to be recognized\n" \
+ " -q,--quiet Disable error reporting by getopt(3)\n" \
+ " -Q,--quiet-output No normal output\n" \
+ " -s,--shell=shell Set shell quoting conventions\n" \
+ " -T,--test Test for getopt(1) version\n" \
+ " -u,--unquoted Don't quote the output" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -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\n" \
+ " -o optstring Short options to be recognized\n" \
+ " -q Disable error reporting by getopt(3)\n" \
+ " -Q No normal output\n" \
+ " -s shell Set shell quoting conventions\n" \
+ " -T Test for getopt(1) version\n" \
+ " -u Don't quote the output" \
+ )
#define getopt_example_usage \
"$ cat getopt.test\n" \
"#!/bin/sh\n" \
#define grep_trivial_usage \
"[-HhrilLnqvso" \
USE_DESKTOP("w") \
- "eF" \
+ "eF" \
USE_FEATURE_GREP_EGREP_ALIAS("E") \
USE_FEATURE_GREP_CONTEXT("ABC") \
"] PATTERN [FILEs...]"
"Uncompress FILE (or standard input if FILE is '-')" \
"\n\nOptions:\n" \
" -c Write output to standard output\n" \
- " -f Force read when source is a terminal\n" \
+ " -f Force\n" \
" -t Test compressed file integrity"
#define gunzip_example_usage \
"$ ls -la /tmp/BusyBox*\n" \
"\n\nOptions:\n" \
" -c Write output to standard output instead of FILE.gz\n" \
" -d Decompress\n" \
- " -f Force write when destination is a terminal"
+ " -f Force"
#define gzip_example_usage \
"$ ls -la /tmp/busybox*\n" \
"-rw-rw-r-- 1 andersen andersen 1761280 Apr 14 17:47 /tmp/busybox.tar\n" \
"daemon:x:1:1:daemon:/usr/sbin:/bin/sh\n"
#define hexdump_trivial_usage \
- "[-[bcCdefnosvx]] [OPTION] FILE"
+ "[-bcCdefnosvx" USE_FEATURE_HEXDUMP_REVERSE("R") "] FILE..."
#define hexdump_full_usage \
"Display file(s) or standard input in a user specified format" \
- "\n\nOptions:\n" \
- " -b One-byte octal display\n" \
- " -c One-byte character display\n" \
- " -C Canonical hex+ASCII, 16 bytes per line\n" \
- " -d Two-byte decimal display\n" \
- " -e FORMAT STRING\n" \
- " -f FORMAT FILE\n" \
- " -n LENGTH Interpret only length bytes of input\n" \
- " -o Two-byte octal display\n" \
- " -s OFFSET Skip offset bytes\n" \
- " -v Display all input data\n" \
- " -x Two-byte hexadecimal display"
+ "\n\nOptions:" \
+ "\n -b One-byte octal display" \
+ "\n -c One-byte character display" \
+ "\n -C Canonical hex+ASCII, 16 bytes per line" \
+ "\n -d Two-byte decimal display" \
+ "\n -e FORMAT STRING" \
+ "\n -f FORMAT FILE" \
+ "\n -n LENGTH Interpret only LENGTH bytes of input" \
+ "\n -o Two-byte octal display" \
+ "\n -s OFFSET Skip OFFSET bytes" \
+ "\n -v Display all input data" \
+ "\n -x Two-byte hexadecimal display" \
+ USE_FEATURE_HEXDUMP_REVERSE( \
+ "\n -R Reverse of 'hexdump -Cv'") \
+
+#define hd_trivial_usage \
+ "FILE..."
+#define hd_full_usage \
+ "hd is an alias for hexdump -C"
#define hostid_trivial_usage \
""
#define httpd_trivial_usage \
"[-c conffile]" \
- " [-p port]" \
- " [-i] [-f]" \
+ " [-p [ip:]port]" \
+ " [-i] [-f] [-v[v]]" \
USE_FEATURE_HTTPD_SETUID(" [-u user[:grp]]") \
USE_FEATURE_HTTPD_BASIC_AUTH(" [-r realm]") \
USE_FEATURE_HTTPD_AUTH_MD5(" [-m pass]") \
" [-h home]" \
" [-d/-e string]"
#define httpd_full_usage \
- "Listen for incoming http server requests" \
- "\n\nOptions:\n" \
- " -c FILE Specifies configuration file. (default httpd.conf)\n" \
- " -p PORT Server port (default 80)\n" \
- " -i Assume that we are started from inetd\n" \
- " -f Do not daemonize\n" \
+ "Listen for incoming HTTP requests" \
+ "\n\nOptions:" \
+ "\n -c FILE Configuration file (default httpd.conf)" \
+ "\n -p [IP:]PORT Bind to ip:port (default *:80)" \
+ "\n -i Inetd mode" \
+ "\n -f Do not daemonize" \
+ "\n -v[v] Verbose" \
USE_FEATURE_HTTPD_SETUID( \
- " -u USER[:GRP] Set uid/gid after binding to port\n") \
+ "\n -u USER[:GRP] Set uid/gid after binding to port") \
USE_FEATURE_HTTPD_BASIC_AUTH( \
- " -r REALM Authentication Realm for Basic Authentication\n") \
+ "\n -r REALM Authentication Realm for Basic Authentication") \
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"
+ "\n -m PASS Crypt PASS with md5 algorithm") \
+ "\n -h HOME Home directory (default .)" \
+ "\n -e STRING HTML encode STRING" \
+ "\n -d STRING URL decode STRING" \
#define hwclock_trivial_usage \
+ USE_GETOPT_LONG( \
"[-r|--show] [-s|--hctosys] [-w|--systohc]" \
" [-l|--localtime] [-u|--utc]" \
- " [-f FILE]"
+ " [-f FILE]" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ "[-r] [-s] [-w] [-l] [-u] [-f FILE]" \
+ )
#define hwclock_full_usage \
"Query and set a hardware clock (RTC)" \
"\n\nOptions:\n" \
" -r Read hardware clock and print result\n" \
" -s Set the system time from the hardware clock\n" \
- " -w Set the hardware clock to the current system time\n" \
+ " -w Set the hardware clock to the system time\n" \
" -u The hardware clock is kept in coordinated universal time\n" \
" -l The hardware clock is kept in local time\n" \
" -f FILE Use the specified clock (e.g. /dev/rtc2)"
"Print information for USERNAME or the current user" \
"\n\nOptions:\n" \
USE_SELINUX( \
- " -Z prints only the security context\n" \
+ " -Z Prints only the security context\n" \
) \
" -g Prints only the group ID\n" \
" -u Prints only the user ID\n" \
" ::shutdown:/sbin/swapoff -a\n"
#define insmod_trivial_usage \
- "[OPTION]... MODULE [symbol=value]..."
+ USE_FEATURE_2_4_MODULES("[OPTION]... ") "MODULE [symbol=value]..."
#define insmod_full_usage \
"Load the specified kernel modules into the kernel" \
+ USE_FEATURE_2_4_MODULES( \
"\n\nOptions:\n" \
" -f Force module to load into the wrong kernel version\n" \
" -k Make module autoclean-able\n" \
" -q Quiet\n" \
" -L Lock to prevent simultaneous loads of a module\n" \
USE_FEATURE_INSMOD_LOAD_MAP( \
- " -m Output load map to stdout\n") \
+ " -m Output load map to stdout\n" \
+ ) \
" -o NAME Set internal module name to NAME\n" \
- " -x Do not export externs"
+ " -x Do not export externs" \
+ )
#define install_trivial_usage \
"[-cgmops] [sources] dest|directory"
" -c Copy the file, default\n" \
" -d Create directories\n" \
" -g Set group ownership\n" \
- " -m Set permission modes\n" \
+ " -m Set permissions\n" \
" -o Set ownership\n" \
" -p Preserve date\n" \
" -s Strip symbol tables" \
USE_FEATURE_IP_LINK("link | ") \
USE_FEATURE_IP_TUNNEL("tunnel | ") \
USE_FEATURE_IP_RULE("rule") \
- "} {COMMAND}"
+ "} {COMMAND}"
#define ip_full_usage \
"ip [OPTIONS] OBJECT {COMMAND}\n" \
"where OBJECT := {" \
USE_FEATURE_IP_LINK("link | ") \
USE_FEATURE_IP_TUNNEL("tunnel | ") \
USE_FEATURE_IP_RULE("rule") \
- "}\n" \
+ "}\n" \
"OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }"
#define ipaddr_trivial_usage \
#define ipcalc_full_usage \
"Calculate IP network settings from a IP address" \
"\n\nOptions:" \
- "\n -b --broadcast Display calculated broadcast address" \
- "\n -n --network Display calculated network address" \
- "\n -m --netmask Display default netmask for IP" \
+ USE_FEATURE_IPCALC_LONG_OPTIONS( \
+ "\n -b,--broadcast Display calculated broadcast address" \
+ "\n -n,--network Display calculated network address" \
+ "\n -m,--netmask Display default netmask for IP" \
USE_FEATURE_IPCALC_FANCY( \
- "\n -p --prefix Display the prefix for IP/NETMASK" \
- "\n -h --hostname Display first resolved host name" \
- "\n -s --silent Don't ever display error messages")
+ "\n -p,--prefix Display the prefix for IP/NETMASK" \
+ "\n -h,--hostname Display first resolved host name" \
+ "\n -s,--silent Don't ever display error messages" \
+ ) \
+ ) \
+ SKIP_FEATURE_IPCALC_LONG_OPTIONS( \
+ "\n -b Display calculated broadcast address" \
+ "\n -n Display calculated network address" \
+ "\n -m Display default netmask for IP" \
+ USE_FEATURE_IPCALC_FANCY( \
+ "\n -p Display the prefix for IP/NETMASK" \
+ "\n -h Display first resolved host name" \
+ "\n -s Don't ever display error messages" \
+ ) \
+ )
#define ipcrm_trivial_usage \
"[-[MQS] key] [-[mqs] id]"
#define ipcs_trivial_usage \
"[[-smq] -i shmid] | [[-asmq] [-tcplu]]"
#define ipcs_full_usage \
- " -i Specify a specific resource id\n" \
+ " -i Show a specific resource\n" \
"Resource specification:\n" \
" -m Shared memory segments\n" \
" -q Message queues\n" \
" [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n" \
" [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]"
+#define kbd_mode_trivial_usage \
+ "[-a|k|s|u]"
+#define kbd_mode_full_usage \
+ "Report or set the keyboard mode" \
+ "\n\nOptions set mode:\n" \
+ " -a Default (ASCII)\n" \
+ " -k Medium-raw (keyboard)\n" \
+ " -s Raw (scancode)\n" \
+ " -u Unicode (utf-8)"
+
#define kill_trivial_usage \
- "[-l] [-signal] process-id [process-id ...]"
+ "[-l] [-signal] process-id [process-id...]"
#define kill_full_usage \
"Send a signal (default is TERM) to the specified process(es)" \
"\n\nOptions:\n" \
"$ kill 252\n"
#define killall_trivial_usage \
- "[-l] [-q] [-signal] process-name [process-name ...]"
+ "[-l] [-q] [-signal] process-name [process-name...]"
#define killall_full_usage \
"Send a signal (default is TERM) to the specified process(es)" \
"\n\nOptions:\n" \
"Kernel logger" \
"\n\nOptions:\n" \
" -c n Sets the default log level of console messages to n\n" \
- " -n Run as foreground process"
+ " -n Run in foreground"
#define length_trivial_usage \
"STRING"
"changed, and files can be manipulated in various ways." \
"\n\nOptions:\n" \
" -E Quit once the end of a file is reached\n" \
- " -M Display a status line containing the current line numbers\n" \
+ " -M,-m Display a status line containing the current line numbers\n" \
" and the percentage through the file\n" \
" -N Prefix line numbers to each line\n" \
- " -m Display a status line containing the percentage through the\n" \
- " file\n" \
" -~ Suppress ~s displayed when input past the end of the file is\n" \
" reached"
#define setarch_trivial_usage \
- "personality program [args ...]"
+ "personality program [args...]"
#define setarch_full_usage \
"Personality may be:\n" \
" linux32 Set 32bit uname emulation\n" \
"\n\nOptions:\n" \
" -s Make symlinks instead of hardlinks\n" \
" -f Remove existing destination files\n" \
- " -n No dereference symlinks - treat like normal file\n" \
+ " -n Don't dereference symlinks - treat like normal file\n" \
" -b Make a backup of the target (if exists) before link operation\n" \
" -S suf Use suffix instead of ~ when making backup files"
#define ln_example_usage \
"$ ls -l /tmp/ls\n" \
"lrwxrwxrwx 1 root root 7 Apr 12 18:39 ls -> BusyBox*\n"
-#define load_policy_trivial_usage \
- "[FILE]"
+#define load_policy_trivial_usage
+
#define load_policy_full_usage
#define loadfont_trivial_usage \
"$ logger \"hello\"\n"
#define login_trivial_usage \
- "[OPTION]... [username] [ENV=VAR ...]"
+ "[OPTION]... [username] [ENV=VAR...]"
#define login_full_usage \
"Begin a new session on the system" \
"\n\nOptions:\n" \
" -f Output data as the log grows"
#define losetup_trivial_usage \
- "[-o OFFSET] [-d] LOOPDEVICE [FILE]]"
+ "[-o OFS] LOOPDEV FILE - associate loop devices\n" \
+ " losetup -d LOOPDEV - disassociate\n" \
+ " losetup [-f] - show"
#define losetup_full_usage \
- "(Dis)associate LOOPDEVICE with FILE, or display current associations" \
- "\n\nOptions:\n" \
- " -d Disassociate LOOPDEVICE\n" \
- " -o OFFSET Start OFFSET bytes into FILE"
+ "Options:\n" \
+ " -o OFS Start OFS bytes into FILE\n" \
+ " -f Show first free loop device"
#define losetup_notes_usage \
"No arguments will display all current associations.\n" \
"One argument (losetup /dev/loop1) will display the current association\n" \
"(if any), or disassociate it (with -d). The display shows the offset\n" \
"and filename of the file the loop device is currently bound to.\n\n" \
"Two arguments (losetup /dev/loop1 file.img) create a new association,\n" \
- "with an optional offset (-o 12345). Encryption is not yet supported.\n\n"
+ "with an optional offset (-o 12345). Encryption is not yet supported.\n" \
+ "losetup -f will show the first loop free loop device\n\n"
#define ls_trivial_usage \
"[-1Aa" USE_FEATURE_LS_TIMESTAMPS("c") "Cd" \
#define lsmod_full_usage \
"List the currently loaded kernel modules"
-#ifdef CONFIG_FEATURE_MAKEDEVS_LEAF
+#if ENABLE_FEATURE_MAKEDEVS_LEAF
#define makedevs_trivial_usage \
"NAME TYPE MAJOR MINOR FIRST LAST [s]"
#define makedevs_full_usage \
"[creates hda,hda1-hda8]\n"
#endif
-#ifdef CONFIG_FEATURE_MAKEDEVS_TABLE
+#if ENABLE_FEATURE_MAKEDEVS_TABLE
#define makedevs_trivial_usage \
"[-d device_table] rootdir"
#define makedevs_full_usage \
"and * (run both after creating and before deleting). The commands run in\n" \
"the /dev directory, and use system() which calls /bin/sh.\n\n" \
) \
- "Config file parsing stops on the first matching line. If no config\n"\
- "entry is matched, devices are created with default 0:0 660. (Make\n"\
+ "Config file parsing stops on the first matching line. If no config\n" \
+ "entry is matched, devices are created with default 0:0 660. (Make\n" \
"the last line match .* to override this.)\n\n" \
)
" y Allow write access to your terminal\n" \
" n Disallow write access to your terminal"
+#define microcom_trivial_usage \
+ "[-s speed] tty-name"
+#define microcom_full_usage \
+ ""
+
#define mkdir_trivial_usage \
"[OPTION] DIRECTORY..."
#define mkdir_full_usage \
#define mkfs_minix_full_usage \
"Make a MINIX filesystem" \
"\n\nOptions:\n" \
- " -c Check the device for bad blocks\n" \
- " -n [14|30] Specify the maximum length of filenames\n" \
- " -i INODES Specify the number of inodes for the filesystem\n" \
- " -l FILENAME Read the bad blocks list from FILENAME\n" \
+ " -c Check device for bad blocks\n" \
+ " -n [14|30] Maximum length of filenames\n" \
+ " -i INODES Number of inodes for the filesystem\n" \
+ " -l FILENAME Read bad blocks list from FILENAME\n" \
" -v Make a Minix version 2 filesystem"
#define mknod_trivial_usage \
"-rw------- 1 andersen andersen 0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
#define modprobe_trivial_usage \
- "[-knqrsv] MODULE [symbol=value ...]"
+ "[-knqrsv] MODULE [symbol=value...]"
#define modprobe_full_usage \
"Options:\n" \
" -k Make module autoclean-able\n" \
- " -n Just show what would be done\n" \
+ " -n Dry run\n" \
" -q Quiet\n" \
" -r Remove module (stacks) or do autoclean\n" \
" -s Report via syslog instead of stderr\n" \
" the module and the alias.\n" \
" A module can be aliased more than once.\n" \
"\n" \
-" options <mod_name|alias_name> <symbol=value ...>\n" \
+" options <mod_name|alias_name> <symbol=value...>\n" \
" When loading module mod_name (or the module aliased by alias_name), pass\n" \
" the \"symbol=value\" pairs as option to that module.\n" \
"\n" \
" from the command line\n"
#define more_trivial_usage \
- "[FILE ...]"
+ "[FILE...]"
#define more_full_usage \
"View FILE or standard input one screenful at a time"
#define more_example_usage \
"\n\nOptions:\n" \
" -a Mount all filesystems in fstab\n" \
USE_FEATURE_MTAB_SUPPORT( \
- " -f \"Fake\" Add entry to mount table but don't mount it\n" \
- " -n Don't write a mount table entry\n" \
+ " -f Update /etc/mtab, but don't mount\n" \
+ " -n Don't update /etc/mtab\n" \
) \
- " -o option One of many filesystem options, listed below\n" \
- " -r Mount the filesystem read-only\n" \
- " -t fs-type Specify the filesystem type\n" \
- " -w Mount for reading and writing (default)\n" \
+ " -r Read-only mount\n" \
+ " -t fs-type Filesystem type\n" \
+ " -w Read-write mount (default)\n" \
"\n" \
- "Options for use with the \"-o\" flag:\n" \
+ "-o option:\n" \
USE_FEATURE_MOUNT_LOOP( \
" loop Ignored (loop devices are autodetected)\n" \
) \
#else /* DESKTOP nc - much more compatible with nc 1.10 */
#define nc_trivial_usage \
- "[-options] hostname port - connect" \
+ "[-options] hostname port - connect" \
USE_NC_SERVER("\nnc [-options] -l -p port [hostname] [port] - listen")
#define nc_full_usage \
USE_NC_SERVER( \
"-l Listen mode, for inbound connects\n" \
) \
- "-n Do not do DNS resolution" \
+ "-n Don't do DNS resolution" \
"\n-s addr Local address" \
"\n-p port Local port" \
"\n-u UDP mode" \
)
#define nice_trivial_usage \
- "[-n ADJUST] [COMMAND [ARG] ...]"
+ "[-n ADJUST] [COMMAND [ARG]...]"
#define nice_full_usage \
"Run a program with modified scheduling priority" \
"\n\nOptions:\n" \
" -u Unlocks (re-enables) the specified user account"
#define chpasswd_trivial_usage \
- "[--md5|--encrypt]"
+ USE_GETOPT_LONG("[--md5|--encrypt]") SKIP_GETOPT_LONG("[-m|-e]")
#define chpasswd_full_usage \
"Read user:password information from stdin\n" \
"and update /etc/passwd accordingly." \
"\n\nOptions:" \
- "\n -e, --encrypt Supplied passwords are in encrypted form" \
- "\n -m, --md5 Use MD5 encryption instead of DES"
+ USE_GETOPT_LONG( \
+ "\n -e,--encrypt Supplied passwords are in encrypted form" \
+ "\n -m,--md5 Use MD5 encryption instead of DES" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ "\n -e Supplied passwords are in encrypted form" \
+ "\n -m Use MD5 encryption instead of DES" \
+ )
#define patch_trivial_usage \
"[-p num] [-i diff]"
"$ patch -p1 < example.diff\n" \
"$ patch -p0 -i example.diff"
+#define pgrep_trivial_usage \
+ "[-flnovx] pattern"
+#define pgrep_full_usage \
+ "Display process(es) selected by regex pattern" \
+ "\n\nOptions:\n" \
+ " -l Show command name too\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" \
+ " -x Match whole name (not substring)"
+
#if (ENABLE_FEATURE_PIDOF_SINGLE || ENABLE_FEATURE_PIDOF_OMIT)
#define USAGE_PIDOF "Options:"
#else
#endif
#define pidof_trivial_usage \
- "process-name [OPTION] [process-name ...]"
+ "process-name [OPTION] [process-name...]"
#define pidof_full_usage \
"List the PIDs of all processes with names that match the\n" \
USE_FEATURE_PIDOF_OMIT( \
"$ pidof /bin/sh -o %PPID\n20351 5950")
-#ifndef CONFIG_FEATURE_FANCY_PING
+#if !ENABLE_FEATURE_FANCY_PING
#define ping_trivial_usage \
"host"
#define ping_full_usage \
"Move the current root file system to PUT_OLD and make NEW_ROOT\n" \
"the new root file system"
+#define pkill_trivial_usage \
+ "[-l] | [-fnovx] [-signal] pattern"
+#define pkill_full_usage \
+ "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" \
+ " -x Match whole name (not substring)"
+
#define poweroff_trivial_usage \
"[-d delay] [-n] [-f]"
#define poweroff_full_usage \
" -n Disable byte order auto-detection"
#define realpath_trivial_usage \
- "pathname ..."
+ "pathname..."
#define realpath_full_usage \
"Return the absolute pathnames of given argument"
" -f Force reboot (don't go through init)"
#define renice_trivial_usage \
- "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID ...]"
+ "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID...]"
#define renice_full_usage \
"Change priority of running processes" \
"\n\nOptions:\n" \
- " -n Adjusts current nice value (smaller is faster)\n" \
+ " -n Adjust current nice value (smaller is faster)\n" \
" -p Process id(s) (default)\n" \
" -g Process group id(s)\n" \
" -u Process user name(s) and/or id(s)"
#define restorecon_full_usage \
"Reset security contexts of files in pathname\n" \
"\n -i Ignore files that do not exist" \
- "\n -f filename File with list of files to process. Use - for stdin" \
+ "\n -f file File with list of files to process. Use - for stdin" \
"\n -e directory Directory to exclude" \
"\n -R,-r Recurse directories" \
"\n -n Don't change any file labels" \
- "\n -o filename Save list of files with incorrect context" \
+ "\n -o file Save list of files with incorrect context" \
"\n -v Verbose" \
"\n -vv Show changed labels" \
"\n -F Force reset of context to match file_context" \
"[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
" runcon CONTEXT COMMAND [args]"
#define runcon_full_usage \
- "runcon [-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
- "runcon CONTEXT COMMAND [args]\n" \
"Run a program in a different security context\n\n" \
" CONTEXT Complete security context\n" \
- " -c, --compute Compute process transition context before modifying\n" \
- " -t, --type=TYPE Type (for same role as parent)\n" \
- " -u, --user=USER User identity\n" \
- " -r, --role=ROLE Role\n" \
- " -l, --range=RNG Levelrange" \
+ USE_GETOPT_LONG( \
+ " -c,--compute Compute process transition context before modifying\n" \
+ " -t,--type=TYPE Type (for same role as parent)\n" \
+ " -u,--user=USER User identity\n" \
+ " -r,--role=ROLE Role\n" \
+ " -l,--range=RNG Levelrange" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -c Compute process transition context before modifying\n" \
+ " -t TYPE Type (for same role as parent)\n" \
+ " -u USER User identity\n" \
+ " -r ROLE Role\n" \
+ " -l RNG Levelrange" \
+ )
#define run_parts_trivial_usage \
"[-t] "USE_FEATURE_RUN_PARTS_FANCY("[-l] ")"[-a ARG] [-u MASK] DIRECTORY"
USE_FEATURE_RUN_PARTS_FANCY("\n -l Prints names of all matching files even when they are not executable")
#define run_parts_example_usage \
- "$ run-parts -a start /etc/init.d\n" \
- "$ run-parts -a stop=now /etc/init.d\n\n" \
- "Let's assume you have a script foo/dosomething:\n" \
- "#!/bin/sh\n" \
- "for i in $*; do eval $i; done; unset i\n" \
- "case \"$1\" in\n" \
- "start*) echo starting something;;\n" \
- "stop*) set -x; shutdown -h $stop;;\n" \
- "esac\n\n" \
- "Running this yields:\n" \
- "$run-parts -a stop=+4m foo/\n" \
- "+ shutdown -h +4m"
+ "$ run-parts -a start /etc/init.d\n" \
+ "$ run-parts -a stop=now /etc/init.d\n\n" \
+ "Let's assume you have a script foo/dosomething:\n" \
+ "#!/bin/sh\n" \
+ "for i in $*; do eval $i; done; unset i\n" \
+ "case \"$1\" in\n" \
+ "start*) echo starting something;;\n" \
+ "stop*) set -x; shutdown -h $stop;;\n" \
+ "esac\n\n" \
+ "Running this yields:\n" \
+ "$run-parts -a stop=+4m foo/\n" \
+ "+ shutdown -h +4m"
#define runlevel_trivial_usage \
"[utmp]"
" FIRST LAST\n" \
" FIRST INCREMENT LAST"
+#define sestatus_trivial_usage \
+ "[-vb]"
+#define sestatus_full_usage \
+ "-v Verbose\n" \
+ "-b Display current state of booleans"
+
#define setconsole_trivial_usage \
- "[-r|--reset] [DEVICE]"
+ "[-r" USE_FEATURE_SETCONSOLE_LONG_OPTIONS("|--reset") "] [DEVICE]"
#define setconsole_full_usage \
"Redirect system console output to DEVICE (default: /dev/tty)" \
"\n\nOptions:\n" \
#define setenforce_full_usage
#define setfiles_trivial_usage \
- "[-dnpqsvW] [-e dir]... [-o filename] [-r alt_root_path]" \
+ "[-dnpqsvW] [-e dir]... [-o file] [-r alt_root_path]" \
USE_FEATURE_SETFILES_CHECK_OPTION( \
" [-c policyfile] spec_file" \
) \
"\n -o file Save list of files with incorrect context" \
"\n -s Take a list of files from standard input (instead of command line)" \
"\n -v Show changes in file labels, if type or role are changing" \
- "\n -vv Show changes in file labels, if type, role, or user are changing" \
- "\n -W Display warnings about entries that had no matching files"
+ "\n -vv Show changes in file labels, if type, role, or user are changing" \
+ "\n -W Display warnings about entries that had no matching files"
#define setkeycodes_trivial_usage \
- "SCANCODE KEYCODE ..."
+ "SCANCODE KEYCODE..."
#define setkeycodes_full_usage \
"Set entries into the kernel's scancode-to-keycode map,\n" \
"allowing unusual keyboards to generate usable keycodes.\n\n" \
#define setlogcons_full_usage \
"Redirect the kernel output to console N (0 for current)"
+#define setsebool_trivial_usage \
+ "boolean value"
+
+#define setsebool_full_usage \
+ "Change boolean setting"
+
#define setsid_trivial_usage \
- "program [arg ...]"
+ "program [arg...]"
#define setsid_full_usage \
"Run any program in a new session by calling setsid() before\n" \
"exec'ing the rest of its arguments. See setsid(2) for details."
"[FILE]...\n" \
"or: sh -c command [args]..."
#define lash_full_usage \
- "The BusyBox LAme SHell (command interpreter)"
-#define lash_notes_usage \
- "This command does not yet have proper documentation.\n\n" \
- "Use lash just as you would use any other shell. It properly handles pipes,\n" \
- "redirects, job control, can be used as the shell for scripts, and has a\n" \
- "sufficient set of builtins to do what is needed. It does not (yet) support\n" \
- "Bourne Shell syntax. If you need things like \"if-then-else\", \"while\", and such\n" \
- "use ash or bash. If you just need a very simple and extremely small shell,\n" \
- "this will do the job."
+ "lash is deprecated, please use hush"
#define last_trivial_usage \
""
" -f Ignore case\n" \
" -g General numerical sort\n" \
" -i Ignore unprintable characters\n" \
- " -k Specify sort key\n" \
+ " -k Sort key\n" \
" -M Sort month\n") \
" -n Sort numbers\n" \
USE_FEATURE_SORT_BIG( \
""
#define split_trivial_usage \
- "[OPTION] [INPUT [PREFIX]]"
+ "[OPTION] [INPUT [PREFIX]]"
#define split_full_usage \
- "Options:" \
- "\n -b n[k|m] Split by bytes" \
- "\n -l n Split by lines" \
- "\n -a n Use n letters as suffix"
+ "Options:" \
+ "\n -b n[k|m] Split by bytes" \
+ "\n -l n Split by lines" \
+ "\n -a n Use n letters as suffix"
#define split_example_usage \
- "$ split TODO foo\n" \
- "$ cat TODO | split -a 2 -l 2 TODO_\n"
+ "$ split TODO foo\n" \
+ "$ cat TODO | split -a 2 -l 2 TODO_\n"
#define start_stop_daemon_trivial_usage \
- "[OPTIONS] [--start|--stop] ... [-- arguments...]"
+ "[OPTIONS] [" \
+ USE_GETOPT_LONG("--start|--stop") SKIP_GETOPT_LONG("-S|-K") \
+ "] ... [-- arguments...]"
#define start_stop_daemon_full_usage \
"Start and stop services" \
"\n\nOptions:" \
- "\n -S|--start Start" \
- "\n -K|--stop Stop" \
- "\n -a|--startas pathname Starts process specified by pathname" \
- "\n -b|--background Force process into background" \
- "\n -u|--user username|uid Stop this user's processes" \
- "\n -x|--exec executable Program to either start or check" \
- "\n -m|--make-pidfile Create the -p file and enter pid in it" \
- "\n -n|--name process-name Stop processes with this name" \
- "\n -p|--pidfile pid-file Save or load pid using a pid-file" \
- "\n -q|--quiet Quiet" \
+ USE_GETOPT_LONG( \
+ "\n -S,--start Start" \
+ "\n -K,--stop Stop" \
+ "\n -a,--startas pathname Starts process specified by pathname" \
+ "\n -b,--background Put process into background" \
+ "\n -u,--user username|uid Stop this user's processes" \
+ "\n -x,--exec executable Program to either start or check" \
+ "\n -n,--name process-name Stop processes with this name" \
+ "\n -p,--pidfile pid-file Save or load pid using a pid-file" \
+ "\n -m,--make-pidfile Create the -p file and enter pid in it" \
+ "\n -q,--quiet Quiet" \
+ USE_FEATURE_START_STOP_DAEMON_FANCY( \
+ "\n -o,--oknodo Exit status 0 if nothing done" \
+ "\n -v,--verbose Verbose" \
+ "\n -N,--nicelevel N Add N to process's nice level" \
+ ) \
+ "\n -s,--signal signal Signal to send (default TERM)" \
+ "\n -c,--chuid user[:[grp]] Change to specified user/group" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ "\n -S Start" \
+ "\n -K Stop" \
+ "\n -a pathname Starts process specified by pathname" \
+ "\n -b Put process into background" \
+ "\n -u username|uid Stop this user's processes" \
+ "\n -x executable Program to either start or check" \
+ "\n -n process-name Stop processes with this name" \
+ "\n -p pid-file Save or load pid using a pid-file" \
+ "\n -m Create the -p file and enter pid in it" \
+ "\n -q Quiet" \
USE_FEATURE_START_STOP_DAEMON_FANCY( \
- "\n -o|--oknodo Exit status 0 if nothing done" \
- "\n -v|--verbose Verbose" \
- "\n -N|--nicelevel N Add N to process's nice level" \
+ "\n -o Exit status 0 if nothing done" \
+ "\n -v Verbose" \
+ "\n -N N Add N to process's nice level" \
) \
- "\n -s|--signal signal Signal to send (default TERM)" \
- "\n -c|--chuid user[:[group]] Change to specified user/group"
+ "\n -s signal Signal to send (default TERM)" \
+ "\n -c user[:[grp]] Change to specified user/group" \
+ )
#define stat_trivial_usage \
"[OPTION] FILE..."
)
#define strings_trivial_usage \
- "[-afo] [-n length] [file ...]"
+ "[-afo] [-n length] [file...]"
#define strings_full_usage \
"Display printable strings in a binary file" \
"\n\nOptions:" \
- "\n -a Scan the whole files (this is the default)" \
- "\n -f Precede each string with the name of the file where it was found" \
- "\n -n N Specifies that at least N characters forms a sequence (default 4)" \
- "\n -o Each string is preceded by its decimal offset in the file"
+ "\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 -o Precede strings with decimal offsets"
#define stty_trivial_usage \
"[-a|g] [-F DEVICE] [SETTING]..."
#define sv_trivial_usage \
"[-v] [-w sec] command service..."
#define sv_full_usage \
- "Report the current status and control the state of services " \
- "monitored by the runsv supervisor"
+ "Control services monitored by runsv supervisor.\n" \
+ "Commands (only first character is enough):\n" \
+ "\n" \
+ "status: query service status\n" \
+ "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" \
+ "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" \
+ "STOP, CONT, HUP, ALRM, INT, QUIT, USR1, USR2, TERM, KILL signal to service"
#define svlogd_trivial_usage \
"[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
#define sysctl_full_usage \
"Configure kernel parameters at runtime" \
"\n\nOptions:\n" \
- " -n Use this option to disable printing of the key name when printing values\n" \
- " -w Use this option when you want to change a sysctl setting\n" \
- " -p Load in sysctl settings from the file specified or /etc/sysctl.conf if none given\n" \
- " -a Display all values currently available\n" \
- " -A Display all values currently available in table form"
+ " -n Disable printing of key names\n" \
+ " -e Don't warn about unknown keys\n" \
+ " -w Change sysctl setting\n" \
+ " -p FILE Load sysctl settings from FILE (default /etc/sysctl.conf)\n" \
+ " -a Display all values\n" \
+ " -A Display all values in table form"
#define sysctl_example_usage \
- "sysctl [-n] variable ...\n" \
- "sysctl [-n] -w variable=value ...\n" \
- "sysctl [-n] -a\n" \
- "sysctl [-n] -p file (default /etc/sysctl.conf)\n" \
- "sysctl [-n] -A\n"
+ "sysctl [-n] [-e] variable...\n" \
+ "sysctl [-n] [-e] -w variable=value...\n" \
+ "sysctl [-n] [-e] -a\n" \
+ "sysctl [-n] [-e] -p file (default /etc/sysctl.conf)\n" \
+ "sysctl [-n] [-e] -A\n"
#define syslogd_trivial_usage \
"[OPTION]..."
"System logging utility.\n" \
"Note that this version of syslogd ignores /etc/syslog.conf." \
"\n\nOptions:" \
- "\n -n Run as foreground process" \
- "\n -O FILE Use an alternate log file (default=/var/log/messages)" \
- "\n -l n Sets the local log level of messages to n" \
- "\n -S Make logging output smaller" \
+ "\n -n Run in foreground" \
+ "\n -O FILE Log to given file (default=/var/log/messages)" \
+ "\n -l n Set local log level" \
+ "\n -S Smaller logging output" \
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)") \
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 -L Log locally and via network (default is network only if -R)") \
USE_FEATURE_IPC_SYSLOG( \
- "\n -C[size(KiB)] Log to a shared mem buffer (read the buffer using logread)")
+ "\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)" */
#define syslogd_example_usage \
USE_FEATURE_TAR_BZIP2("j") USE_FEATURE_TAR_LZMA("a") \
USE_FEATURE_TAR_COMPRESS("Z") "xtvO] " \
USE_FEATURE_TAR_FROM("[-X FILE] ") \
- "[-f TARFILE] [-C DIR] [FILE(s)] ..."
+ "[-f TARFILE] [-C DIR] [FILE(s)]..."
#define tar_full_usage \
"Create, extract, or list files from a tar file" \
"\n\nOptions:\n" \
"$ cat /tmp/foo\n" \
"Hello\n"
-#ifdef CONFIG_FEATURE_TELNET_AUTOLOGIN
+#if ENABLE_FEATURE_TELNET_AUTOLOGIN
#define telnet_trivial_usage \
"[-a] [-l USER] HOST [PORT]"
#define telnet_full_usage \
"\n\nOptions:" \
"\n -l LOGIN Exec LOGIN on connect" \
"\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)" \
USE_FEATURE_TELNETD_STANDALONE( \
"\n -p PORT Port to listen to" \
"\n -b ADDR Address to bind to" \
- "\n -F Stay in foreground" \
+ "\n -F Run in foreground" \
"\n -i Run as inetd subservice" \
)
"and show the status for however many processes will fit on the screen."
#define touch_trivial_usage \
- "[-c] FILE [FILE ...]"
+ "[-c] FILE [FILE...]"
#define touch_full_usage \
"Update the last-modified date on the given FILE[s]" \
"\n\nOptions:\n" \
" [-s src_addr] [-t tos] [-w wait] [-g gateway] [-i iface]\n" \
" [-z pausemsecs] host [data size]"
#define traceroute_full_usage \
- "Trace the route ip packets follow going to \"host\"" \
+ "Trace the route to \"host\"" \
"\n\nOptions:\n" \
" -F Set the don't fragment bit\n" \
" -I Use ICMP ECHO instead of UDP datagrams\n" \
" -q nqueries Number of probes per 'ttl' (default 3)\n" \
" -s src_addr IP address to use as the source address\n" \
" -t tos Type-of-service in probe packets (default 0)\n" \
- " -w wait Time in seconds to wait for a response to a probe\n" \
+ " -w wait Time in seconds to wait for a response\n" \
" (default 3 sec)\n" \
- " -g Specify a loose source route gateway (8 max)"
-
+ " -g Loose source route gateway (8 max)"
#define true_trivial_usage \
""
#define udhcpc_trivial_usage \
"[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n" \
- " [-p pidfile] [-r IP] [-s script]"
+ " [-p pidfile] [-r IP] [-s script] [-O dhcp-option]..."
#define udhcpc_full_usage \
- " -V,--vendorclass=CLASSID Set vendor class identifier\n" \
- " -i,--interface=INTERFACE Interface to use (default: eth0)\n" \
- " -H,-h,--hostname=HOSTNAME Client hostname\n" \
- " -c,--clientid=CLIENTID Set client identifier\n" \
- " -C,--clientid-none Suppress default client identifier\n" \
- " -p,--pidfile=file Store process ID of daemon in file\n" \
- " -r,--request=IP IP address to request (default: none)\n" \
- " -s,--script=file Run file at dhcp events (default: /usr/share/udhcpc/default.script)\n" \
- " -t,--retries=NUM Send up to NUM request packets\n"\
- " -f,--foreground Do not fork after getting lease\n" \
- " -b,--background Fork to background if lease cannot be immediately negotiated\n" \
- " -n,--now Exit with failure if lease cannot be immediately negotiated\n" \
- " -q,--quit Quit after obtaining lease\n" \
- " -R,--release Release IP on quit\n" \
- " -v,--version Display version" \
+ USE_GETOPT_LONG( \
+ " -V,--vendorclass=CLASSID Vendor class identifier" \
+ "\n -i,--interface=INTERFACE Interface to use (default eth0)" \
+ "\n -H,-h,--hostname=HOSTNAME Client hostname" \
+ "\n -c,--clientid=CLIENTID Client identifier" \
+ "\n -C,--clientid-none Suppress default client identifier" \
+ "\n -p,--pidfile=file Create pidfile" \
+ "\n -r,--request=IP IP address to request" \
+ "\n -s,--script=file Run file at dhcp events (default /usr/share/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 -A,--tryagain=N Wait N seconds (default 20) after failure" \
+ "\n -f,--foreground Run in foreground" \
+ "\n -b,--background Background if lease is not immediately obtained" \
+ "\n -S,--syslog Log to syslog too" \
+ "\n -n,--now Exit with failure if lease is not immediately obtained" \
+ "\n -q,--quit Quit after obtaining lease" \
+ "\n -R,--release Release IP on quit" \
+ "\n -O,--request-option=OPT Request DHCP option OPT from server" \
+ USE_FEATURE_UDHCPC_ARPING( \
+ "\n -a,--arping Use arping to validate offered address" \
+ ) \
+ ) \
+ SKIP_GETOPT_LONG( \
+ " -V CLASSID Vendor class identifier" \
+ "\n -i INTERFACE Interface to use (default: eth0)" \
+ "\n -H,-h HOSTNAME Client hostname" \
+ "\n -c CLIENTID Client identifier" \
+ "\n -C Suppress default client identifier" \
+ "\n -p file Create pidfile" \
+ "\n -r IP IP address to request" \
+ "\n -s file Run file at dhcp events (default /usr/share/udhcpc/default.script)" \
+ "\n -t N Send up to N request packets" \
+ "\n -T N Try to get a lease for N seconds (default 3)" \
+ "\n -A N Wait N seconds (default 20) after failure" \
+ "\n -f Run in foreground" \
+ "\n -b Background if lease is not immediately obtained" \
+ "\n -S Log to syslog too" \
+ "\n -n Exit with failure if lease is not immediately obtained" \
+ "\n -q Quit after obtaining lease" \
+ "\n -R Release IP on quit" \
+ "\n -O OPT Request DHCP option OPT from server" \
+ USE_FEATURE_UDHCPC_ARPING( \
+ "\n -a Use arping to validate offered address" \
+ ) \
+ )
#define udhcpd_trivial_usage \
- "[configfile]" \
+ "[-fS] [configfile]" \
#define udhcpd_full_usage \
- ""
+ "DHCP server" \
+ "\n -f Run in foreground" \
+ "\n -S Log to syslog too"
#define umount_trivial_usage \
"[flags] FILESYSTEM|DIRECTORY"
"$ umount /dev/hdc1\n"
#define uname_trivial_usage \
- "[OPTION]..."
+ "[-amnrspv]"
#define uname_full_usage \
- "Print certain system information. With no OPTION, same as -s." \
+ "Print system information." \
"\n\nOptions:\n" \
- " -a Print all information\n" \
+ " -a Print all\n" \
" -m The machine (hardware) type\n" \
- " -n Print the machine's network node hostname\n" \
- " -r Print the operating system release\n" \
- " -s Print the operating system name\n" \
- " -p Print the host processor type\n" \
- " -v Print the operating system version"
+ " -n Hostname\n" \
+ " -r OS release\n" \
+ " -s OS name (default)\n" \
+ " -p Processor type\n" \
+ " -v OS version"
#define uname_example_usage \
"$ uname -a\n" \
"Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n"
"Uncompress .Z file[s]" \
"\n\nOptions:\n" \
" -c Extract to stdout\n" \
- " -f Force overwrite an existing file"
+ " -f Overwrite an existing file"
+
+#define unexpand_trivial_usage \
+ "[-f][-a][-t NUM] [FILE|-]"
+#define unexpand_full_usage \
+ "Convert spaces to tabs, writing to standard output." \
+ "\n\nOptions:" \
+ USE_FEATURE_UNEXPAND_LONG_OPTIONS( \
+ "\n -a,--all Convert all blanks" \
+ "\n -f,--first-only Convert only leading blanks" \
+ "\n -t,--tabs=N Tabstops every N chars" \
+ ) \
+ SKIP_FEATURE_UNEXPAND_LONG_OPTIONS( \
+ "\n -a Convert all blanks" \
+ "\n -f Convert only leading blanks" \
+ "\n -t N Tabstops every N chars" \
+ )
#define uniq_trivial_usage \
"[-fscdu]... [INPUT [OUTPUT]]"
#define unzip_full_usage \
"Extract files from ZIP archives" \
"\n\nOptions:\n" \
- " -l List archive contents (short form)\n" \
+ " -l List archive contents (with -q for short form)\n" \
" -n Never overwrite existing files (default)\n" \
" -o Overwrite files without prompting\n" \
" -p Send output to stdout\n" \
"$\n"
#define vconfig_trivial_usage \
- "COMMAND [OPTIONS] ..."
+ "COMMAND [OPTIONS]..."
#define vconfig_full_usage \
"Create and remove virtual ethernet devices" \
"\n\nOptions:\n" \
#define watch_full_usage \
"Execute a program periodically" \
"\n\nOptions:\n" \
- " -n Loop period in seconds - default is 2\n" \
+ " -n Loop period in seconds (default 2)\n" \
" -t Don't print header"
#define watch_example_usage \
"$ watch date\n" \
"Mon Dec 17 10:31:44 GMT 2000"
#define watchdog_trivial_usage \
- "[-t seconds] [-F] DEV"
+ "[-t N[ms]] [-F] DEV"
#define watchdog_full_usage \
"Periodically write to watchdog device DEV" \
- "\n\nOptions:\n" \
- " -t Timer period in seconds - default is 30\n" \
- " -F Stay in the foreground and don't fork"
+ "\n\nOptions:" \
+ "\n -t N Timer period (default 30)" \
+ "\n -F Run in foreground" \
+ "\n" \
+ "\nUse -t 500ms to specify period in milliseconds"
#define wc_trivial_usage \
"[OPTION]... [FILE]..."
" 31 46 1365 /etc/passwd\n"
#define wget_trivial_usage \
+ USE_GETOPT_LONG( \
"[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document file]\n" \
- " [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
- " [-U|--user-agent agent] url"
+ " [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
+ " [-U|--user-agent agent] url" \
+ ) \
+ SKIP_GETOPT_LONG( \
+ "[-csq] [-O file] [-Y on/off] [-P DIR] [-U agent] url" \
+ )
#define wget_full_usage \
"Retrieve files via HTTP or FTP" \
"\n\nOptions:\n" \
" -Y Use proxy ('on' or 'off')"
#define which_trivial_usage \
- "[COMMAND ...]"
+ "[COMMAND...]"
#define which_full_usage \
"Locate a COMMAND"
#define which_example_usage \
"/bin/login\n"
#define who_trivial_usage \
- " "
+ "[-a]"
#define who_full_usage \
- "Print the current user names and related information"
+ "Show who is logged on" \
+ "\n\nOptions:\n" \
+ " -a show all"
#define whoami_trivial_usage \
""
#define zcip_full_usage \
"Manage a ZeroConf IPv4 link-local address" \
"\n\nOptions:\n" \
- " -f Foreground mode\n" \
+ " -f Run in foreground\n" \
" -q Quit after address (no daemon)\n" \
" -r 169.254.x.x Request this address first\n" \
" -v Verbose"
projects / oweals / busybox.git / blobdiff