randomtest fixes
[oweals/busybox.git] / include / usage.h
index f3d89d341914d42537bc8178bd7a7555bc137e65..9d9ad008bad554b6aa60b20b05fc4ee8f86ba8cb 100644 (file)
      "\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       -s      Image" \
-     "\n       -c      Hide cursor" \
-     "\n       -d      Framebuffer device (default /dev/fb0)" \
-     "\n       -i      Config file (var=value):" \
-     "\n                       BAR_LEFT,BAR_TOP,BAR_WIDTH,BAR_HEIGHT" \
-     "\n                       BAR_R,BAR_G,BAR_B" \
-     "\n       -f      Control pipe (else exit after drawing image)" \
-     "\n                       commands: 'NN' (% for progress bar) or 'exit'" \
+#define bootchartd_trivial_usage \
+       "start [PROG ARGS]|stop|init"
+#define bootchartd_full_usage "\n\n" \
+       "Create /var/log/bootchart.tgz with boot chart data\n" \
+     "\nOptions:" \
+     "\nstart: start background logging; with PROG, run PROG, then kill logging with USR1" \
+     "\nstop: send USR1 to all bootchartd processes" \
+     "\ninit: start background logging; stop when getty/xdm is seen (for init scripts)" \
+     "\nUnder PID 1: as init, then exec $bootchart_init, /init, /sbin/init" \
 
 #define brctl_trivial_usage \
        "COMMAND [BRIDGE [INTERFACE]]"
        "Clear screen"
 
 #define cmp_trivial_usage \
-       "[-l] [-s] FILE1 [FILE2" IF_DESKTOP(" [SKIP1 [SKIP2]") "]]"
+       "[-l] [-s] FILE1 [FILE2" IF_DESKTOP(" [SKIP1 [SKIP2]]") "]"
 #define cmp_full_usage "\n\n" \
-       "Compares FILE1 vs stdin if FILE2 is not specified\n" \
+       "Compare FILE1 with FILE2 (or stdin)\n" \
      "\nOptions:" \
      "\n       -l      Write the byte numbers (decimal) and values (octal)" \
      "\n               for all differing bytes" \
 #define comm_trivial_usage \
        "[-123] FILE1 FILE2"
 #define comm_full_usage "\n\n" \
-       "Compare FILE1 to FILE2, or to stdin if - is specified\n" \
+       "Compare FILE1 with FILE2\n" \
      "\nOptions:" \
      "\n       -1      Suppress lines unique to FILE1" \
      "\n       -2      Suppress lines unique to FILE2" \
 #define dpkg_full_usage "\n\n" \
        "Install, remove and manage Debian packages\n" \
      "\nOptions:" \
+       IF_LONG_OPTS( \
+     "\n       -i,--install    Install the package" \
+     "\n       -l,--list       List of installed packages" \
+     "\n       --configure     Configure an unpackaged package" \
+     "\n       -P,--purge      Purge all files of a package" \
+     "\n       -r,--remove     Remove all but the configuration files for a package" \
+     "\n       --unpack        Unpack a package, but don't configure it" \
+     "\n       --force-depends Ignore dependency problems" \
+     "\n       --force-confnew Overwrite existing config files when installing" \
+     "\n       --force-confold Keep old config files when installing" \
+       ) \
+       IF_NOT_LONG_OPTS( \
      "\n       -i              Install the package" \
      "\n       -l              List of installed packages" \
      "\n       -C              Configure an unpackaged package" \
-     "\n       -F depends      Ignore dependency problems" \
      "\n       -P              Purge all files of a package" \
      "\n       -r              Remove all but the configuration files for a package" \
      "\n       -u              Unpack a package, but don't configure it" \
+     "\n       -F depends      Ignore dependency problems" \
+     "\n       -F confnew      Overwrite existing config files when installing" \
+     "\n       -F confold      Keep old config files when installing" \
+       )
 
 #define dpkg_deb_trivial_usage \
        "[-cefxX] FILE [argument]"
      "\n       -p pass         Append four or six byte password PW to the packet" \
 
 #define expand_trivial_usage \
-       "[-i] [-t N] [FILE|-]"
+       "[-i] [-t N] [FILE]..."
 #define expand_full_usage "\n\n" \
        "Convert tabs to spaces, writing to stdout\n" \
      "\nOptions:" \
        "$ echo $?\n" \
        "1\n"
 
