microcom: split -d (delay) option away from -t
[oweals/busybox.git] / include / usage.h
index 82a17578ae44ccb3fc35ddc3528c38ccb1b6e3de..37cefeab192be17af8535ee85b52cf49d4bea806 100644 (file)
        "$ basename /foo/bar.txt .txt\n" \
        "bar"
 
+#define brctl_trivial_usage \
+       "COMMAND [BRIDGE [INTERFACE]]"
+#define brctl_full_usage \
+       "Manage ethernet bridges." \
+       "\n\nCommands:\n" \
+       "       addbr <bridge>          Create <bridge>\n" \
+       "       delbr <bridge>          Delete <bridge>\n" \
+       "       addif <bridge> <iface>  Add <iface> to <bridge>\n" \
+       "       delif <bridge> <iface>  Delete <iface> from <bridge>" \
+USE_FEATURE_BRCTL_FANCY("\n" \
+       "       setageing <bridge <time>        set ageing time\n" \
+       "       setfd <bridge <time>            set bridge forward delay\n" \
+       "       sethello <bridge <time>         set hello time\n" \
+       "       setmaxage <bridge <time>        set max message age\n" \
+       "       setpathcost <bridge <cost>      set path cost\n" \
+       "       setportprio <bridge <prio>      set port priority\n" \
+       "       setbridgeprio <bridge <prio>    set bridge priority\n" \
+       "       stp <bridge> [1|0]              turn stp on/off\n" \
+)
 #define bunzip2_trivial_usage \
        "[OPTION]... [FILE]"
 #define bunzip2_full_usage \
 #define eject_full_usage \
        "Eject specified DEVICE (or default /dev/cdrom)" \
        "\n\nOptions:\n" \
+       USE_FEATURE_EJECT_SCSI( \
+       "       -s      scsi device\n" \
+       ) \
        "       -t      Close tray\n" \
        "       -T      Open/close tray (toggle)"
 
        "       -S SECTORS      Set the number of sectors\n" \
        "       -v              Give fdisk version"
 
+#define fetchmail_trivial_usage \
+       "[-C dir] [-w timeout] [-U user] -P password [-X] [-t] [-z] server[:port]"
+#define fetchmail_full_usage \
+       "Fetch content of remote mailbox to local Maildir." \
+       "\n\nOptions:\n" \
+       "       -C dir          Set Maildir location\n" \
+       "       -w timeout      Set timeout on network operations\n" \
+       "       -U username     Authenticate with specified username\n" \
+       "       -P password     Authenticate with specified password\n" \
+       "       -X              Use openssl connection helper for secured servers\n" \
+       "       -t              Get only headers\n" \
+       "       -z              Delete messages on server"
+
 #define find_trivial_usage \
        "[PATH...] [EXPRESSION]"
 #define find_full_usage \
      "\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( \
        "[-d delay] [-n] [-f]"
 #define halt_full_usage \
        "Halt the system" \
-       "\n\nOptions:\n" \
-       "       -d      Delay interval for halting\n" \
-       "       -n      No call to sync()\n" \
-       "       -f      Force halt (don't go through init)"
+       "\n\nOptions:" \
+       "\n     -d      Delay interval for halting" \
+       "\n     -n      No call to sync()" \
+       "\n     -f      Force halt (don't go through init)" \
+       USE_FEATURE_WTMP( \
+       "\n     -w      Only write a wtmp record" \
+       )
 
 #define hdparm_trivial_usage \
        "[options] [device] .."
        "       n       Disallow write access to your terminal"
 
 #define microcom_trivial_usage \
-       "[-s speed] tty-name"
+       "[-d DELAY] [-t TIMEOUT] [-s SPEED] [-X] TTY"
 #define microcom_full_usage \
-       ""
+       "Copy bytes for stdin to TTY and from TTY to stdout" \
+       "\n\nOptions:" \
+     "\n       -d      Wait up to DELAY ms for TTY output before sending every" \
+     "\n               next byte to it" \
+     "\n       -t      Exit if both stdin and TTY are silent for TIMEOUT ms" \
+     "\n       -s      Set serial line to SPEED"
+     "\n       -X      Disable special meaning of NUL and Ctrl-X from stdin"
 
 #define mkdir_trivial_usage \
        "[OPTION] DIRECTORY..."
        "       block-count     Number of block to use (default is entire partition)"
 
 #define mktemp_trivial_usage \
-       "[-dq] TEMPLATE"
+       "[-dt] [-p DIR] TEMPLATE"
 #define mktemp_full_usage \
        "Create a temporary file with its name based on TEMPLATE.\n" \
        "TEMPLATE is any name with six 'Xs' (i.e., /tmp/temp.XXXXXX)." \
        "\n\nOptions:\n" \
        "       -d      Make a directory instead of a file\n" \
-       "       -q      Fail silently if an error occurs"
+       /* "    -q      Fail silently if an error occurs\n" - we ignore it */ \
+       "       -t      Generate a path rooted in temporary directory\n" \
+       "       -p DIR  Use DIR as a temporary directory (implies -t)\n" \
+       "\n" \
+       "For -t or -p, directory is chosen as follows:\n" \
+       "$TMPDIR if set, else -p DIR, else /tmp"
+
 #define mktemp_example_usage \
        "$ mktemp /tmp/temp.XXXXXX\n" \
        "/tmp/temp.mWiLjM\n" \
        "Address:    127.0.0.1\n"
 
 #define od_trivial_usage \
