include/usage.h

   1 /* vi: set sw=8 ts=8: */
   2 /*
   3  * This file suffers from chronically incorrect tabification
   4  * of messages. Before editing this file:
   5  * 1. Switch you editor to 8-space tab mode.
   6  * 2. Do not use \t in messages, use real tab character.
   7  * 3. Start each source line with message as follows:
   8  *    |<7 spaces>"text with tabs"....
   9  * or
  10  *    |<5 spaces>"\ntext with tabs"....
  11  */
  12
  13 #ifndef __BB_USAGE_H__
  14 #define __BB_USAGE_H__
  15
  16 #define addgroup_trivial_usage \
  17        "[-g GID] " USE_FEATURE_ADDUSER_TO_GROUP("[user_name] ") "group_name"
  18 #define addgroup_full_usage \
  19        "Add a group " USE_FEATURE_ADDUSER_TO_GROUP("or add an user to a group") "\n" \
  20      "\nOptions:" \
  21      "\n        -g GID  Group id"
  22
  23 #define adduser_trivial_usage \
  24        "[OPTIONS] user_name"
  25 #define adduser_full_usage \
  26        "Add an user\n" \
  27      "\nOptions:" \
  28      "\n        -h DIR          Home directory" \
  29      "\n        -g GECOS        GECOS field" \
  30      "\n        -s SHELL        Login shell" \
  31      "\n        -G GROUP        Add user to existing group" \
  32      "\n        -S              Create a system user" \
  33      "\n        -D              Do not assign a password" \
  34      "\n        -H              Do not create home directory" \
  35
  36 #define adjtimex_trivial_usage \
  37        "[-q] [-o offset] [-f frequency] [-p timeconstant] [-t tick]"
  38 #define adjtimex_full_usage \
  39        "Read and optionally set system timebase parameters. See adjtimex(2).\n" \
  40      "\nOptions:" \
  41      "\n        -q              Quiet" \
  42      "\n        -o offset       Time offset, microseconds" \
  43      "\n        -f frequency    Frequency adjust, integer kernel units (65536 is 1ppm)" \
  44      "\n                        (positive values make clock run faster)" \
  45      "\n        -t tick         Microseconds per tick, usually 10000" \
  46      "\n        -p timeconstant" \
  47
  48 #define ar_trivial_usage \
  49        "[-o] [-v] [-p] [-t] [-x] ARCHIVE FILES"
  50 #define ar_full_usage \
  51        "Extract or list FILES from an ar archive\n" \
  52      "\nOptions:" \
  53      "\n        -o      Preserve original dates" \
  54      "\n        -p      Extract to stdout" \
  55      "\n        -t      List" \
  56      "\n        -x      Extract" \
  57      "\n        -v      Verbose" \
  58
  59 #define arp_trivial_usage \
  60        "\n" \
  61        "[-vn]   [-H type] [-i if] -a [hostname]\n" \
  62        "[-v]              [-i if] -d hostname [pub]\n" \
  63        "[-v]    [-H type] [-i if] -s hostname hw_addr [temp]\n" \
  64        "[-v]    [-H type] [-i if] -s hostname hw_addr [netmask nm] pub\n" \
  65        "[-v]    [-H type] [-i if] -Ds hostname ifa [netmask nm] pub\n"
  66 #define arp_full_usage \
  67        "Manipulate ARP cache\n" \
  68      "\nOptions:" \
  69        "\n      -a              Display (all) hosts" \
  70        "\n      -s              Set new ARP entry" \
  71        "\n      -d              Delete a specified entry" \
  72        "\n      -v              Verbose" \
  73        "\n      -n              Don't resolve names" \
  74        "\n      -i IF           Network interface" \
  75        "\n      -D              Read <hwaddr> from given device" \
  76        "\n      -A, -p AF       Protocol family" \
  77        "\n      -H HWTYPE       Hardware address type" \
  78
  79 #define arping_trivial_usage \
  80        "[-fqbDUA] [-c count] [-w timeout] [-I dev] [-s sender] target"
  81 #define arping_full_usage \
  82        "Send ARP requests/replies\n" \
  83      "\nOptions:" \
  84      "\n        -f              Quit on first ARP reply" \
  85      "\n        -q              Quiet" \
  86      "\n        -b              Keep broadcasting, don't go unicast" \
  87      "\n        -D              Duplicated address detection mode" \
  88      "\n        -U              Unsolicited ARP mode, update your neighbors" \
  89      "\n        -A              ARP answer mode, update your neighbors" \
  90      "\n        -c N            Stop after sending N ARP requests" \
  91      "\n        -w timeout      Time to wait for ARP reply, in seconds" \
  92      "\n        -I dev          Interface to use (default eth0)" \
  93      "\n        -s sender       Sender IP address" \
  94      "\n        target          Target IP address" \
  95
  96 #define ash_trivial_usage \
  97        "[FILE]...\n" \
  98        "or: ash -c command [args]..."
  99 #define ash_full_usage \
 100        "The ash shell"
 101
 102 #define awk_trivial_usage \
 103        "[OPTION]... [program-text] [FILE...]"
 104 #define awk_full_usage \
 105        "Options:" \
 106      "\n        -v var=val      Set variable" \
 107      "\n        -F sep          Use sep as field separator" \
 108      "\n        -f file         Read program from file" \
 109
 110 #define basename_trivial_usage \
 111        "FILE [SUFFIX]"
 112 #define basename_full_usage \
 113        "Strip directory path and suffixes from FILE.\n" \
 114        "If specified, also remove any trailing SUFFIX."
 115 #define basename_example_usage \
 116        "$ basename /usr/local/bin/foo\n" \
 117        "foo\n" \
 118        "$ basename /usr/local/bin/\n" \
 119        "bin\n" \
 120        "$ basename /foo/bar.txt .txt\n" \
 121        "bar"
 122
 123 #define fbsplash_trivial_usage \
 124        "-s IMGFILE [-c] [-d DEV] [-i INIFILE] [-f CMD]"
 125 #define fbsplash_full_usage \
 126        "Options:\n" \
 127      "\n        -s      Image" \
 128      "\n        -c      Hide cursor" \
 129      "\n        -d      Framebuffer device (default /dev/fb0)" \
 130      "\n        -i      Config file (var=value):" \
 131      "\n                        BAR_LEFT,BAR_TOP,BAR_WIDTH,BAR_HEIGHT" \
 132      "\n                        BAR_R,BAR_G,BAR_B" \
 133      "\n        -f      Control pipe (else exit after drawing image)" \
 134      "\n                        commands: 'NN' (% for progress bar) or 'exit'" \
 135
 136 #define brctl_trivial_usage \
 137        "COMMAND [BRIDGE [INTERFACE]]"
 138 #define brctl_full_usage \
 139        "Manage ethernet bridges.\n" \
 140      "\nCommands:" \
 141      "\n        addbr BRIDGE            Create BRIDGE" \
 142      "\n        delbr BRIDGE            Delete BRIDGE" \
 143      "\n        addif BRIDGE IFACE      Add IFACE to BRIDGE" \
 144      "\n        delif BRIDGE IFACE      Delete IFACE from BRIDGE" \
 145         USE_FEATURE_BRCTL_FANCY( \
 146      "\n        setageing BRIDGE TIME           Set ageing time" \
 147      "\n        setfd BRIDGE TIME               Set bridge forward delay" \
 148      "\n        sethello BRIDGE TIME            Set hello time" \
 149      "\n        setmaxage BRIDGE TIME           Set max message age" \
 150      "\n        setpathcost BRIDGE COST         Set path cost" \
 151      "\n        setportprio BRIDGE PRIO         Set port priority" \
 152      "\n        setbridgeprio BRIDGE PRIO       Set bridge priority" \
 153      "\n        stp BRIDGE [1|0]                STP on/off" \
 154         )
 155 #define bunzip2_trivial_usage \
 156        "[OPTION]... [FILE]"
 157 #define bunzip2_full_usage \
 158        "Uncompress FILE (or standard input if FILE is '-' or omitted)\n" \
 159      "\nOptions:" \
 160      "\n        -c      Write to standard output" \
 161      "\n        -f      Force" \
 162
 163 #define bzip2_trivial_usage \
 164        "[OPTION]... [FILE]..."
 165 #define bzip2_full_usage \
 166        "Compress FILE(s) with bzip2 algorithm.\n" \
 167        "When FILE is '-' or unspecified, reads standard input. Implies -c.\n" \
 168      "\nOptions:" \
 169      "\n        -c      Write to standard output" \
 170      "\n        -d      Decompress" \
 171      "\n        -f      Force" \
 172      "\n        -1..-9  Compression level" \
 173
 174 #define busybox_notes_usage \
 175        "Hello world!\n"
 176
 177 #define bzcat_trivial_usage \
 178        "FILE"
 179 #define bzcat_full_usage \
 180        "Uncompress to stdout"
 181
 182 #define unlzma_trivial_usage \
 183        "[OPTION]... [FILE]"
 184 #define unlzma_full_usage \
 185        "Uncompress FILE (or standard input if FILE is '-' or omitted)\n" \
 186      "\nOptions:" \
 187      "\n        -c      Write to standard output" \
 188      "\n        -f      Force" \
 189
 190 #define lzmacat_trivial_usage \
 191        "FILE"
 192 #define lzmacat_full_usage \
 193        "Uncompress to stdout"
 194
 195 #define cal_trivial_usage \
 196        "[-jy] [[month] year]"
 197 #define cal_full_usage \
 198        "Display a calendar\n" \
 199      "\nOptions:" \
 200      "\n        -j      Use julian dates" \
 201      "\n        -y      Display the entire year" \
 202
 203 #define cat_trivial_usage \
 204        "[-u] [FILE]..."
 205 #define cat_full_usage \
 206        "Concatenate FILE(s) and print them to stdout\n" \
 207      "\nOptions:" \
 208      "\n        -u      Use unbuffered i/o (ignored)" \
 209
 210 #define cat_example_usage \
 211        "$ cat /proc/uptime\n" \
 212        "110716.72 17.67"
 213
 214 #define catv_trivial_usage \
 215        "[-etv] [FILE]..."
 216 #define catv_full_usage \
 217        "Display nonprinting characters as ^x or M-x\n" \
 218      "\nOptions:" \
 219      "\n        -e      End each line with $" \
 220      "\n        -t      Show tabs as ^I" \
 221      "\n        -v      Don't use ^x or M-x escapes" \
 222
 223 #define chat_trivial_usage \
 224        "EXPECT [SEND [EXPECT [SEND...]]]"
 225 #define chat_full_usage \
 226        "Useful for interacting with a modem connected to stdin/stdout.\n" \
 227        "A script consists of one or more \"expect-send\" pairs of strings,\n" \
 228        "each pair is a pair of arguments. Example:\n" \
 229        "chat '' ATZ OK ATD123456 CONNECT '' ogin: pppuser word: ppppass '~'" \
 230
 231 #define chattr_trivial_usage \
 232        "[-R] [-+=AacDdijsStTu] [-v version] files..."
 233 #define chattr_full_usage \
 234        "Change file attributes on an ext2 fs\n" \
 235      "\nModifiers:" \
 236      "\n        -       Remove attributes" \
 237      "\n        +       Add attributes" \
 238      "\n        =       Set attributes" \
 239      "\nAttributes:" \
 240      "\n        A       Don't track atime" \
 241      "\n        a       Append mode only" \
 242      "\n        c       Enable compress" \
 243      "\n        D       Write dir contents synchronously" \
 244      "\n        d       Do not backup with dump" \
 245      "\n        i       Cannot be modified (immutable)" \
 246      "\n        j       Write all data to journal first" \
 247      "\n        s       Zero disk storage when deleted" \
 248      "\n        S       Write file contents synchronously" \
 249      "\n        t       Disable tail-merging of partial blocks with other files" \
 250      "\n        u       Allow file to be undeleted" \
 251      "\nOptions:" \
 252      "\n        -R      Recursively list subdirectories" \
 253      "\n        -v      Set the file's version/generation number" \
 254
 255 #define chcon_trivial_usage \
 256        "[OPTIONS] CONTEXT FILE..." \
 257        "\n      chcon [OPTIONS] [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE..." \
 258         USE_FEATURE_CHCON_LONG_OPTIONS( \
 259        "\n      chcon [OPTIONS] --reference=RFILE FILE..." \
 260         )
 261 #define chcon_full_usage \
 262        "Change the security context of each FILE to CONTEXT\n" \
 263         USE_FEATURE_CHCON_LONG_OPTIONS( \
 264      "\n        -v,--verbose            Verbose" \
 265      "\n        -c,--changes            Report changes made" \
 266      "\n        -h,--no-dereference     Affect symlinks instead of their targets" \
 267      "\n        -f,--silent,--quiet     Suppress most error messages" \
 268      "\n        --reference=RFILE       Use RFILE's group instead of using a CONTEXT value" \
 269      "\n        -u,--user=USER          Set user/role/type/range in the target" \
 270      "\n        -r,--role=ROLE          security context" \
 271      "\n        -t,--type=TYPE" \
 272      "\n        -l,--range=RANGE" \
 273      "\n        -R,--recursive          Recurse subdirectories" \
 274         ) \
 275         SKIP_FEATURE_CHCON_LONG_OPTIONS( \
 276      "\n        -v      Verbose" \
 277      "\n        -c      Report changes made" \
 278      "\n        -h      Affect symlinks instead of their targets" \
 279      "\n        -f      Suppress most error messages" \
 280      "\n        -u USER Set user/role/type/range in the target security context" \
 281      "\n        -r ROLE" \
 282      "\n        -t TYPE" \
 283      "\n        -l RNG" \
 284      "\n        -R      Recurse subdirectories" \
 285         )
 286
 287 #define chmod_trivial_usage \
 288        "[-R"USE_DESKTOP("cvf")"] MODE[,MODE]... FILE..."
 289 #define chmod_full_usage \
 290        "Each MODE is one or more of the letters ugoa, one of the\n" \
 291        "symbols +-= and one or more of the letters rwxst\n" \
 292      "\nOptions:" \
 293      "\n        -R      Recurse directories" \
 294         USE_DESKTOP( \
 295      "\n        -c      List changed files" \
 296      "\n        -v      List all files" \
 297      "\n        -f      Hide errors" \
 298         )
 299 #define chmod_example_usage \
 300        "$ ls -l /tmp/foo\n" \
 301        "-rw-rw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n" \
 302        "$ chmod u+x /tmp/foo\n" \
 303        "$ ls -l /tmp/foo\n" \
 304        "-rwxrw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo*\n" \
 305        "$ chmod 444 /tmp/foo\n" \
 306        "$ ls -l /tmp/foo\n" \
 307        "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
 308
 309 #define chgrp_trivial_usage \
 310        "[-RhLHP"USE_DESKTOP("cvf")"]... GROUP FILE..."
 311 #define chgrp_full_usage \
 312        "Change the group membership of each FILE to GROUP\n" \
 313      "\nOptions:" \
 314      "\n        -R      Recurse directories" \
 315      "\n        -h      Affect symlinks instead of symlink targets" \
 316      "\n        -L      Traverse all symlinks to directories" \
 317      "\n        -H      Traverse symlinks on command line only" \
 318      "\n        -P      Do not traverse symlinks (default)" \
 319         USE_DESKTOP( \
 320      "\n        -c      List changed files" \
 321      "\n        -v      Verbose" \
 322      "\n        -f      Hide errors" \
 323         )
 324 #define chgrp_example_usage \
 325        "$ ls -l /tmp/foo\n" \
 326        "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
 327        "$ chgrp root /tmp/foo\n" \
 328        "$ ls -l /tmp/foo\n" \
 329        "-r--r--r--    1 andersen root            0 Apr 12 18:25 /tmp/foo\n"
 330
 331 #define chown_trivial_usage \
 332        "[-RhLHP"USE_DESKTOP("cvf")"]... OWNER[<.|:>[GROUP]] FILE..."
 333 #define chown_full_usage \
 334        "Change the owner and/or group of each FILE to OWNER and/or GROUP\n" \
 335      "\nOptions:" \
 336      "\n        -R      Recurse directories" \
 337      "\n        -h      Affect symlinks instead of symlink targets" \
 338      "\n        -L      Traverse all symlinks to directories" \
 339      "\n        -H      Traverse symlinks on command line only" \
 340      "\n        -P      Do not traverse symlinks (default)" \
 341         USE_DESKTOP( \
 342      "\n        -c      List changed files" \
 343      "\n        -v      List all files" \
 344      "\n        -f      Hide errors" \
 345         )
 346 #define chown_example_usage \
 347        "$ ls -l /tmp/foo\n" \
 348        "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
 349        "$ chown root /tmp/foo\n" \
 350        "$ ls -l /tmp/foo\n" \
 351        "-r--r--r--    1 root     andersen        0 Apr 12 18:25 /tmp/foo\n" \
 352        "$ chown root.root /tmp/foo\n" \
 353        "ls -l /tmp/foo\n" \
 354        "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
 355
 356 #define chpst_trivial_usage \
 357        "[-vP012] [-u user[:group]] [-U user[:group]] [-e dir] " \
 358        "[-/ dir] [-n nice] [-m bytes] [-d bytes] [-o files] " \
 359        "[-p processes] [-f bytes] [-c bytes] prog args"
 360 #define chpst_full_usage \
 361        "Change the process state and run specified program\n" \
 362      "\nOptions:" \
 363      "\n        -u USER[:GRP]   Set uid and gid" \
 364      "\n        -U USER[:GRP]   Set $UID and $GID in environment" \
 365      "\n        -e DIR          Set environment variables as specified by files" \
 366      "\n                        in DIR: file=1st_line_of_file" \
 367      "\n        -/ DIR          Chroot to DIR" \
 368      "\n        -n INC          Add INC to nice value" \
 369      "\n        -m BYTES        Limit data segment, stack segment, locked physical pages," \
 370      "\n                        and total of all segment per process to BYTES each" \
 371      "\n        -d BYTES        Limit data segment" \
 372      "\n        -o N            Limit the number of open file descriptors per process to N" \
 373      "\n        -p N            Limit number of processes per uid to N" \
 374      "\n        -f BYTES        Limit output file size to BYTES" \
 375      "\n        -c BYTES        Limit core file size to BYTES" \
 376      "\n        -v              Verbose" \
 377      "\n        -P              Run prog in a new process group" \
 378      "\n        -0              Close standard input" \
 379      "\n        -1              Close standard output" \
 380      "\n        -2              Close standard error" \
 381
 382 #define setuidgid_trivial_usage \
 383        "account prog args"
 384 #define setuidgid_full_usage \
 385        "Set uid and gid to account's uid and gid, removing all supplementary\n" \
 386        "groups, then run prog"
 387 #define envuidgid_trivial_usage \
 388        "account prog args"
 389 #define envuidgid_full_usage \
 390        "Set $UID to account's uid and $GID to account's gid, then run prog"
 391 #define envdir_trivial_usage \
 392        "dir prog args"
 393 #define envdir_full_usage \
 394        "Set various environment variables as specified by files\n" \
 395        "in the directory dir, then run prog"
 396 #define softlimit_trivial_usage \
 397        "[-a allbytes] [-c corebytes] [-d databytes] [-f filebytes] " \
 398        "[-l lockbytes] [-m membytes] [-o openfiles] [-p processes] " \
 399        "[-r residentbytes] [-s stackbytes] [-t cpusecs] prog args"
 400 #define softlimit_full_usage \
 401        "Set soft resource limits, then run prog\n" \
 402      "\nOptions:" \
 403      "\n        -m n    Same as -d n -s n -l n -a n" \
 404      "\n        -d n    Limit the data segment per process to n bytes" \
 405      "\n        -s n    Limit the stack segment per process to n bytes" \
 406      "\n        -l n    Limit the locked physical pages per process to n bytes" \
 407      "\n        -a n    Limit the total of all segments per process to n bytes" \
 408      "\n        -o n    Limit the number of open file descriptors per process to n" \
 409      "\n        -p n    Limit the number of processes per uid to n" \
 410      "\nOptions controlling file sizes:" \
 411      "\n        -f n    Limit output file sizes to n bytes" \
 412      "\n        -c n    Limit core file sizes to n bytes" \
 413      "\nEfficiency opts:" \
 414      "\n        -r n    Limit the resident set size to n bytes. This limit is not" \
 415      "\n                enforced unless physical memory is full" \
 416      "\n        -t n    Limit the CPU time to n seconds. This limit is not enforced" \
 417      "\n                except that the process receives a SIGXCPU signal after n seconds" \
 418      "\n" \
 419      "\nSome options may have no effect on some operating systems" \
 420      "\nn may be =, indicating that soft limit should be set equal to hard limit" \
 421
 422 #define chroot_trivial_usage \
 423        "NEWROOT [COMMAND...]"
 424 #define chroot_full_usage \
 425        "Run COMMAND with root directory set to NEWROOT"
 426 #define chroot_example_usage \
 427        "$ ls -l /bin/ls\n" \
 428        "lrwxrwxrwx    1 root     root          12 Apr 13 00:46 /bin/ls -> /BusyBox\n" \
 429        "# mount /dev/hdc1 /mnt -t minix\n" \
 430        "# chroot /mnt\n" \
 431        "# ls -l /bin/ls\n" \
 432        "-rwxr-xr-x    1 root     root        40816 Feb  5 07:45 /bin/ls*\n"
 433
 434 #define chvt_trivial_usage \
 435        "N"
 436 #define chvt_full_usage \
 437        "Change the foreground virtual terminal to /dev/ttyN"
 438
 439 #define cksum_trivial_usage \
 440        "FILES..."
 441 #define cksum_full_usage \
 442        "Calculate the CRC32 checksums of FILES"
 443
 444 #define clear_trivial_usage \
 445        ""
 446 #define clear_full_usage \
 447        "Clear screen"
 448
 449 #define cmp_trivial_usage \
 450        "[-l] [-s] FILE1 [FILE2" USE_DESKTOP(" [SKIP1 [SKIP2]") "]]"
 451 #define cmp_full_usage \
 452        "Compares FILE1 vs stdin if FILE2 is not specified\n" \
 453      "\nOptions:" \
 454      "\n        -l      Write the byte numbers (decimal) and values (octal)" \
 455      "\n                for all differing bytes" \
 456      "\n        -s      Quiet" \
 457
 458 #define comm_trivial_usage \
 459        "[-123] FILE1 FILE2"
 460 #define comm_full_usage \
 461        "Compare FILE1 to FILE2, or to stdin if - is specified\n" \
 462      "\nOptions:" \
 463      "\n        -1      Suppress lines unique to FILE1" \
 464      "\n        -2      Suppress lines unique to FILE2" \
 465      "\n        -3      Suppress lines common to both files" \
 466
 467 #define bbconfig_trivial_usage \
 468        ""
 469 #define bbconfig_full_usage \
 470        "Print the config file which built busybox"
 471
 472 #define bbsh_trivial_usage \
 473        "[FILE]...\n" \
 474        "or: bbsh -c command [args]..."
 475 #define bbsh_full_usage \
 476        "The bbsh shell (command interpreter)"
 477
 478 #define chrt_trivial_usage \
 479        "[OPTION]... [prio] [pid | command [arg]...]"
 480 #define chrt_full_usage \
 481        "Manipulate real-time attributes of a process\n" \
 482      "\nOptions:" \
 483      "\n        -p      Operate on pid" \
 484      "\n        -r      Set scheduling policy to SCHED_RR" \
 485      "\n        -f      Set scheduling policy to SCHED_FIFO" \
 486      "\n        -o      Set scheduling policy to SCHED_OTHER" \
 487      "\n        -m      Show min and max priorities" \
 488
 489 #define chrt_example_usage \
 490        "$ chrt -r 4 sleep 900; x=$!\n" \
 491        "$ chrt -f -p 3 $x\n" \
 492        "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
 493
 494 #define cp_trivial_usage \
 495        "[OPTION]... SOURCE DEST"
 496 #define cp_full_usage \
 497        "Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY\n" \
 498      "\nOptions:" \
 499      "\n        -a      Same as -dpR" \
 500         USE_SELINUX( \
 501      "\n        -c      Preserve security context" \
 502         ) \
 503      "\n        -d,-P   Preserve links" \
 504      "\n        -H,-L   Dereference all symlinks (default)" \
 505      "\n        -p      Preserve file attributes if possible" \
 506      "\n        -f      Force overwrite" \
 507      "\n        -i      Prompt before overwrite" \
 508      "\n        -R,-r   Recurse directories" \
 509      "\n        -l,-s   Create (sym)links" \
 510
 511 #define cpio_trivial_usage \
 512        "-[dimtuv][F cpiofile]"
 513 #define cpio_full_usage \
 514        "Extract or list files from a cpio archive\n" \
 515        "Main operation mode:" \
 516      "\n        d       Make leading directories" \
 517      "\n        i       Extract" \
 518      "\n        m       Preserve mtime" \
 519      "\n        t       List" \
 520      "\n        v       Verbose" \
 521      "\n        u       Unconditional overwrite" \
 522      "\n        F       Input from file" \
 523
 524 #define crond_trivial_usage \
 525        "-fbS -l N " USE_DEBUG_CROND_OPTION("-d N ") "-L LOGFILE -c DIR"
 526 #define crond_full_usage \
 527        "        -f      Foreground" \
 528      "\n        -b      Background (default)" \
 529      "\n        -S      Log to syslog (default)" \
 530      "\n        -l      Set log level. 0 is the most verbose, default 8" \
 531         USE_DEBUG_CROND_OPTION( \
 532      "\n        -d      Set log level, log to stderr" \
 533         ) \
 534      "\n        -L      Log to file" \
 535      "\n        -c      Working dir" \
 536
 537 #define crontab_trivial_usage \
 538        "[-c DIR] [-u USER] [-ler]|[FILE]"
 539 #define crontab_full_usage \
 540        "        -c      Crontab directory" \
 541      "\n        -u      User" \
 542      "\n        -l      List crontab" \
 543      "\n        -e      Edit crontab" \
 544      "\n        -r      Delete crontab" \
 545      "\n        FILE    Replace crontab by FILE ('-': stdin)" \
 546
 547 #define cryptpw_trivial_usage \
 548        "[-a des|md5] [string]"
 549 #define cryptpw_full_usage \
 550        "Output crypted string.\n" \
 551        "If string isn't supplied on cmdline, read it from stdin.\n" \
 552      "\nOptions:" \
 553      "\n        -a      Algorithm to use (default: md5)" \
 554
 555 #define cut_trivial_usage \
 556        "[OPTION]... [FILE]..."
 557 #define cut_full_usage \
 558        "Print selected fields from each input FILE to standard output\n" \
 559      "\nOptions:" \
 560      "\n        -b LIST Output only bytes from LIST" \
 561      "\n        -c LIST Output only characters from LIST" \
 562      "\n        -d CHAR Use CHAR instead of tab as the field delimiter" \
 563      "\n        -s      Output only the lines containing delimiter" \
 564      "\n        -f N    Print only these fields" \
 565      "\n        -n      Ignored" \
 566
 567 #define cut_example_usage \
 568        "$ echo \"Hello world\" | cut -f 1 -d ' '\n" \
 569        "Hello\n" \
 570        "$ echo \"Hello world\" | cut -f 2 -d ' '\n" \
 571        "world\n"
 572
 573 #define date_trivial_usage \
 574        "[OPTION]... [+FMT] [TIME]"
 575 #define date_full_usage \
 576        "Display time (using +FMT), or set time\n" \
 577      "\nOptions:" \
 578      "\n        -u              Work in UTC (don't convert to local time)" \
 579      "\n        -R              Output RFC-822 compliant date string" \
 580         USE_FEATURE_DATE_ISOFMT( \
 581      "\n        -I[SPEC]        Output ISO-8601 compliant date string" \
 582      "\n                        SPEC='date' (default) for date only," \
 583      "\n                        'hours', 'minutes', or 'seconds' for date and" \
 584      "\n                        time to the indicated precision" \
 585         ) \
 586      "\n        -d TIME         Display TIME, not 'now'" \
 587      "\n        -r FILE         Display last modification time of FILE" \
 588      "\n        [-s] TIME       Set time to TIME" \
 589         USE_FEATURE_DATE_ISOFMT( \
 590      "\n        -D FMT          Use FMT for str->date conversion" \
 591         ) \
 592      "\n" \
 593      "\nRecognized formats for TIME:" \
 594      "\n        [hh:]mm:ss" \
 595      "\n        [YYYY.]MM.DD-hh:mm[:ss]" \
 596      "\n        MMDDhhmm[[YY]YY][.ss]" \
 597
 598 #define date_example_usage \
 599        "$ date\n" \
 600        "Wed Apr 12 18:52:41 MDT 2000\n"
 601
 602 #define dc_trivial_usage \
 603        "expression..."
 604 #define dc_full_usage \
 605        "Tiny RPN calculator. Operations:\n" \
 606        "+, add, -, sub, *, mul, /, div, %, mod, **, exp, and, or, not, eor,\n" \
 607        "p - print top of the stack (without altering the stack),\n" \
 608        "f - print entire stack, o - pop the value and set output radix\n" \
 609        "(value must be 10 or 16).\n" \
 610        "Examples: 'dc 2 2 add' -> 4, 'dc 8 8 * 2 2 + /' -> 16.\n" \
 611
 612 #define dc_example_usage \
 613        "$ dc 2 2 + p\n" \
 614        "4\n" \
 615        "$ dc 8 8 \\* 2 2 + / p\n" \
 616        "16\n" \
 617        "$ dc 0 1 and p\n" \
 618        "0\n" \
 619        "$ dc 0 1 or p\n" \
 620        "1\n" \
 621        "$ echo 72 9 div 8 mul p | dc\n" \
 622        "64\n"
 623
 624 #define dd_trivial_usage \
 625        "[if=FILE] [of=FILE] " USE_FEATURE_DD_IBS_OBS("[ibs=N] [obs=N] ") "[bs=N] [count=N] [skip=N]\n" \
 626        "        [seek=N]" USE_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync]")
 627 #define dd_full_usage \
 628        "Copy a file with converting and formatting\n" \
 629      "\nOptions:" \
 630      "\n        if=FILE         Read from FILE instead of stdin" \
 631      "\n        of=FILE         Write to FILE instead of stdout" \
 632      "\n        bs=N            Read and write N bytes at a time" \
 633         USE_FEATURE_DD_IBS_OBS( \
 634      "\n        ibs=N           Read N bytes at a time") \
 635         USE_FEATURE_DD_IBS_OBS( \
 636      "\n        obs=N           Write N bytes at a time") \
 637      "\n        count=N         Copy only N input blocks" \
 638      "\n        skip=N          Skip N input blocks" \
 639      "\n        seek=N          Skip N output blocks" \
 640         USE_FEATURE_DD_IBS_OBS( \
 641      "\n        conv=notrunc    Don't truncate output file" \
 642      "\n        conv=noerror    Continue after read errors" \
 643      "\n        conv=sync       Pad blocks with zeros") \
 644      "\n" \
 645      "\nNumbers may be suffixed by c (x1), w (x2), b (x512), kD (x1000), k (x1024)," \
 646      "\nMD (x1000000), M (x1048576), GD (x1000000000) or G (x1073741824)" \
 647
 648 #define dd_example_usage \
 649        "$ dd if=/dev/zero of=/dev/ram1 bs=1M count=4\n" \
 650        "4+0 records in\n" \
 651        "4+0 records out\n"
 652
 653 #define deallocvt_trivial_usage \
 654        "[N]"
 655 #define deallocvt_full_usage \
 656        "Deallocate unused virtual terminal /dev/ttyN"
 657
 658 #define delgroup_trivial_usage \
 659         USE_FEATURE_DEL_USER_FROM_GROUP("[USER] ")"GROUP"
 660 #define delgroup_full_usage \
 661        "Delete group GROUP from the system" \
 662         USE_FEATURE_DEL_USER_FROM_GROUP(" or user USER from group GROUP")
 663
 664 #define deluser_trivial_usage \
 665        "USER"
 666 #define deluser_full_usage \
 667        "Delete user USER from the system"
 668
 669 #define devfsd_trivial_usage \
 670        "mntpnt [-v]" USE_DEVFSD_FG_NP("[-fg][-np]")
 671 #define devfsd_full_usage \
 672        "Manage devfs permissions and old device name symlinks\n" \
 673      "\nOptions:" \
 674      "\n        mntpnt  The mount point where devfs is mounted" \
 675      "\n        -v      Print the protocol version numbers for devfsd" \
 676      "\n                and the kernel-side protocol version and exit" \
 677         USE_DEVFSD_FG_NP( \
 678      "\n        -fg     Run in foreground" \
 679      "\n        -np     Exit after parsing the configuration file" \
 680      "\n                and processing synthetic REGISTER events," \
 681      "\n                do not poll for events" \
 682         )
 683
 684 /* -k is accepted but ignored for !HUMAN_READABLE,
 685  * but we won't mention this (unimportant) */
 686 #if ENABLE_FEATURE_HUMAN_READABLE || ENABLE_FEATURE_DF_INODE
 687 #define DF_HAS_OPTIONS(x) x
 688 #else
 689 #define DF_HAS_OPTIONS(x)
 690 #endif
 691 #define df_trivial_usage \
 692         DF_HAS_OPTIONS("[-") \
 693         USE_FEATURE_HUMAN_READABLE("hmk") USE_FEATURE_DF_INODE("i") \
 694         DF_HAS_OPTIONS("] ") "[FILESYSTEM...]"
 695 #define df_full_usage \
 696        "Print filesystem usage statistics\n" \
 697         DF_HAS_OPTIONS("\nOptions:") \
 698         USE_FEATURE_HUMAN_READABLE( \
 699      "\n        -h      Human readable (e.g. 1K 243M 2G)" \
 700      "\n        -m      1024*1024 blocks" \
 701      "\n        -k      1024 blocks" \
 702         ) \
 703         USE_FEATURE_DF_INODE( \
 704      "\n        -i      Inodes" \
 705         )
 706 #define df_example_usage \
 707        "$ df\n" \
 708        "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
 709        "/dev/sda3              8690864   8553540    137324  98% /\n" \
 710        "/dev/sda1                64216     36364     27852  57% /boot\n" \
 711        "$ df /dev/sda3\n" \
 712        "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
 713        "/dev/sda3              8690864   8553540    137324  98% /\n"
 714
 715 #define dhcprelay_trivial_usage \
 716        "[client_device_list] [server_device]"
 717 #define dhcprelay_full_usage \
 718        "Relay dhcp requests from client devices to server device"
 719
 720 #define dhcprelay_trivial_usage \
 721        "[client_device_list] [server_device]"
 722 #define dhcprelay_full_usage \
 723        "Relay dhcp requests from client devices to server device"
 724
 725 #define diff_trivial_usage \
 726        "[-abdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2"
 727 #define diff_full_usage \
 728        "Compare files line by line and output the differences between them.\n" \
 729        "This implementation supports unified diffs only.\n" \
 730      "\nOptions:" \
 731      "\n        -a      Treat all files as text" \
 732      "\n        -b      Ignore changes in the amount of whitespace" \
 733      "\n        -d      Try hard to find a smaller set of changes" \
 734      "\n        -i      Ignore case differences" \
 735      "\n        -L      Use LABEL instead of the filename in the unified header" \
 736      "\n        -N      Treat absent files as empty" \
 737      "\n        -q      Output only whether files differ" \
 738      "\n        -r      Recursively compare subdirectories" \
 739      "\n        -S      Start with FILE when comparing directories" \
 740      "\n        -T      Make tabs line up by prefixing a tab when necessary" \
 741      "\n        -s      Report when two files are the same" \
 742      "\n        -t      Expand tabs to spaces in output" \
 743      "\n        -U      Output LINES lines of context" \
 744      "\n        -w      Ignore all whitespace" \
 745
 746 #define dirname_trivial_usage \
 747        "FILENAME"
 748 #define dirname_full_usage \
 749        "Strip non-directory suffix from FILENAME"
 750 #define dirname_example_usage \
 751        "$ dirname /tmp/foo\n" \
 752        "/tmp\n" \
 753        "$ dirname /tmp/foo/\n" \
 754        "/tmp\n"
 755
 756 #define dmesg_trivial_usage \
 757        "[-c] [-n LEVEL] [-s SIZE]"
 758 #define dmesg_full_usage \
 759        "Print or control the kernel ring buffer\n" \
 760      "\nOptions:" \
 761      "\n        -c              Clear ring buffer after printing" \
 762      "\n        -n LEVEL        Set console logging level" \
 763      "\n        -s SIZE         Buffer size" \
 764
 765 #define dnsd_trivial_usage \
 766        "[-c config] [-t seconds] [-p port] [-i iface-ip] [-d]"
 767 #define dnsd_full_usage \
 768        "Small static DNS server daemon\n" \
 769      "\nOptions:" \
 770      "\n        -c      Config filename" \
 771      "\n        -t      TTL in seconds" \
 772      "\n        -p      Listening port" \
 773      "\n        -i      Listening ip (default all)" \
 774      "\n        -d      Daemonize" \
 775
 776 #define dos2unix_trivial_usage \
 777        "[option] [FILE]"
 778 #define dos2unix_full_usage \
 779        "Convert FILE from dos to unix format.\n" \
 780        "When no file is given, use stdin/stdout.\n" \
 781      "\nOptions:" \
 782      "\n        -u      dos2unix" \
 783      "\n        -d      unix2dos" \
 784
 785 #define dpkg_trivial_usage \
 786        "[-ilCPru] [-F option] package_name"
 787 #define dpkg_full_usage \
 788        "Install, remove and manage Debian packages\n" \
 789      "\nOptions:" \
 790      "\n        -i              Install the package" \
 791      "\n        -l              List of installed packages" \
 792      "\n        -C              Configure an unpackaged package" \
 793      "\n        -F depends      Ignore dependency problems" \
 794      "\n        -P              Purge all files of a package" \
 795      "\n        -r              Remove all but the configuration files for a package" \
 796      "\n        -u              Unpack a package, but don't configure it" \
 797
 798 #define dpkg_deb_trivial_usage \
 799        "[-cefxX] FILE [argument]"
 800 #define dpkg_deb_full_usage \
 801        "Perform actions on Debian packages (.debs)\n" \
 802      "\nOptions:" \
 803      "\n        -c      List contents of filesystem tree" \
 804      "\n        -e      Extract control files to [argument] directory" \
 805      "\n        -f      Display control field name starting with [argument]" \
 806      "\n        -x      Extract packages filesystem tree to directory" \
 807      "\n        -X      Verbose extract" \
 808
 809 #define dpkg_deb_example_usage \
 810        "$ dpkg-deb -X ./busybox_0.48-1_i386.deb /tmp\n"
 811
 812 #define du_trivial_usage \
 813        "[-aHLdclsx" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILE]..."
 814 #define du_full_usage \
 815        "Summarize disk space used for each FILE and/or directory.\n" \
 816        "Disk space is printed in units of " \
 817         USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("1024") \
 818         SKIP_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("512") \
 819        " bytes.\n" \
 820      "\nOptions:" \
 821      "\n        -a      Show file sizes too" \
 822      "\n        -H      Follow symlinks on command line" \
 823      "\n        -L      Follow all symlinks" \
 824      "\n        -d N    Limit output to directories (and files with -a) of depth < N" \
 825      "\n        -c      Show grand total" \
 826      "\n        -l      Count sizes many times if hard linked" \
 827      "\n        -s      Display only a total for each argument" \
 828      "\n        -x      Skip directories on different filesystems" \
 829         USE_FEATURE_HUMAN_READABLE( \
 830      "\n        -h      Sizes in human readable format (e.g., 1K 243M 2G )" \
 831      "\n        -m      Sizes in megabytes" \
 832         ) \
 833      "\n        -k      Sizes in kilobytes" \
 834                         USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K(" (default)") \
 835
 836 #define du_example_usage \
 837        "$ du\n" \
 838        "16      ./CVS\n" \
 839        "12      ./kernel-patches/CVS\n" \
 840        "80      ./kernel-patches\n" \
 841        "12      ./tests/CVS\n" \
 842        "36      ./tests\n" \
 843        "12      ./scripts/CVS\n" \
 844        "16      ./scripts\n" \
 845        "12      ./docs/CVS\n" \
 846        "104     ./docs\n" \
 847        "2417    .\n"
 848
 849 #define dumpkmap_trivial_usage \
 850        "> keymap"
 851 #define dumpkmap_full_usage \
 852        "Print out a binary keyboard translation table to standard output"
 853 #define dumpkmap_example_usage \
 854        "$ dumpkmap > keymap\n"
 855
 856 #define dumpleases_trivial_usage \
 857        "[-r|-a] [-f LEASEFILE]"
 858 #define dumpleases_full_usage \
 859        "Display DHCP leases granted by udhcpd\n" \
 860      "\nOptions:" \
 861         USE_GETOPT_LONG( \
 862      "\n        -f,--file=FILE  Leases file to load" \
 863      "\n        -r,--remaining  Interpret lease times as time remaining" \
 864      "\n        -a,--absolute   Interpret lease times as expire time" \
 865         ) \
 866         SKIP_GETOPT_LONG( \
 867      "\n        -f FILE Leases file to load" \
 868      "\n        -r      Interpret lease times as time remaining" \
 869      "\n        -a      Interpret lease times as expire time" \
 870         )
 871
 872 #define e2fsck_trivial_usage \
 873        "[-panyrcdfvstDFSV] [-b superblock] [-B blocksize] " \
 874        "[-I inode_buffer_blocks] [-P process_inode_size] " \
 875        "[-l|-L bad_blocks_file] [-C fd] [-j external_journal] " \
 876        "[-E extended-options] device"
 877 #define e2fsck_full_usage \
 878        "Check ext2/ext3 file system\n" \
 879      "\nOptions:" \
 880      "\n        -p              Automatic repair (no questions)" \
 881      "\n        -n              Make no changes to the filesystem" \
 882      "\n        -y              Assume 'yes' to all questions" \
 883      "\n        -c              Check for bad blocks and add them to the badblock list" \
 884      "\n        -f              Force checking even if filesystem is marked clean" \
 885      "\n        -v              Verbose" \
 886      "\n        -b superblock   Use alternative superblock" \
 887      "\n        -B blocksize    Force blocksize when looking for superblock" \
 888      "\n        -j journal      Set location of the external journal" \
 889      "\n        -l file         Add to badblocks list" \
 890      "\n        -L file         Set badblocks list" \
 891
 892 #define echo_trivial_usage \
 893         USE_FEATURE_FANCY_ECHO("[-neE] ") "[ARG...]"
 894 #define echo_full_usage \
 895        "Print the specified ARGs to stdout" \
 896         USE_FEATURE_FANCY_ECHO( "\n" \
 897      "\nOptions:" \
 898      "\n        -n      Suppress trailing newline" \
 899      "\n        -e      Interpret backslash-escaped characters (i.e., \\t=tab)" \
 900      "\n        -E      Disable interpretation of backslash-escaped characters" \
 901         )
 902 #define echo_example_usage \
 903        "$ echo \"Erik is cool\"\n" \
 904        "Erik is cool\n" \
 905         USE_FEATURE_FANCY_ECHO("$ echo -e \"Erik\\nis\\ncool\"\n" \
 906        "Erik\n" \
 907        "is\n" \
 908        "cool\n" \
 909        "$ echo \"Erik\\nis\\ncool\"\n" \
 910        "Erik\\nis\\ncool\n")
 911
 912 #define eject_trivial_usage \
 913        "[-t] [-T] [DEVICE]"
 914 #define eject_full_usage \
 915        "Eject specified DEVICE (or default /dev/cdrom)\n" \
 916      "\nOptions:" \
 917         USE_FEATURE_EJECT_SCSI( \
 918      "\n        -s      SCSI device" \
 919         ) \
 920      "\n        -t      Close tray" \
 921      "\n        -T      Open/close tray (toggle)" \
 922
 923 #define ed_trivial_usage ""
 924 #define ed_full_usage ""
 925
 926 #define env_trivial_usage \
 927        "[-iu] [-] [name=value]... [command]"
 928 #define env_full_usage \
 929        "Print the current environment or run a program after setting\n" \
 930        "up the specified environment\n" \
 931      "\nOptions:" \
 932      "\n        -, -i   Start with an empty environment" \
 933      "\n        -u      Remove variable from the environment" \
 934
 935 #define ether_wake_trivial_usage \
 936        "[-b] [-i iface] [-p aa:bb:cc:dd[:ee:ff]] MAC"
 937 #define ether_wake_full_usage \
 938        "Send a magic packet to wake up sleeping machines.\n" \
 939        "MAC must be a station address (00:11:22:33:44:55) or\n" \
 940        "a hostname with a known 'ethers' entry.\n" \
 941      "\nOptions:" \
 942      "\n        -b              Send wake-up packet to the broadcast address" \
 943      "\n        -i iface        Interface to use (default eth0)" \
 944      "\n        -p pass         Append four or six byte password PW to the packet" \
 945
 946 #define expand_trivial_usage \
 947        "[-i] [-t NUM] [FILE|-]"
 948 #define expand_full_usage \
 949        "Convert tabs to spaces, writing to standard output.\n" \
 950      "\nOptions:" \
 951         USE_FEATURE_EXPAND_LONG_OPTIONS( \
 952      "\n        -i,--initial    Do not convert tabs after non blanks" \
 953      "\n        -t,--tabs=N     Tabstops every N chars" \
 954         ) \
 955         SKIP_FEATURE_EXPAND_LONG_OPTIONS( \
 956      "\n        -i      Do not convert tabs after non blanks" \
 957      "\n        -t      Tabstops every N chars" \
 958         )
 959
 960 #define expr_trivial_usage \
 961        "EXPRESSION"
 962 #define expr_full_usage \
 963        "Print the value of EXPRESSION to standard output.\n" \
 964        "\n" \
 965        "EXPRESSION may be:\n" \
 966        "        ARG1 | ARG2     ARG1 if it is neither null nor 0, otherwise ARG2\n" \
 967        "        ARG1 & ARG2     ARG1 if neither argument is null or 0, otherwise 0\n" \
 968        "        ARG1 < ARG2     1 if ARG1 is less than ARG2, else 0. Similarly:\n" \
 969        "        ARG1 <= ARG2\n" \
 970        "        ARG1 = ARG2\n" \
 971        "        ARG1 != ARG2\n" \
 972        "        ARG1 >= ARG2\n" \
 973        "        ARG1 > ARG2\n" \
 974        "        ARG1 + ARG2     Sum of ARG1 and ARG2. Similarly:\n" \
 975        "        ARG1 - ARG2\n" \
 976        "        ARG1 * ARG2\n" \
 977        "        ARG1 / ARG2\n" \
 978        "        ARG1 % ARG2\n" \
 979        "        STRING : REGEXP         Anchored pattern match of REGEXP in STRING\n" \
 980        "        match STRING REGEXP     Same as STRING : REGEXP\n" \
 981        "        substr STRING POS LENGTH Substring of STRING, POS counted from 1\n" \
 982        "        index STRING CHARS      Index in STRING where any CHARS is found, or 0\n" \
 983        "        length STRING           Length of STRING\n" \
 984        "        quote TOKEN             Interpret TOKEN as a string, even if\n" \
 985        "                                it is a keyword like 'match' or an\n" \
 986        "                                operator like '/'\n" \
 987        "        (EXPRESSION)            Value of EXPRESSION\n" \
 988        "\n" \
 989        "Beware that many operators need to be escaped or quoted for shells.\n" \
 990        "Comparisons are arithmetic if both ARGs are numbers, else\n" \
 991        "lexicographical. Pattern matches return the string matched between\n" \
 992        "\\( and \\) or null; if \\( and \\) are not used, they return the number\n" \
 993        "of characters matched or 0."
 994
 995 #define fakeidentd_trivial_usage \
 996        "[-fiw] [-b ADDR] [STRING]"
 997 #define fakeidentd_full_usage \
 998        "Provide fake ident (auth) service\n" \
 999      "\nOptions:" \