+#define fbsplash_trivial_usage \
+       "-s IMGFILE [-c] [-d DEV] [-i INIFILE] [-f CMD]"
+#define fbsplash_full_usage "\n\n" \
+       "Options:" \
+     "\n       -s      Image" \
+     "\n       -c      Hide cursor" \
+     "\n       -d      Framebuffer device (default /dev/fb0)" \
+     "\n       -i      Config file (var=value):" \
+     "\n                       BAR_LEFT,BAR_TOP,BAR_WIDTH,BAR_HEIGHT" \
+     "\n                       BAR_R,BAR_G,BAR_B" \
+     "\n       -f      Control pipe (else exit after drawing image)" \
+     "\n                       commands: 'NN' (% for progress bar) or 'exit'" \
+
 #define fbset_trivial_usage \
        "[OPTIONS] [MODE]"
 #define fbset_full_usage "\n\n" \
        ) \
      "\n       -b 2048         (for certain MO disks) use 2048-byte sectors" \
      "\n       -C CYLINDERS    Set number of cylinders/heads/sectors" \
-     "\n       -H HEADS\n" \
+     "\n       -H HEADS" \
      "\n       -S SECTORS" \
 
 #define blkid_trivial_usage \
 #define getsebool_trivial_usage \
        "-a or getsebool boolean..."
 #define getsebool_full_usage "\n\n" \
-       "       -a      Show all SELinux booleans"
+       "       -a      Show all selinux booleans"
 
 #define getty_trivial_usage \
        "[OPTIONS] BAUD_RATE TTY [TERMTYPE]"
      "\n       -H HOST         Log HOST into the utmp file as the hostname" \
 
 #define grep_trivial_usage \
-       "[-HhnlLoqvsri" \
-       IF_DESKTOP("w") \
+       "[-HhnlLoqvsriw" \
        "F" \
        IF_FEATURE_GREP_EGREP_ALIAS("E") \
        IF_EXTRA_COMPAT("z") \
      "\n       -s      Suppress open and read errors" \
      "\n       -r      Recurse" \
      "\n       -i      Ignore case" \