-       "[-aBbcDdeFfHhIiLlOovXx] [FILE]"
+       "[-aBbcDdeFfHhIiLlOovXx] " USE_DESKTOP("[-t TYPE] ") "[FILE]"
 #define od_full_usage \
        "Write an unambiguous representation, octal bytes by default, of FILE\n" \
-       "to standard output. With no FILE, or when FILE is -, read standard input."
+       "to standard output. With no FILE or when FILE is -, read standard input."
 
 #define openvt_trivial_usage \
        "VTNUM COMMAND [ARGS...]"
@@ -3111,6 +3162,23 @@ USE_FEATURE_RUN_PARTS_FANCY("\n  -l      Prints names of all matching files even when
 #define selinuxenabled_trivial_usage
 #define selinuxenabled_full_usage
 
+#define sendmail_trivial_usage \
+       "[-C dir] [-w timeout] [-U user] [-P password] [-X]\n" \
+       "-t to [-t to] -f from [-n] [-s subject] [-c charset] server[:port] [body] [attachment ...]"
+#define sendmail_full_usage \
+       "Send an email with optional attachments." \
+       "\n\nOptions:\n" \
+       "       -C dir          Change current directory to dir\n" \
+       "       -w timeout      Set timeout on network operations\n" \
+       "       -U username     Authenticate with specified username\n" \
+       "       -P password     Authenticate with specified password\n" \
+       "       -X              Use openssl connection helper for secured servers\n" \
+       "       -t to           Recipient email. May be multiple\n" \
+       "       -f from         Sender address\n" \
+       "       -n              Request delivery notification to sender\n" \
+       "       -s subject      Subject\n" \
+       "       -c charset      Assumed charset for body and subject [utf-8]"
+
 #define seq_trivial_usage \
        "[first [increment]] last"
 #define seq_full_usage \
@@ -3194,15 +3262,7 @@ USE_FEATURE_RUN_PARTS_FANCY("\n  -l      Prints names of all matching files even when
        "[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 \
        ""
@@ -3361,7 +3421,7 @@ USE_FEATURE_RUN_PARTS_FANCY("\n   -l      Prints names of all matching files even when
        USE_FEATURE_STAT_FORMAT( \
        "       -c fmt  Use the specified format\n") \
        "       -f      Display filesystem status\n" \
-       "       -L,-l   Dereference links\n" \
+       "       -L      Dereference links\n" \
        "       -t      Display info in terse form" \
        USE_SELINUX( \
        "\n     -Z      Print security context" \
@@ -3513,16 +3573,17 @@ USE_FEATURE_RUN_PARTS_FANCY("\n -l      Prints names of all matching files even when
        "Configure kernel parameters at runtime" \
        "\n\nOptions:\n" \
        "       -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]..."
@@ -3548,6 +3609,11 @@ USE_FEATURE_RUN_PARTS_FANCY("\n  -l      Prints names of all matching files even when
        "$ syslogd -R masterlog:514\n" \
        "$ syslogd -R 192.168.1.1:601\n"
 
+#define tac_trivial_usage \
+       "[FILE]..."
+#define tac_full_usage \
+       "Concatenates FILE(s) and prints them to stdout in reverse"
+
 #define tail_trivial_usage \
        "[OPTION]... [FILE]..."
 #define tail_full_usage \
@@ -3846,7 +3912,7 @@ USE_FEATURE_RUN_PARTS_FANCY("\n   -l      Prints names of all matching files even when
 
 #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]..." USE_FEATURE_UDHCP_PORT(" [-P N]")
 #define udhcpc_full_usage \
        USE_GETOPT_LONG( \
        "       -V,--vendorclass=CLASSID        Vendor class identifier" \
@@ -3866,6 +3932,10 @@ USE_FEATURE_RUN_PARTS_FANCY("\n  -l      Prints names of all matching files even when
        "\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_UDHCP_PORT( \
+       "\n     -P,--client-port N  Use port N instead of default 68" \
+       ) \
        USE_FEATURE_UDHCPC_ARPING( \
        "\n     -a,--arping     Use arping to validate offered address" \
        ) \
@@ -3888,18 +3958,25 @@ USE_FEATURE_RUN_PARTS_FANCY("\n -l      Prints names of all matching files even when
        "\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_UDHCP_PORT( \
+       "\n     -P N            Use port N instead of default 68" \
+       ) \
        USE_FEATURE_UDHCPC_ARPING( \
        "\n     -a              Use arping to validate offered address" \
        ) \
        )
 
 #define udhcpd_trivial_usage \
-       "[-fS] [configfile]" \
+       "[-fS]" USE_FEATURE_UDHCP_PORT(" [-P N]") " [configfile]" \
 
 #define udhcpd_full_usage \
        "DHCP server" \
        "\n     -f      Run in foreground" \
-       "\n     -S      Log to syslog too"
+       "\n     -S      Log to syslog too" \
+       USE_FEATURE_UDHCP_PORT( \
+       "\n     -P N    Use port N instead of default 67" \
+       )
 
 #define umount_trivial_usage \
        "[flags] FILESYSTEM|DIRECTORY"