1000      "\n        -f      Run in foreground" \
1001      "\n        -i      Inetd mode" \
1002      "\n        -w      Inetd 'wait' mode" \
1003      "\n        -b ADDR Bind to specified address" \
1004      "\n        STRING  Ident answer string (default is 'nobody')" \
1005
1006 #define false_trivial_usage \
1007        ""
1008 #define false_full_usage \
1009        "Return an exit code of FALSE (1)"
1010
1011 #define false_example_usage \
1012        "$ false\n" \
1013        "$ echo $?\n" \
1014        "1\n"
1015
1016 #define fbset_trivial_usage \
1017        "[options] [mode]"
1018 #define fbset_full_usage \
1019        "Show and modify frame buffer settings"
1020
1021 #define fbset_example_usage \
1022        "$ fbset\n" \
1023        "mode \"1024x768-76\"\n" \
1024        "        # D: 78.653 MHz, H: 59.949 kHz, V: 75.694 Hz\n" \
1025        "        geometry 1024 768 1024 768 16\n" \
1026        "        timings 12714 128 32 16 4 128 4\n" \
1027        "        accel false\n" \
1028        "        rgba 5/11,6/5,5/0,0/0\n" \
1029        "endmode\n"
1030
1031 #define fdflush_trivial_usage \
1032        "DEVICE"
1033 #define fdflush_full_usage \
1034        "Force floppy disk drive to detect disk change"
1035
1036 #define fdformat_trivial_usage \
1037        "[-n] DEVICE"
1038 #define fdformat_full_usage \
1039        "Format floppy disk\n" \
1040      "\nOptions:" \
1041      "\n        -n      Don't verify after format" \
1042
1043 /* Looks like someone forgot to add this to config system */
1044 #ifndef ENABLE_FEATURE_FDISK_BLKSIZE
1045 # define ENABLE_FEATURE_FDISK_BLKSIZE 0
1046 # define USE_FEATURE_FDISK_BLKSIZE(a)
1047 #endif
1048
1049 #define fdisk_trivial_usage \
1050        "[-ul" USE_FEATURE_FDISK_BLKSIZE("s") "] " \
1051        "[-C CYLINDERS] [-H HEADS] [-S SECTORS] [-b SSZ] DISK"
1052 #define fdisk_full_usage \
1053        "Change partition table\n" \
1054      "\nOptions:" \
1055      "\n        -u              Start and End are in sectors (instead of cylinders)" \
1056      "\n        -l              Show partition table for each DISK, then exit" \
1057         USE_FEATURE_FDISK_BLKSIZE( \
1058      "\n        -s              Show partition sizes in kb for each DISK, then exit" \
1059         ) \
1060      "\n        -b 2048         (for certain MO disks) use 2048-byte sectors" \
1061      "\n        -C CYLINDERS    Set number of cylinders/heads/sectors" \
1062      "\n        -H HEADS\n" \
1063      "\n        -S SECTORS" \
1064
1065 #define fetchmail_trivial_usage \
1066        "[-w timeout] [-U user] -P password [-X] [-t] [-z] server[:port] maildir [prog]"
1067 #define fetchmail_full_usage \
1068        "Fetch content of remote mailbox to local Maildir.\n" \
1069      "\nOptions:" \
1070      "\n        -w timeout      Set timeout on network operations" \
1071      "\n        -U username     Authenticate with specified username/password" \
1072      "\n        -P password" \
1073      "\n        -X              Use openssl connection helper for secured servers" \
1074      "\n        -t              Get only headers" \
1075      "\n        -z              Delete messages on server" \
1076      "\n        prog            Run prog <message_file> on message delivery" \
1077
1078 #define findfs_trivial_usage \
1079        "LABEL=label or UUID=uuid"
1080 #define findfs_full_usage \
1081        "Find a filesystem device based on a label or UUID."
1082 #define findfs_example_usage \
1083        "$ findfs LABEL=MyDevice"
1084
1085 #define find_trivial_usage \
1086        "[PATH...] [EXPRESSION]"
1087 #define find_full_usage \
1088        "Search for files. The default PATH is the current directory,\n" \
1089        "default EXPRESSION is '-print'\n" \
1090      "\nEXPRESSION may consist of:" \
1091      "\n        -follow         Dereference symlinks" \
1092         USE_FEATURE_FIND_XDEV( \
1093      "\n        -xdev           Don't descend directories on other filesystems") \
1094         USE_FEATURE_FIND_MAXDEPTH( \
1095      "\n        -maxdepth N     Descend at most N levels. -maxdepth 0 applies" \
1096      "\n                        tests/actions to command line arguments only") \
1097      "\n        -name PATTERN   File name (w/o directory name) matches PATTERN" \
1098      "\n        -iname PATTERN  Case insensitive -name" \
1099         USE_FEATURE_FIND_PATH( \
1100      "\n        -path PATTERN   Path matches PATTERN") \
1101         USE_FEATURE_FIND_REGEX( \
1102      "\n        -regex PATTERN  Path matches regex PATTERN") \
1103         USE_FEATURE_FIND_TYPE( \
1104      "\n        -type X         File type is X (X is one of: f,d,l,b,c,...)") \
1105         USE_FEATURE_FIND_PERM( \
1106      "\n        -perm NNN       Permissions match any of (+NNN), all of (-NNN)," \
1107      "\n                        or exactly (NNN)") \
1108         USE_FEATURE_FIND_MTIME( \
1109      "\n        -mtime DAYS     Modified time is greater than (+N), less than (-N)," \
1110      "\n                        or exactly (N) days") \
1111         USE_FEATURE_FIND_MMIN( \
1112      "\n        -mmin MINS      Modified time is greater than (+N), less than (-N)," \
1113      "\n                        or exactly (N) minutes") \
1114         USE_FEATURE_FIND_NEWER( \
1115      "\n        -newer FILE     Modified time is more recent than FILE's") \
1116         USE_FEATURE_FIND_INUM( \
1117      "\n        -inum N         File has inode number N") \
1118         USE_FEATURE_FIND_USER( \
1119      "\n        -user NAME      File is owned by user NAME (numeric user ID allowed)") \
1120         USE_FEATURE_FIND_GROUP( \
1121      "\n        -group NAME     File belongs to group NAME (numeric group ID allowed)") \
1122         USE_FEATURE_FIND_DEPTH( \
1123      "\n        -depth          Process directory name after traversing it") \
1124         USE_FEATURE_FIND_SIZE( \
1125      "\n        -size N[bck]    File size is N (c:bytes,k:kbytes,b:512 bytes(def.))." \
1126      "\n                        +/-N: file size is bigger/smaller than N") \
1127      "\n        -print          Print (default and assumed)" \
1128         USE_FEATURE_FIND_PRINT0( \
1129      "\n        -print0         Delimit output with null characters rather than" \
1130      "\n                        newlines") \
1131         USE_FEATURE_FIND_CONTEXT ( \
1132      "\n        -context        File has specified security context") \
1133         USE_FEATURE_FIND_EXEC( \
1134      "\n        -exec CMD ARG ; Execute CMD with all instances of {} replaced by the" \
1135      "\n                        matching files") \
1136         USE_FEATURE_FIND_PRUNE( \
1137      "\n        -prune          Stop traversing current subtree") \
1138         USE_FEATURE_FIND_DELETE( \
1139      "\n        -delete         Delete files, turns on -depth option") \
1140         USE_FEATURE_FIND_PAREN( \
1141      "\n        (EXPR)          Group an expression") \
1142
1143 #define find_example_usage \
1144        "$ find / -name passwd\n" \
1145        "/etc/passwd\n"
1146
1147 #define fold_trivial_usage \
1148        "[-bs] [-w WIDTH] [FILE]"
1149 #define fold_full_usage \
1150        "Wrap input lines in each FILE (standard input by default), writing to\n" \
1151        "standard output\n" \
1152      "\nOptions:" \
1153      "\n        -b      Count bytes rather than columns" \
1154      "\n        -s      Break at spaces" \
1155      "\n        -w      Use WIDTH columns instead of 80" \
1156
1157 #define free_trivial_usage \
1158        ""
1159 #define free_full_usage \
1160        "Display the amount of free and used system memory"
1161 #define free_example_usage \
1162        "$ free\n" \
1163        "              total         used         free       shared      buffers\n" \
1164        "  Mem:       257628       248724         8904        59644        93124\n" \
1165        " Swap:       128516         8404       120112\n" \
1166        "Total:       386144       257128       129016\n" \
1167
1168 #define freeramdisk_trivial_usage \
1169        "DEVICE"
1170 #define freeramdisk_full_usage \
1171        "Free all memory used by the specified ramdisk"
1172 #define freeramdisk_example_usage \
1173        "$ freeramdisk /dev/ram2\n"
1174
1175 #define fsck_trivial_usage \
1176        "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys...]"
1177 #define fsck_full_usage \
1178        "Check and repair filesystems\n" \
1179      "\nOptions:" \
1180      "\n        -A      Walk /etc/fstab and check all filesystems" \
1181      "\n        -N      Don't execute, just show what would be done" \
1182      "\n        -P      With -A, check filesystems in parallel" \
1183      "\n        -R      With -A, skip the root filesystem" \
1184      "\n        -T      Don't show title on startup" \
1185      "\n        -V      Verbose" \
1186      "\n        -C n    Write status information to specified filedescriptor" \
1187      "\n        -t type List of filesystem types to check" \
1188
1189 #define fsck_minix_trivial_usage \
1190        "[-larvsmf] /dev/name"
1191 #define fsck_minix_full_usage \
1192        "Check MINIX filesystem\n" \
1193      "\nOptions:" \
1194      "\n        -l      List all filenames" \
1195      "\n        -r      Perform interactive repairs" \
1196      "\n        -a      Perform automatic repairs" \
1197      "\n        -v      Verbose" \
1198      "\n        -s      Output super-block information" \
1199      "\n        -m      Show \"mode not cleared\" warnings" \
1200      "\n        -f      Force file system check" \
1201
1202 #define ftpget_trivial_usage \
1203        "[options] remote-host local-file remote-file"
1204 #define ftpget_full_usage \
1205        "Retrieve a remote file via FTP\n" \
1206      "\nOptions:" \
1207         USE_GETOPT_LONG( \
1208      "\n        -c,--continue   Continue previous transfer" \
1209      "\n        -v,--verbose    Verbose" \
1210      "\n        -u,--username   Username" \
1211      "\n        -p,--password   Password" \
1212      "\n        -P,--port       Port number" \
1213         ) \
1214         SKIP_GETOPT_LONG( \
1215      "\n        -c      Continue previous transfer" \
1216      "\n        -v      Verbose" \
1217      "\n        -u      Username" \
1218      "\n        -p      Password" \
1219      "\n        -P      Port number" \
1220         )
1221
1222 #define ftpput_trivial_usage \
1223        "[options] remote-host remote-file local-file"
1224 #define ftpput_full_usage \
1225        "Store a local file on a remote machine via FTP\n" \
1226      "\nOptions:" \
1227         USE_GETOPT_LONG( \
1228      "\n        -v,--verbose    Verbose" \
1229      "\n        -u,--username   Username" \
1230      "\n        -p,--password   Password" \
1231      "\n        -P,--port       Port number" \
1232         ) \
1233         SKIP_GETOPT_LONG( \
1234      "\n        -v      Verbose" \
1235      "\n        -u      Username" \
1236      "\n        -p      Password" \
1237      "\n        -P      Port number" \
1238         )
1239
1240 #define fuser_trivial_usage \
1241        "[options] FILE or PORT/PROTO"
1242 #define fuser_full_usage \
1243        "Find processes which use FILEs or PORTs\n" \
1244      "\nOptions:" \
1245      "\n        -m      Find processes which use same fs as FILEs" \
1246      "\n        -4      Search only IPv4 space" \
1247      "\n        -6      Search only IPv6 space" \
1248      "\n        -s      Silent: just exit with 0 if any processes are found" \
1249      "\n        -k      Kill found processes (otherwise display PIDs)" \
1250      "\n        -SIGNAL Signal to send (default: TERM)" \
1251
1252 #define getenforce_trivial_usage
1253 #define getenforce_full_usage
1254
1255 #define getopt_trivial_usage \
1256        "[OPTIONS]..."
1257 #define getopt_full_usage \
1258        "Parse command options\n" \
1259         USE_GETOPT_LONG( \
1260      "\n        -a,--alternative                Allow long options starting with single -" \
1261      "\n        -l,--longoptions=longopts       Long options to be recognized" \
1262      "\n        -n,--name=progname              The name under which errors are reported" \
1263      "\n        -o,--options=optstring          Short options to be recognized" \
1264      "\n        -q,--quiet                      Disable error reporting by getopt(3)" \
1265      "\n        -Q,--quiet-output               No normal output" \
1266      "\n        -s,--shell=shell                Set shell quoting conventions" \
1267      "\n        -T,--test                       Test for getopt(1) version" \
1268      "\n        -u,--unquoted                   Don't quote the output" \
1269         ) \
1270         SKIP_GETOPT_LONG( \
1271      "\n        -a              Allow long options starting with single -" \
1272      "\n        -l longopts     Long options to be recognized" \
1273      "\n        -n progname     The name under which errors are reported" \
1274      "\n        -o optstring    Short options to be recognized" \
1275      "\n        -q              Disable error reporting by getopt(3)" \
1276      "\n        -Q              No normal output" \
1277      "\n        -s shell        Set shell quoting conventions" \
1278      "\n        -T              Test for getopt(1) version" \
1279      "\n        -u              Don't quote the output" \
1280         )
1281 #define getopt_example_usage \
1282        "$ cat getopt.test\n" \
1283        "#!/bin/sh\n" \
1284        "GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \\\n" \
1285        "       -n 'example.busybox' -- \"$@\"`\n" \
1286        "if [ $? != 0 ]; then  exit 1; fi\n" \
1287        "eval set -- \"$GETOPT\"\n" \
1288        "while true; do\n" \
1289        " case $1 in\n" \
1290        "   -a|--a-long) echo \"Option a\"; shift;;\n" \
1291        "   -b|--b-long) echo \"Option b, argument '$2'\"; shift 2;;\n" \
1292        "   -c|--c-long)\n" \
1293        "     case \"$2\" in\n" \
1294        "       \"\") echo \"Option c, no argument\"; shift 2;;\n" \
1295        "       *)  echo \"Option c, argument '$2'\"; shift 2;;\n" \
1296        "     esac;;\n" \
1297        "   --) shift; break;;\n" \
1298        "   *) echo \"Internal error!\"; exit 1;;\n" \
1299        " esac\n" \
1300        "done\n"
1301
1302 #define getsebool_trivial_usage \
1303        "-a or getsebool boolean..."
1304 #define getsebool_full_usage \
1305        "        -a      Show all SELinux booleans"
1306
1307 #define getty_trivial_usage \
1308        "[OPTIONS] BAUD_RATE TTY [TERMTYPE]"
1309 #define getty_full_usage \
1310        "Open a tty, prompt for a login name, then invoke /bin/login\n" \
1311      "\nOptions:" \
1312      "\n        -h              Enable hardware (RTS/CTS) flow control" \
1313      "\n        -i              Do not display /etc/issue before running login" \
1314      "\n        -L              Local line, do not do carrier detect" \
1315      "\n        -m              Get baud rate from modem's CONNECT status message" \
1316      "\n        -w              Wait for a CR or LF before sending /etc/issue" \
1317      "\n        -n              Do not prompt the user for a login name" \
1318      "\n        -f issue_file   Display issue_file instead of /etc/issue" \
1319      "\n        -l login_app    Invoke login_app instead of /bin/login" \
1320      "\n        -t timeout      Terminate after timeout if no username is read" \
1321      "\n        -I initstring   Init string to send before anything else" \
1322      "\n        -H login_host   Log login_host into the utmp file as the hostname" \
1323
1324 #define grep_trivial_usage \
1325        "[-HhrilLnqvso" \
1326         USE_DESKTOP("w") \
1327        "eF" \
1328         USE_FEATURE_GREP_EGREP_ALIAS("E") \
1329         USE_FEATURE_GREP_CONTEXT("ABC") \
1330        "] PATTERN [FILEs...]"
1331 #define grep_full_usage \
1332        "Search for PATTERN in each FILE or standard input\n" \
1333      "\nOptions:" \
1334      "\n        -H      Prefix output lines with filename where match was found" \
1335      "\n        -h      Suppress the prefixing filename on output" \
1336      "\n        -r      Recurse subdirectories" \
1337      "\n        -i      Ignore case distinctions" \
1338      "\n        -l      List names of files that match" \
1339      "\n        -L      List names of files that do not match" \
1340      "\n        -n      Print line number with output lines" \
1341      "\n        -q      Quiet. Return 0 if PATTERN is found, 1 otherwise" \
1342      "\n        -v      Select non-matching lines" \
1343      "\n        -s      Suppress file open/read error messages" \
1344      "\n        -c      Only print count of matching lines" \
1345      "\n        -o      Show only the part of a line that matches PATTERN" \
1346      "\n        -m MAX  Match up to MAX times per file" \
1347         USE_DESKTOP( \
1348      "\n        -w      Match whole words only") \
1349      "\n        -F      PATTERN is a set of newline-separated strings" \
1350         USE_FEATURE_GREP_EGREP_ALIAS( \
1351      "\n        -E      PATTERN is an extended regular expression") \
1352      "\n        -e PTRN Pattern to match" \
1353      "\n        -f FILE Read pattern from file" \
1354         USE_FEATURE_GREP_CONTEXT( \
1355      "\n        -A      Print NUM lines of trailing context" \
1356      "\n        -B      Print NUM lines of leading context" \
1357      "\n        -C      Print NUM lines of output context") \
1358
1359 #define grep_example_usage \
1360        "$ grep root /etc/passwd\n" \
1361        "root:x:0:0:root:/root:/bin/bash\n" \
1362        "$ grep ^[rR]oo. /etc/passwd\n" \
1363        "root:x:0:0:root:/root:/bin/bash\n"
1364
1365 #define gunzip_trivial_usage \
1366        "[OPTION]... [FILE]..."
1367 #define gunzip_full_usage \
1368        "Uncompress FILEs (or standard input)\n" \
1369      "\nOptions:" \
1370      "\n        -c      Write to standard output" \
1371      "\n        -f      Force" \
1372      "\n        -t      Test file integrity" \
1373
1374 #define gunzip_example_usage \
1375        "$ ls -la /tmp/BusyBox*\n" \
1376        "-rw-rw-r--    1 andersen andersen   557009 Apr 11 10:55 /tmp/BusyBox-0.43.tar.gz\n" \
1377        "$ gunzip /tmp/BusyBox-0.43.tar.gz\n" \
1378        "$ ls -la /tmp/BusyBox*\n" \
1379        "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar\n"
1380
1381 #define gzip_trivial_usage \
1382        "[OPTION]... [FILE]..."
1383 #define gzip_full_usage \
1384        "Compress FILEs (or standard input)\n" \
1385      "\nOptions:" \
1386      "\n        -c      Write to standard output" \
1387      "\n        -d      Decompress" \
1388      "\n        -f      Force" \
1389
1390 #define gzip_example_usage \
1391        "$ ls -la /tmp/busybox*\n" \
1392        "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/busybox.tar\n" \
1393        "$ gzip /tmp/busybox.tar\n" \
1394        "$ ls -la /tmp/busybox*\n" \
1395        "-rw-rw-r--    1 andersen andersen   554058 Apr 14 17:49 /tmp/busybox.tar.gz\n"
1396
1397 #define halt_trivial_usage \
1398        "[-d delay] [-n] [-f]"
1399 #define halt_full_usage \
1400        "Halt the system\n" \
1401      "\nOptions:" \
1402      "\n        -d      Delay interval for halting" \
1403      "\n        -n      No call to sync()" \
1404      "\n        -f      Force halt (don't go through init)" \
1405         USE_FEATURE_WTMP( \
1406      "\n        -w      Only write a wtmp record" \
1407         )
1408
1409 #define hdparm_trivial_usage \
1410        "[options] [device] .."
1411 #define hdparm_full_usage \
1412        "Options:" \
1413      "\n        -a      Get/set fs readahead" \
1414      "\n        -A      Set drive read-lookahead flag (0/1)" \
1415      "\n        -b      Get/set bus state (0 == off, 1 == on, 2 == tristate)" \
1416      "\n        -B      Set Advanced Power Management setting (1-255)" \
1417      "\n        -c      Get/set IDE 32-bit IO setting" \
1418      "\n        -C      Check IDE power mode status" \
1419         USE_FEATURE_HDPARM_HDIO_GETSET_DMA( \
1420      "\n        -d      Get/set using_dma flag") \
1421      "\n        -D      Enable/disable drive defect-mgmt" \
1422      "\n        -f      Flush buffer cache for device on exit" \
1423      "\n        -g      Display drive geometry" \
1424      "\n        -h      Display terse usage information" \
1425         USE_FEATURE_HDPARM_GET_IDENTITY( \
1426      "\n        -i      Display drive identification") \
1427         USE_FEATURE_HDPARM_GET_IDENTITY( \
1428      "\n        -I      Detailed/current information directly from drive") \
1429      "\n        -k      Get/set keep_settings_over_reset flag (0/1)" \
1430      "\n        -K      Set drive keep_features_over_reset flag (0/1)" \
1431      "\n        -L      Set drive doorlock (0/1) (removable harddisks only)" \
1432      "\n        -m      Get/set multiple sector count" \
1433      "\n        -n      Get/set ignore-write-errors flag (0/1)" \
1434      "\n        -p      Set PIO mode on IDE interface chipset (0,1,2,3,4,...)" \
1435      "\n        -P      Set drive prefetch count" \
1436 /*   "\n        -q      Change next setting quietly" - not supported ib bbox */ \
1437      "\n        -Q      Get/set DMA tagged-queuing depth (if supported)" \
1438      "\n        -r      Get/set readonly flag (DANGEROUS to set)" \
1439         USE_FEATURE_HDPARM_HDIO_SCAN_HWIF( \
1440      "\n        -R      Register an IDE interface (DANGEROUS)") \
1441      "\n        -S      Set standby (spindown) timeout" \
1442      "\n        -t      Perform device read timings" \
1443      "\n        -T      Perform cache read timings" \
1444      "\n        -u      Get/set unmaskirq flag (0/1)" \
1445         USE_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF( \
1446      "\n        -U      Un-register an IDE interface (DANGEROUS)") \
1447      "\n        -v      Defaults; same as -mcudkrag for IDE drives" \
1448      "\n        -V      Display program version and exit immediately" \
1449         USE_FEATURE_HDPARM_HDIO_DRIVE_RESET( \
1450      "\n        -w      Perform device reset (DANGEROUS)") \
1451      "\n        -W      Set drive write-caching flag (0/1) (DANGEROUS)" \
1452         USE_FEATURE_HDPARM_HDIO_TRISTATE_HWIF( \
1453      "\n        -x      Tristate device for hotswap (0/1) (DANGEROUS)") \
1454      "\n        -X      Set IDE xfer mode (DANGEROUS)" \
1455      "\n        -y      Put IDE drive in standby mode" \
1456      "\n        -Y      Put IDE drive to sleep" \
1457      "\n        -Z      Disable Seagate auto-powersaving mode" \
1458      "\n        -z      Re-read partition table" \
1459
1460 #define head_trivial_usage \
1461        "[OPTION]... [FILE]..."
1462 #define head_full_usage \
1463        "Print first 10 lines of each FILE to standard output.\n" \
1464        "With more than one FILE, precede each with a header giving the\n" \
1465        "file name. With no FILE, or when FILE is -, read standard input.\n" \
1466      "\nOptions:" \
1467      "\n        -n NUM  Print first NUM lines instead of first 10" \
1468         USE_FEATURE_FANCY_HEAD( \
1469      "\n        -c NUM  Output the first NUM bytes" \
1470      "\n        -q      Never output headers giving file names" \
1471      "\n        -v      Always output headers giving file names") \
1472
1473 #define head_example_usage \
1474        "$ head -n 2 /etc/passwd\n" \
1475        "root:x:0:0:root:/root:/bin/bash\n" \
1476        "daemon:x:1:1:daemon:/usr/sbin:/bin/sh\n"
1477
1478 #define hexdump_trivial_usage \
1479        "[-bcCdefnosvx" USE_FEATURE_HEXDUMP_REVERSE("R") "] FILE..."
1480 #define hexdump_full_usage \
1481        "Display file(s) or standard input in a user specified format\n" \
1482      "\nOptions:" \
1483      "\n        -b              One-byte octal display" \
1484      "\n        -c              One-byte character display" \
1485      "\n        -C              Canonical hex+ASCII, 16 bytes per line" \
1486      "\n        -d              Two-byte decimal display" \
1487      "\n        -e FORMAT STRING" \
1488      "\n        -f FORMAT FILE" \
1489      "\n        -n LENGTH       Interpret only LENGTH bytes of input" \
1490      "\n        -o              Two-byte octal display" \
1491      "\n        -s OFFSET       Skip OFFSET bytes" \
1492      "\n        -v              Display all input data" \
1493      "\n        -x              Two-byte hexadecimal display" \
1494         USE_FEATURE_HEXDUMP_REVERSE( \
1495      "\n        -R              Reverse of 'hexdump -Cv'") \
1496
1497 #define hd_trivial_usage \
1498        "FILE..."
1499 #define hd_full_usage \
1500        "hd is an alias for hexdump -C"
1501
1502 #define hostid_trivial_usage \
1503        ""
1504 #define hostid_full_usage \
1505        "Print out a unique 32-bit identifier for the machine"
1506
1507 #define hostname_trivial_usage \
1508        "[OPTION] [hostname | -F FILE]"
1509 #define hostname_full_usage \
1510        "Get or set hostname or DNS domain name\n" \
1511      "\nOptions:" \
1512      "\n        -s      Short" \
1513      "\n        -i      Addresses for the hostname" \
1514      "\n        -d      DNS domain name" \
1515      "\n        -f      Fully qualified domain name" \
1516      "\n        -F FILE Use the contents of FILE to specify the hostname" \
1517
1518 #define hostname_example_usage \
1519        "$ hostname\n" \
1520        "sage\n"
1521
1522 #define httpd_trivial_usage \
1523        "[-c conffile]" \
1524        " [-p [ip:]port]" \
1525        " [-i] [-f] [-v[v]]" \
1526         USE_FEATURE_HTTPD_SETUID(" [-u user[:grp]]") \
1527         USE_FEATURE_HTTPD_BASIC_AUTH(" [-r realm]") \
1528         USE_FEATURE_HTTPD_AUTH_MD5(" [-m pass]") \
1529        " [-h home]" \
1530        " [-d/-e string]"
1531 #define httpd_full_usage \
1532        "Listen for incoming HTTP requests\n" \
1533      "\nOptions:" \
1534      "\n        -c FILE         Configuration file (default httpd.conf)" \
1535      "\n        -p [IP:]PORT    Bind to ip:port (default *:80)" \
1536      "\n        -i              Inetd mode" \
1537      "\n        -f              Do not daemonize" \
1538      "\n        -v[v]           Verbose" \
1539         USE_FEATURE_HTTPD_SETUID( \
1540      "\n        -u USER[:GRP]   Set uid/gid after binding to port") \
1541         USE_FEATURE_HTTPD_BASIC_AUTH( \
1542      "\n        -r REALM        Authentication Realm for Basic Authentication") \
1543         USE_FEATURE_HTTPD_AUTH_MD5( \
1544      "\n        -m PASS         Crypt PASS with md5 algorithm") \
1545      "\n        -h HOME         Home directory (default .)" \
1546      "\n        -e STRING       HTML encode STRING" \
1547      "\n        -d STRING       URL decode STRING" \
1548
1549 #define hwclock_trivial_usage \
1550         USE_GETOPT_LONG( \
1551        "[-r|--show] [-s|--hctosys] [-w|--systohc]" \
1552        " [-l|--localtime] [-u|--utc]" \
1553        " [-f FILE]" \
1554         ) \
1555         SKIP_GETOPT_LONG( \
1556        "[-r] [-s] [-w] [-l] [-u] [-f FILE]" \
1557         )
1558 #define hwclock_full_usage \
1559        "Query and set hardware clock (RTC)\n" \
1560      "\nOptions:" \
1561      "\n        -r      Show hardware clock time" \
1562      "\n        -s      Set system time from hardware clock" \
1563      "\n        -w      Set hardware clock to system time" \
1564      "\n        -u      Hardware clock is in UTC" \
1565      "\n        -l      Hardware clock is in local time" \
1566      "\n        -f FILE Use specified device (e.g. /dev/rtc2)" \
1567
1568 #define id_trivial_usage \
1569        "[OPTIONS]... [USER]"
1570 #define id_full_usage \
1571        "Print information about USER or the current user\n" \
1572      "\nOptions:" \
1573         USE_SELINUX( \
1574      "\n        -Z      Print the security context" \
1575         ) \
1576      "\n        -g      Print group ID" \
1577      "\n        -u      Print user ID" \
1578      "\n        -n      Print name instead of a number" \
1579      "\n        -r      Print real user ID instead of effective ID" \
1580
1581 #define id_example_usage \
1582        "$ id\n" \
1583        "uid=1000(andersen) gid=1000(andersen)\n"
1584
1585 #define ifconfig_trivial_usage \
1586         USE_FEATURE_IFCONFIG_STATUS("[-a]") " interface [address]"
1587 #define ifconfig_full_usage \
1588        "Configure a network interface\n" \
1589      "\nOptions:" \
1590      "\n" \
1591         USE_FEATURE_IPV6( \
1592        "        [add ADDRESS[/PREFIXLEN]]\n") \
1593         USE_FEATURE_IPV6( \
1594        "        [del ADDRESS[/PREFIXLEN]]\n") \
1595        "        [[-]broadcast [ADDRESS]] [[-]pointopoint [ADDRESS]]\n" \
1596        "        [netmask ADDRESS] [dstaddr ADDRESS]\n" \
1597         USE_FEATURE_IFCONFIG_SLIP( \
1598        "        [outfill NN] [keepalive NN]\n") \
1599        "        " USE_FEATURE_IFCONFIG_HW("[hw ether ADDRESS] ") "[metric NN] [mtu NN]\n" \
1600        "        [[-]trailers] [[-]arp] [[-]allmulti]\n" \
1601        "        [multicast] [[-]promisc] [txqueuelen NN] [[-]dynamic]\n" \
1602         USE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ( \
1603        "        [mem_start NN] [io_addr NN] [irq NN]\n") \
1604        "        [up|down] ..."
1605
1606 #define ifenslave_trivial_usage \
1607        "[-cdf] master-iface <slave-iface...>"
1608 #define ifenslave_full_usage \
1609        "Configure network interfaces for parallel routing\n" \
1610      "\nOptions:" \
1611      "\n        -c, --change-active     Change active slave" \
1612      "\n        -d, --detach            Remove slave interface from bonding device" \
1613      "\n        -f, --force             Force, even if interface is not Ethernet" \
1614 /*   "\n        -r, --receive-slave     Create a receive-only slave" */
1615
1616 #define ifenslave_example_usage \
1617        "To create a bond device, simply follow these three steps :\n" \
1618        "- ensure that the required drivers are properly loaded :\n" \
1619        "  # modprobe bonding ; modprobe <3c59x|eepro100|pcnet32|tulip|...>\n" \
1620        "- assign an IP address to the bond device :\n" \
1621        "  # ifconfig bond0 <addr> netmask <mask> broadcast <bcast>\n" \
1622        "- attach all the interfaces you need to the bond device :\n" \
1623        "  # ifenslave bond0 eth0 eth1 eth2\n" \
1624        "  If bond0 didn't have a MAC address, it will take eth0's. Then, all\n" \
1625        "  interfaces attached AFTER this assignment will get the same MAC addr.\n\n" \
1626        "  To detach a dead interface without setting the bond device down :\n" \
1627        "   # ifenslave -d bond0 eth1\n\n" \
1628        "  To set the bond device down and automatically release all the slaves :\n" \
1629        "   # ifconfig bond0 down\n\n" \
1630        "  To change active slave :\n" \
1631        "   # ifenslave -c bond0 eth0\n" \
1632
1633 #define ifup_trivial_usage \
1634        "[-ahinv] ifaces..."
1635 #define ifup_full_usage \
1636        "Options:" \
1637      "\n        -a      De/configure all interfaces automatically" \
1638      "\n        -i FILE Use FILE for interface definitions" \
1639      "\n        -n      Print out what would happen, but don't do it" \
1640      "\n                (note: doesn't disable mappings)" \
1641      "\n        -v      Print out what would happen before doing it" \
1642      "\n        -m      Don't run any mappings" \
1643      "\n        -f      Force de/configuration" \
1644
1645 #define ifdown_trivial_usage \
1646        "[-ahinv] ifaces..."
1647 #define ifdown_full_usage \
1648        "Options:" \
1649      "\n        -a      De/configure all interfaces automatically" \
1650      "\n        -i FILE Use FILE for interface definitions" \
1651      "\n        -n      Print out what would happen, but don't do it" \
1652      "\n                (note: doesn't disable mappings)" \
1653      "\n        -v      Print out what would happen before doing it" \
1654      "\n        -m      Don't run any mappings" \
1655      "\n        -f      Force de/configuration" \
1656
1657 #define inetd_trivial_usage \
1658        "[-fe] [-q N] [-R N] [CONFFILE]"
1659 #define inetd_full_usage \
1660        "Listen for network connections and launch programs\n" \
1661      "\nOptions:" \
1662      "\n        -f      Run in foreground" \
1663      "\n        -e      Log to stderr" \
1664      "\n        -q N    Socket listen queue (default: 128)" \
1665      "\n        -R N    Pause services after N connects/min" \
1666      "\n                (default: 0 - disabled)" \
1667
1668 #define init_trivial_usage \
1669        ""
1670 #define init_full_usage \
1671        "Init is the parent of all processes"
1672
1673 #define init_notes_usage \
1674 "This version of init is designed to be run only by the kernel.\n" \
1675 "\n" \
1676 "BusyBox init doesn't support multiple runlevels. The runlevels field of\n" \
1677 "the /etc/inittab file is completely ignored by BusyBox init. If you want\n" \
1678 "runlevels, use sysvinit.\n" \
1679 "\n" \
1680 "BusyBox init works just fine without an inittab. If no inittab is found,\n" \
1681 "it has the following default behavior:\n" \
1682 "\n" \
1683 "       ::sysinit:/etc/init.d/rcS\n" \
1684 "       ::askfirst:/bin/sh\n" \
1685 "       ::ctrlaltdel:/sbin/reboot\n" \
1686 "       ::shutdown:/sbin/swapoff -a\n" \
1687 "       ::shutdown:/bin/umount -a -r\n" \
1688 "       ::restart:/sbin/init\n" \
1689 "\n" \
1690 "if it detects that /dev/console is _not_ a serial console, it will also run:\n" \
1691 "\n" \
1692 "       tty2::askfirst:/bin/sh\n" \
1693 "       tty3::askfirst:/bin/sh\n" \
1694 "       tty4::askfirst:/bin/sh\n" \
1695 "\n" \
1696 "If you choose to use an /etc/inittab file, the inittab entry format is as follows:\n" \
1697 "\n" \
1698 "       <id>:<runlevels>:<action>:<process>\n" \
1699 "\n" \
1700 "       <id>:\n" \
1701 "\n" \
1702 "               WARNING: This field has a non-traditional meaning for BusyBox init!\n" \
1703 "               The id field is used by BusyBox init to specify the controlling tty for\n" \
1704 "               the specified process to run on. The contents of this field are\n" \
1705 "               appended to \"/dev/\" and used as-is. There is no need for this field to\n" \
1706 "               be unique, although if it isn't you may have strange results. If this\n" \
1707 "               field is left blank, the controlling tty is set to the console. Also\n" \
1708 "               note that if BusyBox detects that a serial console is in use, then only\n" \
1709 "               entries whose controlling tty is either the serial console or /dev/null\n" \
1710 "               will be run. BusyBox init does nothing with utmp. We don't need no\n" \
1711 "               stinkin' utmp.\n" \
1712 "\n" \
1713 "       <runlevels>:\n" \
1714 "\n" \
1715 "               The runlevels field is completely ignored.\n" \
1716 "\n" \
1717 "       <action>:\n" \
1718 "\n" \
1719 "               Valid actions include: sysinit, respawn, askfirst, wait,\n" \
1720 "               once, restart, ctrlaltdel, and shutdown.\n" \
1721 "\n" \
1722 "               The available actions can be classified into two groups: actions\n" \
1723 "               that are run only once, and actions that are re-run when the specified\n" \
1724 "               process exits.\n" \
1725 "\n" \
1726 "               Run only-once actions:\n" \
1727 "\n" \
1728 "                       'sysinit' is the first item run on boot. init waits until all\n" \
1729 "                       sysinit actions are completed before continuing. Following the\n" \
1730 "                       completion of all sysinit actions, all 'wait' actions are run.\n" \
1731 "                       'wait' actions, like 'sysinit' actions, cause init to wait until\n" \
1732 "                       the specified task completes. 'once' actions are asynchronous,\n" \
1733 "                       therefore, init does not wait for them to complete. 'restart' is\n" \
1734 "                       the action taken to restart the init process. By default this should\n" \
1735 "                       simply run /sbin/init, but can be a script which runs pivot_root or it\n" \
1736 "                       can do all sorts of other interesting things. The 'ctrlaltdel' init\n" \
1737 "                       actions are run when the system detects that someone on the system\n" \
1738 "                       console has pressed the CTRL-ALT-DEL key combination. Typically one\n" \
1739 "                       wants to run 'reboot' at this point to cause the system to reboot.\n" \
1740 "                       Finally the 'shutdown' action specifies the actions to taken when\n" \
1741 "                       init is told to reboot. Unmounting filesystems and disabling swap\n" \
1742 "                       is a very good here.\n" \
1743 "\n" \
1744 "               Run repeatedly actions:\n" \
1745 "\n" \
1746 "                       'respawn' actions are run after the 'once' actions. When a process\n" \
1747 "                       started with a 'respawn' action exits, init automatically restarts\n" \
1748 "                       it. Unlike sysvinit, BusyBox init does not stop processes from\n" \
1749 "                       respawning out of control. The 'askfirst' actions acts just like\n" \
1750 "                       respawn, except that before running the specified process it\n" \
1751 "                       displays the line \"Please press Enter to activate this console.\"\n" \
1752 "                       and then waits for the user to press enter before starting the\n" \
1753 "                       specified process.\n" \
1754 "\n" \
1755 "               Unrecognized actions (like initdefault) will cause init to emit an\n" \
1756 "               error message, and then go along with its business. All actions are\n" \
1757 "               run in the order they appear in /etc/inittab.\n" \
1758 "\n" \
1759 "       <process>:\n" \
1760 "\n" \
1761 "               Specifies the process to be executed and its command line.\n" \
1762 "\n" \
1763 "Example /etc/inittab file:\n" \
1764 "\n" \
1765 "       # This is run first except when booting in single-user mode\n" \
1766 "       #\n" \
1767 "       ::sysinit:/etc/init.d/rcS\n" \
1768 "       \n" \
1769 "       # /bin/sh invocations on selected ttys\n" \
1770 "       #\n" \
1771 "       # Start an \"askfirst\" shell on the console (whatever that may be)\n" \
1772 "       ::askfirst:-/bin/sh\n" \
1773 "       # Start an \"askfirst\" shell on /dev/tty2-4\n" \
1774 "       tty2::askfirst:-/bin/sh\n" \
1775 "       tty3::askfirst:-/bin/sh\n" \
1776 "       tty4::askfirst:-/bin/sh\n" \
1777 "       \n" \
1778 "       # /sbin/getty invocations for selected ttys\n" \
1779 "       #\n" \
1780 "       tty4::respawn:/sbin/getty 38400 tty4\n" \
1781 "       tty5::respawn:/sbin/getty 38400 tty5\n" \
1782 "       \n" \
1783 "       \n" \
1784 "       # Example of how to put a getty on a serial line (for a terminal)\n" \
1785 "       #\n" \
1786 "       #::respawn:/sbin/getty -L ttyS0 9600 vt100\n" \
1787 "       #::respawn:/sbin/getty -L ttyS1 9600 vt100\n" \
1788 "       #\n" \
1789 "       # Example how to put a getty on a modem line\n" \
1790 "       #::respawn:/sbin/getty 57600 ttyS2\n" \
1791 "       \n" \
1792 "       # Stuff to do when restarting the init process\n" \
1793 "       ::restart:/sbin/init\n" \
1794 "       \n" \
1795 "       # Stuff to do before rebooting\n" \
1796 "       ::ctrlaltdel:/sbin/reboot\n" \
1797 "       ::shutdown:/bin/umount -a -r\n" \
1798 "       ::shutdown:/sbin/swapoff -a\n"
1799
1800 #define insmod_trivial_usage \
1801         USE_FEATURE_2_4_MODULES("[OPTION]... ") "MODULE [symbol=value]..."
1802 #define insmod_full_usage \
1803        "Load the specified kernel modules into the kernel" \
1804         USE_FEATURE_2_4_MODULES( "\n" \
1805      "\nOptions:" \
1806      "\n        -f      Force module to load into the wrong kernel version" \
1807      "\n        -k      Make module autoclean-able" \
1808      "\n        -v      Verbose" \
1809      "\n        -q      Quiet" \
1810      "\n        -L      Lock to prevent simultaneous loads of a module" \
1811         USE_FEATURE_INSMOD_LOAD_MAP( \
1812      "\n        -m      Output load map to stdout" \
1813         ) \
1814      "\n        -o NAME Set internal module name to NAME" \
1815      "\n        -x      Do not export externs" \
1816         )
1817
1818 #define install_trivial_usage \
1819        "[-cgmops] [sources] dest|directory"
1820 #define install_full_usage \
1821        "Copy files and set attributes\n" \
1822      "\nOptions:" \
1823      "\n        -c      Copy the file, default" \
1824      "\n        -d      Create directories" \
1825      "\n        -g      Set group ownership" \
1826      "\n        -m      Set permissions" \
1827      "\n        -o      Set ownership" \
1828      "\n        -p      Preserve date" \
1829      "\n        -s      Strip symbol tables" \
1830         USE_SELINUX( \
1831      "\n        -Z      Set security context of copy" \
1832         )
1833
1834 /* would need to make the " | " optional depending on more than one selected: */
1835 #define ip_trivial_usage \
1836        "[OPTIONS] {" \
1837         USE_FEATURE_IP_ADDRESS("address | ") \
1838         USE_FEATURE_IP_ROUTE("route | ") \
1839         USE_FEATURE_IP_LINK("link | ") \
1840         USE_FEATURE_IP_TUNNEL("tunnel | ") \
1841         USE_FEATURE_IP_RULE("rule") \
1842        "} {COMMAND}"
1843 #define ip_full_usage \
1844        "ip [OPTIONS] OBJECT {COMMAND}\n" \
1845        "where OBJECT := {" \
1846         USE_FEATURE_IP_ADDRESS("address | ") \
1847         USE_FEATURE_IP_ROUTE("route | ") \
1848         USE_FEATURE_IP_LINK("link | ") \
1849         USE_FEATURE_IP_TUNNEL("tunnel | ") \
1850         USE_FEATURE_IP_RULE("rule") \
1851        "}\n" \
1852        "OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }" \
1853
1854 #define ipaddr_trivial_usage \
1855        "{ {add|del} IFADDR dev STRING | {show|flush}\n" \
1856        "                [dev STRING] [to PREFIX] }"
1857 #define ipaddr_full_usage \
1858        "ipaddr {add|delete} IFADDR dev STRING\n" \
1859        "ipaddr {show|flush} [dev STRING] [scope SCOPE-ID]\n" \
1860        "        [to PREFIX] [label PATTERN]\n" \
1861        "        IFADDR := PREFIX | ADDR peer PREFIX\n" \
1862        "        [broadcast ADDR] [anycast ADDR]\n" \
1863        "        [label STRING] [scope SCOPE-ID]\n" \
1864        "        SCOPE-ID := [host | link | global | NUMBER]" \
1865
1866 #define ipcalc_trivial_usage \
1867        "[OPTION]... ADDRESS[[/]NETMASK] [NETMASK]"
1868 #define ipcalc_full_usage \
1869        "Calculate IP network settings from a IP address\n" \
1870      "\nOptions:" \
1871         USE_FEATURE_IPCALC_LONG_OPTIONS( \
1872      "\n        -b,--broadcast  Display calculated broadcast address" \
1873      "\n        -n,--network    Display calculated network address" \
1874      "\n        -m,--netmask    Display default netmask for IP" \
1875         USE_FEATURE_IPCALC_FANCY( \
1876      "\n        -p,--prefix     Display the prefix for IP/NETMASK" \
1877      "\n        -h,--hostname   Display first resolved host name" \
1878      "\n        -s,--silent     Don't ever display error messages" \
1879         ) \
1880         ) \
1881         SKIP_FEATURE_IPCALC_LONG_OPTIONS( \
1882      "\n        -b      Display calculated broadcast address" \
1883      "\n        -n      Display calculated network address" \
1884      "\n        -m      Display default netmask for IP" \
1885         USE_FEATURE_IPCALC_FANCY( \
1886      "\n        -p      Display the prefix for IP/NETMASK" \
1887      "\n        -h      Display first resolved host name" \
1888      "\n        -s      Don't ever display error messages" \
1889         ) \
1890         )
1891
1892 #define ipcrm_trivial_usage \
1893        "[-MQS key] [-mqs id]"
1894 #define ipcrm_full_usage \
1895        "Upper-case options MQS remove an object by shmkey value.\n" \
1896        "Lower-case options remove an object by shmid value.\n" \
1897      "\nOptions:" \
1898      "\n        -mM     Remove memory segment after last detach" \
1899      "\n        -qQ     Remove message queue" \
1900      "\n        -sS     Remove semaphore" \
1901
1902 #define ipcs_trivial_usage \
1903        "[[-smq] -i shmid] | [[-asmq] [-tcplu]]"
1904 #define ipcs_full_usage \
1905        "        -i      Show specific resource" \
1906      "\nResource specification:" \
1907      "\n        -m      Shared memory segments" \
1908      "\n        -q      Message queues" \
1909      "\n        -s      Semaphore arrays" \
1910      "\n        -a      All (default)" \
1911      "\nOutput format:" \
1912      "\n        -t      Time" \
1913      "\n        -c      Creator" \
1914      "\n        -p      Pid" \
1915      "\n        -l      Limits" \
1916      "\n        -u      Summary" \
1917
1918 #define iplink_trivial_usage \
1919        "{ set DEVICE { up | down | arp { on | off } | show [DEVICE] }"
1920 #define iplink_full_usage \
1921        "iplink set DEVICE { up | down | arp | multicast { on | off } |\n" \
1922        "                        dynamic { on | off } |\n" \
1923        "                        mtu MTU }\n" \
1924        "iplink show [DEVICE]" \
1925
1926 #define iproute_trivial_usage \
1927        "{ list | flush | { add | del | change | append |\n" \
1928        "                replace | monitor } ROUTE }"
1929 #define iproute_full_usage \
1930        "iproute { list | flush } SELECTOR\n" \
1931        "iproute get ADDRESS [from ADDRESS iif STRING]\n" \
1932        "                        [oif STRING]  [tos TOS]\n" \
1933        "iproute { add | del | change | append | replace | monitor } ROUTE\n" \
1934        "                        SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n" \
1935        "                        ROUTE := [TYPE] PREFIX [tos TOS] [proto RTPROTO]" \
1936
1937 #define iprule_trivial_usage \
1938        "{[list | add | del] RULE}"
1939 #define iprule_full_usage \
1940        "iprule [list | add | del] SELECTOR ACTION\n" \
1941        "        SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n" \
1942        "                        [dev STRING] [pref NUMBER]\n" \
1943        "        ACTION := [table TABLE_ID] [nat ADDRESS]\n" \
1944        "                        [prohibit | reject | unreachable]\n" \
1945        "                        [realms [SRCREALM/]DSTREALM]\n" \
1946        "        TABLE_ID := [local | main | default | NUMBER]" \
1947
1948 #define iptunnel_trivial_usage \
1949        "{ add | change | del | show } [NAME]\n" \
1950        "        [mode { ipip | gre | sit }]\n" \
1951        "        [remote ADDR] [local ADDR] [ttl TTL]"
1952 #define iptunnel_full_usage \
1953        "iptunnel { add | change | del | show } [NAME]\n" \
1954        "        [mode { ipip | gre | sit }] [remote ADDR] [local ADDR]\n" \
1955        "        [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n" \
1956        "        [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]" \
1957
1958 #define kbd_mode_trivial_usage \
1959        "[-a|k|s|u]"
1960 #define kbd_mode_full_usage \
1961        "Report or set the keyboard mode\n" \
1962      "\nOptions set mode:" \
1963      "\n        -a      Default (ASCII)" \
1964      "\n        -k      Medium-raw (keyboard)" \
1965      "\n        -s      Raw (scancode)" \
1966      "\n        -u      Unicode (utf-8)" \
1967
1968 #define kill_trivial_usage \
1969        "[-l] [-signal] process-id..."
1970 #define kill_full_usage \
1971        "Send a signal (default is TERM) to the specified process(es)\n" \
1972      "\nOptions:" \
1973      "\n        -l      List all signal names and numbers" \
1974
1975 #define kill_example_usage \
1976        "$ ps | grep apache\n" \
1977        "252 root     root     S [apache]\n" \
1978        "263 www-data www-data S [apache]\n" \
1979        "264 www-data www-data S [apache]\n" \
1980        "265 www-data www-data S [apache]\n" \
1981        "266 www-data www-data S [apache]\n" \
1982        "267 www-data www-data S [apache]\n" \
1983        "$ kill 252\n"
1984
1985 #define killall_trivial_usage \
1986        "[-l] [-q] [-signal] process-name..."
1987 #define killall_full_usage \
1988        "Send a signal (default is TERM) to the specified process(es)\n" \
1989      "\nOptions:" \
1990      "\n        -l      List all signal names and numbers" \
1991      "\n        -q      Do not complain if no processes were killed" \
1992
1993 #define killall_example_usage \
1994        "$ killall apache\n"
1995
1996 #define killall5_trivial_usage \
1997        "[-l] [-signal]"
1998 #define killall5_full_usage \
1999        "Send a signal (default is TERM) to all processes outside current session\n" \
2000      "\nOptions:" \
2001      "\n        -l      List all signal names and numbers" \
2002
2003 #define klogd_trivial_usage \
2004        "[-c n] [-n]"
2005 #define klogd_full_usage \
2006        "Kernel logger\n" \
2007      "\nOptions:" \
2008      "\n        -c n    Set the default log level of console messages to n" \
2009      "\n        -n      Run in foreground" \
2010
2011 #define length_trivial_usage \
2012        "STRING"
2013 #define length_full_usage \
2014        "Print STRING's length"
2015
2016 #define length_example_usage \
2017        "$ length Hello\n" \
2018        "5\n"
2019
2020 #define less_trivial_usage \
2021        "[-EMNmh~?] [FILE...]"
2022 #define less_full_usage \
2023        "View a file or list of files. The position within files can be\n" \
2024        "changed, and files can be manipulated in various ways.\n" \
2025      "\nOptions:" \
2026      "\n        -E      Quit once the end of a file is reached" \
2027      "\n        -M,-m   Display a status line containing the line numbers" \
2028      "\n                and percentage through the file" \
2029      "\n        -N      Prefix line numbers to each line" \
2030      "\n        -~      Suppress ~s displayed past the end of the file" \
2031
2032 #define setarch_trivial_usage \
2033        "personality program [args...]"
2034 #define setarch_full_usage \
2035        "Personality may be:\n" \
2036        "        linux32         Set 32bit uname emulation\n" \
2037        "        linux64         Set 64bit uname emulation" \
2038
2039 #define ln_trivial_usage \
2040        "[OPTION] TARGET... LINK_NAME|DIRECTORY"
2041 #define ln_full_usage \
2042        "Create a link named LINK_NAME or DIRECTORY to the specified TARGET.\n" \
2043        "Use '--' to indicate that all following arguments are non-options.\n" \
2044      "\nOptions:" \
2045      "\n        -s      Make symlinks instead of hardlinks" \
2046      "\n        -f      Remove existing destination files" \
2047      "\n        -n      Don't dereference symlinks - treat like normal file" \
2048      "\n        -b      Make a backup of the target (if exists) before link operation" \
2049      "\n        -S suf  Use suffix instead of ~ when making backup files" \
2050
2051 #define ln_example_usage \
2052        "$ ln -s BusyBox /tmp/ls\n" \
2053        "$ ls -l /tmp/ls\n" \
2054        "lrwxrwxrwx    1 root     root            7 Apr 12 18:39 ls -> BusyBox*\n"
2055
2056 #define load_policy_trivial_usage
2057
2058 #define load_policy_full_usage
2059
2060 #define loadfont_trivial_usage \
2061        "< font"
2062 #define loadfont_full_usage \
2063        "Load a console font from standard input"
2064 #define loadfont_example_usage \
2065        "$ loadfont < /etc/i18n/fontname\n"
2066
2067 #define loadkmap_trivial_usage \
2068        "< keymap"
2069 #define loadkmap_full_usage \
2070        "Load a binary keyboard translation table from standard input"
2071 #define loadkmap_example_usage \
2072        "$ loadkmap < /etc/i18n/lang-keymap\n"
2073
2074 #define logger_trivial_usage \
2075        "[OPTION]... [MESSAGE]"
2076 #define logger_full_usage \
2077        "Write MESSAGE to the system log. If MESSAGE is omitted, log stdin.\n" \
2078      "\nOptions:" \
2079      "\n        -s      Log to stderr as well as the system log" \
2080      "\n        -t TAG  Log using the specified tag (defaults to user name)" \
2081      "\n        -p PRIO Priority (numeric or facility.level pair)" \
2082
2083 #define logger_example_usage \
2084        "$ logger \"hello\"\n"
2085
2086 #define login_trivial_usage \
2087        "[-p] [-h HOST] [[-f] USER]"
2088 #define login_full_usage \
2089        "Begin a new session on the system\n" \
2090      "\nOptions:" \
2091      "\n        -f      Do not authenticate (user already authenticated)" \
2092      "\n        -h      Name of the remote host" \
2093      "\n        -p      Preserve environment" \
2094
2095 #define logname_trivial_usage \
2096        ""
2097 #define logname_full_usage \
2098        "Print the name of the current user"
2099 #define logname_example_usage \
2100        "$ logname\n" \
2101        "root\n"
2102
2103 #define logread_trivial_usage \
2104        "[OPTION]..."
2105 #define logread_full_usage \
2106        "Show messages in syslogd's circular buffer\n" \
2107      "\nOptions:" \
2108      "\n        -f      Output data as log grows" \
2109
2110 #define losetup_trivial_usage \
2111        "[-o OFS] LOOPDEV FILE - associate loop devices\n" \
2112        "        losetup -d LOOPDEV - disassociate\n" \
2113        "        losetup [-f] - show"
2114 #define losetup_full_usage \
2115        "Options:" \
2116      "\n        -o OFS  Start OFS bytes into FILE" \
2117      "\n        -f      Show first free loop device" \
2118
2119 #define losetup_notes_usage \
2120        "No arguments will display all current associations.\n" \
2121        "One argument (losetup /dev/loop1) will display the current association\n" \
2122        "(if any), or disassociate it (with -d). The display shows the offset\n" \
2123        "and filename of the file the loop device is currently bound to.\n\n" \
2124        "Two arguments (losetup /dev/loop1 file.img) create a new association,\n" \
2125        "with an optional offset (-o 12345). Encryption is not yet supported.\n" \
2126        "losetup -f will show the first loop free loop device\n\n"
2127
2128 #define lpd_trivial_usage \
2129        "SPOOLDIR [HELPER [ARGS...]]"
2130 #define lpd_full_usage \
2131        "Example:" \
2132      "\n        tcpsvd -E 0 515 softlimit -m 999999 lpd /var/spool ./print"
2133
2134 #define lpq_trivial_usage \
2135        "[-P queue[@host[:port]]] [-U USERNAME] [-d JOBID...] [-fs]"
2136 #define lpq_full_usage \
2137        "Options:" \
2138      "\n        -P      lp service to connect to (else uses $PRINTER)" \
2139      "\n        -d      Delete jobs" \
2140      "\n        -f      Force any waiting job to be printed" \
2141      "\n        -s      Short display" \
2142
2143 #define lpr_trivial_usage \
2144        "-P queue[@host[:port]] -U USERNAME -J TITLE -Vmh [FILE...]"
2145 /* -C CLASS exists too, not shown.
2146  * CLASS is supposed to be printed on banner page, if one is requested */
2147 #define lpr_full_usage \
2148        "Options:" \
2149      "\n        -P      lp service to connect to (else uses $PRINTER)"\
2150      "\n        -m      Send mail on completion" \
2151      "\n        -h      Print banner page too" \
2152      "\n        -V      Verbose" \
2153
2154 #define ls_trivial_usage \
2155        "[-1Aa" USE_FEATURE_LS_TIMESTAMPS("c") "Cd" \
2156         USE_FEATURE_LS_TIMESTAMPS("e") USE_FEATURE_LS_FILETYPES("F") "iln" \
2157         USE_FEATURE_LS_FILETYPES("p") USE_FEATURE_LS_FOLLOWLINKS("L") \
2158         USE_FEATURE_LS_RECURSIVE("R") USE_FEATURE_LS_SORTFILES("rS") "s" \
2159         USE_FEATURE_AUTOWIDTH("T") USE_FEATURE_LS_TIMESTAMPS("tu") \
2160         USE_FEATURE_LS_SORTFILES("v") USE_FEATURE_AUTOWIDTH("w") "x" \
2161         USE_FEATURE_LS_SORTFILES("X") USE_FEATURE_HUMAN_READABLE("h") "k" \
2162         USE_SELINUX("K") "] [filenames...]"
2163 #define ls_full_usage \
2164        "List directory contents\n" \
2165      "\nOptions:" \
2166      "\n        -1      List files in a single column" \
2167      "\n        -A      Do not list implied . and .." \
2168      "\n        -a      Do not hide entries starting with ." \
2169      "\n        -C      List entries by columns" \
2170         USE_FEATURE_LS_TIMESTAMPS( \
2171      "\n        -c      With -l: show ctime") \
2172         USE_FEATURE_LS_COLOR( \
2173      "\n        --color[={always,never,auto}]   Control coloring") \
2174      "\n        -d      List directory entries instead of contents" \
2175         USE_FEATURE_LS_TIMESTAMPS( \
2176      "\n        -e      List both full date and full time") \
2177         USE_FEATURE_LS_FILETYPES( \
2178      "\n        -F      Append indicator (one of */=@|) to entries") \
2179      "\n        -i      List the i-node for each file" \
2180      "\n        -l      Use a long listing format" \
2181      "\n        -n      List numeric UIDs and GIDs instead of names" \
2182         USE_FEATURE_LS_FILETYPES( \
2183      "\n        -p      Append indicator (one of /=@|) to entries") \
2184         USE_FEATURE_LS_FOLLOWLINKS( \
2185      "\n        -L      List entries pointed to by symlinks") \
2186         USE_FEATURE_LS_RECURSIVE( \
2187      "\n        -R      List subdirectories recursively") \
2188         USE_FEATURE_LS_SORTFILES( \
2189      "\n        -r      Sort the listing in reverse order") \
2190         USE_FEATURE_LS_SORTFILES( \
2191      "\n        -S      Sort the listing by file size") \
2192      "\n        -s      List the size of each file, in blocks" \
2193         USE_FEATURE_AUTOWIDTH( \
2194      "\n        -T NUM  Assume Tabstop every NUM columns") \
2195         USE_FEATURE_LS_TIMESTAMPS( \
2196      "\n        -t      With -l: show modification time") \
2197         USE_FEATURE_LS_TIMESTAMPS( \
2198      "\n        -u      With -l: show access time") \
2199         USE_FEATURE_LS_SORTFILES( \
2200      "\n        -v      Sort the listing by version") \
2201         USE_FEATURE_AUTOWIDTH( \
2202      "\n        -w NUM  Assume the terminal is NUM columns wide") \
2203      "\n        -x      List entries by lines instead of by columns" \
2204         USE_FEATURE_LS_SORTFILES( \
2205      "\n        -X      Sort the listing by extension") \
2206         USE_FEATURE_HUMAN_READABLE( \
2207      "\n        -h      Print sizes in human readable format (e.g., 1K 243M 2G)") \
2208         USE_SELINUX( \
2209      "\n        -k      Print security context") \
2210         USE_SELINUX( \
2211      "\n        -K      Print security context in long format") \
2212         USE_SELINUX( \
2213      "\n        -Z      Print security context and permission") \
2214
2215 #define lsattr_trivial_usage \
2216        "[-Radlv] [files...]"
2217 #define lsattr_full_usage \
2218        "List file attributes on an ext2 fs\n" \
2219      "\nOptions:" \
2220      "\n        -R      Recursively list subdirectories" \
2221      "\n        -a      Do not hide entries starting with ." \
2222      "\n        -d      List directory entries instead of contents" \
2223      "\n        -l      Print long flag names" \
2224      "\n        -v      List the file's version/generation number" \
2225
2226 #define lsmod_trivial_usage \
2227        ""
2228 #define lsmod_full_usage \
2229        "List the currently loaded kernel modules"
2230
2231 #if ENABLE_FEATURE_MAKEDEVS_LEAF
2232 #define makedevs_trivial_usage \
2233        "NAME TYPE MAJOR MINOR FIRST LAST [s]"
2234 #define makedevs_full_usage \
2235        "Create a range of block or character special files\n\n" \
2236        "TYPEs include:\n" \
2237        "        b       Make a block device\n" \
2238        "        c or u  Make a character device\n" \
2239        "        p       Make a named pipe. MAJOR and MINOR are ignored\n" \
2240        "\n" \
2241        "FIRST specifies the number appended to NAME to create the first device.\n" \
2242        "LAST specifies the number of the last item that should be created\n" \
2243        "If 's' is the last argument, the base device is created as well.\n\n" \
2244        "For example:\n" \
2245        "        makedevs /dev/ttyS c 4 66 2 63   ->  ttyS2-ttyS63\n" \
2246        "        makedevs /dev/hda b 3 0 0 8 s    ->  hda,hda1-hda8"
2247 #define makedevs_example_usage \
2248        "# makedevs /dev/ttyS c 4 66 2 63\n" \
2249        "[creates ttyS2-ttyS63]\n" \
2250        "# makedevs /dev/hda b 3 0 0 8 s\n" \
2251        "[creates hda,hda1-hda8]\n"
2252 #endif
2253
2254 #if ENABLE_FEATURE_MAKEDEVS_TABLE
2255 #define makedevs_trivial_usage \
2256        "[-d device_table] rootdir"
2257 #define makedevs_full_usage \
2258        "Create a range of special files as specified in a device table.\n" \
2259        "Device table entries take the form of:\n" \
2260        "<type> <mode> <uid> <gid> <major> <minor> <start> <inc> <count>\n" \
2261        "Where name is the file name, type can be one of:\n" \
2262        "        f       A regular file\n" \
2263        "        d       Directory\n" \
2264        "        c       Character special device file\n" \
2265        "        b       Block special device file\n" \
2266        "        p       Fifo (named pipe)\n" \
2267        "uid is the user id for the target file, gid is the group id for the\n" \
2268        "target file. The rest of the entries (major, minor, etc) apply to\n" \
2269        "to device special files. A '-' may be used for blank entries."
2270 #define makedevs_example_usage \
2271        "For example:\n" \
2272        "<name>    <type> <mode><uid><gid><major><minor><start><inc><count>\n" \
2273        "/dev         d   755    0    0    -      -      -      -    -\n" \
2274        "/dev/console c   666    0    0    5      1      -      -    -\n" \
2275        "/dev/null    c   666    0    0    1      3      0      0    -\n" \
2276        "/dev/zero    c   666    0    0    1      5      0      0    -\n" \
2277        "/dev/hda     b   640    0    0    3      0      0      0    -\n" \
2278        "/dev/hda     b   640    0    0    3      1      1      1    15\n\n" \
2279        "Will Produce:\n" \
2280        "/dev\n" \
2281        "/dev/console\n" \
2282        "/dev/null\n" \
2283        "/dev/zero\n" \
2284        "/dev/hda\n" \
2285        "/dev/hda[0-15]\n"
2286 #endif
2287
2288 #define matchpathcon_trivial_usage \
2289        "[-n] [-N] [-f file_contexts_file] [-p prefix] [-V]"
2290 #define matchpathcon_full_usage \
2291        "        -n      Do not display path" \
2292      "\n        -N      Do not use translations" \
2293      "\n        -f      Use alternate file_context file" \
2294      "\n        -p      Use prefix to speed translations" \
2295      "\n        -V      Verify file context on disk matches defaults" \
2296
2297 #define md5sum_trivial_usage \
2298        "[OPTION] [FILEs...]" \
2299         USE_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: md5sum [OPTION] -c [FILE]")
2300 #define md5sum_full_usage \
2301        "Print" USE_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums" \
2302         USE_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
2303      "\nOptions:" \
2304      "\n        -c      Check MD5 sums against given list" \
2305      "\n        -s      Don't output anything, status code shows success" \
2306      "\n        -w      Warn about improperly formatted MD5 checksum lines") \
2307
2308 #define md5sum_example_usage \
2309        "$ md5sum < busybox\n" \
2310        "6fd11e98b98a58f64ff3398d7b324003\n" \
2311        "$ md5sum busybox\n" \
2312        "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
2313        "$ md5sum -c -\n" \
2314        "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
2315        "busybox: OK\n" \
2316        "^D\n"
2317
2318 #define mdev_trivial_usage \
2319        "[-s]"
2320 #define mdev_full_usage \
2321        "        -s      Scan /sys and populate /dev during system boot\n" \
2322        "\n" \
2323        "Called with no options (via hotplug) it uses environment variables\n" \
2324        "to determine which device to add/remove."
2325
2326 #define mdev_notes_usage "" \
2327         USE_FEATURE_MDEV_CONFIG( \
2328        "The mdev config file contains lines that look like:\n" \
2329        "  hd[a-z][0-9]* 0:3 660\n\n" \
2330        "That's device name (with regex match), uid:gid, and permissions.\n\n" \
2331         USE_FEATURE_MDEV_EXEC( \
2332        "Optionally, that can be followed (on the same line) by a special character\n" \
2333        "and a command line to run after creating/before deleting the corresponding\n" \
2334        "device(s). The environment variable $MDEV indicates the active device node\n" \
2335        "(which is useful if it's a regex match). For example:\n\n" \
2336        "  hdc root:cdrom 660  *ln -s $MDEV cdrom\n\n" \
2337        "The special characters are @ (run after creating), $ (run before deleting),\n" \
2338        "and * (run both after creating and before deleting). The commands run in\n" \
2339        "the /dev directory, and use system() which calls /bin/sh.\n\n" \
2340         ) \
2341        "Config file parsing stops on the first matching line. If no config\n" \
2342        "entry is matched, devices are created with default 0:0 660. (Make\n" \
2343        "the last line match .* to override this.)\n\n" \
2344         )
2345
2346 #define mesg_trivial_usage \
2347        "[y|n]"
2348 #define mesg_full_usage \
2349        "Control write access to your terminal\n" \
2350        "        y       Allow write access to your terminal\n" \
2351        "        n       Disallow write access to your terminal"
2352
2353 #define microcom_trivial_usage \
2354        "[-d DELAY] [-t TIMEOUT] [-s SPEED] [-X] TTY"
2355 #define microcom_full_usage \
2356        "Copy bytes for stdin to TTY and from TTY to stdout\n" \
2357      "\nOptions:" \
2358      "\n        -d      Wait up to DELAY ms for TTY output before sending every" \
2359      "\n                next byte to it" \
2360      "\n        -t      Exit if both stdin and TTY are silent for TIMEOUT ms" \
2361      "\n        -s      Set serial line to SPEED" \
2362      "\n        -X      Disable special meaning of NUL and Ctrl-X from stdin" \
2363
2364 #define mkdir_trivial_usage \
2365        "[OPTION] DIRECTORY..."
2366 #define mkdir_full_usage \
2367        "Create DIRECTORY\n" \
2368      "\nOptions:" \
2369      "\n        -m      Set permission mode (as in chmod), not rwxrwxrwx - umask" \
2370      "\n        -p      No error if existing, make parent directories as needed" \
2371         USE_SELINUX( \
2372      "\n        -Z      Set security context" \
2373         )
2374
2375 #define mkdir_example_usage \
2376        "$ mkdir /tmp/foo\n" \
2377        "$ mkdir /tmp/foo\n" \
2378        "/tmp/foo: File exists\n" \
2379        "$ mkdir /tmp/foo/bar/baz\n" \
2380        "/tmp/foo/bar/baz: No such file or directory\n" \
2381        "$ mkdir -p /tmp/foo/bar/baz\n"
2382
2383 #define mke2fs_trivial_usage \
2384        "[-c|-l filename] [-b block-size] [-f fragment-size] [-g blocks-per-group] " \
2385        "[-i bytes-per-inode] [-j] [-J journal-options] [-N number-of-inodes] [-n] " \
2386        "[-m reserved-blocks-percentage] [-o creator-os] [-O feature[,...]] [-q] " \
2387        "[r fs-revision-level] [-E extended-options] [-v] [-F] [-L volume-label] " \
2388        "[-M last-mounted-directory] [-S] [-T filesystem-type] " \
2389        "device [blocks-count]"
2390 #define mke2fs_full_usage \
2391        "        -b size         Block size in bytes" \
2392      "\n        -c              Check for bad blocks before creating" \
2393      "\n        -E opts         Set extended options" \
2394      "\n        -f size         Fragment size in bytes" \
2395      "\n        -F              Force (ignore sanity checks)" \
2396      "\n        -g num          Number of blocks in a block group" \
2397      "\n        -i ratio        The bytes/inode ratio" \
2398      "\n        -j              Create a journal (ext3)" \
2399      "\n        -J opts         Set journal options (size/device)" \
2400      "\n        -l file         Read bad blocks list from file" \
2401      "\n        -L lbl          Set the volume label" \
2402      "\n        -m percent      Percent of fs blocks to reserve for admin" \
2403      "\n        -M dir          Set last mounted directory" \
2404      "\n        -n              Do not actually create anything" \
2405      "\n        -N num          Number of inodes to create" \
2406      "\n        -o os           Set the 'creator os' field" \
2407      "\n        -O features     Dir_index/filetype/has_journal/journal_dev/sparse_super" \
2408      "\n        -q              Quiet" \
2409      "\n        -r rev          Set filesystem revision" \
2410      "\n        -S              Write superblock and group descriptors only" \
2411      "\n        -T fs-type      Set usage type (news/largefile/largefile4)" \
2412      "\n        -v              Verbose" \
2413
2414 #define mkfifo_trivial_usage \
2415        "[OPTIONS] name"
2416 #define mkfifo_full_usage \
2417        "Create named pipe (identical to 'mknod name p')\n" \
2418      "\nOptions:" \
2419      "\n        -m MODE Mode (default a=rw)" \
2420         USE_SELINUX( \
2421      "\n        -Z      Set security context" \
2422         )
2423
2424 #define mkfs_minix_trivial_usage \
2425        "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]"
2426 #define mkfs_minix_full_usage \
2427        "Make a MINIX filesystem\n" \
2428      "\nOptions:" \
2429      "\n        -c              Check device for bad blocks" \
2430      "\n        -n [14|30]      Maximum length of filenames" \
2431      "\n        -i INODES       Number of inodes for the filesystem" \
2432      "\n        -l FILENAME     Read bad blocks list from FILENAME" \
2433      "\n        -v              Make version 2 filesystem" \
2434
2435 #define mknod_trivial_usage \
2436        "[OPTIONS] NAME TYPE MAJOR MINOR"
2437 #define mknod_full_usage \
2438        "Create a special file (block, character, or pipe)\n" \
2439      "\nOptions:" \
2440      "\n        -m      Create the special file using the specified mode (default a=rw)" \
2441      "\nTYPEs include:" \
2442      "\n        b:      Make a block device" \
2443      "\n        c or u: Make a character device" \
2444      "\n        p:      Make a named pipe (MAJOR and MINOR are ignored)" \
2445         USE_SELINUX( \
2446      "\n        -Z      Set security context" \
2447         )
2448
2449 #define mknod_example_usage \
2450        "$ mknod /dev/fd0 b 2 0\n" \
2451        "$ mknod -m 644 /tmp/pipe p\n"
2452
2453 #define mkswap_trivial_usage \
2454        "DEVICE"
2455 #define mkswap_full_usage \
2456        "Prepare block device to be used as swap partition"
2457 #if 0
2458        "[-c] [-v0|-v1] DEVICE [BLOCKS]"
2459      "\nOptions:"
2460      "\n        -c      Check for readability"
2461      "\n        -v0     Make swap version 0 (max 128M)"
2462      "\n        -v1     Make swap version 1 (default for kernels > 2.1.117)"
2463      "\n        BLOCKS  Number of blocks to use (default is entire partition)"
2464 #endif
2465
2466 #define mktemp_trivial_usage \
2467        "[-dt] [-p DIR] TEMPLATE"
2468 #define mktemp_full_usage \
2469        "Create a temporary file with its name based on TEMPLATE.\n" \
2470        "TEMPLATE is any name with six 'Xs' (i.e., /tmp/temp.XXXXXX).\n" \
2471      "\nOptions:" \
2472      "\n        -d      Make a directory instead of a file" \
2473 /*   "\n        -q      Fail silently if an error occurs" - we ignore it */ \
2474      "\n        -t      Generate a path rooted in temporary directory" \
2475      "\n        -p DIR  Use DIR as a temporary directory (implies -t)" \
2476      "\n" \
2477      "\n" \
2478        "For -t or -p, directory is chosen as follows:\n" \
2479        "$TMPDIR if set, else -p DIR, else /tmp" \
2480
2481 #define mktemp_example_usage \
2482        "$ mktemp /tmp/temp.XXXXXX\n" \
2483        "/tmp/temp.mWiLjM\n" \
2484        "$ ls -la /tmp/temp.mWiLjM\n" \
2485        "-rw-------    1 andersen andersen        0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
2486
2487 #define modprobe_trivial_usage \
2488        "[-knqrsv] MODULE [symbol=value...]"
2489 #define modprobe_full_usage \
2490        "Options:" \
2491      "\n        -k      Make module autoclean-able" \
2492      "\n        -n      Dry run" \
2493      "\n        -q      Quiet" \
2494      "\n        -r      Remove module (stacks) or do autoclean" \
2495      "\n        -s      Report via syslog instead of stderr" \
2496      "\n        -v      Verbose" \
2497
2498 #define modprobe_notes_usage \
2499 "modprobe can (un)load a stack of modules, passing each module options (when\n" \
2500 "loading). modprobe uses a configuration file to determine what option(s) to\n" \
2501 "pass each module it loads.\n" \
2502 "\n" \
2503 "The configuration file is searched (in order) amongst:\n" \
2504 "\n" \
2505 "    /etc/modprobe.conf (2.6 only)\n" \
2506 "    /etc/modules.conf\n" \
2507 "    /etc/conf.modules (deprecated)\n" \
2508 "\n" \
2509 "They all have the same syntax (see below). If none is present, it is\n" \
2510 "_not_ an error; each loaded module is then expected to load without\n" \
2511 "options. Once a file is found, the others are tested for.\n" \
2512 "\n" \
2513 "/etc/modules.conf entry format:\n" \
2514 "\n" \
2515 "  alias <alias_name> <mod_name>\n" \
2516 "    Makes it possible to modprobe alias_name, when there is no such module.\n" \
2517 "    It makes sense if your mod_name is long, or you want a more representative\n" \
2518 "    name for that module (eg. 'scsi' in place of 'aha7xxx').\n" \
2519 "    This makes it also possible to use a different set of options (below) for\n" \
2520 "    the module and the alias.\n" \
2521 "    A module can be aliased more than once.\n" \
2522 "\n" \
2523 "  options <mod_name|alias_name> <symbol=value...>\n" \
2524 "    When loading module mod_name (or the module aliased by alias_name), pass\n" \
2525 "    the \"symbol=value\" pairs as option to that module.\n" \
2526 "\n" \
2527 "Sample /etc/modules.conf file:\n" \
2528 "\n" \
2529 "  options tulip irq=3\n" \
2530 "  alias tulip tulip2\n" \
2531 "  options tulip2 irq=4 io=0x308\n" \
2532 "\n" \
2533 "Other functionality offered by 'classic' modprobe is not available in\n" \
2534 "this implementation.\n" \
2535 "\n" \
2536 "If module options are present both in the config file, and on the command line,\n" \
2537 "then the options from the command line will be passed to the module _after_\n" \
2538 "the options from the config file. That way, you can have defaults in the config\n" \
2539 "file, and override them for a specific usage from the command line.\n"
2540 #define modprobe_example_usage \
2541        "(with the above /etc/modules.conf):\n\n" \
2542        "$ modprobe tulip\n" \
2543        "   will load the module 'tulip' with default option 'irq=3'\n\n" \
2544        "$ modprobe tulip irq=5\n" \
2545        "   will load the module 'tulip' with option 'irq=5', thus overriding the default\n\n" \
2546        "$ modprobe tulip2\n" \
2547        "   will load the module 'tulip' with default options 'irq=4 io=0x308',\n" \
2548        "   which are the default for alias 'tulip2'\n\n" \
2549        "$ modprobe tulip2 irq=8\n" \
2550        "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=8',\n" \
2551        "   which are the default for alias 'tulip2' overridden by the option 'irq=8'\n\n" \
2552        "   from the command line\n\n" \
2553        "$ modprobe tulip2 irq=2 io=0x210\n" \
2554        "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=4 io=0x210',\n" \
2555        "   which are the default for alias 'tulip2' overridden by the options 'irq=2 io=0x210'\n\n" \
2556        "   from the command line\n"
2557
2558 #define more_trivial_usage \
2559        "[FILE...]"
2560 #define more_full_usage \
2561        "View FILE or standard input one screenful at a time"
2562
2563 #define more_example_usage \
2564        "$ dmesg | more\n"
2565
2566 #define mount_trivial_usage \
2567        "[flags] DEVICE NODE [-o options,more-options]"
2568 #define mount_full_usage \
2569        "Mount a filesystem. Filesystem autodetection requires /proc be mounted.\n" \
2570      "\nOptions:" \
2571      "\n        -a              Mount all filesystems in fstab" \
2572         USE_FEATURE_MOUNT_FAKE( \
2573      "\n        -f              "USE_FEATURE_MTAB_SUPPORT("Update /etc/mtab, but ")"don't mount" \
2574         ) \
2575         USE_FEATURE_MTAB_SUPPORT( \
2576      "\n        -n              Don't update /etc/mtab" \
2577         ) \
2578      "\n        -r              Read-only mount" \
2579      "\n        -t fs-type      Filesystem type" \
2580      "\n        -w              Read-write mount (default)" \
2581        "\n" \
2582        "-o option:\n" \
2583         USE_FEATURE_MOUNT_LOOP( \
2584        "        loop            Ignored (loop devices are autodetected)\n" \
2585         ) \
2586         USE_FEATURE_MOUNT_FLAGS( \
2587        "        [a]sync         Writes are asynchronous / synchronous\n" \
2588        "        [no]atime       Disable / enable updates to inode access times\n" \
2589        "        [no]diratime    Disable / enable atime updates to directories\n" \
2590        "        [no]dev         Allow use of special device files / disallow them\n" \
2591        "        [no]exec        Allow use of executable files / disallow them\n" \
2592        "        [no]suid        Allow set-user-id-root programs / disallow them\n" \
2593        "        [r]shared       Convert [recursively] to a shared subtree\n" \
2594        "        [r]slave        Convert [recursively] to a slave subtree\n" \
2595        "        [r]private      Convert [recursively] to a private subtree\n" \
2596        "        [un]bindable    Make mount point [un]able to be bind mounted\n" \
2597        "        bind            Bind a directory to an additional location\n" \
2598        "        move            Relocate an existing mount point\n" \
2599         ) \
2600        "        remount         Remount a mounted filesystem, changing its flags\n" \
2601        "        ro/rw           Mount for read-only / read-write\n" \
2602        "\n" \
2603        "There are EVEN MORE flags that are specific to each filesystem\n" \
2604        "You'll have to see the written documentation for those filesystems" \
2605
2606 #define mount_example_usage \
2607        "$ mount\n" \
2608        "/dev/hda3 on / type minix (rw)\n" \
2609        "proc on /proc type proc (rw)\n" \
2610        "devpts on /dev/pts type devpts (rw)\n" \
2611        "$ mount /dev/fd0 /mnt -t msdos -o ro\n" \
2612        "$ mount /tmp/diskimage /opt -t ext2 -o loop\n" \
2613        "$ mount cd_image.iso mydir\n"
2614 #define mount_notes_usage \
2615        "Returns 0 for success, number of failed mounts for -a, or errno for one mount."
2616
2617 #define mountpoint_trivial_usage \
2618        "[-q] <[-d] DIR | -x DEVICE>"
2619 #define mountpoint_full_usage \
2620        "mountpoint checks if the directory is a mountpoint\n" \
2621      "\nOptions:" \
2622      "\n        -q      Quiet" \
2623      "\n        -d      Print major/minor device number of the filesystem" \
2624      "\n        -x      Print major/minor device number of the blockdevice" \
2625
2626 #define mountpoint_example_usage \
2627        "$ mountpoint /proc\n" \
2628        "/proc is not a mountpoint\n" \
2629        "$ mountpoint /sys\n" \
2630        "/sys is a mountpoint\n"
2631
2632 #define mt_trivial_usage \
2633        "[-f device] opcode value"
2634 #define mt_full_usage \
2635        "Control magnetic tape drive operation\n" \
2636        "\n" \
2637        "Available Opcodes:\n" \
2638        "\n" \
2639        "bsf bsfm bsr bss datacompression drvbuffer eof eom erase\n" \
2640        "fsf fsfm fsr fss load lock mkpart nop offline ras1 ras2\n" \
2641        "ras3 reset retension rewind rewoffline seek setblk setdensity\n" \
2642        "setpart tell unload unlock weof wset" \
2643
2644 #define mv_trivial_usage \
2645        "[OPTION]... SOURCE DEST\n" \
2646        "or: mv [OPTION]... SOURCE... DIRECTORY"
2647 #define mv_full_usage \
2648        "Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY\n" \
2649      "\nOptions:" \
2650      "\n        -f      Don't prompt before overwriting" \
2651      "\n        -i      Interactive, prompt before overwrite" \
2652
2653 #define mv_example_usage \
2654        "$ mv /tmp/foo /bin/bar\n"
2655
2656 #define nameif_trivial_usage \
2657        "[-s] [-c FILE] [{IFNAME MACADDR}]"
2658 #define nameif_full_usage \
2659        "Rename network interface while it in the down state\n" \
2660      "\nOptions:" \
2661      "\n        -c FILE         Use configuration file (default is /etc/mactab)" \
2662      "\n        -s              Use syslog (LOCAL0 facility)" \
2663      "\n        IFNAME MACADDR  new_interface_name interface_mac_address" \
2664
2665 #define nameif_example_usage \
2666        "$ nameif -s dmz0 00:A0:C9:8C:F6:3F\n" \
2667        " or\n" \
2668        "$ nameif -c /etc/my_mactab_file\n" \
2669
2670 #if !ENABLE_DESKTOP
2671
2672 #if ENABLE_NC_SERVER || ENABLE_NC_EXTRA
2673 #define NC_OPTIONS_STR "\n\nOptions:"
2674 #else
2675 #define NC_OPTIONS_STR
2676 #endif
2677
2678 #define nc_trivial_usage \
2679         USE_NC_EXTRA("[-iN] [-wN] ")USE_NC_SERVER("[-l] [-p PORT] ") \
2680        "["USE_NC_EXTRA("-f FILENAME|")"IPADDR PORTNUM]"USE_NC_EXTRA(" [-e COMMAND]")
2681 #define nc_full_usage \
2682        "Open a pipe to IP:port" USE_NC_EXTRA(" or file") \
2683         NC_OPTIONS_STR \
2684         USE_NC_EXTRA( \
2685      "\n        -e      Exec rest of command line after connect" \
2686      "\n        -i SECS Delay interval for lines sent" \
2687      "\n        -w SECS Timeout for connect" \
2688      "\n        -f FILE Use file (ala /dev/ttyS0) instead of network" \
2689         ) \
2690         USE_NC_SERVER( \
2691      "\n        -l      Listen mode, for inbound connects" \
2692         USE_NC_EXTRA( \
2693      "\n                (use -l twice with -e for persistent server)") \
2694      "\n        -p PORT Local port number" \
2695         )
2696
2697 #define nc_notes_usage "" \
2698         USE_NC_EXTRA( \
2699        "To use netcat as a terminal emulator on a serial port:\n\n" \
2700        "$ stty 115200 -F /dev/ttyS0\n" \
2701        "$ stty raw -echo -ctlecho && nc -f /dev/ttyS0\n" \
2702         )
2703
2704 #define nc_example_usage \
2705        "$ nc foobar.somedomain.com 25\n" \
2706        "220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600\n" \
2707        "help\n" \
2708        "214-Commands supported:\n" \
2709        "214-    HELO EHLO MAIL RCPT DATA AUTH\n" \
2710        "214     NOOP QUIT RSET HELP\n" \
2711        "quit\n" \
2712        "221 foobar closing connection\n"
2713
2714 #else /* DESKTOP nc - much more compatible with nc 1.10 */
2715
2716 #define nc_trivial_usage \
2717        "[-options] hostname port  - connect" \
2718         USE_NC_SERVER("\n" \
2719        "nc [-options] -l -p port [hostname] [port]  - listen")
2720 #define nc_full_usage \
2721        "Options:" \
2722      "\n        -e prog [args]  Program to exec after connect (must be last)" \
2723         USE_NC_SERVER( \
2724      "\n        -l              Listen mode, for inbound connects" \
2725         ) \
2726      "\n        -n              Don't do DNS resolution" \
2727      "\n        -s addr         Local address" \
2728      "\n        -p port         Local port" \
2729      "\n        -u              UDP mode" \
2730      "\n        -v              Verbose (cumulative: -vv)" \
2731      "\n        -w secs         Timeout for connects and final net reads" \
2732         USE_NC_EXTRA( \
2733      "\n        -i sec          Delay interval for lines sent" /* ", ports scanned" */ \
2734      "\n        -o file         Hex dump of traffic" \
2735      "\n        -z              Zero-I/O mode (scanning)" \
2736         ) \
2737 /*   "\n        -r              Randomize local and remote ports" */
2738 /*   "\n        -g gateway      Source-routing hop point[s], up to 8" */
2739 /*   "\n        -G num          Source-routing pointer: 4, 8, 12, ..." */
2740 /*   "\nport numbers can be individual or ranges: lo-hi [inclusive]" */
2741
2742 #endif
2743
2744 #define netstat_trivial_usage \
2745        "[-laentuwxr"USE_FEATURE_NETSTAT_WIDE("W")"]"
2746 #define netstat_full_usage \
2747        "Display networking information\n" \
2748      "\nOptions:" \
2749      "\n        -l      Display listening server sockets" \
2750      "\n        -a      Display all sockets (default: connected)" \
2751      "\n        -e      Display other/more information" \
2752      "\n        -n      Don't resolve names" \
2753      "\n        -t      Tcp sockets" \
2754      "\n        -u      Udp sockets" \
2755      "\n        -w      Raw sockets" \
2756      "\n        -x      Unix sockets" \
2757      "\n        -r      Display routing table" \
2758         USE_FEATURE_NETSTAT_WIDE( \
2759      "\n        -W      Display with no column truncation" \
2760         )
2761
2762 #define nice_trivial_usage \
2763        "[-n ADJUST] [COMMAND [ARG]...]"
2764 #define nice_full_usage \
2765        "Run a program with modified scheduling priority\n" \
2766      "\nOptions:" \
2767      "\n        -n ADJUST       Adjust the scheduling priority by ADJUST" \
2768
2769 #define nmeter_trivial_usage \
2770        "format_string"
2771 #define nmeter_full_usage \
2772        "Monitor system in real time\n\n" \
2773        "Format specifiers:\n" \
2774        "%Nc or %[cN]    Monitor CPU. N - bar size, default 10\n" \
2775        "                (displays: S:system U:user N:niced D:iowait I:irq i:softirq)\n" \
2776        "%[niface]       Monitor network interface 'iface'\n" \
2777        "%m              Monitor allocated memory\n" \
2778        "%[mf]           Monitor free memory\n" \
2779        "%[mt]           Monitor total memory\n" \
2780        "%s              Monitor allocated swap\n" \
2781        "%f              Monitor number of used file descriptors\n" \
2782        "%Ni             Monitor total/specific IRQ rate\n" \
2783        "%x              Monitor context switch rate\n" \
2784        "%p              Monitor forks\n" \
2785        "%[pn]           Monitor # of processes\n" \
2786        "%b              Monitor block io\n" \
2787        "%Nt             Show time (with N decimal points)\n" \
2788        "%Nd             Milliseconds between updates (default=1000)\n" \
2789        "%r              Print <cr> instead of <lf> at EOL" \
2790
2791 #define nmeter_example_usage \
2792        "nmeter '%250d%t %20c int %i bio %b mem %m forks%p'"
2793
2794 #define nohup_trivial_usage \
2795        "COMMAND [ARGS]"
2796 #define nohup_full_usage \
2797        "Run a command immune to hangups, with output to a non-tty"
2798 #define nohup_example_usage \
2799        "$ nohup make &"
2800
2801 #define nslookup_trivial_usage \
2802        "[HOST] [SERVER]"
2803 #define nslookup_full_usage \
2804        "Query the nameserver for the IP address of the given HOST\n" \
2805        "optionally using a specified DNS server"
2806 #define nslookup_example_usage \
2807        "$ nslookup localhost\n" \
2808        "Server:     default\n" \
2809        "Address:    default\n" \
2810        "\n" \
2811        "Name:       debian\n" \
2812        "Address:    127.0.0.1\n"
2813
2814 #define od_trivial_usage \
2815        "[-aBbcDdeFfHhIiLlOovXx] " USE_DESKTOP("[-t TYPE] ") "[FILE]"
2816 #define od_full_usage \
2817        "Write an unambiguous representation, octal bytes by default, of FILE\n" \
2818        "to standard output. With no FILE or when FILE is -, read standard input."
2819
2820 #define openvt_trivial_usage \
2821        "[-c NUM] [-sw] [COMMAND [ARGS]]"
2822 #define openvt_full_usage \
2823        "Start COMMAND on a new virtual terminal\n" \
2824      "\nOptions:" \
2825      "\n        -c      Use specified VT" \
2826      "\n        -s      Switch to the VT" \
2827 /*   "\n        -l      Run COMMAND as login shell (by prepending '-')" */ \
2828      "\n        -w      Wait for COMMAND to exit" \
2829
2830 #define openvt_example_usage \
2831        "openvt 2 /bin/ash\n"
2832
2833 #define passwd_trivial_usage \
2834        "[OPTION] [name]"
2835 #define passwd_full_usage \
2836        "Change user's password. If no name is specified,\n" \
2837        "changes the password for the current user.\n" \
2838      "\nOptions:" \
2839      "\n        -a      Algorithm to use for password (choices: des, md5)" /* ", sha1)" */ \
2840      "\n        -d      Delete password for the account" \
2841      "\n        -l      Lock (disable) account" \
2842      "\n        -u      Unlock (re-enable) account" \
2843
2844 #define chpasswd_trivial_usage \
2845         USE_GETOPT_LONG("[--md5|--encrypt]") SKIP_GETOPT_LONG("[-m|-e]")
2846 #define chpasswd_full_usage \
2847        "Read user:password information from stdin\n" \
2848        "and update /etc/passwd accordingly.\n" \
2849      "\nOptions:" \
2850         USE_GETOPT_LONG( \
2851      "\n        -e,--encrypt    Supplied passwords are in encrypted form" \
2852      "\n        -m,--md5        Use MD5 encryption instead of DES" \
2853         ) \
2854         SKIP_GETOPT_LONG( \
2855      "\n        -e      Supplied passwords are in encrypted form" \
2856      "\n        -m      Use MD5 encryption instead of DES" \
2857         )
2858
2859 #define patch_trivial_usage \
2860        "[-p NUM] [-i DIFF] [-R]"
2861 #define patch_full_usage \
2862        "        -p NUM  Strip NUM leading components from file names" \
2863      "\n        -i DIFF Read DIFF instead of stdin" \
2864      "\n        -R      Reverse patch" \
2865
2866 #define patch_example_usage \
2867        "$ patch -p1 < example.diff\n" \
2868        "$ patch -p0 -i example.diff"
2869
2870 #define pgrep_trivial_usage \
2871        "[-flnovx] pattern"
2872 #define pgrep_full_usage \
2873        "Display process(es) selected by regex pattern\n" \
2874      "\nOptions:" \
2875      "\n        -l      Show command name too" \
2876      "\n        -f      Match against entire command line" \
2877      "\n        -n      Show the newest process only" \
2878      "\n        -o      Show the oldest process only" \
2879      "\n        -v      Negate the matching" \
2880      "\n        -x      Match whole name (not substring)" \
2881
2882 #if (ENABLE_FEATURE_PIDOF_SINGLE || ENABLE_FEATURE_PIDOF_OMIT)
2883 #define pidof_trivial_usage \
2884        "[OPTION] [NAME...]"
2885 #define USAGE_PIDOF "\n\nOptions:"
2886 #else
2887 #define pidof_trivial_usage \
2888        "[NAME...]"
2889 #define USAGE_PIDOF /* none */
2890 #endif
2891 #define pidof_full_usage \
2892        "List PIDs of all processes with names that match NAMEs" \
2893         USAGE_PIDOF \
2894         USE_FEATURE_PIDOF_SINGLE( \
2895      "\n        -s      Show only one PID") \
2896         USE_FEATURE_PIDOF_OMIT( \
2897      "\n        -o PID  Omit given pid" \
2898      "\n                Use %PPID to omit pid of pidof's parent") \
2899
2900 #define pidof_example_usage \
2901        "$ pidof init\n" \
2902        "1\n" \
2903         USE_FEATURE_PIDOF_OMIT( \
2904        "$ pidof /bin/sh\n20351 5973 5950\n") \
2905         USE_FEATURE_PIDOF_OMIT( \
2906        "$ pidof /bin/sh -o %PPID\n20351 5950")
2907
2908 #if !ENABLE_FEATURE_FANCY_PING
2909 #define ping_trivial_usage \
2910        "host"
2911 #define ping_full_usage \
2912        "Send ICMP ECHO_REQUEST packets to network hosts"
2913 #define ping6_trivial_usage \
2914        "host"
2915 #define ping6_full_usage \
2916        "Send ICMP ECHO_REQUEST packets to network hosts"
2917 #else
2918 #define ping_trivial_usage \
2919        "[OPTION]... host"
2920 #define ping_full_usage \
2921        "Send ICMP ECHO_REQUEST packets to network hosts\n" \
2922      "\nOptions:" \
2923      "\n        -4, -6          Force IPv4 or IPv6 hostname resolution" \
2924      "\n        -c CNT          Send only CNT pings" \
2925      "\n        -s SIZE         Send SIZE data bytes in packets (default=56)" \
2926      "\n        -I iface/IP     Use interface or IP address as source" \
2927      "\n        -q              Quiet, only displays output at start" \
2928      "\n                        and when finished" \
2929
2930 #define ping6_trivial_usage \
2931        "[OPTION]... host"
2932 #define ping6_full_usage \
2933        "Send ICMP ECHO_REQUEST packets to network hosts\n" \
2934      "\nOptions:" \
2935      "\n        -c CNT          Send only CNT pings" \
2936      "\n        -s SIZE         Send SIZE data bytes in packets (default=56)" \
2937      "\n        -I iface/IP     Use interface or IP address as source" \
2938      "\n        -q              Quiet, only displays output at start" \
2939      "\n                        and when finished" \
2940
2941 #endif
2942 #define ping_example_usage \
2943        "$ ping localhost\n" \
2944        "PING slag (127.0.0.1): 56 data bytes\n" \
2945        "64 bytes from 127.0.0.1: icmp_seq=0 ttl=255 time=20.1 ms\n" \
2946        "\n" \
2947        "--- debian ping statistics ---\n" \
2948        "1 packets transmitted, 1 packets received, 0% packet loss\n" \
2949        "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
2950 #define ping6_example_usage \
2951        "$ ping6 ip6-localhost\n" \
2952        "PING ip6-localhost (::1): 56 data bytes\n" \
2953        "64 bytes from ::1: icmp6_seq=0 ttl=64 time=20.1 ms\n" \
2954        "\n" \
2955        "--- ip6-localhost ping statistics ---\n" \
2956        "1 packets transmitted, 1 packets received, 0% packet loss\n" \
2957        "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
2958
2959 #define pivot_root_trivial_usage \
2960        "NEW_ROOT PUT_OLD"
2961 #define pivot_root_full_usage \
2962        "Move the current root file system to PUT_OLD and make NEW_ROOT\n" \
2963        "the new root file system"
2964
2965 #define pkill_trivial_usage \
2966        "[-l] | [-fnovx] [-signal] pattern"
2967 #define pkill_full_usage \
2968        "Send a signal to process(es) selected by regex pattern\n" \
2969      "\nOptions:" \
2970      "\n        -l      List all signals" \
2971      "\n        -f      Match against entire command line" \
2972      "\n        -n      Signal the newest process only" \
2973      "\n        -o      Signal the oldest process only" \
2974      "\n        -v      Negate the matching" \
2975      "\n        -x      Match whole name (not substring)" \
2976
2977 #define poweroff_trivial_usage \
2978        "[-d delay] [-n] [-f]"
2979 #define poweroff_full_usage \
2980        "Halt and shut off power\n" \
2981      "\nOptions:" \
2982      "\n        -d      Delay interval for halting" \
2983      "\n        -n      No call to sync()" \
2984      "\n        -f      Force power off (don't go through init)" \
2985
2986 #define printenv_trivial_usage \
2987        "[VARIABLES...]"
2988 #define printenv_full_usage \
2989        "Print all or part of environment.\n" \
2990        "If no environment VARIABLE specified, print them all."
2991
2992 #define printf_trivial_usage \
2993        "FORMAT [ARGUMENT...]"
2994 #define printf_full_usage \
2995        "Format and print ARGUMENT(s) according to FORMAT,\n" \
2996        "where FORMAT controls the output exactly as in C printf"
2997 #define printf_example_usage \
2998        "$ printf \"Val=%d\\n\" 5\n" \
2999        "Val=5\n"
3000
3001
3002 #if ENABLE_DESKTOP
3003
3004 #define ps_trivial_usage \
3005        ""
3006 #define ps_full_usage \
3007        "Report process status\n" \
3008      "\nOptions:" \
3009      "\n        -o col1,col2=header     Select columns for display" \
3010
3011 #else /* !ENABLE_DESKTOP */
3012
3013 #if !ENABLE_SELINUX && !ENABLE_FEATURE_PS_WIDE
3014 #define USAGE_PS "\nThis version of ps accepts no options"
3015 #else
3016 #define USAGE_PS "\nOptions:"
3017 #endif
3018
3019 #define ps_trivial_usage \
3020        ""
3021 #define ps_full_usage \
3022        "Report process status\n" \
3023         USAGE_PS \
3024         USE_SELINUX( \
3025      "\n        -Z      Show SE Linux context" \
3026         ) \
3027         USE_FEATURE_PS_WIDE( \
3028      "\n        w       Wide output" \
3029         )
3030
3031 #endif /* ENABLE_DESKTOP */
3032
3033 #define ps_example_usage \
3034        "$ ps\n" \
3035        "  PID  Uid      Gid State Command\n" \
3036        "    1 root     root     S init\n" \
3037        "    2 root     root     S [kflushd]\n" \
3038        "    3 root     root     S [kupdate]\n" \
3039        "    4 root     root     S [kpiod]\n" \
3040        "    5 root     root     S [kswapd]\n" \
3041        "  742 andersen andersen S [bash]\n" \
3042        "  743 andersen andersen S -bash\n" \
3043        "  745 root     root     S [getty]\n" \
3044        " 2990 andersen andersen R ps\n"
3045
3046 #define pscan_trivial_usage \
3047        "[-cb] [-p MIN_PORT] [-P MAX_PORT] [-t TIMEOUT] [-T MIN_RTT] HOST"
3048 #define pscan_full_usage \
3049        "Scan a host, print all open ports\n" \
3050      "\nOptions:" \
3051      "\n        -c      Show closed ports too" \
3052      "\n        -b      Show blocked ports too" \
3053      "\n        -p      Scan from this port (default 1)" \
3054      "\n        -P      Scan up to this port (default 1024)" \
3055      "\n        -t      Timeout (default 5000 ms)" \
3056      "\n        -T      Minimum rtt (default 5 ms, increase for congested hosts)" \
3057
3058 #define pwd_trivial_usage \
3059        ""
3060 #define pwd_full_usage \
3061        "Print the full filename of the current working directory"
3062 #define pwd_example_usage \
3063        "$ pwd\n" \
3064        "/root\n"
3065
3066 #define raidautorun_trivial_usage \
3067        "DEVICE"
3068 #define raidautorun_full_usage \
3069        "Tell the kernel to automatically search and start RAID arrays"
3070 #define raidautorun_example_usage \
3071        "$ raidautorun /dev/md0"
3072
3073 #define rdate_trivial_usage \
3074        "[-sp] HOST"
3075 #define rdate_full_usage \
3076        "Get and possibly set the system date and time from a remote HOST\n" \
3077      "\nOptions:" \
3078      "\n        -s      Set the system date and time (default)" \
3079      "\n        -p      Print the date and time" \
3080
3081 #define readahead_trivial_usage \
3082        "[FILE]..."
3083 #define readahead_full_usage \
3084        "Preload FILE(s) in RAM cache so that subsequent reads for those" \
3085        "files do not block on disk I/O"
3086
3087 #define readlink_trivial_usage \
3088         USE_FEATURE_READLINK_FOLLOW("[-f] ") "FILE"
3089 #define readlink_full_usage \
3090        "Display the value of a symlink" \
3091         USE_FEATURE_READLINK_FOLLOW( "\n" \
3092      "\nOptions:" \
3093      "\n        -f      Canonicalize by following all symlinks") \
3094
3095 #define readprofile_trivial_usage \
3096        "[OPTIONS]..."
3097 #define readprofile_full_usage \
3098        "Options:" \
3099      "\n        -m mapfile      (Default: /boot/System.map)" \
3100      "\n        -p profile      (Default: /proc/profile)" \
3101      "\n        -M mult         Set the profiling multiplier to mult" \
3102      "\n        -i              Print only info about the sampling step" \
3103      "\n        -v              Verbose" \
3104      "\n        -a              Print all symbols, even if count is 0" \
3105      "\n        -b              Print individual histogram-bin counts" \
3106      "\n        -s              Print individual counters within functions" \
3107      "\n        -r              Reset all the counters (root only)" \
3108      "\n        -n              Disable byte order auto-detection" \
3109
3110 #define realpath_trivial_usage \
3111        "pathname..."
3112 #define realpath_full_usage \
3113        "Return the absolute pathnames of given argument"
3114
3115 #define reboot_trivial_usage \
3116        "[-d delay] [-n] [-f]"
3117 #define reboot_full_usage \
3118        "Reboot the system\n" \
3119      "\nOptions:" \
3120      "\n        -d      Delay interval for rebooting" \
3121      "\n        -n      No call to sync()" \
3122      "\n        -f      Force reboot (don't go through init)" \
3123
3124 #define renice_trivial_usage \
3125        "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID...]"
3126 #define renice_full_usage \
3127        "Change priority of running processes\n" \
3128      "\nOptions:" \
3129      "\n        -n      Adjust current nice value (smaller is faster)" \
3130      "\n        -p      Process id(s) (default)" \
3131      "\n        -g      Process group id(s)" \
3132      "\n        -u      Process user name(s) and/or id(s)" \
3133
3134 #define reset_trivial_usage \
3135        ""
3136 #define reset_full_usage \
3137        "Reset the screen"
3138
3139 #define resize_trivial_usage \
3140        ""
3141 #define resize_full_usage \
3142        "Resize the screen"
3143
3144 #define restorecon_trivial_usage \
3145        "[-iFnrRv] [-e excludedir]... [-o filename] [-f filename | pathname]"
3146 #define restorecon_full_usage \
3147        "Reset security contexts of files in pathname\n" \
3148      "\n        -i              Ignore files that do not exist" \
3149      "\n        -f file         File with list of files to process. Use - for stdin" \
3150      "\n        -e directory    Directory to exclude" \
3151      "\n        -R,-r           Recurse directories" \
3152      "\n        -n              Don't change any file labels" \
3153      "\n        -o file         Save list of files with incorrect context" \
3154      "\n        -v              Verbose" \
3155      "\n        -vv             Show changed labels" \
3156      "\n        -F              Force reset of context to match file_context" \
3157      "\n                        for customizable files, or the user section," \
3158      "\n                        if it has changed" \
3159
3160 #define rm_trivial_usage \
3161        "[OPTION]... FILE..."
3162 #define rm_full_usage \
3163        "Remove (unlink) the FILE(s). Use '--' to\n" \
3164        "indicate that all following arguments are non-options.\n" \
3165      "\nOptions:" \
3166      "\n        -i      Always prompt before removing" \
3167      "\n        -f      Never prompt" \
3168      "\n        -r,-R   Remove directories recursively" \
3169
3170 #define rm_example_usage \
3171        "$ rm -rf /tmp/foo\n"
3172
3173 #define rmdir_trivial_usage \
3174        "[OPTION]... DIRECTORY..."
3175 #define rmdir_full_usage \
3176        "Remove the DIRECTORY, if it is empty"
3177 #define rmdir_example_usage \
3178        "# rmdir /tmp/foo\n"
3179
3180 #define rmmod_trivial_usage \
3181        "[OPTION]... [MODULE]..."
3182 #define rmmod_full_usage \
3183        "Unload the specified kernel modules from the kernel\n" \
3184      "\nOptions:" \
3185      "\n        -a      Remove all unused modules (recursively)" \
3186
3187 #define rmmod_example_usage \
3188        "$ rmmod tulip\n"
3189
3190 #define route_trivial_usage \
3191        "[{add|del|delete}]"
3192 #define route_full_usage \
3193        "Edit the kernel's routing tables\n" \
3194      "\nOptions:" \
3195      "\n        -n      Don't resolve names" \
3196      "\n        -e      Display other/more information" \
3197      "\n        -A inet" USE_FEATURE_IPV6("{6}") "      Select address family" \
3198
3199 #define rpm_trivial_usage \
3200        "-i -q[ildc]p package.rpm"
3201 #define rpm_full_usage \
3202        "Manipulate RPM packages\n" \
3203      "\nOptions:" \
3204      "\n        -i      Install package" \
3205      "\n        -q      Query package" \
3206      "\n        -p      Query uninstalled package" \
3207      "\n        -i      Show information" \
3208      "\n        -l      List contents" \
3209      "\n        -d      List documents" \
3210      "\n        -c      List config files" \
3211
3212 #define rpm2cpio_trivial_usage \
3213        "package.rpm"
3214 #define rpm2cpio_full_usage \
3215        "Output a cpio archive of the rpm file"
3216
3217 #define rtcwake_trivial_usage \
3218        "[-a | -l | -u] [-d DEV] [-m MODE] [-s SECS | -t TIME]"
3219 #define rtcwake_full_usage \
3220        "Enter a system sleep state until specified wakeup time\n" \
3221         USE_GETOPT_LONG( \
3222      "\n        -a,--auto        Read clock mode from adjtime" \
3223      "\n        -l,--local       Clock is set to local time" \
3224      "\n        -u,--utc         Clock is set to UTC time" \
3225      "\n        -d,--device=DEV  Specify the RTC device" \
3226      "\n        -m,--mode=MODE   Set the sleep state (default: standby)" \
3227      "\n        -s,--seconds=SEC Set the timeout in SEC seconds from now" \
3228      "\n        -t,--time=TIME   Set the timeout to TIME seconds from epoch" \
3229         ) \
3230         SKIP_GETOPT_LONG( \
3231      "\n        -a      Read clock mode from adjtime" \
3232      "\n        -l      Clock is set to local time" \
3233      "\n        -u      Clock is set to UTC time" \
3234      "\n        -d DEV  Specify the RTC device" \
3235      "\n        -m MODE Set the sleep state (default: standby)" \
3236      "\n        -s SEC  Set the timeout in SEC seconds from now" \
3237      "\n        -t TIME Set the timeout to TIME seconds from epoch" \
3238         )
3239
3240 #define runcon_trivial_usage \
3241        "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
3242        "        runcon CONTEXT COMMAND [args]"
3243 #define runcon_full_usage \
3244        "Run a program in a different security context\n" \
3245      "\n        CONTEXT         Complete security context\n" \
3246         USE_GETOPT_LONG( \
3247      "\n        -c,--compute    Compute process transition context before modifying" \
3248      "\n        -t,--type=TYPE  Type (for same role as parent)" \
3249      "\n        -u,--user=USER  User identity" \
3250      "\n        -r,--role=ROLE  Role" \
3251      "\n        -l,--range=RNG  Levelrange" \
3252         ) \
3253         SKIP_GETOPT_LONG( \
3254      "\n        -c      Compute process transition context before modifying" \
3255      "\n        -t TYPE Type (for same role as parent)" \
3256      "\n        -u USER User identity" \
3257      "\n        -r ROLE Role" \
3258      "\n        -l RNG  Levelrange" \
3259         )
3260
3261 #define run_parts_trivial_usage \
3262        "[-t] "USE_FEATURE_RUN_PARTS_FANCY("[-l] ")"[-a ARG] [-u MASK] DIRECTORY"
3263 #define run_parts_full_usage \
3264        "Run a bunch of scripts in a directory\n" \
3265      "\nOptions:" \
3266      "\n        -t      Print what would be run, but don't actually run anything" \
3267      "\n        -a ARG  Pass ARG as argument for every program" \
3268      "\n        -u MASK Set the umask to MASK before running every program" \
3269         USE_FEATURE_RUN_PARTS_FANCY( \
3270      "\n        -l      Print names of all matching files even if they are not executable" \
3271         )
3272
3273 #define run_parts_example_usage \
3274        "$ run-parts -a start /etc/init.d\n" \
3275        "$ run-parts -a stop=now /etc/init.d\n\n" \
3276        "Let's assume you have a script foo/dosomething:\n" \
3277        "#!/bin/sh\n" \
3278        "for i in $*; do eval $i; done; unset i\n" \
3279        "case \"$1\" in\n" \
3280        "start*) echo starting something;;\n" \
3281        "stop*) set -x; shutdown -h $stop;;\n" \
3282        "esac\n\n" \
3283        "Running this yields:\n" \
3284        "$run-parts -a stop=+4m foo/\n" \
3285        "+ shutdown -h +4m"
3286
3287 #define runlevel_trivial_usage \
3288        "[utmp]"
3289 #define runlevel_full_usage \
3290        "Find the current and previous system runlevel.\n\n" \
3291        "If no utmp file exists or if no runlevel record can be found,\n" \
3292        "print \"unknown\""
3293 #define runlevel_example_usage \
3294        "$ runlevel /var/run/utmp\n" \
3295        "N 2"
3296
3297 #define runsv_trivial_usage \
3298        "dir"
3299 #define runsv_full_usage \
3300        "Start and monitor a service and optionally an appendant log service"
3301
3302 #define runsvdir_trivial_usage \
3303        "[-P] dir"
3304 #define runsvdir_full_usage \
3305        "Start a runsv process for each subdirectory"
3306
3307 #define rx_trivial_usage \
3308        "FILE"
3309 #define rx_full_usage \
3310        "Receive a file using the xmodem protocol"
3311 #define rx_example_usage \
3312        "$ rx /tmp/foo\n"
3313
3314 #define script_trivial_usage \
3315        "[-afq] [-c COMMAND] [OUTFILE]"
3316 #define script_full_usage \
3317        "Options:" \
3318      "\n        -a      Append output" \
3319      "\n        -c      Run COMMAND, not shell" \
3320      "\n        -f      Flush output after each write" \
3321      "\n        -q      Quiet" \
3322
3323 #define sed_trivial_usage \
3324        "[-efinr] pattern [files...]"
3325 #define sed_full_usage \
3326        "Options:" \
3327      "\n        -e script       Add the script to the commands to be executed" \
3328      "\n        -f scriptfile   Add scriptfile contents to the" \
3329      "\n                        commands to be executed" \
3330      "\n        -i              Edit files in-place" \
3331      "\n        -n              Suppress automatic printing of pattern space" \
3332      "\n        -r              Use extended regular expression syntax" \
3333      "\n" \
3334      "\nIf no -e or -f is given, the first non-option argument is taken as the sed" \
3335      "\nscript to interpret. All remaining arguments are names of input files; if no" \
3336      "\ninput files are specified, then the standard input is read. Source files" \
3337      "\nwill not be modified unless -i option is given." \
3338
3339 #define sed_example_usage \
3340        "$ echo \"foo\" | sed -e 's/f[a-zA-Z]o/bar/g'\n" \
3341        "bar\n"
3342
3343 #define selinuxenabled_trivial_usage
3344 #define selinuxenabled_full_usage
3345
3346 #define sendmail_trivial_usage \
3347        "[-w timeout] [-U user] [-P password] [-X]\n" \
3348        "-t to [-t to]... [-n] [-s subject] [-c charset] server[:port] from [body] [attachment ...]"
3349 #define sendmail_full_usage \
3350        "Send an email.\n" \
3351      "\nOptions:" \
3352      "\n        -w timeout      Set timeout on network operations" \
3353      "\n        -U username     Authenticate with specified username/password" \
3354      "\n        -P password" \
3355      "\n        -t address      Recipient(s). May be repeated" \
3356      "\n        -X              Use openssl connection helper for secured servers" \
3357      "\n        -n              Request delivery notification to sender" \
3358      "\n        -s subject      Subject" \
3359      "\n        -c charset      Assumed charset for body and subject [utf-8]" \
3360
3361 #define seq_trivial_usage \
3362        "[first [increment]] last"
3363 #define seq_full_usage \
3364        "Print numbers from FIRST to LAST, in steps of INCREMENT.\n" \
3365        "FIRST, INCREMENT default to 1" \
3366        "\n\nArguments:\n" \
3367        "        LAST\n" \
3368        "        FIRST LAST\n" \
3369        "        FIRST INCREMENT LAST"
3370
3371 #define sestatus_trivial_usage \
3372        "[-vb]"
3373 #define sestatus_full_usage \
3374        "        -v      Verbose" \
3375      "\n        -b      Display current state of booleans" \
3376
3377 #define setconsole_trivial_usage \
3378        "[-r" USE_FEATURE_SETCONSOLE_LONG_OPTIONS("|--reset") "] [DEVICE]"
3379 #define setconsole_full_usage \
3380        "Redirect system console output to DEVICE (default: /dev/tty)\n" \
3381      "\nOptions:" \
3382      "\n        -r      Reset output to /dev/console" \
3383
3384 #define setenforce_trivial_usage \
3385        "[Enforcing | Permissive | 1 | 0]"
3386 #define setenforce_full_usage
3387
3388 #define setfiles_trivial_usage \
3389        "[-dnpqsvW] [-e dir]... [-o file] [-r alt_root_path]" \
3390         USE_FEATURE_SETFILES_CHECK_OPTION( \
3391        " [-c policyfile] spec_file" \
3392         ) \
3393        " pathname"
3394 #define setfiles_full_usage \
3395        "Reset file contexts under pathname according to spec_file\n" \
3396         USE_FEATURE_SETFILES_CHECK_OPTION( \
3397      "\n        -c file Check the validity of the contexts against the specified binary policy" \
3398         ) \
3399      "\n        -d      Show which specification matched each file" \
3400      "\n        -l      Log changes in file labels to syslog" \
3401      "\n        -n      Don't change any file labels" \
3402      "\n        -q      Suppress warnings" \
3403      "\n        -r dir  Use an altenate root path" \
3404      "\n        -e dir  Exclude directory" \
3405      "\n        -F      Force reset of context to match file_context for customizable files" \
3406      "\n        -o file Save list of files with incorrect context" \
3407      "\n        -s      Take a list of files from standard input (instead of command line)" \
3408      "\n        -v      Show changes in file labels, if type or role are changing" \
3409      "\n        -vv     Show changes in file labels, if type, role, or user are changing" \
3410      "\n        -W      Display warnings about entries that had no matching files" \
3411
3412 #define setkeycodes_trivial_usage \
3413        "SCANCODE KEYCODE..."
3414 #define setkeycodes_full_usage \
3415        "Set entries into the kernel's scancode-to-keycode map,\n" \
3416        "allowing unusual keyboards to generate usable keycodes.\n\n" \
3417        "SCANCODE may be either xx or e0xx (hexadecimal),\n" \
3418        "and KEYCODE is given in decimal" \
3419
3420 #define setkeycodes_example_usage \
3421        "$ setkeycodes e030 127\n"
3422
3423 #define setlogcons_trivial_usage \
3424        "N"
3425 #define setlogcons_full_usage \
3426        "Redirect the kernel output to console N (0 for current)"
3427
3428 #define setsebool_trivial_usage \
3429        "boolean value"
3430
3431 #define setsebool_full_usage \
3432        "Change boolean setting"
3433
3434 #define setsid_trivial_usage \
3435        "PROG [ARG...]"
3436 #define setsid_full_usage \
3437        "Run PROG in a new session. PROG will have no controlling terminal\n" \
3438        "and will not be affected by keyboard signals (Ctrl-C etc).\n" \
3439        "See setsid(2) for details." \
3440
3441 #define lash_trivial_usage \
3442        "[FILE]...\n" \
3443        "or: sh -c command [args]..."
3444 #define lash_full_usage \
3445        "lash is deprecated, please use hush"
3446
3447 #define last_trivial_usage \
3448        ""
3449 #define last_full_usage \
3450        "Show listing of the last users that logged into the system"
3451
3452 #define sha1sum_trivial_usage \
3453        "[OPTION] [FILEs...]" \
3454         USE_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum [OPTION] -c [FILE]")
3455 #define sha1sum_full_usage \
3456        "Print" USE_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums." \
3457         USE_FEATURE_MD5_SHA1_SUM_CHECK( "\n" \
3458      "\nOptions:" \
3459      "\n        -c      Check SHA1 sums against given list" \
3460      "\n        -s      Don't output anything, status code shows success" \
3461      "\n        -w      Warn about improperly formatted SHA1 checksum lines" \
3462         )
3463
3464 #define slattach_trivial_usage \
3465        "[-cehmLF] [-s speed] [-p protocol] DEVICEs"
3466 #define slattach_full_usage \
3467        "Attach network interface(s) to serial line(s)\n" \
3468      "\nOptions:" \
3469      "\n        -p      Set protocol (slip, cslip, slip6, clisp6 or adaptive)" \
3470      "\n        -s      Set line speed" \
3471      "\n        -e      Exit after initializing device" \
3472      "\n        -h      Exit when the carrier is lost" \
3473      "\n        -c      Execute a command when the line is hung up" \
3474      "\n        -m      Do NOT initialize the line in raw 8 bits mode" \
3475      "\n        -L      Enable 3-wire operation" \
3476      "\n        -F      Disable RTS/CTS flow control" \
3477
3478 #define sleep_trivial_usage \
3479         USE_FEATURE_FANCY_SLEEP("[") "N" USE_FEATURE_FANCY_SLEEP("]...")
3480 #define sleep_full_usage \
3481         SKIP_FEATURE_FANCY_SLEEP("Pause for N seconds") \
3482         USE_FEATURE_FANCY_SLEEP( \
3483        "Pause for a time equal to the total of the args given, where each arg can\n" \
3484        "have an optional suffix of (s)econds, (m)inutes, (h)ours, or (d)ays")
3485 #define sleep_example_usage \
3486        "$ sleep 2\n" \
3487        "[2 second delay results]\n" \
3488         USE_FEATURE_FANCY_SLEEP( \
3489        "$ sleep 1d 3h 22m 8s\n" \
3490        "[98528 second delay results]\n")
3491
3492 #define sort_trivial_usage \
3493        "[-nru" \
3494         USE_FEATURE_SORT_BIG("gMcszbdfimSTokt] [-o FILE] [-k start[.offset][opts][,end[.offset][opts]] [-t CHAR") \
3495        "] [FILE]..."
3496 #define sort_full_usage \
3497        "Sort lines of text\n" \
3498      "\nOptions:" \
3499         USE_FEATURE_SORT_BIG( \
3500      "\n        -b      Ignore leading blanks" \
3501      "\n        -c      Check whether input is sorted" \
3502      "\n        -d      Dictionary order (blank or alphanumeric only)" \
3503      "\n        -f      Ignore case" \
3504      "\n        -g      General numerical sort" \
3505      "\n        -i      Ignore unprintable characters" \
3506      "\n        -k      Sort key" \
3507      "\n        -M      Sort month" \
3508         ) \
3509      "\n        -n      Sort numbers" \
3510         USE_FEATURE_SORT_BIG( \
3511      "\n        -o      Output to file" \
3512      "\n        -k      Sort by key" \
3513      "\n        -t CHAR Key separator" \
3514         ) \
3515      "\n        -r      Reverse sort order" \
3516         USE_FEATURE_SORT_BIG( \
3517      "\n        -s      Stable (don't sort ties alphabetically)" \
3518         ) \
3519      "\n        -u      Suppress duplicate lines" \
3520         USE_FEATURE_SORT_BIG( \
3521      "\n        -z      Lines are terminated by NUL, not newline" \
3522      "\n        -mST    Ignored for GNU compatibility") \
3523
3524 #define sort_example_usage \
3525        "$ echo -e \"e\\nf\\nb\\nd\\nc\\na\" | sort\n" \
3526        "a\n" \
3527        "b\n" \
3528        "c\n" \
3529        "d\n" \
3530        "e\n" \
3531        "f\n" \
3532         USE_FEATURE_SORT_BIG( \
3533                 "$ echo -e \"c 3\\nb 2\\nd 2\" | $SORT -k 2,2n -k 1,1r\n" \
3534                 "d 2\n" \
3535                 "b 2\n" \
3536                 "c 3\n" \
3537         ) \
3538        ""
3539
3540 #define split_trivial_usage \
3541        "[OPTION] [INPUT [PREFIX]]"
3542 #define split_full_usage \
3543        "Options:" \
3544      "\n        -b n[k|m]       Split by bytes" \
3545      "\n        -l n            Split by lines" \
3546      "\n        -a n            Use n letters as suffix" \
3547
3548 #define split_example_usage \
3549        "$ split TODO foo\n" \
3550        "$ cat TODO | split -a 2 -l 2 TODO_\n"
3551
3552 #define start_stop_daemon_trivial_usage \
3553        "[OPTIONS] [" \
3554         USE_GETOPT_LONG("--start|--stop") SKIP_GETOPT_LONG("-S|-K") \
3555        "] ... [-- arguments...]"
3556 #define start_stop_daemon_full_usage \
3557        "Start and stop services\n" \
3558      "\nOptions:" \
3559         USE_GETOPT_LONG( \
3560      "\n        -S,--start              Start" \
3561      "\n        -K,--stop               Stop" \
3562      "\n        -a,--startas pathname   Start process specified by pathname" \
3563      "\n        -b,--background         Put process into background" \
3564      "\n        -u,--user username|uid  Stop this user's processes" \
3565      "\n        -x,--exec executable    Program to either start or check" \
3566      "\n        -n,--name process-name  Stop processes with this name" \
3567      "\n        -p,--pidfile pid-file   Save or load pid using a pid-file" \
3568      "\n        -m,--make-pidfile       Create the -p file and enter pid in it" \
3569      "\n        -q,--quiet              Quiet" \
3570         USE_FEATURE_START_STOP_DAEMON_FANCY( \
3571      "\n        -o,--oknodo             Exit status 0 if nothing done" \
3572      "\n        -v,--verbose            Verbose" \
3573      "\n        -N,--nicelevel N        Add N to process's nice level" \
3574         ) \
3575      "\n        -s,--signal signal      Signal to send (default TERM)" \
3576      "\n        -c,--chuid user[:[grp]] Change to specified user/group" \
3577         ) \
3578         SKIP_GETOPT_LONG( \
3579      "\n        -S              Start" \
3580      "\n        -K              Stop" \
3581      "\n        -a pathname     Start process specified by pathname" \
3582      "\n        -b              Put process into background" \
3583      "\n        -u username|uid Stop this user's processes" \
3584      "\n        -x executable   Program to either start or check" \
3585      "\n        -n process-name Stop processes with this name" \
3586      "\n        -p pid-file     Save or load pid using a pid-file" \
3587      "\n        -m              Create the -p file and enter pid in it" \
3588      "\n        -q              Quiet" \
3589         USE_FEATURE_START_STOP_DAEMON_FANCY( \
3590      "\n        -o              Exit status 0 if nothing done" \
3591      "\n        -v              Verbose" \
3592      "\n        -N N            Add N to process's nice level" \
3593         ) \
3594      "\n        -s signal       Signal to send (default TERM)" \
3595      "\n        -c user[:[grp]] Change to specified user/group" \
3596         )
3597
3598 #define stat_trivial_usage \
3599        "[OPTION] FILE..."
3600 #define stat_full_usage \
3601        "Display file (default) or filesystem status\n" \
3602      "\nOptions:" \
3603         USE_FEATURE_STAT_FORMAT( \
3604      "\n        -c fmt  Use the specified format" \
3605         ) \
3606      "\n        -f      Display filesystem status" \
3607      "\n        -L      Dereference links" \
3608      "\n        -t      Display info in terse form" \
3609         USE_SELINUX( \
3610      "\n        -Z      Print security context" \
3611         ) \
3612         USE_FEATURE_STAT_FORMAT( \
3613        "\n\nValid format sequences for files:\n" \
3614        " %a     Access rights in octal\n" \
3615        " %A     Access rights in human readable form\n" \
3616        " %b     Number of blocks allocated (see %B)\n" \
3617        " %B     The size in bytes of each block reported by %b\n" \
3618        " %d     Device number in decimal\n" \
3619        " %D     Device number in hex\n" \
3620        " %f     Raw mode in hex\n" \
3621        " %F     File type\n" \
3622        " %g     Group ID of owner\n" \
3623        " %G     Group name of owner\n" \
3624        " %h     Number of hard links\n" \
3625        " %i     Inode number\n" \
3626        " %n     File name\n" \
3627        " %N     Quoted file name with dereference if symlink\n" \
3628        " %o     I/O block size\n" \
3629        " %s     Total size, in bytes\n" \
3630        " %t     Major device type in hex\n" \
3631        " %T     Minor device type in hex\n" \
3632        " %u     User ID of owner\n" \
3633        " %U     User name of owner\n" \
3634        " %x     Time of last access\n" \
3635        " %X     Time of last access as seconds since Epoch\n" \
3636        " %y     Time of last modification\n" \
3637        " %Y     Time of last modification as seconds since Epoch\n" \
3638        " %z     Time of last change\n" \
3639        " %Z     Time of last change as seconds since Epoch\n" \
3640        "\nValid format sequences for file systems:\n" \
3641        " %a     Free blocks available to non-superuser\n" \
3642        " %b     Total data blocks in file system\n" \
3643        " %c     Total file nodes in file system\n" \
3644        " %d     Free file nodes in file system\n" \
3645        " %f     Free blocks in file system\n" \
3646         USE_SELINUX( \
3647        " %C     Security context in SELinux\n" \
3648         ) \
3649        " %i     File System ID in hex\n" \
3650        " %l     Maximum length of filenames\n" \
3651        " %n     File name\n" \
3652        " %s     Block size (for faster transfer)\n" \
3653        " %S     Fundamental block size (for block counts)\n" \
3654        " %t     Type in hex\n" \
3655        " %T     Type in human readable form" \
3656         )
3657
3658 #define strings_trivial_usage \
3659        "[-afo] [-n length] [file...]"
3660 #define strings_full_usage \
3661        "Display printable strings in a binary file\n" \
3662      "\nOptions:" \
3663      "\n        -a      Scan whole file (default)" \
3664      "\n        -f      Precede strings with filenames" \
3665      "\n        -n N    At least N characters form a string (default 4)" \
3666      "\n        -o      Precede strings with decimal offsets" \
3667
3668 #define stty_trivial_usage \
3669        "[-a|g] [-F DEVICE] [SETTING]..."
3670 #define stty_full_usage \
3671        "Without arguments, prints baud rate, line discipline,\n" \
3672        "and deviations from stty sane\n" \
3673      "\nOptions:" \
3674      "\n        -F DEVICE       Open device instead of stdin" \
3675      "\n        -a              Print all current settings in human-readable form" \
3676      "\n        -g              Print in stty-readable form" \
3677      "\n        [SETTING]       See manpage" \
3678
3679 #define su_trivial_usage \
3680        "[OPTION]... [-] [username]"
3681 #define su_full_usage \
3682        "Change user id or become root\n" \
3683      "\nOptions:" \
3684      "\n        -p, -m  Preserve environment" \
3685      "\n        -c      Command to pass to 'sh -c'" \
3686      "\n        -s      Shell to use instead of default shell" \
3687
3688 #define sulogin_trivial_usage \
3689        "[OPTION]... [tty-device]"
3690 #define sulogin_full_usage \
3691        "Single user login\n" \
3692      "\nOptions:" \
3693      "\n        -t      Timeout" \
3694
3695 #define sum_trivial_usage \
3696        "[rs] [files...]"
3697 #define sum_full_usage \
3698        "Checksum and count the blocks in a file\n" \
3699      "\nOptions:" \
3700      "\n        -r      Use BSD sum algorithm (1K blocks)" \
3701      "\n        -s      Use System V sum algorithm (512byte blocks)" \
3702
3703 #define sv_trivial_usage \
3704        "[-v] [-w sec] command service..."
3705 #define sv_full_usage \
3706        "Control services monitored by runsv supervisor.\n" \
3707        "Commands (only first character is enough):\n" \
3708        "\n" \
3709        "status: query service status\n" \
3710        "up: if service isn't running, start it. If service stops, restart it\n" \
3711        "once: like 'up', but if service stops, don't restart it\n" \
3712        "down: send TERM and CONT signals. If ./run exits, start ./finish\n" \
3713        "    if it exists. After it stops, do not restart service\n" \
3714        "exit: send TERM and CONT signals to service and log service. If they exit,\n" \
3715        "    runsv exits too\n" \
3716        "pause, cont, hup, alarm, interrupt, quit, 1, 2, term, kill: send\n" \
3717        "STOP, CONT, HUP, ALRM, INT, QUIT, USR1, USR2, TERM, KILL signal to service" \
3718
3719 #define svlogd_trivial_usage \
3720        "[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
3721 #define svlogd_full_usage \
3722        "Continuously read log data from standard input, optionally " \
3723        "filter log messages, and write the data to one or more automatically " \
3724        "rotated logs" \
3725
3726 #define swapoff_trivial_usage \
3727        "[-a] [DEVICE]"
3728 #define swapoff_full_usage \
3729        "Stop swapping on DEVICE\n" \
3730      "\nOptions:" \
3731      "\n        -a      Stop swapping on all swap devices" \
3732
3733 #define swapon_trivial_usage \
3734        "[-a] [DEVICE]"
3735 #define swapon_full_usage \
3736        "Start swapping on DEVICE\n" \
3737      "\nOptions:" \
3738      "\n        -a      Start swapping on all swap devices" \
3739
3740 #define switch_root_trivial_usage \
3741        "[-c /dev/console] NEW_ROOT NEW_INIT [ARGUMENTS_TO_INIT]"
3742 #define switch_root_full_usage \
3743        "Use from PID 1 under initramfs to free initramfs, chroot to NEW_ROOT,\n" \
3744        "and exec NEW_INIT\n" \
3745      "\nOptions:" \
3746      "\n        -c      Redirect console to device on new root" \
3747
3748 #define sync_trivial_usage \
3749        ""
3750 #define sync_full_usage \
3751        "Write all buffered filesystem blocks to disk"
3752
3753 #define sysctl_trivial_usage \
3754        "[OPTIONS]... [VALUE]..."
3755 #define sysctl_full_usage \
3756        "Configure kernel parameters at runtime\n" \
3757      "\nOptions:" \
3758      "\n        -n      Disable printing of key names" \
3759      "\n        -e      Don't warn about unknown keys" \
3760      "\n        -w      Change sysctl setting" \
3761      "\n        -p FILE Load sysctl settings from FILE (default /etc/sysctl.conf)" \
3762      "\n        -a      Display all values" \
3763      "\n        -A      Display all values in table form" \
3764
3765 #define sysctl_example_usage \
3766        "sysctl [-n] [-e] variable...\n" \
3767        "sysctl [-n] [-e] -w variable=value...\n" \
3768        "sysctl [-n] [-e] -a\n" \
3769        "sysctl [-n] [-e] -p file        (default /etc/sysctl.conf)\n" \
3770        "sysctl [-n] [-e] -A\n"
3771
3772 #define syslogd_trivial_usage \
3773        "[OPTION]..."
3774 #define syslogd_full_usage \
3775        "System logging utility.\n" \
3776        "Note that this version of syslogd ignores /etc/syslog.conf.\n" \
3777      "\nOptions:" \
3778      "\n        -n              Run in foreground" \
3779      "\n        -O FILE         Log to given file (default=/var/log/messages)" \
3780      "\n        -l n            Set local log level" \
3781      "\n        -S              Smaller logging output" \
3782         USE_FEATURE_ROTATE_LOGFILE( \
3783      "\n        -s SIZE         Max size (KB) before rotate (default=200KB, 0=off)" \
3784      "\n        -b NUM          Number of rotated logs to keep (default=1, max=99, 0=purge)") \
3785         USE_FEATURE_REMOTE_LOG( \
3786      "\n        -R HOST[:PORT]  Log to IP or hostname on PORT (default PORT=514/UDP)" \
3787      "\n        -L              Log locally and via network (default is network only if -R)") \
3788         USE_FEATURE_SYSLOGD_DUP( \
3789      "\n        -D              Drop duplicates") \
3790         USE_FEATURE_IPC_SYSLOG( \
3791      "\n        -C[size(KiB)]   Log to shared mem buffer (read it using logread)") \
3792         /* NB: -Csize shouldn't have space (because size is optional) */
3793 /*   "\n        -m MIN          Minutes between MARK lines (default=20, 0=off)" */
3794
3795 #define syslogd_example_usage \
3796        "$ syslogd -R masterlog:514\n" \
3797        "$ syslogd -R 192.168.1.1:601\n"
3798
3799 #define tac_trivial_usage \
3800         "[FILE]..."
3801 #define tac_full_usage \
3802         "Concatenate FILE(s) and print them in reverse"
3803
3804 #define tail_trivial_usage \
3805        "[OPTION]... [FILE]..."
3806 #define tail_full_usage \
3807        "Print last 10 lines of each FILE to standard output.\n" \
3808        "With more than one FILE, precede each with a header giving the\n" \
3809        "file name. With no FILE, or when FILE is -, read standard input.\n" \
3810      "\nOptions:" \
3811         USE_FEATURE_FANCY_TAIL( \
3812      "\n        -c N[kbm]       Output the last N bytes") \
3813      "\n        -n N[kbm]       Print last N lines instead of last 10" \
3814      "\n        -f              Output data as the file grows" \
3815         USE_FEATURE_FANCY_TAIL( \
3816      "\n        -q              Never output headers giving file names" \
3817      "\n        -s SEC          Wait SEC seconds between reads with -f" \
3818      "\n        -v              Always output headers giving file names" \
3819      "\n\n" \
3820        "If the first character of N (bytes or lines) is a '+', output begins with\n" \
3821        "the Nth item from the start of each file, otherwise, print the last N items\n" \
3822        "in the file. N bytes may be suffixed by k (x1024), b (x512), or m (1024^2)." ) \
3823
3824 #define tail_example_usage \
3825        "$ tail -n 1 /etc/resolv.conf\n" \
3826        "nameserver 10.0.0.1\n"
3827
3828 #define tar_trivial_usage \
3829        "-[" USE_FEATURE_TAR_CREATE("c") USE_FEATURE_TAR_GZIP("z") \
3830         USE_FEATURE_TAR_BZIP2("j") USE_FEATURE_TAR_LZMA("a") \
3831         USE_FEATURE_TAR_COMPRESS("Z") "xtvO] " \
3832         USE_FEATURE_TAR_FROM("[-X FILE] ") \
3833        "[-f TARFILE] [-C DIR] [FILE(s)]..."
3834 #define tar_full_usage \
3835        "Create, extract, or list files from a tar file\n" \
3836      "\nOptions:" \
3837         USE_FEATURE_TAR_CREATE( \
3838      "\n        c       Create") \
3839      "\n        x       Extract" \
3840      "\n        t       List" \
3841      "\nArchive format selection:" \
3842         USE_FEATURE_TAR_GZIP( \
3843      "\n        z       Filter the archive through gzip" \
3844         ) \
3845         USE_FEATURE_TAR_BZIP2( \
3846      "\n        j       Filter the archive through bzip2" \
3847         ) \
3848         USE_FEATURE_TAR_LZMA( \
3849      "\n        a       Filter the archive through lzma" \
3850         ) \
3851         USE_FEATURE_TAR_COMPRESS( \
3852      "\n        Z       Filter the archive through compress" \
3853         ) \
3854      "\nFile selection:" \
3855      "\n        f       Name of TARFILE or \"-\" for stdin" \
3856      "\n        O       Extract to stdout" \
3857         USE_FEATURE_TAR_FROM( \
3858      "\n        exclude File to exclude" \
3859      "\n        X       File with names to exclude" \
3860         ) \
3861      "\n        C       Change to directory DIR before operation" \
3862      "\n        v       Verbose" \
3863
3864 #define tar_example_usage \
3865        "$ zcat /tmp/tarball.tar.gz | tar -xf -\n" \
3866        "$ tar -cf /tmp/tarball.tar /usr/local\n"
3867
3868 #define taskset_trivial_usage \
3869        "[-p] [mask] [pid | command [arg]...]"
3870 #define taskset_full_usage \
3871        "Set or get CPU affinity\n" \
3872      "\nOptions:" \
3873      "\n        -p      Operate on an existing PID" \
3874
3875 #define taskset_example_usage \
3876        "$ taskset 0x7 ./dgemm_test&\n" \
3877        "$ taskset -p 0x1 $!\n" \
3878        "pid 4790's current affinity mask: 7\n" \
3879        "pid 4790's new affinity mask: 1\n" \
3880        "$ taskset 0x7 /bin/sh -c './taskset -p 0x1 $$'\n" \
3881        "pid 6671's current affinity mask: 1\n" \
3882        "pid 6671's new affinity mask: 1\n" \
3883        "$ taskset -p 1\n" \
3884        "pid 1's current affinity mask: 3\n"
3885
3886 #define tee_trivial_usage \
3887        "[OPTION]... [FILE]..."
3888 #define tee_full_usage \
3889        "Copy standard input to each FILE, and also to standard output\n" \
3890      "\nOptions:" \
3891      "\n        -a      Append to the given FILEs, do not overwrite" \
3892      "\n        -i      Ignore interrupt signals (SIGINT)" \
3893
3894 #define tee_example_usage \
3895        "$ echo \"Hello\" | tee /tmp/foo\n" \
3896        "$ cat /tmp/foo\n" \
3897        "Hello\n"
3898
3899 #if ENABLE_FEATURE_TELNET_AUTOLOGIN
3900 #define telnet_trivial_usage \
3901        "[-a] [-l USER] HOST [PORT]"
3902 #define telnet_full_usage \
3903        "Connect to telnet server\n" \
3904      "\nOptions:" \
3905      "\n        -a      Attempt an automatic login with USER variable" \
3906      "\n        -l USER Attempt an automatic login with USER argument" \
3907
3908 #else
3909 #define telnet_trivial_usage \
3910        "HOST [PORT]"
3911 #define telnet_full_usage \
3912        "Connect to telnet server"
3913 #endif
3914
3915 #define telnetd_trivial_usage \
3916        "[OPTION]"
3917 #define telnetd_full_usage \
3918        "Handle incoming telnet connections" \
3919         SKIP_FEATURE_TELNETD_STANDALONE(" via inetd") "\n" \
3920      "\nOptions:" \
3921      "\n        -l LOGIN        Exec LOGIN on connect" \
3922      "\n        -f issue_file   Display issue_file instead of /etc/issue" \
3923      "\n        -K              Close connection as soon as login exits" \
3924      "\n                        (normally wait until all programs close slave pty)" \
3925         USE_FEATURE_TELNETD_STANDALONE( \
3926      "\n        -p PORT         Port to listen on" \
3927      "\n        -b ADDR         Address to bind to" \
3928      "\n        -F              Run in foreground" \
3929      "\n        -i              Run as inetd subservice" \
3930         )
3931
3932 #define test_trivial_usage \
3933        "EXPRESSION\n" \
3934        "  or   [ EXPRESSION ]"
3935 #define test_full_usage \
3936        "Check file types and compares values returning an exit code\n" \
3937        "determined by the value of EXPRESSION"
3938 #define test_example_usage \
3939        "$ test 1 -eq 2\n" \
3940        "$ echo $?\n" \
3941        "1\n" \
3942        "$ test 1 -eq 1\n" \
3943        "$ echo $?\n" \
3944        "0\n" \
3945        "$ [ -d /etc ]\n" \
3946        "$ echo $?\n" \
3947        "0\n" \
3948        "$ [ -d /junk ]\n" \
3949        "$ echo $?\n" \
3950        "1\n"
3951
3952 #define tcpsvd_trivial_usage \
3953        "[-hEv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] ip port prog..."
3954 /* with not-implemented options: */
3955 /*     "[-hpEvv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] [-i dir|-x cdb] [-t sec] ip port prog..." */
3956 #define tcpsvd_full_usage \
3957        "Create TCP socket, bind it to ip:port and listen\n" \
3958        "for incoming connection. Run PROG for each connection.\n" \
3959      "\nip              IP to listen on. '0' = all" \
3960      "\nport            Port to listen on" \
3961      "\nprog [arg]      Program to run" \
3962      "\n-l name         Local hostname (else looks up local hostname in DNS)" \
3963      "\n-u user[:group] Change to user/group after bind" \
3964      "\n-c n            Handle up to n connections simultaneously" \
3965      "\n-b n            Allow a backlog of approximately n TCP SYNs" \
3966      "\n-C n[:msg]      Allow only up to n connections from the same IP" \
3967      "\n                New connections from this IP address are closed" \
3968      "\n                immediately. 'msg' is written to the peer before close" \
3969      "\n-h              Look up peer's hostname" \
3970      "\n-E              Do not set up environment variables" \
3971      "\n-v              Verbose" \
3972
3973 #define udpsvd_trivial_usage \
3974        "[-hEv] [-c n] [-u user] [-l name] ip port prog"
3975 #define udpsvd_full_usage \
3976        "Create UDP socket, bind it to ip:port and wait\n" \
3977        "for incoming packets. Run PROG for each packet,\n" \
3978        "redirecting all further packets with same peer ip:port to it\n" \
3979      "\nip              IP to listen on. '0' = all" \
3980      "\nport            Port to listen on" \
3981      "\nprog [arg]      Program to run" \
3982      "\n-l name         Local hostname (else looks up local hostname in DNS)" \
3983      "\n-u user[:group] Change to user/group after bind" \
3984      "\n-c n            Handle up to n connections simultaneously" \
3985      "\n-h              Look up peer's hostname" \
3986      "\n-E              Do not set up environment variables" \
3987      "\n-v              Verbose" \
3988
3989 #define tftp_trivial_usage \
3990        "[OPTION]... HOST [PORT]"
3991 #define tftp_full_usage \
3992        "Transfer a file from/to tftp server\n" \
3993      "\nOptions:" \
3994      "\n        -l FILE Local FILE" \
3995      "\n        -r FILE Remote FILE" \
3996         USE_FEATURE_TFTP_GET( \
3997      "\n        -g      Get file" \
3998         ) \
3999         USE_FEATURE_TFTP_PUT( \
4000      "\n        -p      Put file" \
4001         ) \
4002         USE_FEATURE_TFTP_BLOCKSIZE( \
4003      "\n        -b SIZE Transfer blocks of SIZE octets" \
4004         )
4005
4006 #define tftpd_trivial_usage \
4007        "[-cr] [-u USER] [DIR]"
4008 #define tftpd_full_usage \
4009        "Transfer a file on tftp client's request.\n" \
4010      "\nOptions:" \
4011      "\n        -r      Prohibit upload" \
4012      "\n        -c      Allow file creation via upload" \
4013      "\n        -u      Access files as USER" \
4014
4015 #define time_trivial_usage \
4016        "[OPTION]... COMMAND [ARGS...]"
4017 #define time_full_usage \
4018        "Run the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \
4019        "COMMAND's resource usage information is displayed.\n" \
4020      "\nOptions:" \
4021      "\n        -v      Verbose" \
4022
4023 #define top_trivial_usage \
4024        "[-b] [-n COUNT] [-d SECONDS]"
4025 #define top_full_usage \
4026        "Provide a view of process activity in real time.\n" \
4027        "Read the status of all processes from /proc each SECONDS\n" \
4028        "and show the status for however many processes will fit on the screen." \
4029
4030 #define touch_trivial_usage \
4031        "[-c] FILE [FILE...]"
4032 #define touch_full_usage \
4033        "Update the last-modified date on the given FILE[s]\n" \
4034      "\nOptions:" \
4035      "\n        -c      Do not create any files" \
4036
4037 #define touch_example_usage \
4038        "$ ls -l /tmp/foo\n" \
4039        "/bin/ls: /tmp/foo: No such file or directory\n" \
4040        "$ touch /tmp/foo\n" \
4041        "$ ls -l /tmp/foo\n" \
4042        "-rw-rw-r--    1 andersen andersen        0 Apr 15 01:11 /tmp/foo\n"
4043
4044 #define tr_trivial_usage \
4045        "[-cds] STRING1 [STRING2]"
4046 #define tr_full_usage \
4047        "Translate, squeeze, and/or delete characters from\n" \
4048        "standard input, writing to standard output\n" \
4049      "\nOptions:" \
4050      "\n        -c      Take complement of STRING1" \
4051      "\n        -d      Delete input characters coded STRING1" \
4052      "\n        -s      Squeeze multiple output characters of STRING2 into one character" \
4053
4054 #define tr_example_usage \
4055        "$ echo \"gdkkn vnqkc\" | tr [a-y] [b-z]\n" \
4056        "hello world\n"
4057
4058 #define traceroute_trivial_usage \
4059        "[-FIldnrv] [-f 1st_ttl] [-m max_ttl] [-p port#] [-q nqueries]\n" \
4060        "        [-s src_addr] [-t tos] [-w wait] [-g gateway] [-i iface]\n" \
4061        "        [-z pausemsecs] HOST [data size]"
4062 #define traceroute_full_usage \
4063        "Trace the route to HOST\n" \
4064      "\nOptions:" \
4065      "\n        -F      Set the don't fragment bit" \
4066      "\n        -I      Use ICMP ECHO instead of UDP datagrams" \
4067      "\n        -l      Display the ttl value of the returned packet" \
4068      "\n        -d      Set SO_DEBUG options to socket" \
4069      "\n        -n      Print hop addresses numerically rather than symbolically" \
4070      "\n        -r      Bypass the normal routing tables and send directly to a host" \
4071      "\n        -v      Verbose" \
4072      "\n        -m max_ttl      Max time-to-live (max number of hops)" \
4073      "\n        -p port#        Base UDP port number used in probes" \
4074      "\n                        (default is 33434)" \
4075      "\n        -q nqueries     Number of probes per 'ttl' (default 3)" \
4076      "\n        -s src_addr     IP address to use as the source address" \
4077      "\n        -t tos          Type-of-service in probe packets (default 0)" \
4078      "\n        -w wait         Time in seconds to wait for a response" \
4079      "\n                        (default 3 sec)" \
4080      "\n        -g              Loose source route gateway (8 max)" \
4081
4082 #define true_trivial_usage \
4083        ""
4084 #define true_full_usage \
4085        "Return an exit code of TRUE (0)"
4086 #define true_example_usage \
4087        "$ true\n" \
4088        "$ echo $?\n" \
4089        "0\n"
4090
4091 #define tty_trivial_usage \
4092        ""
4093 #define tty_full_usage \
4094        "Print file name of standard input's terminal" \
4095         USE_INCLUDE_SUSv2( "\n" \
4096      "\nOptions:" \
4097      "\n        -s      Print nothing, only return exit status" \
4098         )
4099 #define tty_example_usage \
4100        "$ tty\n" \
4101        "/dev/tty2\n"
4102
4103 #define ttysize_trivial_usage \
4104        "[w] [h]"
4105 #define ttysize_full_usage \
4106        "Print dimension(s) of standard input's terminal, on error return 80x25"
4107
4108 #define tune2fs_trivial_usage \
4109        "[-c max-mounts-count] [-e errors-behavior] [-g group] " \
4110        "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " \
4111        "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " \
4112        "[-r reserved-blocks-count] [-u user] [-C mount-count] " \
4113        "[-L volume-label] [-M last-mounted-dir] [-O [^]feature[,...]] " \
4114        "[-T last-check-time] [-U UUID] device"
4115 #define tune2fs_full_usage \
4116        "Adjust filesystem options on ext[23] filesystems"
4117
4118 #define udhcpc_trivial_usage \
4119        "[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n" \
4120        "        [-p pidfile] [-r IP] [-s script] [-O dhcp-option]..." USE_FEATURE_UDHCP_PORT(" [-P N]")
4121 #define udhcpc_full_usage \
4122         USE_GETOPT_LONG( \
4123        "        -V,--vendorclass=CLASSID        Vendor class identifier" \
4124      "\n        -i,--interface=INTERFACE        Interface to use (default eth0)" \
4125      "\n        -H,-h,--hostname=HOSTNAME       Client hostname" \
4126      "\n        -c,--clientid=CLIENTID  Client identifier" \
4127      "\n        -C,--clientid-none      Suppress default client identifier" \
4128      "\n        -p,--pidfile=file       Create pidfile" \
4129      "\n        -r,--request=IP         IP address to request" \
4130      "\n        -s,--script=file        Run file at dhcp events (default /usr/share/udhcpc/default.script)" \
4131      "\n        -t,--retries=N          Send up to N request packets" \
4132      "\n        -T,--timeout=N          Try to get a lease for N seconds (default 3)" \
4133      "\n        -A,--tryagain=N         Wait N seconds (default 20) after failure" \
4134      "\n        -f,--foreground Run in foreground" \
4135      "\n        -b,--background Background if lease is not immediately obtained" \
4136      "\n        -S,--syslog     Log to syslog too" \
4137      "\n        -n,--now        Exit with failure if lease is not immediately obtained" \
4138      "\n        -q,--quit       Quit after obtaining lease" \
4139      "\n        -R,--release    Release IP on quit" \
4140      "\n        -O,--request-option=OPT Request DHCP option OPT from server" \
4141         USE_FEATURE_UDHCP_PORT( \
4142      "\n        -P,--client-port N  Use port N instead of default 68" \
4143         ) \
4144         USE_FEATURE_UDHCPC_ARPING( \
4145      "\n        -a,--arping     Use arping to validate offered address" \
4146         ) \
4147         ) \
4148         SKIP_GETOPT_LONG( \
4149        "        -V CLASSID      Vendor class identifier" \
4150      "\n        -i INTERFACE    Interface to use (default: eth0)" \
4151      "\n        -H,-h HOSTNAME  Client hostname" \
4152      "\n        -c CLIENTID     Client identifier" \
4153      "\n        -C              Suppress default client identifier" \
4154      "\n        -p file         Create pidfile" \
4155      "\n        -r IP           IP address to request" \
4156      "\n        -s file         Run file at dhcp events (default /usr/share/udhcpc/default.script)" \
4157      "\n        -t N            Send up to N request packets" \
4158      "\n        -T N            Try to get a lease for N seconds (default 3)" \
4159      "\n        -A N            Wait N seconds (default 20) after failure" \
4160      "\n        -f              Run in foreground" \
4161      "\n        -b              Background if lease is not immediately obtained" \
4162      "\n        -S              Log to syslog too" \
4163      "\n        -n              Exit with failure if lease is not immediately obtained" \
4164      "\n        -q              Quit after obtaining lease" \
4165      "\n        -R              Release IP on quit" \
4166      "\n        -O OPT          Request DHCP option OPT from server" \
4167         USE_FEATURE_UDHCP_PORT( \
4168      "\n        -P N            Use port N instead of default 68" \
4169         ) \
4170         USE_FEATURE_UDHCPC_ARPING( \
4171      "\n        -a              Use arping to validate offered address" \
4172         ) \
4173         )
4174
4175 #define udhcpd_trivial_usage \
4176        "[-fS]" USE_FEATURE_UDHCP_PORT(" [-P N]") " [configfile]" \
4177
4178 #define udhcpd_full_usage \
4179        "DHCP server\n" \
4180      "\n        -f      Run in foreground" \
4181      "\n        -S      Log to syslog too" \
4182         USE_FEATURE_UDHCP_PORT( \
4183      "\n        -P N    Use port N instead of default 67" \
4184         )
4185
4186 #define umount_trivial_usage \
4187        "[flags] FILESYSTEM|DIRECTORY"
4188 #define umount_full_usage \
4189        "Unmount file systems\n" \
4190      "\nOptions:" \
4191         USE_FEATURE_UMOUNT_ALL( \
4192      "\n        -a      Unmount all file systems" USE_FEATURE_MTAB_SUPPORT(" in /etc/mtab") \
4193         ) \
4194         USE_FEATURE_MTAB_SUPPORT( \
4195      "\n        -n      Don't erase /etc/mtab entries" \
4196         ) \
4197      "\n        -r      Try to remount devices as read-only if mount is busy" \
4198      "\n        -l      Lazy umount (detach filesystem)" \
4199      "\n        -f      Force umount (i.e., unreachable NFS server)" \
4200         USE_FEATURE_MOUNT_LOOP( \
4201      "\n        -d      Free loop device if it has been used" \
4202         )
4203
4204 #define umount_example_usage \
4205        "$ umount /dev/hdc1\n"
4206
4207 #define uname_trivial_usage \
4208        "[-amnrspv]"
4209 #define uname_full_usage \
4210        "Print system information.\n" \
4211      "\nOptions:" \
4212      "\n        -a      Print all" \
4213      "\n        -m      The machine (hardware) type" \
4214      "\n        -n      Hostname" \
4215      "\n        -r      OS release" \
4216      "\n        -s      OS name (default)" \
4217      "\n        -p      Processor type" \
4218      "\n        -v      OS version" \
4219
4220 #define uname_example_usage \
4221        "$ uname -a\n" \
4222        "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n"
4223
4224 #define uncompress_trivial_usage \
4225        "[-c] [-f] [name...]"
4226 #define uncompress_full_usage \
4227        "Uncompress .Z file[s]\n" \
4228      "\nOptions:" \
4229      "\n        -c      Extract to stdout" \
4230      "\n        -f      Overwrite an existing file" \
4231
4232 #define unexpand_trivial_usage \
4233        "[-f][-a][-t NUM] [FILE|-]"
4234 #define unexpand_full_usage \
4235        "Convert spaces to tabs, writing to standard output.\n" \
4236      "\nOptions:" \
4237         USE_FEATURE_UNEXPAND_LONG_OPTIONS( \
4238      "\n        -a,--all        Convert all blanks" \
4239      "\n        -f,--first-only Convert only leading blanks" \
4240      "\n        -t,--tabs=N     Tabstops every N chars" \
4241         ) \
4242         SKIP_FEATURE_UNEXPAND_LONG_OPTIONS( \
4243      "\n        -a      Convert all blanks" \
4244      "\n        -f      Convert only leading blanks" \
4245      "\n        -t N    Tabstops every N chars" \
4246         )
4247
4248 #define uniq_trivial_usage \
4249        "[-fscdu]... [INPUT [OUTPUT]]"
4250 #define uniq_full_usage \
4251        "Discard all but one of successive identical lines from INPUT\n" \
4252        "(or standard input), writing to OUTPUT (or standard output)\n" \
4253      "\nOptions:" \
4254      "\n        -c      Prefix lines by the number of occurrences" \
4255      "\n        -d      Only print duplicate lines" \
4256      "\n        -u      Only print unique lines" \
4257      "\n        -f N    Skip the first N fields" \
4258      "\n        -s N    Skip the first N chars (after any skipped fields)" \
4259
4260 #define uniq_example_usage \
4261        "$ echo -e \"a\\na\\nb\\nc\\nc\\na\" | sort | uniq\n" \
4262        "a\n" \
4263        "b\n" \
4264        "c\n"
4265
4266 #define unix2dos_trivial_usage \
4267        "[option] [FILE]"
4268 #define unix2dos_full_usage \
4269        "Convert FILE from unix to dos format.\n" \
4270        "When no file is given, use stdin/stdout.\n" \
4271      "\nOptions:" \
4272      "\n        -u      dos2unix" \
4273      "\n        -d      unix2dos" \
4274
4275 #define unzip_trivial_usage \
4276        "[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]"
4277 #define unzip_full_usage \
4278        "Extract files from ZIP archives\n" \
4279      "\nOptions:" \
4280      "\n        -l      List archive contents (with -q for short form)" \
4281      "\n        -n      Never overwrite existing files (default)" \
4282      "\n        -o      Overwrite files without prompting" \
4283      "\n        -p      Send output to stdout" \
4284      "\n        -q      Quiet" \
4285      "\n        -x      Exclude these files" \
4286      "\n        -d      Extract files into this directory" \
4287
4288 #define uptime_trivial_usage \
4289        ""
4290 #define uptime_full_usage \
4291        "Display the time since the last boot"
4292
4293 #define uptime_example_usage \
4294        "$ uptime\n" \
4295        "  1:55pm  up  2:30, load average: 0.09, 0.04, 0.00\n"
4296
4297 #define usleep_trivial_usage \
4298        "N"
4299 #define usleep_full_usage \
4300        "Pause for N microseconds"
4301
4302 #define usleep_example_usage \
4303        "$ usleep 1000000\n" \
4304        "[pauses for 1 second]\n"
4305
4306 #define uudecode_trivial_usage \
4307        "[-o outfile] [infile]"
4308 #define uudecode_full_usage \
4309        "Uudecode a file\n" \
4310        "Finds outfile name in uuencoded source unless -o is given"
4311
4312 #define uudecode_example_usage \
4313        "$ uudecode -o busybox busybox.uu\n" \
4314        "$ ls -l busybox\n" \
4315        "-rwxr-xr-x   1 ams      ams        245264 Jun  7 21:35 busybox\n"
4316
4317 #define uuencode_trivial_usage \
4318        "[-m] [infile] stored_filename"
4319 #define uuencode_full_usage \
4320        "Uuencode a file to stdout\n" \
4321      "\nOptions:" \
4322      "\n        -m      Use base64 encoding per RFC1521" \
4323
4324 #define uuencode_example_usage \
4325        "$ uuencode busybox busybox\n" \
4326        "begin 755 busybox\n" \
4327        "<encoded file snipped>\n" \
4328        "$ uudecode busybox busybox > busybox.uu\n" \
4329        "$\n"
4330
4331 #define vconfig_trivial_usage \
4332        "COMMAND [OPTIONS]..."
4333 #define vconfig_full_usage \
4334        "Create and remove virtual ethernet devices\n" \
4335      "\nOptions:" \
4336      "\n        add             [interface-name] [vlan_id]" \
4337      "\n        rem             [vlan-name]" \
4338      "\n        set_flag        [interface-name] [flag-num] [0 | 1]" \
4339      "\n        set_egress_map  [vlan-name] [skb_priority] [vlan_qos]" \
4340      "\n        set_ingress_map [vlan-name] [skb_priority] [vlan_qos]" \
4341      "\n        set_name_type   [name-type]" \
4342
4343 #define vi_trivial_usage \
4344        "[OPTION] [FILE]..."
4345 #define vi_full_usage \
4346        "Edit FILE\n" \
4347      "\nOptions:" \
4348         USE_FEATURE_VI_COLON( \
4349      "\n        -c      Initial command to run ($EXINIT also available)") \
4350         USE_FEATURE_VI_READONLY( \
4351      "\n        -R      Read-only - do not write to the file") \
4352      "\n        -H      Short help regarding available features" \
4353
4354 #define vlock_trivial_usage \
4355        "[OPTIONS]"
4356 #define vlock_full_usage \
4357        "Lock a virtual terminal. A password is required to unlock.\n" \
4358      "\nOptions:" \
4359      "\n        -a      Lock all VTs" \
4360
4361 #define watch_trivial_usage \
4362        "[-n seconds] [-t] COMMAND..."
4363 #define watch_full_usage \
4364        "Execute a program periodically\n" \
4365      "\nOptions:" \
4366      "\n        -n      Loop period in seconds (default 2)" \
4367      "\n        -t      Don't print header" \
4368
4369 #define watch_example_usage \
4370        "$ watch date\n" \
4371        "Mon Dec 17 10:31:40 GMT 2000\n" \
4372        "Mon Dec 17 10:31:42 GMT 2000\n" \
4373        "Mon Dec 17 10:31:44 GMT 2000"
4374
4375 #define watchdog_trivial_usage \
4376        "[-t N[ms]] [-F] DEV"
4377 #define watchdog_full_usage \
4378        "Periodically write to watchdog device DEV\n" \
4379      "\nOptions:" \
4380      "\n        -t N    Timer period (default 30)" \
4381      "\n        -F      Run in foreground" \
4382      "\n" \
4383      "\nUse -t 500ms to specify period in milliseconds" \
4384
4385 #define wc_trivial_usage \
4386        "[OPTION]... [FILE]..."
4387 #define wc_full_usage \
4388        "Print line, word, and byte counts for each FILE, and a total line if\n" \
4389        "more than one FILE is specified. With no FILE, read standard input.\n" \
4390      "\nOptions:" \
4391      "\n        -c      Print the byte counts" \
4392      "\n        -l      Print the newline counts" \
4393      "\n        -L      Print the length of the longest line" \
4394      "\n        -w      Print the word counts" \
4395
4396 #define wc_example_usage \
4397        "$ wc /etc/passwd\n" \
4398        "     31      46    1365 /etc/passwd\n"
4399
4400 #define wget_trivial_usage \
4401         USE_GETOPT_LONG( \
4402        "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document file]\n" \
4403        "        [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
4404        "        [-U|--user-agent agent] url" \
4405         ) \
4406         SKIP_GETOPT_LONG( \
4407        "[-csq] [-O file] [-Y on/off] [-P DIR] [-U agent] url" \
4408         )
4409 #define wget_full_usage \
4410        "Retrieve files via HTTP or FTP\n" \
4411      "\nOptions:" \
4412      "\n        -s      Spider mode - only check file existence" \
4413      "\n        -c      Continue retrieval of aborted transfer" \
4414      "\n        -q      Quiet" \
4415      "\n        -P      Set directory prefix to DIR" \
4416      "\n        -O      Save to filename ('-' for stdout)" \
4417      "\n        -U      Adjust 'User-Agent' field" \
4418      "\n        -Y      Use proxy ('on' or 'off')" \
4419
4420 #define which_trivial_usage \
4421        "[COMMAND...]"
4422 #define which_full_usage \
4423        "Locate a COMMAND"
4424 #define which_example_usage \
4425        "$ which login\n" \
4426        "/bin/login\n"
4427
4428 #define who_trivial_usage \
4429        "[-a]"
4430 #define who_full_usage \
4431        "Show who is logged on\n" \
4432      "\nOptions:" \
4433      "\n        -a      show all" \
4434
4435 #define whoami_trivial_usage \
4436        ""
4437 #define whoami_full_usage \
4438        "Print the user name associated with the current effective user id"
4439
4440 #define xargs_trivial_usage \
4441        "[OPTIONS] [COMMAND] [ARGS...]"
4442 #define xargs_full_usage \
4443        "Execute COMMAND on every item given by standard input\n" \
4444      "\nOptions:" \
4445         USE_FEATURE_XARGS_SUPPORT_CONFIRMATION( \
4446      "\n        -p      Prompt the user about whether to run each command") \
4447      "\n        -r      Do not run command for empty read lines" \
4448         USE_FEATURE_XARGS_SUPPORT_TERMOPT( \
4449      "\n        -x      Exit if the size is exceeded") \
4450         USE_FEATURE_XARGS_SUPPORT_ZERO_TERM( \
4451      "\n        -0      Input filenames are terminated by a null character") \
4452      "\n        -t      Print the command line on stderr before executing it" \
4453
4454 #define xargs_example_usage \
4455        "$ ls | xargs gzip\n" \
4456        "$ find . -name '*.c' -print | xargs rm\n"
4457
4458 #define yes_trivial_usage \
4459        "[OPTION]... [STRING]..."
4460 #define yes_full_usage \
4461        "Repeatedly output a line with all specified STRING(s), or 'y'"
4462
4463 #define zcat_trivial_usage \
4464        "FILE"
4465 #define zcat_full_usage \
4466        "Uncompress to stdout"
4467
4468 #define zcip_trivial_usage \
4469        "[OPTIONS] ifname script"
4470 #define zcip_full_usage \
4471        "Manage a ZeroConf IPv4 link-local address\n" \
4472      "\nOptions:" \
4473      "\n        -f              Run in foreground" \
4474      "\n        -q              Quit after address (no daemon)" \
4475      "\n        -r 169.254.x.x  Request this address first" \
4476      "\n        -v              Verbose" \
4477
4478 #endif /* __BB_USAGE_H__ */