-       IF_DESKTOP( \
      "\n       -w      Match whole words only" \
-       ) \
      "\n       -F      PATTERN is a literal (not regexp)" \
        IF_FEATURE_GREP_EGREP_ALIAS( \
      "\n       -E      PATTERN is an extended regexp" \
      "\n       -i              Inetd mode" \
      "\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)" \
        IF_FEATURE_HTTPD_SETUID( \
      "\n       -u USER[:GRP]   Set uid/gid after binding to port") \
        IF_FEATURE_HTTPD_BASIC_AUTH( \
      "\n       -r REALM        Authentication Realm for Basic Authentication") \
      "\n       -h HOME         Home directory (default .)" \
+     "\n       -c FILE         Configuration file (default {/etc,HOME}/httpd.conf)" \
        IF_FEATURE_HTTPD_AUTH_MD5( \
      "\n       -m STRING       MD5 crypt STRING") \
      "\n       -e STRING       HTML encode STRING" \
        "Halt and shut off power\n" \
      "\nOptions:" \
      "\n       -d      Delay interval for halting" \
-     "\n       -n      No call to sync()" \
+     "\n       -n      Do not sync" \
      "\n       -f      Force power off (don't go through init)" \
 
 #define printenv_trivial_usage \
        "Report process status\n" \
        USAGE_PS \
        IF_SELINUX( \
-     "\n       -Z      Show SE Linux context" \
+     "\n       -Z      Show selinux context" \
        ) \
        IF_FEATURE_PS_WIDE( \
      "\n       w       Wide output" \
        "Options:" \
      "\n       -m mapfile      (Default: /boot/System.map)" \
      "\n       -p profile      (Default: /proc/profile)" \
-     "\n       -M mult         Set the profiling multiplier to mult" \
+     "\n       -M NUM          Set the profiling multiplier to NUM" \
      "\n       -i              Print only info about the sampling step" \
      "\n       -v              Verbose" \
      "\n       -a              Print all symbols, even if count is 0" \
        "Resize the screen"
 
 #define restorecon_trivial_usage \
-       "[-iFnrRv] [-e excludedir]... [-o filename] [-f filename | pathname]"
+       "[-iFnRv] [-e EXCLUDEDIR]... [-o FILE] [-f FILE]"
 #define restorecon_full_usage "\n\n" \
        "Reset security contexts of files in pathname\n" \
-     "\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" \
-     "\n       -n              Don't change any file labels" \
-     "\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" \
-     "\n                       for customizable files, or the user section," \
-     "\n                       if it has changed" \
+     "\n       -i      Ignore files that don't exist" \
+     "\n       -f FILE File with list of files to process" \
+     "\n       -e DIR  Directory to exclude" \
+     "\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       -vv     Show changed labels" \
+     "\n       -F      Force reset of context to match file_context" \
+     "\n               for customizable files, or the user section," \
+     "\n               if it has changed" \
+
+#define rfkill_trivial_usage \
+       "COMMAND [INDEX|TYPE]"
+#define rfkill_full_usage "\n\n" \
+       "Enable/disable wireless devices\n" \
+       "\nCommands:" \
+     "\n       list [INDEX|TYPE]       List current state" \
+     "\n       block INDEX|TYPE        Disable device" \
+     "\n       unblock INDEX|TYPE      Enable device" \
+     "\n" \
+     "\n       TYPE: all, wlan(wifi), bluetooth, uwb(ultrawideband)," \
+     "\n               wimax, wwan, gps, fm" \
 
 #define rm_trivial_usage \
        "[OPTIONS] FILE..."
      "\n       -A inet" IF_FEATURE_IPV6("{6}") "       Select address family" \
 
 #define rpm_trivial_usage \
-       "-i -q[ildc]p PACKAGE.rpm"
+       "-i PACKAGE.rpm; rpm -qp[ildc] PACKAGE.rpm"
 #define rpm_full_usage "\n\n" \
        "Manipulate RPM packages\n" \
-     "\nOptions:" \
+     "\nCommands:" \
      "\n       -i      Install package" \
-     "\n       -q      Query package" \
-     "\n       -p      Query uninstalled package" \
+     "\n       -qp     Query package" \
+     "\nOptions:" \
      "\n       -i      Show information" \
      "\n       -l      List contents" \
      "\n       -d      List documents" \
 
 #define runcon_trivial_usage \
        "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] PROG ARGS\n" \
-       "       runcon CONTEXT PROG ARGS"
+       "runcon CONTEXT PROG ARGS"
 #define runcon_full_usage "\n\n" \
        "Run PROG in a different security context\n" \
      "\n       CONTEXT         Complete security context\n" \
 #define script_full_usage "\n\n" \
        "Options:" \
      "\n       -a      Append output" \
-     "\n       -c      Run PROG, not shell" \
+     "\n       -c PROG Run PROG, not shell" \
      "\n       -f      Flush output after each write" \
      "\n       -q      Quiet" \
        IF_SCRIPTREPLAY( \
        "See setsid(2) for details." \
 
 #define last_trivial_usage \
-       ""IF_FEATURE_LAST_FANCY("[-HW] [-f file]")
+       ""IF_FEATURE_LAST_FANCY("[-HW] [-f FILE]")
 #define last_full_usage "\n\n" \
        "Show listing of the last users that logged into the system" \
        IF_FEATURE_LAST_FANCY( "\n" \
      "\nOptions:" \
 /*   "\n       -H      Show header line" */ \
      "\n       -W      Display with no host column truncation" \
-     "\n       -f file Read from file instead of /var/log/wtmp" \
+     "\n       -f FILE Read from FILE instead of /var/log/wtmp" \
        )
 
 #define showkey_trivial_usage \
        " %d    Free file nodes in file system\n" \
        " %f    Free blocks in file system\n" \
        IF_SELINUX( \
-       " %C    Security context in SELinux\n" \
+       " %C    Security context in selinux\n" \
        ) \
        " %i    File System ID in hex\n" \
        " %l    Maximum length of filenames\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..."
+       "[-ttv] [-r C] [-R CHARS] [-l MATCHLEN] [-b BUFLEN] DIR..."
 #define svlogd_full_usage "\n\n" \
        "Continuously read log data from stdin, optionally\n" \
        "filter log messages, and write the data to one or more automatically\n" \
      "\n       -s,--script PROG        Run PROG at DHCP events (default "CONFIG_UDHCPC_DEFAULT_SCRIPT")" \
      "\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       -x OPT:VAL              Include option OPT in sent packets (cumulative)" \
-     "\n       -O,--request-option OPT Request DHCP option OPT (cumulative)" \
-     "\n       -o,--no-default-options Don't request any options (unless -O is given)" \
+     "\n       -A,--tryagain N         Wait N seconds after failure (default 20)" \
      "\n       -f,--foreground         Run in foreground" \
        USE_FOR_MMU( \
      "\n       -b,--background         Background if lease is not obtained" \
        IF_FEATURE_UDHCPC_ARPING( \
      "\n       -a,--arping             Use arping to validate offered address" \
        ) \
+     "\n       -O,--request-option OPT Request DHCP option OPT (cumulative)" \
+     "\n       -o,--no-default-options Don't request any options (unless -O is given)" \
+     "\n       -x OPT:VAL              Include option OPT in sent packets (cumulative)" \
      "\n       -F,--fqdn NAME          Ask server to update DNS mapping for NAME" \
      "\n       -H,-h,--hostname NAME   Send NAME as client hostname (default none)" \
      "\n       -V,--vendorclass VENDOR Vendor identifier (default 'udhcp VERSION')" \
        "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n"
 
 #define uncompress_trivial_usage \
-       "[-c] [-f] [FILE]..."
+       "[-cf] [FILE]..."
 #define uncompress_full_usage "\n\n" \
        "Uncompress .Z file[s]\n" \
      "\nOptions:" \
      "\n       -f      Overwrite an existing file" \
 
 #define unexpand_trivial_usage \
-       "[-f][-a][-t N] [FILE|-]"
+       "[-fa][-t N] [FILE]..."
 #define unexpand_full_usage "\n\n" \
        "Convert spaces to tabs, writing to stdout\n" \
      "\nOptions:" \
        )
 
 #define uniq_trivial_usage \
-       "[-fscduw]... [INPUT [OUTPUT]]"
+       "[-cdu][-f,s,w N] [INPUT [OUTPUT]]"
 #define uniq_full_usage "\n\n" \
        "Discard duplicate lines\n" \
      "\nOptions:" \
        "c\n"
 
 #define unzip_trivial_usage \
-       "[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]"
+       "[-opts[modifiers]] FILE[.zip] [LIST] [-x XLIST] [-d DIR]"
 #define unzip_full_usage "\n\n" \
        "Extract files from ZIP archives\n" \
      "\nOptions:" \
      "\n       -o      Overwrite files without prompting" \
      "\n       -p      Send output to stdout" \
      "\n       -q      Quiet" \
-     "\n       -x      Exclude these files" \
-     "\n       -d      Extract files into this directory" \
+     "\n       -x XLST Exclude these files" \
+     "\n       -d DIR  Extract files into DIR" \
 
 #define uptime_trivial_usage \
        ""
 
 #define wget_trivial_usage \
        IF_FEATURE_WGET_LONG_OPTIONS( \
-       "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document file]\n" \
+       "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document FILE]\n" \
        "       [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
-       "       [--no-check-certificate] [-U|--user-agent agent] url" \
+       "       [--no-check-certificate] [-U|--user-agent AGENT] URL" \
        ) \
        IF_NOT_FEATURE_WGET_LONG_OPTIONS( \
-       "[-csq] [-O file] [-Y on/off] [-P DIR] [-U agent] url" \
+       "[-csq] [-O FILE] [-Y on/off] [-P DIR] [-U AGENT] URL" \
        )
 #define wget_full_usage "\n\n" \
        "Retrieve files via HTTP or FTP\n" \
      "\n       -c      Continue retrieval of aborted transfer" \
      "\n       -q      Quiet" \
      "\n       -P      Set directory prefix to DIR" \
-     "\n       -O      Save to filename ('-' for stdout)" \
-     "\n       -U      Adjust 'User-Agent' field" \
+     "\n       -O FILE Save to FILE ('-' for stdout)" \
+     "\n       -U STR  Use STR for User-Agent header" \
      "\n       -Y      Use proxy ('on' or 'off')" \
 
 #define which_trivial_usage \