Changeset 1770 in MondoRescue for branches/stable/mindi-busybox/include


Ignore:
Timestamp:
Nov 6, 2007, 11:01:53 AM (16 years ago)
Author:
Bruno Cornec
Message:
  • Better output for mindi-busybox revision
  • Remove dummy file created on NFS - report from Arnaud Tiger <arnaud.tiger_at_hp.com>
  • strace useful for debug
  • fix new versions for pb (2.0.0 for mindi and 1.7.2 for mindi-busybox)
  • fix build process for mindi-busybox + options used in that version (dd for label-partitions-as-necessary)
  • fix typo in label-partitions-as-necessary which doesn't seem to work
  • Update to busybox 1.7.2
  • perl is now required at restore time to support uuid swap partitions (and will be used for many other thigs

in the future for sure)

  • next mindi version will be 2.0.0 due to all the changes made in it (udev may break working distros)
  • small optimization in mindi on keyboard handling (one single find instead of multiple)
  • better interaction for USB device when launching mindi manually
  • attempt to automatically guess block disk size for ramdisk
  • fix typos in bkphw
  • Fix the remaining problem with UUID support for swap partitions
  • Updates mondoarchive man page for USB support
  • Adds preliminary Hardware support to mindi (Proliant SSSTK)
  • Tries to add udev support also for rhel4
  • Fix UUID support which was still broken.
  • Be conservative in test for the start-nfs script
  • Update config file for mindi-busybox for 1.7.2 migration
  • Try to run around a busybox bug (1.2.2 pb on inexistant links)
  • Add build content for mindi-busybox in pb
  • Remove distributions content for mindi-busybox
  • Fix a warning on inexistant raidtab
  • Solve problem on tmpfs in restore init (Problem of inexistant symlink and busybox)
  • Create MONDO_CACHE and use it everywhere + creation at start
  • Really never try to eject a USB device
  • Fix a issue with &> usage (replaced with 1> and 2>)
  • Adds magic file to depllist in order to have file working + ldd which helps for debugging issues
  • tty modes correct to avoid sh error messages
  • Use ext3 normally and not ext2 instead
  • USB device should be corrected after reading (take 1st part)
  • Adds a mount_USB_here function derived from mount_CDROM_here
  • usb detection place before /dev detection in device name at restore time
  • Fix when restoring from USB: media is asked in interactive mode
  • Adds USB support for mondorestore
  • mount_cdrom => mount_media
  • elilo.efi is now searched throughout /boot/efi and not in a fixed place as there is no standard
  • untar-and-softlink => untar (+ interface change)
  • suppress useless softlinks creation/removal in boot process
  • avoids udevd messages on groups
  • Increase # of disks to 99 as in mindi at restore time (should be a conf file parameter)
  • skip existing big file creation
  • seems to work correctly for USB mindi boot
  • Adds group and tty link to udev conf
  • Always load usb-torage (even 2.6) to initiate USB bus discovery
  • Better printing of messages
  • Attempt to fix a bug in supporting OpenSusE 10.3 kernel for initramfs (mindi may now use multiple regex for kernel initrd detection)
  • Links were not correctly done as non relative for modules in mindi
  • exclusion of modules denied now works
  • Also create modules in their ordinary place, so that classical modprobe works + copy modules.dep
  • Fix bugs for DENY_MODS handling
  • Add device /dev/console for udev
  • ide-generic should now really be excluded
  • Fix a bug in major number for tty
  • If udev then adds modprobe/insmod to rootfs
  • tty0 is also cretaed with udev
  • ide-generic put rather in DENY_MODS
  • udevd remove from deplist s handled in mindi directly
  • better default for mindi when using --usb
  • Handles dynamically linked busybox (in case we want to use it soon ;-)
  • Adds fixed devices to create for udev
  • ide-generic should not be part of the initrd when using libata v2
  • support a dynamically linked udev (case on Ubuntu 7.10 and Mandriva 2008.0 so should be quite generic) This will give incitation to move to dyn. linked binaries in the initrd which will help for other tasks (ia6 4)
  • Improvement in udev support (do not use cl options not available in busybox)
  • Udev in mindi
    • auto creation of the right links at boot time with udev-links.conf(from Mandriva 2008.0)
    • rework startup of udev as current makes kernel crash (from Mandriva 2008.0)
    • add support for 64 bits udev
  • Try to render MyInsmod silent at boot time
  • Adds udev support (mandatory for newest distributions to avoid remapping of devices in a different way as on the original system)
  • We also need vaft format support for USB boot
  • Adds libusual support (Ubuntu 7.10 needs it for USB)
  • Improve Ubuntu/Debian keyboard detection and support
  • pbinit adapted to new pb (0.8.10). Filtering of docs done in it
  • Suppress some mondo warnings and errors on USB again
  • Tries to fix lack of files in deb mindi package
  • Verify should now work for USB devices
  • More log/mesages improvement for USB support
  • - Supress g_erase_tmpdir_and_scratchdir
  • Improve some log messages for USB support
  • Try to improve install in mindi to avoid issues with isolinux.cfg not installed vene if in the pkg :-(
  • Improve mindi-busybox build
  • In conformity with pb 0.8.9
  • Add support for Ubuntu 7.10 in build process
  • Add USB Key button to Menu UI (CD streamer removed)
  • Attempt to fix error messages on tmp/scratch files at the end by removing those dir at the latest possible.
  • Fix a bug linked to the size of the -E param which could be used (Arnaud Tiger/René Ribaud).
  • Integrate ~/.pbrc content into mondorescue.pb (required project-builder >= 0.8.7)
  • Put mondorescue in conformity with new pb filtering rules
  • Add USB support at restore time (no test done yet). New start-usb script PB varibale added where useful
  • Unmounting USB device before removal of temporary scratchdir
  • Stil refining USB copy back to mondo (one command was not executed)
  • No need to have the image subdor in the csratchdir when USB.
  • umount the USB partition before attempting to use it
  • Remove useless copy from mindi to mondo at end of USB handling

(risky merge, we are raising the limits of 2 diverging branches. The status of stable is not completely sure as such. Will need lots of tests, but it's not yet done :-()
(merge -r1692:1769 $SVN_M/branches/2.2.5)

Location:
branches/stable/mindi-busybox/include
Files:
12 edited
1 copied

Legend:

Unmodified
Added
Removed
  • branches/stable/mindi-busybox/include/applets.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12/*
    23 * applets.h - a listing of all busybox applets.
     
    1112 */
    1213
    13 #undef APPLET
    14 #undef APPLET_ODDNAME
    15 #undef APPLET_NOUSAGE
    16 
     14/*
     15name  - applet name as it is typed on command line
     16name2 - applet name, converted to C (ether-wake: name2 = ether_wake)
     17main  - corresponding <applet>_main to call (bzcat: main = bunzip2)
     18l     - location to install link to: [/usr]/[s]bin
     19s     - suid type:
     20        _BB_SUID_ALWAYS: will complain if busybox isn't suid
     21        and is run by non-root (applet_main() will not be called at all)
     22        _BB_SUID_NEVER: will drop suid prior to applet_main()
     23        _BB_SUID_MAYBE: neither of the above
     24*/
    1725
    1826#if defined(PROTOTYPES)
    19 # define APPLET(a,b,c) extern int a##_main(int argc, char **argv);
    20 # define APPLET_NOUSAGE(a,b,c,d) extern int b##_main(int argc, char **argv);
    21 # define APPLET_ODDNAME(a,b,c,d,e) extern int b##_main(int argc, char **argv);
    22 #elif defined(MAKE_USAGE)
    23 # ifdef CONFIG_FEATURE_VERBOSE_USAGE
    24 #  define APPLET(a,b,c) a##_trivial_usage "\n\n" a##_full_usage "\0"
    25 #  define APPLET_NOUSAGE(a,b,c,d) "\b\0"
    26 #  define APPLET_ODDNAME(a,b,c,d,e) e##_trivial_usage "\n\n" e##_full_usage "\0"
    27 # else
    28 #  define APPLET(a,b,c) a##_trivial_usage "\0"
    29 #  define APPLET_NOUSAGE(a,b,c,d) "\b\0"
    30 #  define APPLET_ODDNAME(a,b,c,d,e) e##_trivial_usage "\0"
    31 # endif
     27# define APPLET(name,l,s)                    int name##_main(int argc, char **argv);
     28# define APPLET_NOUSAGE(name,main,l,s)       int main##_main(int argc, char **argv);
     29# define APPLET_ODDNAME(name,main,l,s,name2) int main##_main(int argc, char **argv);
     30# define APPLET_NOEXEC(name,main,l,s,name2)  int main##_main(int argc, char **argv);
     31# define APPLET_NOFORK(name,main,l,s,name2)  int main##_main(int argc, char **argv);
     32
     33#elif defined(MAKE_USAGE) && ENABLE_FEATURE_VERBOSE_USAGE
     34# define APPLET(name,l,s)                    name##_trivial_usage "\n\n" name##_full_usage "\0"
     35# define APPLET_NOUSAGE(name,main,l,s)       "\b\0"
     36# define APPLET_ODDNAME(name,main,l,s,name2) name2##_trivial_usage "\n\n" name2##_full_usage "\0"
     37# define APPLET_NOEXEC(name,main,l,s,name2)  name2##_trivial_usage "\n\n" name2##_full_usage "\0"
     38# define APPLET_NOFORK(name,main,l,s,name2)  name2##_trivial_usage "\n\n" name2##_full_usage "\0"
     39
     40#elif defined(MAKE_USAGE) && !ENABLE_FEATURE_VERBOSE_USAGE
     41# define APPLET(name,l,s)                    name##_trivial_usage "\0"
     42# define APPLET_NOUSAGE(name,main,l,s)       "\b\0"
     43# define APPLET_ODDNAME(name,main,l,s,name2) name2##_trivial_usage "\0"
     44# define APPLET_NOEXEC(name,main,l,s,name2)  name2##_trivial_usage "\0"
     45# define APPLET_NOFORK(name,main,l,s,name2)  name2##_trivial_usage "\0"
     46
    3247#elif defined(MAKE_LINKS)
    33 # define APPLET(a,b,c) LINK b a
    34 # define APPLET_NOUSAGE(a,b,c,d) LINK c a
    35 # define APPLET_ODDNAME(a,b,c,d,e) LINK c a
     48# define APPLET(name,l,c)                    LINK l name
     49# define APPLET_NOUSAGE(name,main,l,s)       LINK l name
     50# define APPLET_ODDNAME(name,main,l,s,name2) LINK l name
     51# define APPLET_NOEXEC(name,main,l,s,name2)  LINK l name
     52# define APPLET_NOFORK(name,main,l,s,name2)  LINK l name
     53
    3654#else
    37   const struct BB_applet applets[] = {
    38 # define APPLET(a,b,c) {#a,a##_main,b,c},
    39 # define APPLET_NOUSAGE(a,b,c,d) {#a,b##_main,c,d},
    40 # define APPLET_ODDNAME(a,b,c,d,e) {#a,b##_main,c,d},
    41 #endif
    42 
    43 #ifdef CONFIG_INSTALL_NO_USR
     55  const struct bb_applet applets[] = { /*    name, main, location, need_suid */
     56# define APPLET(name,l,s)                    { #name, name##_main USE_FEATURE_INSTALLER(,l) USE_FEATURE_SUID(,s) },
     57# define APPLET_NOUSAGE(name,main,l,s)       { #name, main##_main USE_FEATURE_INSTALLER(,l) USE_FEATURE_SUID(,s) },
     58# define APPLET_ODDNAME(name,main,l,s,name2) { #name, main##_main USE_FEATURE_INSTALLER(,l) USE_FEATURE_SUID(,s) },
     59# define APPLET_NOEXEC(name,main,l,s,name2)  { #name, main##_main USE_FEATURE_INSTALLER(,l) USE_FEATURE_SUID(,s) USE_FEATURE_PREFER_APPLETS(,1) },
     60# define APPLET_NOFORK(name,main,l,s,name2)  { #name, main##_main USE_FEATURE_INSTALLER(,l) USE_FEATURE_SUID(,s) USE_FEATURE_PREFER_APPLETS(,1 ,1) },
     61#endif
     62
     63#if ENABLE_INSTALL_NO_USR
    4464# define _BB_DIR_USR_BIN _BB_DIR_BIN
    4565# define _BB_DIR_USR_SBIN _BB_DIR_SBIN
     
    4767
    4868
    49 USE_TEST(APPLET_NOUSAGE([, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     69USE_TEST(APPLET_NOEXEC([, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER, test))
    5070USE_TEST(APPLET_NOUSAGE([[, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    5171USE_ADDGROUP(APPLET(addgroup, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    5373USE_ADJTIMEX(APPLET(adjtimex, _BB_DIR_SBIN, _BB_SUID_NEVER))
    5474USE_AR(APPLET(ar, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     75USE_ARP(APPLET(arp, _BB_DIR_SBIN, _BB_SUID_NEVER))
    5576USE_ARPING(APPLET(arping, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    5677USE_ASH(APPLET_NOUSAGE(ash, ash, _BB_DIR_BIN, _BB_SUID_NEVER))
    57 USE_AWK(APPLET(awk, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    58 USE_BASENAME(APPLET(basename, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     78USE_AWK(APPLET_NOEXEC(awk, awk, _BB_DIR_USR_BIN, _BB_SUID_NEVER, awk))
     79USE_BASENAME(APPLET_NOFORK(basename, basename, _BB_DIR_USR_BIN, _BB_SUID_NEVER, basename))
    5980USE_BBCONFIG(APPLET(bbconfig, _BB_DIR_BIN, _BB_SUID_NEVER))
     81//USE_BBSH(APPLET(bbsh, _BB_DIR_BIN, _BB_SUID_NEVER))
    6082USE_BUNZIP2(APPLET(bunzip2, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    61 /* Always enabled. */
    62 APPLET_NOUSAGE(busybox, busybox, _BB_DIR_BIN, _BB_SUID_MAYBE)
    6383USE_BUNZIP2(APPLET_ODDNAME(bzcat, bunzip2, _BB_DIR_USR_BIN, _BB_SUID_NEVER, bzcat))
    6484USE_CAL(APPLET(cal, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    65 USE_CAT(APPLET(cat, _BB_DIR_BIN, _BB_SUID_NEVER))
     85USE_CAT(APPLET_NOFORK(cat, cat, _BB_DIR_BIN, _BB_SUID_NEVER, cat))
    6686USE_CATV(APPLET(catv, _BB_DIR_BIN, _BB_SUID_NEVER))
    6787USE_CHATTR(APPLET(chattr, _BB_DIR_BIN, _BB_SUID_NEVER))
    68 USE_CHGRP(APPLET(chgrp, _BB_DIR_BIN, _BB_SUID_NEVER))
    69 USE_CHMOD(APPLET(chmod, _BB_DIR_BIN, _BB_SUID_NEVER))
    70 USE_CHOWN(APPLET(chown, _BB_DIR_BIN, _BB_SUID_NEVER))
     88USE_CHCON(APPLET(chcon, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     89USE_CHGRP(APPLET_NOEXEC(chgrp, chgrp, _BB_DIR_BIN, _BB_SUID_NEVER, chgrp))
     90USE_CHMOD(APPLET_NOEXEC(chmod, chmod, _BB_DIR_BIN, _BB_SUID_NEVER, chmod))
     91USE_CHOWN(APPLET_NOEXEC(chown, chown, _BB_DIR_BIN, _BB_SUID_NEVER, chown))
     92USE_CHPASSWD(APPLET(chpasswd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     93USE_CHPST(APPLET(chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    7194USE_CHROOT(APPLET(chroot, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     95USE_CHRT(APPLET(chrt, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    7296USE_CHVT(APPLET(chvt, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    7397USE_CKSUM(APPLET(cksum, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     
    7599USE_CMP(APPLET(cmp, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    76100USE_COMM(APPLET(comm, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    77 USE_CP(APPLET(cp, _BB_DIR_BIN, _BB_SUID_NEVER))
     101USE_CP(APPLET_NOEXEC(cp, cp, _BB_DIR_BIN, _BB_SUID_NEVER, cp))
    78102USE_CPIO(APPLET(cpio, _BB_DIR_BIN, _BB_SUID_NEVER))
    79103USE_CROND(APPLET(crond, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    80104USE_CRONTAB(APPLET(crontab, _BB_DIR_USR_BIN, _BB_SUID_ALWAYS))
    81 USE_CUT(APPLET(cut, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     105USE_CRYPTPW(APPLET(cryptpw, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     106USE_CTTYHACK(APPLET_NOUSAGE(cttyhack, cttyhack, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     107USE_CUT(APPLET_NOEXEC(cut, cut, _BB_DIR_USR_BIN, _BB_SUID_NEVER, cut))
    82108USE_DATE(APPLET(date, _BB_DIR_BIN, _BB_SUID_NEVER))
    83109USE_DC(APPLET(dc, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    84 USE_DD(APPLET(dd, _BB_DIR_BIN, _BB_SUID_NEVER))
     110USE_DD(APPLET_NOEXEC(dd, dd, _BB_DIR_BIN, _BB_SUID_NEVER, dd))
    85111USE_DEALLOCVT(APPLET(deallocvt, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    86112USE_DELGROUP(APPLET_ODDNAME(delgroup, deluser, _BB_DIR_BIN, _BB_SUID_NEVER, delgroup))
     
    88114USE_DEVFSD(APPLET(devfsd, _BB_DIR_SBIN, _BB_SUID_NEVER))
    89115USE_DF(APPLET(df, _BB_DIR_BIN, _BB_SUID_NEVER))
     116USE_APP_DHCPRELAY(APPLET(dhcprelay, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    90117USE_DIFF(APPLET(diff, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    91 USE_DIRNAME(APPLET(dirname, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     118USE_DIRNAME(APPLET_NOFORK(dirname, dirname, _BB_DIR_USR_BIN, _BB_SUID_NEVER, dirname))
    92119USE_DMESG(APPLET(dmesg, _BB_DIR_BIN, _BB_SUID_NEVER))
    93120USE_DNSD(APPLET(dnsd, _BB_DIR_USR_SBIN, _BB_SUID_ALWAYS))
     
    98125USE_DUMPKMAP(APPLET(dumpkmap, _BB_DIR_BIN, _BB_SUID_NEVER))
    99126USE_APP_DUMPLEASES(APPLET(dumpleases, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    100 USE_E2FSCK(APPLET(e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
    101 USE_E2LABEL(APPLET_NOUSAGE(e2label, tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    102 USE_ECHO(APPLET(echo, _BB_DIR_BIN, _BB_SUID_NEVER))
     127//USE_E2FSCK(APPLET(e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
     128//USE_E2LABEL(APPLET_NOUSAGE(e2label, tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     129USE_ECHO(APPLET_NOFORK(echo, echo, _BB_DIR_BIN, _BB_SUID_NEVER, echo))
    103130USE_ED(APPLET(ed, _BB_DIR_BIN, _BB_SUID_NEVER))
    104131USE_FEATURE_GREP_EGREP_ALIAS(APPLET_NOUSAGE(egrep, grep, _BB_DIR_BIN, _BB_SUID_NEVER))
    105132USE_EJECT(APPLET(eject, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    106133USE_ENV(APPLET(env, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    107 USE_ETHER_WAKE(APPLET_ODDNAME(ether-wake, etherwake, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ether_wake))
     134USE_ENVDIR(APPLET_ODDNAME(envdir, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, envdir))
     135USE_ENVUIDGID(APPLET_ODDNAME(envuidgid, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, envuidgid))
     136USE_ETHER_WAKE(APPLET_ODDNAME(ether-wake, ether_wake, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ether_wake))
     137USE_EXPAND(APPLET(expand, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    108138USE_EXPR(APPLET(expr, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    109139USE_FAKEIDENTD(APPLET(fakeidentd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    110 USE_FALSE(APPLET(false, _BB_DIR_BIN, _BB_SUID_NEVER))
     140USE_FALSE(APPLET_NOFORK(false, false, _BB_DIR_BIN, _BB_SUID_NEVER, false))
    111141USE_FBSET(APPLET(fbset, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    112142USE_FDFLUSH(APPLET_ODDNAME(fdflush, freeramdisk, _BB_DIR_BIN, _BB_SUID_NEVER, fdflush))
     
    114144USE_FDISK(APPLET(fdisk, _BB_DIR_SBIN, _BB_SUID_NEVER))
    115145USE_FEATURE_GREP_FGREP_ALIAS(APPLET_NOUSAGE(fgrep, grep, _BB_DIR_BIN, _BB_SUID_NEVER))
    116 USE_FIND(APPLET(find, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    117 USE_FINDFS(APPLET_NOUSAGE(findfs, tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     146USE_FIND(APPLET_NOEXEC(find, find, _BB_DIR_USR_BIN, _BB_SUID_NEVER, find))
     147//USE_FINDFS(APPLET_NOUSAGE(findfs, tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    118148USE_FOLD(APPLET(fold, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    119149USE_FREE(APPLET(free, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    120150USE_FREERAMDISK(APPLET(freeramdisk, _BB_DIR_SBIN, _BB_SUID_NEVER))
    121151USE_FSCK(APPLET(fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
    122 USE_E2FSCK(APPLET_NOUSAGE(fsck.ext2, e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
    123 USE_E2FSCK(APPLET_NOUSAGE(fsck.ext3, e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
     152//USE_E2FSCK(APPLET_NOUSAGE(fsck.ext2, e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
     153//USE_E2FSCK(APPLET_NOUSAGE(fsck.ext3, e2fsck, _BB_DIR_SBIN, _BB_SUID_NEVER))
    124154USE_FSCK_MINIX(APPLET_ODDNAME(fsck.minix, fsck_minix, _BB_DIR_SBIN, _BB_SUID_NEVER, fsck_minix))
    125 USE_FTPGET(APPLET_ODDNAME(ftpget, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER,ftpget))
    126 USE_FTPPUT(APPLET_ODDNAME(ftpput, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER,ftpput))
     155USE_FTPGET(APPLET_ODDNAME(ftpget, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ftpget))
     156USE_FTPPUT(APPLET_ODDNAME(ftpput, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ftpput))
    127157USE_FUSER(APPLET(fuser, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     158USE_GETENFORCE(APPLET(getenforce, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    128159USE_GETOPT(APPLET(getopt, _BB_DIR_BIN, _BB_SUID_NEVER))
     160USE_GETSEBOOL(APPLET(getsebool, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    129161USE_GETTY(APPLET(getty, _BB_DIR_SBIN, _BB_SUID_NEVER))
    130162USE_GREP(APPLET(grep, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    134166USE_HDPARM(APPLET(hdparm, _BB_DIR_SBIN, _BB_SUID_NEVER))
    135167USE_HEAD(APPLET(head, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    136 USE_HEXDUMP(APPLET(hexdump, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    137 USE_HOSTID(APPLET(hostid, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     168USE_HEXDUMP(APPLET_NOEXEC(hexdump, hexdump, _BB_DIR_USR_BIN, _BB_SUID_NEVER, hexdump))
     169USE_HOSTID(APPLET_NOFORK(hostid, hostid, _BB_DIR_USR_BIN, _BB_SUID_NEVER, hostid))
    138170USE_HOSTNAME(APPLET(hostname, _BB_DIR_BIN, _BB_SUID_NEVER))
    139171USE_HTTPD(APPLET(httpd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     
    148180USE_INSMOD(APPLET(insmod, _BB_DIR_SBIN, _BB_SUID_NEVER))
    149181USE_INSTALL(APPLET(install, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     182#if ENABLE_FEATURE_IP_ADDRESS \
     183 || ENABLE_FEATURE_IP_ROUTE \
     184 || ENABLE_FEATURE_IP_LINK \
     185 || ENABLE_FEATURE_IP_TUNNEL \
     186 || ENABLE_FEATURE_IP_RULE
    150187USE_IP(APPLET(ip, _BB_DIR_BIN, _BB_SUID_NEVER))
     188#endif
    151189USE_IPADDR(APPLET(ipaddr, _BB_DIR_BIN, _BB_SUID_NEVER))
    152190USE_IPCALC(APPLET(ipcalc, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    155193USE_IPLINK(APPLET(iplink, _BB_DIR_BIN, _BB_SUID_NEVER))
    156194USE_IPROUTE(APPLET(iproute, _BB_DIR_BIN, _BB_SUID_NEVER))
     195USE_IPRULE(APPLET(iprule, _BB_DIR_BIN, _BB_SUID_NEVER))
    157196USE_IPTUNNEL(APPLET(iptunnel, _BB_DIR_BIN, _BB_SUID_NEVER))
    158197USE_KILL(APPLET(kill, _BB_DIR_BIN, _BB_SUID_NEVER))
    159198USE_KILLALL(APPLET_ODDNAME(killall, kill, _BB_DIR_USR_BIN, _BB_SUID_NEVER, killall))
     199USE_KILLALL5(APPLET_ODDNAME(killall5, kill, _BB_DIR_USR_BIN, _BB_SUID_NEVER, killall5))
    160200USE_KLOGD(APPLET(klogd, _BB_DIR_SBIN, _BB_SUID_NEVER))
    161201USE_LASH(APPLET(lash, _BB_DIR_BIN, _BB_SUID_NEVER))
    162202USE_LAST(APPLET(last, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    163 USE_LENGTH(APPLET(length, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     203USE_LENGTH(APPLET_NOFORK(length, length, _BB_DIR_USR_BIN, _BB_SUID_NEVER, length))
    164204USE_LESS(APPLET(less, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    165205USE_SETARCH(APPLET_NOUSAGE(linux32, setarch, _BB_DIR_BIN, _BB_SUID_NEVER))
    166206USE_SETARCH(APPLET_NOUSAGE(linux64, setarch, _BB_DIR_BIN, _BB_SUID_NEVER))
    167207USE_FEATURE_INITRD(APPLET_NOUSAGE(linuxrc, init, _BB_DIR_ROOT, _BB_SUID_NEVER))
    168 USE_LN(APPLET(ln, _BB_DIR_BIN, _BB_SUID_NEVER))
     208USE_LN(APPLET_NOEXEC(ln, ln, _BB_DIR_BIN, _BB_SUID_NEVER, ln))
     209USE_LOAD_POLICY(APPLET(load_policy, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    169210USE_LOADFONT(APPLET(loadfont, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    170211USE_LOADKMAP(APPLET(loadkmap, _BB_DIR_SBIN, _BB_SUID_NEVER))
    171212USE_LOGGER(APPLET(logger, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    172213USE_LOGIN(APPLET(login, _BB_DIR_BIN, _BB_SUID_ALWAYS))
    173 USE_LOGNAME(APPLET(logname, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     214USE_LOGNAME(APPLET_NOFORK(logname, logname, _BB_DIR_USR_BIN, _BB_SUID_NEVER, logname))
    174215USE_LOGREAD(APPLET(logread, _BB_DIR_SBIN, _BB_SUID_NEVER))
    175216USE_LOSETUP(APPLET(losetup, _BB_DIR_SBIN, _BB_SUID_NEVER))
    176 USE_LS(APPLET(ls, _BB_DIR_BIN, _BB_SUID_NEVER))
     217USE_LS(APPLET_NOEXEC(ls, ls, _BB_DIR_BIN, _BB_SUID_NEVER, ls))
    177218USE_LSATTR(APPLET(lsattr, _BB_DIR_BIN, _BB_SUID_NEVER))
    178219USE_LSMOD(APPLET(lsmod, _BB_DIR_SBIN, _BB_SUID_NEVER))
    179220USE_UNLZMA(APPLET_ODDNAME(lzmacat, unlzma, _BB_DIR_USR_BIN, _BB_SUID_NEVER, lzmacat))
    180221USE_MAKEDEVS(APPLET(makedevs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    181 USE_MD5SUM(APPLET(md5sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     222USE_MATCHPATHCON(APPLET(matchpathcon, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     223USE_MD5SUM(APPLET_ODDNAME(md5sum, md5_sha1_sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER, md5sum))
    182224USE_MDEV(APPLET(mdev, _BB_DIR_SBIN, _BB_SUID_NEVER))
    183225USE_MESG(APPLET(mesg, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    184 USE_MKDIR(APPLET(mkdir, _BB_DIR_BIN, _BB_SUID_NEVER))
    185 USE_MKE2FS(APPLET(mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     226USE_MKDIR(APPLET_NOFORK(mkdir, mkdir, _BB_DIR_BIN, _BB_SUID_NEVER, mkdir))
     227//USE_MKE2FS(APPLET(mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    186228USE_MKFIFO(APPLET(mkfifo, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    187 USE_MKE2FS(APPLET_NOUSAGE(mkfs.ext2, mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    188 USE_MKE2FS(APPLET_NOUSAGE(mkfs.ext3, mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     229//USE_MKE2FS(APPLET_NOUSAGE(mkfs.ext2, mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     230//USE_MKE2FS(APPLET_NOUSAGE(mkfs.ext3, mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    189231USE_MKFS_MINIX(APPLET_ODDNAME(mkfs.minix, mkfs_minix, _BB_DIR_SBIN, _BB_SUID_NEVER, mkfs_minix))
    190232USE_MKNOD(APPLET(mknod, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    193235USE_MODPROBE(APPLET(modprobe, _BB_DIR_SBIN, _BB_SUID_NEVER))
    194236USE_MORE(APPLET(more, _BB_DIR_BIN, _BB_SUID_NEVER))
    195 USE_MOUNT(APPLET(mount, _BB_DIR_BIN, _BB_SUID_NEVER))
     237USE_MOUNT(APPLET(mount, _BB_DIR_BIN, USE_DESKTOP(_BB_SUID_MAYBE) SKIP_DESKTOP(_BB_SUID_NEVER)))
    196238USE_MOUNTPOINT(APPLET(mountpoint, _BB_DIR_BIN, _BB_SUID_NEVER))
    197239USE_MSH(APPLET_NOUSAGE(msh, msh, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    202244USE_NETSTAT(APPLET(netstat, _BB_DIR_BIN, _BB_SUID_NEVER))
    203245USE_NICE(APPLET(nice, _BB_DIR_BIN, _BB_SUID_NEVER))
     246USE_NMETER(APPLET(nmeter, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    204247USE_NOHUP(APPLET(nohup, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    205248USE_NSLOOKUP(APPLET(nslookup, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     
    217260USE_PRINTF(APPLET(printf, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    218261USE_PS(APPLET(ps, _BB_DIR_BIN, _BB_SUID_NEVER))
    219 USE_PWD(APPLET(pwd, _BB_DIR_BIN, _BB_SUID_NEVER))
     262USE_PSCAN(APPLET(pscan, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     263USE_PWD(APPLET_NOFORK(pwd, pwd, _BB_DIR_BIN, _BB_SUID_NEVER, pwd))
     264USE_RAIDAUTORUN(APPLET(raidautorun, _BB_DIR_SBIN, _BB_SUID_NEVER))
    220265USE_RDATE(APPLET(rdate, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     266USE_READAHEAD(APPLET(readahead, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    221267USE_READLINK(APPLET(readlink, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    222268USE_READPROFILE(APPLET(readprofile, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     
    225271USE_RENICE(APPLET(renice, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    226272USE_RESET(APPLET(reset, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    227 USE_RM(APPLET(rm, _BB_DIR_BIN, _BB_SUID_NEVER))
    228 USE_RMDIR(APPLET(rmdir, _BB_DIR_BIN, _BB_SUID_NEVER))
     273USE_RESIZE(APPLET(resize, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     274USE_RESTORECON(APPLET_ODDNAME(restorecon, setfiles, _BB_DIR_SBIN, _BB_SUID_NEVER, restorecon))
     275USE_RM(APPLET_NOFORK(rm, rm, _BB_DIR_BIN, _BB_SUID_NEVER, rm))
     276USE_RMDIR(APPLET_NOFORK(rmdir, rmdir, _BB_DIR_BIN, _BB_SUID_NEVER, rmdir))
    229277USE_RMMOD(APPLET(rmmod, _BB_DIR_SBIN, _BB_SUID_NEVER))
    230278USE_ROUTE(APPLET(route, _BB_DIR_SBIN, _BB_SUID_NEVER))
     
    232280USE_RPM2CPIO(APPLET(rpm2cpio, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    233281USE_RUN_PARTS(APPLET_ODDNAME(run-parts, run_parts, _BB_DIR_BIN, _BB_SUID_NEVER, run_parts))
     282USE_RUNCON(APPLET(runcon, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    234283USE_RUNLEVEL(APPLET(runlevel, _BB_DIR_SBIN, _BB_SUID_NEVER))
     284USE_RUNSV(APPLET(runsv, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     285USE_RUNSVDIR(APPLET(runsvdir, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    235286USE_RX(APPLET(rx, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    236287USE_SED(APPLET(sed, _BB_DIR_BIN, _BB_SUID_NEVER))
    237 USE_SEQ(APPLET(seq, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     288USE_SELINUXENABLED(APPLET(selinuxenabled, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     289USE_SEQ(APPLET_NOFORK(seq, seq, _BB_DIR_USR_BIN, _BB_SUID_NEVER, seq))
    238290USE_SETARCH(APPLET(setarch, _BB_DIR_BIN, _BB_SUID_NEVER))
    239291USE_SETCONSOLE(APPLET(setconsole, _BB_DIR_SBIN, _BB_SUID_NEVER))
     292USE_SETENFORCE(APPLET(setenforce, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     293USE_SETFILES(APPLET(setfiles, _BB_DIR_SBIN, _BB_SUID_NEVER))
    240294USE_SETKEYCODES(APPLET(setkeycodes, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    241295USE_SETLOGCONS(APPLET(setlogcons, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    242296USE_SETSID(APPLET(setsid, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     297USE_SETUIDGID(APPLET_ODDNAME(setuidgid, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, setuidgid))
    243298USE_FEATURE_SH_IS_ASH(APPLET_NOUSAGE(sh, ash, _BB_DIR_BIN, _BB_SUID_NEVER))
    244299USE_FEATURE_SH_IS_HUSH(APPLET_NOUSAGE(sh, hush, _BB_DIR_BIN, _BB_SUID_NEVER))
    245300USE_FEATURE_SH_IS_LASH(APPLET_NOUSAGE(sh, lash, _BB_DIR_BIN, _BB_SUID_NEVER))
    246301USE_FEATURE_SH_IS_MSH(APPLET_NOUSAGE(sh, msh, _BB_DIR_BIN, _BB_SUID_NEVER))
    247 USE_SHA1SUM(APPLET(sha1sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    248 USE_SLEEP(APPLET(sleep, _BB_DIR_BIN, _BB_SUID_NEVER))
    249 USE_SORT(APPLET(sort, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     302USE_SHA1SUM(APPLET_ODDNAME(sha1sum, md5_sha1_sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER, sha1sum))
     303USE_SLATTACH(APPLET(slattach, _BB_DIR_SBIN, _BB_SUID_NEVER))
     304USE_SLEEP(APPLET_NOFORK(sleep, sleep, _BB_DIR_BIN, _BB_SUID_NEVER, sleep))
     305USE_SOFTLIMIT(APPLET_ODDNAME(softlimit, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, softlimit))
     306USE_SORT(APPLET_NOEXEC(sort, sort, _BB_DIR_USR_BIN, _BB_SUID_NEVER, sort))
     307USE_SPLIT(APPLET(split, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    250308USE_START_STOP_DAEMON(APPLET_ODDNAME(start-stop-daemon, start_stop_daemon, _BB_DIR_SBIN, _BB_SUID_NEVER, start_stop_daemon))
    251309USE_STAT(APPLET(stat, _BB_DIR_BIN, _BB_SUID_NEVER))
     
    255313USE_SULOGIN(APPLET(sulogin, _BB_DIR_SBIN, _BB_SUID_NEVER))
    256314USE_SUM(APPLET(sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     315USE_SV(APPLET(sv, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     316USE_SVLOGD(APPLET(svlogd, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    257317USE_SWAPONOFF(APPLET_ODDNAME(swapoff, swap_on_off, _BB_DIR_SBIN, _BB_SUID_NEVER,swapoff))
    258318USE_SWAPONOFF(APPLET_ODDNAME(swapon, swap_on_off, _BB_DIR_SBIN, _BB_SUID_NEVER, swapon))
    259319USE_SWITCH_ROOT(APPLET(switch_root, _BB_DIR_SBIN, _BB_SUID_NEVER))
    260 USE_SYNC(APPLET(sync, _BB_DIR_BIN, _BB_SUID_NEVER))
     320USE_SYNC(APPLET_NOFORK(sync, sync, _BB_DIR_BIN, _BB_SUID_NEVER, sync))
    261321USE_BB_SYSCTL(APPLET(sysctl, _BB_DIR_SBIN, _BB_SUID_NEVER))
    262322USE_SYSLOGD(APPLET(syslogd, _BB_DIR_SBIN, _BB_SUID_NEVER))
    263323USE_TAIL(APPLET(tail, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    264324USE_TAR(APPLET(tar, _BB_DIR_BIN, _BB_SUID_NEVER))
     325USE_TASKSET(APPLET(taskset, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     326USE_TCPSVD(APPLET_ODDNAME(tcpsvd, tcpudpsvd, _BB_DIR_USR_BIN, _BB_SUID_NEVER, tcpsvd))
    265327USE_TEE(APPLET(tee, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    266328USE_TELNET(APPLET(telnet, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    267329USE_TELNETD(APPLET(telnetd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
    268 USE_TEST(APPLET(test, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     330USE_TEST(APPLET_NOEXEC(test, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER, test))
     331#if ENABLE_FEATURE_TFTP_GET || ENABLE_FEATURE_TFTP_PUT
    269332USE_TFTP(APPLET(tftp, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     333#endif
    270334USE_TIME(APPLET(time, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    271335USE_TOP(APPLET(top, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    272 USE_TOUCH(APPLET(touch, _BB_DIR_BIN, _BB_SUID_NEVER))
     336USE_TOUCH(APPLET_NOFORK(touch, touch, _BB_DIR_BIN, _BB_SUID_NEVER, touch))
    273337USE_TR(APPLET(tr, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    274338USE_TRACEROUTE(APPLET(traceroute, _BB_DIR_USR_BIN, _BB_SUID_MAYBE))
    275 USE_TRUE(APPLET(true, _BB_DIR_BIN, _BB_SUID_NEVER))
     339USE_TRUE(APPLET_NOFORK(true, true, _BB_DIR_BIN, _BB_SUID_NEVER, true))
    276340USE_TTY(APPLET(tty, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    277 USE_TUNE2FS(APPLET(tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
     341USE_TTYSIZE(APPLET(ttysize, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     342//USE_TUNE2FS(APPLET(tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER))
    278343USE_APP_UDHCPC(APPLET(udhcpc, _BB_DIR_SBIN, _BB_SUID_NEVER))
    279344USE_APP_UDHCPD(APPLET(udhcpd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER))
     345USE_UDPSVD(APPLET_ODDNAME(udpsvd, tcpudpsvd, _BB_DIR_USR_BIN, _BB_SUID_NEVER, udpsvd))
    280346USE_UMOUNT(APPLET(umount, _BB_DIR_BIN, _BB_SUID_NEVER))
    281347USE_UNAME(APPLET(uname, _BB_DIR_BIN, _BB_SUID_NEVER))
    282348USE_UNCOMPRESS(APPLET(uncompress, _BB_DIR_BIN, _BB_SUID_NEVER))
     349USE_UNEXPAND(APPLET_ODDNAME(unexpand, expand, _BB_DIR_USR_BIN, _BB_SUID_NEVER, unexpand))
    283350USE_UNIQ(APPLET(uniq, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    284351USE_UNIX2DOS(APPLET_ODDNAME(unix2dos, dos2unix, _BB_DIR_USR_BIN, _BB_SUID_NEVER, unix2dos))
     
    286353USE_UNZIP(APPLET(unzip, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    287354USE_UPTIME(APPLET(uptime, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    288 USE_USLEEP(APPLET(usleep, _BB_DIR_BIN, _BB_SUID_NEVER))
     355USE_USLEEP(APPLET_NOFORK(usleep, usleep, _BB_DIR_BIN, _BB_SUID_NEVER, usleep))
    289356USE_UUDECODE(APPLET(uudecode, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    290357USE_UUENCODE(APPLET(uuencode, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     
    298365USE_WHICH(APPLET(which, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    299366USE_WHO(APPLET(who, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    300 USE_WHOAMI(APPLET(whoami, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    301 USE_XARGS(APPLET(xargs, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
    302 USE_YES(APPLET(yes, _BB_DIR_USR_BIN, _BB_SUID_NEVER))
     367USE_WHOAMI(APPLET_NOFORK(whoami, whoami, _BB_DIR_USR_BIN, _BB_SUID_NEVER, whoami))
     368USE_XARGS(APPLET_NOEXEC(xargs, xargs, _BB_DIR_USR_BIN, _BB_SUID_NEVER, xargs))
     369USE_YES(APPLET_NOFORK(yes, yes, _BB_DIR_USR_BIN, _BB_SUID_NEVER, yes))
    303370USE_GUNZIP(APPLET_ODDNAME(zcat, gunzip, _BB_DIR_BIN, _BB_SUID_NEVER, zcat))
    304371USE_ZCIP(APPLET(zcip, _BB_DIR_SBIN, _BB_SUID_NEVER))
    305372
    306373#if !defined(PROTOTYPES) && !defined(MAKE_USAGE)
    307     { 0,NULL,0,0 }
     374    { NULL }
    308375};
    309 
    310 #endif
     376#endif
     377
     378#undef APPLET
     379#undef APPLET_NOUSAGE
     380#undef APPLET_ODDNAME
     381#undef APPLET_NOEXEC
     382#undef APPLET_NOFORK
  • branches/stable/mindi-busybox/include/busybox.h

    r821 r1770  
    88#define _BB_INTERNAL_H_    1
    99
    10 #include "bb_config.h"
    11 
    1210#include "libbb.h"
    1311
    14 /* order matters:  used as index into "install_dir[]" in busybox.c */
    15 enum Location {
     12#if ENABLE_FEATURE_INSTALLER
     13/* order matters: used as index into "install_dir[]" in busybox.c */
     14typedef enum bb_install_loc_t {
    1615    _BB_DIR_ROOT = 0,
    1716    _BB_DIR_BIN,
     
    1918    _BB_DIR_USR_BIN,
    2019    _BB_DIR_USR_SBIN
    21 };
     20} bb_install_loc_t;
     21#endif
    2222
    23 enum SUIDRoot {
     23#if ENABLE_FEATURE_SUID
     24typedef enum bb_suid_t {
    2425    _BB_SUID_NEVER = 0,
    2526    _BB_SUID_MAYBE,
    2627    _BB_SUID_ALWAYS
     28} bb_suid_t;
     29#endif
     30
     31struct bb_applet {
     32    const char *name;
     33    int (*main) (int argc, char **argv);
     34#if ENABLE_FEATURE_INSTALLER
     35    __extension__ enum bb_install_loc_t install_loc:8;
     36#endif
     37#if ENABLE_FEATURE_SUID
     38    __extension__ enum bb_suid_t need_suid:8;
     39#endif
     40#if ENABLE_FEATURE_PREFER_APPLETS
     41    /* true if instead of fork(); exec("applet"); waitpid();
     42     * one can do fork(); exit(applet_main(argc,argv)); waitpid(); */
     43    unsigned char noexec;
     44    /* Even nicer */
     45    /* true if instead of fork(); exec("applet"); waitpid();
     46     * one can simply call applet_main(argc,argv); */
     47    unsigned char nofork;
     48#endif
    2749};
    2850
    29 struct BB_applet {
    30     const char *name;
    31     int (*main) (int argc, char **argv);
    32     __extension__ enum Location location:4;
    33     __extension__ enum SUIDRoot need_suid:4;
    34 };
     51/* Defined in applet.c */
     52extern const struct bb_applet applets[];
     53extern const unsigned short NUM_APPLETS;
    3554
    36 /* From busybox.c */
    37 extern const struct BB_applet applets[];
    38 
    39 /* Automagically pull in all the applet function prototypes and
    40  * applet usage strings.  These are all of the form:
    41  *      extern int foo_main(int argc, char **argv);
    42  *      extern const char foo_usage[];
    43  * These are all autogenerated from the set of currently defined applets.
    44  */
    45 #define PROTOTYPES
    46 #include "applets.h"
    47 #undef PROTOTYPES
    48 
    49 #endif                          /* _BB_INTERNAL_H_ */
     55#endif  /* _BB_INTERNAL_H_ */
  • branches/stable/mindi-busybox/include/dump.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12#define F_IGNORE    0x01        /* %_A */
    23#define F_SETREP    0x02        /* rep count set, not default */
     
    4041
    4142extern void bb_dump_add(const char *fmt);
    42 extern int bb_dump_dump (char **argv);
     43extern int bb_dump_dump(char **argv);
    4344extern int bb_dump_size(FS * fs);
    4445
  • branches/stable/mindi-busybox/include/grp_.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12/* Copyright (C) 1991,92,95,96,97,98,99,2000,01 Free Software Foundation, Inc.
    23   This file is part of the GNU C Library.
     
    2122 */
    2223
     24#if !ENABLE_USE_BB_PWD_GRP
    2325
    24 #if !defined CONFIG_USE_BB_PWD_GRP
    2526#include <grp.h>
    2627
     
    2829
    2930#ifndef _GRP_H
    30 #define _GRP_H  1
     31#define _GRP_H 1
     32
     33/* The group structure.  */
     34struct group {
     35    char *gr_name;          /* Group name.  */
     36    char *gr_passwd;        /* Password.    */
     37    gid_t gr_gid;           /* Group ID.    */
     38    char **gr_mem;          /* Member list. */
     39};
     40
     41/* We don't reimplement this, just supplying prototype */
     42/* The function itself is in libc */
     43/* Set the group set for the current user to GROUPS (N of them).  */
     44extern int setgroups(size_t __n, __const gid_t *__groups);
    3145
    3246
    33 #include <sys/types.h>
    34 #include <features.h>
    35 #include <stdio.h>
     47#define setgrent     bb_internal_setgrent
     48#define endgrent     bb_internal_endgrent
     49#define getgrent     bb_internal_getgrent
     50#define fgetgrent    bb_internal_fgetgrent
     51#define putgrent     bb_internal_putgrent
     52#define getgrgid     bb_internal_getgrgid
     53#define getgrnam     bb_internal_getgrnam
     54#define getgrent_r   bb_internal_getgrent_r
     55#define getgrgid_r   bb_internal_getgrgid_r
     56#define getgrnam_r   bb_internal_getgrnam_r
     57#define fgetgrent_r  bb_internal_fgetgrent_r
     58#define getgrouplist bb_internal_getgrouplist
     59#define initgroups   bb_internal_initgroups
    3660
    3761
    38 /* The group structure.  */
    39 struct group
    40 {
    41     char *gr_name;      /* Group name.  */
    42     char *gr_passwd;        /* Password.    */
    43     gid_t gr_gid;       /* Group ID.    */
    44     char **gr_mem;      /* Member list. */
    45 };
     62/* All function names below should be remapped by #defines above
     63 * in order to not collide with libc names.
     64 * In theory it isn't necessary, but I saw weird interactions at link time.
     65 * Let's play safe */
    4666
    4767
    4868/* Rewind the group-file stream.  */
    49 extern void setgrent (void);
     69extern void setgrent(void);
    5070
    5171/* Close the group-file stream.  */
    52 extern void endgrent (void);
     72extern void endgrent(void);
    5373
    5474/* Read an entry from the group-file stream, opening it if necessary.  */
    55 extern struct group *getgrent (void);
     75extern struct group *getgrent(void);
    5676
    5777/* Read a group entry from STREAM.  */
    58 extern struct group *fgetgrent (FILE *__stream);
     78extern struct group *fgetgrent(FILE *__stream);
    5979
    6080/* Write the given entry onto the given stream.  */
    61 extern int putgrent (__const struct group *__restrict __p,
     81extern int putgrent(__const struct group *__restrict __p,
    6282             FILE *__restrict __f);
    6383
    6484/* Search for an entry with a matching group ID.  */
    65 extern struct group *getgrgid (gid_t __gid);
     85extern struct group *getgrgid(gid_t __gid);
    6686
    6787/* Search for an entry with a matching group name.  */
    68 extern struct group *getgrnam (__const char *__name);
     88extern struct group *getgrnam(__const char *__name);
    6989
    7090/* Reentrant versions of some of the functions above.
     
    7696   POSIX people would choose.  */
    7797
    78 extern int getgrent_r (struct group *__restrict __resultbuf,
     98extern int getgrent_r(struct group *__restrict __resultbuf,
    7999               char *__restrict __buffer, size_t __buflen,
    80100               struct group **__restrict __result);
    81101
    82102/* Search for an entry with a matching group ID.  */
    83 extern int getgrgid_r (gid_t __gid, struct group *__restrict __resultbuf,
     103extern int getgrgid_r(gid_t __gid, struct group *__restrict __resultbuf,
    84104               char *__restrict __buffer, size_t __buflen,
    85105               struct group **__restrict __result);
    86106
    87107/* Search for an entry with a matching group name.  */
    88 extern int getgrnam_r (__const char *__restrict __name,
     108extern int getgrnam_r(__const char *__restrict __name,
    89109               struct group *__restrict __resultbuf,
    90110               char *__restrict __buffer, size_t __buflen,
     
    93113/* Read a group entry from STREAM.  This function is not standardized
    94114   an probably never will.  */
    95 extern int fgetgrent_r (FILE *__restrict __stream,
     115extern int fgetgrent_r(FILE *__restrict __stream,
    96116            struct group *__restrict __resultbuf,
    97117            char *__restrict __buffer, size_t __buflen,
    98118            struct group **__restrict __result);
    99119
    100 /* Set the group set for the current user to GROUPS (N of them).  */
    101 extern int setgroups (size_t __n, __const gid_t *__groups);
    102 
    103120/* Store at most *NGROUPS members of the group set for USER into
    104121   *GROUPS.  Also include GROUP.  The actual number of groups found is
    105122   returned in *NGROUPS.  Return -1 if the if *NGROUPS is too small.  */
    106 extern int getgrouplist (__const char *__user, gid_t __group,
     123extern int getgrouplist(__const char *__user, gid_t __group,
    107124             gid_t *__groups, int *__ngroups);
    108125
     
    110127   by reading the group database and using all groups
    111128   of which USER is a member.  Also include GROUP.  */
    112 extern int initgroups (__const char *__user, gid_t __group);
     129extern int initgroups(__const char *__user, gid_t __group);
    113130
    114131
  • branches/stable/mindi-busybox/include/inet_common.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12/*
    23 * stolen from net-tools-1.59 and stripped down for busybox by
     
    56 * Heavily modified by Manuel Novoa III       Mar 12, 2001
    67 *
    7  * Version:     $Id: inet_common.h,v 1.4 2004/03/10 07:42:37 mjn3 Exp $
    8  *
    98 */
    109
    11 #include <features.h>
    12 #include <sys/types.h>
    13 #include <sys/socket.h>
    1410#include "platform.h"
    15 
    16 
    17 extern const char bb_INET_default[];    /* = "default" */
    1811
    1912/* hostfirst!=0 If we expect this to be a hostname,
    2013   try hostname database first
    2114 */
    22 extern int INET_resolve(const char *name, struct sockaddr_in *s_in, int hostfirst);
     15int INET_resolve(const char *name, struct sockaddr_in *s_in, int hostfirst);
    2316
    24 
    25 /* numeric: & 0x8000: default instead of *,
     17/* numeric: & 0x8000: "default" instead of "*",
    2618 *          & 0x4000: host instead of net,
    2719 *          & 0x0fff: don't resolve
    2820 */
    29 extern int INET_rresolve(char *name, size_t len, struct sockaddr_in *s_in,
    30              int numeric, unsigned int netmask);
    3121
    32 extern int INET6_resolve(const char *name, struct sockaddr_in6 *sin6);
    33 extern int INET6_rresolve(char *name, size_t len, struct sockaddr_in6 *sin6, int numeric);
     22int INET6_resolve(const char *name, struct sockaddr_in6 *sin6);
     23
     24/* These return malloced string */
     25char *INET_rresolve(struct sockaddr_in *s_in, int numeric, uint32_t netmask);
     26char *INET6_rresolve(struct sockaddr_in6 *sin6, int numeric);
  • branches/stable/mindi-busybox/include/libbb.h

    r821 r1770  
    33 * Busybox main internal header file
    44 *
    5  * Licensed under the GPL v2 or later, see the file LICENSE in this tarball.
    6  *
    75 * Based in part on code from sash, Copyright (c) 1999 by David I. Bell
    86 * Permission has been granted to redistribute this code under the GPL.
    97 *
     8 * Licensed under the GPL version 2, see the file LICENSE in this tarball.
    109 */
    1110#ifndef __LIBBUSYBOX_H__
    1211#define __LIBBUSYBOX_H__    1
    1312
    14 #include "bb_config.h"
    1513#include "platform.h"
    1614
    1715#include <ctype.h>
    1816#include <dirent.h>
     17#include <errno.h>
    1918#include <fcntl.h>
    2019#include <inttypes.h>
     20#include <mntent.h>
    2121#include <netdb.h>
     22#include <setjmp.h>
     23#include <signal.h>
    2224#include <stdio.h>
    2325#include <stdlib.h>
    2426#include <stdarg.h>
     27#include <stddef.h>
    2528#include <string.h>
    26 #include <strings.h>
     29/* #include <strings.h> - said to be obsolete */
     30#include <sys/ioctl.h>
     31#include <sys/mman.h>
    2732#include <sys/socket.h>
    2833#include <sys/stat.h>
     34#include <sys/statfs.h>
    2935#include <sys/time.h>
    3036#include <sys/types.h>
     37#include <sys/wait.h>
    3138#include <termios.h>
     39#include <time.h>
    3240#include <unistd.h>
    33 
    34 #ifdef CONFIG_SELINUX
     41#include <utime.h>
     42
     43#if ENABLE_SELINUX
    3544#include <selinux/selinux.h>
     45#include <selinux/context.h>
     46#endif
     47
     48#if ENABLE_LOCALE_SUPPORT
     49#include <locale.h>
     50#else
     51#define setlocale(x,y) ((void)0)
    3652#endif
    3753
    3854#include "pwd_.h"
    3955#include "grp_.h"
    40 #ifdef CONFIG_FEATURE_SHADOWPASSWDS
     56/* ifdef it out, because it may include <shadow.h> */
     57/* and we may not even _have_ <shadow.h>! */
     58#if ENABLE_FEATURE_SHADOWPASSWDS
    4159#include "shadow_.h"
    42 #endif
    43 #ifdef CONFIG_FEATURE_SHA1_PASSWORDS
    44 # include "sha1.h"
    4560#endif
    4661
     
    4964#include <sys/param.h>
    5065#ifndef PATH_MAX
    51 #define  PATH_MAX         256
    52 #endif
    53 
    54 #ifdef DMALLOC
    55 #include <dmalloc.h>
    56 #endif
     66#define PATH_MAX 256
     67#endif
     68
     69/* Tested to work correctly (IIRC :]) */
     70#define MAXINT(T) (T)( \
     71    ((T)-1) > 0 \
     72    ? (T)-1 \
     73    : (T)~((T)1 << (sizeof(T)*8-1)) \
     74    )
     75
     76#define MININT(T) (T)( \
     77    ((T)-1) > 0 \
     78    ? (T)0 \
     79    : ((T)1 << (sizeof(T)*8-1)) \
     80    )
     81
     82/* Large file support */
     83/* Note that CONFIG_LFS forces bbox to be built with all common ops
     84 * (stat, lseek etc) mapped to "largefile" variants by libc.
     85 * Practically it means that open() automatically has O_LARGEFILE added
     86 * and all filesize/file_offset parameters and struct members are "large"
     87 * (in today's world - signed 64bit). For full support of large files,
     88 * we need a few helper #defines (below) and careful use of off_t
     89 * instead of int/ssize_t. No lseek64(), O_LARGEFILE etc necessary */
     90#if ENABLE_LFS
     91/* CONFIG_LFS is on */
     92# if ULONG_MAX > 0xffffffff
     93/* "long" is long enough on this system */
     94#  define XATOOFF(a) xatoul_range(a, 0, LONG_MAX)
     95/* usage: sz = BB_STRTOOFF(s, NULL, 10); if (errno || sz < 0) die(); */
     96#  define BB_STRTOOFF bb_strtoul
     97#  define STRTOOFF strtoul
     98/* usage: printf("size: %"OFF_FMT"d (%"OFF_FMT"x)\n", sz, sz); */
     99#  define OFF_FMT "l"
     100# else
     101/* "long" is too short, need "long long" */
     102#  define XATOOFF(a) xatoull_range(a, 0, LLONG_MAX)
     103#  define BB_STRTOOFF bb_strtoull
     104#  define STRTOOFF strtoull
     105#  define OFF_FMT "ll"
     106# endif
     107#else
     108/* CONFIG_LFS is off */
     109# if UINT_MAX == 0xffffffff
     110/* While sizeof(off_t) == sizeof(int), off_t is typedef'ed to long anyway.
     111 * gcc will throw warnings on printf("%d", off_t). Crap... */
     112#  define XATOOFF(a) xatoi_u(a)
     113#  define BB_STRTOOFF bb_strtou
     114#  define STRTOOFF strtol
     115#  define OFF_FMT "l"
     116# else
     117#  define XATOOFF(a) xatoul_range(a, 0, LONG_MAX)
     118#  define BB_STRTOOFF bb_strtoul
     119#  define STRTOOFF strtol
     120#  define OFF_FMT "l"
     121# endif
     122#endif
     123/* scary. better ideas? (but do *test* them first!) */
     124#define OFF_T_MAX  ((off_t)~((off_t)1 << (sizeof(off_t)*8-1)))
    57125
    58126/* Some useful definitions */
     
    81149
    82150/* buffer allocation schemes */
    83 #ifdef CONFIG_FEATURE_BUFFERS_GO_ON_STACK
    84 #define RESERVE_CONFIG_BUFFER(buffer,len)           char buffer[len]
     151#if ENABLE_FEATURE_BUFFERS_GO_ON_STACK
     152#define RESERVE_CONFIG_BUFFER(buffer,len)  char buffer[len]
    85153#define RESERVE_CONFIG_UBUFFER(buffer,len) unsigned char buffer[len]
    86154#define RELEASE_CONFIG_BUFFER(buffer)      ((void)0)
    87155#else
    88 #ifdef CONFIG_FEATURE_BUFFERS_GO_IN_BSS
     156#if ENABLE_FEATURE_BUFFERS_GO_IN_BSS
    89157#define RESERVE_CONFIG_BUFFER(buffer,len)  static          char buffer[len]
    90158#define RESERVE_CONFIG_UBUFFER(buffer,len) static unsigned char buffer[len]
    91159#define RELEASE_CONFIG_BUFFER(buffer)      ((void)0)
    92160#else
    93 #define RESERVE_CONFIG_BUFFER(buffer,len)           char *buffer=xmalloc(len)
    94 #define RESERVE_CONFIG_UBUFFER(buffer,len) unsigned char *buffer=xmalloc(len)
    95 #define RELEASE_CONFIG_BUFFER(buffer)      free (buffer)
    96 #endif
    97 #endif
    98 
    99 
    100 typedef struct llist_s {
    101     char *data;
    102     struct llist_s *link;
    103 } llist_t;
    104 extern void llist_add_to(llist_t **old_head, void *data);
    105 extern void llist_add_to_end(llist_t **list_head, void *data);
    106 extern void *llist_pop(llist_t **elm);
    107 extern void llist_free(llist_t *elm, void (*freeit)(void *data));
    108 
    109 
    110 extern void bb_show_usage(void) ATTRIBUTE_NORETURN ATTRIBUTE_EXTERNALLY_VISIBLE;
    111 extern void bb_error_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
    112 extern void bb_error_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
    113 extern void bb_perror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
    114 extern void bb_perror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
    115 extern void bb_vherror_msg(const char *s, va_list p);
    116 extern void bb_herror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
    117 extern void bb_herror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
    118 
    119 extern void bb_perror_nomsg_and_die(void) ATTRIBUTE_NORETURN;
    120 extern void bb_perror_nomsg(void);
    121 
    122 /* These two are used internally -- you shouldn't need to use them */
    123 extern void bb_verror_msg(const char *s, va_list p) __attribute__ ((format (printf, 1, 0)));
    124 extern void bb_vperror_msg(const char *s, va_list p)  __attribute__ ((format (printf, 1, 0)));
    125 
    126 extern int bb_echo(int argc, char** argv);
    127 extern int bb_test(int argc, char** argv);
    128 
    129 extern const char *bb_mode_string(int mode);
    130 extern int is_directory(const char *name, int followLinks, struct stat *statBuf);
    131 extern DIR *bb_opendir(const char *path);
    132 extern DIR *bb_xopendir(const char *path);
    133 
    134 extern int remove_file(const char *path, int flags);
    135 extern int copy_file(const char *source, const char *dest, int flags);
    136 extern ssize_t safe_read(int fd, void *buf, size_t count);
    137 extern ssize_t bb_full_read(int fd, void *buf, size_t len);
    138 extern ssize_t safe_write(int fd, const void *buf, size_t count);
    139 extern ssize_t bb_full_write(int fd, const void *buf, size_t len);
    140 extern int recursive_action(const char *fileName, int recurse,
    141       int followLinks, int depthFirst,
    142       int (*fileAction) (const char *fileName, struct stat* statbuf, void* userData),
    143       int (*dirAction) (const char *fileName, struct stat* statbuf, void* userData),
    144       void* userData);
    145 
    146 extern int bb_parse_mode( const char* s, mode_t* theMode);
    147 extern long bb_xgetlarg(const char *arg, int base, long lower, long upper);
    148 
    149 extern unsigned int tty_baud_to_value(speed_t speed);
    150 extern speed_t tty_value_to_baud(unsigned int value);
    151 
    152 extern int get_linux_version_code(void);
    153 
    154 extern int get_console_fd(void);
    155 extern struct mntent *find_mount_point(const char *name, const char *table);
    156 extern void erase_mtab(const char * name);
    157 extern long *find_pid_by_name( const char* pidName);
    158 extern long *pidlist_reverse(long *pidList);
    159 extern char *find_block_device(char *path);
    160 extern char *bb_get_line_from_file(FILE *file);
    161 extern char *bb_get_chomped_line_from_file(FILE *file);
    162 extern char *bb_get_chunk_from_file(FILE *file, int *end);
    163 extern int bb_copyfd_size(int fd1, int fd2, const off_t size);
    164 extern int bb_copyfd_eof(int fd1, int fd2);
    165 extern void  bb_xprint_and_close_file(FILE *file);
    166 extern int   bb_xprint_file_by_name(const char *filename);
    167 extern char  bb_process_escape_sequence(const char **ptr);
    168 extern char *bb_get_last_path_component(char *path);
    169 extern FILE *bb_wfopen(const char *path, const char *mode);
    170 extern FILE *bb_wfopen_input(const char *filename);
    171 extern FILE *bb_xfopen(const char *path, const char *mode);
    172 
    173 extern int   bb_fclose_nonstdin(FILE *f);
    174 extern void  bb_fflush_stdout_and_exit(int retval) ATTRIBUTE_NORETURN;
    175 
    176 extern void xstat(const char *filename, struct stat *buf);
    177 extern int  bb_xsocket(int domain, int type, int protocol);
    178 extern pid_t bb_spawn(char **argv);
    179 extern pid_t bb_xspawn(char **argv);
    180 extern int wait4pid(int pid);
    181 extern void bb_xdaemon(int nochdir, int noclose);
    182 extern void bb_xbind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);
    183 extern void bb_xlisten(int s, int backlog);
    184 extern void bb_xchdir(const char *path);
    185 extern void xsetgid(gid_t gid);
    186 extern void xsetuid(uid_t uid);
    187 
    188 #define BB_GETOPT_ERROR 0x80000000UL
    189 extern const char *bb_opt_complementally;
    190 extern const struct option *bb_applet_long_options;
    191 extern unsigned long bb_getopt_ulflags(int argc, char **argv, const char *applet_opts, ...);
    192 
    193 extern int bb_vfprintf(FILE * __restrict stream, const char * __restrict format,
    194                        va_list arg) __attribute__ ((format (printf, 2, 0)));
    195 extern int bb_vprintf(const char * __restrict format, va_list arg)
    196     __attribute__ ((format (printf, 1, 0)));
    197 extern int bb_fprintf(FILE * __restrict stream, const char * __restrict format, ...)
    198     __attribute__ ((format (printf, 2, 3)));
    199 extern int bb_printf(const char * __restrict format, ...)
    200     __attribute__ ((format (printf, 1, 2)));
    201 
    202 //#warning rename to xferror_filename?
    203 extern void bb_xferror(FILE *fp, const char *fn);
    204 extern void bb_xferror_stdout(void);
    205 extern void bb_xfflush_stdout(void);
    206 
    207 extern void bb_warn_ignoring_args(int n);
    208 
    209 extern void chomp(char *s);
    210 extern void trim(char *s);
    211 extern char *skip_whitespace(const char *);
    212 
    213 extern struct BB_applet *find_applet_by_name(const char *name);
    214 void run_applet_by_name(const char *name, int argc, char **argv);
    215 
    216 /* dmalloc will redefine these to it's own implementation. It is safe
    217  * to have the prototypes here unconditionally.  */
    218 extern void *xmalloc(size_t size);
    219 extern void *xrealloc(void *old, size_t size);
    220 extern void *xzalloc(size_t size);
    221 extern void *xcalloc(size_t nmemb, size_t size);
    222 
    223 extern char *bb_xstrdup (const char *s);
    224 extern char *bb_xstrndup (const char *s, int n);
    225 extern char *safe_strncpy(char *dst, const char *src, size_t size);
    226 extern int safe_strtoi(char *arg, int* value);
    227 extern int safe_strtod(char *arg, double* value);
    228 extern int safe_strtol(char *arg, long* value);
    229 extern int safe_strtoul(char *arg, unsigned long* value);
    230 
    231 struct suffix_mult {
    232     const char *suffix;
    233     unsigned int mult;
    234 };
    235 
    236 extern unsigned long bb_xgetularg_bnd_sfx(const char *arg, int base,
    237                                           unsigned long lower,
    238                                           unsigned long upper,
    239                                           const struct suffix_mult *suffixes);
    240 extern unsigned long bb_xgetularg_bnd(const char *arg, int base,
    241                                       unsigned long lower,
    242                                       unsigned long upper);
    243 extern unsigned long bb_xgetularg10_bnd(const char *arg,
    244                                         unsigned long lower,
    245                                         unsigned long upper);
    246 extern unsigned long bb_xgetularg10(const char *arg);
    247 
    248 extern long bb_xgetlarg_bnd_sfx(const char *arg, int base,
    249                                 long lower,
    250                                 long upper,
    251                                 const struct suffix_mult *suffixes);
    252 extern long bb_xgetlarg10_sfx(const char *arg, const struct suffix_mult *suffixes);
    253 
    254 
    255 //#warning pitchable now?
    256 extern unsigned long bb_xparse_number(const char *numstr,
    257         const struct suffix_mult *suffixes);
    258 
    259 
    260 /* These parse entries in /etc/passwd and /etc/group.  This is desirable
    261  * for BusyBox since we want to avoid using the glibc NSS stuff, which
    262  * increases target size and is often not needed on embedded systems.  */
    263 extern long bb_xgetpwnam(const char *name);
    264 extern long bb_xgetgrnam(const char *name);
    265 extern char * bb_getug(char *buffer, char *idname, long id, int bufsize, char prefix);
    266 extern char * bb_getpwuid(char *name, long uid, int bufsize);
    267 extern char * bb_getgrgid(char *group, long gid, int bufsize);
    268 extern char *bb_askpass(int timeout, const char * prompt);
    269 
    270 extern int device_open(const char *device, int mode);
    271 
    272 extern char *query_loop(const char *device);
    273 extern int del_loop(const char *device);
    274 extern int set_loop(char **device, const char *file, int offset);
    275 
    276 #if (__GLIBC__ < 2)
    277 extern int vdprintf(int d, const char *format, va_list ap);
    278 #endif
    279 
    280 int nfsmount(const char *spec, const char *node, int *flags,
    281          char **mount_opts, int running_bg);
    282 
     161#define RESERVE_CONFIG_BUFFER(buffer,len)  char *buffer = xmalloc(len)
     162#define RESERVE_CONFIG_UBUFFER(buffer,len) unsigned char *buffer = xmalloc(len)
     163#define RELEASE_CONFIG_BUFFER(buffer)      free(buffer)
     164#endif
     165#endif
     166
     167
     168#if defined(__GLIBC__)
     169/* glibc uses __errno_location() to get a ptr to errno */
     170/* We can just memorize it once - no multithreading in busybox :) */
     171extern int *const bb_errno;
     172#undef errno
     173#define errno (*bb_errno)
     174#endif
     175
     176#if defined(__GLIBC__) && __GLIBC__ < 2
     177int vdprintf(int d, const char *format, va_list ap);
     178#endif
     179// This is declared here rather than #including <libgen.h> in order to avoid
     180// confusing the two versions of basename.  See the dirname/basename man page
     181// for details.
     182char *dirname(char *path);
    283183/* Include our own copy of struct sysinfo to avoid binary compatibility
    284184 * problems with Linux 2.4, which changed things.  Grumble, grumble. */
     
    299199    char _f[20-2*sizeof(long)-sizeof(int)]; /* Padding: libc5 uses this.. */
    300200};
    301 extern int sysinfo (struct sysinfo* info);
    302 
     201int sysinfo(struct sysinfo* info);
     202
     203unsigned long long monotonic_us(void);
     204unsigned monotonic_sec(void);
     205
     206extern void chomp(char *s);
     207extern void trim(char *s);
     208extern char *skip_whitespace(const char *);
     209extern char *skip_non_whitespace(const char *);
     210
     211//TODO: supply a pointer to char[11] buffer (avoid statics)?
     212extern const char *bb_mode_string(mode_t mode);
     213extern int is_directory(const char *name, int followLinks, struct stat *statBuf);
     214extern int remove_file(const char *path, int flags);
     215extern int copy_file(const char *source, const char *dest, int flags);
    303216enum {
    304     KILOBYTE = 1024,
    305     MEGABYTE = (KILOBYTE*1024),
    306     GIGABYTE = (MEGABYTE*1024)
    307 };
     217    ACTION_RECURSE        = (1 << 0),
     218    ACTION_FOLLOWLINKS    = (1 << 1),
     219    ACTION_FOLLOWLINKS_L0 = (1 << 2),
     220    ACTION_DEPTHFIRST     = (1 << 3),
     221    /*ACTION_REVERSE      = (1 << 4), - unused */
     222};
     223extern int recursive_action(const char *fileName, unsigned flags,
     224    int (*fileAction) (const char *fileName, struct stat* statbuf, void* userData, int depth),
     225    int (*dirAction) (const char *fileName, struct stat* statbuf, void* userData, int depth),
     226    void* userData, unsigned depth);
     227extern int device_open(const char *device, int mode);
     228extern int get_console_fd(void);
     229extern char *find_block_device(const char *path);
     230/* bb_copyfd_XX print read/write errors and return -1 if they occur */
     231extern off_t bb_copyfd_eof(int fd1, int fd2);
     232extern off_t bb_copyfd_size(int fd1, int fd2, off_t size);
     233extern void bb_copyfd_exact_size(int fd1, int fd2, off_t size);
     234/* "short" copy can be detected by return value < size */
     235/* this helper yells "short read!" if param is not -1 */
     236extern void complain_copyfd_and_die(off_t sz) ATTRIBUTE_NORETURN;
     237extern char bb_process_escape_sequence(const char **ptr);
     238/* TODO: sometimes modifies its parameter, which
     239 * makes it rather inconvenient at times: */
     240extern char *bb_get_last_path_component(char *path);
     241
     242int ndelay_on(int fd);
     243int ndelay_off(int fd);
     244void xdup2(int, int);
     245void xmove_fd(int, int);
     246
     247
     248DIR *xopendir(const char *path);
     249DIR *warn_opendir(const char *path);
     250
     251/* UNUSED: char *xmalloc_realpath(const char *path); */
     252char *xmalloc_readlink(const char *path);
     253char *xmalloc_readlink_or_warn(const char *path);
     254char *xrealloc_getcwd_or_warn(char *cwd);
     255
     256
     257//TODO: signal(sid, f) is the same? then why?
     258extern void sig_catch(int,void (*)(int));
     259//#define sig_ignore(s) (sig_catch((s), SIG_IGN))
     260//#define sig_uncatch(s) (sig_catch((s), SIG_DFL))
     261extern void sig_block(int);
     262extern void sig_unblock(int);
     263/* UNUSED: extern void sig_blocknone(void); */
     264extern void sig_pause(void);
     265
     266
     267void xsetgid(gid_t gid);
     268void xsetuid(uid_t uid);
     269void xchdir(const char *path);
     270void xsetenv(const char *key, const char *value);
     271void xunlink(const char *pathname);
     272void xstat(const char *pathname, struct stat *buf);
     273int xopen(const char *pathname, int flags);
     274int xopen3(const char *pathname, int flags, int mode);
     275int open_or_warn(const char *pathname, int flags);
     276int open3_or_warn(const char *pathname, int flags, int mode);
     277void xpipe(int filedes[2]);
     278off_t xlseek(int fd, off_t offset, int whence);
     279off_t fdlength(int fd);
     280
     281int xsocket(int domain, int type, int protocol);
     282void xbind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);
     283void xlisten(int s, int backlog);
     284void xconnect(int s, const struct sockaddr *s_addr, socklen_t addrlen);
     285ssize_t xsendto(int s, const void *buf, size_t len, const struct sockaddr *to,
     286                socklen_t tolen);
     287/* SO_REUSEADDR allows a server to rebind to an address that is already
     288 * "in use" by old connections to e.g. previous server instance which is
     289 * killed or crashed. Without it bind will fail until all such connections
     290 * time out. Linux does not allow multiple live binds on same ip:port
     291 * regardless of SO_REUSEADDR (unlike some other flavors of Unix).
     292 * Turn it on before you call bind(). */
     293void setsockopt_reuseaddr(int fd); /* On Linux this never fails. */
     294int setsockopt_broadcast(int fd);
     295/* NB: returns port in host byte order */
     296unsigned bb_lookup_port(const char *port, const char *protocol, unsigned default_port);
     297typedef struct len_and_sockaddr {
     298    socklen_t len;
     299    union {
     300        struct sockaddr sa;
     301        struct sockaddr_in sin;
     302#if ENABLE_FEATURE_IPV6
     303        struct sockaddr_in6 sin6;
     304#endif
     305    };
     306} len_and_sockaddr;
     307enum {
     308    LSA_SIZEOF_SA = sizeof(
     309        union {
     310            struct sockaddr sa;
     311            struct sockaddr_in sin;
     312#if ENABLE_FEATURE_IPV6
     313            struct sockaddr_in6 sin6;
     314#endif
     315        }
     316    )
     317};
     318/* Create stream socket, and allocate suitable lsa.
     319 * (lsa of correct size and lsa->sa.sa_family (AF_INET/AF_INET6))
     320 * af == AF_UNSPEC will result in trying to create IPv6 socket,
     321 * and if kernel doesn't support it, IPv4.
     322 */
     323int xsocket_type(len_and_sockaddr **lsap, USE_FEATURE_IPV6(int af,) int sock_type);
     324int xsocket_stream(len_and_sockaddr **lsap);
     325/* Create server socket bound to bindaddr:port. bindaddr can be NULL,
     326 * numeric IP ("N.N.N.N") or numeric IPv6 address,
     327 * and can have ":PORT" suffix (for IPv6 use "[X:X:...:X]:PORT").
     328 * Only if there is no suffix, port argument is used */
     329/* NB: these set SO_REUSEADDR before bind */
     330int create_and_bind_stream_or_die(const char *bindaddr, int port);
     331int create_and_bind_dgram_or_die(const char *bindaddr, int port);
     332/* Create client TCP socket connected to peer:port. Peer cannot be NULL.
     333 * Peer can be numeric IP ("N.N.N.N"), numeric IPv6 address or hostname,
     334 * and can have ":PORT" suffix (for IPv6 use "[X:X:...:X]:PORT").
     335 * If there is no suffix, port argument is used */
     336int create_and_connect_stream_or_die(const char *peer, int port);
     337/* Connect to peer identified by lsa */
     338int xconnect_stream(const len_and_sockaddr *lsa);
     339/* Return malloc'ed len_and_sockaddr with socket address of host:port
     340 * Currently will return IPv4 or IPv6 sockaddrs only
     341 * (depending on host), but in theory nothing prevents e.g.
     342 * UNIX socket address being returned, IPX sockaddr etc...
     343 * On error does bb_error_msg and returns NULL */
     344len_and_sockaddr* host2sockaddr(const char *host, int port);
     345/* Version which dies on error */
     346len_and_sockaddr* xhost2sockaddr(const char *host, int port);
     347len_and_sockaddr* xdotted2sockaddr(const char *host, int port);
     348#if ENABLE_FEATURE_IPV6
     349/* Same, useful if you want to force family (e.g. IPv6) */
     350len_and_sockaddr* host_and_af2sockaddr(const char *host, int port, sa_family_t af);
     351len_and_sockaddr* xhost_and_af2sockaddr(const char *host, int port, sa_family_t af);
     352#else
     353/* [we evaluate af: think about "host_and_af2sockaddr(..., af++)"] */
     354#define host_and_af2sockaddr(host, port, af) ((void)(af), host2sockaddr((host), (port)))
     355#define xhost_and_af2sockaddr(host, port, af) ((void)(af), xhost2sockaddr((host), (port)))
     356#endif
     357/* Assign sin[6]_port member if the socket is an AF_INET[6] one,
     358 * otherwise no-op. Useful for ftp.
     359 * NB: does NOT do htons() internally, just direct assignment. */
     360void set_nport(len_and_sockaddr *lsa, unsigned port);
     361/* Retrieve sin[6]_port or return -1 for non-INET[6] lsa's */
     362int get_nport(const struct sockaddr *sa);
     363/* Reverse DNS. Returns NULL on failure. */
     364char* xmalloc_sockaddr2host(const struct sockaddr *sa);
     365/* This one doesn't append :PORTNUM */
     366char* xmalloc_sockaddr2host_noport(const struct sockaddr *sa);
     367/* This one also doesn't fall back to dotted IP (returns NULL) */
     368char* xmalloc_sockaddr2hostonly_noport(const struct sockaddr *sa);
     369/* inet_[ap]ton on steroids */
     370char* xmalloc_sockaddr2dotted(const struct sockaddr *sa);
     371char* xmalloc_sockaddr2dotted_noport(const struct sockaddr *sa);
     372// "old" (ipv4 only) API
     373// users: traceroute.c hostname.c - use _list_ of all IPs
     374struct hostent *xgethostbyname(const char *name);
     375// Also mount.c and inetd.c are using gethostbyname(),
     376// + inet_common.c has additional IPv4-only stuff
     377
     378
     379void socket_want_pktinfo(int fd);
     380ssize_t send_to_from(int fd, void *buf, size_t len, int flags,
     381        const struct sockaddr *from, const struct sockaddr *to,
     382        socklen_t tolen);
     383ssize_t recv_from_to(int fd, void *buf, size_t len, int flags,
     384        struct sockaddr *from, struct sockaddr *to,
     385        socklen_t sa_size);
     386
     387
     388extern char *xstrdup(const char *s);
     389extern char *xstrndup(const char *s, int n);
     390extern char *safe_strncpy(char *dst, const char *src, size_t size);
     391extern char *xasprintf(const char *format, ...) __attribute__ ((format (printf, 1, 2)));
     392// gcc-4.1.1 still isn't good enough at optimizing it
     393// (+200 bytes compared to macro)
     394//static ALWAYS_INLINE
     395//int LONE_DASH(const char *s) { return s[0] == '-' && !s[1]; }
     396//static ALWAYS_INLINE
     397//int NOT_LONE_DASH(const char *s) { return s[0] != '-' || s[1]; }
     398#define LONE_DASH(s)     ((s)[0] == '-' && !(s)[1])
     399#define NOT_LONE_DASH(s) ((s)[0] != '-' || (s)[1])
     400#define LONE_CHAR(s,c)     ((s)[0] == (c) && !(s)[1])
     401#define NOT_LONE_CHAR(s,c) ((s)[0] != (c) || (s)[1])
     402#define DOT_OR_DOTDOT(s) ((s)[0] == '.' && (!(s)[1] || ((s)[1] == '.' && !(s)[2])))
     403
     404/* dmalloc will redefine these to it's own implementation. It is safe
     405 * to have the prototypes here unconditionally.  */
     406extern void *malloc_or_warn(size_t size);
     407extern void *xmalloc(size_t size);
     408extern void *xzalloc(size_t size);
     409extern void *xrealloc(void *old, size_t size);
     410
     411extern ssize_t safe_read(int fd, void *buf, size_t count);
     412extern ssize_t full_read(int fd, void *buf, size_t count);
     413extern void xread(int fd, void *buf, size_t count);
     414extern unsigned char xread_char(int fd);
     415// Read one line a-la fgets. Uses one read(), works only on seekable streams
     416extern char *reads(int fd, char *buf, size_t count);
     417// Read one line a-la fgets. Reads byte-by-byte.
     418// Useful when it is important to not read ahead.
     419extern char *xmalloc_reads(int fd, char *pfx);
     420extern ssize_t read_close(int fd, void *buf, size_t count);
     421extern ssize_t open_read_close(const char *filename, void *buf, size_t count);
     422extern void *xmalloc_open_read_close(const char *filename, size_t *sizep);
     423
     424extern ssize_t safe_write(int fd, const void *buf, size_t count);
     425extern ssize_t full_write(int fd, const void *buf, size_t count);
     426extern void xwrite(int fd, const void *buf, size_t count);
     427
     428/* Reads and prints to stdout till eof, then closes FILE. Exits on error: */
     429extern void xprint_and_close_file(FILE *file);
     430extern char *xmalloc_fgets(FILE *file);
     431/* Read up to (and including) TERMINATING_STRING: */
     432extern char *xmalloc_fgets_str(FILE *file, const char *terminating_string);
     433/* Chops off '\n' from the end, unlike fgets: */
     434extern char *xmalloc_getline(FILE *file);
     435extern char *bb_get_chunk_from_file(FILE *file, int *end);
     436extern void die_if_ferror(FILE *file, const char *msg);
     437extern void die_if_ferror_stdout(void);
     438extern void xfflush_stdout(void);
     439extern void fflush_stdout_and_exit(int retval) ATTRIBUTE_NORETURN;
     440extern int fclose_if_not_stdin(FILE *file);
     441extern FILE *xfopen(const char *filename, const char *mode);
     442/* Prints warning to stderr and returns NULL on failure: */
     443extern FILE *fopen_or_warn(const char *filename, const char *mode);
     444/* "Opens" stdin if filename is special, else just opens file: */
     445extern FILE *fopen_or_warn_stdin(const char *filename);
     446
     447/* Convert each alpha char in str to lower-case */
     448extern char* str_tolower(char *str);
     449
     450char *utoa(unsigned n);
     451char *itoa(int n);
     452/* Returns a pointer past the formatted number, does NOT null-terminate */
     453char *utoa_to_buf(unsigned n, char *buf, unsigned buflen);
     454char *itoa_to_buf(int n, char *buf, unsigned buflen);
     455void smart_ulltoa5(unsigned long long ul, char buf[5]);
     456//TODO: provide pointer to buf (avoid statics)?
    308457const char *make_human_readable_str(unsigned long long size,
    309458        unsigned long block_size, unsigned long display_unit);
    310 
     459/* Put a string of hex bytes ("1b2e66fe"...), return advanced pointer */
     460char *bin2hex(char *buf, const char *cp, int count);
     461
     462/* Last element is marked by mult == 0 */
     463struct suffix_mult {
     464    char suffix[4];
     465    unsigned mult;
     466};
     467#include "xatonum.h"
     468/* Specialized: */
     469/* Using xatoi() instead of naive atoi() is not always convenient -
     470 * in many places people want *non-negative* values, but store them
     471 * in signed int. Therefore we need this one:
     472 * dies if input is not in [0, INT_MAX] range. Also will reject '-0' etc */
     473int xatoi_u(const char *numstr);
     474/* Useful for reading port numbers */
     475uint16_t xatou16(const char *numstr);
     476
     477
     478/* These parse entries in /etc/passwd and /etc/group.  This is desirable
     479 * for BusyBox since we want to avoid using the glibc NSS stuff, which
     480 * increases target size and is often not needed on embedded systems.  */
     481long xuname2uid(const char *name);
     482long xgroup2gid(const char *name);
     483/* wrapper: allows string to contain numeric uid or gid */
     484unsigned long get_ug_id(const char *s, long (*xname2id)(const char *));
     485/* from chpst. Does not die, returns 0 on failure */
     486struct bb_uidgid_t {
     487    uid_t uid;
     488    gid_t gid;
     489};
     490/* always sets uid and gid */
     491int get_uidgid(struct bb_uidgid_t*, const char*, int numeric_ok);
     492/* chown-like handling of "user[:[group]" */
     493void parse_chown_usergroup_or_die(struct bb_uidgid_t *u, char *user_group);
     494/* bb_getpwuid, bb_getgrgid:
     495 * bb_getXXXid(buf, bufsz, id) - copy user/group name or id
     496 *              as a string to buf, return user/group name or NULL
     497 * bb_getXXXid(NULL, 0, id) - return user/group name or NULL
     498 * bb_getXXXid(NULL, -1, id) - return user/group name or exit
     499*/
     500char *bb_getpwuid(char *name, int bufsize, long uid);
     501char *bb_getgrgid(char *group, int bufsize, long gid);
     502/* versions which cache results (useful for ps, ls etc) */
     503const char* get_cached_username(uid_t uid);
     504const char* get_cached_groupname(gid_t gid);
     505void clear_username_cache(void);
     506/* internally usernames are saved in fixed-sized char[] buffers */
     507enum { USERNAME_MAX_SIZE = 16 - sizeof(int) };
     508
     509
     510struct bb_applet;
     511int execable_file(const char *name);
     512char *find_execable(const char *filename);
     513int exists_execable(const char *filename);
     514
     515#if ENABLE_FEATURE_PREFER_APPLETS
     516int bb_execvp(const char *file, char *const argv[]);
     517#define BB_EXECVP(prog,cmd) bb_execvp(prog,cmd)
     518#define BB_EXECLP(prog,cmd,...) \
     519    execlp((find_applet_by_name(prog)) ? CONFIG_BUSYBOX_EXEC_PATH : prog, \
     520        cmd, __VA_ARGS__)
     521#else
     522#define BB_EXECVP(prog,cmd)     execvp(prog,cmd)
     523#define BB_EXECLP(prog,cmd,...) execlp(prog,cmd, __VA_ARGS__)
     524#endif
     525
     526/* NOMMU friendy fork+exec */
     527pid_t spawn(char **argv);
     528pid_t xspawn(char **argv);
     529
     530/* Unlike waitpid, waits ONLY for one process,
     531 * It's safe to pass negative 'pids' from failed [v]fork -
     532 * wait4pid will return -1 (and will not clobber [v]fork's errno).
     533 * IOW: rc = wait4pid(spawn(argv));
     534 *      if (rc < 0) bb_perror_msg("%s", argv[0]);
     535 *      if (rc > 0) bb_error_msg("exit code: %d", rc);
     536 */
     537int wait4pid(int pid);
     538int wait_pid(int *wstat, int pid);
     539int wait_nohang(int *wstat);
     540#define wait_crashed(w) ((w) & 127)
     541#define wait_exitcode(w) ((w) >> 8)
     542#define wait_stopsig(w) ((w) >> 8)
     543#define wait_stopped(w) (((w) & 127) == 127)
     544/* wait4pid(spawn(argv)) + NOFORK/NOEXEC (if configured) */
     545int spawn_and_wait(char **argv);
     546struct nofork_save_area {
     547    jmp_buf die_jmp;
     548    const struct bb_applet *current_applet;
     549    int xfunc_error_retval;
     550    uint32_t option_mask32;
     551    int die_sleep;
     552    smallint saved;
     553};
     554void save_nofork_data(struct nofork_save_area *save);
     555void restore_nofork_data(struct nofork_save_area *save);
     556/* Does NOT check that applet is NOFORK, just blindly runs it */
     557int run_nofork_applet(const struct bb_applet *a, char **argv);
     558int run_nofork_applet_prime(struct nofork_save_area *old, const struct bb_applet *a, char **argv);
     559
     560/* Helpers for daemonization.
     561 *
     562 * bb_daemonize(flags) = daemonize, does not compile on NOMMU
     563 *
     564 * bb_daemonize_or_rexec(flags, argv) = daemonizes on MMU (and ignores argv),
     565 *      rexec's itself on NOMMU with argv passed as command line.
     566 * Thus bb_daemonize_or_rexec may cause your <applet>_main() to be re-executed
     567 * from the start. (It will detect it and not reexec again second time).
     568 * You have to audit carefully that you don't do something twice as a result
     569 * (opening files/sockets, parsing config files etc...)!
     570 *
     571 * Both of the above will redirect fd 0,1,2 to /dev/null and drop ctty
     572 * (will do setsid()).
     573 *
     574 * forkexit_or_rexec(argv) = bare-bones "fork + parent exits" on MMU,
     575 *      "vfork + re-exec ourself" on NOMMU. No fd redirection, no setsid().
     576 *      Currently used for openvt. On MMU ignores argv.
     577 *
     578 * Helper for network daemons in foreground mode:
     579 *
     580 * bb_sanitize_stdio() = make sure that fd 0,1,2 are opened by opening them
     581 * to /dev/null if they are not.
     582 */
     583enum {
     584    DAEMON_CHDIR_ROOT = 1,
     585    DAEMON_DEVNULL_STDIO = 2,
     586    DAEMON_CLOSE_EXTRA_FDS = 4,
     587    DAEMON_ONLY_SANITIZE = 8, /* internal use */
     588};
     589#if BB_MMU
     590  void forkexit_or_rexec(void);
     591  enum { re_execed = 0 };
     592# define forkexit_or_rexec(argv)            forkexit_or_rexec()
     593# define bb_daemonize_or_rexec(flags, argv) bb_daemonize_or_rexec(flags)
     594# define bb_daemonize(flags)                bb_daemonize_or_rexec(flags, bogus)
     595#else
     596  void re_exec(char **argv) ATTRIBUTE_NORETURN;
     597  void forkexit_or_rexec(char **argv);
     598  extern bool re_execed;
     599# define fork()          BUG_fork_is_unavailable_on_nommu()
     600# define daemon(a,b)     BUG_daemon_is_unavailable_on_nommu()
     601# define bb_daemonize(a) BUG_bb_daemonize_is_unavailable_on_nommu()
     602#endif
     603void bb_daemonize_or_rexec(int flags, char **argv);
     604void bb_sanitize_stdio(void);
     605
     606
     607extern const char *opt_complementary;
     608#if ENABLE_GETOPT_LONG
     609#define No_argument "\0"
     610#define Required_argument "\001"
     611#define Optional_argument "\002"
     612extern const char *applet_long_options;
     613#endif
     614extern uint32_t option_mask32;
     615extern uint32_t getopt32(char **argv, const char *applet_opts, ...);
     616
     617
     618typedef struct llist_t {
     619    char *data;
     620    struct llist_t *link;
     621} llist_t;
     622void llist_add_to(llist_t **old_head, void *data);
     623void llist_add_to_end(llist_t **list_head, void *data);
     624void *llist_pop(llist_t **elm);
     625void llist_unlink(llist_t **head, llist_t *elm);
     626void llist_free(llist_t *elm, void (*freeit)(void *data));
     627llist_t *llist_rev(llist_t *list);
     628/* BTW, surprisingly, changing API to
     629 *   llist_t *llist_add_to(llist_t *old_head, void *data)
     630 * etc does not result in smaller code... */
     631
     632/* start_stop_daemon and udhcpc are special - they want
     633 * to create pidfiles regardless of FEATURE_PIDFILE */
     634#if ENABLE_FEATURE_PIDFILE || defined(WANT_PIDFILE)
     635/* True only if we created pidfile which is *file*, not /dev/null etc */
     636extern smallint wrote_pidfile;
     637void write_pidfile(const char *path);
     638#define remove_pidfile(path) do { if (wrote_pidfile) unlink(path); } while (0)
     639#else
     640enum { wrote_pidfile = 0 };
     641#define write_pidfile(path)  ((void)0)
     642#define remove_pidfile(path) ((void)0)
     643#endif
     644
     645enum {
     646    LOGMODE_NONE = 0,
     647    LOGMODE_STDIO = (1 << 0),
     648    LOGMODE_SYSLOG = (1 << 1) * ENABLE_FEATURE_SYSLOG,
     649    LOGMODE_BOTH = LOGMODE_SYSLOG + LOGMODE_STDIO,
     650};
     651extern const char *msg_eol;
     652extern smallint logmode;
     653extern int die_sleep;
     654extern int xfunc_error_retval;
     655extern jmp_buf die_jmp;
     656extern void xfunc_die(void) ATTRIBUTE_NORETURN;
     657extern void bb_show_usage(void) ATTRIBUTE_NORETURN ATTRIBUTE_EXTERNALLY_VISIBLE;
     658extern void bb_error_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
     659extern void bb_error_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
     660extern void bb_perror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
     661extern void bb_perror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
     662extern void bb_herror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
     663extern void bb_herror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2)));
     664extern void bb_perror_nomsg_and_die(void) ATTRIBUTE_NORETURN;
     665extern void bb_perror_nomsg(void);
     666extern void bb_info_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2)));
     667extern void bb_verror_msg(const char *s, va_list p, const char *strerr);
     668
     669
     670/* applets which are useful from another applets */
     671int bb_cat(char** argv);
     672int bb_echo(char** argv);
     673int test_main(int argc, char** argv);
     674int kill_main(int argc, char **argv);
     675#if ENABLE_ROUTE
     676void bb_displayroutes(int noresolve, int netstatfmt);
     677#endif
     678int chown_main(int argc, char **argv);
     679#if ENABLE_GUNZIP
     680int gunzip_main(int argc, char **argv);
     681#endif
     682int bbunpack(char **argv,
     683    char* (*make_new_name)(char *filename),
     684    USE_DESKTOP(long long) int (*unpacker)(void)
     685);
     686
     687
     688/* Networking */
     689int create_icmp_socket(void);
     690int create_icmp6_socket(void);
     691/* interface.c */
     692/* This structure defines protocol families and their handlers. */
     693struct aftype {
     694    const char *name;
     695    const char *title;
     696    int af;
     697    int alen;
     698    char *(*print) (unsigned char *);
     699    const char *(*sprint) (struct sockaddr *, int numeric);
     700    int (*input) (/*int type,*/ const char *bufp, struct sockaddr *);
     701    void (*herror) (char *text);
     702    int (*rprint) (int options);
     703    int (*rinput) (int typ, int ext, char **argv);
     704
     705    /* may modify src */
     706    int (*getmask) (char *src, struct sockaddr * mask, char *name);
     707};
     708/* This structure defines hardware protocols and their handlers. */
     709struct hwtype {
     710    const char *name;
     711    const char *title;
     712    int type;
     713    int alen;
     714    char *(*print) (unsigned char *);
     715    int (*input) (const char *, struct sockaddr *);
     716    int (*activate) (int fd);
     717    int suppress_null_addr;
     718};
     719extern smallint interface_opt_a;
     720int display_interfaces(char *ifname);
     721const struct aftype *get_aftype(const char *name);
     722const struct hwtype *get_hwtype(const char *name);
     723const struct hwtype *get_hwntype(int type);
     724
     725
     726#ifndef BUILD_INDIVIDUAL
     727extern const struct bb_applet *find_applet_by_name(const char *name);
     728/* Returns only if applet is not found. */
     729extern void run_applet_and_exit(const char *name, char **argv);
     730extern void run_current_applet_and_exit(char **argv) ATTRIBUTE_NORETURN;
     731#endif
     732
     733extern int match_fstype(const struct mntent *mt, const char *fstypes);
     734extern struct mntent *find_mount_point(const char *name, const char *table);
     735extern void erase_mtab(const char * name);
     736extern unsigned int tty_baud_to_value(speed_t speed);
     737extern speed_t tty_value_to_baud(unsigned int value);
     738extern void bb_warn_ignoring_args(int n);
     739
     740extern int get_linux_version_code(void);
     741
     742extern char *query_loop(const char *device);
     743extern int del_loop(const char *device);
     744/* If *devname is not NULL, use that name, otherwise try to find free one,
     745 * malloc and return it in *devname.
     746 * return value: 1: read-only loopdev was setup, 0: rw, < 0: error */
     747extern int set_loop(char **devname, const char *file, unsigned long long offset);
     748
     749
     750//TODO: pass buf pointer or return allocated buf (avoid statics)?
     751char *bb_askpass(int timeout, const char * prompt);
    311752int bb_ask_confirmation(void);
    312753int klogctl(int type, char * b, int len);
    313754
    314 char *xgetcwd(char *cwd);
    315 char *xreadlink(const char *path);
     755extern int bb_parse_mode(const char* s, mode_t* theMode);
     756
    316757char *concat_path_file(const char *path, const char *filename);
    317758char *concat_subpath_file(const char *path, const char *filename);
     759const char *bb_basename(const char *name);
     760/* NB: can violate const-ness (similarly to strchr) */
    318761char *last_char_is(const char *s, int c);
    319762
    320 int read_package_field(const char *package_buffer, char **field_name, char **field_value);
    321 //#warning yuk!
    322 char *fgets_str(FILE *file, const char *terminating_string);
    323 
    324 extern int uncompress(int fd_in, int fd_out);
    325 extern int inflate(int in, int out);
    326 
    327 extern struct hostent *xgethostbyname(const char *name);
    328 extern struct hostent *xgethostbyname2(const char *name, int af);
    329 extern int create_icmp_socket(void);
    330 extern int create_icmp6_socket(void);
    331 extern int xconnect(struct sockaddr_in *s_addr);
    332 extern unsigned short bb_lookup_port(const char *port, const char *protocol, unsigned short default_port);
    333 extern void bb_lookup_host(struct sockaddr_in *s_in, const char *host);
    334 
    335 //#warning wrap this?
    336 char *dirname (char *path);
    337 
    338 int bb_make_directory (char *path, long mode, int flags);
    339 
    340 const char *u_signal_names(const char *str_sig, int *signo, int startnum);
     763
     764USE_DESKTOP(long long) int uncompress(int fd_in, int fd_out);
     765int inflate(int in, int out);
     766
     767
     768int bb_make_directory(char *path, long mode, int flags);
     769
     770int get_signum(const char *name);
     771const char *get_signame(int number);
     772
    341773char *bb_simplify_path(const char *path);
    342774
    343 enum {  /* DO NOT CHANGE THESE VALUES!  cp.c depends on them. */
     775#define FAIL_DELAY 3
     776extern void bb_do_delay(int seconds);
     777extern void change_identity(const struct passwd *pw);
     778extern const char *change_identity_e2str(const struct passwd *pw);
     779extern void run_shell(const char *shell, int loginshell, const char *command, const char **additional_args);
     780#if ENABLE_SELINUX
     781extern void renew_current_security_context(void);
     782extern void set_current_security_context(security_context_t sid);
     783extern context_t set_security_context_component(security_context_t cur_context,
     784                        char *user, char *role, char *type, char *range);
     785extern void setfscreatecon_or_die(security_context_t scontext);
     786#endif
     787extern void selinux_or_die(void);
     788extern int restricted_shell(const char *shell);
     789extern void setup_environment(const char *shell, int loginshell, int changeenv, const struct passwd *pw);
     790extern int correct_password(const struct passwd *pw);
     791/* Returns a ptr to static storage */
     792extern char *pw_encrypt(const char *clear, const char *salt);
     793extern int obscure(const char *old, const char *newval, const struct passwd *pwdp);
     794extern int index_in_str_array(const char *const string_array[], const char *key);
     795extern int index_in_strings(const char *strings, const char *key);
     796extern int index_in_substr_array(const char *const string_array[], const char *key);
     797extern int index_in_substrings(const char *strings, const char *key);
     798extern void print_login_issue(const char *issue_file, const char *tty);
     799extern void print_login_prompt(void);
     800
     801/* rnd is additional random input. New one is returned.
     802 * Useful if you call crypt_make_salt many times in a row:
     803 * rnd = crypt_make_salt(buf1, 4, 0);
     804 * rnd = crypt_make_salt(buf2, 4, rnd);
     805 * rnd = crypt_make_salt(buf3, 4, rnd);
     806 * (otherwise we risk having same salt generated)
     807 */
     808extern int crypt_make_salt(char *p, int cnt, int rnd);
     809
     810/* Returns number of lines changed, or -1 on error */
     811extern int update_passwd(const char *filename, const char *username,
     812            const char *new_pw);
     813
     814/* NB: typically you want to pass fd 0, not 1. Think 'applet | grep something' */
     815int get_terminal_width_height(int fd, int *width, int *height);
     816
     817int ioctl_or_perror(int fd, int request, void *argp, const char *fmt,...) __attribute__ ((format (printf, 4, 5)));
     818void ioctl_or_perror_and_die(int fd, int request, void *argp, const char *fmt,...) __attribute__ ((format (printf, 4, 5)));
     819#if ENABLE_IOCTL_HEX2STR_ERROR
     820int bb_ioctl_or_warn(int fd, int request, void *argp, const char *ioctl_name);
     821void bb_xioctl(int fd, int request, void *argp, const char *ioctl_name);
     822#define ioctl_or_warn(fd,request,argp) bb_ioctl_or_warn(fd,request,argp,#request)
     823#define xioctl(fd,request,argp)        bb_xioctl(fd,request,argp,#request)
     824#else
     825int bb_ioctl_or_warn(int fd, int request, void *argp);
     826void bb_xioctl(int fd, int request, void *argp);
     827#define ioctl_or_warn(fd,request,argp) bb_ioctl_or_warn(fd,request,argp)
     828#define xioctl(fd,request,argp)        bb_xioctl(fd,request,argp)
     829#endif
     830
     831char *is_in_ino_dev_hashtable(const struct stat *statbuf);
     832void add_to_ino_dev_hashtable(const struct stat *statbuf, const char *name);
     833void reset_ino_dev_hashtable(void);
     834#ifdef __GLIBC__
     835/* At least glibc has horrendously large inline for this, so wrap it */
     836unsigned long long bb_makedev(unsigned int major, unsigned int minor);
     837#undef makedev
     838#define makedev(a,b) bb_makedev(a,b)
     839#endif
     840
     841
     842#if ENABLE_FEATURE_EDITING
     843/* It's NOT just ENABLEd or disabled. It's a number: */
     844#ifdef CONFIG_FEATURE_EDITING_HISTORY
     845#define MAX_HISTORY (CONFIG_FEATURE_EDITING_HISTORY + 0)
     846#else
     847#define MAX_HISTORY 0
     848#endif
     849typedef struct line_input_t {
     850    int flags;
     851    const char *path_lookup;
     852#if MAX_HISTORY
     853    int cnt_history;
     854    int cur_history;
     855    USE_FEATURE_EDITING_SAVEHISTORY(const char *hist_file;)
     856    char *history[MAX_HISTORY + 1];
     857#endif
     858} line_input_t;
     859enum {
     860    DO_HISTORY = 1 * (MAX_HISTORY > 0),
     861    SAVE_HISTORY = 2 * (MAX_HISTORY > 0) * ENABLE_FEATURE_EDITING_SAVEHISTORY,
     862    TAB_COMPLETION = 4 * ENABLE_FEATURE_TAB_COMPLETION,
     863    USERNAME_COMPLETION = 8 * ENABLE_FEATURE_USERNAME_COMPLETION,
     864    VI_MODE = 0x10 * ENABLE_FEATURE_EDITING_VI,
     865    WITH_PATH_LOOKUP = 0x20,
     866    FOR_SHELL = DO_HISTORY | SAVE_HISTORY | TAB_COMPLETION | USERNAME_COMPLETION,
     867};
     868line_input_t *new_line_input_t(int flags);
     869int read_line_input(const char* prompt, char* command, int maxsize, line_input_t *state);
     870#else
     871int read_line_input(const char* prompt, char* command, int maxsize);
     872#define read_line_input(prompt, command, maxsize, state) \
     873    read_line_input(prompt, command, maxsize)
     874#endif
     875
     876
     877#ifndef COMM_LEN
     878#ifdef TASK_COMM_LEN
     879enum { COMM_LEN = TASK_COMM_LEN };
     880#else
     881/* synchronize with sizeof(task_struct.comm) in /usr/include/linux/sched.h */
     882enum { COMM_LEN = 16 };
     883#endif
     884#endif
     885typedef struct {
     886    DIR *dir;
     887/* Fields are set to 0/NULL if failed to determine (or not requested) */
     888    /*char *cmd;*/
     889    char *argv0;
     890    /*char *exe;*/
     891    USE_SELINUX(char *context;)
     892    /* Everything below must contain no ptrs to malloc'ed data:
     893     * it is memset(0) for each process in procps_scan() */
     894    unsigned vsz, rss; /* we round it to kbytes */
     895    unsigned long stime, utime;
     896    unsigned pid;
     897    unsigned ppid;
     898    unsigned pgid;
     899    unsigned sid;
     900    unsigned uid;
     901    unsigned gid;
     902    unsigned tty_major,tty_minor;
     903    char state[4];
     904    /* basename of executable in exec(2), read from /proc/N/stat
     905     * (if executable is symlink or script, it is NOT replaced
     906     * by link target or interpreter name) */
     907    char comm[COMM_LEN];
     908    /* user/group? - use passwd/group parsing functions */
     909} procps_status_t;
     910enum {
     911    PSSCAN_PID      = 1 << 0,
     912    PSSCAN_PPID     = 1 << 1,
     913    PSSCAN_PGID     = 1 << 2,
     914    PSSCAN_SID      = 1 << 3,
     915    PSSCAN_UIDGID   = 1 << 4,
     916    PSSCAN_COMM     = 1 << 5,
     917    /* PSSCAN_CMD      = 1 << 6, - use read_cmdline instead */
     918    PSSCAN_ARGV0    = 1 << 7,
     919    /* PSSCAN_EXE      = 1 << 8, - not implemented */
     920    PSSCAN_STATE    = 1 << 9,
     921    PSSCAN_VSZ      = 1 << 10,
     922    PSSCAN_RSS      = 1 << 11,
     923    PSSCAN_STIME    = 1 << 12,
     924    PSSCAN_UTIME    = 1 << 13,
     925    PSSCAN_TTY      = 1 << 14,
     926    USE_SELINUX(PSSCAN_CONTEXT  = 1 << 15,)
     927    /* These are all retrieved from proc/NN/stat in one go: */
     928    PSSCAN_STAT     = PSSCAN_PPID | PSSCAN_PGID | PSSCAN_SID
     929                    | PSSCAN_COMM | PSSCAN_STATE
     930                    | PSSCAN_VSZ | PSSCAN_RSS
     931            | PSSCAN_STIME | PSSCAN_UTIME
     932            | PSSCAN_TTY,
     933};
     934procps_status_t* alloc_procps_scan(int flags);
     935void free_procps_scan(procps_status_t* sp);
     936procps_status_t* procps_scan(procps_status_t* sp, int flags);
     937/* Format cmdline (up to col chars) into char buf[col+1] */
     938/* Puts [comm] if cmdline is empty (-> process is a kernel thread) */
     939void read_cmdline(char *buf, int col, unsigned pid, const char *comm);
     940pid_t *find_pid_by_name(const char* procName);
     941pid_t *pidlist_reverse(pid_t *pidList);
     942
     943
     944extern const char bb_uuenc_tbl_base64[];
     945extern const char bb_uuenc_tbl_std[];
     946void bb_uuencode(char *store, const void *s, int length, const char *tbl);
     947
     948typedef struct sha1_ctx_t {
     949    uint32_t count[2];
     950    uint32_t hash[5];
     951    uint32_t wbuf[16];
     952} sha1_ctx_t;
     953void sha1_begin(sha1_ctx_t *ctx);
     954void sha1_hash(const void *data, size_t length, sha1_ctx_t *ctx);
     955void *sha1_end(void *resbuf, sha1_ctx_t *ctx);
     956
     957typedef struct md5_ctx_t {
     958    uint32_t A;
     959    uint32_t B;
     960    uint32_t C;
     961    uint32_t D;
     962    uint64_t total;
     963    uint32_t buflen;
     964    char buffer[128];
     965} md5_ctx_t;
     966void md5_begin(md5_ctx_t *ctx);
     967void md5_hash(const void *data, size_t length, md5_ctx_t *ctx);
     968void *md5_end(void *resbuf, md5_ctx_t *ctx);
     969
     970uint32_t *crc32_filltable(uint32_t *tbl256, int endian);
     971
     972
     973enum {  /* DO NOT CHANGE THESE VALUES!  cp.c, mv.c, install.c depend on them. */
    344974    FILEUTILS_PRESERVE_STATUS = 1,
    345975    FILEUTILS_DEREFERENCE = 2,
    346976    FILEUTILS_RECUR = 4,
    347977    FILEUTILS_FORCE = 8,
    348     FILEUTILS_INTERACTIVE = 16
    349 };
    350 
    351 extern const char *bb_applet_name;
    352 
    353 extern const char * const bb_msg_full_version;
    354 extern const char * const bb_msg_memory_exhausted;
    355 extern const char * const bb_msg_invalid_date;
    356 extern const char * const bb_msg_io_error;
    357 extern const char * const bb_msg_read_error;
    358 extern const char * const bb_msg_write_error;
    359 extern const char * const bb_msg_name_longer_than_foo;
    360 extern const char * const bb_msg_unknown;
    361 extern const char * const bb_msg_can_not_create_raw_socket;
    362 extern const char * const bb_msg_perm_denied_are_you_root;
    363 extern const char * const bb_msg_requires_arg;
    364 extern const char * const bb_msg_invalid_arg;
    365 extern const char * const bb_msg_standard_input;
    366 extern const char * const bb_msg_standard_output;
    367 
    368 extern const char * const bb_path_nologin_file;
    369 extern const char * const bb_path_passwd_file;
    370 extern const char * const bb_path_shadow_file;
    371 extern const char * const bb_path_gshadow_file;
    372 extern const char * const bb_path_group_file;
    373 extern const char * const bb_path_securetty_file;
    374 extern const char * const bb_path_motd_file;
    375 extern const char * const bb_path_wtmp_file;
    376 extern const char * const bb_dev_null;
     978    FILEUTILS_INTERACTIVE = 0x10,
     979    FILEUTILS_MAKE_HARDLINK = 0x20,
     980    FILEUTILS_MAKE_SOFTLINK = 0x40,
     981#if ENABLE_SELINUX
     982    FILEUTILS_PRESERVE_SECURITY_CONTEXT = 0x80,
     983    FILEUTILS_SET_SECURITY_CONTEXT = 0x100
     984#endif
     985};
     986
     987#define FILEUTILS_CP_OPTSTR "pdRfils" USE_SELINUX("c")
     988extern const struct bb_applet *current_applet;
     989extern const char *applet_name;
     990/* "BusyBox vN.N.N (timestamp or extra_vestion)" */
     991extern const char bb_banner[];
     992extern const char bb_msg_memory_exhausted[];
     993extern const char bb_msg_invalid_date[];
     994extern const char bb_msg_read_error[];
     995extern const char bb_msg_write_error[];
     996extern const char bb_msg_unknown[];
     997extern const char bb_msg_can_not_create_raw_socket[];
     998extern const char bb_msg_perm_denied_are_you_root[];
     999extern const char bb_msg_requires_arg[];
     1000extern const char bb_msg_invalid_arg[];
     1001extern const char bb_msg_standard_input[];
     1002extern const char bb_msg_standard_output[];
     1003
     1004extern const char bb_str_default[];
     1005/* NB: (bb_hexdigits_upcase[i] | 0x20) -> lowercase hex digit */
     1006extern const char bb_hexdigits_upcase[];
     1007
     1008extern const char bb_path_mtab_file[];
     1009extern const char bb_path_passwd_file[];
     1010extern const char bb_path_shadow_file[];
     1011extern const char bb_path_gshadow_file[];
     1012extern const char bb_path_group_file[];
     1013extern const char bb_path_motd_file[];
     1014extern const char bb_path_wtmp_file[];
     1015extern const char bb_dev_null[];
     1016extern const char bb_busybox_exec_path[];
     1017/* util-linux manpage says /sbin:/bin:/usr/sbin:/usr/bin,
     1018 * but I want to save a few bytes here */
     1019extern const char bb_PATH_root_path[]; /* "PATH=/sbin:/usr/sbin:/bin:/usr/bin" */
     1020#define bb_default_root_path (bb_PATH_root_path + sizeof("PATH"))
     1021#define bb_default_path      (bb_PATH_root_path + sizeof("PATH=/sbin:/usr/sbin"))
     1022
     1023extern const int const_int_0;
     1024extern const int const_int_1;
     1025
    3771026
    3781027#ifndef BUFSIZ
    3791028#define BUFSIZ 4096
    3801029#endif
    381 extern char bb_common_bufsiz1[BUFSIZ+1];
    382 
    383 /*
    384  * You can change LIBBB_DEFAULT_LOGIN_SHELL, but don`t use,
    385  * use bb_default_login_shell and next defines,
    386  * if you LIBBB_DEFAULT_LOGIN_SHELL change,
    387  * don`t lose change increment constant!
    388  */
     1030/* Providing hard guarantee on minimum size (think of BUFSIZ == 128) */
     1031enum { COMMON_BUFSIZE = (BUFSIZ >= 256*sizeof(void*) ? BUFSIZ+1 : 256*sizeof(void*)) };
     1032extern char bb_common_bufsiz1[COMMON_BUFSIZE];
     1033/* This struct is deliberately not defined. */
     1034/* See docs/keep_data_small.txt */
     1035struct globals;
     1036/* '*const' ptr makes gcc optimize code much better.
     1037 * Magic prevents ptr_to_globals from going into rodata.
     1038 * If you want to assign a value, use PTR_TO_GLOBALS = xxx */
     1039extern struct globals *const ptr_to_globals;
     1040#define PTR_TO_GLOBALS (*(struct globals**)&ptr_to_globals)
     1041
     1042
     1043/* You can change LIBBB_DEFAULT_LOGIN_SHELL, but don't use it,
     1044 * use bb_default_login_shell and following defines.
     1045 * If you change LIBBB_DEFAULT_LOGIN_SHELL,
     1046 * don't forget to change increment constant. */
    3891047#define LIBBB_DEFAULT_LOGIN_SHELL      "-/bin/sh"
    390 
    391 extern const char * const bb_default_login_shell;
     1048extern const char bb_default_login_shell[];
    3921049/* "/bin/sh" */
    3931050#define DEFAULT_SHELL     (bb_default_login_shell+1)
     
    3961053
    3971054
    398 extern const char bb_path_mtab_file[];
    399 
    400 extern int bb_default_error_retval;
    401 
    402 #ifdef CONFIG_FEATURE_DEVFS
     1055#if ENABLE_FEATURE_DEVFS
    4031056# define CURRENT_VC "/dev/vc/0"
    4041057# define VC_1 "/dev/vc/1"
     
    4211074# define VC_FORMAT "/dev/vc/%d"
    4221075# define LOOP_FORMAT "/dev/loop/%d"
     1076# define LOOP_NAMESIZE (sizeof("/dev/loop/") + sizeof(int)*3 + 1)
     1077# define LOOP_NAME "/dev/loop/"
    4231078# define FB_0 "/dev/fb/0"
    4241079#else
     
    4401095# define VC_FORMAT "/dev/tty%d"
    4411096# define LOOP_FORMAT "/dev/loop%d"
     1097# define LOOP_NAMESIZE (sizeof("/dev/loop") + sizeof(int)*3 + 1)
     1098# define LOOP_NAME "/dev/loop"
    4421099# define FB_0 "/dev/fb0"
    4431100#endif
    444 
    445 //#warning put these in .o files
    4461101
    4471102/* The following devices are the same on devfs and non-devfs systems.  */
    4481103#define CURRENT_TTY "/dev/tty"
    449 #define CONSOLE_DEV "/dev/console"
    450 
    451 int is_in_ino_dev_hashtable(const struct stat *statbuf, char **name);
    452 void add_to_ino_dev_hashtable(const struct stat *statbuf, const char *name);
    453 void reset_ino_dev_hashtable(void);
    454 
    455 char *bb_xasprintf(const char *format, ...) __attribute__ ((format (printf, 1, 2)));
    456 
    457 #define FAIL_DELAY    3
    458 extern void bb_do_delay(int seconds);
    459 extern void change_identity ( const struct passwd *pw );
    460 extern const char *change_identity_e2str ( const struct passwd *pw );
    461 extern void run_shell ( const char *shell, int loginshell, const char *command, const char **additional_args);
    462 #ifdef CONFIG_SELINUX
    463 extern void renew_current_security_context(void);
    464 extern void set_current_security_context(security_context_t sid);
    465 #endif
    466 extern int run_parts(char **args, const unsigned char test_mode, char **env);
    467 extern int restricted_shell ( const char *shell );
    468 extern void setup_environment ( const char *shell, int loginshell, int changeenv, const struct passwd *pw );
    469 extern int correct_password ( const struct passwd *pw );
    470 extern char *pw_encrypt(const char *clear, const char *salt);
    471 extern struct spwd *pwd_to_spwd(const struct passwd *pw);
    472 extern int obscure(const char *old, const char *newval, const struct passwd *pwdp);
    473 
    474 extern int bb_xopen(const char *pathname, int flags);
    475 extern int bb_xopen3(const char *pathname, int flags, int mode);
    476 extern ssize_t bb_xread(int fd, void *buf, size_t count);
    477 extern void bb_xread_all(int fd, void *buf, size_t count);
    478 extern unsigned char bb_xread_char(int fd);
    479 
    480 #ifndef COMM_LEN
    481 #ifdef TASK_COMM_LEN
    482 #define COMM_LEN TASK_COMM_LEN
    483 #else
    484 /* synchronize with sizeof(task_struct.comm) in /usr/include/linux/sched.h */
    485 #define COMM_LEN 16
    486 #endif
    487 #endif
    488 typedef struct {
    489     int pid;
    490     char user[9];
    491     char state[4];
    492     unsigned long rss;
    493     int ppid;
    494 #ifdef CONFIG_FEATURE_TOP_CPU_USAGE_PERCENTAGE
    495     unsigned pcpu;
    496     unsigned pscpu;
    497     unsigned long stime, utime;
    498 #endif
    499     char *cmd;
    500 
    501     /* basename of executable file in call to exec(2),
    502         size from kernel headers */
    503     char short_cmd[COMM_LEN];
    504 } procps_status_t;
    505 
    506 extern procps_status_t * procps_scan(int save_user_arg0);
    507 extern int compare_string_array(const char * const string_array[], const char *key);
    508 
    509 extern int my_query_module(const char *name, int which, void **buf, size_t *bufsize, size_t *ret);
    510 
    511 extern void print_login_issue(const char *issue_file, const char *tty);
    512 extern void print_login_prompt(void);
    513 
    514 #ifdef BB_NOMMU
    515 extern void vfork_daemon(int nochdir, int noclose);
    516 extern void vfork_daemon_rexec(int nochdir, int noclose,
    517         int argc, char **argv, char *foreground_opt);
    518 #endif
    519 
    520 extern int get_terminal_width_height(int fd, int *width, int *height);
    521 extern unsigned long get_ug_id(const char *s, long (*__bb_getxxnam)(const char *));
    522 
    523 typedef struct _sha1_ctx_t_ {
    524     uint32_t count[2];
    525     uint32_t hash[5];
    526     uint32_t wbuf[16];
    527 } sha1_ctx_t;
    528 
    529 void sha1_begin(sha1_ctx_t *ctx);
    530 void sha1_hash(const void *data, size_t length, sha1_ctx_t *ctx);
    531 void *sha1_end(void *resbuf, sha1_ctx_t *ctx);
    532 
    533 typedef struct _md5_ctx_t_ {
    534     uint32_t A;
    535     uint32_t B;
    536     uint32_t C;
    537     uint32_t D;
    538     uint64_t total;
    539     uint32_t buflen;
    540     char buffer[128];
    541 } md5_ctx_t;
    542 
    543 void md5_begin(md5_ctx_t *ctx);
    544 void md5_hash(const void *data, size_t length, md5_ctx_t *ctx);
    545 void *md5_end(void *resbuf, md5_ctx_t *ctx);
    546 
    547 extern uint32_t *bb_crc32_filltable (int endian);
     1104#define DEV_CONSOLE "/dev/console"
     1105
    5481106
    5491107#ifndef RB_POWER_OFF
     
    5521110#endif
    5531111
    554 extern const char BB_BANNER[];
     1112/* Make sure we call functions instead of macros.  */
     1113#undef isalnum
     1114#undef isalpha
     1115#undef isascii
     1116#undef isblank
     1117#undef iscntrl
     1118#undef isgraph
     1119#undef islower
     1120#undef isprint
     1121#undef ispunct
     1122#undef isspace
     1123#undef isupper
     1124#undef isxdigit
     1125
     1126/* This one is more efficient - we save ~400 bytes */
     1127#undef isdigit
     1128#define isdigit(a) ((unsigned)((a) - '0') <= 9)
     1129
     1130
     1131#ifdef DMALLOC
     1132#include <dmalloc.h>
     1133#endif
     1134
     1135
     1136#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
    5551137
    5561138#endif /* __LIBBUSYBOX_H__ */
  • branches/stable/mindi-busybox/include/platform.h

    r902 r1770  
    1212#if defined __GNUC__ && defined __GNUC_MINOR__
    1313# define __GNUC_PREREQ(maj, min) \
    14             ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
     14        ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
    1515#else
    1616# define __GNUC_PREREQ(maj, min) 0
     
    3535
    3636#undef inline
    37 #if __STDC_VERSION__ > 199901L
     37#if defined(__STDC_VERSION__) && __STDC_VERSION__ > 199901L
    3838/* it's a keyword */
    3939#else
     
    5454# define ATTRIBUTE_ALIGNED(m) __attribute__ ((__aligned__(m)))
    5555# if __GNUC_PREREQ (3,0)
    56 #  define ATTRIBUTE_ALWAYS_INLINE __attribute__ ((always_inline)) inline
     56#  define ALWAYS_INLINE __attribute__ ((always_inline)) inline
     57#  if !ENABLE_WERROR
     58#   define ATTRIBUTE_DEPRECATED __attribute__ ((__deprecated__))
     59#   define ATTRIBUTE_UNUSED_RESULT __attribute__ ((warn_unused_result))
     60#  else
     61#   define ATTRIBUTE_DEPRECATED /* n/a */
     62#   define ATTRIBUTE_UNUSED_RESULT /* n/a */
     63#  endif
    5764# else
    58 #  define ATTRIBUTE_ALWAYS_INLINE inline
     65#  define ALWAYS_INLINE inline
     66#  define ATTRIBUTE_DEPRECATED /* n/a */
     67#  define ATTRIBUTE_UNUSED_RESULT /* n/a */
    5968# endif
    6069
     
    134143
    135144/* ---- Compiler dependent settings ------------------------- */
     145#if (defined __digital__ && defined __unix__)
     146# undef HAVE_MNTENT_H
     147#else
     148# define HAVE_MNTENT_H 1
     149#endif /* ___digital__ && __unix__ */
     150
     151/* linux/loop.h relies on __u64. Make sure we have that as a proper type
     152 * until userspace is widely fixed.  */
    136153#ifndef __GNUC__
    137154#if defined __INTEL_COMPILER
     
    141158#endif /* ifndef __GNUC__ */
    142159
    143 #if (defined __digital__ && defined __unix__)
    144 # undef HAVE_MNTENT_H
    145 #else
    146 # define HAVE_MNTENT_H 1
    147 #endif /* ___digital__ && __unix__ */
    148 
    149160/*----- Kernel versioning ------------------------------------*/
    150161#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))
     
    159170#endif
    160171
    161 // Don't perpetuate e2fsck crap into the headers.  Clean up e2fsck instead.
     172/* Don't perpetuate e2fsck crap into the headers.  Clean up e2fsck instead. */
    162173
    163174#if defined __GLIBC__ || defined __UCLIBC__ \
     
    170181/* Largest integral types.  */
    171182#if __BIG_ENDIAN__
    172 typedef long int                intmax_t;
    173 typedef unsigned long int       uintmax_t;
     183typedef long                intmax_t;
     184typedef unsigned long       uintmax_t;
    174185#else
    175186__extension__
    176 typedef long long int           intmax_t;
     187typedef long long           intmax_t;
    177188__extension__
    178 typedef unsigned long long int  uintmax_t;
    179 #endif
    180 #endif
    181 
    182 /* uclibc does not implement daemon for no-mmu systems.
     189typedef unsigned long long  uintmax_t;
     190#endif
     191#endif
     192
     193/* Size-saving "small" ints (arch-dependent) */
     194#if defined(i386) || defined(__x86_64__) || defined(__mips__) || defined(__cris__)
     195/* add other arches which benefit from this... */
     196typedef signed char smallint;
     197typedef unsigned char smalluint;
     198#else
     199/* for arches where byte accesses generate larger code: */
     200typedef int smallint;
     201typedef unsigned smalluint;
     202#endif
     203
     204/* ISO C Standard:  7.16  Boolean type and values  <stdbool.h> */
     205#if (defined __digital__ && defined __unix__)
     206/* old system without (proper) C99 support */
     207#define bool smalluint
     208#else
     209/* modern system, so use it */
     210#include <stdbool.h>
     211#endif
     212
     213/* Try to defeat gcc's alignment of "char message[]"-like data */
     214#if 1 /* if needed: !defined(arch1) && !defined(arch2) */
     215#define ALIGN1 __attribute__((aligned(1)))
     216#define ALIGN2 __attribute__((aligned(2)))
     217#else
     218/* Arches which MUST have 2 or 4 byte alignment for everything are here */
     219#define ALIGN1
     220#define ALIGN2
     221#endif
     222
     223
     224/* uclibc does not implement daemon() for no-mmu systems.
    183225 * For 0.9.29 and svn, __ARCH_USE_MMU__ indicates no-mmu reliably.
    184226 * For earlier versions there is no reliable way to check if we are building
     
    188230#if defined __UCLIBC__ && __UCLIBC_MAJOR__ >= 0 && __UCLIBC_MINOR__ >= 9 && \
    189231    __UCLIBC_SUBLEVEL__ > 28 && !defined __ARCH_USE_MMU__
    190 #define BB_NOMMU
     232#define BB_MMU 0
     233#define BB_NOMMU 1
     234#define USE_FOR_NOMMU(...) __VA_ARGS__
     235#define USE_FOR_MMU(...)
     236#else
     237#define BB_MMU 1
     238/* BB_NOMMU is not defined in this case! */
     239#define USE_FOR_NOMMU(...)
     240#define USE_FOR_MMU(...) __VA_ARGS__
    191241#endif
    192242
     
    194244 * libbb.  This would require a platform.c.  It's not going to be cleaned
    195245 * out of the tree, so stop saying it should be. */
     246#if !defined(__dietlibc__)
     247/* Needed for: glibc */
     248/* Not needed for: dietlibc */
     249/* Others: ?? (add as needed) */
    196250#define fdprintf dprintf
     251#endif
     252
     253#if defined(__dietlibc__)
     254static ALWAYS_INLINE char* strchrnul(const char *s, char c)
     255{
     256    while (*s && *s != c) ++s;
     257    return (char*)s;
     258}
     259#endif
     260
     261/* Don't use lchown with glibc older than 2.1.x ... uClibc lacks it */
     262#if (defined __GLIBC__ && __GLIBC__ <= 2 && __GLIBC_MINOR__ < 1) || \
     263    defined __UC_LIBC__
     264# define lchown chown
     265#endif
    197266
    198267/* THIS SHOULD BE CLEANED OUT OF THE TREE ENTIRELY */
     
    209278#define PRIu32 "u"
    210279
    211 /* use legacy setpgrp(pidt_,pid_t) for now.  move to platform.c */
    212 #define bb_setpgrp do{pid_t __me = getpid();setpgrp(__me,__me);}while(0)
     280/* use legacy setpgrp(pid_t,pid_t) for now.  move to platform.c */
     281#define bb_setpgrp() do { pid_t __me = getpid(); setpgrp(__me,__me); } while (0)
    213282
    214283#if !defined ADJ_OFFSET_SINGLESHOT && defined MOD_CLKA && defined MOD_OFFSET
     
    226295
    227296#else
    228 #define bb_setpgrp setpgrp()
     297#define bb_setpgrp() setpgrp()
    229298#endif
    230299
    231300#if defined(__linux__)
    232301#include <sys/mount.h>
     302/* Make sure we have all the new mount flags we actually try to use. */
     303#ifndef MS_BIND
     304#define MS_BIND        (1<<12)
     305#endif
     306#ifndef MS_MOVE
     307#define MS_MOVE        (1<<13)
     308#endif
     309#ifndef MS_RECURSIVE
     310#define MS_RECURSIVE   (1<<14)
     311#endif
     312#ifndef MS_SILENT
     313#define MS_SILENT      (1<<15)
     314#endif
     315
     316/* The shared subtree stuff, which went in around 2.6.15. */
     317#ifndef MS_UNBINDABLE
     318#define MS_UNBINDABLE  (1<<17)
     319#endif
     320#ifndef MS_PRIVATE
     321#define MS_PRIVATE     (1<<18)
     322#endif
     323#ifndef MS_SLAVE
     324#define MS_SLAVE       (1<<19)
     325#endif
     326#ifndef MS_SHARED
     327#define MS_SHARED      (1<<20)
     328#endif
     329
     330
    233331#if !defined(BLKSSZGET)
    234332#define BLKSSZGET _IO(0x12, 104)
  • branches/stable/mindi-busybox/include/pwd_.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12/* Copyright (C) 1991,92,95,96,97,98,99,2001 Free Software Foundation, Inc.
    23   This file is part of the GNU C Library.
     
    2122 */
    2223
    23 #if !defined CONFIG_USE_BB_PWD_GRP
     24#if !ENABLE_USE_BB_PWD_GRP
     25
    2426#include <pwd.h>
    2527
     
    2729
    2830#ifndef _PWD_H
    29 #define _PWD_H  1
    30 
    31 #include <sys/types.h>
    32 #include <features.h>
    33 #include <stdio.h>
     31#define _PWD_H 1
    3432
    3533/* The passwd structure.  */
    36 struct passwd
    37 {
    38     char *pw_name;      /* Username.  */
    39     char *pw_passwd;        /* Password.  */
    40     uid_t pw_uid;           /* User ID.  */
    41     gid_t pw_gid;           /* Group ID.  */
    42     char *pw_gecos;     /* Real name.  */
    43     char *pw_dir;           /* Home directory.  */
    44     char *pw_shell;     /* Shell program.  */
     34struct passwd {
     35    char *pw_name;          /* Username.  */
     36    char *pw_passwd;        /* Password.  */
     37    uid_t pw_uid;           /* User ID.  */
     38    gid_t pw_gid;           /* Group ID.  */
     39    char *pw_gecos;         /* Real name.  */
     40    char *pw_dir;           /* Home directory.  */
     41    char *pw_shell;         /* Shell program.  */
    4542};
    4643
    4744
     45#define setpwent    bb_internal_setpwent
     46#define endpwent    bb_internal_endpwent
     47#define getpwent    bb_internal_getpwent
     48#define fgetpwent   bb_internal_fgetpwent
     49#define putpwent    bb_internal_putpwent
     50#define getpwuid    bb_internal_getpwuid
     51#define getpwnam    bb_internal_getpwnam
     52#define getpwent_r  bb_internal_getpwent_r
     53#define getpwuid_r  bb_internal_getpwuid_r
     54#define getpwnam_r  bb_internal_getpwnam_r
     55#define fgetpwent_r bb_internal_fgetpwent_r
     56#define getpw       bb_internal_getpw
     57
     58
     59/* All function names below should be remapped by #defines above
     60 * in order to not collide with libc names.
     61 * In theory it isn't necessary, but I saw weird interactions at link time.
     62 * Let's play safe */
     63
     64
    4865/* Rewind the password-file stream.  */
    49 extern void setpwent (void);
     66extern void setpwent(void);
    5067
    5168/* Close the password-file stream.  */
    52 extern void endpwent (void);
     69extern void endpwent(void);
    5370
    5471/* Read an entry from the password-file stream, opening it if necessary.  */
    55 extern struct passwd *getpwent (void);
     72extern struct passwd *getpwent(void);
    5673
    5774/* Read an entry from STREAM.  */
    58 extern struct passwd *fgetpwent (FILE *__stream);
     75extern struct passwd *fgetpwent(FILE *__stream);
    5976
    6077/* Write the given entry onto the given stream.  */
    61 extern int putpwent (__const struct passwd *__restrict __p,
     78extern int putpwent(__const struct passwd *__restrict __p,
    6279             FILE *__restrict __f);
    6380
    6481/* Search for an entry with a matching user ID.  */
    65 extern struct passwd *getpwuid (uid_t __uid);
     82extern struct passwd *getpwuid(uid_t __uid);
    6683
    6784/* Search for an entry with a matching username.  */
    68 extern struct passwd *getpwnam (__const char *__name);
     85extern struct passwd *getpwnam(__const char *__name);
    6986
    7087/* Reentrant versions of some of the functions above.
     
    7693   POSIX people would choose.  */
    7794
    78 extern int getpwent_r (struct passwd *__restrict __resultbuf,
     95extern int getpwent_r(struct passwd *__restrict __resultbuf,
    7996               char *__restrict __buffer, size_t __buflen,
    8097               struct passwd **__restrict __result);
    8198
    82 extern int getpwuid_r (uid_t __uid,
     99extern int getpwuid_r(uid_t __uid,
    83100               struct passwd *__restrict __resultbuf,
    84101               char *__restrict __buffer, size_t __buflen,
    85102               struct passwd **__restrict __result);
    86103
    87 extern int getpwnam_r (__const char *__restrict __name,
     104extern int getpwnam_r(__const char *__restrict __name,
    88105               struct passwd *__restrict __resultbuf,
    89106               char *__restrict __buffer, size_t __buflen,
    90107               struct passwd **__restrict __result);
    91108
    92 
    93109/* Read an entry from STREAM.  This function is not standardized and
    94110   probably never will.  */
    95 extern int fgetpwent_r (FILE *__restrict __stream,
     111extern int fgetpwent_r(FILE *__restrict __stream,
    96112            struct passwd *__restrict __resultbuf,
    97113            char *__restrict __buffer, size_t __buflen,
     
    101117   in the given buffer.  This knows the format that the caller
    102118   will expect, but this need not be the format of the password file.  */
    103 extern int getpw (uid_t __uid, char *__buffer);
     119extern int getpw(uid_t __uid, char *__buffer);
    104120
    105121#endif /* pwd.h  */
  • branches/stable/mindi-busybox/include/shadow_.h

    r821 r1770  
     1/* vi: set sw=4 ts=4: */
    12/* Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
    23   This file is part of the GNU C Library.
     
    1718   02111-1307 USA.  */
    1819
    19 /* Declaration of types and functions for shadow password suite. */
     20/* Declaration of types and functions for shadow password suite */
    2021
    21 #if !defined CONFIG_USE_BB_SHADOW
     22#if !ENABLE_USE_BB_SHADOW
     23
    2224#include <shadow.h>
     25
    2326#else
    2427
    2528#ifndef _SHADOW_H
    26 #define _SHADOW_H   1
     29#define _SHADOW_H 1
    2730
    28 #include <stdio.h>
     31/* Paths to the user database files */
     32#ifndef _PATH_SHADOW
     33#define _PATH_SHADOW "/etc/shadow"
     34#endif
    2935
    30 /* Paths to the user database files.  */
    31 #ifndef _PATH_SHADOW
    32 #define _PATH_SHADOW    "/etc/shadow"
    33 #endif
    34 #define SHADOW _PATH_SHADOW
    35 
    36 
    37 /* Structure of the password file.  */
    38 struct spwd
    39 {
    40     char *sp_namp;      /* Login name.  */
    41     char *sp_pwdp;      /* Encrypted password.  */
    42     long int sp_lstchg;     /* Date of last change.  */
    43     long int sp_min;        /* Minimum number of days between changes.  */
    44     long int sp_max;        /* Maximum number of days between changes.  */
    45     long int sp_warn;       /* Number of days to warn user to change
    46                    the password.  */
    47     long int sp_inact;      /* Number of days the account may be
    48                    inactive.  */
    49     long int sp_expire;     /* Number of days since 1970-01-01 until
    50                    account expires.  */
    51     unsigned long int sp_flag;  /* Reserved.  */
     36/* Structure of the password file */
     37struct spwd {
     38    char *sp_namp;          /* Login name */
     39    char *sp_pwdp;          /* Encrypted password */
     40    long sp_lstchg;         /* Date of last change */
     41    long sp_min;            /* Minimum number of days between changes */
     42    long sp_max;            /* Maximum number of days between changes */
     43    long sp_warn;           /* Number of days to warn user to change the password */
     44    long sp_inact;          /* Number of days the account may be inactive */
     45    long sp_expire;         /* Number of days since 1970-01-01 until account expires */
     46    unsigned long sp_flag;  /* Reserved */
    5247};
    5348
    5449
    55 /* Open database for reading.  */
    56 extern void setspent (void);
     50#define setspent    bb_internal_setspent
     51#define endspent    bb_internal_endspent
     52#define getspent    bb_internal_getspent
     53#define getspnam    bb_internal_getspnam
     54#define sgetspent   bb_internal_sgetspent
     55#define fgetspent   bb_internal_fgetspent
     56#define putspent    bb_internal_putspent
     57#define getspent_r  bb_internal_getspent_r
     58#define getspnam_r  bb_internal_getspnam_r
     59#define sgetspent_r bb_internal_sgetspent_r
     60#define fgetspent_r bb_internal_fgetspent_r
     61#define lckpwdf     bb_internal_lckpwdf
     62#define ulckpwdf    bb_internal_ulckpwdf
    5763
    58 /* Close database.  */
    59 extern void endspent (void);
    6064
    61 /* Get next entry from database, perhaps after opening the file.  */
    62 extern struct spwd *getspent (void);
     65/* All function names below should be remapped by #defines above
     66 * in order to not collide with libc names.
     67 * In theory it isn't necessary, but I saw weird interactions at link time.
     68 * Let's play safe */
    6369
    64 /* Get shadow entry matching NAME.  */
    65 extern struct spwd *getspnam (__const char *__name);
    6670
    67 /* Read shadow entry from STRING. */
    68 extern struct spwd *sgetspent (__const char *__string);
     71/* Open database for reading */
     72extern void setspent(void);
    6973
    70 /* Read next shadow entry from STREAM. */
    71 extern struct spwd *fgetspent (FILE *__stream);
     74/* Close database */
     75extern void endspent(void);
    7276
    73 /* Write line containing shadow password entry to stream. */
    74 extern int putspent (__const struct spwd *__p, FILE *__stream);
     77/* Get next entry from database, perhaps after opening the file */
     78extern struct spwd *getspent(void);
    7579
    76 /* Reentrant versions of some of the functions above.  */
    77 extern int getspent_r (struct spwd *__result_buf, char *__buffer,
     80/* Get shadow entry matching NAME */
     81extern struct spwd *getspnam(__const char *__name);
     82
     83/* Read shadow entry from STRING */
     84extern struct spwd *sgetspent(__const char *__string);
     85
     86/* Read next shadow entry from STREAM */
     87extern struct spwd *fgetspent(FILE *__stream);
     88
     89/* Write line containing shadow password entry to stream */
     90extern int putspent(__const struct spwd *__p, FILE *__stream);
     91
     92/* Reentrant versions of some of the functions above */
     93extern int getspent_r(struct spwd *__result_buf, char *__buffer,
    7894               size_t __buflen, struct spwd **__result);
    7995
    80 extern int getspnam_r (__const char *__name, struct spwd *__result_buf,
     96extern int getspnam_r(__const char *__name, struct spwd *__result_buf,
    8197               char *__buffer, size_t __buflen,
    8298               struct spwd **__result);
    8399
    84 extern int sgetspent_r (__const char *__string, struct spwd *__result_buf,
     100extern int sgetspent_r(__const char *__string, struct spwd *__result_buf,
    85101            char *__buffer, size_t __buflen,
    86102            struct spwd **__result);
    87103
    88 extern int fgetspent_r (FILE *__stream, struct spwd *__result_buf,
     104extern int fgetspent_r(FILE *__stream, struct spwd *__result_buf,
    89105            char *__buffer, size_t __buflen,
    90106            struct spwd **__result);
    91 /* Protect password file against multi writers. */
    92 extern int lckpwdf (void);
     107/* Protect password file against multi writers */
     108extern int lckpwdf(void);
    93109
    94 /* Unlock password file. */
    95 extern int ulckpwdf (void);
     110/* Unlock password file */
     111extern int ulckpwdf(void);
    96112
    97113#endif /* shadow.h */
  • branches/stable/mindi-busybox/include/unarchive.h

    r821 r1770  
    1111#define ARCHIVE_NOPRESERVE_PERM         64
    1212
    13 #include <sys/types.h>
    14 #include <stdio.h>
    15 #include "libbb.h"
    16 
    17 typedef struct file_headers_s {
     13typedef struct file_header_t {
    1814    char *name;
    19     char *link_name;
     15    char *link_target;
    2016    off_t size;
    2117    uid_t uid;
     
    2622} file_header_t;
    2723
    28 typedef struct archive_handle_s {
    29     /* define if the header and data component should processed */
    30     char (*filter)(struct archive_handle_s *);
     24typedef struct archive_handle_t {
     25    /* define if the header and data component should be processed */
     26    char (*filter)(struct archive_handle_t *);
    3127    llist_t *accept;
    3228    /* List of files that have been rejected */
     
    4238
    4339    /* process the data component, e.g. extract to filesystem */
    44     void (*action_data)(struct archive_handle_s *);
     40    void (*action_data)(struct archive_handle_t *);
    4541
    4642    /* How to process any sub archive, e.g. get_header_tar_gz */
    47     char (*action_data_subarchive)(struct archive_handle_s *);
     43    char (*action_data_subarchive)(struct archive_handle_t *);
    4844
    4945    /* Contains the handle to a sub archive */
    50     struct archive_handle_s *sub_archive;
     46    struct archive_handle_t *sub_archive;
    5147
    5248    /* The raw stream as read from disk or stdin */
     
    5753
    5854    /* Function that skips data: read_by_char or read_by_skip */
    59     void (*seek)(const struct archive_handle_s *archive_handle, const unsigned int amount);
     55    void (*seek)(const struct archive_handle_t *archive_handle, const unsigned amount);
    6056
    6157    /* Temporary storage */
     
    6662
    6763} archive_handle_t;
     64
    6865
    6966extern archive_handle_t *init_handle(void);
     
    8582extern void header_verbose_list(const file_header_t *file_header);
    8683
    87 extern void check_header_gzip(int src_fd);
     84extern void check_header_gzip_or_die(int src_fd);
    8885
    8986extern char get_header_ar(archive_handle_t *archive_handle);
     
    9491extern char get_header_tar_gz(archive_handle_t *archive_handle);
    9592
    96 extern void seek_by_jump(const archive_handle_t *archive_handle, const unsigned int amount);
    97 extern void seek_by_char(const archive_handle_t *archive_handle, const unsigned int amount);
     93extern void seek_by_jump(const archive_handle_t *archive_handle, const unsigned amount);
     94extern void seek_by_read(const archive_handle_t *archive_handle, const unsigned amount);
    9895
    99 extern void archive_xread_all(const archive_handle_t *archive_handle, void *buf, const size_t count);
    10096extern ssize_t archive_xread_all_eof(archive_handle_t *archive_handle, unsigned char *buf, size_t count);
    10197
    10298extern void data_align(archive_handle_t *archive_handle, const unsigned short boundary);
    10399extern const llist_t *find_list_entry(const llist_t *list, const char *filename);
     100extern const llist_t *find_list_entry2(const llist_t *list, const char *filename);
    104101
    105 extern int uncompressStream(int src_fd, int dst_fd);
    106 extern void inflate_init(unsigned int bufsize);
    107 extern void inflate_cleanup(void);
    108 extern int inflate_unzip(int in, int out);
    109 extern int inflate_gunzip(int in, int out);
    110 extern int unlzma(int src_fd, int dst_fd);
     102/* A bit of bunzip2 internals are exposed for compressed help support: */
     103typedef struct bunzip_data bunzip_data;
     104int start_bunzip(bunzip_data **bdp, int in_fd, const unsigned char *inbuf, int len);
     105int read_bunzip(bunzip_data *bd, char *outbuf, int len);
     106void dealloc_bunzip(bunzip_data *bd);
    111107
    112 extern int open_transformer(int src_fd, int (*transformer)(int src_fd, int dst_fd));
     108typedef struct inflate_unzip_result {
     109    off_t bytes_out;
     110    uint32_t crc;
     111} inflate_unzip_result;
    113112
     113extern USE_DESKTOP(long long) int unpack_bz2_stream(int src_fd, int dst_fd);
     114extern USE_DESKTOP(long long) int inflate_unzip(inflate_unzip_result *res, unsigned bufsize, int src_fd, int dst_fd);
     115extern USE_DESKTOP(long long) int unpack_gz_stream(int src_fd, int dst_fd);
     116extern USE_DESKTOP(long long) int unpack_lzma_stream(int src_fd, int dst_fd);
     117
     118#if BB_MMU
     119extern int open_transformer(int src_fd,
     120    USE_DESKTOP(long long) int (*transformer)(int src_fd, int dst_fd));
     121#define open_transformer(src_fd, transformer, transform_prog, ...) open_transformer(src_fd, transformer)
     122#else
     123extern int open_transformer(int src_fd, const char *transform_prog, ...);
     124#define open_transformer(src_fd, transformer, transform_prog, ...) open_transformer(src_fd, transform_prog, __VA_ARGS__)
     125#endif
    114126
    115127#endif
  • branches/stable/mindi-busybox/include/usage.h

    r821 r1770  
     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 */
     10
    111#ifndef __BB_USAGE_H__
    212#define __BB_USAGE_H__
    313
    414#define addgroup_trivial_usage \
    5     "[-g GID] group_name [user_name]"
     15       "[-g GID]"USE_FEATURE_ADDUSER_TO_GROUP(" [user_name]")" group_name"
    616#define addgroup_full_usage \
    7     "Adds a group to the system\n\n" \
    8     "Options:\n" \
    9     "\t-g GID\t\tspecify gid"
     17       "Add a group to the system"USE_FEATURE_ADDUSER_TO_GROUP(" or add an user to a group") \
     18       "\n\nOptions:\n" \
     19       "    -g GID  Specify gid"
    1020
    1121#define adduser_trivial_usage \
    12     "[OPTIONS] user_name"
     22       "[OPTIONS] user_name"
    1323#define adduser_full_usage \
    14     "Adds a user to the system\n\n" \
    15     "Options:\n" \
    16     "\t-h DIR\t\tAssign home directory DIR\n" \
    17     "\t-g GECOS\tAssign gecos field GECOS\n" \
    18     "\t-s SHELL\tAssign login shell SHELL\n" \
    19     "\t-G\t\tAdd the user to existing group GROUP\n" \
    20     "\t-S\t\tcreate a system user (ignored)\n" \
    21     "\t-D\t\tDo not assign a password (logins still possible via ssh)\n" \
    22     "\t-H\t\tDo not create the home directory"
     24       "Add a user to the system" \
     25       "\n\nOptions:\n" \
     26       "    -h DIR      Home directory\n" \
     27       "    -g GECOS    GECOS field\n" \
     28       "    -s SHELL    Login shell\n" \
     29       "    -G GROUP    Add user to existing group\n" \
     30       "    -S      Create a system user (ignored)\n" \
     31       "    -D      Do not assign a password (logins still possible via ssh)\n" \
     32       "    -H      Do not create home directory"
    2333
    2434#define adjtimex_trivial_usage \
    25     "[-q] [-o offset] [-f frequency] [-p timeconstant] [-t tick]"
     35       "[-q] [-o offset] [-f frequency] [-p timeconstant] [-t tick]"
    2636#define adjtimex_full_usage \
    27     "Reads and optionally sets system timebase parameters.\n" \
    28     "See adjtimex(2).\n\n" \
    29     "Options:\n" \
    30     "\t-q\t\tquiet mode - do not print\n" \
    31     "\t-o offset\ttime offset, microseconds\n" \
    32     "\t-f frequency\tfrequency adjust, integer kernel units (65536 is 1ppm)\n" \
    33     "\t\t\t(positive values make the system clock run fast)\n" \
    34     "\t-t tick\t\tmicroseconds per tick, usually 10000\n" \
    35     "\t-p timeconstant"
     37       "Read and optionally set system timebase parameters.\n" \
     38       "See adjtimex(2)." \
     39       "\n\nOptions:\n" \
     40       "    -q      Quiet\n" \
     41       "    -o offset   Time offset, microseconds\n" \
     42       "    -f frequency    Frequency adjust, integer kernel units (65536 is 1ppm)\n" \
     43       "            (positive values make the system clock run faster)\n" \
     44       "    -t tick     Microseconds per tick, usually 10000\n" \
     45       "    -p timeconstant"
    3646
    3747#define ar_trivial_usage \
    38     "[-o] [-v] [-p] [-t] [-x] ARCHIVE FILES"
     48       "[-o] [-v] [-p] [-t] [-x] ARCHIVE FILES"
    3949#define ar_full_usage \
    40     "Extract or list FILES from an ar archive.\n\n" \
    41     "Options:\n" \
    42     "\t-o\t\tpreserve original dates\n" \
    43     "\t-p\t\textract to stdout\n" \
    44     "\t-t\t\tlist\n" \
    45     "\t-x\t\textract\n" \
    46     "\t-v\t\tverbosely list files processed"
     50       "Extract or list FILES from an ar archive" \
     51       "\n\nOptions:\n" \
     52       "    -o  Preserve original dates\n" \
     53       "    -p  Extract to stdout\n" \
     54       "    -t  List\n" \
     55       "    -x  Extract\n" \
     56       "    -v  Verbose"
     57
     58#define arp_trivial_usage \
     59       "\n" \
     60       "[-vn]   [-H type] [-i if] -a [hostname]\n" \
     61       "[-v]          [-i if] -d hostname [pub]\n" \
     62       "[-v]    [-H type] [-i if] -s hostname hw_addr [temp]\n" \
     63       "[-v]    [-H type] [-i if] -s hostname hw_addr [netmask nm] pub\n" \
     64       "[-v]    [-H type] [-i if] -Ds hostname ifa [netmask nm] pub\n"
     65#define arp_full_usage \
     66       "Manipulate the system ARP cache" \
     67       "\n\nOptions:" \
     68       "\n  -a      Display (all) hosts" \
     69       "\n  -s      Set a new ARP entry" \
     70       "\n  -d      Delete a specified entry" \
     71       "\n  -v      Verbose" \
     72       "\n  -n      Don't resolve names" \
     73       "\n  -i if       Specify network interface (e.g. eth0)" \
     74       "\n  -D      Read <hwaddr> from given device" \
     75       "\n  -A, -p      Specify protocol family" \
     76       "\n  -H hwtype   Specify hardware address type"
    4777
    4878#define arping_trivial_usage \
    49     "[-fqbDUA] [-c count] [-w timeout] [-i device] [-s sender] target"
     79       "[-fqbDUA] [-c count] [-w timeout] [-i device] [-s sender] target"
    5080#define arping_full_usage \
    51     "Ping hosts by ARP requests/replies.\n\n" \
    52     "Options:\n" \
    53     "\t-f\t\tQuit on first ARP reply\n" \
    54     "\t-q\t\tBe quiet\n" \
    55     "\t-b\t\tKeep broadcasting, don't go unicast\n" \
    56     "\t-D\t\tDuplicated address detection mode\n" \
    57     "\t-U\t\tUnsolicited ARP mode, update your neighbours\n" \
    58     "\t-A\t\tARP answer mode, update your neighbours\n" \
    59     "\t-c count\tStop after sending count ARP request packets\n" \
    60     "\t-w timeout\tTime to wait for ARP reply, in seconds\n" \
    61     "\t-i device\tOutgoing interface name, default is eth0\n" \
    62     "\t-s sender\tSet specific sender IP address\n" \
    63     "\ttarget\t\tTarget IP address of ARP request"
     81       "Ping hosts by ARP requests/replies" \
     82       "\n\nOptions:\n" \
     83       "    -f      Quit on first ARP reply\n" \
     84       "    -q      Quiet\n" \
     85       "    -b      Keep broadcasting, don't go unicast\n" \
     86       "    -D      Duplicated address detection mode\n" \
     87       "    -U      Unsolicited ARP mode, update your neighbours\n" \
     88       "    -A      ARP answer mode, update your neighbours\n" \
     89       "    -c count    Stop after sending count ARP request packets\n" \
     90       "    -w timeout  Time to wait for ARP reply, in seconds\n" \
     91       "    -I device   Outgoing interface name, default is eth0\n" \
     92       "    -s sender   Set specific sender IP address\n" \
     93       "    target      Target IP address of ARP request"
    6494
    6595#define ash_trivial_usage \
    66     "[FILE]...\n" \
    67     "or: ash -c command [args]..."
     96       "[FILE]...\n" \
     97       "or: ash -c command [args]..."
    6898#define ash_full_usage \
    69     "The ash shell (command interpreter)"
     99       "The ash shell (command interpreter)"
    70100
    71101#define awk_trivial_usage \
    72     "[OPTION]... [program-text] [FILE ...]"
     102       "[OPTION]... [program-text] [FILE ...]"
    73103#define awk_full_usage \
    74     "Options:\n" \
    75     "\t-v var=val\tassign value 'val' to variable 'var'\n" \
    76     "\t-F sep\t\tuse 'sep' as field separator\n" \
    77     "\t-f progname\tread program source from file 'progname'"
     104       "Options:\n" \
     105       "    -v var=val  Set variable\n" \
     106       "    -F sep      Use 'sep' as field separator\n" \
     107       "    -f filename Read program from file"
    78108
    79109#define basename_trivial_usage \
    80     "FILE [SUFFIX]"
     110       "FILE [SUFFIX]"
    81111#define basename_full_usage \
    82     "Strips directory path and suffixes from FILE.\n" \
    83     "If specified, also removes any trailing SUFFIX."
     112       "Strip directory path and suffixes from FILE.\n" \
     113       "If specified, also remove any trailing SUFFIX."
    84114#define basename_example_usage \
    85     "$ basename /usr/local/bin/foo\n" \
    86     "foo\n" \
    87     "$ basename /usr/local/bin/\n" \
    88     "bin\n" \
    89     "$ basename /foo/bar.txt .txt\n" \
    90     "bar"
     115       "$ basename /usr/local/bin/foo\n" \
     116       "foo\n" \
     117       "$ basename /usr/local/bin/\n" \
     118       "bin\n" \
     119       "$ basename /foo/bar.txt .txt\n" \
     120       "bar"
    91121
    92122#define bunzip2_trivial_usage \
    93     "[OPTION]... [FILE]"
     123       "[OPTION]... [FILE]"
    94124#define bunzip2_full_usage \
    95     "Uncompress FILE (or standard input if FILE is '-' or omitted).\n\n" \
    96     "Options:\n" \
    97     "\t-c\tWrite output to standard output\n" \
    98     "\t-f\tForce"
     125       "Uncompress FILE (or standard input if FILE is '-' or omitted)" \
     126       "\n\nOptions:\n" \
     127       "    -c  Write output to standard output\n" \
     128       "    -f  Force"
    99129
    100130#define busybox_notes_usage \
    101     "Hello world!\n"
     131       "Hello world!\n"
    102132
    103133#define bzcat_trivial_usage \
    104     "FILE"
     134       "FILE"
    105135#define bzcat_full_usage \
    106     "Uncompress to stdout."
     136       "Uncompress to stdout"
    107137
    108138#define unlzma_trivial_usage \
    109     "[OPTION]... [FILE]"
     139       "[OPTION]... [FILE]"
    110140#define unlzma_full_usage \
    111     "Uncompress FILE (or standard input if FILE is '-' or omitted).\n\n" \
    112     "Options:\n" \
    113     "\t-c\tWrite output to standard output\n" \
    114     "\t-f\tForce"
     141       "Uncompress FILE (or standard input if FILE is '-' or omitted)" \
     142       "\n\nOptions:\n" \
     143       "    -c  Write output to standard output\n" \
     144       "    -f  Force"
    115145
    116146#define lzmacat_trivial_usage \
    117     "FILE"
     147       "FILE"
    118148#define lzmacat_full_usage \
    119     "Uncompress to stdout."
     149       "Uncompress to stdout"
    120150
    121151#define cal_trivial_usage \
    122     "[-jy] [[month] year]"
     152       "[-jy] [[month] year]"
    123153#define cal_full_usage \
    124     "Display a calendar.\n" \
    125     "\nOptions:\n" \
    126     "\t-j\tUse julian dates\n" \
    127     "\t-y\tDisplay the entire year"
     154       "Display a calendar" \
     155       "\n\nOptions:" \
     156       "\n  -j  Use julian dates" \
     157       "\n  -y  Display the entire year"
    128158
    129159#define cat_trivial_usage \
    130     "[-u] [FILE]..."
     160       "[-u] [FILE]..."
    131161#define cat_full_usage \
    132     "Concatenates FILE(s) and prints them to stdout.\n\n" \
    133     "Options:\n" \
    134     "\t-u\tignored since unbuffered i/o is always used"
     162       "Concatenate FILE(s) and print them to stdout" \
     163       "\n\nOptions:" \
     164       "\n  -u  Use unbuffered i/o (ignored)"
    135165#define cat_example_usage \
    136     "$ cat /proc/uptime\n" \
    137     "110716.72 17.67"
     166       "$ cat /proc/uptime\n" \
     167       "110716.72 17.67"
    138168
    139169#define catv_trivial_usage \
    140     "[-etv] [FILE]..."
     170       "[-etv] [FILE]..."
    141171#define catv_full_usage \
    142     "Display nonprinting characters as ^x or M-x.\n\n"\
    143     "\t-e\tEnd each line with $\n" \
    144     "\t-t\tShow tabs as ^I\n" \
    145     "\t-v\tDon't use ^x or M-x escapes."
     172       "Display nonprinting characters as ^x or M-x" \
     173       "\n\nOptions:\n" \
     174       "    -e  End each line with $\n" \
     175       "    -t  Show tabs as ^I\n" \
     176       "    -v  Don't use ^x or M-x escapes"
    146177#define chattr_trivial_usage \
    147     "[-R] [-+=AacDdijsStTu] [-v version] files..."
     178       "[-R] [-+=AacDdijsStTu] [-v version] files..."
    148179#define chattr_full_usage \
    149     "change file attributes on an ext2 fs\n\n" \
    150     "Modifiers:\n" \
    151     "\t-\tremove attributes\n" \
    152     "\t+\tadd attributes\n" \
    153     "\t=\tset attributes\n" \
    154     "Attributes:\n" \
    155     "\tA\tdon't track atime\n" \
    156     "\ta\tappend mode only\n" \
    157     "\tc\tenable compress\n" \
    158     "\tD\twrite dir contents synchronously\n" \
    159     "\td\tdo not backup with dump\n" \
    160     "\ti\tcannot be modified (immutable)\n" \
    161     "\tj\twrite all data to journal first\n" \
    162     "\ts\tzero disk storage when deleted\n" \
    163     "\tS\twrite file contents synchronously\n" \
    164     "\tt\tdisable tail-merging of partial blocks with other files\n" \
    165     "\tu\tallow file to be undeleted\n" \
    166     "Options:\n" \
    167     "\t-R\trecursively list subdirectories\n" \
    168     "\t-v\tset the file's version/generation number"
     180       "Change file attributes on an ext2 fs\n\n" \
     181       "Modifiers:\n" \
     182       "    -   Remove attributes\n" \
     183       "    +   Add attributes\n" \
     184       "    =   Set attributes\n" \
     185       "Attributes:\n" \
     186       "    A   Don't track atime\n" \
     187       "    a   Append mode only\n" \
     188       "    c   Enable compress\n" \
     189       "    D   Write dir contents synchronously\n" \
     190       "    d   Do not backup with dump\n" \
     191       "    i   Cannot be modified (immutable)\n" \
     192       "    j   Write all data to journal first\n" \
     193       "    s   Zero disk storage when deleted\n" \
     194       "    S   Write file contents synchronously\n" \
     195       "    t   Disable tail-merging of partial blocks with other files\n" \
     196       "    u   Allow file to be undeleted\n" \
     197       "Options:\n" \
     198       "    -R  Recursively list subdirectories\n" \
     199       "    -v  Set the file's version/generation number"
     200
     201#define chcon_trivial_usage \
     202       "[OPTIONS] CONTEXT FILE...\n" \
     203       "    chcon [OPTIONS] [-u USER] [-r ROLE] [-l RANGE] [-t TYPE] FILE...\n" \
     204       "    chcon [OPTIONS] --reference=RFILE FILE...\n"
     205#define chcon_full_usage \
     206       "Change the security context of each FILE to CONTEXT\n" \
     207       "\n  -v, --verbose       Verbose" \
     208       "\n  -c, --changes       Report changes made" \
     209       "\n  -h, --no-dereference    Affect symlinks instead of their targets" \
     210       "\n  -f, --silent, --quiet   Suppress most error messages" \
     211       "\n  --reference=RFILE   Use RFILE's group instead of using a CONTEXT value" \
     212       "\n  -u, --user=USER     Set user USER in the target security context" \
     213       "\n  -r, --role=ROLE     Set role ROLE in the target security context" \
     214       "\n  -t, --type=TYPE     Set type TYPE in the target security context" \
     215       "\n  -l, --range=RANGE   Set range RANGE in the target security context" \
     216       "\n  -R, --recursive     Recurse subdirectories" \
     217
     218#define chmod_trivial_usage \
     219       "[-R"USE_DESKTOP("cvf")"] MODE[,MODE]... FILE..."
     220#define chmod_full_usage \
     221       "Each MODE is one or more of the letters ugoa, one of the\n" \
     222       "symbols +-= and one or more of the letters rwxst" \
     223       "\n\nOptions:" \
     224       "\n  -R  Recurse directories" \
     225    USE_DESKTOP( \
     226       "\n  -c  List changed files" \
     227       "\n  -v  List all files" \
     228       "\n  -f  Hide errors" \
     229    )
     230#define chmod_example_usage \
     231       "$ ls -l /tmp/foo\n" \
     232       "-rw-rw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n" \
     233       "$ chmod u+x /tmp/foo\n" \
     234       "$ ls -l /tmp/foo\n" \
     235       "-rwxrw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo*\n" \
     236       "$ chmod 444 /tmp/foo\n" \
     237       "$ ls -l /tmp/foo\n" \
     238       "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
    169239
    170240#define chgrp_trivial_usage \
    171     "[OPTION]... GROUP FILE..."
     241       "[-RhLHP"USE_DESKTOP("cvf")"]... GROUP FILE..."
    172242#define chgrp_full_usage \
    173     "Change the group membership of each FILE to GROUP.\n" \
    174     "\nOptions:\n" \
    175     "\t-R\tChanges files and directories recursively"
     243       "Change the group membership of each FILE to GROUP" \
     244       "\n\nOptions:" \
     245       "\n  -R  Recurse directories" \
     246       "\n  -h  Affect symlinks instead of symlink targets" \
     247       "\n  -L  Traverse all symlinks to directories" \
     248       "\n  -H  Traverse symlinks on command line only" \
     249       "\n  -P  Do not traverse symlinks (default)" \
     250    USE_DESKTOP( \
     251       "\n  -c  List changed files" \
     252       "\n  -v  Verbose" \
     253       "\n  -f  Hide errors" \
     254    )
    176255#define chgrp_example_usage \
    177     "$ ls -l /tmp/foo\n" \
    178     "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
    179     "$ chgrp root /tmp/foo\n" \
    180     "$ ls -l /tmp/foo\n" \
    181     "-r--r--r--    1 andersen root            0 Apr 12 18:25 /tmp/foo\n"
    182 
    183 #define chmod_trivial_usage \
    184     "[-R] MODE[,MODE]... FILE..."
    185 #define chmod_full_usage \
    186     "Each MODE is one or more of the letters ugoa, one of the\n" \
    187     "symbols +-= and one or more of the letters rwxst.\n\n" \
    188     "Options:\n" \
    189     "\t-R\tChanges files and directories recursively"
    190 #define chmod_example_usage \
    191     "$ ls -l /tmp/foo\n" \
    192     "-rw-rw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n" \
    193     "$ chmod u+x /tmp/foo\n" \
    194     "$ ls -l /tmp/foo\n" \
    195     "-rwxrw-r--    1 root     root            0 Apr 12 18:25 /tmp/foo*\n" \
    196     "$ chmod 444 /tmp/foo\n" \
    197     "$ ls -l /tmp/foo\n" \
    198     "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
     256       "$ ls -l /tmp/foo\n" \
     257       "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
     258       "$ chgrp root /tmp/foo\n" \
     259       "$ ls -l /tmp/foo\n" \
     260       "-r--r--r--    1 andersen root            0 Apr 12 18:25 /tmp/foo\n"
    199261
    200262#define chown_trivial_usage \
    201     "[ -Rh ]... OWNER[<.|:>[GROUP]] FILE..."
     263       "[-RhLHP"USE_DESKTOP("cvf")"]... OWNER[<.|:>[GROUP]] FILE..."
    202264#define chown_full_usage \
    203     "Change the owner and/or group of each FILE to OWNER and/or GROUP.\n" \
    204     "\nOptions:\n" \
    205     "\t-R\tChanges files and directories recursively\n" \
    206     "\t-h\tDo not dereference symbolic links"
     265       "Change the owner and/or group of each FILE to OWNER and/or GROUP" \
     266       "\n\nOptions:" \
     267       "\n  -R  Recurse directories" \
     268       "\n  -h  Affect symlinks instead of symlink targets" \
     269       "\n  -L  Traverse all symlinks to directories" \
     270       "\n  -H  Traverse symlinks on command line only" \
     271       "\n  -P  Do not traverse symlinks (default)" \
     272    USE_DESKTOP( \
     273       "\n  -c  List changed files" \
     274       "\n  -v  List all files" \
     275       "\n  -f  Hide errors" \
     276    )
    207277#define chown_example_usage \
    208     "$ ls -l /tmp/foo\n" \
    209     "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
    210     "$ chown root /tmp/foo\n" \
    211     "$ ls -l /tmp/foo\n" \
    212     "-r--r--r--    1 root     andersen        0 Apr 12 18:25 /tmp/foo\n" \
    213     "$ chown root.root /tmp/foo\n" \
    214     "ls -l /tmp/foo\n" \
    215     "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
     278       "$ ls -l /tmp/foo\n" \
     279       "-r--r--r--    1 andersen andersen        0 Apr 12 18:25 /tmp/foo\n" \
     280       "$ chown root /tmp/foo\n" \
     281       "$ ls -l /tmp/foo\n" \
     282       "-r--r--r--    1 root     andersen        0 Apr 12 18:25 /tmp/foo\n" \
     283       "$ chown root.root /tmp/foo\n" \
     284       "ls -l /tmp/foo\n" \
     285       "-r--r--r--    1 root     root            0 Apr 12 18:25 /tmp/foo\n"
     286
     287#define chpst_trivial_usage \
     288       "[-vP012] [-u user[:group]] [-U user[:group]] [-e dir] " \
     289       "[-/ dir] [-n nice] [-m bytes] [-d bytes] [-o files] " \
     290       "[-p processes] [-f bytes] [-c bytes] prog args"
     291#define chpst_full_usage \
     292       "Change the process state and run specified program" \
     293       "\n\nOptions:\n" \
     294       "    -u user[:grp]   Set uid and gid\n" \
     295       "    -U user[:grp]   Set environment variables UID and GID\n" \
     296       "    -e dir      Set environment variables as specified by files\n" \
     297       "            in the directory: file=1st_line_of_file\n" \
     298       "    -/ dir      Chroot to dir\n" \
     299       "    -n inc      Add inc to nice value\n" \
     300       "    -m bytes    Limit data segment, stack segment, locked physical pages,\n" \
     301       "            and total of all segment per process to bytes bytes each\n" \
     302       "    -d bytes    Limit data segment\n" \
     303       "    -o n        Limit the number of open file descriptors per process to n\n" \
     304       "    -p n        Limit number of processes per uid to n\n" \
     305       "    -f bytes    Limit output file size to bytes bytes\n" \
     306       "    -c bytes    Limit core file size to bytes bytes\n" \
     307       "    -v      Verbose\n" \
     308       "    -P      Run prog in a new process group\n" \
     309       "    -0      Close standard input\n" \
     310       "    -1      Close standard output\n" \
     311       "    -2      Close standard error"
     312#define setuidgid_trivial_usage \
     313       "account prog args"
     314#define setuidgid_full_usage \
     315       "Set uid and gid to account's uid and gid, removing all supplementary\n" \
     316       "groups, then run prog"
     317#define envuidgid_trivial_usage \
     318       "account prog args"
     319#define envuidgid_full_usage \
     320       "Set $UID to account's uid and $GID to account's gid, then run prog"
     321#define envdir_trivial_usage \
     322       "dir prog args"
     323#define envdir_full_usage \
     324       "Set various environment variables as specified by files\n" \
     325       "in the directory dir, then run prog"
     326#define softlimit_trivial_usage \
     327       "[-a allbytes] [-c corebytes] [-d databytes] [-f filebytes] " \
     328       "[-l lockbytes] [-m membytes] [-o openfiles] [-p processes] " \
     329       "[-r residentbytes] [-s stackbytes] [-t cpusecs] prog args"
     330#define softlimit_full_usage \
     331       "Set soft resource limits, then run prog" \
     332       "\n\nOptions:\n" \
     333       "    -m n    Same as -d n -s n -l n -a n\n" \
     334       "    -d n    Limit the data segment per process to n bytes\n" \
     335       "    -s n    Limit the stack segment per process to n bytes\n" \
     336       "    -l n    Limit the locked physical pages per process to n bytes\n" \
     337       "    -a n    Limit the total of all segments per process to n bytes\n" \
     338       "    -o n    Limit the number of open file descriptors per process to n\n" \
     339       "    -p n    Limit the number of processes per uid to n\n" \
     340       "Options controlling file sizes:\n" \
     341       "    -f n    Limit output file sizes to n bytes\n" \
     342       "    -c n    Limit core file sizes to n bytes\n" \
     343       "Efficiency opts:\n" \
     344       "    -r n    Limit the resident set size to n bytes. This limit is not\n" \
     345       "        enforced unless physical memory is full\n" \
     346       "    -t n    Limit the CPU time to n seconds. This limit is not enforced\n" \
     347       "        except that the process receives a SIGXCPU signal after n seconds\n" \
     348       "\n" \
     349       "Some options may have no effect on some operating systems\n" \
     350       "n may be =, indicating that soft limit should be set equal to hard limit"
    216351
    217352#define chroot_trivial_usage \
    218     "NEWROOT [COMMAND...]"
     353       "NEWROOT [COMMAND...]"
    219354#define chroot_full_usage \
    220     "Run COMMAND with root directory set to NEWROOT."
     355       "Run COMMAND with root directory set to NEWROOT"
    221356#define chroot_example_usage \
    222     "$ ls -l /bin/ls\n" \
    223     "lrwxrwxrwx    1 root     root          12 Apr 13 00:46 /bin/ls -> /BusyBox\n" \
    224     "# mount /dev/hdc1 /mnt -t minix\n" \
    225     "# chroot /mnt\n" \
    226     "# ls -l /bin/ls\n" \
    227     "-rwxr-xr-x    1 root     root        40816 Feb  5 07:45 /bin/ls*\n"
     357       "$ ls -l /bin/ls\n" \
     358       "lrwxrwxrwx    1 root     root          12 Apr 13 00:46 /bin/ls -> /BusyBox\n" \
     359       "# mount /dev/hdc1 /mnt -t minix\n" \
     360       "# chroot /mnt\n" \
     361       "# ls -l /bin/ls\n" \
     362       "-rwxr-xr-x    1 root     root        40816 Feb  5 07:45 /bin/ls*\n"
    228363
    229364#define chvt_trivial_usage \
    230     "N"
     365       "N"
    231366#define chvt_full_usage \
    232     "Changes the foreground virtual terminal to /dev/ttyN"
     367       "Change the foreground virtual terminal to /dev/ttyN"
    233368
    234369#define cksum_trivial_usage \
    235     "FILES..."
     370       "FILES..."
    236371#define cksum_full_usage \
    237     "Calculates the CRC32 checksums of FILES."
     372       "Calculate the CRC32 checksums of FILES"
    238373
    239374#define clear_trivial_usage \
    240     ""
     375       ""
    241376#define clear_full_usage \
    242     "Clear screen."
     377       "Clear screen"
    243378
    244379#define cmp_trivial_usage \
    245     "[-l] [-s] FILE1 [FILE2]"
     380       "[-l] [-s] FILE1 [FILE2" USE_DESKTOP(" [SKIP1 [SKIP2]") "]]"
    246381#define cmp_full_usage \
    247     "Compares FILE1 vs stdin if FILE2 is not specified.\n\n" \
    248     "Options:\n" \
    249     "\t-l\tWrite the byte numbers (decimal) and values (octal)\n" \
    250     "\t\t  for all differing bytes\n" \
    251     "\t-s\tquiet mode - do not print"
     382       "Compares FILE1 vs stdin if FILE2 is not specified" \
     383       "\n\nOptions:\n" \
     384       "    -l  Write the byte numbers (decimal) and values (octal)\n" \
     385       "        for all differing bytes\n" \
     386       "    -s  Quiet"
    252387
    253388#define comm_trivial_usage \
    254     "[-123] FILE1 FILE2"
     389       "[-123] FILE1 FILE2"
    255390#define comm_full_usage \
    256     "Compares FILE1 to FILE2, or to stdin if = is specified.\n\n" \
    257     "Options:\n" \
    258     "\t-1\tSuppress lines unique to FILE1\n" \
    259     "\t-2\tSuppress lines unique to FILE2\n" \
    260     "\t-3\tSuppress lines common to both files"
     391       "Compare FILE1 to FILE2, or to stdin if - is specified" \
     392       "\n\nOptions:\n" \
     393       "    -1  Suppress lines unique to FILE1\n" \
     394       "    -2  Suppress lines unique to FILE2\n" \
     395       "    -3  Suppress lines common to both files"
    261396
    262397#define bbconfig_trivial_usage \
    263     ""
     398       ""
    264399#define bbconfig_full_usage \
    265     "Print the config file which built busybox"
     400       "Print the config file which built busybox"
     401
     402#define bbsh_trivial_usage \
     403       "[FILE]...\n" \
     404       "or: bbsh -c command [args]..."
     405#define bbsh_full_usage \
     406       "The bbsh shell (command interpreter)"
     407
     408#define chrt_trivial_usage \
     409       "[OPTION]... [prio] [pid | command [arg]...]"
     410#define chrt_full_usage \
     411       "manipulate real-time attributes of a process" \
     412       "\n\nOptions:\n" \
     413       "    -p  operate on pid\n" \
     414       "    -r  set scheduling policy to SCHED_RR\n" \
     415       "    -f  set scheduling policy to SCHED_FIFO\n" \
     416       "    -o  set scheduling policy to SCHED_OTHER\n" \
     417       "    -m  show min and max priorities"
     418
     419#define chrt_example_usage \
     420       "$ chrt -r 4 sleep 900; x=$!\n" \
     421       "$ chrt -f -p 3 $x\n" \
     422       "You need CAP_SYS_NICE privileges to set scheduling attributes of a process"
    266423
    267424#define cp_trivial_usage \
    268     "[OPTION]... SOURCE DEST"
     425       "[OPTION]... SOURCE DEST"
    269426#define cp_full_usage \
    270     "Copies SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.\n" \
    271     "\n" \
    272     "\t-a\tSame as -dpR\n" \
    273     "\t-d,-P\tPreserves links\n" \
    274     "\t-H,-L\tDereference all symlinks (implied by default)\n" \
    275     "\t-p\tPreserves file attributes if possible\n" \
    276     "\t-f\tforce (implied; ignored) - always set\n" \
    277     "\t-i\tinteractive, prompt before overwrite\n" \
    278     "\t-R,-r\tCopies directories recursively"
     427       "Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY" \
     428       "\n\nOptions:" \
     429       "\n  -a  Same as -dpR" \
     430    USE_SELINUX( \
     431       "\n  -c  Preserves security context" \
     432    ) \
     433       "\n  -d,-P   Preserve links" \
     434       "\n  -H,-L   Dereference all symlinks (default)" \
     435       "\n  -p  Preserve file attributes if possible" \
     436       "\n  -f  Force overwrite" \
     437       "\n  -i  Prompt before overwrite" \
     438       "\n  -R,-r   Recurse directories" \
     439       "\n  -l,-s   Create (sym)links"
    279440
    280441#define cpio_trivial_usage \
    281     "-[dimtuv][F cpiofile]"
     442       "-[dimtuv][F cpiofile]"
    282443#define cpio_full_usage \
    283     "Extract or list files from a cpio archive\n" \
    284     "Main operation mode:\n" \
    285     "\td\t\tmake leading directories\n" \
    286     "\ti\t\textract\n" \
    287     "\tm\t\tpreserve mtime\n" \
    288     "\tt\t\tlist\n" \
    289     "\tv\t\tverbose\n" \
    290     "\tu\t\tunconditional overwrite\n" \
    291     "\tF\t\tinput from file"
     444       "Extract or list files from a cpio archive\n" \
     445       "Main operation mode:\n" \
     446       "    d   Make leading directories\n" \
     447       "    i   Extract\n" \
     448       "    m   Preserve mtime\n" \
     449       "    t   List\n" \
     450       "    v   Verbose\n" \
     451       "    u   Unconditional overwrite\n" \
     452       "    F   Input from file"
    292453
    293454#define crond_trivial_usage \
    294     "-d[#] -c <crondir> -f -b"
     455       "-d[#] -c crondir -f -b"
    295456#define crond_full_usage \
    296     "\t-d [#] -l [#] -S -L logfile -f -b -c dir\n" \
    297     "\t-d num\tdebug level\n" \
    298     "\t-l num\tlog level (8 - default)\n" \
    299     "\t-S\tlog to syslogd (default)\n" \
    300     "\t-L file\tlog to file\n" \
    301     "\t-f\trun in foreground\n" \
    302     "\t-b\trun in background (default)\n" \
    303     "\t-c dir\tworking dir"
     457       "    -d [#] -l [#] -S -L logfile -f -b -c dir\n" \
     458       "    -d num  Debug level\n" \
     459       "    -l num  Log level (8 - default)\n" \
     460       "    -S  Log to syslogd (default)\n" \
     461       "    -L file Log to file\n" \
     462       "    -f  Run in foreground\n" \
     463       "    -b  Run in background (default)\n" \
     464       "    -c dir  Working dir"
    304465
    305466#define crontab_trivial_usage \
    306     "[-c dir] {file|-}|[-u|-l|-e|-d user]"
     467       "[-c dir] {file|-}|[-u|-l|-e|-d user]"
    307468#define crontab_full_usage \
    308     "\tfile <opts>  replace crontab from file\n" \
    309     "\t-    <opts>  replace crontab from stdin\n" \
    310     "\t-u user      specify user\n" \
    311     "\t-l [user]    list crontab for user\n" \
    312     "\t-e [user]    edit crontab for user\n" \
    313     "\t-d [user]    delete crontab for user\n" \
    314     "\t-c dir       specify crontab directory"
    315 
     469       "    file [opts] Replace crontab from file\n" \
     470       "    - [opts]    Replace crontab from stdin\n" \
     471       "    -u user     Specify user\n" \
     472       "    -l [user]   List crontab for user\n" \
     473       "    -e [user]   Edit crontab for user\n" \
     474       "    -d [user]   Delete crontab for user\n" \
     475       "    -c dir      Specify crontab directory"
     476
     477#define cryptpw_trivial_usage \
     478       "[-a des|md5] [string]"
     479#define cryptpw_full_usage \
     480       "Outputs crypted string.\n" \
     481       "If string isn't supplied on cmdline, reads it from stdin.\n" \
     482       "\nOptions:" \
     483       "\n  -a  Algorithm to use (default: md5)"
    316484
    317485#define cut_trivial_usage \
    318     "[OPTION]... [FILE]..."
     486       "[OPTION]... [FILE]..."
    319487#define cut_full_usage \
    320     "Prints selected fields from each input FILE to standard output.\n\n" \
    321     "Options:\n" \
    322     "\t-b LIST\t\tOutput only bytes from LIST\n" \
    323     "\t-c LIST\t\tOutput only characters from LIST\n" \
    324     "\t-d CHAR\t\tUse CHAR instead of tab as the field delimiter\n" \
    325     "\t-s\t\tOutput only the lines containing delimiter\n" \
    326     "\t-f N\t\tPrint only these fields\n" \
    327     "\t-n\t\tIgnored"
     488       "Print selected fields from each input FILE to standard output" \
     489       "\n\nOptions:\n" \
     490       "    -b LIST Output only bytes from LIST\n" \
     491       "    -c LIST Output only characters from LIST\n" \
     492       "    -d CHAR Use CHAR instead of tab as the field delimiter\n" \
     493       "    -s  Output only the lines containing delimiter\n" \
     494       "    -f N    Print only these fields\n" \
     495       "    -n  Ignored"
    328496#define cut_example_usage \
    329     "$ echo \"Hello world\" | cut -f 1 -d ' '\n" \
    330     "Hello\n" \
    331     "$ echo \"Hello world\" | cut -f 2 -d ' '\n" \
    332     "world\n"
     497       "$ echo \"Hello world\" | cut -f 1 -d ' '\n" \
     498       "Hello\n" \
     499       "$ echo \"Hello world\" | cut -f 2 -d ' '\n" \
     500       "world\n"
    333501
    334502#define date_trivial_usage \
    335     "[OPTION]... [MMDDhhmm[[CC]YY][.ss]] [+FORMAT]"
     503       "[OPTION]... [MMDDhhmm[[CC]YY][.ss]] [+FORMAT]"
    336504#define date_full_usage \
    337     "Displays the current time in the given FORMAT, or sets the system date.\n" \
    338     "\nOptions:\n" \
    339     "\t-R\t\tOutputs RFC-822 compliant date string\n" \
    340     "\t-d STRING\tDisplays time described by STRING, not `now'\n" \
    341 USE_FEATURE_DATE_ISOFMT( \
    342     "\t-I[TIMESPEC]\tOutputs an ISO-8601 compliant date/time string\n" \
    343     "\t\t\tTIMESPEC=`date' (or missing) for date only,\n" \
    344     "\t\t\t`hours', `minutes', or `seconds' for date and,\n" \
    345     "\t\t\ttime to the indicated precision\n" \
    346     "\t-D hint\t\tUse 'hint' as date format, via strptime()\n" \
    347 ) \
    348     "\t-s\t\tSets time described by STRING\n" \
    349     "\t-r FILE\t\tDisplays the last modification time of FILE\n" \
    350     "\t-u\t\tPrints or sets Coordinated Universal Time"
     505       "Display current time in the given FORMAT, or set system date" \
     506       "\n\nOptions:\n" \
     507       "    -R      Outputs RFC-822 compliant date string\n" \
     508       "    -d STRING   Displays time described by STRING, not 'now'\n" \
     509    USE_FEATURE_DATE_ISOFMT( \
     510       "    -I[TIMESPEC]    Outputs an ISO-8601 compliant date/time string\n" \
     511       "            TIMESPEC='date' (or missing) for date only,\n" \
     512       "            'hours', 'minutes', or 'seconds' for date and,\n" \
     513       "            time to the indicated precision\n" \
     514       "    -D hint     Use 'hint' as date format, via strptime()\n" \
     515    ) \
     516       "    -s      Sets time described by STRING\n" \
     517       "    -r FILE     Displays the last modification time of FILE\n" \
     518       "    -u      Prints or sets Coordinated Universal Time"
    351519#define date_example_usage \
    352     "$ date\n" \
    353     "Wed Apr 12 18:52:41 MDT 2000\n"
     520       "$ date\n" \
     521       "Wed Apr 12 18:52:41 MDT 2000\n"
    354522
    355523#define dc_trivial_usage \
    356     "expression ..."
     524       "expression ..."
    357525#define dc_full_usage \
    358     "This is a Tiny RPN calculator that understands the\n" \
    359     "following operations: +, add, -, sub, *, mul, /, div, %, mod, " \
    360     "**, exp, and, or, not, eor.\n" \
    361     "For example: 'dc 2 2 add' -> 4, and 'dc 8 8 \\* 2 2 + /' -> 16.\n" \
    362     "\nOptions:\n" \
    363     "p - Prints the value on the top of the stack, without altering the stack\n" \
    364     "f - Prints the entire contents of the stack without altering anything\n" \
    365     "o - Pops the value off the top of the stack and uses it to set the output radix\n" \
    366     "    Only 10 and 16 are supported"
     526       "This is a Tiny RPN calculator that understands the\n" \
     527       "following operations: +, add, -, sub, *, mul, /, div, %, mod, " \
     528       "**, exp, and, or, not, eor.\n" \
     529       "For example: 'dc 2 2 add' -> 4, and 'dc 8 8 \\* 2 2 + /' -> 16." \
     530       "\n\nOptions:\n" \
     531       "p - Prints the value on the top of the stack, without altering the stack\n" \
     532       "f - Prints the entire contents of the stack without altering anything\n" \
     533       "o - Pops the value off the top of the stack and uses it to set the output radix\n" \
     534       "    Only 10 and 16 are supported"
    367535#define dc_example_usage \
    368     "$ dc 2 2 + p\n" \
    369     "4\n" \
    370     "$ dc 8 8 \\* 2 2 + / p\n" \
    371     "16\n" \
    372     "$ dc 0 1 and p\n" \
    373     "0\n" \
    374     "$ dc 0 1 or p\n" \
    375     "1\n" \
    376     "$ echo 72 9 div 8 mul p | dc\n" \
    377     "64\n"
     536       "$ dc 2 2 + p\n" \
     537       "4\n" \
     538       "$ dc 8 8 \\* 2 2 + / p\n" \
     539       "16\n" \
     540       "$ dc 0 1 and p\n" \
     541       "0\n" \
     542       "$ dc 0 1 or p\n" \
     543       "1\n" \
     544       "$ echo 72 9 div 8 mul p | dc\n" \
     545       "64\n"
    378546
    379547#define dd_trivial_usage \
    380     "[if=FILE] [of=FILE] " USE_FEATURE_DD_IBS_OBS("[ibs=N] [obs=N] ") "[bs=N] [count=N] [skip=N]\n" \
    381     "\t  [seek=N]" USE_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync]")
     548       "[if=FILE] [of=FILE] " USE_FEATURE_DD_IBS_OBS("[ibs=N] [obs=N] ") "[bs=N] [count=N] [skip=N]\n" \
     549       "    [seek=N]" USE_FEATURE_DD_IBS_OBS(" [conv=notrunc|noerror|sync]")
    382550#define dd_full_usage \
    383     "Copy a file, converting and formatting according to options\n\n" \
    384     "\tif=FILE\t\tread from FILE instead of stdin\n" \
    385     "\tof=FILE\t\twrite to FILE instead of stdout\n" \
    386     "\tbs=N\t\tread and write N bytes at a time\n" \
    387     USE_FEATURE_DD_IBS_OBS("\tibs=N\t\tread N bytes at a time\n") \
    388     USE_FEATURE_DD_IBS_OBS("\tobs=N\t\twrite N bytes at a time\n") \
    389     "\tcount=N\t\tcopy only N input blocks\n" \
    390     "\tskip=N\t\tskip N input blocks\n" \
    391     "\tseek=N\t\tskip N output blocks\n" \
     551       "Copy a file with converting and formatting" \
     552       "\n\nOptions:\n" \
     553       "    if=FILE     Read from FILE instead of stdin\n" \
     554       "    of=FILE     Write to FILE instead of stdout\n" \
     555       "    bs=N        Read and write N bytes at a time\n" \
    392556    USE_FEATURE_DD_IBS_OBS( \
    393         "\tconv=notrunc\tdon't truncate output file\n" \
    394         "\tconv=noerror\tcontinue after read errors\n" \
    395         "\tconv=sync\tpad blocks with zeros\n" \
    396     ) \
    397     "\n" \
    398     "Numbers may be suffixed by c (x1), w (x2), b (x512), kD (x1000), k (x1024),\n" \
    399     "MD (x1000000), M (x1048576), GD (x1000000000) or G (x1073741824)"
     557       "    ibs=N       Read N bytes at a time\n") \
     558    USE_FEATURE_DD_IBS_OBS( \
     559       "    obs=N       Write N bytes at a time\n") \
     560       "    count=N     Copy only N input blocks\n" \
     561       "    skip=N      Skip N input blocks\n" \
     562       "    seek=N      Skip N output blocks\n" \
     563    USE_FEATURE_DD_IBS_OBS( \
     564       "    conv=notrunc    Don't truncate output file\n" \
     565       "    conv=noerror    Continue after read errors\n" \
     566       "    conv=sync   Pad blocks with zeros\n") \
     567       "\n" \
     568       "Numbers may be suffixed by c (x1), w (x2), b (x512), kD (x1000), k (x1024),\n" \
     569       "MD (x1000000), M (x1048576), GD (x1000000000) or G (x1073741824)"
    400570#define dd_example_usage \
    401     "$ dd if=/dev/zero of=/dev/ram1 bs=1M count=4\n" \
    402     "4+0 records in\n" \
    403     "4+0 records out\n"
     571       "$ dd if=/dev/zero of=/dev/ram1 bs=1M count=4\n" \
     572       "4+0 records in\n" \
     573       "4+0 records out\n"
    404574
    405575#define deallocvt_trivial_usage \
    406     "[N]"
     576       "[N]"
    407577#define deallocvt_full_usage \
    408     "Deallocate unused virtual terminal /dev/ttyN"
     578      "Deallocate unused virtual terminal /dev/ttyN"
    409579
    410580#define delgroup_trivial_usage \
    411     "GROUP"
     581    USE_FEATURE_DEL_USER_FROM_GROUP("[USER] ")"GROUP"
    412582#define delgroup_full_usage \
    413      "Deletes group GROUP from the system"
     583       "Delete group GROUP from the system" \
     584    USE_FEATURE_DEL_USER_FROM_GROUP(" or user USER from group GROUP")
    414585
    415586#define deluser_trivial_usage \
    416     "USER"
     587       "USER"
    417588#define deluser_full_usage \
    418      "Deletes user USER from the system"
     589       "Delete user USER from the system"
    419590
    420591#define devfsd_trivial_usage \
    421     "mntpnt [-v]" \
     592       "mntpnt [-v]" \
    422593    USE_DEVFSD_FG_NP("[-fg][-np]" )
    423594#define devfsd_full_usage \
    424     "Optional daemon for managing devfs permissions and old device name symlinks.\n" \
    425     "\nOptions:\n" \
    426     "\tmntpnt\tThe mount point where devfs is mounted.\n\n" \
    427     "\t-v\tPrint the protocol version numbers for devfsd\n" \
    428     "\t\tand the kernel-side protocol version and exits." \
    429     USE_DEVFSD_FG_NP( "\n\n\t-fg\tRun the daemon in the foreground.\n\n" \
    430     "\t-np\tExit  after  parsing  the configuration file\n" \
    431     "\t\tand processing synthetic REGISTER events.\n" \
    432     "\t\tDo not poll for events.")
     595       "Manage devfs permissions and old device name symlinks" \
     596       "\n\nOptions:" \
     597       "\n  mntpnt  The mount point where devfs is mounted" \
     598       "\n  -v  Print the protocol version numbers for devfsd" \
     599       "\n      and the kernel-side protocol version and exits" \
     600    USE_DEVFSD_FG_NP( \
     601       "\n  -fg Run the daemon in the foreground" \
     602       "\n  -np Exit after parsing the configuration file" \
     603       "\n      and processing synthetic REGISTER events," \
     604       "\n      do not poll for events")
    433605
    434606#define df_trivial_usage \
    435     "[-" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILESYSTEM ...]"
     607       "[-" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILESYSTEM ...]"
    436608#define df_full_usage \
    437     "Print the filesystem space used and space available.\n\n" \
    438     "Options:\n" \
     609       "Print the filesystem space used and space available" \
    439610    USE_FEATURE_HUMAN_READABLE( \
    440         "\n\t-h\tprint sizes in human readable format (e.g., 1K 243M 2G )\n" \
    441         "\t-m\tprint sizes in megabytes\n" \
    442         "\t-k\tprint sizes in kilobytes(default)" \
    443     ) \
    444     SKIP_FEATURE_HUMAN_READABLE("\n\t-k\tignored")
     611       "\n\nOptions control size display:" \
     612       "\n  -h  Human readable (e.g. 1K 243M 2G)" \
     613       "\n  -m  1024*1024 blocks" \
     614       "\n  -k  1024 blocks") \
     615    SKIP_FEATURE_HUMAN_READABLE( \
     616       "\n\nOptions:" \
     617       "\n  -k  Ignored")
    445618#define df_example_usage \
    446     "$ df\n" \
    447     "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
    448     "/dev/sda3              8690864   8553540    137324  98% /\n" \
    449     "/dev/sda1                64216     36364     27852  57% /boot\n" \
    450     "$ df /dev/sda3\n" \
    451     "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
    452     "/dev/sda3              8690864   8553540    137324  98% /\n"
     619       "$ df\n" \
     620       "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
     621       "/dev/sda3              8690864   8553540    137324  98% /\n" \
     622       "/dev/sda1                64216     36364     27852  57% /boot\n" \
     623       "$ df /dev/sda3\n" \
     624       "Filesystem           1k-blocks      Used Available Use% Mounted on\n" \
     625       "/dev/sda3              8690864   8553540    137324  98% /\n"
     626
     627#define dhcprelay_trivial_usage \
     628       "[client_device_list] [server_device]"
     629#define dhcprelay_full_usage \
     630       "Relay dhcp requests from client devices to server device"
     631
     632#define dhcprelay_trivial_usage \
     633       "[client_device_list] [server_device]"
     634#define dhcprelay_full_usage \
     635       "Relay dhcp requests from client devices to server device"
    453636
    454637#define diff_trivial_usage \
    455     "[-abdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2"
     638       "[-abdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2"
    456639#define diff_full_usage \
    457     "Compare files line by line and output the differences between them.\n" \
    458     "This diff implementation only supports unified diffs.\n\n" \
    459     "Options:\n" \
    460     "\t-a\tTreat all files as text\n" \
    461     "\t-b\tIgnore changes in the amount of whitespace\n" \
    462     "\t-d\tTry hard to find a smaller set of changes\n" \
    463     "\t-i\tIgnore case differences\n" \
    464     "\t-L\tUse LABEL instead of the filename in the unified header\n" \
    465     "\t-N\tTreat absent files as empty\n" \
    466     "\t-q\tOutput only whether files differ\n" \
    467     "\t-r\tRecursively compare any subdirectories\n" \
    468     "\t-S\tStart with FILE when comparing directories\n" \
    469     "\t-T\tMake tabs line up by prefixing a tab when necessary\n" \
    470     "\t-s\tReport when two files are the same\n" \
    471     "\t-t\tExpand tabs to spaces in output\n" \
    472     "\t-U\tOutput LINES lines of context\n" \
    473     "\t-w\tIgnore all whitespace\n"
     640       "Compare files line by line and output the differences between them.\n" \
     641       "This diff implementation only supports unified diffs." \
     642       "\n\nOptions:\n" \
     643       "    -a  Treat all files as text\n" \
     644       "    -b  Ignore changes in the amount of whitespace\n" \
     645       "    -d  Try hard to find a smaller set of changes\n" \
     646       "    -i  Ignore case differences\n" \
     647       "    -L  Use LABEL instead of the filename in the unified header\n" \
     648       "    -N  Treat absent files as empty\n" \
     649       "    -q  Output only whether files differ\n" \
     650       "    -r  Recursively compare subdirectories\n" \
     651       "    -S  Start with FILE when comparing directories\n" \
     652       "    -T  Make tabs line up by prefixing a tab when necessary\n" \
     653       "    -s  Report when two files are the same\n" \
     654       "    -t  Expand tabs to spaces in output\n" \
     655       "    -U  Output LINES lines of context\n" \
     656       "    -w  Ignore all whitespace"
    474657
    475658#define dirname_trivial_usage \
    476     "FILENAME"
     659       "FILENAME"
    477660#define dirname_full_usage \
    478     "Strips non-directory suffix from FILENAME"
     661       "Strip non-directory suffix from FILENAME"
    479662#define dirname_example_usage \
    480     "$ dirname /tmp/foo\n" \
    481     "/tmp\n" \
    482     "$ dirname /tmp/foo/\n" \
    483     "/tmp\n"
     663       "$ dirname /tmp/foo\n" \
     664       "/tmp\n" \
     665       "$ dirname /tmp/foo/\n" \
     666       "/tmp\n"
    484667
    485668#define dmesg_trivial_usage \
    486     "[-c] [-n LEVEL] [-s SIZE]"
     669       "[-c] [-n LEVEL] [-s SIZE]"
    487670#define dmesg_full_usage \
    488     "Prints or controls the kernel ring buffer\n\n" \
    489     "Options:\n" \
    490     "\t-c\t\tClears the ring buffer's contents after printing\n" \
    491     "\t-n LEVEL\tSets console logging level\n" \
    492     "\t-s SIZE\t\tUse a buffer of size SIZE"
     671       "Print or control the kernel ring buffer" \
     672       "\n\nOptions:\n" \
     673       "    -c      Clears the ring buffer's contents after printing\n" \
     674       "    -n LEVEL    Sets console logging level\n" \
     675       "    -s SIZE     Use a buffer of size SIZE"
    493676
    494677#define dnsd_trivial_usage \
    495         "[-c config] [-t seconds] [-p port] [-i iface-ip] [-d]"
     678       "[-c config] [-t seconds] [-p port] [-i iface-ip] [-d]"
    496679#define dnsd_full_usage \
    497         "Small and static DNS server daemon\n\n" \
    498     "Options:\n" \
    499     "\t-c\t\tconfig filename\n" \
    500     "\t-t\t\tTTL in seconds\n" \
    501     "\t-p\t\tlistening port\n" \
    502     "\t-i\t\tlistening iface ip (default all)\n" \
    503     "\t-d\t\tdaemonize"
     680       "Small and static DNS server daemon" \
     681       "\n\nOptions:\n" \
     682       "    -c  Config filename\n" \
     683       "    -t  TTL in seconds\n" \
     684       "    -p  Listening port\n" \
     685       "    -i  Listening ip (default all)\n" \
     686       "    -d  Daemonize"
    504687
    505688#define dos2unix_trivial_usage \
    506     "[option] [FILE]"
     689       "[option] [FILE]"
    507690#define dos2unix_full_usage \
    508     "Converts FILE from dos format to unix format. When no option\n" \
    509     "is given, the input is converted to the opposite output format.\n" \
    510     "When no file is given, uses stdin for input and stdout for output.\n\n" \
    511     "Options:\n" \
    512     "\t-u\toutput will be in UNIX format\n" \
    513     "\t-d\toutput will be in DOS format"
     691       "Convert FILE from dos format to unix format. When no option\n" \
     692       "is given, the input is converted to the opposite output format.\n" \
     693       "When no file is given, use stdin for input and stdout for output." \
     694       "\n\nOptions:\n" \
     695       "    -u  Output will be in UNIX format\n" \
     696       "    -d  Output will be in DOS format"
    514697
    515698#define dpkg_trivial_usage \
    516     "[-ilCPru] [-F option] package_name"
     699       "[-ilCPru] [-F option] package_name"
    517700#define dpkg_full_usage \
    518     "dpkg is a utility to install, remove and manage Debian packages.\n\n" \
    519     "Options:\n" \
    520     "\t-i\t\tInstall the package\n" \
    521     "\t-l\t\tList of installed packages\n" \
    522     "\t-C\t\tConfigure an unpackaged package\n" \
    523     "\t-F depends\tIgnore dependency problems\n" \
    524     "\t-P\t\tPurge all files of a package\n" \
    525     "\t-r\t\tRemove all but the configuration files for a package\n" \
    526     "\t-u\t\tUnpack a package, but don't configure it"
     701       "Install, remove and manage Debian packages" \
     702       "\n\nOptions:\n" \
     703       "    -i      Install the package\n" \
     704       "    -l      List of installed packages\n" \
     705       "    -C      Configure an unpackaged package\n" \
     706       "    -F depends  Ignore dependency problems\n" \
     707       "    -P      Purge all files of a package\n" \
     708       "    -r      Remove all but the configuration files for a package\n" \
     709       "    -u      Unpack a package, but don't configure it"
    527710
    528711#define dpkg_deb_trivial_usage \
    529     "[-cefxX] FILE [argument]"
     712       "[-cefxX] FILE [argument]"
    530713#define dpkg_deb_full_usage \
    531     "Perform actions on Debian packages (.debs)\n\n" \
    532     "Options:\n" \
    533     "\t-c\tList contents of filesystem tree\n" \
    534     "\t-e\tExtract control files to [argument] directory\n" \
    535     "\t-f\tDisplay control field name starting with [argument]\n" \
    536     "\t-x\tExtract packages filesystem tree to directory\n" \
    537     "\t-X\tVerbose extract"
     714       "Perform actions on Debian packages (.debs)" \
     715       "\n\nOptions:\n" \
     716       "    -c  List contents of filesystem tree\n" \
     717       "    -e  Extract control files to [argument] directory\n" \
     718       "    -f  Display control field name starting with [argument]\n" \
     719       "    -x  Extract packages filesystem tree to directory\n" \
     720       "    -X  Verbose extract"
    538721#define dpkg_deb_example_usage \
    539     "$ dpkg-deb -X ./busybox_0.48-1_i386.deb /tmp\n"
     722       "$ dpkg-deb -X ./busybox_0.48-1_i386.deb /tmp\n"
    540723
    541724#define du_trivial_usage \
    542     "[-aHLdclsx" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILE]..."
     725       "[-aHLdclsx" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILE]..."
    543726#define du_full_usage \
    544     "Summarizes disk space used for each FILE and/or directory.\n" \
    545     "Disk space is printed in units of " \
     727       "Summarize disk space used for each FILE and/or directory.\n" \
     728       "Disk space is printed in units of " \
    546729    USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("1024") \
    547730    SKIP_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("512") \
    548     " bytes.\n\n" \
    549     "Options:\n" \
    550     "\t-a\tshow sizes of files in addition to directories\n" \
    551     "\t-H\tfollow symbolic links that are FILE command line args\n" \
    552     "\t-L\tfollow all symbolic links encountered\n" \
    553     "\t-d N\tlimit output to directories (and files with -a) of depth < N\n" \
    554     "\t-c\toutput a grand total\n" \
    555     "\t-l\tcount sizes many times if hard linked\n" \
    556     "\t-s\tdisplay only a total for each argument\n" \
    557     "\t-x\tskip directories on different filesystems\n" \
     731       " bytes." \
     732       "\n\nOptions:\n" \
     733       "    -a  Show sizes of files in addition to directories\n" \
     734       "    -H  Follow symlinks that are FILE command line args\n" \
     735       "    -L  Follow all symlinks encountered\n" \
     736       "    -d N    Limit output to directories (and files with -a) of depth < N\n" \
     737       "    -c  Output a grand total\n" \
     738       "    -l  Count sizes many times if hard linked\n" \
     739       "    -s  Display only a total for each argument\n" \
     740       "    -x  Skip directories on different filesystems\n" \
    558741    USE_FEATURE_HUMAN_READABLE( \
    559         "\t-h\tprint sizes in human readable format (e.g., 1K 243M 2G )\n" \
    560         "\t-m\tprint sizes in megabytes\n" \
     742       "    -h  Print sizes in human readable format (e.g., 1K 243M 2G )\n" \
     743       "    -m  Print sizes in megabytes\n" \
    561744    ) \
    562     "\t-k\tprint sizes in kilobytes" \
     745       "    -k  Print sizes in kilobytes" \
    563746    USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("(default)")
    564747#define du_example_usage \
    565     "$ du\n" \
    566     "16      ./CVS\n" \
    567     "12      ./kernel-patches/CVS\n" \
    568     "80      ./kernel-patches\n" \
    569     "12      ./tests/CVS\n" \
    570     "36      ./tests\n" \
    571     "12      ./scripts/CVS\n" \
    572     "16      ./scripts\n" \
    573     "12      ./docs/CVS\n" \
    574     "104     ./docs\n" \
    575     "2417    .\n"
     748       "$ du\n" \
     749       "16      ./CVS\n" \
     750       "12      ./kernel-patches/CVS\n" \
     751       "80      ./kernel-patches\n" \
     752       "12      ./tests/CVS\n" \
     753       "36      ./tests\n" \
     754       "12      ./scripts/CVS\n" \
     755       "16      ./scripts\n" \
     756       "12      ./docs/CVS\n" \
     757       "104     ./docs\n" \
     758       "2417    .\n"
    576759
    577760#define dumpkmap_trivial_usage \
    578     "> keymap"
     761       "> keymap"
    579762#define dumpkmap_full_usage \
    580     "Prints out a binary keyboard translation table to standard output."
     763       "Print out a binary keyboard translation table to standard output"
    581764#define dumpkmap_example_usage \
    582     "$ dumpkmap > keymap\n"
     765       "$ dumpkmap > keymap\n"
    583766
    584767#define dumpleases_trivial_usage \
    585     "[-r|-a] [-f LEASEFILE]"
     768       "[-r|-a] [-f LEASEFILE]"
    586769#define dumpleases_full_usage \
    587     "Displays the DHCP leases granted by udhcpd.\n\n" \
    588     "Options:\n" \
    589     "\t-f,\t--file=FILENAME\tLeases file to load\n" \
    590     "\t-r,\t--remaining\tInterpret lease times as time remaining\n" \
    591     "\t-a,\t--absolute\tInterpret lease times as expire time"
     770       "Display DHCP leases granted by udhcpd" \
     771       "\n\nOptions:\n" \
     772       "    -f, --file=FILENAME Leases file to load\n" \
     773       "    -r, --remaining     Interpret lease times as time remaining\n" \
     774       "    -a, --absolute      Interpret lease times as expire time"
    592775
    593776#define e2fsck_trivial_usage \
    594     "[-panyrcdfvstDFSV] [-b superblock] [-B blocksize] " \
    595     "[-I inode_buffer_blocks] [-P process_inode_size] " \
    596     "[-l|-L bad_blocks_file] [-C fd] [-j external_journal] " \
    597     "[-E extended-options] device"
     777       "[-panyrcdfvstDFSV] [-b superblock] [-B blocksize] " \
     778       "[-I inode_buffer_blocks] [-P process_inode_size] " \
     779       "[-l|-L bad_blocks_file] [-C fd] [-j external_journal] " \
     780       "[-E extended-options] device"
    598781#define e2fsck_full_usage \
    599     "Check a Linux ext2/ext3 file system.\n\n" \
    600     "Options:\n" \
    601     "\t-p\tAutomatic repair (no questions)\n" \
    602     "\t-n\tMake no changes to the filesystem\n" \
    603     "\t-y\tAssume 'yes' to all questions\n" \
    604     "\t-c\tCheck for bad blocks and add them to the badblock list\n" \
    605     "\t-f\tForce checking even if filesystem is marked clean\n" \
    606     "\t-v\tBe verbose\n" \
    607     "\t-b superblock\tUse alternative superblock\n" \
    608     "\t-B blocksize\tForce blocksize when looking for superblock\n" \
    609     "\t-j journal\tSet location of the external journal\n" \
    610     "\t-l file\tAdd to badblocks list\n" \
    611     "\t-L file\tSet badblocks list"
     782       "Check ext2/ext3 file system" \
     783       "\n\nOptions:\n" \
     784       "    -p      Automatic repair (no questions)\n" \
     785       "    -n      Make no changes to the filesystem\n" \
     786       "    -y      Assume 'yes' to all questions\n" \
     787       "    -c      Check for bad blocks and add them to the badblock list\n" \
     788       "    -f      Force checking even if filesystem is marked clean\n" \
     789       "    -v      Verbose\n" \
     790       "    -b superblock   Use alternative superblock\n" \
     791       "    -B blocksize    Force blocksize when looking for superblock\n" \
     792       "    -j journal  Set location of the external journal\n" \
     793       "    -l file     Add to badblocks list\n" \
     794       "    -L file     Set badblocks list"
    612795
    613796#define echo_trivial_usage \
    614797    USE_FEATURE_FANCY_ECHO("[-neE] ") "[ARG ...]"
    615798#define echo_full_usage \
    616     "Prints the specified ARGs to stdout\n\n" \
     799       "Print the specified ARGs to stdout" \
    617800    USE_FEATURE_FANCY_ECHO( \
    618         "Options:\n" \
    619         "\t-n\tsuppress trailing newline\n" \
    620         "\t-e\tinterpret backslash-escaped characters (i.e., \\t=tab)\n" \
    621         "\t-E\tdisable interpretation of backslash-escaped characters" \
     801       "\n\nOptions:\n" \
     802       "    -n  Suppress trailing newline\n" \
     803       "    -e  Interpret backslash-escaped characters (i.e., \\t=tab)\n" \
     804       "    -E  Disable interpretation of backslash-escaped characters" \
    622805    )
    623806#define echo_example_usage \
    624     "$ echo \"Erik is cool\"\n" \
    625     "Erik is cool\n" \
    626     USE_FEATURE_FANCY_ECHO("$  echo -e \"Erik\\nis\\ncool\"\n" \
    627     "Erik\n" \
    628     "is\n" \
    629     "cool\n" \
    630     "$ echo \"Erik\\nis\\ncool\"\n" \
    631     "Erik\\nis\\ncool\n")
     807       "$ echo \"Erik is cool\"\n" \
     808       "Erik is cool\n" \
     809    USE_FEATURE_FANCY_ECHO("$ echo -e \"Erik\\nis\\ncool\"\n" \
     810       "Erik\n" \
     811       "is\n" \
     812       "cool\n" \
     813       "$ echo \"Erik\\nis\\ncool\"\n" \
     814       "Erik\\nis\\ncool\n")
    632815
    633816#define eject_trivial_usage \
    634     "[-t] [DEVICE]"
     817       "[-t] [-T] [DEVICE]"
    635818#define eject_full_usage \
    636     "Eject specified DEVICE (or default /dev/cdrom).\n\n" \
    637     "Options:\n" \
    638     "\t-t\tclose tray"
     819       "Eject specified DEVICE (or default /dev/cdrom)" \
     820       "\n\nOptions:\n" \
     821       "    -t  Close tray\n" \
     822       "    -T  Open/close tray (toggle)"
    639823
    640824#define ed_trivial_usage ""
     
    642826
    643827#define env_trivial_usage \
    644     "[-iu] [-] [name=value]... [command]"
     828       "[-iu] [-] [name=value]... [command]"
    645829#define env_full_usage \
    646     "Prints the current environment or runs a program after setting\n" \
    647     "up the specified environment.\n\n" \
    648     "Options:\n" \
    649     "\t-, -i\tstart with an empty environment\n" \
    650     "\t-u\tremove variable from the environment"
     830       "Print the current environment or run a program after setting\n" \
     831       "up the specified environment" \
     832       "\n\nOptions:\n" \
     833       "    -, -i   Start with an empty environment\n" \
     834       "    -u  Remove variable from the environment"
    651835
    652836#define ether_wake_trivial_usage \
    653     "[-b] [-i iface] [-p aa:bb:cc:dd[:ee:ff]] MAC"
     837       "[-b] [-i iface] [-p aa:bb:cc:dd[:ee:ff]] MAC"
    654838#define ether_wake_full_usage \
    655     "Send a magic packet to wake up sleeping machines.\n" \
    656     "MAC must be a station address (00:11:22:33:44:55) or\n" \
    657     "    a hostname with a known 'ethers' entry.\n\n" \
    658     "Options:\n" \
    659     "\t-b\t\tSend wake-up packet to the broadcast address\n" \
    660     "\t-i iface\tUse interface ifname instead of the default \"eth0\"\n" \
    661     "\t-p pass\tAppend the four or six byte password PW to the packet"
     839       "Send a magic packet to wake up sleeping machines.\n" \
     840       "MAC must be a station address (00:11:22:33:44:55) or\n" \
     841       "a hostname with a known 'ethers' entry." \
     842       "\n\nOptions:\n" \
     843       "    -b      Send wake-up packet to the broadcast address\n" \
     844       "    -i iface    Use interface ifname instead of the default \"eth0\"\n" \
     845       "    -p pass     Append the four or six byte password PW to the packet"
     846
     847#define expand_trivial_usage \
     848       "[-i] [-t NUM] [FILE|-]"
     849#define expand_full_usage \
     850       "Convert tabs to spaces, writing to standard output." \
     851       "\n\nOptions:" \
     852       "\n  -i" USE_FEATURE_EXPAND_LONG_OPTIONS(",--initial") \
     853       "    Do not convert tabs after non blanks" \
     854       "\n  -t" USE_FEATURE_EXPAND_LONG_OPTIONS(",--tabs=N") \
     855       "    Tabstops every N chars"
    662856
    663857#define expr_trivial_usage \
    664     "EXPRESSION"
     858       "EXPRESSION"
    665859#define expr_full_usage \
    666     "Prints the value of EXPRESSION to standard output.\n\n" \
    667     "EXPRESSION may be:\n" \
    668     "\tARG1 |  ARG2 ARG1 if it is neither null nor 0, otherwise ARG2\n" \
    669     "\tARG1 &  ARG2 ARG1 if neither argument is null or 0, otherwise 0\n" \
    670     "\tARG1 <  ARG2 ARG1 is less than ARG2\n" \
    671     "\tARG1 <= ARG2 ARG1 is less than or equal to ARG2\n" \
    672     "\tARG1 =  ARG2 ARG1 is equal to ARG2\n" \
    673     "\tARG1 != ARG2 ARG1 is unequal to ARG2\n" \
    674     "\tARG1 >= ARG2 ARG1 is greater than or equal to ARG2\n" \
    675     "\tARG1 >  ARG2 ARG1 is greater than ARG2\n" \
    676     "\tARG1 +  ARG2 arithmetic sum of ARG1 and ARG2\n" \
    677     "\tARG1 -  ARG2 arithmetic difference of ARG1 and ARG2\n" \
    678     "\tARG1 *  ARG2 arithmetic product of ARG1 and ARG2\n" \
    679     "\tARG1 /  ARG2 arithmetic quotient of ARG1 divided by ARG2\n" \
    680     "\tARG1 %  ARG2 arithmetic remainder of ARG1 divided by ARG2\n" \
    681     "\tSTRING : REGEXP             anchored pattern match of REGEXP in STRING\n" \
    682     "\tmatch STRING REGEXP         same as STRING : REGEXP\n" \
    683     "\tsubstr STRING POS LENGTH    substring of STRING, POS counted from 1\n" \
    684     "\tindex STRING CHARS          index in STRING where any CHARS is found,\n" \
    685     "\t                            or 0\n" \
    686     "\tlength STRING               length of STRING\n" \
    687     "\tquote TOKEN                 interpret TOKEN as a string, even if\n" \
    688     "\t                            it is a keyword like `match' or an\n" \
    689     "\t                            operator like `/'\n" \
    690     "\t( EXPRESSION )              value of EXPRESSION\n\n" \
    691     "Beware that many operators need to be escaped or quoted for shells.\n" \
    692     "Comparisons are arithmetic if both ARGs are numbers, else\n" \
    693     "lexicographical.  Pattern matches return the string matched between \n" \
    694     "\\( and \\) or null; if \\( and \\) are not used, they return the number \n" \
    695     "of characters matched or 0."
     860       "Print the value of EXPRESSION to standard output.\n\n" \
     861       "EXPRESSION may be:\n" \
     862       "    ARG1 |  ARG2    ARG1 if it is neither null nor 0, otherwise ARG2\n" \
     863       "    ARG1 &  ARG2    ARG1 if neither argument is null or 0, otherwise 0\n" \
     864       "    ARG1 <  ARG2    ARG1 is less than ARG2\n" \
     865       "    ARG1 <= ARG2    ARG1 is less than or equal to ARG2\n" \
     866       "    ARG1 =  ARG2    ARG1 is equal to ARG2\n" \
     867       "    ARG1 != ARG2    ARG1 is unequal to ARG2\n" \
     868       "    ARG1 >= ARG2    ARG1 is greater than or equal to ARG2\n" \
     869       "    ARG1 >  ARG2    ARG1 is greater than ARG2\n" \
     870       "    ARG1 +  ARG2    Sum of ARG1 and ARG2\n" \
     871       "    ARG1 -  ARG2    Difference of ARG1 and ARG2\n" \
     872       "    ARG1 *  ARG2    Product of ARG1 and ARG2\n" \
     873       "    ARG1 /  ARG2    Quotient of ARG1 divided by ARG2\n" \
     874       "    ARG1 %  ARG2    Remainder of ARG1 divided by ARG2\n" \
     875       "    STRING : REGEXP     Anchored pattern match of REGEXP in STRING\n" \
     876       "    match STRING REGEXP Same as STRING : REGEXP\n" \
     877       "    substr STRING POS LENGTH Substring of STRING, POS counted from 1\n" \
     878       "    index STRING CHARS  Index in STRING where any CHARS is found, or 0\n" \
     879       "    length STRING       Length of STRING\n" \
     880       "    quote TOKEN     Interpret TOKEN as a string, even if\n" \
     881       "                it is a keyword like 'match' or an\n" \
     882       "                operator like '/'\n" \
     883       "    (EXPRESSION)        Value of EXPRESSION\n\n" \
     884       "Beware that many operators need to be escaped or quoted for shells.\n" \
     885       "Comparisons are arithmetic if both ARGs are numbers, else\n" \
     886       "lexicographical. Pattern matches return the string matched between\n" \
     887       "\\( and \\) or null; if \\( and \\) are not used, they return the number\n" \
     888       "of characters matched or 0."
    696889
    697890#define fakeidentd_trivial_usage \
    698     "[-b ip] [STRING]"
     891       "[-fiw] [-b ADDR] [STRING]"
    699892#define fakeidentd_full_usage \
    700     "Returns a set string to auth requests\n\n" \
    701     "\t-b\tBind to ip address\n" \
    702     "\tSTRING\tThe ident answer string (default is nobody)"
     893       "Provide fake ident (auth) service" \
     894       "\n\nOptions:" \
     895       "\n  -f  Run in foreground" \
     896       "\n  -i  Inetd mode" \
     897       "\n  -w  Inetd 'wait' mode" \
     898       "\n  -b ADDR Bind to specified address" \
     899       "\n  STRING  Ident answer string (default is 'nobody')"
    703900
    704901#define false_trivial_usage \
    705     ""
     902       ""
    706903#define false_full_usage \
    707     "Return an exit code of FALSE (1)."
     904       "Return an exit code of FALSE (1)"
    708905#define false_example_usage \
    709     "$ false\n" \
    710     "$ echo $?\n" \
    711     "1\n"
     906       "$ false\n" \
     907       "$ echo $?\n" \
     908       "1\n"
    712909
    713910#define fbset_trivial_usage \
    714     "[options] [mode]"
     911       "[options] [mode]"
    715912#define fbset_full_usage \
    716     "Show and modify frame buffer settings"
     913       "Show and modify frame buffer settings"
    717914#define fbset_example_usage \
    718     "$ fbset\n" \
    719     "mode \"1024x768-76\"\n" \
    720     "\t# D: 78.653 MHz, H: 59.949 kHz, V: 75.694 Hz\n" \
    721     "\tgeometry 1024 768 1024 768 16\n" \
    722     "\ttimings 12714 128 32 16 4 128 4\n" \
    723     "\taccel false\n" \
    724     "\trgba 5/11,6/5,5/0,0/0\n" \
    725     "endmode\n"
     915       "$ fbset\n" \
     916       "mode \"1024x768-76\"\n" \
     917       "    # D: 78.653 MHz, H: 59.949 kHz, V: 75.694 Hz\n" \
     918       "    geometry 1024 768 1024 768 16\n" \
     919       "    timings 12714 128 32 16 4 128 4\n" \
     920       "    accel false\n" \
     921       "    rgba 5/11,6/5,5/0,0/0\n" \
     922       "endmode\n"
    726923
    727924#define fdflush_trivial_usage \
    728     "DEVICE"
     925       "DEVICE"
    729926#define fdflush_full_usage \
    730     "Forces floppy disk drive to detect disk change"
     927       "Force floppy disk drive to detect disk change"
    731928
    732929#define fdformat_trivial_usage \
    733     "[-n] DEVICE"
     930       "[-n] DEVICE"
    734931#define fdformat_full_usage \
    735     "Low-level formats a floppy disk\n\n" \
    736     "Options:\n" \
    737     "\t-n\tDon't verify after format"
     932       "Format floppy disk" \
     933       "\n\nOptions:\n" \
     934       "    -n  Don't verify after format"
    738935
    739936#define fdisk_trivial_usage \
    740     "[-luv] [-C CYLINDERS] [-H HEADS] [-S SECTORS] [-b SSZ] DISK"
     937       "[-luv] [-C CYLINDERS] [-H HEADS] [-S SECTORS] [-b SSZ] DISK"
    741938#define fdisk_full_usage \
    742     "Change partition table\n" \
    743     "Options:\n" \
    744     "\t-l  List partition table(s)\n" \
    745     "\t-u  Give Start and End in sector (instead of cylinder) units\n" \
    746     "\t-s PARTITION  Give partition size(s) in blocks\n" \
    747     "\t-b 2048: (for certain MO disks) use 2048-byte sectors\n" \
    748     "\t-C CYLINDERS  Set the number of cylinders\n" \
    749     "\t-H HEADS  Set the number of heads\n" \
    750     "\t-S SECTORS  Set the number of sectors\n" \
    751     "\t-v  Give fdisk version"
     939       "Change partition table" \
     940       "\n\nOptions:\n" \
     941       "    -l      List partition table(s)\n" \
     942       "    -u      Give Start and End in sector (instead of cylinder) units\n" \
     943       "    -s PARTITION    Give partition size(s) in blocks\n" \
     944       "    -b 2048     (for certain MO disks) use 2048-byte sectors\n" \
     945       "    -C CYLINDERS    Set the number of cylinders\n" \
     946       "    -H HEADS    Set the number of heads\n" \
     947       "    -S SECTORS  Set the number of sectors\n" \
     948       "    -v      Give fdisk version"
    752949
    753950#define find_trivial_usage \
    754     "[PATH...] [EXPRESSION]"
     951       "[PATH...] [EXPRESSION]"
    755952#define find_full_usage \
    756     "Search for files in a directory hierarchy.  The default PATH is\n" \
    757     "the current directory; default EXPRESSION is '-print'\n" \
    758     "\nEXPRESSION may consist of:\n" \
    759     "\t-follow\t\tDereference symbolic links\n" \
    760     "\t-name PATTERN\tFile name (leading directories removed) matches PATTERN\n" \
    761     "\t-print\t\tPrint (default and assumed)\n" \
     953       "Search for files in a directory hierarchy. The default PATH is\n" \
     954       "the current directory, default EXPRESSION is '-print'\n" \
     955     "\nEXPRESSION may consist of:" \
     956     "\n    -follow     Dereference symlinks" \
     957    USE_FEATURE_FIND_XDEV( \
     958     "\n    -xdev       Don't descend directories on other filesystems") \
     959    USE_FEATURE_FIND_MAXDEPTH( \
     960     "\n    -maxdepth N Descend at most N levels. -maxdepth 0 applies" \
     961     "\n            tests/actions to command line arguments only") \
     962     "\n    -name PATTERN   File name (w/o directory name) matches PATTERN" \
     963    USE_FEATURE_FIND_PATH( \
     964     "\n    -path PATTERN   Path matches PATTERN") \
     965    USE_FEATURE_FIND_REGEX( \
     966     "\n    -regex PATTERN  Path matches regex PATTERN") \
     967    USE_FEATURE_FIND_TYPE( \
     968     "\n    -type X     File type is X (X is one of: f,d,l,b,c,...)") \
     969    USE_FEATURE_FIND_PERM( \
     970     "\n    -perm NNN   Permissions match any of (+NNN), all of (-NNN)," \
     971     "\n            or exactly (NNN)") \
     972    USE_FEATURE_FIND_MTIME( \
     973     "\n    -mtime DAYS Modified time is greater than (+N), less than (-N)," \
     974     "\n            or exactly (N) days") \
     975    USE_FEATURE_FIND_MMIN( \
     976     "\n    -mmin MINS  Modified time is greater than (+N), less than (-N)," \
     977     "\n            or exactly (N) minutes") \
     978    USE_FEATURE_FIND_NEWER( \
     979     "\n    -newer FILE Modified time is more recent than FILE's") \
     980    USE_FEATURE_FIND_INUM( \
     981     "\n    -inum N     File has inode number N") \
     982    USE_FEATURE_FIND_USER( \
     983     "\n    -user NAME  File is owned by user NAME (numeric user ID allowed)") \
     984    USE_FEATURE_FIND_GROUP( \
     985     "\n    -group NAME File belongs to group NAME (numeric group ID allowed)") \
     986    USE_FEATURE_FIND_DEPTH( \
     987     "\n    -depth      Process directory name after traversing it") \
     988    USE_FEATURE_FIND_SIZE( \
     989     "\n    -size N[bck]    File size is N (c:bytes,k:kbytes,b:512 bytes(def.))." \
     990     "\n            +/-N: file size is bigger/smaller than N") \
     991     "\n    -print      Print (default and assumed)" \
    762992    USE_FEATURE_FIND_PRINT0( \
    763     "\t-print0\t\tDelimit output with null characters rather than\n\t\t\tnewlines" \
    764 ) USE_FEATURE_FIND_TYPE( \
    765     "\n\t-type X\t\tFiletype matches X (where X is one of: f,d,l,b,c,...)" \
    766 ) USE_FEATURE_FIND_PERM( \
    767     "\n\t-perm PERMS\tPermissions match any of (+NNN); all of (-NNN);\n\t\t\tor exactly (NNN)" \
    768 ) USE_FEATURE_FIND_MTIME( \
    769     "\n\t-mtime DAYS\tModified time is greater than (+N); less than (-N);\n\t\t\tor exactly (N) days" \
    770 ) USE_FEATURE_FIND_MMIN( \
    771     "\n\t-mmin MINS\tModified time is greater than (+N); less than (-N);\n\t\t\tor exactly (N) minutes" \
    772 ) USE_FEATURE_FIND_NEWER( \
    773     "\n\t-newer FILE\tModified time is more recent than FILE's" \
    774 ) USE_FEATURE_FIND_INUM( \
    775     "\n\t-inum N\t\tFile has inode number N" \
    776 ) USE_FEATURE_FIND_EXEC( \
    777     "\n\t-exec CMD\tExecute CMD with all instances of {} replaced by the" \
    778     "\n\t\t\tfiles matching EXPRESSION")
     993     "\n    -print0     Delimit output with null characters rather than" \
     994     "\n            newlines") \
     995    USE_FEATURE_FIND_CONTEXT ( \
     996     "\n    -context    File has specified security context") \
     997    USE_FEATURE_FIND_EXEC( \
     998     "\n    -exec CMD ARG ; Execute CMD with all instances of {} replaced by the" \
     999     "\n            matching files") \
     1000    USE_FEATURE_FIND_PRUNE( \
     1001     "\n    -prune      Stop traversing current subtree") \
     1002    USE_FEATURE_FIND_DELETE( \
     1003     "\n    -delete     Delete files, turns on -depth option") \
     1004    USE_FEATURE_FIND_PAREN( \
     1005     "\n    (EXPR)      Group an expression") \
    7791006
    7801007#define find_example_usage \
    781     "$ find / -name passwd\n" \
    782     "/etc/passwd\n"
     1008       "$ find / -name passwd\n" \
     1009       "/etc/passwd\n"
    7831010
    7841011#define fold_trivial_usage \
    785     "[-bs] [-w WIDTH] [FILE]"
     1012       "[-bs] [-w WIDTH] [FILE]"
    7861013#define fold_full_usage \
    787     "Wrap input lines in each FILE (standard input by default), writing to\n" \
    788     "standard output.\n\n" \
    789     "Options:\n" \
    790     "\t-b\tcount bytes rather than columns\n" \
    791     "\t-s\tbreak at spaces\n" \
    792     "\t-w\tuse WIDTH columns instead of 80"
     1014       "Wrap input lines in each FILE (standard input by default), writing to\n" \
     1015       "standard output" \
     1016       "\n\nOptions:\n" \
     1017       "    -b  Count bytes rather than columns\n" \
     1018       "    -s  Break at spaces\n" \
     1019       "    -w  Use WIDTH columns instead of 80"
    7931020
    7941021#define free_trivial_usage \
    795     ""
     1022       ""
    7961023#define free_full_usage \
    797     "Displays the amount of free and used system memory"
     1024       "Display the amount of free and used system memory"
    7981025#define free_example_usage \
    799     "$ free\n" \
    800     "              total         used         free       shared      buffers\n" \
    801     "  Mem:       257628       248724         8904        59644        93124\n" \
    802     " Swap:       128516         8404       120112\n" \
    803     "Total:       386144       257128       129016\n" \
     1026       "$ free\n" \
     1027       "              total         used         free       shared      buffers\n" \
     1028       "  Mem:       257628       248724         8904        59644        93124\n" \
     1029       " Swap:       128516         8404       120112\n" \
     1030       "Total:       386144       257128       129016\n" \
    8041031
    8051032#define freeramdisk_trivial_usage \
    806     "DEVICE"
     1033       "DEVICE"
    8071034#define freeramdisk_full_usage \
    808     "Frees all memory used by the specified ramdisk."
     1035       "Free all memory used by the specified ramdisk"
    8091036#define freeramdisk_example_usage \
    810     "$ freeramdisk /dev/ram2\n"
     1037       "$ freeramdisk /dev/ram2\n"
    8111038
    8121039#define fsck_trivial_usage \
    813     "[-ANPRTV] [ -C [ fd ] ] [-t fstype] [fs-options] [filesys ...]"
     1040       "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys ...]"
    8141041#define fsck_full_usage \
    815     "Check and repair filesystems.\n\n" \
    816     "Options:\n" \
    817     "\t-A\tWalk /etc/fstab and check all filesystems\n" \
    818     "\t-N\tDon't execute, just show what would be done\n" \
    819     "\t-P\tWhen using -A, check filesystems in parallel\n" \
    820     "\t-R\tWhen using -A, skip the root filesystem\n" \
    821     "\t-T\tDon't show title on startup\n" \
    822     "\t-V\tVerbose mode\n" \
    823     "\t-C\tWrite status information to specified filedescriptor\n" \
    824     "\t-t\tList of filesystem types to check"
     1042       "Check and repair filesystems" \
     1043       "\n\nOptions:\n" \
     1044       "    -A  Walk /etc/fstab and check all filesystems\n" \
     1045       "    -N  Don't execute, just show what would be done\n" \
     1046       "    -P  When using -A, check filesystems in parallel\n" \
     1047       "    -R  When using -A, skip the root filesystem\n" \
     1048       "    -T  Don't show title on startup\n" \
     1049       "    -V  Verbose\n" \
     1050       "    -C n    Write status information to specified filedescriptor\n" \
     1051       "    -t type List of filesystem types to check"
    8251052
    8261053#define fsck_minix_trivial_usage \
    827     "[-larvsmf] /dev/name"
     1054       "[-larvsmf] /dev/name"
    8281055#define fsck_minix_full_usage \
    829     "Performs a consistency check for MINIX filesystems.\n\n" \
    830     "Options:\n" \
    831     "\t-l\tLists all filenames\n" \
    832     "\t-r\tPerform interactive repairs\n" \
    833     "\t-a\tPerform automatic repairs\n" \
    834     "\t-v\tverbose\n" \
    835     "\t-s\tOutputs super-block information\n" \
    836     "\t-m\tActivates MINIX-like \"mode not cleared\" warnings\n" \
    837     "\t-f\tForce file system check"
     1056       "Perform a consistency check for MINIX filesystems" \
     1057       "\n\nOptions:\n" \
     1058       "    -l  Lists all filenames\n" \
     1059       "    -r  Perform interactive repairs\n" \
     1060       "    -a  Perform automatic repairs\n" \
     1061       "    -v  Verbose\n" \
     1062       "    -s  Outputs super-block information\n" \
     1063       "    -m  Activates MINIX-like \"mode not cleared\" warnings\n" \
     1064       "    -f  Force file system check"
    8381065
    8391066#define ftpget_trivial_usage \
    840     "[options] remote-host local-file remote-file"
     1067       "[options] remote-host local-file remote-file"
    8411068#define ftpget_full_usage \
    842     "Retrieve a remote file via FTP.\n\n" \
    843     "Options:\n" \
    844     "\t-c, --continue         Continue a previous transfer\n" \
    845     "\t-v, --verbose          Verbose\n" \
    846     "\t-u, --username         Username to be used\n" \
    847     "\t-p, --password         Password to be used\n" \
    848     "\t-P, --port             Port number to be used"
     1069       "Retrieve a remote file via FTP" \
     1070       "\n\nOptions:\n" \
     1071       "    -c, --continue  Continue a previous transfer\n" \
     1072       "    -v, --verbose   Verbose\n" \
     1073       "    -u, --username  Username to be used\n" \
     1074       "    -p, --password  Password to be used\n" \
     1075       "    -P, --port  Port number to be used"
    8491076
    8501077#define ftpput_trivial_usage \
    851     "[options] remote-host remote-file local-file"
     1078       "[options] remote-host remote-file local-file"
    8521079#define ftpput_full_usage \
    853     "Store a local file on a remote machine via FTP.\n\n" \
    854     "Options:\n" \
    855     "\t-v, --verbose          Verbose\n" \
    856     "\t-u, --username         Username to be used\n" \
    857     "\t-p, --password         Password to be used\n" \
    858     "\t-P, --port             Port number to be used"
     1080       "Store a local file on a remote machine via FTP" \
     1081       "\n\nOptions:\n" \
     1082       "    -v, --verbose   Verbose\n" \
     1083       "    -u, --username  Username to be used\n" \
     1084       "    -p, --password  Password to be used\n" \
     1085       "    -P, --port  Port number to be used"
    8591086
    8601087#define fuser_trivial_usage \
    861     "[options] file OR port/proto"
     1088       "[options] file OR port/proto"
    8621089#define fuser_full_usage \
    863     "Options:\n" \
    864     "\t-m         Show all processes on the same mounted fs\n" \
    865     "\t-k         Kill all processes that match.\n" \
    866     "\t-s         Don't print or kill anything.\n" \
    867     "\t-4         When using port/proto only search IPv4 space\n" \
    868     "\t-6         When using port/proto only search IPv6 space\n" \
    869     "\t-SIGNAL    When used with -k, this signal will be used to kill"
     1090       "Options:\n" \
     1091       "    -m  Show all processes on the same mounted fs\n" \
     1092       "    -k  Kill all processes that match\n" \
     1093       "    -s  Don't print or kill anything\n" \
     1094       "    -4  When using port/proto only search IPv4 space\n" \
     1095       "    -6  When using port/proto only search IPv6 space\n" \
     1096       "    -SIGNAL When used with -k, this signal will be used to kill"
     1097
     1098#define getenforce_trivial_usage
     1099#define getenforce_full_usage
    8701100
    8711101#define getopt_trivial_usage \
    872     "[OPTIONS]..."
     1102       "[OPTIONS]..."
    8731103#define getopt_full_usage \
    874     "Parse command options\n" \
    875     "\t-a, --alternative        Allow long options starting with single -\n" \
    876     "\t-l, --longoptions=longopts   Long options to be recognized\n" \
    877     "\t-n, --name=progname      The name under which errors are reported\n" \
    878     "\t-o, --options=optstring  Short options to be recognized\n" \
    879     "\t-q, --quiet          Disable error reporting by getopt(3)\n" \
    880     "\t-Q, --quiet-output       No normal output\n" \
    881     "\t-s, --shell=shell        Set shell quoting conventions\n" \
    882     "\t-T, --test           Test for getopt(1) version\n" \
    883     "\t-u, --unquoted       Do not quote the output"
     1104       "Parse command options\n" \
     1105       "    -a, --alternative       Allow long options starting with single -\n" \
     1106       "    -l, --longoptions=longopts  Long options to be recognized\n" \
     1107       "    -n, --name=progname     The name under which errors are reported\n" \
     1108       "    -o, --options=optstring     Short options to be recognized\n" \
     1109       "    -q, --quiet         Disable error reporting by getopt(3)\n" \
     1110       "    -Q, --quiet-output      No normal output\n" \
     1111       "    -s, --shell=shell       Set shell quoting conventions\n" \
     1112       "    -T, --test          Test for getopt(1) version\n" \
     1113       "    -u, --unquoted          Do not quote the output"
    8841114#define getopt_example_usage \
    885     "$ cat getopt.test\n" \
    886     "#!/bin/sh\n" \
    887     "GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \\\n" \
    888     "       -n 'example.busybox' -- \"$@\"`\n" \
    889     "if [ $? != 0 ] ; then  exit 1 ; fi\n" \
    890     "eval set -- \"$GETOPT\"\n" \
    891     "while true ; do\n" \
    892     " case $1 in\n" \
    893     "   -a|--a-long) echo \"Option a\" ; shift ;;\n" \
    894     "   -b|--b-long) echo \"Option b, argument `$2'\" ; shift 2 ;;\n" \
    895     "   -c|--c-long)\n" \
    896     "     case \"$2\" in\n" \
    897     "       \"\") echo \"Option c, no argument\"; shift 2 ;;\n" \
    898     "       *)  echo \"Option c, argument `$2'\" ; shift 2 ;;\n" \
    899     "     esac ;;\n" \
    900     "   --) shift ; break ;;\n" \
    901     "   *) echo \"Internal error!\" ; exit 1 ;;\n" \
    902     " esac\n" \
    903     "done\n"
     1115       "$ cat getopt.test\n" \
     1116       "#!/bin/sh\n" \
     1117       "GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \\\n" \
     1118       "       -n 'example.busybox' -- \"$@\"`\n" \
     1119       "if [ $? != 0 ]; then  exit 1; fi\n" \
     1120       "eval set -- \"$GETOPT\"\n" \
     1121       "while true; do\n" \
     1122       " case $1 in\n" \
     1123       "   -a|--a-long) echo \"Option a\"; shift;;\n" \
     1124       "   -b|--b-long) echo \"Option b, argument '$2'\"; shift 2;;\n" \
     1125       "   -c|--c-long)\n" \
     1126       "     case \"$2\" in\n" \
     1127       "       \"\") echo \"Option c, no argument\"; shift 2;;\n" \
     1128       "       *)  echo \"Option c, argument '$2'\"; shift 2;;\n" \
     1129       "     esac;;\n" \
     1130       "   --) shift; break;;\n" \
     1131       "   *) echo \"Internal error!\"; exit 1;;\n" \
     1132       " esac\n" \
     1133       "done\n"
     1134
     1135#define getsebool_trivial_usage \
     1136       "-a or getsebool boolean..."
     1137#define getsebool_full_usage \
     1138       "    -a  Show all SELinux booleans"
    9041139
    9051140#define getty_trivial_usage \
    906     "[OPTIONS]... baud_rate,... line [termtype]"
     1141       "[OPTIONS]... baud_rate,... line [termtype]"
    9071142#define getty_full_usage \
    908     "Opens a tty, prompts for a login name, then invokes /bin/login\n\n" \
    909     "Options:\n" \
    910     "\t-h\t\tEnable hardware (RTS/CTS) flow control\n" \
    911     "\t-i\t\tDo not display /etc/issue before running login\n" \
    912     "\t-L\t\tLocal line, so do not do carrier detect\n" \
    913     "\t-m\t\tGet baud rate from modem's CONNECT status message\n" \
    914     "\t-w\t\tWait for a CR or LF before sending /etc/issue\n" \
    915     "\t-n\t\tDo not prompt the user for a login name\n" \
    916     "\t-f issue_file\tDisplay issue_file instead of /etc/issue\n" \
    917     "\t-l login_app\tInvoke login_app instead of /bin/login\n" \
    918     "\t-t timeout\tTerminate after timeout if no username is read\n" \
    919     "\t-I initstring\tSets the init string to send before anything else\n" \
    920     "\t-H login_host\tLog login_host into the utmp file as the hostname"
     1143       "Open a tty, prompt for a login name, then invoke /bin/login" \
     1144       "\n\nOptions:\n" \
     1145       "    -h      Enable hardware (RTS/CTS) flow control\n" \
     1146       "    -i      Do not display /etc/issue before running login\n" \
     1147       "    -L      Local line, so do not do carrier detect\n" \
     1148       "    -m      Get baud rate from modem's CONNECT status message\n" \
     1149       "    -w      Wait for a CR or LF before sending /etc/issue\n" \
     1150       "    -n      Do not prompt the user for a login name\n" \
     1151       "    -f issue_file   Display issue_file instead of /etc/issue\n" \
     1152       "    -l login_app    Invoke login_app instead of /bin/login\n" \
     1153       "    -t timeout  Terminate after timeout if no username is read\n" \
     1154       "    -I initstring   Sets the init string to send before anything else\n" \
     1155       "    -H login_host   Log login_host into the utmp file as the hostname"
    9211156
    9221157#define grep_trivial_usage \
    923     "[-ihHnqvs" \
     1158       "[-HhrilLnqvso" \
     1159    USE_DESKTOP("w") \
     1160       "eF" \
    9241161    USE_FEATURE_GREP_EGREP_ALIAS("E") \
    9251162    USE_FEATURE_GREP_CONTEXT("ABC") \
    926     "] PATTERN [FILEs...]"
     1163       "] PATTERN [FILEs...]"
    9271164#define grep_full_usage \
    928     "Search for PATTERN in each FILE or standard input.\n\n" \
    929     "Options:\n" \
    930     "\t-H\tprefix output lines with filename where match was found\n" \
    931     "\t-h\tsuppress the prefixing filename on output\n" \
    932     "\t-i\tignore case distinctions\n" \
    933     "\t-l\tlist names of files that match\n" \
    934     "\t-L\tlist names of files that do not match\n" \
    935     "\t-n\tprint line number with output lines\n" \
    936     "\t-q\tbe quiet. Returns 0 if PATTERN was found, 1 otherwise\n" \
    937     "\t-v\tselect non-matching lines\n" \
    938     "\t-s\tsuppress file open/read error messages\n" \
    939     "\t-c\tonly print count of matching lines\n" \
    940     "\t-f\tread PATTERN from file\n" \
    941     "\t-e\tPATTERN is a regular expression\n" \
    942     "\t-F\tPATTERN is a set of newline-separated strings" \
    943     USE_FEATURE_GREP_EGREP_ALIAS("\n\t-E\tPATTERN is an extended regular expression") \
    944     USE_FEATURE_GREP_CONTEXT("\n\t-A\tprint NUM lines of trailing context") \
    945     USE_FEATURE_GREP_CONTEXT("\n\t-B\tprint NUM lines of leading context") \
    946     USE_FEATURE_GREP_CONTEXT("\n\t-C\tprint NUM lines of output context")
     1165       "Search for PATTERN in each FILE or standard input" \
     1166       "\n\nOptions:" \
     1167       "\n  -H  Prefix output lines with filename where match was found" \
     1168       "\n  -h  Suppress the prefixing filename on output" \
     1169       "\n  -r  Recurse subdirectories" \
     1170       "\n  -i  Ignore case distinctions" \
     1171       "\n  -l  List names of files that match" \
     1172       "\n  -L  List names of files that do not match" \
     1173       "\n  -n  Print line number with output lines" \
     1174       "\n  -q  Quiet. Returns 0 if PATTERN was found, 1 otherwise" \
     1175       "\n  -v  Select non-matching lines" \
     1176       "\n  -s  Suppress file open/read error messages" \
     1177       "\n  -c  Only print count of matching lines" \
     1178       "\n  -o  Show only the part of a line that matches PATTERN" \
     1179       "\n  -m MAX  Match up to MAX times per file" \
     1180    USE_DESKTOP( \
     1181       "\n  -w  Match whole words only") \
     1182       "\n  -F  PATTERN is a set of newline-separated strings" \
     1183    USE_FEATURE_GREP_EGREP_ALIAS( \
     1184       "\n  -E  PATTERN is an extended regular expression") \
     1185       "\n  -e PTRN Pattern to match" \
     1186       "\n  -f FILE Read pattern from file" \
     1187    USE_FEATURE_GREP_CONTEXT( \
     1188       "\n  -A  Print NUM lines of trailing context" \
     1189       "\n  -B  Print NUM lines of leading context" \
     1190       "\n  -C  Print NUM lines of output context") \
    9471191
    9481192#define grep_example_usage \
    949     "$ grep root /etc/passwd\n" \
    950     "root:x:0:0:root:/root:/bin/bash\n" \
    951     "$ grep ^[rR]oo. /etc/passwd\n" \
    952     "root:x:0:0:root:/root:/bin/bash\n"
     1193       "$ grep root /etc/passwd\n" \
     1194       "root:x:0:0:root:/root:/bin/bash\n" \
     1195       "$ grep ^[rR]oo. /etc/passwd\n" \
     1196       "root:x:0:0:root:/root:/bin/bash\n"
    9531197
    9541198#define gunzip_trivial_usage \
    955     "[OPTION]... FILE"
     1199       "[OPTION]... FILE"
    9561200#define gunzip_full_usage \
    957     "Uncompress FILE (or standard input if FILE is '-').\n\n" \
    958     "Options:\n" \
    959     "\t-c\tWrite output to standard output\n" \
    960     "\t-f\tForce read when source is a terminal\n" \
    961     "\t-t\tTest compressed file integrity"
     1201       "Uncompress FILE (or standard input if FILE is '-')" \
     1202       "\n\nOptions:\n" \
     1203       "    -c  Write output to standard output\n" \
     1204       "    -f  Force read when source is a terminal\n" \
     1205       "    -t  Test compressed file integrity"
    9621206#define gunzip_example_usage \
    963     "$ ls -la /tmp/BusyBox*\n" \
    964     "-rw-rw-r--    1 andersen andersen   557009 Apr 11 10:55 /tmp/BusyBox-0.43.tar.gz\n" \
    965     "$ gunzip /tmp/BusyBox-0.43.tar.gz\n" \
    966     "$ ls -la /tmp/BusyBox*\n" \
    967     "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar\n"
     1207       "$ ls -la /tmp/BusyBox*\n" \
     1208       "-rw-rw-r--    1 andersen andersen   557009 Apr 11 10:55 /tmp/BusyBox-0.43.tar.gz\n" \
     1209       "$ gunzip /tmp/BusyBox-0.43.tar.gz\n" \
     1210       "$ ls -la /tmp/BusyBox*\n" \
     1211       "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar\n"
    9681212
    9691213#define gzip_trivial_usage \
    970     "[OPTION]... [FILE]..."
     1214       "[OPTION]... [FILE]..."
    9711215#define gzip_full_usage \
    972     "Compress FILE(s) with maximum compression.\n" \
    973     "When FILE is '-' or unspecified, reads standard input.  Implies -c.\n\n" \
    974     "Options:\n" \
    975     "\t-c\tWrite output to standard output instead of FILE.gz\n" \
    976     "\t-d\tDecompress\n" \
    977     "\t-f\tForce write when destination is a terminal"
     1216       "Compress FILE(s) with maximum compression.\n" \
     1217       "When FILE is '-' or unspecified, reads standard input. Implies -c." \
     1218       "\n\nOptions:\n" \
     1219       "    -c  Write output to standard output instead of FILE.gz\n" \
     1220       "    -d  Decompress\n" \
     1221       "    -f  Force write when destination is a terminal"
    9781222#define gzip_example_usage \
    979     "$ ls -la /tmp/busybox*\n" \
    980     "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/busybox.tar\n" \
    981     "$ gzip /tmp/busybox.tar\n" \
    982     "$ ls -la /tmp/busybox*\n" \
    983     "-rw-rw-r--    1 andersen andersen   554058 Apr 14 17:49 /tmp/busybox.tar.gz\n"
     1223       "$ ls -la /tmp/busybox*\n" \
     1224       "-rw-rw-r--    1 andersen andersen  1761280 Apr 14 17:47 /tmp/busybox.tar\n" \
     1225       "$ gzip /tmp/busybox.tar\n" \
     1226       "$ ls -la /tmp/busybox*\n" \
     1227       "-rw-rw-r--    1 andersen andersen   554058 Apr 14 17:49 /tmp/busybox.tar.gz\n"
    9841228
    9851229#define halt_trivial_usage \
    986     "[-d<delay>] [-n<nosync>] [-f<force>]"
     1230       "[-d delay] [-n] [-f]"
    9871231#define halt_full_usage \
    988     "Halt the system.\n" \
    989     "Options:\n" \
    990     "\t-d\t\tdelay interval for halting\n" \
    991     "\t-n\t\tno call to sync()\n" \
    992     "\t-f\t\tforce halt (don't go through init)"
     1232       "Halt the system" \
     1233       "\n\nOptions:\n" \
     1234       "    -d  Delay interval for halting\n" \
     1235       "    -n  No call to sync()\n" \
     1236       "    -f  Force halt (don't go through init)"
    9931237
    9941238#define hdparm_trivial_usage \
    995     "[options] [device] .."
     1239       "[options] [device] .."
    9961240#define hdparm_full_usage \
    997     USE_FEATURE_HDPARM_GET_IDENTITY("\tIf no device name is specified try to read from stdin.\n") \
    998     "\nOptions:\n" \
    999     "\t-a   get/set fs readahead\n" \
    1000     "\t-A   set drive read-lookahead flag (0/1)\n" \
    1001     "\t-b   get/set bus state (0 == off, 1 == on, 2 == tristate)\n" \
    1002     "\t-B   set Advanced Power Management setting (1-255)\n" \
    1003     "\t-c   get/set IDE 32-bit IO setting\n" \
    1004     "\t-C   check IDE power mode status\n" \
    1005     USE_FEATURE_HDPARM_HDIO_GETSET_DMA("\t-d   get/set using_dma flag\n") \
    1006     "\t-D   enable/disable drive defect-mgmt\n" \
    1007     "\t-f   flush buffer cache for device on exit\n" \
    1008     "\t-g   display drive geometry\n" \
    1009     "\t-h   display terse usage information\n" \
    1010     USE_FEATURE_HDPARM_GET_IDENTITY("\t-i   display drive identification\n") \
    1011     USE_FEATURE_HDPARM_GET_IDENTITY("\t-I   detailed/current information directly from drive\n") \
    1012     "\t-k   get/set keep_settings_over_reset flag (0/1)\n" \
    1013     "\t-K   set drive keep_features_over_reset flag (0/1)\n" \
    1014     "\t-L   set drive doorlock (0/1) (removable harddisks only)\n" \
    1015     "\t-m   get/set multiple sector count\n" \
    1016     "\t-n   get/set ignore-write-errors flag (0/1)\n" \
    1017     "\t-p   set PIO mode on IDE interface chipset (0,1,2,3,4,...)\n" \
    1018     "\t-P   set drive prefetch count\n" \
    1019     "\t-q   change next setting quietly\n" \
    1020     "\t-Q   get/set DMA tagged-queuing depth (if supported)\n" \
    1021     "\t-r   get/set readonly flag (DANGEROUS to set)\n" \
    1022     USE_FEATURE_HDPARM_HDIO_SCAN_HWIF("\t-R   register an IDE interface (DANGEROUS)\n") \
    1023     "\t-S   set standby (spindown) timeout\n" \
    1024     "\t-t   perform device read timings\n" \
    1025     "\t-T   perform cache read timings\n" \
    1026     "\t-u   get/set unmaskirq flag (0/1)\n" \
    1027     USE_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF("\t-U   un-register an IDE interface (DANGEROUS)\n") \
    1028     "\t-v   defaults; same as -mcudkrag for IDE drives\n" \
    1029     "\t-V   display program version and exit immediately\n" \
    1030     USE_FEATURE_HDPARM_HDIO_DRIVE_RESET("\t-w   perform device reset (DANGEROUS)\n") \
    1031     "\t-W   set drive write-caching flag (0/1) (DANGEROUS)\n" \
    1032     USE_FEATURE_HDPARM_HDIO_TRISTATE_HWIF("\t-x   tristate device for hotswap (0/1) (DANGEROUS)\n") \
    1033     "\t-X   set IDE xfer mode (DANGEROUS)\n" \
    1034     "\t-y   put IDE drive in standby mode\n" \
    1035     "\t-Y   put IDE drive to sleep\n" \
    1036     "\t-Z   disable Seagate auto-powersaving mode\n" \
    1037     "\t-z   re-read partition table"
     1241    USE_FEATURE_HDPARM_GET_IDENTITY( \
     1242       "If no device name is specified try to read from stdin.\n\n") \
     1243       "Options:\n" \
     1244       "    -a  Get/set fs readahead\n" \
     1245       "    -A  Set drive read-lookahead flag (0/1)\n" \
     1246       "    -b  Get/set bus state (0 == off, 1 == on, 2 == tristate)\n" \
     1247       "    -B  Set Advanced Power Management setting (1-255)\n" \
     1248       "    -c  Get/set IDE 32-bit IO setting\n" \
     1249       "    -C  Check IDE power mode status\n" \
     1250    USE_FEATURE_HDPARM_HDIO_GETSET_DMA( \
     1251       "    -d  Get/set using_dma flag\n") \
     1252       "    -D  Enable/disable drive defect-mgmt\n" \
     1253       "    -f  Flush buffer cache for device on exit\n" \
     1254       "    -g  Display drive geometry\n" \
     1255       "    -h  Display terse usage information\n" \
     1256    USE_FEATURE_HDPARM_GET_IDENTITY( \
     1257       "    -i  Display drive identification\n") \
     1258    USE_FEATURE_HDPARM_GET_IDENTITY( \
     1259       "    -I  Detailed/current information directly from drive\n") \
     1260       "    -k  Get/set keep_settings_over_reset flag (0/1)\n" \
     1261       "    -K  Set drive keep_features_over_reset flag (0/1)\n" \
     1262       "    -L  Set drive doorlock (0/1) (removable harddisks only)\n" \
     1263       "    -m  Get/set multiple sector count\n" \
     1264       "    -n  Get/set ignore-write-errors flag (0/1)\n" \
     1265       "    -p  Set PIO mode on IDE interface chipset (0,1,2,3,4,...)\n" \
     1266       "    -P  Set drive prefetch count\n" \
     1267       "    -q  Change next setting quietly\n" \
     1268       "    -Q  Get/set DMA tagged-queuing depth (if supported)\n" \
     1269       "    -r  Get/set readonly flag (DANGEROUS to set)\n" \
     1270    USE_FEATURE_HDPARM_HDIO_SCAN_HWIF( \
     1271       "    -R  Register an IDE interface (DANGEROUS)\n") \
     1272       "    -S  Set standby (spindown) timeout\n" \
     1273       "    -t  Perform device read timings\n" \
     1274       "    -T  Perform cache read timings\n" \
     1275       "    -u  Get/set unmaskirq flag (0/1)\n" \
     1276    USE_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF( \
     1277       "    -U  Un-register an IDE interface (DANGEROUS)\n") \
     1278       "    -v  Defaults; same as -mcudkrag for IDE drives\n" \
     1279       "    -V  Display program version and exit immediately\n" \
     1280    USE_FEATURE_HDPARM_HDIO_DRIVE_RESET( \
     1281       "    -w  Perform device reset (DANGEROUS)\n") \
     1282       "    -W  Set drive write-caching flag (0/1) (DANGEROUS)\n" \
     1283    USE_FEATURE_HDPARM_HDIO_TRISTATE_HWIF( \
     1284       "    -x  Tristate device for hotswap (0/1) (DANGEROUS)\n") \
     1285       "    -X  Set IDE xfer mode (DANGEROUS)\n" \
     1286       "    -y  Put IDE drive in standby mode\n" \
     1287       "    -Y  Put IDE drive to sleep\n" \
     1288       "    -Z  Disable Seagate auto-powersaving mode\n" \
     1289       "    -z  Re-read partition table"
    10381290
    10391291#define head_trivial_usage \
    1040     "[OPTION]... [FILE]..."
     1292       "[OPTION]... [FILE]..."
    10411293#define head_full_usage \
    1042     "Print first 10 lines of each FILE to standard output.\n" \
    1043     "With more than one FILE, precede each with a header giving the\n" \
    1044     "file name. With no FILE, or when FILE is -, read standard input.\n\n" \
    1045     "Options:\n" \
    1046     "\t-n NUM\t\tPrint first NUM lines instead of first 10" \
     1294       "Print first 10 lines of each FILE to standard output.\n" \
     1295       "With more than one FILE, precede each with a header giving the\n" \
     1296       "file name. With no FILE, or when FILE is -, read standard input." \
     1297       "\n\nOptions:" \
     1298       "\n  -n NUM  Print first NUM lines instead of first 10" \
    10471299    USE_FEATURE_FANCY_HEAD( \
    1048     "\n\t-c NUM\t\toutput the first NUM bytes\n" \
    1049     "\t-q\t\tnever output headers giving file names\n" \
    1050     "\t-v\t\talways output headers giving file names" )
     1300       "\n  -c NUM  Output the first NUM bytes" \
     1301       "\n  -q  Never output headers giving file names" \
     1302       "\n  -v  Always output headers giving file names")
    10511303#define head_example_usage \
    1052     "$ head -n 2 /etc/passwd\n" \
    1053     "root:x:0:0:root:/root:/bin/bash\n" \
    1054     "daemon:x:1:1:daemon:/usr/sbin:/bin/sh\n"
     1304       "$ head -n 2 /etc/passwd\n" \
     1305       "root:x:0:0:root:/root:/bin/bash\n" \
     1306       "daemon:x:1:1:daemon:/usr/sbin:/bin/sh\n"
    10551307
    10561308#define hexdump_trivial_usage \
    1057     "[-[bcCdefnosvx]] [OPTION] FILE"
     1309       "[-[bcCdefnosvx]] [OPTION] FILE"
    10581310#define hexdump_full_usage \
    1059     "The hexdump utility is a filter which displays the specified files,\n" \
    1060     "or the standard input, if no files are specified, in a user specified\n" \
    1061     "format\n" \
    1062     "\t-b\t\tOne-byte octal display\n" \
    1063     "\t-c\t\tOne-byte character display\n" \
    1064     "\t-C\t\tCanonical hex+ASCII, 16 bytes per line\n" \
    1065     "\t-d\t\tTwo-byte decimal display\n" \
    1066     "\t-e FORMAT STRING\n" \
    1067     "\t-f FORMAT FILE\n" \
    1068     "\t-n LENGTH\tInterpret only length bytes of input\n" \
    1069     "\t-o\t\tTwo-byte octal display\n" \
    1070     "\t-s OFFSET\tSkip offset byte\n" \
    1071     "\t-v\t\tdisplay all input data\n" \
    1072     "\t-x\t\tTwo-byte hexadecimal display"
     1311       "Display file(s) or standard input in a user specified format" \
     1312       "\n\nOptions:\n" \
     1313       "    -b      One-byte octal display\n" \
     1314       "    -c      One-byte character display\n" \
     1315       "    -C      Canonical hex+ASCII, 16 bytes per line\n" \
     1316       "    -d      Two-byte decimal display\n" \
     1317       "    -e FORMAT STRING\n" \
     1318       "    -f FORMAT FILE\n" \
     1319       "    -n LENGTH   Interpret only length bytes of input\n" \
     1320       "    -o      Two-byte octal display\n" \
     1321       "    -s OFFSET   Skip offset bytes\n" \
     1322       "    -v      Display all input data\n" \
     1323       "    -x      Two-byte hexadecimal display"
    10731324
    10741325#define hostid_trivial_usage \
    1075     ""
     1326       ""
    10761327#define hostid_full_usage \
    1077     "Print out a unique 32-bit identifier for the machine."
     1328       "Print out a unique 32-bit identifier for the machine"
    10781329
    10791330#define hostname_trivial_usage \
    1080     "[OPTION] {hostname | -F FILE}"
     1331       "[OPTION] {hostname | -F FILE}"
    10811332#define hostname_full_usage \
    1082     "Get or set the hostname or DNS domain name. If a hostname is given\n" \
    1083     "(or FILE with the -F parameter), the host name will be set.\n\n" \
    1084     "Options:\n" \
    1085     "\t-s\tShort\n" \
    1086     "\t-i\tAddresses for the hostname\n" \
    1087     "\t-d\tDNS domain name\n" \
    1088     "\t-f\tFully qualified domain name\n" \
    1089     "\t-F FILE\tUse the contents of FILE to specify the hostname"
     1333       "Get or set the hostname or DNS domain name. If a hostname is given\n" \
     1334       "(or FILE with the -F parameter), the host name will be set." \
     1335       "\n\nOptions:\n" \
     1336       "    -s  Short\n" \
     1337       "    -i  Addresses for the hostname\n" \
     1338       "    -d  DNS domain name\n" \
     1339       "    -f  Fully qualified domain name\n" \
     1340       "    -F FILE Use the contents of FILE to specify the hostname"
    10901341#define hostname_example_usage \
    1091     "$ hostname\n" \
    1092     "sage\n"
     1342       "$ hostname\n" \
     1343       "sage\n"
    10931344
    10941345#define httpd_trivial_usage \
    1095     "[-c <conf file>]" \
    1096     USE_FEATURE_HTTPD_WITHOUT_INETD(" [-p <port>]") \
    1097     USE_FEATURE_HTTPD_SETUID(" [-u user]") \
    1098     USE_FEATURE_HTTPD_BASIC_AUTH(" [-r <realm>]") \
     1346       "[-c conffile]" \
     1347       " [-p [ip:]port]" \
     1348       " [-i] [-f] [-v[v]]" \
     1349    USE_FEATURE_HTTPD_SETUID(" [-u user[:grp]]") \
     1350    USE_FEATURE_HTTPD_BASIC_AUTH(" [-r realm]") \
    10991351    USE_FEATURE_HTTPD_AUTH_MD5(" [-m pass]") \
    1100     " [-h home]" \
    1101     " [-d/-e <string>]"
     1352       " [-h home]" \
     1353       " [-d/-e string]"
    11021354#define httpd_full_usage \
    1103     "Listens for incoming http server requests.\n\n" \
    1104     "Options:\n" \
    1105     "\t-c FILE\t\tSpecifies configuration file. (default httpd.conf)\n" \
    1106     USE_FEATURE_HTTPD_WITHOUT_INETD("\t-p PORT\tServer port (default 80)\n") \
    1107     USE_FEATURE_HTTPD_SETUID("\t-u USER\tSet uid to USER after listening privileges port\n") \
    1108     USE_FEATURE_HTTPD_BASIC_AUTH("\t-r REALM\tAuthentication Realm for Basic Authentication\n") \
    1109     USE_FEATURE_HTTPD_AUTH_MD5("\t-m PASS\t\tCrypt PASS with md5 algorithm\n") \
    1110     "\t-h HOME  \tSpecifies http HOME directory (default ./)\n" \
    1111     "\t-e STRING\tHtml encode STRING\n" \
    1112     "\t-d STRING\tURL decode STRING"
     1355       "Listen for incoming HTTP requests" \
     1356       "\n\nOptions:" \
     1357       "\n  -c FILE     Configuration file (default httpd.conf)" \
     1358       "\n  -p [IP:]PORT    Bind to ip:port (default *:80)" \
     1359       "\n  -i      Inetd mode" \
     1360       "\n  -f      Do not daemonize" \
     1361       "\n  -v[v]       Verbose" \
     1362    USE_FEATURE_HTTPD_SETUID( \
     1363       "\n  -u USER[:GRP]   Set uid/gid after binding to port") \
     1364    USE_FEATURE_HTTPD_BASIC_AUTH( \
     1365       "\n  -r REALM    Authentication Realm for Basic Authentication") \
     1366    USE_FEATURE_HTTPD_AUTH_MD5( \
     1367       "\n  -m PASS     Crypt PASS with md5 algorithm") \
     1368       "\n  -h HOME     Home directory (default .)" \
     1369       "\n  -e STRING   HTML encode STRING" \
     1370       "\n  -d STRING   URL decode STRING" \
    11131371
    11141372#define hwclock_trivial_usage \
    1115     "[-r|--show] [-s|--hctosys] [-w|--systohc] [-l|--localtime] [-u|--utc]"
     1373       "[-r|--show] [-s|--hctosys] [-w|--systohc]" \
     1374       " [-l|--localtime] [-u|--utc]" \
     1375       " [-f FILE]"
    11161376#define hwclock_full_usage \
    1117     "Query and set the hardware clock (RTC)\n\n" \
    1118     "Options:\n" \
    1119     "\t-r\tread hardware clock and print result\n" \
    1120     "\t-s\tset the system time from the hardware clock\n" \
    1121     "\t-w\tset the hardware clock to the current system time\n" \
    1122     "\t-u\tthe hardware clock is kept in coordinated universal time\n" \
    1123     "\t-l\tthe hardware clock is kept in local time"
    1124 
    1125 #ifdef CONFIG_SELINUX
    1126 #  define USAGE_SELINUX(a) a
    1127 #else
    1128 #  define USAGE_SELINUX(a)
    1129 #endif
     1377       "Query and set a hardware clock (RTC)" \
     1378       "\n\nOptions:\n" \
     1379       "    -r  Read hardware clock and print result\n" \
     1380       "    -s  Set the system time from the hardware clock\n" \
     1381       "    -w  Set the hardware clock to the current system time\n" \
     1382       "    -u  The hardware clock is kept in coordinated universal time\n" \
     1383       "    -l  The hardware clock is kept in local time\n" \
     1384       "    -f FILE Use the specified clock (e.g. /dev/rtc2)"
    11301385
    11311386#define id_trivial_usage \
    1132     "[OPTIONS]... [USERNAME]"
     1387       "[OPTIONS]... [USERNAME]"
    11331388#define id_full_usage \
    1134     "Print information for USERNAME or the current user\n\n" \
    1135     "Options:\n" \
    1136     USAGE_SELINUX("\t-c\tprints only the security context\n") \
    1137     "\t-g\tprints only the group ID\n" \
    1138     "\t-u\tprints only the user ID\n" \
    1139     "\t-n\tprint a name instead of a number\n" \
    1140     "\t-r\tprints the real user ID instead of the effective ID"
     1389       "Print information for USERNAME or the current user" \
     1390       "\n\nOptions:\n" \
     1391    USE_SELINUX( \
     1392       "    -Z  prints only the security context\n" \
     1393    ) \
     1394       "    -g  Prints only the group ID\n" \
     1395       "    -u  Prints only the user ID\n" \
     1396       "    -n  Print a name instead of a number\n" \
     1397       "    -r  Prints the real user ID instead of the effective ID"
    11411398#define id_example_usage \
    1142     "$ id\n" \
    1143     "uid=1000(andersen) gid=1000(andersen)\n"
    1144 
    1145 #ifdef CONFIG_FEATURE_IFCONFIG_SLIP
    1146 #  define USAGE_SIOCSKEEPALIVE(a) a
    1147 #else
    1148 #  define USAGE_SIOCSKEEPALIVE(a)
    1149 #endif
    1150 #ifdef CONFIG_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
    1151 #  define USAGE_IFCONFIG_MII(a) a
    1152 #else
    1153 #  define USAGE_IFCONFIG_MII(a)
    1154 #endif
    1155 #ifdef CONFIG_FEATURE_IFCONFIG_HW
    1156 #  define USAGE_IFCONFIG_HW(a) a
    1157 #else
    1158 #  define USAGE_IFCONFIG_HW(a)
    1159 #endif
    1160 #ifdef CONFIG_FEATURE_IFCONFIG_STATUS
    1161 #  define USAGE_IFCONFIG_OPT_A(a) a
    1162 #else
    1163 #  define USAGE_IFCONFIG_OPT_A(a)
    1164 #endif
    1165 #ifdef CONFIG_FEATURE_IPV6
    1166 #  define USAGE_IPV6(a) a
    1167 #else
    1168 #  define USAGE_IPV6(a)
    1169 #endif
     1399       "$ id\n" \
     1400       "uid=1000(andersen) gid=1000(andersen)\n"
    11701401
    11711402#define ifconfig_trivial_usage \
    1172     USAGE_IFCONFIG_OPT_A("[-a]") " <interface> [<address>]"
     1403    USE_FEATURE_IFCONFIG_STATUS("[-a]") " interface [address]"
    11731404#define ifconfig_full_usage \
    1174     "configure a network interface\n\n" \
    1175     "Options:\n" \
    1176     USAGE_IPV6("\t[add <address>[/<prefixlen>]]\n") \
    1177     USAGE_IPV6("\t[del <address>[/<prefixlen>]]\n") \
    1178     "\t[[-]broadcast [<address>]]  [[-]pointopoint [<address>]]\n" \
    1179     "\t[netmask <address>]  [dstaddr <address>]\n" \
    1180     USAGE_SIOCSKEEPALIVE("\t[outfill <NN>] [keepalive <NN>]\n") \
    1181     "\t" USAGE_IFCONFIG_HW("[hw ether <address>]  ") \
    1182     "[metric <NN>]  [mtu <NN>]\n" \
    1183     "\t[[-]trailers]  [[-]arp]  [[-]allmulti]\n" \
    1184     "\t[multicast]  [[-]promisc]  [txqueuelen <NN>]  [[-]dynamic]\n" \
    1185     USAGE_IFCONFIG_MII("\t[mem_start <NN>]  [io_addr <NN>]  [irq <NN>]\n") \
    1186     "\t[up|down] ..."
     1405       "Configure a network interface" \
     1406       "\n\nOptions:\n" \
     1407    USE_FEATURE_IPV6( \
     1408       "    [add ADDRESS[/PREFIXLEN]]\n") \
     1409    USE_FEATURE_IPV6( \
     1410       "    [del ADDRESS[/PREFIXLEN]]\n") \
     1411       "    [[-]broadcast [ADDRESS]] [[-]pointopoint [ADDRESS]]\n" \
     1412       "    [netmask ADDRESS] [dstaddr ADDRESS]\n" \
     1413    USE_FEATURE_IFCONFIG_SLIP( \
     1414       "    [outfill NN] [keepalive NN]\n") \
     1415       "    " USE_FEATURE_IFCONFIG_HW("[hw ether ADDRESS] ") "[metric NN] [mtu NN]\n" \
     1416       "    [[-]trailers] [[-]arp] [[-]allmulti]\n" \
     1417       "    [multicast] [[-]promisc] [txqueuelen NN] [[-]dynamic]\n" \
     1418    USE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ( \
     1419       "    [mem_start NN] [io_addr NN] [irq NN]\n") \
     1420       "    [up|down] ..."
    11871421
    11881422#define ifup_trivial_usage \
    1189     "<-ahinv> <ifaces...>"
     1423       "[-ahinv] ifaces..."
    11901424#define ifup_full_usage \
    1191     "ifup <options> <ifaces...>\n\n" \
    1192     "Options:\n" \
    1193     "\t-h\tthis help\n" \
    1194     "\t-a\tde/configure all interfaces automatically\n" \
    1195     "\t-i FILE\tuse FILE for interface definitions\n" \
    1196     "\t-n\tprint out what would happen, but don't do it\n" \
    1197     "\t\t\t(note that this option doesn't disable mappings)\n" \
    1198     "\t-v\tprint out what would happen before doing it\n" \
    1199     "\t-m\tdon't run any mappings\n" \
    1200     "\t-f\tforce de/configuration"
     1425       "Options:\n" \
     1426       "    -a  De/configure all interfaces automatically\n" \
     1427       "    -i FILE Use FILE for interface definitions\n" \
     1428       "    -n  Print out what would happen, but don't do it\n" \
     1429       "        (note that this option doesn't disable mappings)\n" \
     1430       "    -v  Print out what would happen before doing it\n" \
     1431       "    -m  Don't run any mappings\n" \
     1432       "    -f  Force de/configuration"
    12011433
    12021434#define ifdown_trivial_usage \
    1203     "<-ahinv> <ifaces...>"
     1435       "[-ahinv] ifaces..."
    12041436#define ifdown_full_usage \
    1205     "ifdown <options> <ifaces...>\n\n" \
    1206     "Options:\n" \
    1207     "\t-h\tthis help\n" \
    1208     "\t-a\tde/configure all interfaces automatically\n" \
    1209     "\t-i FILE\tuse FILE for interface definitions\n" \
    1210     "\t-n\tprint out what would happen, but don't do it\n" \
    1211     "\t\t(note that this option doesn't disable mappings)\n" \
    1212     "\t-v\tprint out what would happen before doing it\n" \
    1213     "\t-m\tdon't run any mappings\n" \
    1214     "\t-f\tforce de/configuration"
     1437       "Options:\n" \
     1438       "    -a  De/configure all interfaces automatically\n" \
     1439       "    -i FILE Use FILE for interface definitions\n" \
     1440       "    -n  Print out what would happen, but don't do it\n" \
     1441       "        (note that this option doesn't disable mappings)\n" \
     1442       "    -v  Print out what would happen before doing it\n" \
     1443       "    -m  Don't run any mappings\n" \
     1444       "    -f  Force de/configuration"
    12151445
    12161446#define inetd_trivial_usage \
    1217     "[-f] [-q len] [conf]"
     1447       "[-f] [-q len] [conf]"
    12181448#define inetd_full_usage \
    1219     "Listens for network connections and launches programs\n\n" \
    1220     "Option:\n" \
    1221     "\t-f\tRun as a foreground progress\n" \
    1222     "\t-q\tSets the size of the socket listen queue to\n" \
    1223     "\t\tthe specified value. Default is 128"
     1449       "Listen for network connections and launch programs" \
     1450       "\n\nOptions:\n" \
     1451       "    -f  Run in foreground\n" \
     1452       "    -q N    Set the size of the socket listen queue to N\n" \
     1453       "        (default: 128)"
    12241454
    12251455#define init_trivial_usage \
    1226     ""
     1456       ""
    12271457#define init_full_usage \
    1228     "Init is the parent of all processes."
     1458       "Init is the parent of all processes"
    12291459#define init_notes_usage \
    12301460"This version of init is designed to be run only by the kernel.\n" \
    12311461"\n" \
    1232 "BusyBox init doesn't support multiple runlevels.  The runlevels field of\n" \
    1233 "the /etc/inittab file is completely ignored by BusyBox init. If you want \n" \
     1462"BusyBox init doesn't support multiple runlevels. The runlevels field of\n" \
     1463"the /etc/inittab file is completely ignored by BusyBox init. If you want\n" \
    12341464"runlevels, use sysvinit.\n" \
    12351465"\n" \
    1236 "BusyBox init works just fine without an inittab.  If no inittab is found, \n" \
     1466"BusyBox init works just fine without an inittab. If no inittab is found,\n" \
    12371467"it has the following default behavior:\n" \
    12381468"\n" \
     
    12581488"       WARNING: This field has a non-traditional meaning for BusyBox init!\n" \
    12591489"       The id field is used by BusyBox init to specify the controlling tty for\n" \
    1260 "       the specified process to run on.  The contents of this field are\n" \
    1261 "       appended to \"/dev/\" and used as-is.  There is no need for this field to\n" \
    1262 "       be unique, although if it isn't you may have strange results.  If this\n" \
    1263 "       field is left blank, the controlling tty is set to the console.  Also\n" \
     1490"       the specified process to run on. The contents of this field are\n" \
     1491"       appended to \"/dev/\" and used as-is. There is no need for this field to\n" \
     1492"       be unique, although if it isn't you may have strange results. If this\n" \
     1493"       field is left blank, the controlling tty is set to the console. Also\n" \
    12641494"       note that if BusyBox detects that a serial console is in use, then only\n" \
    12651495"       entries whose controlling tty is either the serial console or /dev/null\n" \
    1266 "       will be run.  BusyBox init does nothing with utmp. We don't need no\n" \
     1496"       will be run. BusyBox init does nothing with utmp. We don't need no\n" \
    12671497"       stinkin' utmp.\n" \
    12681498"\n" \
     
    12821512"       Run only-once actions:\n" \
    12831513"\n" \
    1284 "           'sysinit' is the first item run on boot.  init waits until all\n" \
    1285 "           sysinit actions are completed before continuing.  Following the\n" \
     1514"           'sysinit' is the first item run on boot. init waits until all\n" \
     1515"           sysinit actions are completed before continuing. Following the\n" \
    12861516"           completion of all sysinit actions, all 'wait' actions are run.\n" \
    1287 "           'wait' actions, like  'sysinit' actions, cause init to wait until\n" \
    1288 "           the specified task completes.  'once' actions are asynchronous,\n" \
    1289 "           therefore, init does not wait for them to complete.  'restart' is\n" \
    1290 "           the action taken to restart the init process.  By default this should\n" \
     1517"           'wait' actions, like 'sysinit' actions, cause init to wait until\n" \
     1518"           the specified task completes. 'once' actions are asynchronous,\n" \
     1519"           therefore, init does not wait for them to complete. 'restart' is\n" \
     1520"           the action taken to restart the init process. By default this should\n" \
    12911521"           simply run /sbin/init, but can be a script which runs pivot_root or it\n" \
    1292 "           can do all sorts of other interesting things.  The 'ctrlaltdel' init\n" \
     1522"           can do all sorts of other interesting things. The 'ctrlaltdel' init\n" \
    12931523"           actions are run when the system detects that someone on the system\n" \
    1294 "                       console has pressed the CTRL-ALT-DEL key combination. Typically one\n" \
    1295 "                       wants to run 'reboot' at this point to cause the system to reboot.\n" \
     1524"           console has pressed the CTRL-ALT-DEL key combination. Typically one\n" \
     1525"           wants to run 'reboot' at this point to cause the system to reboot.\n" \
    12961526"           Finally the 'shutdown' action specifies the actions to taken when\n" \
    1297 "                       init is told to reboot. Unmounting filesystems and disabling swap\n" \
    1298 "                       is a very good here\n" \
     1527"           init is told to reboot. Unmounting filesystems and disabling swap\n" \
     1528"           is a very good here.\n" \
    12991529"\n" \
    13001530"       Run repeatedly actions:\n" \
    13011531"\n" \
    1302 "           'respawn' actions are run after the 'once' actions.  When a process\n" \
     1532"           'respawn' actions are run after the 'once' actions. When a process\n" \
    13031533"           started with a 'respawn' action exits, init automatically restarts\n" \
    1304 "           it.  Unlike sysvinit, BusyBox init does not stop processes from\n" \
    1305 "           respawning out of control.  The 'askfirst' actions acts just like\n" \
     1534"           it. Unlike sysvinit, BusyBox init does not stop processes from\n" \
     1535"           respawning out of control. The 'askfirst' actions acts just like\n" \
    13061536"           respawn, except that before running the specified process it\n" \
    13071537"           displays the line \"Please press Enter to activate this console.\"\n" \
     
    13101540"\n" \
    13111541"       Unrecognized actions (like initdefault) will cause init to emit an\n" \
    1312 "       error message, and then go along with its business.  All actions are\n" \
     1542"       error message, and then go along with its business. All actions are\n" \
    13131543"       run in the order they appear in /etc/inittab.\n" \
    13141544"\n" \
     
    13191549"Example /etc/inittab file:\n" \
    13201550"\n" \
    1321 "   # This is run first except when booting in single-user mode.\n" \
     1551"   # This is run first except when booting in single-user mode\n" \
    13221552"   #\n" \
    13231553"   ::sysinit:/etc/init.d/rcS\n" \
     
    13431573"   #::respawn:/sbin/getty -L ttyS1 9600 vt100\n" \
    13441574"   #\n" \
    1345 "   # Example how to put a getty on a modem line.\n" \
     1575"   # Example how to put a getty on a modem line\n" \
    13461576"   #::respawn:/sbin/getty 57600 ttyS2\n" \
    13471577"   \n" \
     
    13541584"   ::shutdown:/sbin/swapoff -a\n"
    13551585
    1356 #ifdef CONFIG_FEATURE_INSMOD_LOAD_MAP
    1357 #  define USAGE_INSMOD_MAP(a) a
    1358 #else
    1359 #  define USAGE_INSMOD_MAP(a)
     1586#define insmod_trivial_usage \
     1587       "[OPTION]... MODULE [symbol=value]..."
     1588#define insmod_full_usage \
     1589       "Load the specified kernel modules into the kernel" \
     1590       "\n\nOptions:\n" \
     1591       "    -f  Force module to load into the wrong kernel version\n" \
     1592       "    -k  Make module autoclean-able\n" \
     1593       "    -v  Verbose\n" \
     1594       "    -q  Quiet\n" \
     1595       "    -L  Lock to prevent simultaneous loads of a module\n" \
     1596    USE_FEATURE_INSMOD_LOAD_MAP( \
     1597       "    -m  Output load map to stdout\n") \
     1598       "    -o NAME Set internal module name to NAME\n" \
     1599       "    -x  Do not export externs"
     1600
     1601#define install_trivial_usage \
     1602       "[-cgmops] [sources] dest|directory"
     1603#define install_full_usage \
     1604       "Copy files and set attributes" \
     1605       "\n\nOptions:\n" \
     1606       "    -c  Copy the file, default\n" \
     1607       "    -d  Create directories\n" \
     1608       "    -g  Set group ownership\n" \
     1609       "    -m  Set permission modes\n" \
     1610       "    -o  Set ownership\n" \
     1611       "    -p  Preserve date\n" \
     1612       "    -s  Strip symbol tables" \
     1613    USE_SELINUX( \
     1614       "\n  -Z  Set security context of copy" \
     1615    )
     1616/* would need to make the " | " optional depending on more than one selected */
     1617#define ip_trivial_usage \
     1618       "[OPTIONS] {" \
     1619    USE_FEATURE_IP_ADDRESS("address | ") \
     1620    USE_FEATURE_IP_ROUTE("route | ") \
     1621    USE_FEATURE_IP_LINK("link | ") \
     1622    USE_FEATURE_IP_TUNNEL("tunnel | ") \
     1623    USE_FEATURE_IP_RULE("rule") \
     1624       "} {COMMAND}"
     1625#define ip_full_usage \
     1626       "ip [OPTIONS] OBJECT {COMMAND}\n" \
     1627       "where OBJECT := {" \
     1628    USE_FEATURE_IP_ADDRESS("address | ") \
     1629    USE_FEATURE_IP_ROUTE("route | ") \
     1630    USE_FEATURE_IP_LINK("link | ") \
     1631    USE_FEATURE_IP_TUNNEL("tunnel | ") \
     1632    USE_FEATURE_IP_RULE("rule") \
     1633       "}\n" \
     1634       "OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }"
     1635
     1636#define ipaddr_trivial_usage \
     1637       "{ {add|del} IFADDR dev STRING | {show|flush}\n" \
     1638       "        [dev STRING] [to PREFIX] }"
     1639#define ipaddr_full_usage \
     1640       "ipaddr {add|delete} IFADDR dev STRING\n" \
     1641       "ipaddr {show|flush} [dev STRING] [scope SCOPE-ID]\n" \
     1642       "    [to PREFIX] [label PATTERN]\n" \
     1643       "    IFADDR := PREFIX | ADDR peer PREFIX\n" \
     1644       "    [broadcast ADDR] [anycast ADDR]\n" \
     1645       "    [label STRING] [scope SCOPE-ID]\n" \
     1646       "    SCOPE-ID := [host | link | global | NUMBER]"
     1647
     1648#define ipcalc_trivial_usage \
     1649       "[OPTION]... ADDRESS[[/]NETMASK] [NETMASK]"
     1650#define ipcalc_full_usage \
     1651       "Calculate IP network settings from a IP address" \
     1652       "\n\nOptions:" \
     1653       "\n  -b  --broadcast Display calculated broadcast address" \
     1654       "\n  -n  --network   Display calculated network address" \
     1655       "\n  -m  --netmask   Display default netmask for IP" \
     1656    USE_FEATURE_IPCALC_FANCY( \
     1657       "\n  -p  --prefix    Display the prefix for IP/NETMASK" \
     1658       "\n  -h  --hostname  Display first resolved host name" \
     1659       "\n  -s  --silent    Don't ever display error messages")
     1660
     1661#define ipcrm_trivial_usage \
     1662       "[-[MQS] key] [-[mqs] id]"
     1663#define ipcrm_full_usage \
     1664       "The upper-case options MQS are used to remove a shared memory segment by a\n" \
     1665       "segment by a shmkey value. The lower-case options mqs are used\n" \
     1666       "to remove a segment by shmid value.\n" \
     1667       "\n\nOptions:\n" \
     1668       "    -[mM]   Remove the memory segment after the last detach\n" \
     1669       "    -[qQ]   Remove the message queue\n" \
     1670       "    -[sS]   Remove the semaphore"
     1671
     1672#define ipcs_trivial_usage \
     1673       "[[-smq] -i shmid] | [[-asmq] [-tcplu]]"
     1674#define ipcs_full_usage \
     1675       "    -i  Specify a specific resource id\n" \
     1676       "Resource specification:\n" \
     1677       "    -m  Shared memory segments\n" \
     1678       "    -q  Message queues\n" \
     1679       "    -s  Semaphore arrays\n" \
     1680       "    -a  All (default)\n" \
     1681       "Output format:\n" \
     1682       "    -t  Time\n" \
     1683       "    -c  Creator\n" \
     1684       "    -p  Pid\n" \
     1685       "    -l  Limits\n" \
     1686       "    -u  Summary"
     1687
     1688#define iplink_trivial_usage \
     1689       "{ set DEVICE { up | down | arp { on | off } | show [DEVICE] }"
     1690#define iplink_full_usage \
     1691       "iplink set DEVICE { up | down | arp | multicast { on | off } |\n" \
     1692       "            dynamic { on | off } |\n" \
     1693       "            mtu MTU }\n" \
     1694       "iplink show [DEVICE]"
     1695
     1696#define iproute_trivial_usage \
     1697       "{ list | flush | { add | del | change | append |\n" \
     1698       "        replace | monitor } ROUTE }"
     1699#define iproute_full_usage \
     1700       "iproute { list | flush } SELECTOR\n" \
     1701       "iproute get ADDRESS [from ADDRESS iif STRING]\n" \
     1702       "            [oif STRING]  [tos TOS]\n" \
     1703       "iproute { add | del | change | append | replace | monitor } ROUTE\n" \
     1704       "            SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n" \
     1705       "            ROUTE := [TYPE] PREFIX [tos TOS] [proto RTPROTO]"
     1706
     1707#define iprule_trivial_usage \
     1708       "{[list | add | del] RULE}"
     1709#define iprule_full_usage \
     1710       "iprule [list | add | del] SELECTOR ACTION\n" \
     1711       "    SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n" \
     1712       "            [dev STRING] [pref NUMBER]\n" \
     1713       "    ACTION := [table TABLE_ID] [nat ADDRESS]\n" \
     1714       "            [prohibit | reject | unreachable]\n" \
     1715       "            [realms [SRCREALM/]DSTREALM]\n" \
     1716       "    TABLE_ID := [local | main | default | NUMBER]"
     1717
     1718#define iptunnel_trivial_usage \
     1719       "{ add | change | del | show } [NAME]\n" \
     1720       "    [mode { ipip | gre | sit }]\n" \
     1721       "    [remote ADDR] [local ADDR] [ttl TTL]"
     1722#define iptunnel_full_usage \
     1723       "iptunnel { add | change | del | show } [NAME]\n" \
     1724       "    [mode { ipip | gre | sit }] [remote ADDR] [local ADDR]\n" \
     1725       "    [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n" \
     1726       "    [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]"
     1727
     1728#define kill_trivial_usage \
     1729       "[-l] [-signal] process-id [process-id ...]"
     1730#define kill_full_usage \
     1731       "Send a signal (default is TERM) to the specified process(es)" \
     1732       "\n\nOptions:\n" \
     1733       "    -l  List all signal names and numbers"
     1734#define kill_example_usage \
     1735       "$ ps | grep apache\n" \
     1736       "252 root     root     S [apache]\n" \
     1737       "263 www-data www-data S [apache]\n" \
     1738       "264 www-data www-data S [apache]\n" \
     1739       "265 www-data www-data S [apache]\n" \
     1740       "266 www-data www-data S [apache]\n" \
     1741       "267 www-data www-data S [apache]\n" \
     1742       "$ kill 252\n"
     1743
     1744#define killall_trivial_usage \
     1745       "[-l] [-q] [-signal] process-name [process-name ...]"
     1746#define killall_full_usage \
     1747       "Send a signal (default is TERM) to the specified process(es)" \
     1748       "\n\nOptions:\n" \
     1749       "    -l  List all signal names and numbers\n" \
     1750       "    -q  Do not complain if no processes were killed"
     1751#define killall_example_usage \
     1752       "$ killall apache\n"
     1753
     1754#define killall5_trivial_usage \
     1755       "[-l] [-signal]"
     1756#define killall5_full_usage \
     1757       "Send a signal (default is TERM) to all processes outside current session" \
     1758       "\n\nOptions:\n" \
     1759       "    -l  List all signal names and numbers\n" \
     1760
     1761#define klogd_trivial_usage \
     1762       "[-c n] [-n]"
     1763#define klogd_full_usage \
     1764       "Kernel logger" \
     1765       "\n\nOptions:\n" \
     1766       "    -c n    Sets the default log level of console messages to n\n" \
     1767       "    -n  Run as foreground process"
     1768
     1769#define length_trivial_usage \
     1770       "STRING"
     1771#define length_full_usage \
     1772       "Print out the length of the specified STRING"
     1773#define length_example_usage \
     1774       "$ length Hello\n" \
     1775       "5\n"
     1776
     1777#define less_trivial_usage \
     1778       "[-EMNmh~?] FILE1 FILE2..."
     1779#define less_full_usage \
     1780       "View a file or list of files. The position within files can be\n" \
     1781       "changed, and files can be manipulated in various ways." \
     1782       "\n\nOptions:\n" \
     1783       "    -E  Quit once the end of a file is reached\n" \
     1784       "    -M  Display a status line containing the current line numbers\n" \
     1785       "        and the percentage through the file\n" \
     1786       "    -N  Prefix line numbers to each line\n" \
     1787       "    -m  Display a status line containing the percentage through the\n" \
     1788       "        file\n" \
     1789       "    -~  Suppress ~s displayed when input past the end of the file is\n" \
     1790       "        reached"
     1791
     1792#define setarch_trivial_usage \
     1793       "personality program [args ...]"
     1794#define setarch_full_usage \
     1795       "Personality may be:\n" \
     1796       "    linux32     Set 32bit uname emulation\n" \
     1797       "    linux64     Set 64bit uname emulation"
     1798
     1799#define ln_trivial_usage \
     1800       "[OPTION] TARGET... LINK_NAME|DIRECTORY"
     1801#define ln_full_usage \
     1802       "Create a link named LINK_NAME or DIRECTORY to the specified TARGET.\n" \
     1803       "You may use '--' to indicate that all following arguments are non-options." \
     1804       "\n\nOptions:\n" \
     1805       "    -s  Make symlinks instead of hardlinks\n" \
     1806       "    -f  Remove existing destination files\n" \
     1807       "    -n  No dereference symlinks - treat like normal file\n" \
     1808       "    -b  Make a backup of the target (if exists) before link operation\n" \
     1809       "    -S suf  Use suffix instead of ~ when making backup files"
     1810#define ln_example_usage \
     1811       "$ ln -s BusyBox /tmp/ls\n" \
     1812       "$ ls -l /tmp/ls\n" \
     1813       "lrwxrwxrwx    1 root     root            7 Apr 12 18:39 ls -> BusyBox*\n"
     1814
     1815#define load_policy_trivial_usage \
     1816       "[FILE]"
     1817#define load_policy_full_usage
     1818
     1819#define loadfont_trivial_usage \
     1820       "< font"
     1821#define loadfont_full_usage \
     1822       "Load a console font from standard input"
     1823#define loadfont_example_usage \
     1824       "$ loadfont < /etc/i18n/fontname\n"
     1825
     1826#define loadkmap_trivial_usage \
     1827       "< keymap"
     1828#define loadkmap_full_usage \
     1829       "Load a binary keyboard translation table from standard input"
     1830#define loadkmap_example_usage \
     1831       "$ loadkmap < /etc/i18n/lang-keymap\n"
     1832
     1833#define logger_trivial_usage \
     1834       "[OPTION]... [MESSAGE]"
     1835#define logger_full_usage \
     1836       "Write MESSAGE to the system log. If MESSAGE is omitted, log stdin." \
     1837       "\n\nOptions:\n" \
     1838       "    -s  Log to stderr as well as the system log\n" \
     1839       "    -t TAG  Log using the specified tag (defaults to user name)\n" \
     1840       "    -p PRIO Enter the message with the specified priority.\n" \
     1841       "        This may be numerical or a 'facility.level' pair."
     1842#define logger_example_usage \
     1843       "$ logger \"hello\"\n"
     1844
     1845#define login_trivial_usage \
     1846       "[OPTION]... [username] [ENV=VAR ...]"
     1847#define login_full_usage \
     1848       "Begin a new session on the system" \
     1849       "\n\nOptions:\n" \
     1850       "    -f  Do not authenticate (user already authenticated)\n" \
     1851       "    -h  Name of the remote host for this login\n" \
     1852       "    -p  Preserve environment"
     1853
     1854#define logname_trivial_usage \
     1855       ""
     1856#define logname_full_usage \
     1857       "Print the name of the current user"
     1858#define logname_example_usage \
     1859       "$ logname\n" \
     1860       "root\n"
     1861
     1862#define logread_trivial_usage \
     1863       "[OPTION]..."
     1864#define logread_full_usage \
     1865       "Show the messages from syslogd (using circular buffer)" \
     1866       "\n\nOptions:\n" \
     1867       "    -f  Output data as the log grows"
     1868
     1869#define losetup_trivial_usage \
     1870       "[-o OFFSET] [-d] LOOPDEVICE [FILE]]"
     1871#define losetup_full_usage \
     1872       "(Dis)associate LOOPDEVICE with FILE, or display current associations" \
     1873       "\n\nOptions:\n" \
     1874       "    -d      Disassociate LOOPDEVICE\n" \
     1875       "    -o OFFSET   Start OFFSET bytes into FILE"
     1876#define losetup_notes_usage \
     1877       "No arguments will display all current associations.\n" \
     1878       "One argument (losetup /dev/loop1) will display the current association\n" \
     1879       "(if any), or disassociate it (with -d). The display shows the offset\n" \
     1880       "and filename of the file the loop device is currently bound to.\n\n" \
     1881       "Two arguments (losetup /dev/loop1 file.img) create a new association,\n" \
     1882       "with an optional offset (-o 12345). Encryption is not yet supported.\n\n"
     1883
     1884#define ls_trivial_usage \
     1885       "[-1Aa" USE_FEATURE_LS_TIMESTAMPS("c") "Cd" \
     1886    USE_FEATURE_LS_TIMESTAMPS("e") USE_FEATURE_LS_FILETYPES("F") "iln" \
     1887    USE_FEATURE_LS_FILETYPES("p") USE_FEATURE_LS_FOLLOWLINKS("L") \
     1888    USE_FEATURE_LS_RECURSIVE("R") USE_FEATURE_LS_SORTFILES("rS") "s" \
     1889    USE_FEATURE_AUTOWIDTH("T") USE_FEATURE_LS_TIMESTAMPS("tu") \
     1890    USE_FEATURE_LS_SORTFILES("v") USE_FEATURE_AUTOWIDTH("w") "x" \
     1891    USE_FEATURE_LS_SORTFILES("X") USE_FEATURE_HUMAN_READABLE("h") "k" \
     1892    USE_SELINUX("K") "] [filenames...]"
     1893#define ls_full_usage \
     1894       "List directory contents" \
     1895       "\n\nOptions:" \
     1896       "\n  -1  List files in a single column" \
     1897       "\n  -A  Do not list implied . and .." \
     1898       "\n  -a  Do not hide entries starting with ." \
     1899       "\n  -C  List entries by columns" \
     1900    USE_FEATURE_LS_TIMESTAMPS( \
     1901       "\n  -c  With -l: show ctime") \
     1902    USE_FEATURE_LS_COLOR( \
     1903       "\n  --color[={always,never,auto}]   Control coloring") \
     1904       "\n  -d  List directory entries instead of contents" \
     1905    USE_FEATURE_LS_TIMESTAMPS( \
     1906       "\n  -e  List both full date and full time") \
     1907    USE_FEATURE_LS_FILETYPES( \
     1908       "\n  -F  Append indicator (one of */=@|) to entries") \
     1909       "\n  -i  List the i-node for each file" \
     1910       "\n  -l  Use a long listing format" \
     1911       "\n  -n  List numeric UIDs and GIDs instead of names" \
     1912    USE_FEATURE_LS_FILETYPES( \
     1913       "\n  -p  Append indicator (one of /=@|) to entries") \
     1914    USE_FEATURE_LS_FOLLOWLINKS( \
     1915       "\n  -L  List entries pointed to by symlinks") \
     1916    USE_FEATURE_LS_RECURSIVE( \
     1917       "\n  -R  List subdirectories recursively") \
     1918    USE_FEATURE_LS_SORTFILES( \
     1919       "\n  -r  Sort the listing in reverse order") \
     1920    USE_FEATURE_LS_SORTFILES( \
     1921       "\n  -S  Sort the listing by file size") \
     1922       "\n  -s  List the size of each file, in blocks" \
     1923    USE_FEATURE_AUTOWIDTH( \
     1924       "\n  -T NUM  Assume Tabstop every NUM columns") \
     1925    USE_FEATURE_LS_TIMESTAMPS( \
     1926       "\n  -t  With -l: show modification time") \
     1927    USE_FEATURE_LS_TIMESTAMPS( \
     1928       "\n  -u  With -l: show access time") \
     1929    USE_FEATURE_LS_SORTFILES( \
     1930       "\n  -v  Sort the listing by version") \
     1931    USE_FEATURE_AUTOWIDTH( \
     1932       "\n  -w NUM  Assume the terminal is NUM columns wide") \
     1933       "\n  -x  List entries by lines instead of by columns" \
     1934    USE_FEATURE_LS_SORTFILES( \
     1935       "\n  -X  Sort the listing by extension") \
     1936    USE_FEATURE_HUMAN_READABLE( \
     1937       "\n  -h  Print sizes in human readable format (e.g., 1K 243M 2G)") \
     1938    USE_SELINUX( \
     1939       "\n  -k  Print security context") \
     1940    USE_SELINUX( \
     1941       "\n  -K  Print security context in long format") \
     1942    USE_SELINUX( \
     1943       "\n  -Z  Print security context and permission")
     1944
     1945#define lsattr_trivial_usage \
     1946       "[-Radlv] [files...]"
     1947#define lsattr_full_usage \
     1948       "List file attributes on an ext2 fs" \
     1949       "\n\nOptions:\n" \
     1950       "    -R  Recursively list subdirectories\n" \
     1951       "    -a  Do not hide entries starting with .\n" \
     1952       "    -d  List directory entries instead of contents\n" \
     1953       "    -l  Print long flag names\n" \
     1954       "    -v  List the file's version/generation number"
     1955
     1956#define lsmod_trivial_usage \
     1957       ""
     1958#define lsmod_full_usage \
     1959       "List the currently loaded kernel modules"
     1960
     1961#if ENABLE_FEATURE_MAKEDEVS_LEAF
     1962#define makedevs_trivial_usage \
     1963       "NAME TYPE MAJOR MINOR FIRST LAST [s]"
     1964#define makedevs_full_usage \
     1965       "Create a range of block or character special files\n\n" \
     1966       "TYPEs include:\n" \
     1967       "    b:  Make a block (buffered) device\n" \
     1968       "    c or u: Make a character (un-buffered) device\n" \
     1969       "    p:  Make a named pipe. MAJOR and MINOR are ignored for named pipes\n" \
     1970       "\n" \
     1971       "FIRST specifies the number appended to NAME to create the first device.\n" \
     1972       "LAST specifies the number of the last item that should be created\n" \
     1973       "If 's' is the last argument, the base device is created as well.\n\n" \
     1974       "For example:\n" \
     1975       "    makedevs /dev/ttyS c 4 66 2 63   ->  ttyS2-ttyS63\n" \
     1976       "    makedevs /dev/hda b 3 0 0 8 s    ->  hda,hda1-hda8"
     1977#define makedevs_example_usage \
     1978       "# makedevs /dev/ttyS c 4 66 2 63\n" \
     1979       "[creates ttyS2-ttyS63]\n" \
     1980       "# makedevs /dev/hda b 3 0 0 8 s\n" \
     1981       "[creates hda,hda1-hda8]\n"
    13601982#endif
    1361 #define insmod_trivial_usage \
    1362     "[OPTION]... MODULE [symbol=value]..."
    1363 #define insmod_full_usage \
    1364     "Loads the specified kernel modules into the kernel.\n\n" \
    1365     "Options:\n" \
    1366     "\t-f\tForce module to load into the wrong kernel version\n" \
    1367     "\t-k\tMake module autoclean-able\n" \
    1368     "\t-v\tverbose output\n"  \
    1369     "\t-q\tquiet output\n" \
    1370     "\t-L\tLock to prevent simultaneous loads of a module\n" \
    1371     USAGE_INSMOD_MAP("\t-m\tOutput load map to stdout\n") \
    1372     "\t-o NAME\tSet internal module name to NAME\n" \
    1373     "\t-x\tdo not export externs"
    1374 
    1375 #define install_trivial_usage \
    1376     "[-cgmops] [sources] <dest|directory>"
    1377 #define install_full_usage \
    1378     "Copies files and set attributes\n\n" \
    1379     "Options:\n" \
    1380     "\t-c\tcopy the file, default\n" \
    1381     "\t-d\tcreate directories\n" \
    1382     "\t-g\tset group ownership\n" \
    1383     "\t-m\tset permission modes\n" \
    1384     "\t-o\tset ownership\n" \
    1385     "\t-p\tpreserve date\n" \
    1386     "\t-s\tstrip symbol tables"
    1387 
    1388 #define ip_trivial_usage \
    1389     "[ OPTIONS ] { address | link | route | tunnel } { COMMAND | help }"
    1390 #define ip_full_usage \
    1391     "ip [ OPTIONS ] OBJECT { COMMAND | help }\n" \
    1392     "where  OBJECT := { link | addr | route | tunnel }\n" \
    1393     "OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }"
    1394 
    1395 #define ipaddr_trivial_usage \
    1396     "{ {add|del} IFADDR dev STRING | {show|flush}\n" \
    1397     "\t\t[ dev STRING ] [ to PREFIX ] }"
    1398 #define ipaddr_full_usage \
    1399     "ipaddr {add|delete} IFADDR dev STRING\n" \
    1400     "ipaddr {show|flush} [ dev STRING ] [ scope SCOPE-ID ]\n" \
    1401     "\t\t\t[ to PREFIX ] [ label PATTERN ]\n" \
    1402     "\t\t\tIFADDR := PREFIX | ADDR peer PREFIX\n" \
    1403     "\t\t\t[ broadcast ADDR ] [ anycast ADDR ]\n" \
    1404     "\t\t\t[ label STRING ] [ scope SCOPE-ID ]\n" \
    1405     "\t\t\tSCOPE-ID := [ host | link | global | NUMBER ]"
    1406 
    1407 #ifdef CONFIG_FEATURE_IPCALC_FANCY
    1408 #  define XUSAGE_IPCALC_FANCY(a) a
    1409 #else
    1410 #  define XUSAGE_IPCALC_FANCY(a)
     1983
     1984#if ENABLE_FEATURE_MAKEDEVS_TABLE
     1985#define makedevs_trivial_usage \
     1986       "[-d device_table] rootdir"
     1987#define makedevs_full_usage \
     1988       "Create a range of special files as specified in a device table.\n" \
     1989       "Device table entries take the form of:\n" \
     1990       "<type> <mode> <uid> <gid> <major> <minor> <start> <inc> <count>\n" \
     1991       "Where name is the file name, type can be one of:\n" \
     1992       "    f   A regular file\n" \
     1993       "    d   Directory\n" \
     1994       "    c   Character special device file\n" \
     1995       "    b   Block special device file\n" \
     1996       "    p   Fifo (named pipe)\n" \
     1997       "uid is the user id for the target file, gid is the group id for the\n" \
     1998       "target file. The rest of the entries (major, minor, etc) apply to\n" \
     1999       "to device special files. A '-' may be used for blank entries."
     2000#define makedevs_example_usage \
     2001       "For example:\n" \
     2002       "<name>    <type> <mode><uid><gid><major><minor><start><inc><count>\n" \
     2003       "/dev         d   755    0    0    -      -      -      -    -\n" \
     2004       "/dev/console c   666    0    0    5      1      -      -    -\n" \
     2005       "/dev/null    c   666    0    0    1      3      0      0    -\n" \
     2006       "/dev/zero    c   666    0    0    1      5      0      0    -\n" \
     2007       "/dev/hda     b   640    0    0    3      0      0      0    -\n" \
     2008       "/dev/hda     b   640    0    0    3      1      1      1    15\n\n" \
     2009       "Will Produce:\n" \
     2010       "/dev\n" \
     2011       "/dev/console\n" \
     2012       "/dev/null\n" \
     2013       "/dev/zero\n" \
     2014       "/dev/hda\n" \
     2015       "/dev/hda[0-15]\n"
    14112016#endif
    1412 #define ipcalc_trivial_usage \
    1413     "[OPTION]... <ADDRESS>[[/]<NETMASK>] [NETMASK]"
    1414 #define ipcalc_full_usage \
    1415     "Calculate IP network settings from a IP address\n\n" \
    1416     "Options:\n" \
    1417     "\t-b\t--broadcast\tDisplay calculated broadcast address\n" \
    1418     "\t-n\t--network\tDisplay calculated network address\n" \
    1419     "\t-m\t--netmask\tDisplay default netmask for IP" \
    1420     XUSAGE_IPCALC_FANCY( \
    1421     "\n\t-p\t--prefix\tDisplay the prefix for IP/NETMASK\n" \
    1422     "\t-h\t--hostname\tDisplay first resolved host name\n" \
    1423     "\t-s\t--silent\tDon't ever display error messages")
    1424 
    1425 #define ipcrm_trivial_usage \
    1426     "[-[MQS] key] [-[mqs] id]"
    1427 #define ipcrm_full_usage \
    1428     "The upper-case options MQS are used to remove a shared memory\n" \
    1429     "segment by an shmkey value. The lower-case options mqs are used\n" \
    1430     "to remove a segment by shmid value.\n" \
    1431     "\t-m | -M\tRemove the memory segment after the last detach\n" \
    1432     "\t-q | -Q\tRemove the message queue\n" \
    1433     "\t-s | -S\tRemove the semaphore"
    1434 
    1435 #define ipcs_trivial_usage \
    1436     "[[-smq] -i shmid] | [[-asmq] [-tclup]]"
    1437 #define ipcs_full_usage \
    1438     "\t-i\tspecify a specific resource id\n" \
    1439     "Resource specification:\n" \
    1440     "\t-m\tshared memory segments\n" \
    1441     "\t-q\tmessage queues\n" \
    1442     "\t-s\tsemaphore arrays\n" \
    1443     "\t-a\tall (default)\n" \
    1444     "Output format:\n" \
    1445     "\t-t\ttime\n" \
    1446     "\t-p\tpid\n" \
    1447     "\t-s\tcreator\n" \
    1448     "\t-a\tlimits\n" \
    1449     "\t-i\tsummary"
    1450 
    1451 #define iplink_trivial_usage \
    1452     "{ set DEVICE { up | down | arp { on | off } | show [ DEVICE ] }"
    1453 #define iplink_full_usage \
    1454     "iplink set DEVICE { up | down | arp { on | off } |\n" \
    1455     "\t\t\tdynamic { on | off } |\n" \
    1456     "\t\t\tmtu MTU }\n" \
    1457     "\tiplink show [ DEVICE ]"
    1458 
    1459 #define iproute_trivial_usage \
    1460     "{ list | flush | { add | del | change | append |\n" \
    1461     "\t\treplace | monitor } ROUTE }"
    1462 #define iproute_full_usage \
    1463     "iproute { list | flush } SELECTOR\n" \
    1464     "iproute get ADDRESS [ from ADDRESS iif STRING ]\n" \
    1465     "\t\t\t[ oif STRING ]  [ tos TOS ]\n" \
    1466     "\tiproute { add | del | change | append | replace | monitor } ROUTE\n" \
    1467     "\t\t\tSELECTOR := [ root PREFIX ] [ match PREFIX ] [ proto RTPROTO ]\n" \
    1468     "\t\t\tROUTE := [ TYPE ] PREFIX [ tos TOS ] [ proto RTPROTO ]"
    1469 
    1470 #define iptunnel_trivial_usage \
    1471     "{ add | change | del | show } [ NAME ]\n" \
    1472     "\t\t[ mode { ipip | gre | sit } ]\n" \
    1473     "\t\t[ remote ADDR ] [ local ADDR ] [ ttl TTL ]"
    1474 #define iptunnel_full_usage \
    1475     "iptunnel { add | change | del | show } [ NAME ]\n" \
    1476     "\t\t\t[ mode { ipip | gre | sit } ] [ remote ADDR ] [ local ADDR ]\n" \
    1477     "\t\t\t[ [i|o]seq ] [ [i|o]key KEY ] [ [i|o]csum ]\n" \
    1478     "\t\t\t[ ttl TTL ] [ tos TOS ] [ [no]pmtudisc ] [ dev PHYS_DEV ]"
    1479 
    1480 #define kill_trivial_usage \
    1481     "[-signal] process-id [process-id ...]"
    1482 #define kill_full_usage \
    1483     "Send a signal (default is SIGTERM) to the specified process(es).\n\n" \
    1484     "Options:\n" \
    1485     "\t-l\tList all signal names and numbers"
    1486 #define kill_example_usage \
    1487     "$ ps | grep apache\n" \
    1488     "252 root     root     S [apache]\n" \
    1489     "263 www-data www-data S [apache]\n" \
    1490     "264 www-data www-data S [apache]\n" \
    1491     "265 www-data www-data S [apache]\n" \
    1492     "266 www-data www-data S [apache]\n" \
    1493     "267 www-data www-data S [apache]\n" \
    1494     "$ kill 252\n"
    1495 
    1496 #define killall_trivial_usage \
    1497     "[-q] [-signal] process-name [process-name ...]"
    1498 #define killall_full_usage \
    1499     "Send a signal (default is SIGTERM) to the specified process(es).\n\n" \
    1500     "Options:\n" \
    1501     "\t-l\tList all signal names and numbers\n" \
    1502     "\t-q\tDo not complain if no processes were killed"
    1503 #define killall_example_usage \
    1504     "$ killall apache\n"
    1505 
    1506 #define klogd_trivial_usage \
    1507     "[-c n] [-n]"
    1508 #define klogd_full_usage \
    1509     "Kernel logger.\n" \
    1510     "Options:\n" \
    1511     "\t-c n\tSets the default log level of console messages to n\n" \
    1512     "\t-n\tRun as a foreground process"
    1513 
    1514 #define length_trivial_usage \
    1515     "STRING"
    1516 #define length_full_usage \
    1517     "Prints out the length of the specified STRING."
    1518 #define length_example_usage \
    1519     "$ length Hello\n" \
    1520     "5\n"
    1521 
    1522 #define less_trivial_usage \
    1523     "[-EMNmh~?] FILE1 FILE2..."
    1524 #define less_full_usage \
    1525     "View a file or list of files. The position within files can be\n" \
    1526     "changed, and files can be manipulated in various ways with the\n" \
    1527     "following options:\n\n" \
    1528     "\t-E\tQuit once the end of a file is reached\n" \
    1529     "\t-M\tDisplay a status line containing the current line numbers\n" \
    1530     "\t\tand the percentage through the file\n" \
    1531     "\t-N\tPrefix line numbers to each line\n" \
    1532     "\t-m\tDisplay a status line containing the percentage through the\n" \
    1533     "\t\tfile\n" \
    1534     "\t-~\tSuppress ~s displayed when input past the end of the file is\n" \
    1535     "\t\treached.\n" \
    1536     "\t-h, -?\tDisplay this help message"
    1537 
    1538 #define setarch_trivial_usage \
    1539     "<personality> <program> [args ...]"
    1540 #define setarch_full_usage \
    1541     "Personality may be:\n" \
    1542     "\tlinux32\tSet 32bit uname emulation\n" \
    1543     "\tlinux64\tSet 64bit uname emulation"
    1544 
    1545 #define ln_trivial_usage \
    1546     "[OPTION] TARGET... LINK_NAME|DIRECTORY"
    1547 #define ln_full_usage \
    1548     "Create a link named LINK_NAME or DIRECTORY to the specified TARGET\n" \
    1549     "\nYou may use '--' to indicate that all following arguments are non-options.\n\n" \
    1550     "Options:\n" \
    1551     "\t-s\tmake symbolic links instead of hard links\n" \
    1552     "\t-f\tremove existing destination files\n" \
    1553     "\t-n\tno dereference symlinks - treat like normal file\n" \
    1554     "\t-b\tmake a backup of the target (if exists) before link operation\n" \
    1555     "\t-S suffix\tuse suffix instead of ~ when making backup files"
    1556 #define ln_example_usage \
    1557     "$ ln -s BusyBox /tmp/ls\n" \
    1558     "$ ls -l /tmp/ls\n" \
    1559     "lrwxrwxrwx    1 root     root            7 Apr 12 18:39 ls -> BusyBox*\n"
    1560 
    1561 #define loadfont_trivial_usage \
    1562     "< font"
    1563 #define loadfont_full_usage \
    1564     "Loads a console font from standard input."
    1565 #define loadfont_example_usage \
    1566     "$ loadfont < /etc/i18n/fontname\n"
    1567 
    1568 #define loadkmap_trivial_usage \
    1569     "< keymap"
    1570 #define loadkmap_full_usage \
    1571     "Loads a binary keyboard translation table from standard input."
    1572 #define loadkmap_example_usage \
    1573     "$ loadkmap < /etc/i18n/lang-keymap\n"
    1574 
    1575 #define logger_trivial_usage \
    1576     "[OPTION]... [MESSAGE]"
    1577 #define logger_full_usage \
    1578     "Write MESSAGE to the system log.  If MESSAGE is omitted, log stdin.\n\n" \
    1579     "Options:\n" \
    1580     "\t-s\tLog to stderr as well as the system log\n" \
    1581     "\t-t TAG\tLog using the specified tag (defaults to user name)\n" \
    1582     "\t-p PRIORITY\tEnter the message with the specified priority\n" \
    1583     "\t\tThis may be numerical or a ``facility.level'' pair"
    1584 #define logger_example_usage \
    1585     "$ logger \"hello\"\n"
    1586 
    1587 #define login_trivial_usage \
    1588     "[OPTION]... [username] [ENV=VAR ...]"
    1589 #define login_full_usage \
    1590     "Begin a new session on the system\n\n" \
    1591     "Options:\n" \
    1592     "\t-f\tDo not authenticate (user already authenticated)\n" \
    1593     "\t-h\tName of the remote host for this login\n" \
    1594     "\t-p\tPreserve environment"
    1595 
    1596 #define logname_trivial_usage \
    1597     ""
    1598 #define logname_full_usage \
    1599     "Print the name of the current user."
    1600 #define logname_example_usage \
    1601     "$ logname\n" \
    1602     "root\n"
    1603 
    1604 #define logread_trivial_usage \
    1605     "[OPTION]..."
    1606 #define logread_full_usage \
    1607     "Shows the messages from syslogd (using circular buffer).\n\n" \
    1608     "Options:\n" \
    1609     "\t-f\t\toutput data as the log grows"
    1610 
    1611 #define losetup_trivial_usage \
    1612     "[-od] LOOPDEVICE [FILE]"
    1613 #define losetup_full_usage \
    1614     "Associate LOOPDEVICE with FILE, or display current association.\n\n" \
    1615     "Options:\n" \
    1616     "\t-d\t\tDisassociate LOOPDEVICE\n" \
    1617     "\t-o OFFSET\tStart OFFSET bytes into FILE"
    1618 #define losetup_notes_usage \
    1619     "One argument (losetup /dev/loop1) will display the current association\n" \
    1620     "(if any), or disassociate it (with -d).  The display shows the offset\n" \
    1621     "and filename of the file the loop device is currently bound to.\n\n" \
    1622     "Two arguments (losetup /dev/loop1 file.img) create a new association,\n" \
    1623     "with an optional offset (-o 12345).  Encryption is not yet supported.\n\n"
    1624 
    1625 #ifdef CONFIG_FEATURE_LS_TIMESTAMPS
    1626 #  define USAGE_LS_TIMESTAMPS(a) a
    1627 #else
    1628 #  define USAGE_LS_TIMESTAMPS(a)
    1629 #endif
    1630 #ifdef CONFIG_FEATURE_LS_FILETYPES
    1631 #  define USAGE_LS_FILETYPES(a) a
    1632 #else
    1633 #  define USAGE_LS_FILETYPES(a)
    1634 #endif
    1635 #ifdef CONFIG_FEATURE_LS_FOLLOWLINKS
    1636 #  define USAGE_LS_FOLLOWLINKS(a) a
    1637 #else
    1638 #  define USAGE_LS_FOLLOWLINKS(a)
    1639 #endif
    1640 #ifdef CONFIG_FEATURE_LS_RECURSIVE
    1641 #  define USAGE_LS_RECURSIVE(a) a
    1642 #else
    1643 #  define USAGE_LS_RECURSIVE(a)
    1644 #endif
    1645 #ifdef CONFIG_FEATURE_LS_SORTFILES
    1646 #  define USAGE_LS_SORTFILES(a) a
    1647 #else
    1648 #  define USAGE_LS_SORTFILES(a)
    1649 #endif
    1650 #ifdef CONFIG_FEATURE_AUTOWIDTH
    1651 #  define USAGE_AUTOWIDTH(a) a
    1652 #else
    1653 #  define USAGE_AUTOWIDTH(a)
    1654 #endif
    1655 #ifdef CONFIG_FEATURE_LS_COLOR
    1656   #define USAGE_LS_COLOR(a) a
    1657 #else
    1658   #define USAGE_LS_COLOR(a)
    1659 #endif
    1660 
    1661 #define ls_trivial_usage \
    1662     "[-1Aa" USAGE_LS_TIMESTAMPS("c") "Cd" USAGE_LS_TIMESTAMPS("e") USAGE_LS_FILETYPES("F") "iln" USAGE_LS_FILETYPES("p") USAGE_LS_FOLLOWLINKS("L") USAGE_LS_RECURSIVE("R") USAGE_LS_SORTFILES("rS") "s" USAGE_AUTOWIDTH("T") USAGE_LS_TIMESTAMPS("tu") USAGE_LS_SORTFILES("v") USAGE_AUTOWIDTH("w") "x" USAGE_LS_SORTFILES("X") USE_FEATURE_HUMAN_READABLE("h") "k" USAGE_SELINUX("K") "] [filenames...]"
    1663 #define ls_full_usage \
    1664     "List directory contents\n\n" \
    1665     "Options:\n" \
    1666     "\t-1\tlist files in a single column\n" \
    1667     "\t-A\tdo not list implied . and ..\n" \
    1668     "\t-a\tdo not hide entries starting with .\n" \
    1669     "\t-C\tlist entries by columns\n" \
    1670     USAGE_LS_TIMESTAMPS("\t-c\twith -l: show ctime\n") \
    1671     USAGE_LS_COLOR("\t--color[={always,never,auto}]\tto control coloring\n") \
    1672     "\t-d\tlist directory entries instead of contents\n" \
    1673     USAGE_LS_TIMESTAMPS("\t-e\tlist both full date and full time\n") \
    1674     USAGE_LS_FILETYPES("\t-F\tappend indicator (one of */=@|) to entries\n") \
    1675     "\t-i\tlist the i-node for each file\n" \
    1676     "\t-l\tuse a long listing format\n" \
    1677     "\t-n\tlist numeric UIDs and GIDs instead of names\n" \
    1678     USAGE_LS_FILETYPES("\t-p\tappend indicator (one of /=@|) to entries\n") \
    1679     USAGE_LS_FOLLOWLINKS("\t-L\tlist entries pointed to by symbolic links\n") \
    1680     USAGE_LS_RECURSIVE("\t-R\tlist subdirectories recursively\n") \
    1681     USAGE_LS_SORTFILES("\t-r\tsort the listing in reverse order\n") \
    1682     USAGE_LS_SORTFILES("\t-S\tsort the listing by file size\n") \
    1683     "\t-s\tlist the size of each file, in blocks\n" \
    1684     USAGE_AUTOWIDTH("\t-T NUM\tassume Tabstop every NUM columns\n") \
    1685     USAGE_LS_TIMESTAMPS("\t-t\twith -l: show modification time\n") \
    1686     USAGE_LS_TIMESTAMPS("\t-u\twith -l: show access time\n") \
    1687     USAGE_LS_SORTFILES("\t-v\tsort the listing by version\n") \
    1688     USAGE_AUTOWIDTH("\t-w NUM\tassume the terminal is NUM columns wide\n") \
    1689     "\t-x\tlist entries by lines instead of by columns\n" \
    1690     USAGE_LS_SORTFILES("\t-X\tsort the listing by extension\n") \
    1691     USE_FEATURE_HUMAN_READABLE( \
    1692     "\t-h\tprint sizes in human readable format (e.g., 1K 243M 2G )\n") \
    1693     USAGE_SELINUX("\t-k\tprint security context\n") \
    1694     USAGE_SELINUX("\t-K\tprint security context in long format\n")
    1695 
    1696 #define lsattr_trivial_usage \
    1697     "[-Radlv] [files...]"
    1698 #define lsattr_full_usage \
    1699     "list file attributes on an ext2 fs\n\n" \
    1700     "Options:\n" \
    1701     "\t-R\trecursively list subdirectories\n" \
    1702     "\t-a\tdo not hide entries starting with .\n" \
    1703     "\t-d\tlist directory entries instead of contents\n" \
    1704     "\t-l\tprint long flag names\n" \
    1705     "\t-v\tlist the file's version/generation number"
    1706 
    1707 #define lsmod_trivial_usage \
    1708     ""
    1709 #define lsmod_full_usage \
    1710     "List the currently loaded kernel modules."
    1711 
    1712 #ifdef CONFIG_FEATURE_MAKEDEVS_LEAF
    1713 #define makedevs_trivial_usage \
    1714     "NAME TYPE MAJOR MINOR FIRST LAST [s]"
    1715 #define makedevs_full_usage \
    1716     "Creates a range of block or character special files\n\n" \
    1717     "TYPEs include:\n" \
    1718     "\tb:\tMake a block (buffered) device.\n" \
    1719     "\tc or u:\tMake a character (un-buffered) device.\n" \
    1720     "\tp:\tMake a named pipe. MAJOR and MINOR are ignored for named pipes.\n\n" \
    1721     "FIRST specifies the number appended to NAME to create the first device.\n" \
    1722     "LAST specifies the number of the last item that should be created\n" \
    1723     "If 's' is the last argument, the base device is created as well.\n\n" \
    1724     "For example:\n" \
    1725     "\tmakedevs /dev/ttyS c 4 66 2 63   ->  ttyS2-ttyS63\n" \
    1726     "\tmakedevs /dev/hda b 3 0 0 8 s    ->  hda,hda1-hda8"
    1727 #define makedevs_example_usage \
    1728     "# makedevs /dev/ttyS c 4 66 2 63\n" \
    1729     "[creates ttyS2-ttyS63]\n" \
    1730     "# makedevs /dev/hda b 3 0 0 8 s\n" \
    1731     "[creates hda,hda1-hda8]\n"
    1732 #endif
    1733 
    1734 #ifdef CONFIG_FEATURE_MAKEDEVS_TABLE
    1735 #define makedevs_trivial_usage \
    1736     "[-d device_table] rootdir"
    1737 #define makedevs_full_usage \
    1738     "Creates a range of special files as specified in a device table.\n" \
    1739     "Device table entries take the form of:\n" \
    1740     "<type> <mode> <uid> <gid> <major> <minor> <start> <inc> <count>\n" \
    1741     "Where name is the file name,  type can be one of:\n" \
    1742     "      f       A regular file\n" \
    1743     "      d       Directory\n" \
    1744     "      c       Character special device file\n" \
    1745     "      b       Block special device file\n" \
    1746     "      p       Fifo (named pipe)\n" \
    1747     "uid is the user id for the target file, gid is the group id for the\n" \
    1748     "target file.  The rest of the entries (major, minor, etc) apply to\n" \
    1749     "to device special files.  A '-' may be used for blank entries."
    1750 #define makedevs_example_usage \
    1751     "For example:\n" \
    1752     "<name>    <type> <mode><uid><gid><major><minor><start><inc><count>\n" \
    1753     "/dev         d   755    0    0    -      -      -      -    -\n" \
    1754     "/dev/console c   666    0    0    5      1      -      -    -\n" \
    1755     "/dev/null    c   666    0    0    1      3      0      0    -\n" \
    1756     "/dev/zero    c   666    0    0    1      5      0      0    -\n" \
    1757     "/dev/hda     b   640    0    0    3      0      0      0    -\n" \
    1758     "/dev/hda     b   640    0    0    3      1      1      1    15\n\n" \
    1759     "Will Produce:\n" \
    1760     "/dev\n" \
    1761     "/dev/console\n" \
    1762     "/dev/null\n" \
    1763     "/dev/zero\n" \
    1764     "/dev/hda\n" \
    1765     "/dev/hda[0-15]\n"
    1766 #endif
    1767 
    1768 #ifdef CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
    1769 #define USAGE_MD5_SHA1_SUM_CHECK(a) a
    1770 #else
    1771 #define USAGE_MD5_SHA1_SUM_CHECK(a)
    1772 #endif
     2017
     2018#define matchpathcon_trivial_usage \
     2019       "[-n] [-N] [-f file_contexts_file] [-p prefix] [-V]"
     2020#define matchpathcon_full_usage \
     2021       "    -n  Do not display path" \
     2022       "\n  -N  Do not use translations" \
     2023       "\n  -f  Use alternate file_context file" \
     2024       "\n  -p  Use prefix to speed translations" \
     2025       "\n  -V  Verify file context on disk matches defaults"
    17732026
    17742027#define md5sum_trivial_usage \
    1775     "[OPTION] [FILEs...]" \
    1776     USAGE_MD5_SHA1_SUM_CHECK("\n   or: md5sum [OPTION] -c [FILE]")
     2028       "[OPTION] [FILEs...]" \
     2029    USE_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: md5sum [OPTION] -c [FILE]")
    17772030#define md5sum_full_usage \
    1778     "Print" USAGE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums.\n\n" \
    1779     "Options:\n" \
    1780     "With no FILE, or when FILE is -, read standard input." \
    1781     USAGE_MD5_SHA1_SUM_CHECK("\n\n" \
    1782     "\t-c\tcheck MD5 sums against given list\n" \
    1783     "\nThe following two options are useful only when verifying checksums:\n" \
    1784     "\t-s\tdon't output anything, status code shows success\n" \
    1785     "\t-w\twarn about improperly formated MD5 checksum lines")
     2031       "Print" USE_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums" \
     2032       "\n\nOptions:\n" \
     2033       "With no FILE, or when FILE is -, read standard input." \
     2034    USE_FEATURE_MD5_SHA1_SUM_CHECK("\n\n" \
     2035       "    -c  Check MD5 sums against given list\n" \
     2036       "\nThe following two options are useful only when verifying checksums:\n" \
     2037       "    -s  Don't output anything, status code shows success\n" \
     2038       "    -w  Warn about improperly formatted MD5 checksum lines")
    17862039#define md5sum_example_usage \
    1787     "$ md5sum < busybox\n" \
    1788     "6fd11e98b98a58f64ff3398d7b324003\n" \
    1789     "$ md5sum busybox\n" \
    1790     "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
    1791     "$ md5sum -c -\n" \
    1792     "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
    1793     "busybox: OK\n" \
    1794     "^D\n"
     2040       "$ md5sum < busybox\n" \
     2041       "6fd11e98b98a58f64ff3398d7b324003\n" \
     2042       "$ md5sum busybox\n" \
     2043       "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
     2044       "$ md5sum -c -\n" \
     2045       "6fd11e98b98a58f64ff3398d7b324003  busybox\n" \
     2046       "busybox: OK\n" \
     2047       "^D\n"
    17952048
    17962049#define mdev_trivial_usage \
    1797     "[-s]"
     2050       "[-s]"
    17982051#define mdev_full_usage \
    1799     "\t-s\tScan /sys and populate /dev during system boot\n\n" \
    1800     "Called with no options (via hotplug) it uses environment variables\n" \
    1801     "to determine which device to add/remove."
     2052       "    -s  Scan /sys and populate /dev during system boot\n\n" \
     2053       "Called with no options (via hotplug) it uses environment variables\n" \
     2054       "to determine which device to add/remove."
    18022055#define mdev_notes_usage "" \
    1803 USE_FEATURE_MDEV_CONFIG( \
    1804     "The mdev config file contains lines that look like:\n" \
    1805     "  hd[a-z][0-9]* 0:3 660\n\n" \
    1806     "That's device name (with regex match), uid:gid, and permissions.\n\n" \
     2056    USE_FEATURE_MDEV_CONFIG( \
     2057       "The mdev config file contains lines that look like:\n" \
     2058       "  hd[a-z][0-9]* 0:3 660\n\n" \
     2059       "That's device name (with regex match), uid:gid, and permissions.\n\n" \
    18072060    USE_FEATURE_MDEV_EXEC( \
    1808         "Optionally, that can be followed (on the same line) by a special character\n" \
    1809         "and a command line to run after creating/before deleting the corresponding\n" \
    1810         "device(s). The environment variable $MDEV indicates the active device node\n" \
    1811         "(which is useful if it's a regex match). For example:\n\n" \
    1812         "  hdc root:cdrom 660  *ln -s $MDEV cdrom\n\n" \
    1813         "The special characters are @ (run after creating), $ (run before deleting),\n" \
    1814         "and * (run both after creating and before deleting). The commands run in\n" \
    1815         "the /dev directory, and use system() which calls /bin/sh.\n\n" \
     2061       "Optionally, that can be followed (on the same line) by a special character\n" \
     2062       "and a command line to run after creating/before deleting the corresponding\n" \
     2063       "device(s). The environment variable $MDEV indicates the active device node\n" \
     2064       "(which is useful if it's a regex match). For example:\n\n" \
     2065       "  hdc root:cdrom 660  *ln -s $MDEV cdrom\n\n" \
     2066       "The special characters are @ (run after creating), $ (run before deleting),\n" \
     2067       "and * (run both after creating and before deleting). The commands run in\n" \
     2068       "the /dev directory, and use system() which calls /bin/sh.\n\n" \
    18162069    ) \
    1817     "Config file parsing stops on the first matching line. If no config\n"\
    1818     "entry is matched, devices are created with default 0:0 660. (Make\n"\
    1819     "the last line match .* to override this.)\n\n" \
    1820 )
     2070       "Config file parsing stops on the first matching line. If no config\n"\
     2071       "entry is matched, devices are created with default 0:0 660. (Make\n"\
     2072       "the last line match .* to override this.)\n\n" \
     2073    )
    18212074
    18222075#define mesg_trivial_usage \
    1823     "[y|n]"
     2076       "[y|n]"
    18242077#define mesg_full_usage \
    1825     "mesg controls write access to your terminal\n" \
    1826     "\ty\tAllow write access to your terminal\n" \
    1827     "\tn\tDisallow write access to your terminal"
     2078       "Control write access to your terminal\n" \
     2079       "    y   Allow write access to your terminal\n" \
     2080       "    n   Disallow write access to your terminal"
    18282081
    18292082#define mkdir_trivial_usage \
    1830     "[OPTION] DIRECTORY..."
     2083       "[OPTION] DIRECTORY..."
    18312084#define mkdir_full_usage \
    1832     "Create the DIRECTORY(ies) if they do not already exist\n\n" \
    1833     "Options:\n" \
    1834     "\t-m\tset permission mode (as in chmod), not rwxrwxrwx - umask\n" \
    1835     "\t-p\tno error if existing, make parent directories as needed"
     2085       "Create the DIRECTORY(ies) if they do not already exist" \
     2086       "\n\nOptions:\n" \
     2087       "    -m  Set permission mode (as in chmod), not rwxrwxrwx - umask\n" \
     2088       "    -p  No error if existing, make parent directories as needed" \
     2089    USE_SELINUX( \
     2090       "\n  -Z  Set security context" \
     2091    )
     2092
    18362093#define mkdir_example_usage \
    1837     "$ mkdir /tmp/foo\n" \
    1838     "$ mkdir /tmp/foo\n" \
    1839     "/tmp/foo: File exists\n" \
    1840     "$ mkdir /tmp/foo/bar/baz\n" \
    1841     "/tmp/foo/bar/baz: No such file or directory\n" \
    1842     "$ mkdir -p /tmp/foo/bar/baz\n"
     2094       "$ mkdir /tmp/foo\n" \
     2095       "$ mkdir /tmp/foo\n" \
     2096       "/tmp/foo: File exists\n" \
     2097       "$ mkdir /tmp/foo/bar/baz\n" \
     2098       "/tmp/foo/bar/baz: No such file or directory\n" \
     2099       "$ mkdir -p /tmp/foo/bar/baz\n"
    18432100
    18442101#define mke2fs_trivial_usage \
    1845     "[-c|-l filename] [-b block-size] [-f fragment-size] [-g blocks-per-group] " \
    1846     "[-i bytes-per-inode] [-j] [-J journal-options] [-N number-of-inodes] [-n] " \
    1847     "[-m reserved-blocks-percentage] [-o creator-os] [-O feature[,...]] [-q] " \
    1848     "[r fs-revision-level] [-E extended-options] [-v] [-F] [-L volume-label] " \
    1849     "[-M last-mounted-directory] [-S] [-T filesystem-type] " \
    1850     "device [blocks-count]"
     2102       "[-c|-l filename] [-b block-size] [-f fragment-size] [-g blocks-per-group] " \
     2103       "[-i bytes-per-inode] [-j] [-J journal-options] [-N number-of-inodes] [-n] " \
     2104       "[-m reserved-blocks-percentage] [-o creator-os] [-O feature[,...]] [-q] " \
     2105       "[r fs-revision-level] [-E extended-options] [-v] [-F] [-L volume-label] " \
     2106       "[-M last-mounted-directory] [-S] [-T filesystem-type] " \
     2107       "device [blocks-count]"
    18512108#define mke2fs_full_usage \
    1852     "\t-b size\tblock size in bytes\n" \
    1853     "\t-c\tcheck for bad blocks before creating\n" \
    1854     "\t-E opts\tset extended options\n" \
    1855     "\t-f size\tfragment size in bytes\n" \
    1856     "\t-F\tforce (ignore sanity checks)\n" \
    1857     "\t-g num\tnumber of blocks in a block group\n" \
    1858     "\t-i ratio\tthe bytes/inode ratio\n" \
    1859     "\t-j\tcreate a journal (ext3)\n" \
    1860     "\t-J opts\tset journal options (size/device)\n" \
    1861     "\t-l file\tread bad blocks list from file\n" \
    1862     "\t-L lbl\tset the volume label\n" \
    1863     "\t-m percent\tpercent of fs blocks to reserve for admin\n" \
    1864     "\t-M dir\tset last mounted directory\n" \
    1865     "\t-n\tdo not actually create anything\n" \
    1866     "\t-N num\tnumber of inodes to create\n" \
    1867     "\t-o os\tset the 'creator os' field\n" \
    1868     "\t-O features\tdir_index/filetype/has_journal/journal_dev/sparse_super\n" \
    1869     "\t-q\tquiet execution\n" \
    1870     "\t-r rev\tset filesystem revision\n" \
    1871     "\t-S\twrite superblock and group descriptors only\n" \
    1872     "\t-T fs-type\tset usage type (news/largefile/largefile4)\n" \
    1873     "\t-v\tverbose execution"
     2109       "    -b size     Block size in bytes\n" \
     2110       "    -c      Check for bad blocks before creating\n" \
     2111       "    -E opts     Set extended options\n" \
     2112       "    -f size     Fragment size in bytes\n" \
     2113       "    -F      Force (ignore sanity checks)\n" \
     2114       "    -g num      Number of blocks in a block group\n" \
     2115       "    -i ratio    The bytes/inode ratio\n" \
     2116       "    -j      Create a journal (ext3)\n" \
     2117       "    -J opts     Set journal options (size/device)\n" \
     2118       "    -l file     Read bad blocks list from file\n" \
     2119       "    -L lbl      Set the volume label\n" \
     2120       "    -m percent  Percent of fs blocks to reserve for admin\n" \
     2121       "    -M dir      Set last mounted directory\n" \
     2122       "    -n      Do not actually create anything\n" \
     2123       "    -N num      Number of inodes to create\n" \
     2124       "    -o os       Set the 'creator os' field\n" \
     2125       "    -O features Dir_index/filetype/has_journal/journal_dev/sparse_super\n" \
     2126       "    -q      Quiet\n" \
     2127       "    -r rev      Set filesystem revision\n" \
     2128       "    -S      Write superblock and group descriptors only\n" \
     2129       "    -T fs-type  Set usage type (news/largefile/largefile4)\n" \
     2130       "    -v      Verbose"
    18742131
    18752132#define mkfifo_trivial_usage \
    1876     "[OPTIONS] name"
     2133       "[OPTIONS] name"
    18772134#define mkfifo_full_usage \
    1878     "Creates a named pipe (identical to 'mknod name p')\n\n" \
    1879     "Options:\n" \
    1880     "\t-m\tcreate the pipe using the specified mode (default a=rw)"
     2135       "Create a named pipe (identical to 'mknod name p')" \
     2136       "\n\nOptions:\n" \
     2137       "    -m  Create the pipe using the specified mode (default a=rw)" \
     2138    USE_SELINUX( \
     2139       "\n  -Z  Set security context" \
     2140    )
    18812141
    18822142#define mkfs_minix_trivial_usage \
    1883     "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]"
     2143       "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]"
    18842144#define mkfs_minix_full_usage \
    1885     "Make a MINIX filesystem.\n\n" \
    1886     "Options:\n" \
    1887     "\t-c\t\tCheck the device for bad blocks\n" \
    1888     "\t-n [14|30]\tSpecify the maximum length of filenames\n" \
    1889     "\t-i INODES\tSpecify the number of inodes for the filesystem\n" \
    1890     "\t-l FILENAME\tRead the bad blocks list from FILENAME\n" \
    1891     "\t-v\t\tMake a Minix version 2 filesystem"
     2145       "Make a MINIX filesystem" \
     2146       "\n\nOptions:\n" \
     2147       "    -c      Check the device for bad blocks\n" \
     2148       "    -n [14|30]  Specify the maximum length of filenames\n" \
     2149       "    -i INODES   Specify the number of inodes for the filesystem\n" \
     2150       "    -l FILENAME Read the bad blocks list from FILENAME\n" \
     2151       "    -v      Make a Minix version 2 filesystem"
    18922152
    18932153#define mknod_trivial_usage \
    1894     "[OPTIONS] NAME TYPE MAJOR MINOR"
     2154       "[OPTIONS] NAME TYPE MAJOR MINOR"
    18952155#define mknod_full_usage \
    1896     "Create a special file (block, character, or pipe).\n\n" \
    1897     "Options:\n" \
    1898     "\t-m\tcreate the special file using the specified mode (default a=rw)\n\n" \
    1899     "TYPEs include:\n" \
    1900     "\tb:\tMake a block (buffered) device\n" \
    1901     "\tc or u:\tMake a character (un-buffered) device\n" \
    1902     "\tp:\tMake a named pipe. MAJOR and MINOR are ignored for named pipes"
     2156       "Create a special file (block, character, or pipe)" \
     2157       "\n\nOptions:\n" \
     2158       "    -m  Create the special file using the specified mode (default a=rw)" \
     2159       "\n\nTYPEs include:\n" \
     2160       "    b:  Make a block (buffered) device\n" \
     2161       "    c or u: Make a character (un-buffered) device\n" \
     2162       "    p:  Make a named pipe. MAJOR and MINOR are ignored for named pipes" \
     2163    USE_SELINUX( \
     2164       "\n  -Z  Set security context" \
     2165    )
     2166
    19032167#define mknod_example_usage \
    1904     "$ mknod /dev/fd0 b 2 0\n" \
    1905     "$ mknod -m 644 /tmp/pipe p\n"
     2168       "$ mknod /dev/fd0 b 2 0\n" \
     2169       "$ mknod -m 644 /tmp/pipe p\n"
    19062170
    19072171#define mkswap_trivial_usage \
    1908     "[-c] [-v0|-v1] device [block-count]"
     2172       "[-c] [-v0|-v1] device [block-count]"
    19092173#define mkswap_full_usage \
    1910     "Prepare a disk partition to be used as a swap partition.\n\n" \
    1911     "Options:\n" \
    1912     "\t-c\t\tCheck for read-ability\n" \
    1913     "\t-v0\t\tMake version 0 swap [max 128 Megs]\n" \
    1914     "\t-v1\t\tMake version 1 swap [big!] (default for kernels >\n\t\t\t2.1.117)\n" \
    1915     "\tblock-count\tNumber of block to use (default is entire partition)"
     2174       "Prepare a disk partition to be used as swap partition" \
     2175       "\n\nOptions:\n" \
     2176       "    -c      Check for read-ability\n" \
     2177       "    -v0     Make version 0 swap [max 128 Megs]\n" \
     2178       "    -v1     Make version 1 swap [big!] (default for kernels > 2.1.117)\n" \
     2179       "    block-count Number of block to use (default is entire partition)"
    19162180
    19172181#define mktemp_trivial_usage \
    1918     "[-dq] TEMPLATE"
     2182       "[-dq] TEMPLATE"
    19192183#define mktemp_full_usage \
    1920     "Creates a temporary file with its name based on TEMPLATE.\n" \
    1921     "TEMPLATE is any name with six `Xs' (i.e., /tmp/temp.XXXXXX).\n\n" \
    1922     "Options:\n" \
    1923     "\t-d\t\tMake a directory instead of a file\n" \
    1924     "\t-q\t\tFail silently if an error occurs"
     2184       "Create a temporary file with its name based on TEMPLATE.\n" \
     2185       "TEMPLATE is any name with six 'Xs' (i.e., /tmp/temp.XXXXXX)." \
     2186       "\n\nOptions:\n" \
     2187       "    -d  Make a directory instead of a file\n" \
     2188       "    -q  Fail silently if an error occurs"
    19252189#define mktemp_example_usage \
    1926     "$ mktemp /tmp/temp.XXXXXX\n" \
    1927     "/tmp/temp.mWiLjM\n" \
    1928     "$ ls -la /tmp/temp.mWiLjM\n" \
    1929     "-rw-------    1 andersen andersen        0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
     2190       "$ mktemp /tmp/temp.XXXXXX\n" \
     2191       "/tmp/temp.mWiLjM\n" \
     2192       "$ ls -la /tmp/temp.mWiLjM\n" \
     2193       "-rw-------    1 andersen andersen        0 Apr 25 17:10 /tmp/temp.mWiLjM\n"
    19302194
    19312195#define modprobe_trivial_usage \
    1932     "[-knqrsv] MODULE [symbol=value ...]"
     2196       "[-knqrsv] MODULE [symbol=value ...]"
    19332197#define modprobe_full_usage \
    1934     "Options:\n" \
    1935     "\t-k\tMake module autoclean-able\n" \
    1936     "\t-n\tJust show what would be done\n" \
    1937     "\t-q\tQuiet output\n" \
    1938     "\t-r\tRemove module (stacks) or do autoclean\n" \
    1939     "\t-s\tReport via syslog instead of stderr\n" \
    1940     "\t-v\tVerbose output"
     2198       "Options:\n" \
     2199       "    -k  Make module autoclean-able\n" \
     2200       "    -n  Just show what would be done\n" \
     2201       "    -q  Quiet\n" \
     2202       "    -r  Remove module (stacks) or do autoclean\n" \
     2203       "    -s  Report via syslog instead of stderr\n" \
     2204       "    -v  Verbose"
    19412205#define modprobe_notes_usage \
    19422206"modprobe can (un)load a stack of modules, passing each module options (when\n" \
     
    19822246"file, and override them for a specific usage from the command line.\n"
    19832247#define modprobe_example_usage \
    1984     "(with the above /etc/modules.conf):\n\n" \
    1985     "$ modprobe tulip\n" \
    1986     "   will load the module 'tulip' with default option 'irq=3'\n\n" \
    1987     "$ modprobe tulip irq=5\n" \
    1988     "   will load the module 'tulip' with option 'irq=5', thus overriding the default\n\n" \
    1989     "$ modprobe tulip2\n" \
    1990     "   will load the module 'tulip' with default options 'irq=4 io=0x308',\n" \
    1991     "   which are the default for alias 'tulip2'\n\n" \
    1992     "$ modprobe tulip2 irq=8\n" \
    1993     "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=8',\n" \
    1994     "   which are the default for alias 'tulip2' overridden by the option 'irq=8'\n\n" \
    1995     "   from the command line\n\n" \
    1996     "$ modprobe tulip2 irq=2 io=0x210\n" \
    1997     "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=4 io=0x210',\n" \
    1998     "   which are the default for alias 'tulip2' overridden by the options 'irq=2 io=0x210'\n\n" \
    1999     "   from the command line\n"
     2248       "(with the above /etc/modules.conf):\n\n" \
     2249       "$ modprobe tulip\n" \
     2250       "   will load the module 'tulip' with default option 'irq=3'\n\n" \
     2251       "$ modprobe tulip irq=5\n" \
     2252       "   will load the module 'tulip' with option 'irq=5', thus overriding the default\n\n" \
     2253       "$ modprobe tulip2\n" \
     2254       "   will load the module 'tulip' with default options 'irq=4 io=0x308',\n" \
     2255       "   which are the default for alias 'tulip2'\n\n" \
     2256       "$ modprobe tulip2 irq=8\n" \
     2257       "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=8',\n" \
     2258       "   which are the default for alias 'tulip2' overridden by the option 'irq=8'\n\n" \
     2259       "   from the command line\n\n" \
     2260       "$ modprobe tulip2 irq=2 io=0x210\n" \
     2261       "   will load the module 'tulip' with default options 'irq=4 io=0x308 irq=4 io=0x210',\n" \
     2262       "   which are the default for alias 'tulip2' overridden by the options 'irq=2 io=0x210'\n\n" \
     2263       "   from the command line\n"
    20002264
    20012265#define more_trivial_usage \
    2002     "[FILE ...]"
     2266       "[FILE ...]"
    20032267#define more_full_usage \
    2004     "More is a filter for viewing FILE one screenful at a time."
     2268       "View FILE or standard input one screenful at a time"
    20052269#define more_example_usage \
    2006     "$ dmesg | more\n"
    2007 
    2008 #ifdef CONFIG_FEATURE_MOUNT_LOOP
    2009 #  define USAGE_MOUNT_LOOP(a) a
     2270       "$ dmesg | more\n"
     2271
     2272#define mount_trivial_usage \
     2273       "[flags] DEVICE NODE [-o options,more-options]"
     2274#define mount_full_usage \
     2275       "Mount a filesystem. Filesystem autodetection requires /proc be mounted." \
     2276       "\n\nOptions:\n" \
     2277       "    -a      Mount all filesystems in fstab\n" \
     2278    USE_FEATURE_MTAB_SUPPORT( \
     2279       "    -f      \"Fake\" Add entry to mount table but don't mount it\n" \
     2280       "    -n      Don't write a mount table entry\n" \
     2281    ) \
     2282       "    -o option   One of many filesystem options, listed below\n" \
     2283       "    -r      Mount the filesystem read-only\n" \
     2284       "    -t fs-type  Specify the filesystem type\n" \
     2285       "    -w      Mount for reading and writing (default)\n" \
     2286       "\n" \
     2287       "Options for use with the \"-o\" flag:\n" \
     2288    USE_FEATURE_MOUNT_LOOP( \
     2289       "    loop        Ignored (loop devices are autodetected)\n" \
     2290    ) \
     2291    USE_FEATURE_MOUNT_FLAGS( \
     2292       "    [a]sync     Writes are asynchronous / synchronous\n" \
     2293       "    [no]atime   Disable / enable updates to inode access times\n" \
     2294       "    [no]diratime    Disable / enable atime updates to directories\n" \
     2295       "    [no]dev     Allow use of special device files / disallow them\n" \
     2296       "    [no]exec    Allow use of executable files / disallow them\n" \
     2297       "    [no]suid    Allow set-user-id-root programs / disallow them\n" \
     2298       "    [r]shared   Convert [recursively] to a shared subtree\n" \
     2299       "    [r]slave    Convert [recursively] to a slave subtree\n" \
     2300       "    [r]private  Convert [recursively] to a private subtree\n" \
     2301       "    [un]bindable    Make mount point [un]able to be bind mounted\n" \
     2302       "    bind        Bind a directory to an additional location\n" \
     2303       "    move        Relocate an existing mount point\n" \
     2304    ) \
     2305       "    remount     Remount a mounted filesystem, changing its flags\n" \
     2306       "    ro/rw       Mount for read-only / read-write\n" \
     2307       "\n" \
     2308       "There are EVEN MORE flags that are specific to each filesystem\n" \
     2309       "You'll have to see the written documentation for those filesystems"
     2310#define mount_example_usage \
     2311       "$ mount\n" \
     2312       "/dev/hda3 on / type minix (rw)\n" \
     2313       "proc on /proc type proc (rw)\n" \
     2314       "devpts on /dev/pts type devpts (rw)\n" \
     2315       "$ mount /dev/fd0 /mnt -t msdos -o ro\n" \
     2316       "$ mount /tmp/diskimage /opt -t ext2 -o loop\n" \
     2317       "$ mount cd_image.iso mydir\n"
     2318#define mount_notes_usage \
     2319       "Returns 0 for success, number of failed mounts for -a, or errno for one mount."
     2320
     2321#define mountpoint_trivial_usage \
     2322       "[-q] <[-d] DIR | -x DEVICE>"
     2323#define mountpoint_full_usage \
     2324       "mountpoint checks if the directory is a mountpoint" \
     2325       "\n\nOptions:\n" \
     2326       "    -q  Quiet\n" \
     2327       "    -d  Print major/minor device number of the filesystem\n" \
     2328       "    -x  Print major/minor device number of the blockdevice"
     2329#define mountpoint_example_usage \
     2330       "$ mountpoint /proc\n" \
     2331       "/proc is not a mountpoint\n" \
     2332       "$ mountpoint /sys\n" \
     2333       "/sys is a mountpoint\n"
     2334
     2335#define mt_trivial_usage \
     2336       "[-f device] opcode value"
     2337#define mt_full_usage \
     2338       "Control magnetic tape drive operation\n" \
     2339       "\nAvailable Opcodes:\n\n" \
     2340       "bsf bsfm bsr bss datacompression drvbuffer eof eom erase\n" \
     2341       "fsf fsfm fsr fss load lock mkpart nop offline ras1 ras2\n" \
     2342       "ras3 reset retension rewind rewoffline seek setblk setdensity\n" \
     2343       "setpart tell unload unlock weof wset"
     2344
     2345#define mv_trivial_usage \
     2346       "[OPTION]... SOURCE DEST\n" \
     2347       "or: mv [OPTION]... SOURCE... DIRECTORY"
     2348#define mv_full_usage \
     2349       "Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY" \
     2350       "\n\nOptions:\n" \
     2351       "    -f  Don't prompt before overwriting\n" \
     2352       "    -i  Interactive, prompt before overwrite"
     2353#define mv_example_usage \
     2354       "$ mv /tmp/foo /bin/bar\n"
     2355
     2356#define nameif_trivial_usage \
     2357       "[-s] [-c FILE] [{IFNAME MACADDR}]"
     2358#define nameif_full_usage \
     2359       "Rename network interface while it in the down state" \
     2360       "\n\nOptions:\n" \
     2361       "    -c FILE     Use configuration file (default is /etc/mactab)\n" \
     2362       "    -s      Use syslog (LOCAL0 facility)\n" \
     2363       "    IFNAME MACADDR  new_interface_name interface_mac_address"
     2364#define nameif_example_usage \
     2365       "$ nameif -s dmz0 00:A0:C9:8C:F6:3F\n" \
     2366       " or\n" \
     2367       "$ nameif -c /etc/my_mactab_file\n" \
     2368
     2369#if !ENABLE_DESKTOP
     2370
     2371#if ENABLE_NC_SERVER || ENABLE_NC_EXTRA
     2372#define NC_OPTIONS_STR "\n\nOptions:"
    20102373#else
    2011 #  define USAGE_MOUNT_LOOP(a)
     2374#define NC_OPTIONS_STR
    20122375#endif
    2013 #ifdef CONFIG_FEATURE_MTAB_SUPPORT
    2014 #  define USAGE_MTAB(a) a
    2015 #else
    2016 #  define USAGE_MTAB(a)
     2376
     2377#define nc_trivial_usage \
     2378    USE_NC_EXTRA("[-iN] [-wN] ")USE_NC_SERVER("[-l] [-p PORT] ") \
     2379       "["USE_NC_EXTRA("-f FILENAME|")"IPADDR PORTNUM]"USE_NC_EXTRA(" [-e COMMAND]")
     2380#define nc_full_usage \
     2381       "Open a pipe to IP:port" USE_NC_EXTRA(" or file") \
     2382    NC_OPTIONS_STR \
     2383    USE_NC_EXTRA( \
     2384       "\n  -e  Exec rest of command line after connect" \
     2385       "\n  -i SECS Delay interval for lines sent" \
     2386       "\n  -w SECS Timeout for connect" \
     2387       "\n  -f FILE Use file (ala /dev/ttyS0) instead of network" \
     2388    ) \
     2389    USE_NC_SERVER( \
     2390       "\n  -l  Listen mode, for inbound connects" \
     2391    USE_NC_EXTRA( \
     2392       "\n      (use -l twice with -e for persistent server)") \
     2393       "\n  -p PORT Local port number" \
     2394    )
     2395
     2396#define nc_notes_usage "" \
     2397    USE_NC_EXTRA( \
     2398       "To use netcat as a terminal emulator on a serial port:\n\n" \
     2399       "$ stty 115200 -F /dev/ttyS0\n" \
     2400       "$ stty raw -echo -ctlecho && nc -f /dev/ttyS0\n" \
     2401    )
     2402
     2403#define nc_example_usage \
     2404       "$ nc foobar.somedomain.com 25\n" \
     2405       "220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600\n" \
     2406       "help\n" \
     2407       "214-Commands supported:\n" \
     2408       "214-    HELO EHLO MAIL RCPT DATA AUTH\n" \
     2409       "214     NOOP QUIT RSET HELP\n" \
     2410       "quit\n" \
     2411       "221 foobar closing connection\n"
     2412
     2413#else /* DESKTOP nc - much more compatible with nc 1.10 */
     2414
     2415#define nc_trivial_usage \
     2416       "[-options] hostname port  - connect" \
     2417    USE_NC_SERVER("\nnc [-options] -l -p port [hostname] [port]  - listen")
     2418#define nc_full_usage \
     2419    USE_NC_SERVER( \
     2420       "-l      Listen mode, for inbound connects\n" \
     2421    ) \
     2422       "-n      Do not do DNS resolution" \
     2423     "\n-s addr     Local address" \
     2424     "\n-p port     Local port" \
     2425     "\n-u      UDP mode" \
     2426     "\n-v      Verbose (cumulative: -vv)" \
     2427     "\n-w secs     Timeout for connects and final net reads" \
     2428    USE_NC_EXTRA( \
     2429     "\n-i sec      Delay interval for lines sent" /* ", ports scanned" */ \
     2430     "\n-o file     Hex dump of traffic" \
     2431     "\n-z      Zero-I/O mode (scanning)" \
     2432    ) \
     2433     "\n-e prog [args]  Program to exec after connect (must be last)" \
     2434/*   "\n-r      Randomize local and remote ports" */
     2435/*   "\n-g gateway  Source-routing hop point[s], up to 8" */
     2436/*   "\n-G num      Source-routing pointer: 4, 8, 12, ..." */
     2437/*   "\nport numbers can be individual or ranges: lo-hi [inclusive]" */
     2438
    20172439#endif
    2018 #define mount_trivial_usage \
    2019     "[flags] DEVICE NODE [-o options,more-options]"
    2020 #define mount_full_usage \
    2021     "Mount a filesystem.  Filesystem autodetection requires /proc be mounted.\n\n" \
    2022     "Flags:\n"  \
    2023     "\t-a:\t\tMount all filesystems in fstab\n" \
    2024     USAGE_MTAB( \
    2025     "\t-f:\t\t\"Fake\" Add entry to mount table but don't mount it\n" \
    2026     "\t-n:\t\tDon't write a mount table entry\n" \
    2027     ) \
    2028     "\t-o option:\tOne of many filesystem options, listed below\n" \
    2029     "\t-r:\t\tMount the filesystem read-only\n" \
    2030     "\t-t fs-type:\tSpecify the filesystem type\n" \
    2031     "\t-w:\t\tMount for reading and writing (default)\n" \
    2032     "\n" \
    2033     "Options for use with the \"-o\" flag:\n" \
    2034     "\tasync/sync:\tWrites are asynchronous / synchronous\n" \
    2035     "\tatime/noatime:\tEnable / disable updates to inode access times\n" \
    2036     "\tdev/nodev:\tAllow use of special device files / disallow them\n" \
    2037     "\texec/noexec:\tAllow use of executable files / disallow them\n" \
    2038     USAGE_MOUNT_LOOP( \
    2039     "\tloop:\t\t Ignored (loop devices are autodetected)\n" \
    2040     ) \
    2041     "\tsuid/nosuid:\tAllow set-user-id-root programs / disallow them\n" \
    2042     "\tremount:\tRe-mount a mounted filesystem, changing its flags\n" \
    2043     "\tro/rw:\t\tMount for read-only / read-write\n" \
    2044     "\tbind:\t\tBind a directory to an additional location\n" \
    2045     "\tmove:\t\tRelocate an existing mount point.\n" \
    2046     "\nThere are EVEN MORE flags that are specific to each filesystem\n" \
    2047     "You'll have to see the written documentation for those filesystems"
    2048 #define mount_example_usage \
    2049     "$ mount\n" \
    2050     "/dev/hda3 on / type minix (rw)\n" \
    2051     "proc on /proc type proc (rw)\n" \
    2052     "devpts on /dev/pts type devpts (rw)\n" \
    2053     "$ mount /dev/fd0 /mnt -t msdos -o ro\n" \
    2054     "$ mount /tmp/diskimage /opt -t ext2 -o loop\n" \
    2055     "$ mount cd_image.iso mydir\n"
    2056 #define mount_notes_usage \
    2057     "Returns 0 for success, number of failed mounts for -a, or errno for one mount."
    2058 
    2059 #define mountpoint_trivial_usage \
    2060     "[-q] <[-d] DIR | -x DEVICE>"
    2061 #define mountpoint_full_usage \
    2062     "mountpoint checks if the directory is a mountpoint\n\n" \
    2063     "Options:\n"  \
    2064     "\t-q:\t\tBe more quiet\n" \
    2065     "\t-d:\t\tPrint major/minor device number of the filesystem\n" \
    2066     "\t-x:\t\tPrint major/minor device number of the blockdevice"
    2067 #define mountpoint_example_usage \
    2068     "$ mountpoint /proc\n" \
    2069     "/proc is not a mountpoint\n" \
    2070     "$ mountpoint /sys\n" \
    2071     "/sys is a mountpoint\n"
    2072 
    2073 #define mt_trivial_usage \
    2074     "[-f device] opcode value"
    2075 #define mt_full_usage \
    2076     "Control magnetic tape drive operation\n" \
    2077     "\nAvailable Opcodes:\n\n" \
    2078     "bsf bsfm bsr bss datacompression drvbuffer eof eom erase\n" \
    2079     "fsf fsfm fsr fss load lock mkpart nop offline ras1 ras2\n" \
    2080     "ras3 reset retension rewind rewoffline seek setblk setdensity\n" \
    2081     "setpart tell unload unlock weof wset"
    2082 
    2083 #define mv_trivial_usage \
    2084     "[OPTION]... SOURCE DEST\n" \
    2085     "or: mv [OPTION]... SOURCE... DIRECTORY"
    2086 #define mv_full_usage \
    2087     "Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.\n\n" \
    2088     "Options:\n" \
    2089     "\t-f\tdon't prompt before overwriting\n" \
    2090     "\t-i\tinteractive, prompt before overwrite"
    2091 #define mv_example_usage \
    2092     "$ mv /tmp/foo /bin/bar\n"
    2093 
    2094 #define nameif_trivial_usage \
    2095     "[-s] [-c FILE] [{IFNAME MACADDR}]"
    2096 #define nameif_full_usage \
    2097     "Nameif renaming network interface while it in the down state.\n\n" \
    2098     "Options:\n" \
    2099     "\t-c FILE\t\tUse configuration file (default is /etc/mactab)\n" \
    2100     "\t-s\t\tUse syslog (LOCAL0 facility)\n" \
    2101     "\tIFNAME MACADDR\tnew_interface_name interface_mac_address"
    2102 #define nameif_example_usage \
    2103     "$ nameif -s dmz0 00:A0:C9:8C:F6:3F\n" \
    2104     " or\n" \
    2105     "$ nameif -c /etc/my_mactab_file\n" \
    2106 
    2107 #ifdef CONFIG_NC_GAPING_SECURITY_HOLE
    2108 #  define USAGE_NC_EXEC(a) a
    2109 #else
    2110 #  define USAGE_NC_EXEC(a)
    2111 #endif
    2112 #define nc_trivial_usage \
    2113     "[OPTIONS] [IP] [port]"
    2114 #define nc_full_usage \
    2115     "Netcat opens a pipe to IP:port\n\n" \
    2116     "Options:\n" \
    2117     "\t-l\t\tlisten mode, for inbound connects\n" \
    2118     "\t-p PORT\t\tlocal port number\n" \
    2119     "\t-i SECS\t\tdelay interval for lines sent\n" \
    2120     USAGE_NC_EXEC( \
    2121     "\t-e PROG\t\tprogram to exec after connect (dangerous!)\n" \
    2122     ) \
    2123     "\t-w SECS\t\ttimeout for connects and final net reads"
    2124 #define nc_example_usage \
    2125     "$ nc foobar.somedomain.com 25\n" \
    2126     "220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600\n" \
    2127     "help\n" \
    2128     "214-Commands supported:\n" \
    2129     "214-    HELO EHLO MAIL RCPT DATA AUTH\n" \
    2130     "214     NOOP QUIT RSET HELP\n" \
    2131     "quit\n" \
    2132     "221 foobar closing connection\n"
    21332440
    21342441#define netstat_trivial_usage \
    2135     "[-laenrtuwx]"
     2442       "[-laentuwxr"USE_FEATURE_NETSTAT_WIDE("W")"]"
    21362443#define netstat_full_usage \
    2137     "Netstat displays Linux networking information.\n\n" \
    2138     "Options:\n" \
    2139     "\t-l display listening server sockets\n" \
    2140     "\t-a display all sockets (default: connected)\n" \
    2141     "\t-e display other/more information\n" \
    2142     "\t-n don't resolve names\n" \
    2143     "\t-r display routing table\n" \
    2144     "\t-t tcp sockets\n" \
    2145     "\t-u udp sockets\n" \
    2146     "\t-w raw sockets\n" \
    2147     "\t-x unix sockets"
     2444       "Display networking information" \
     2445     "\n\nOptions:" \
     2446     "\n    -l  Display listening server sockets" \
     2447     "\n    -a  Display all sockets (default: connected)" \
     2448     "\n    -e  Display other/more information" \
     2449     "\n    -n  Don't resolve names" \
     2450     "\n    -t  Tcp sockets" \
     2451     "\n    -u  Udp sockets" \
     2452     "\n    -w  Raw sockets" \
     2453     "\n    -x  Unix sockets" \
     2454     "\n    -r  Display routing table" \
     2455    USE_FEATURE_NETSTAT_WIDE( \
     2456     "\n    -W  Display with no column truncation" \
     2457    )
    21482458
    21492459#define nice_trivial_usage \
    2150     "[-n ADJUST] [COMMAND [ARG] ...]"
     2460       "[-n ADJUST] [COMMAND [ARG] ...]"
    21512461#define nice_full_usage \
    2152     "Nice runs a program with modified scheduling priority.\n\n" \
    2153     "Options:\n" \
    2154     "\t-n ADJUST\tAdjust the scheduling priority by ADJUST"
     2462       "Run a program with modified scheduling priority" \
     2463       "\n\nOptions:\n" \
     2464       "    -n ADJUST   Adjust the scheduling priority by ADJUST"
     2465
     2466#define nmeter_trivial_usage \
     2467       "format_string"
     2468#define nmeter_full_usage \
     2469       "Monitor system in real time\n\n" \
     2470       "Format specifiers:\n" \
     2471       "%Nc or %[cN]    Monitor CPU. N - bar size, default 10\n" \
     2472       "        (displays: S:system U:user N:niced D:iowait I:irq i:softirq)\n" \
     2473       "%[niface]   Monitor network interface 'iface'\n" \
     2474       "%m      Monitor allocated memory\n" \
     2475       "%[mf]       Monitor free memory\n" \
     2476       "%[mt]       Monitor total memory\n" \
     2477       "%s      Monitor allocated swap\n" \
     2478       "%f      Monitor number of used file descriptors\n" \
     2479       "%Ni     Monitor total/specific IRQ rate\n" \
     2480       "%x      Monitor context switch rate\n" \
     2481       "%p      Monitor forks\n" \
     2482       "%[pn]       Monitor # of processes\n" \
     2483       "%b      Monitor block io\n" \
     2484       "%Nt     Show time (with N decimal points)\n" \
     2485       "%Nd     Milliseconds between updates (default=1000)\n" \
     2486       "%r      Print <cr> instead of <lf> at EOL"
     2487#define nmeter_example_usage \
     2488       "nmeter '%250d%t %20c int %i bio %b mem %m forks%p'"
    21552489
    21562490#define nohup_trivial_usage \
    2157     "COMMAND [ARGS]"
     2491       "COMMAND [ARGS]"
    21582492#define nohup_full_usage \
    2159     "run a command immune to hangups, with output to a non-tty"
     2493       "Run a command immune to hangups, with output to a non-tty"
    21602494#define nohup_example_usage \
    2161     "$ nohup make &"
     2495       "$ nohup make &"
    21622496
    21632497#define nslookup_trivial_usage \
    2164     "[HOST] [SERVER]"
     2498       "[HOST] [SERVER]"
    21652499#define nslookup_full_usage \
    2166     "Queries the nameserver for the IP address of the given HOST\n" \
    2167     "optionally using a specified DNS server"
     2500       "Query the nameserver for the IP address of the given HOST\n" \
     2501       "optionally using a specified DNS server"
    21682502#define nslookup_example_usage \
    2169     "$ nslookup localhost\n" \
    2170     "Server:     default\n" \
    2171     "Address:    default\n" \
    2172     "\n" \
    2173     "Name:       debian\n" \
    2174     "Address:    127.0.0.1\n"
     2503       "$ nslookup localhost\n" \
     2504       "Server:     default\n" \
     2505       "Address:    default\n" \
     2506       "\n" \
     2507       "Name:       debian\n" \
     2508       "Address:    127.0.0.1\n"
    21752509
    21762510#define od_trivial_usage \
    2177     "[-aBbcDdeFfHhIiLlOovXx] [FILE]"
     2511       "[-aBbcDdeFfHhIiLlOovXx] [FILE]"
    21782512#define od_full_usage \
    2179     "Write an unambiguous representation, octal bytes by default, of FILE\n" \
    2180     "to standard output. With no FILE, or when FILE is -, read standard input."
     2513       "Write an unambiguous representation, octal bytes by default, of FILE\n" \
     2514       "to standard output. With no FILE, or when FILE is -, read standard input."
    21812515
    21822516#define openvt_trivial_usage \
    2183     "<vtnum> <COMMAND> [ARGS...]"
     2517       "VTNUM COMMAND [ARGS...]"
    21842518#define openvt_full_usage \
    2185     "Start a command on a new virtual terminal"
     2519       "Start a command on a new virtual terminal"
    21862520#define openvt_example_usage \
    2187     "openvt 2 /bin/ash\n"
    2188 
    2189 #ifdef CONFIG_FEATURE_SHA1_PASSWORDS
    2190 #  define PASSWORD_ALG_TYPES(a) a
    2191 #else
    2192 #  define PASSWORD_ALG_TYPES(a)
    2193 #endif
     2521       "openvt 2 /bin/ash\n"
     2522
    21942523#define passwd_trivial_usage \
    2195     "[OPTION] [name]"
     2524       "[OPTION] [name]"
    21962525#define passwd_full_usage \
    2197     "Change a user password. If no name is specified,\n" \
    2198     "changes the password for the current user.\n" \
    2199     "Options:\n" \
    2200     "\t-a\tDefine which algorithm shall be used for the password\n" \
    2201     "\t\t\t(Choices: des, md5" \
    2202     PASSWORD_ALG_TYPES(", sha1") \
    2203     ")\n\t-d\tDelete the password for the specified user account\n" \
    2204     "\t-l\tLocks (disables) the specified user account\n" \
    2205     "\t-u\tUnlocks (re-enables) the specified user account"
     2526       "Change a user password. If no name is specified,\n" \
     2527       "changes the password for the current user." \
     2528       "\n\nOptions:\n" \
     2529       "    -a  Define which algorithm shall be used for the password\n" \
     2530       "        (choices: des, md5)\n" /* ", sha1)" */ \
     2531       "    -d  Delete the password for the specified user account\n" \
     2532       "    -l  Locks (disables) the specified user account\n" \
     2533       "    -u  Unlocks (re-enables) the specified user account"
     2534
     2535#define chpasswd_trivial_usage \
     2536       "[--md5|--encrypt]"
     2537#define chpasswd_full_usage \
     2538       "Read user:password information from stdin\n" \
     2539       "and update /etc/passwd accordingly." \
     2540       "\n\nOptions:" \
     2541       "\n  -e, --encrypt   Supplied passwords are in encrypted form" \
     2542       "\n  -m, --md5   Use MD5 encryption instead of DES"
    22062543
    22072544#define patch_trivial_usage \
    2208     "[-p<num>] [-i <diff>]"
     2545       "[-p num] [-i diff]"
    22092546#define patch_full_usage \
    2210     "\t-p <num>\tStrip <num> leading components from file names\n" \
    2211     "\t-i <diff>\tRead <diff> instead of stdin"
     2547       "    -p NUM  Strip NUM leading components from file names\n" \
     2548       "    -i DIFF Read DIFF instead of stdin"
    22122549#define patch_example_usage \
    2213     "$ patch -p1 < example.diff\n" \
    2214     "$ patch -p0 -i example.diff"
    2215 
    2216 #if ENABLE_FEATURE_PIDOF_SINGLE
    2217 #define USAGE_FEATURE_PIDOF_SINGLE(a) a
    2218 #else
    2219 #define USAGE_FEATURE_PIDOF_SINGLE(a)
    2220 #endif
    2221 #if ENABLE_FEATURE_PIDOF_OMIT
    2222 #define USAGE_FEATURE_PIDOF_OMIT(a) a
    2223 #else
    2224 #define USAGE_FEATURE_PIDOF_OMIT(a)
    2225 #endif
     2550       "$ patch -p1 < example.diff\n" \
     2551       "$ patch -p0 -i example.diff"
     2552
    22262553#if (ENABLE_FEATURE_PIDOF_SINGLE || ENABLE_FEATURE_PIDOF_OMIT)
    22272554#define USAGE_PIDOF "Options:"
    22282555#else
    2229 #define USAGE_PIDOF "\n\tThis version of pidof accepts no options."
     2556#define USAGE_PIDOF "\nThis version of pidof accepts no options."
    22302557#endif
    22312558
    22322559#define pidof_trivial_usage \
    2233     "process-name [OPTION] [process-name ...]"
     2560       "process-name [OPTION] [process-name ...]"
    22342561
    22352562#define pidof_full_usage \
    2236     "Lists the PIDs of all processes with names that match the\n" \
    2237     "names on the command line.\n" \
     2563       "List the PIDs of all processes with names that match the\n" \
     2564       "names on the command line\n" \
    22382565    USAGE_PIDOF \
    2239     USAGE_FEATURE_PIDOF_SINGLE("\n\t-s\t\tdisplay only a single PID") \
    2240     USAGE_FEATURE_PIDOF_OMIT("\n\t-o\t\tomit given pid.") \
    2241     USAGE_FEATURE_PIDOF_OMIT("\n\t\t\tUse %PPID to omit the parent pid of pidof itself")
     2566    USE_FEATURE_PIDOF_SINGLE( \
     2567       "\n  -s  Display only a single PID") \
     2568    USE_FEATURE_PIDOF_OMIT( \
     2569       "\n  -o PID  Omit given pid") \
     2570    USE_FEATURE_PIDOF_OMIT( \
     2571       "\n      Use %PPID to omit the parent pid of pidof itself")
    22422572#define pidof_example_usage \
    2243     "$ pidof init\n" \
    2244     "1\n" \
    2245     USAGE_FEATURE_PIDOF_OMIT("$ pidof /bin/sh\n20351 5973 5950\n") \
    2246     USAGE_FEATURE_PIDOF_OMIT("$ pidof /bin/sh -o %PPID\n20351 5950")
    2247 
    2248 #ifndef CONFIG_FEATURE_FANCY_PING
    2249 #define ping_trivial_usage "host"
    2250 #define ping_full_usage    "Send ICMP ECHO_REQUEST packets to network hosts"
     2573       "$ pidof init\n" \
     2574       "1\n" \
     2575    USE_FEATURE_PIDOF_OMIT( \
     2576       "$ pidof /bin/sh\n20351 5973 5950\n") \
     2577    USE_FEATURE_PIDOF_OMIT( \
     2578       "$ pidof /bin/sh -o %PPID\n20351 5950")
     2579
     2580#if !ENABLE_FEATURE_FANCY_PING
     2581#define ping_trivial_usage \
     2582       "host"
     2583#define ping_full_usage \
     2584       "Send ICMP ECHO_REQUEST packets to network hosts"
     2585#define ping6_trivial_usage \
     2586       "host"
     2587#define ping6_full_usage \
     2588       "Send ICMP ECHO_REQUEST packets to network hosts"
    22512589#else
    22522590#define ping_trivial_usage \
    2253     "[OPTION]... host"
     2591       "[OPTION]... host"
    22542592#define ping_full_usage \
    2255     "Send ICMP ECHO_REQUEST packets to network hosts.\n\n" \
    2256     "Options:\n" \
    2257     "\t-c COUNT\tSend only COUNT pings\n" \
    2258     "\t-s SIZE\t\tSend SIZE data bytes in packets (default=56)\n" \
    2259     "\t-q\t\tQuiet mode, only displays output at start\n" \
    2260     "\t\t\tand when finished"
     2593       "Send ICMP ECHO_REQUEST packets to network hosts" \
     2594       "\n\nOptions:\n" \
     2595       "    -4, -6      Force IPv4 or IPv6 hostname resolution\n" \
     2596       "    -c CNT      Send only CNT pings\n" \
     2597       "    -s SIZE     Send SIZE data bytes in packets (default=56)\n" \
     2598       "    -I iface/IP Use interface or IP address as source\n" \
     2599       "    -q      Quiet, only displays output at start\n" \
     2600       "            and when finished"
     2601#define ping6_trivial_usage \
     2602       "[OPTION]... host"
     2603#define ping6_full_usage \
     2604       "Send ICMP ECHO_REQUEST packets to network hosts" \
     2605       "\n\nOptions:\n" \
     2606       "    -c CNT      Send only CNT pings\n" \
     2607       "    -s SIZE     Send SIZE data bytes in packets (default=56)\n" \
     2608       "    -I iface/IP Use interface or IP address as source\n" \
     2609       "    -q      Quiet, only displays output at start\n" \
     2610       "            and when finished"
    22612611#endif
    22622612#define ping_example_usage \
    2263     "$ ping localhost\n" \
    2264     "PING slag (127.0.0.1): 56 data bytes\n" \
    2265     "64 bytes from 127.0.0.1: icmp_seq=0 ttl=255 time=20.1 ms\n" \
    2266     "\n" \
    2267     "--- debian ping statistics ---\n" \
    2268     "1 packets transmitted, 1 packets received, 0% packet loss\n" \
    2269     "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
    2270 
    2271 #ifndef CONFIG_FEATURE_FANCY_PING6
    2272 #define ping6_trivial_usage "host"
    2273 #define ping6_full_usage    "Send ICMP ECHO_REQUEST packets to network hosts"
    2274 #else
    2275 #define ping6_trivial_usage \
    2276     "[OPTION]... host"
    2277 #define ping6_full_usage \
    2278     "Send ICMP ECHO_REQUEST packets to network hosts.\n\n" \
    2279     "Options:\n" \
    2280     "\t-c COUNT\tSend only COUNT pings\n" \
    2281     "\t-s SIZE\t\tSend SIZE data bytes in packets (default=56)\n" \
    2282     "\t-q\t\tQuiet mode, only displays output at start\n" \
    2283     "\t\t\tand when finished"
    2284 #endif
     2613       "$ ping localhost\n" \
     2614       "PING slag (127.0.0.1): 56 data bytes\n" \
     2615       "64 bytes from 127.0.0.1: icmp_seq=0 ttl=255 time=20.1 ms\n" \
     2616       "\n" \
     2617       "--- debian ping statistics ---\n" \
     2618       "1 packets transmitted, 1 packets received, 0% packet loss\n" \
     2619       "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
    22852620#define ping6_example_usage \
    2286     "$ ping6 ip6-localhost\n" \
    2287     "PING ip6-localhost (::1): 56 data bytes\n" \
    2288     "64 bytes from ::1: icmp6_seq=0 ttl=64 time=20.1 ms\n" \
    2289     "\n" \
    2290     "--- ip6-localhost ping statistics ---\n" \
    2291     "1 packets transmitted, 1 packets received, 0% packet loss\n" \
    2292     "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
     2621       "$ ping6 ip6-localhost\n" \
     2622       "PING ip6-localhost (::1): 56 data bytes\n" \
     2623       "64 bytes from ::1: icmp6_seq=0 ttl=64 time=20.1 ms\n" \
     2624       "\n" \
     2625       "--- ip6-localhost ping statistics ---\n" \
     2626       "1 packets transmitted, 1 packets received, 0% packet loss\n" \
     2627       "round-trip min/avg/max = 20.1/20.1/20.1 ms\n"
    22932628
    22942629#define pivot_root_trivial_usage \
    2295     "NEW_ROOT PUT_OLD"
     2630       "NEW_ROOT PUT_OLD"
    22962631#define pivot_root_full_usage \
    2297     "Move the current root file system to PUT_OLD and make NEW_ROOT\n" \
    2298     "the new root file system."
     2632       "Move the current root file system to PUT_OLD and make NEW_ROOT\n" \
     2633       "the new root file system"
    22992634
    23002635#define poweroff_trivial_usage \
    2301     "[-d<delay>] [-n<nosync>] [-f<force>]"
     2636       "[-d delay] [-n] [-f]"
    23022637#define poweroff_full_usage \
    2303     "Halt and shut off power.\n" \
    2304     "Options:\n" \
    2305     "\t-d\t\tdelay interval for halting\n" \
    2306     "\t-n\t\tno call to sync()\n" \
    2307     "\t-f\t\tforce power off (don't go through init)"
     2638       "Halt and shut off power" \
     2639       "\n\nOptions:\n" \
     2640       "    -d  Delay interval for halting\n" \
     2641       "    -n  No call to sync()\n" \
     2642       "    -f  Force power off (don't go through init)"
    23082643
    23092644#define printenv_trivial_usage \
    2310     "[VARIABLES...]"
     2645       "[VARIABLES...]"
    23112646#define printenv_full_usage \
    2312     "print all or part of environment\n\n" \
    2313     "If no environment VARIABLE specified, print them all."
     2647       "Print all or part of environment.\n" \
     2648       "If no environment VARIABLE specified, print them all."
    23142649
    23152650#define printf_trivial_usage \
    2316     "FORMAT [ARGUMENT...]"
     2651       "FORMAT [ARGUMENT...]"
    23172652#define printf_full_usage \
    2318     "Formats and prints ARGUMENT(s) according to FORMAT,\n" \
    2319     "Where FORMAT controls the output exactly as in C printf."
     2653       "Format and print ARGUMENT(s) according to FORMAT,\n" \
     2654       "where FORMAT controls the output exactly as in C printf"
    23202655#define printf_example_usage \
    2321     "$ printf \"Val=%d\\n\" 5\n" \
    2322     "Val=5\n"
     2656       "$ printf \"Val=%d\\n\" 5\n" \
     2657       "Val=5\n"
     2658
     2659
     2660#if ENABLE_DESKTOP
     2661
     2662#define ps_trivial_usage \
     2663       ""
     2664#define ps_full_usage \
     2665       "Report process status" \
     2666       "\n\nOptions:" \
     2667       "\n  -o col1,col2=header Select columns for display" \
     2668
     2669#else /* !ENABLE_DESKTOP */
    23232670
    23242671#if !defined CONFIG_SELINUX && !ENABLE_FEATURE_PS_WIDE
    2325 #define USAGE_PS "\n\tThis version of ps accepts no options."
     2672#define USAGE_PS "\nThis version of ps accepts no options"
    23262673#else
    23272674#define USAGE_PS "\nOptions:"
    23282675#endif
    2329 #if ENABLE_FEATURE_PS_WIDE
    2330 #define USAGE_PS_WIDE(a) a
    2331 #else
    2332 #define USAGE_PS_WIDE(a)
    2333 #endif
    23342676
    23352677#define ps_trivial_usage \
    2336     ""
     2678       ""
    23372679#define ps_full_usage \
    2338     "Report process status\n" \
     2680       "Report process status\n" \
    23392681    USAGE_PS \
    2340     USAGE_SELINUX("\n\t-c\tshow SE Linux context") \
    2341     USAGE_PS_WIDE("\n\tw\twide output")
     2682    USE_SELINUX( \
     2683       "\n  -Z  Show SE Linux context") \
     2684    USE_FEATURE_PS_WIDE( \
     2685       "\n  w   Wide output")
     2686
     2687#endif /* ENABLE_DESKTOP */
    23422688
    23432689#define ps_example_usage \
    2344     "$ ps\n" \
    2345     "  PID  Uid      Gid State Command\n" \
    2346     "    1 root     root     S init\n" \
    2347     "    2 root     root     S [kflushd]\n" \
    2348     "    3 root     root     S [kupdate]\n" \
    2349     "    4 root     root     S [kpiod]\n" \
    2350     "    5 root     root     S [kswapd]\n" \
    2351     "  742 andersen andersen S [bash]\n" \
    2352     "  743 andersen andersen S -bash\n" \
    2353     "  745 root     root     S [getty]\n" \
    2354     " 2990 andersen andersen R ps\n"
     2690       "$ ps\n" \
     2691       "  PID  Uid      Gid State Command\n" \
     2692       "    1 root     root     S init\n" \
     2693       "    2 root     root     S [kflushd]\n" \
     2694       "    3 root     root     S [kupdate]\n" \
     2695       "    4 root     root     S [kpiod]\n" \
     2696       "    5 root     root     S [kswapd]\n" \
     2697       "  742 andersen andersen S [bash]\n" \
     2698       "  743 andersen andersen S -bash\n" \
     2699       "  745 root     root     S [getty]\n" \
     2700       " 2990 andersen andersen R ps\n"
     2701
     2702#define pscan_trivial_usage \
     2703       "[-p MIN_PORT] [-P MAX_PORT] [-t TIMEOUT] [-T MIN_RTT] HOST"
     2704#define pscan_full_usage \
     2705       "Scan a host, print all open ports" \
     2706       "\n\nOptions:" \
     2707     "\n    -p  Scan from this port (default 1)" \
     2708     "\n    -P  Scan up to this port (default 1024)" \
     2709     "\n    -t  Timeout (default 5000 ms)" \
     2710     "\n    -T  Minimum rtt (default 5 ms, increase for congested hosts)" \
    23552711
    23562712#define pwd_trivial_usage \
    2357     ""
     2713       ""
    23582714#define pwd_full_usage \
    2359     "Print the full filename of the current working directory."
     2715       "Print the full filename of the current working directory"
    23602716#define pwd_example_usage \
    2361     "$ pwd\n" \
    2362     "/root\n"
     2717       "$ pwd\n" \
     2718       "/root\n"
     2719
     2720#define raidautorun_trivial_usage \
     2721       "DEVICE"
     2722#define raidautorun_full_usage \
     2723       "Tell the kernel to automatically search and start RAID arrays"
     2724#define raidautorun_example_usage \
     2725       "$ raidautorun /dev/md0"
    23632726
    23642727#define rdate_trivial_usage \
    2365     "[-sp] HOST"
     2728       "[-sp] HOST"
    23662729#define rdate_full_usage \
    2367     "Get and possibly set the system date and time from a remote HOST.\n\n" \
    2368     "Options:\n" \
    2369     "\t-s\tSet the system date and time (default)\n" \
    2370     "\t-p\tPrint the date and time"
    2371 
    2372 #ifdef CONFIG_FEATURE_READLINK_FOLLOW
    2373 #define USAGE_READLINK_FOLLOW(a) a
    2374 #else
    2375 #define USAGE_READLINK_FOLLOW(a)
    2376 #endif
     2730       "Get and possibly set the system date and time from a remote HOST" \
     2731       "\n\nOptions:\n" \
     2732       "    -s  Set the system date and time (default)\n" \
     2733       "    -p  Print the date and time"
     2734
     2735#define readahead_trivial_usage \
     2736       "[FILE]..."
     2737#define readahead_full_usage \
     2738       "Preload FILE(s) in RAM cache so that subsequent reads for those" \
     2739       "files do not block on disk I/O"
    23772740
    23782741#define readlink_trivial_usage \
    2379     USAGE_READLINK_FOLLOW("[-f] ") "FILE"
     2742    USE_FEATURE_READLINK_FOLLOW("[-f] ") "FILE"
    23802743#define readlink_full_usage \
    2381     "Displays the value of a symbolic link." \
    2382     USAGE_READLINK_FOLLOW("\n\nOptions:\n" \
    2383     "\t-f\tcanonicalize by following all symlinks")
     2744       "Display the value of a symlink" \
     2745    USE_FEATURE_READLINK_FOLLOW( \
     2746       "\n\nOptions:\n" \
     2747       "    -f  Canonicalize by following all symlinks")
    23842748
    23852749#define readprofile_trivial_usage \
    2386     "[OPTIONS]..."
     2750       "[OPTIONS]..."
    23872751#define readprofile_full_usage \
    2388     "Options:\n" \
    2389     "\t -m <mapfile>  (default: /boot/System.map)\n" \
    2390     "\t -p <profile>  (default: /proc/profile)\n" \
    2391     "\t -M <mult>     set the profiling multiplier to <mult>\n" \
    2392     "\t -i            print only info about the sampling step\n" \
    2393     "\t -v            print verbose data\n" \
    2394     "\t -a            print all symbols, even if count is 0\n" \
    2395     "\t -b            print individual histogram-bin counts\n" \
    2396     "\t -s            print individual counters within functions\n" \
    2397     "\t -r            reset all the counters (root only)\n" \
    2398     "\t -n            disable byte order auto-detection"
     2752       "Options:\n" \
     2753       "    -m mapfile  (Default: /boot/System.map)\n" \
     2754       "    -p profile  (Default: /proc/profile)\n" \
     2755       "    -M mult     Set the profiling multiplier to mult\n" \
     2756       "    -i      Print only info about the sampling step\n" \
     2757       "    -v      Verbose\n" \
     2758       "    -a      Print all symbols, even if count is 0\n" \
     2759       "    -b      Print individual histogram-bin counts\n" \
     2760       "    -s      Print individual counters within functions\n" \
     2761       "    -r      Reset all the counters (root only)\n" \
     2762       "    -n      Disable byte order auto-detection"
    23992763
    24002764#define realpath_trivial_usage \
    2401     "pathname ..."
     2765       "pathname ..."
    24022766#define realpath_full_usage \
    2403     "Returns the absolute pathnames of given argument."
     2767       "Return the absolute pathnames of given argument"
    24042768
    24052769#define reboot_trivial_usage \
    2406     "[-d<delay>] [-n<nosync>] [-f<force>]"
     2770       "[-d delay] [-n] [-f]"
    24072771#define reboot_full_usage \
    2408     "Reboot the system.\n" \
    2409     "Options:\n" \
    2410     "\t-d\t\tdelay interval for rebooting\n" \
    2411     "\t-n\t\tno call to sync()\n" \
    2412     "\t-f\t\tforce reboot (don't go through init)"
     2772       "Reboot the system" \
     2773       "\n\nOptions:\n" \
     2774       "    -d  Delay interval for rebooting\n" \
     2775       "    -n  No call to sync()\n" \
     2776       "    -f  Force reboot (don't go through init)"
    24132777
    24142778#define renice_trivial_usage \
    2415     "{{-n INCREMENT} | PRIORITY} [[ -p | -g | -u ] ID ...]"
     2779       "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID ...]"
    24162780#define renice_full_usage \
    2417     "Changes priority of running processes.\n\n" \
    2418     "Options:\n" \
    2419     "\t-n\tadjusts current nice value (smaller is faster)\n" \
    2420     "\t-p\tprocess id(s) (default)\n" \
    2421     "\t-g\tprocess group id(s)\n" \
    2422     "\t-u\tprocess user name(s) and/or id(s)"
     2781       "Change priority of running processes" \
     2782       "\n\nOptions:\n" \
     2783       "    -n  Adjusts current nice value (smaller is faster)\n" \
     2784       "    -p  Process id(s) (default)\n" \
     2785       "    -g  Process group id(s)\n" \
     2786       "    -u  Process user name(s) and/or id(s)"
    24232787
    24242788#define reset_trivial_usage \
    2425     ""
     2789       ""
    24262790#define reset_full_usage \
    2427     "Resets the screen."
     2791       "Reset the screen"
     2792
     2793#define resize_trivial_usage \
     2794       ""
     2795#define resize_full_usage \
     2796       "Resize the screen"
     2797
     2798#define restorecon_trivial_usage \
     2799       "[-iFnrRv] [-e excludedir]... [-o filename] [-f filename | pathname]"
     2800#define restorecon_full_usage \
     2801       "Reset security contexts of files in pathname\n" \
     2802       "\n  -i      Ignore files that do not exist" \
     2803       "\n  -f filename File with list of files to process. Use - for stdin" \
     2804       "\n  -e directory    Directory to exclude" \
     2805       "\n  -R,-r       Recurse directories" \
     2806       "\n  -n      Don't change any file labels" \
     2807       "\n  -o filename Save list of files with incorrect context" \
     2808       "\n  -v      Verbose" \
     2809       "\n  -vv     Show changed labels" \
     2810       "\n  -F      Force reset of context to match file_context" \
     2811       "\n          for customizable files, or the user section," \
     2812       "\n          if it has changed"
    24282813
    24292814#define rm_trivial_usage \
    2430     "[OPTION]... FILE..."
     2815       "[OPTION]... FILE..."
    24312816#define rm_full_usage \
    2432     "Remove (unlink) the FILE(s). You may use '--' to\n" \
    2433     "indicate that all following arguments are non-options.\n\n" \
    2434     "Options:\n" \
    2435     "\t-i\t\talways prompt before removing each destination\n" \
    2436     "\t-f\t\tremove existing destinations, never prompt\n" \
    2437     "\t-r or -R\tremove the contents of directories recursively"
     2817       "Remove (unlink) the FILE(s). You may use '--' to\n" \
     2818       "indicate that all following arguments are non-options." \
     2819       "\n\nOptions:\n" \
     2820       "    -i  Always prompt before removing each destination\n" \
     2821       "    -f  Remove existing destinations, never prompt\n" \
     2822       "    -r,-R   Remove the contents of directories recursively"
    24382823#define rm_example_usage \
    2439     "$ rm -rf /tmp/foo\n"
     2824       "$ rm -rf /tmp/foo\n"
    24402825
    24412826#define rmdir_trivial_usage \
    2442     "[OPTION]... DIRECTORY..."
     2827       "[OPTION]... DIRECTORY..."
    24432828#define rmdir_full_usage \
    2444     "Remove the DIRECTORY(ies), if they are empty."
     2829       "Remove the DIRECTORY, if it is empty"
    24452830#define rmdir_example_usage \
    2446     "# rmdir /tmp/foo\n"
     2831       "# rmdir /tmp/foo\n"
    24472832
    24482833#define rmmod_trivial_usage \
    2449     "[OPTION]... [MODULE]..."
     2834       "[OPTION]... [MODULE]..."
    24502835#define rmmod_full_usage \
    2451     "Unloads the specified kernel modules from the kernel.\n\n" \
    2452     "Options:\n" \
    2453     "\t-a\tRemove all unused modules (recursively)"
     2836       "Unload the specified kernel modules from the kernel" \
     2837       "\n\nOptions:\n" \
     2838       "    -a  Remove all unused modules (recursively)"
    24542839#define rmmod_example_usage \
    2455     "$ rmmod tulip\n"
    2456 
    2457 #ifdef CONFIG_FEATURE_IPV6
    2458 #  define USAGE_ROUTE_IPV6(a) a
    2459 #else
    2460 #  define USAGE_ROUTE_IPV6(a) "\t"
    2461 #endif
    2462 
     2840       "$ rmmod tulip\n"
    24632841
    24642842#define route_trivial_usage \
    2465     "[{add|del|delete}]"
     2843       "[{add|del|delete}]"
    24662844#define route_full_usage \
    2467     "Edit the kernel's routing tables.\n\n" \
    2468     "Options:\n" \
    2469     "\t-n\t\tDont resolve names\n" \
    2470     "\t-e\t\tDisplay other/more information\n" \
    2471     "\t-A inet" USAGE_ROUTE_IPV6("{6}") "\tSelect address family"
     2845       "Edit the kernel's routing tables" \
     2846       "\n\nOptions:\n" \
     2847       "    -n  Dont resolve names\n" \
     2848       "    -e  Display other/more information\n" \
     2849       "    -A inet" USE_FEATURE_IPV6("{6}") "  Select address family"
    24722850
    24732851#define rpm_trivial_usage \
    2474     "-i -q[ildc]p package.rpm"
     2852       "-i -q[ildc]p package.rpm"
    24752853#define rpm_full_usage \
    2476     "Manipulates RPM packages" \
    2477     "\n\nOptions:" \
    2478     "\n\t-i Install package" \
    2479     "\n\t-q Query package" \
    2480     "\n\t-p Query uninstalled package" \
    2481     "\n\t-i Show information" \
    2482     "\n\t-l List contents" \
    2483     "\n\t-d List documents" \
    2484     "\n\t-c List config files"
     2854       "Manipulate RPM packages" \
     2855       "\n\nOptions:" \
     2856       "\n  -i  Install package" \
     2857       "\n  -q  Query package" \
     2858       "\n  -p  Query uninstalled package" \
     2859       "\n  -i  Show information" \
     2860       "\n  -l  List contents" \
     2861       "\n  -d  List documents" \
     2862       "\n  -c  List config files"
    24852863
    24862864#define rpm2cpio_trivial_usage \
    2487     "package.rpm"
     2865       "package.rpm"
    24882866#define rpm2cpio_full_usage \
    2489     "Outputs a cpio archive of the rpm file."
     2867       "Output a cpio archive of the rpm file"
     2868
     2869#define runcon_trivial_usage \
     2870       "[-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
     2871       "    runcon CONTEXT COMMAND [args]"
     2872#define runcon_full_usage \
     2873       "runcon [-c] [-u USER] [-r ROLE] [-t TYPE] [-l RANGE] COMMAND [args]\n" \
     2874       "runcon CONTEXT COMMAND [args]\n" \
     2875       "Run a program in a different security context\n\n" \
     2876       "    CONTEXT     Complete security context\n" \
     2877       "    -c, --compute   Compute process transition context before modifying\n" \
     2878       "    -t, --type=TYPE Type (for same role as parent)\n" \
     2879       "    -u, --user=USER User identity\n" \
     2880       "    -r, --role=ROLE Role\n" \
     2881       "    -l, --range=RNG Levelrange" \
    24902882
    24912883#define run_parts_trivial_usage \
    2492     "[-t] [-a ARG] [-u MASK] DIRECTORY"
     2884       "[-t] "USE_FEATURE_RUN_PARTS_FANCY("[-l] ")"[-a ARG] [-u MASK] DIRECTORY"
    24932885#define run_parts_full_usage \
    2494     "Run a bunch of scripts in a directory.\n\n" \
    2495     "Options:\n" \
    2496     "\t-t\tPrints what would be run, but does not actually run anything\n" \
    2497     "\t-a ARG\tPass ARG as an argument for every program invoked\n" \
    2498     "\t-u MASK\tSet the umask to MASK before executing every program"
     2886       "Run a bunch of scripts in a directory" \
     2887       "\n\nOptions:\n" \
     2888       "    -t  Prints what would be run, but does not actually run anything\n" \
     2889       "    -a ARG  Pass ARG as an argument for every program invoked\n" \
     2890       "    -u MASK Set the umask to MASK before executing every program" \
     2891USE_FEATURE_RUN_PARTS_FANCY("\n -l  Prints names of all matching files even when they are not executable")
     2892
     2893#define run_parts_example_usage \
     2894       "$ run-parts -a start /etc/init.d\n" \
     2895       "$ run-parts -a stop=now /etc/init.d\n\n" \
     2896       "Let's assume you have a script foo/dosomething:\n" \
     2897       "#!/bin/sh\n" \
     2898       "for i in $*; do eval $i; done; unset i\n" \
     2899       "case \"$1\" in\n" \
     2900       "start*) echo starting something;;\n" \
     2901       "stop*) set -x; shutdown -h $stop;;\n" \
     2902       "esac\n\n" \
     2903       "Running this yields:\n" \
     2904       "$run-parts -a stop=+4m foo/\n" \
     2905       "+ shutdown -h +4m"
    24992906
    25002907#define runlevel_trivial_usage \
    2501     "[utmp]"
     2908       "[utmp]"
    25022909#define runlevel_full_usage \
    2503     "Find the current and previous system runlevel.\n\n" \
    2504     "If no utmp file exists or if no runlevel record can be found,\n" \
    2505     "runlevel prints \"unknown\""
     2910       "Find the current and previous system runlevel.\n\n" \
     2911       "If no utmp file exists or if no runlevel record can be found,\n" \
     2912       "print \"unknown\""
    25062913#define runlevel_example_usage \
    2507     "$ runlevel /var/run/utmp\n" \
    2508     "N 2"
     2914       "$ runlevel /var/run/utmp\n" \
     2915       "N 2"
     2916
     2917#define runsv_trivial_usage \
     2918       "dir"
     2919#define runsv_full_usage \
     2920       "Start and monitor a service and optionally an appendant log service"
     2921
     2922#define runsvdir_trivial_usage \
     2923       "[-P] dir"
     2924#define runsvdir_full_usage \
     2925       "Start a runsv process for each subdirectory"
    25092926
    25102927#define rx_trivial_usage \
    2511     "FILE"
     2928       "FILE"
    25122929#define rx_full_usage \
    2513     "Receive a file using the xmodem protocol."
     2930       "Receive a file using the xmodem protocol"
    25142931#define rx_example_usage \
    2515     "$ rx /tmp/foo\n"
     2932       "$ rx /tmp/foo\n"
    25162933
    25172934#define sed_trivial_usage \
    2518     "[-efinr] pattern [files...]"
     2935       "[-efinr] pattern [files...]"
    25192936#define sed_full_usage \
    2520     "Options:\n" \
    2521     "\t-e script\tadd the script to the commands to be executed\n" \
    2522     "\t-f scriptfile\tadd script-file contents to the\n" \
    2523     "\t\t\tcommands to be executed\n" \
    2524     "\t-i\t\tedit files in-place\n" \
    2525     "\t-n\t\tsuppress automatic printing of pattern space\n" \
    2526     "\t-r\t\tuse extended regular expression syntax\n" \
    2527     "\n" \
    2528     "If no -e or -f is given, the first non-option argument is taken as the sed\n" \
    2529     "script to interpret. All remaining arguments are names of input files; if no\n" \
    2530     "input files are specified, then the standard input is read. Source files\n" \
    2531     "will not be modified unless -i option is given."
     2937       "Options:\n" \
     2938       "    -e script   Add the script to the commands to be executed\n" \
     2939       "    -f scriptfile   Add script-file contents to the\n" \
     2940       "            commands to be executed\n" \
     2941       "    -i      Edit files in-place\n" \
     2942       "    -n      Suppress automatic printing of pattern space\n" \
     2943       "    -r      Use extended regular expression syntax\n" \
     2944       "\n" \
     2945       "If no -e or -f is given, the first non-option argument is taken as the sed\n" \
     2946       "script to interpret. All remaining arguments are names of input files; if no\n" \
     2947       "input files are specified, then the standard input is read. Source files\n" \
     2948       "will not be modified unless -i option is given."
    25322949
    25332950#define sed_example_usage \
    2534     "$ echo \"foo\" | sed -e 's/f[a-zA-Z]o/bar/g'\n" \
    2535     "bar\n"
     2951       "$ echo \"foo\" | sed -e 's/f[a-zA-Z]o/bar/g'\n" \
     2952       "bar\n"
     2953
     2954#define selinuxenabled_trivial_usage
     2955#define selinuxenabled_full_usage
    25362956
    25372957#define seq_trivial_usage \
    2538     "[first [increment]] last"
     2958       "[first [increment]] last"
    25392959#define seq_full_usage \
    2540     "Print numbers from FIRST to LAST, in steps of INCREMENT.\n" \
    2541     "FIRST, INCREMENT default to 1\n" \
    2542     "Arguments:\n" \
    2543     "\tLAST\n" \
    2544     "\tFIRST\tLAST\n" \
    2545     "\tFIRST\tINCREMENT\tLAST"
     2960       "Print numbers from FIRST to LAST, in steps of INCREMENT.\n" \
     2961       "FIRST, INCREMENT default to 1" \
     2962       "\n\nArguments:\n" \
     2963       "    LAST\n" \
     2964       "    FIRST LAST\n" \
     2965       "    FIRST INCREMENT LAST"
    25462966
    25472967#define setconsole_trivial_usage \
    2548     "[-r|--reset] [DEVICE]"
     2968       "[-r|--reset] [DEVICE]"
    25492969#define setconsole_full_usage \
    2550     "Redirects system console output to DEVICE (default: /dev/tty).\n\n" \
    2551     "Options:\n" \
    2552     "\t-r\tReset output to /dev/console."
     2970       "Redirect system console output to DEVICE (default: /dev/tty)" \
     2971       "\n\nOptions:\n" \
     2972       "    -r  Reset output to /dev/console"
     2973
     2974#define setenforce_trivial_usage \
     2975       "[Enforcing | Permissive | 1 | 0]"
     2976#define setenforce_full_usage
     2977
     2978#define setfiles_trivial_usage \
     2979       "[-dnpqsvW] [-e dir]... [-o filename] [-r alt_root_path]" \
     2980    USE_FEATURE_SETFILES_CHECK_OPTION( \
     2981       " [-c policyfile] spec_file" \
     2982    ) \
     2983       " pathname"
     2984
     2985#define setfiles_full_usage \
     2986       "Reset file contexts under pathname according to spec_file" \
     2987    USE_FEATURE_SETFILES_CHECK_OPTION( \
     2988       "\n  -c file Check the validity of the contexts against the specified binary policy" \
     2989    ) \
     2990       "\n  -d  Show which specification matched each file" \
     2991       "\n  -l  Log changes in file labels to syslog" \
     2992       "\n  -n  Don't change any file labels" \
     2993       "\n  -q  Suppress warnings" \
     2994       "\n  -r dir  Use an altenate root path" \
     2995       "\n  -e dir  Exclude directory" \
     2996       "\n  -F  Force reset of context to match file_context for customizable files" \
     2997       "\n  -o file Save list of files with incorrect context" \
     2998       "\n  -s  Take a list of files from standard input (instead of command line)" \
     2999       "\n  -v  Show changes in file labels, if type or role are changing" \
     3000       "\n  -vv Show changes in file labels, if type, role, or user are changing" \
     3001       "\n  -W  Display warnings about entries that had no matching files"
    25533002
    25543003#define setkeycodes_trivial_usage \
    2555     "SCANCODE KEYCODE ..."
     3004       "SCANCODE KEYCODE ..."
    25563005#define setkeycodes_full_usage \
    2557     "Set entries into the kernel's scancode-to-keycode map,\n" \
    2558     "allowing unusual keyboards to generate usable keycodes.\n\n" \
    2559     "SCANCODE may be either xx or e0xx (hexadecimal),\n" \
    2560     "and KEYCODE is given in decimal"
     3006       "Set entries into the kernel's scancode-to-keycode map,\n" \
     3007       "allowing unusual keyboards to generate usable keycodes.\n\n" \
     3008       "SCANCODE may be either xx or e0xx (hexadecimal),\n" \
     3009       "and KEYCODE is given in decimal"
    25613010#define setkeycodes_example_usage \
    2562     "$ setkeycodes e030 127\n"
     3011       "$ setkeycodes e030 127\n"
    25633012
    25643013#define setlogcons_trivial_usage \
    2565     "N"
     3014       "N"
    25663015#define setlogcons_full_usage \
    2567     "Redirects the kernel output to console N (0 for current)."
     3016       "Redirect the kernel output to console N (0 for current)"
    25683017
    25693018#define setsid_trivial_usage \
    2570     "program [arg ...]"
     3019       "program [arg ...]"
    25713020#define setsid_full_usage \
    2572     "Runs any program in a new session by calling setsid() before\n" \
    2573     "exec'ing the rest of its arguments. See setsid(2) for details."
     3021       "Run any program in a new session by calling setsid() before\n" \
     3022       "exec'ing the rest of its arguments. See setsid(2) for details."
    25743023
    25753024#define lash_trivial_usage \
    2576     "[FILE]...\n" \
    2577     "or: sh -c command [args]..."
     3025       "[FILE]...\n" \
     3026       "or: sh -c command [args]..."
    25783027#define lash_full_usage \
    2579     "The BusyBox LAme SHell (command interpreter)"
     3028       "The BusyBox LAme SHell (command interpreter)"
    25803029#define lash_notes_usage \
    2581     "This command does not yet have proper documentation.\n\n" \
    2582     "Use lash just as you would use any other shell. It properly handles pipes,\n" \
    2583     "redirects, job control, can be used as the shell for scripts, and has a\n" \
    2584     "sufficient set of builtins to do what is needed. It does not (yet) support\n" \
    2585     "Bourne Shell syntax. If you need things like \"if-then-else\", \"while\", and such\n" \
    2586     "use ash or bash. If you just need a very simple and extremely small shell,\n" \
    2587     "this will do the job."
     3030       "This command does not yet have proper documentation.\n\n" \
     3031       "Use lash just as you would use any other shell. It properly handles pipes,\n" \
     3032       "redirects, job control, can be used as the shell for scripts, and has a\n" \
     3033       "sufficient set of builtins to do what is needed. It does not (yet) support\n" \
     3034       "Bourne Shell syntax. If you need things like \"if-then-else\", \"while\", and such\n" \
     3035       "use ash or bash. If you just need a very simple and extremely small shell,\n" \
     3036       "this will do the job."
    25883037
    25893038#define last_trivial_usage \
    2590     ""
     3039       ""
    25913040#define last_full_usage \
    2592     "Shows listing of the last users that logged into the system"
     3041       "Show listing of the last users that logged into the system"
    25933042
    25943043#define sha1sum_trivial_usage \
    2595     "[OPTION] [FILEs...]" \
    2596     USAGE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum [OPTION] -c [FILE]")
     3044       "[OPTION] [FILEs...]" \
     3045    USE_FEATURE_MD5_SHA1_SUM_CHECK("\n   or: sha1sum [OPTION] -c [FILE]")
    25973046#define sha1sum_full_usage \
    2598     "Print" USAGE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums.\n\n" \
    2599     "Options:\n" \
    2600     "With no FILE, or when FILE is -, read standard input." \
    2601     USAGE_MD5_SHA1_SUM_CHECK("\n\n" \
    2602     "\t-c\tcheck SHA1 sums against given list\n" \
    2603     "\nThe following two options are useful only when verifying checksums:\n" \
    2604     "\t-s\tdon't output anything, status code shows success\n" \
    2605     "\t-w\twarn about improperly formated SHA1 checksum lines")
    2606 
    2607 #ifdef CONFIG_FEATURE_FANCY_SLEEP
    2608 #  define USAGE_FANCY_SLEEP(a) a
    2609 #  define USAGE_NOT_FANCY_SLEEP(a)
    2610 #else
    2611 #  define USAGE_FANCY_SLEEP(a)
    2612 #  define USAGE_NOT_FANCY_SLEEP(a) a
    2613 #endif
     3047       "Print" USE_FEATURE_MD5_SHA1_SUM_CHECK(" or check") " SHA1 checksums.\n" \
     3048       "With no FILE, or when FILE is -, read standard input." \
     3049       "\n\nOptions:\n" \
     3050    USE_FEATURE_MD5_SHA1_SUM_CHECK( \
     3051       "    -c  Check SHA1 sums against given list\n" \
     3052       "\nThe following two options are useful only when verifying checksums:\n" \
     3053       "    -s  Don't output anything, status code shows success\n" \
     3054       "    -w  Warn about improperly formatted SHA1 checksum lines")
     3055
     3056#define slattach_trivial_usage \
     3057       "[-cehmLF] [-s speed] [-p protocol] DEVICEs"
     3058#define slattach_full_usage \
     3059       "Attach network interface(s) to serial line(s)\n" \
     3060     "\nOptions:" \
     3061     "\n    -p  Set protocol (slip, cslip, slip6, clisp6 or adaptive)" \
     3062     "\n    -s  Set line speed" \
     3063     "\n    -e  Exit after initializing device" \
     3064     "\n    -h  Exit when the carrier is lost" \
     3065     "\n    -c  Execute a command when the line is hung up" \
     3066     "\n    -m  Do NOT initialize the line in raw 8 bits mode" \
     3067     "\n    -L  Enable 3-wire operation" \
     3068     "\n    -F  Disable RTS/CTS flow control" \
    26143069
    26153070#define sleep_trivial_usage \
    2616     USAGE_FANCY_SLEEP("[") "N" USAGE_FANCY_SLEEP("]...")
     3071    USE_FEATURE_FANCY_SLEEP("[") "N" USE_FEATURE_FANCY_SLEEP("]...")
    26173072#define sleep_full_usage \
    2618     USAGE_NOT_FANCY_SLEEP("Pause for N seconds.") \
    2619     USAGE_FANCY_SLEEP( \
    2620     "Pause for a time equal to the total of the args given, where each arg can\n" \
    2621     "\t\thave an optional suffix of (s)econds, (m)inutes, (h)ours, or (d)ays.")
     3073    SKIP_FEATURE_FANCY_SLEEP("Pause for N seconds") \
     3074    USE_FEATURE_FANCY_SLEEP( \
     3075       "Pause for a time equal to the total of the args given, where each arg can\n" \
     3076       "have an optional suffix of (s)econds, (m)inutes, (h)ours, or (d)ays")
    26223077#define sleep_example_usage \
    2623     "$ sleep 2\n" \
    2624     "[2 second delay results]\n" \
    2625     USAGE_FANCY_SLEEP("$ sleep 1d 3h 22m 8s\n" \
    2626     "[98528 second delay results]\n")
    2627 
    2628 #if ENABLE_FEATURE_SORT_BIG
    2629 #  define USAGE_SORT_BIG(a) a
    2630 #else
    2631 #  define USAGE_SORT_BIG(a)
    2632 #endif
     3078       "$ sleep 2\n" \
     3079       "[2 second delay results]\n" \
     3080    USE_FEATURE_FANCY_SLEEP( \
     3081       "$ sleep 1d 3h 22m 8s\n" \
     3082       "[98528 second delay results]\n")
    26333083
    26343084#define sort_trivial_usage \
    2635     "[-nru" USAGE_SORT_BIG("gMcszbdfimSTokt] [-o outfile] [-k start[.offset][opts][,end[.offset][opts]] [-t char") "] [FILE]..."
     3085       "[-nru" \
     3086    USE_FEATURE_SORT_BIG("gMcszbdfimSTokt] [-o outfile] [-k start[.offset][opts][,end[.offset][opts]] [-t char") \
     3087       "] [FILE]..."
    26363088#define sort_full_usage \
    2637     "Sorts lines of text in the specified files\n\n" \
    2638     "Options:\n" \
    2639     USAGE_SORT_BIG( \
    2640         "\t-b\tignore leading blanks\n" \
    2641         "\t-c\tcheck whether input is sorted\n" \
    2642         "\t-d\tdictionary order (blank or alphanumeric only)\n" \
    2643         "\t-f\tignore case\n" \
    2644         "\t-g\tgeneral numerical sort\n" \
    2645         "\t-i\tignore unprintable characters\n" \
    2646         "\t-k\tspecify sort key\n" \
    2647         "\t-M\tsort month\n" \
    2648     ) \
    2649     "\t-n\tsort numbers\n" \
    2650     USAGE_SORT_BIG( \
    2651         "\t-o\toutput to file\n" \
    2652         "\t-k\tsort by key\n" \
    2653         "\t-t\tuse key separator other than whitespace\n" \
    2654     ) \
    2655     "\t-r\treverse sort order\n" \
    2656     USAGE_SORT_BIG("\t-s\tstable (don't sort ties alphabetically)\n") \
    2657     "\t-u\tsuppress duplicate lines" \
    2658     USAGE_SORT_BIG("\n\t-z\tinput terminated by nulls, not newlines\n") \
    2659     USAGE_SORT_BIG("\t-mST\tignored for GNU compatibility") \
    2660     ""
     3089       "Sort lines of text in the specified files" \
     3090       "\n\nOptions:\n" \
     3091    USE_FEATURE_SORT_BIG( \
     3092       "    -b  Ignore leading blanks\n" \
     3093       "    -c  Check whether input is sorted\n" \
     3094       "    -d  Dictionary order (blank or alphanumeric only)\n" \
     3095       "    -f  Ignore case\n" \
     3096       "    -g  General numerical sort\n" \
     3097       "    -i  Ignore unprintable characters\n" \
     3098       "    -k  Specify sort key\n" \
     3099       "    -M  Sort month\n") \
     3100       "    -n  Sort numbers\n" \
     3101    USE_FEATURE_SORT_BIG( \
     3102       "    -o  Output to file\n" \
     3103       "    -k  Sort by key\n" \
     3104       "    -t  Use key separator other than whitespace\n") \
     3105       "    -r  Reverse sort order\n" \
     3106    USE_FEATURE_SORT_BIG( \
     3107       "    -s  Stable (don't sort ties alphabetically)\n") \
     3108       "    -u  Suppress duplicate lines" \
     3109    USE_FEATURE_SORT_BIG( \
     3110       "\n  -z  Input terminated by nulls, not newlines\n") \
     3111    USE_FEATURE_SORT_BIG( \
     3112       "    -mST    Ignored for GNU compatibility") \
     3113       ""
    26613114#define sort_example_usage \
    2662     "$ echo -e \"e\\nf\\nb\\nd\\nc\\na\" | sort\n" \
    2663     "a\n" \
    2664     "b\n" \
    2665     "c\n" \
    2666     "d\n" \
    2667     "e\n" \
    2668     "f\n" \
    2669     USAGE_SORT_BIG( \
     3115       "$ echo -e \"e\\nf\\nb\\nd\\nc\\na\" | sort\n" \
     3116       "a\n" \
     3117       "b\n" \
     3118       "c\n" \
     3119       "d\n" \
     3120       "e\n" \
     3121       "f\n" \
     3122    USE_FEATURE_SORT_BIG( \
    26703123        "$ echo -e \"c 3\\nb 2\\nd 2\" | $SORT -k 2,2n -k 1,1r\n" \
    26713124        "d 2\n" \
     
    26733126        "c 3\n" \
    26743127    ) \
    2675     ""
     3128       ""
     3129
     3130#define split_trivial_usage \
     3131       "[OPTION] [INPUT [PREFIX]]"
     3132#define split_full_usage \
     3133       "Options:" \
     3134       "\n  -b n[k|m]   Split by bytes" \
     3135       "\n  -l n        Split by lines" \
     3136       "\n  -a n        Use n letters as suffix"
     3137#define split_example_usage \
     3138       "$ split TODO foo\n" \
     3139       "$ cat TODO | split -a 2 -l 2 TODO_\n"
    26763140
    26773141#define start_stop_daemon_trivial_usage \
    2678     "[OPTIONS] [--start|--stop] ... [-- arguments...]"
     3142       "[OPTIONS] [--start|--stop] ... [-- arguments...]"
    26793143#define start_stop_daemon_full_usage \
    2680     "Program to start and stop services." \
    2681     "\n\nOptions:" \
    2682     "\n\t-S|--start\t\t\tstart" \
    2683     "\n\t-K|--stop\t\t\tstop" \
    2684     "\n\t-a|--startas <pathname>\t\tstarts process specified by pathname" \
    2685     "\n\t-b|--background\t\t\tforce process into background" \
    2686     "\n\t-u|--user <username>|<uid>\tstop this user's processes" \
    2687     "\n\t-x|--exec <executable>\t\tprogram to either start or check" \
    2688     "\n\t-m|--make-pidfile <filename>\tcreate the -p file and enter pid in it" \
    2689     "\n\t-n|--name <process-name>\tstop processes with this name" \
    2690     "\n\t-p|--pidfile <pid-file>\t\tsave or load pid using a pid-file" \
    2691     "\n\t-q|--quiet\t\t\tbe quiet" \
    2692 USE_FEATURE_START_STOP_DAEMON_FANCY( \
    2693     "\n\t-o|--oknodo\t\t\texit status 0 if nothing done" \
    2694     "\n\t-v|--verbose\t\t\tbe verbose" \
    2695 ) \
    2696     "\n\t-s|--signal <signal>\t\tsignal to send (default TERM)"
    2697 
    2698 #ifdef CONFIG_FEATURE_STAT_FORMAT
    2699 #  define USAGE_STAT_FORMAT(a) a
    2700 #else
    2701 #  define USAGE_STAT_FORMAT(a)
    2702 #endif
     3144       "Start and stop services" \
     3145       "\n\nOptions:" \
     3146       "\n  -S|--start          Start" \
     3147       "\n  -K|--stop           Stop" \
     3148       "\n  -a|--startas pathname       Starts process specified by pathname" \
     3149       "\n  -b|--background         Force process into background" \
     3150       "\n  -u|--user username|uid      Stop this user's processes" \
     3151       "\n  -x|--exec executable        Program to either start or check" \
     3152       "\n  -m|--make-pidfile       Create the -p file and enter pid in it" \
     3153       "\n  -n|--name process-name      Stop processes with this name" \
     3154       "\n  -p|--pidfile pid-file       Save or load pid using a pid-file" \
     3155       "\n  -q|--quiet          Quiet" \
     3156    USE_FEATURE_START_STOP_DAEMON_FANCY( \
     3157       "\n  -o|--oknodo         Exit status 0 if nothing done" \
     3158       "\n  -v|--verbose            Verbose" \
     3159       "\n  -N|--nicelevel N        Add N to process's nice level" \
     3160    ) \
     3161       "\n  -s|--signal signal      Signal to send (default TERM)" \
     3162       "\n  -c|--chuid user[:[group]]   Change to specified user/group"
     3163
    27033164#define stat_trivial_usage \
    2704     "[OPTION] FILE..."
     3165       "[OPTION] FILE..."
    27053166#define stat_full_usage \
    2706     "display file (default) or filesystem status.\n\n" \
    2707     "Options:\n" \
    2708     USAGE_STAT_FORMAT("\t-c fmt\tuse the specified format\n") \
    2709     "\t-f\tdisplay filesystem status\n" \
    2710     "\t-L,-l\tdereference links\n" \
    2711     "\t-t\tdisplay info in terse form\n" \
    2712     USAGE_STAT_FORMAT( \
    2713     "\nValid format sequences for files:\n" \
    2714     "  %a   Access rights in octal\n" \
    2715     "  %A   Access rights in human readable form\n" \
    2716     "  %b   Number of blocks allocated (see %B)\n" \
    2717     "  %B   The size in bytes of each block reported by %b\n" \
    2718     "  %d   Device number in decimal\n" \
    2719     "  %D   Device number in hex\n" \
    2720     "  %f   Raw mode in hex\n" \
    2721     "  %F   File type\n" \
    2722     "  %g   Group ID of owner\n" \
    2723     "  %G   Group name of owner\n" \
    2724     "  %h   Number of hard links\n" \
    2725     "  %i   Inode number\n" \
    2726     "  %n   File name\n" \
    2727     "  %N   Quoted file name with dereference if symbolic link\n" \
    2728     "  %o   I/O block size\n" \
    2729     "  %s   Total size, in bytes\n" \
    2730     "  %t   Major device type in hex\n" \
    2731     "  %T   Minor device type in hex\n" \
    2732     "  %u   User ID of owner\n" \
    2733     "  %U   User name of owner\n" \
    2734     "  %x   Time of last access\n" \
    2735     "  %X   Time of last access as seconds since Epoch\n" \
    2736     "  %y   Time of last modification\n" \
    2737     "  %Y   Time of last modification as seconds since Epoch\n" \
    2738     "  %z   Time of last change\n" \
    2739     "  %Z   Time of last change as seconds since Epoch\n" \
    2740     "\nValid format sequences for file systems:\n" \
    2741     "  %a   Free blocks available to non-superuser\n" \
    2742     "  %b   Total data blocks in file system\n" \
    2743     "  %c   Total file nodes in file system\n" \
    2744     "  %d   Free file nodes in file system\n" \
    2745     "  %f   Free blocks in file system\n" \
    2746     "  %i   File System ID in hex\n" \
    2747     "  %l   Maximum length of filenames\n" \
    2748     "  %n   File name\n" \
    2749     "  %s   Block size (for faster transfers)\n" \
    2750     "  %S   Fundamental block size (for block counts)\n" \
    2751     "  %t   Type in hex\n" \
    2752     "  %T   Type in human readable form\n" \
     3167       "Display file (default) or filesystem status" \
     3168       "\n\nOptions:\n" \
     3169    USE_FEATURE_STAT_FORMAT( \
     3170       "    -c fmt  Use the specified format\n") \
     3171       "    -f  Display filesystem status\n" \
     3172       "    -L,-l   Dereference links\n" \
     3173       "    -t  Display info in terse form" \
     3174    USE_SELINUX( \
     3175       "\n  -Z  Print security context" \
     3176    ) \
     3177    USE_FEATURE_STAT_FORMAT( \
     3178       "\n\nValid format sequences for files:\n" \
     3179       " %a Access rights in octal\n" \
     3180       " %A Access rights in human readable form\n" \
     3181       " %b Number of blocks allocated (see %B)\n" \
     3182       " %B The size in bytes of each block reported by %b\n" \
     3183       " %d Device number in decimal\n" \
     3184       " %D Device number in hex\n" \
     3185       " %f Raw mode in hex\n" \
     3186       " %F File type\n" \
     3187       " %g Group ID of owner\n" \
     3188       " %G Group name of owner\n" \
     3189       " %h Number of hard links\n" \
     3190       " %i Inode number\n" \
     3191       " %n File name\n" \
     3192       " %N Quoted file name with dereference if symlink\n" \
     3193       " %o I/O block size\n" \
     3194       " %s Total size, in bytes\n" \
     3195       " %t Major device type in hex\n" \
     3196       " %T Minor device type in hex\n" \
     3197       " %u User ID of owner\n" \
     3198       " %U User name of owner\n" \
     3199       " %x Time of last access\n" \
     3200       " %X Time of last access as seconds since Epoch\n" \
     3201       " %y Time of last modification\n" \
     3202       " %Y Time of last modification as seconds since Epoch\n" \
     3203       " %z Time of last change\n" \
     3204       " %Z Time of last change as seconds since Epoch\n" \
     3205       "\nValid format sequences for file systems:\n" \
     3206       " %a Free blocks available to non-superuser\n" \
     3207       " %b Total data blocks in file system\n" \
     3208       " %c Total file nodes in file system\n" \
     3209       " %d Free file nodes in file system\n" \
     3210       " %f Free blocks in file system\n" \
     3211    USE_SELINUX( \
     3212       " %C Security context in SELinux\n" \
     3213    ) \
     3214       " %i File System ID in hex\n" \
     3215       " %l Maximum length of filenames\n" \
     3216       " %n File name\n" \
     3217       " %s Block size (for faster transfer)\n" \
     3218       " %S Fundamental block size (for block counts)\n" \
     3219       " %t Type in hex\n" \
     3220       " %T Type in human readable form" \
    27533221    )
    27543222
    27553223#define strings_trivial_usage \
    2756     "[-afo] [-n length] [file ... ]"
     3224       "[-afo] [-n length] [file ...]"
    27573225#define strings_full_usage \
    2758     "Display printable strings in a binary file." \
    2759     "\n\nOptions:" \
    2760     "\n\t-a\tScan the whole files (this is the default)." \
    2761     "\n\t-f\tPrecede each string with the name of the file where it was found." \
    2762     "\n\t-n N\tSpecifies that at least N characters forms a sequence (default 4)" \
    2763     "\n\t-o\tEach string is preceded by its decimal offset in the file"
     3226       "Display printable strings in a binary file" \
     3227       "\n\nOptions:" \
     3228       "\n  -a  Scan the whole files (this is the default)" \
     3229       "\n  -f  Precede each string with the name of the file where it was found" \
     3230       "\n  -n N    Specifies that at least N characters forms a sequence (default 4)" \
     3231       "\n  -o  Each string is preceded by its decimal offset in the file"
    27643232
    27653233#define stty_trivial_usage \
    2766     "[-a|g] [-F DEVICE] [SETTING]..."
     3234       "[-a|g] [-F DEVICE] [SETTING]..."
    27673235#define stty_full_usage \
    2768     "Without arguments, prints baud rate, line discipline," \
    2769     "\nand deviations from stty sane." \
    2770     "\n\nOptions:" \
    2771     "\n\t-F DEVICE\topen device instead of stdin" \
    2772     "\n\t-a\t\tprint all current settings in human-readable form" \
    2773     "\n\t-g\t\tprint in stty-readable form" \
    2774     "\n\t[SETTING]\tsee manpage"
     3236       "Without arguments, prints baud rate, line discipline,\n" \
     3237       "and deviations from stty sane" \
     3238       "\n\nOptions:" \
     3239       "\n  -F DEVICE   Open device instead of stdin" \
     3240       "\n  -a      Print all current settings in human-readable form" \
     3241       "\n  -g      Print in stty-readable form" \
     3242       "\n  [SETTING]   See manpage"
    27753243
    27763244#define su_trivial_usage \
    2777     "[OPTION]... [-] [username]"
     3245       "[OPTION]... [-] [username]"
    27783246#define su_full_usage \
    2779     "Change user id or become root.\n" \
    2780     "Options:\n" \
    2781     "\t-p, -m\tPreserve environment" \
    2782     "\n\t-c\tCommand to pass to 'sh -c'" \
    2783     "\n\t-s\tShell to use instead of default shell"
     3247       "Change user id or become root" \
     3248       "\n\nOptions:" \
     3249       "\n  -p, -m  Preserve environment" \
     3250       "\n  -c  Command to pass to 'sh -c'" \
     3251       "\n  -s  Shell to use instead of default shell"
    27843252
    27853253#define sulogin_trivial_usage \
    2786     "[OPTION]... [tty-device]"
     3254       "[OPTION]... [tty-device]"
    27873255#define sulogin_full_usage \
    2788     "Single user login\n" \
    2789     "Options:\n" \
    2790     "\t-f\tDo not authenticate (user already authenticated)\n" \
    2791     "\t-h\tName of the remote host for this login\n" \
    2792     "\t-p\tPreserve environment"
     3256       "Single user login" \
     3257       "\n\nOptions:" \
     3258       "\n  -t  Timeout"
    27933259
    27943260#define sum_trivial_usage \
    2795     "[rs] [files...]"
     3261       "[rs] [files...]"
    27963262#define sum_full_usage \
    2797     "checksum and count the blocks in a file\n\n" \
    2798     "Options:\n" \
    2799     "\t-r\tuse BSD sum algorithm (1K blocks)\n" \
    2800     "\t-s\tuse System V sum algorithm (512byte blocks)"
     3263       "Checksum and count the blocks in a file" \
     3264       "\n\nOptions:\n" \
     3265       "    -r  Use BSD sum algorithm (1K blocks)\n" \
     3266       "    -s  Use System V sum algorithm (512byte blocks)"
     3267
     3268#define sv_trivial_usage \
     3269       "[-v] [-w sec] command service..."
     3270#define sv_full_usage \
     3271       "Control services monitored by runsv supervisor.\n" \
     3272       "Commands (only first character is enough):\n" \
     3273       "\n" \
     3274       "status: query service status\n" \
     3275       "up: if service isn't running, start it. If service stops, restart it\n" \
     3276       "once: like 'up', but if service stops, don't restart it\n" \
     3277       "down: send TERM and CONT signals. If ./run exits, start ./finish\n" \
     3278       "    if it exists. After it stops, do not restart service\n" \
     3279       "exit: send TERM and CONT signals to service and log service. If they exit,\n" \
     3280       "    runsv exits too\n" \
     3281       "pause, cont, hup, alarm, interrupt, quit, 1, 2, term, kill: send\n" \
     3282       "STOP, CONT, HUP, ALRM, INT, QUIT, USR1, USR2, TERM, KILL signal to service"
     3283
     3284#define svlogd_trivial_usage \
     3285       "[-ttv] [-r c] [-R abc] [-l len] [-b buflen] dir..."
     3286#define svlogd_full_usage \
     3287       "Continuously read log data from standard input, optionally " \
     3288       "filter log messages, and write the data to one or more automatically " \
     3289       "rotated logs"
    28013290
    28023291#define swapoff_trivial_usage \
    2803     "[-a] [DEVICE]"
     3292       "[-a] [DEVICE]"
    28043293#define swapoff_full_usage \
    2805     "Stop swapping virtual memory pages on DEVICE.\n\n" \
    2806     "Options:\n" \
    2807     "\t-a\tStop swapping on all swap devices"
     3294       "Stop swapping virtual memory pages on DEVICE" \
     3295       "\n\nOptions:\n" \
     3296       "    -a  Stop swapping on all swap devices"
    28083297
    28093298#define swapon_trivial_usage \
    2810     "[-a] [DEVICE]"
     3299       "[-a] [DEVICE]"
    28113300#define swapon_full_usage \
    2812     "Start swapping virtual memory pages on DEVICE.\n\n" \
    2813     "Options:\n" \
    2814     "\t-a\tStart swapping on all swap devices"
     3301       "Start swapping virtual memory pages on DEVICE" \
     3302       "\n\nOptions:\n" \
     3303       "    -a  Start swapping on all swap devices"
    28153304
    28163305#define switch_root_trivial_usage \
    2817     "[-c /dev/console] NEW_ROOT NEW_INIT [ARGUMENTS_TO_INIT]"
     3306       "[-c /dev/console] NEW_ROOT NEW_INIT [ARGUMENTS_TO_INIT]"
    28183307#define switch_root_full_usage \
    2819     "Use from PID 1 under initramfs to free initramfs, chroot to NEW_ROOT,\n" \
    2820     "and exec NEW_INIT.\n\n" \
    2821     "Options:\n" \
    2822     "\t-c\tRedirect console to device on new root"
     3308       "Use from PID 1 under initramfs to free initramfs, chroot to NEW_ROOT,\n" \
     3309       "and exec NEW_INIT" \
     3310       "\n\nOptions:\n" \
     3311       "    -c  Redirect console to device on new root"
    28233312
    28243313#define sync_trivial_usage \
    2825     ""
     3314       ""
    28263315#define sync_full_usage \
    2827     "Write all buffered filesystem blocks to disk."
    2828 
    2829 
    2830 #ifdef CONFIG_FEATURE_ROTATE_LOGFILE
    2831 #  define USAGE_ROTATE_LOGFILE(a) a
    2832 #else
    2833 #  define USAGE_ROTATE_LOGFILE(a)
    2834 #endif
    2835 #ifdef CONFIG_FEATURE_REMOTE_LOG
    2836 #  define USAGE_REMOTE_LOG(a) a
    2837 #else
    2838 #  define USAGE_REMOTE_LOG(a)
    2839 #endif
    2840 #ifdef CONFIG_FEATURE_IPC_SYSLOG
    2841 #  define USAGE_IPC_LOG(a) a
    2842 #else
    2843 #  define USAGE_IPC_LOG(a)
    2844 #endif
     3316       "Write all buffered filesystem blocks to disk"
    28453317
    28463318#define sysctl_trivial_usage \
    2847     "[OPTIONS]... [VALUE]..."
     3319       "[OPTIONS]... [VALUE]..."
    28483320#define sysctl_full_usage \
    2849     "configure kernel parameters at runtime\n\n" \
    2850     "Options:\n" \
    2851     "\t-n\tUse this option to disable printing of the key name when printing values\n" \
    2852     "\t-w\tUse this option when you want to change a sysctl setting\n" \
    2853     "\t-p\tLoad in sysctl settings from the file specified or /etc/sysctl.conf if none given\n" \
    2854     "\t-a\tDisplay all values currently available\n" \
    2855     "\t-A\tDisplay all values currently available in table form"
     3321       "Configure kernel parameters at runtime" \
     3322       "\n\nOptions:\n" \
     3323       "    -n  Use this option to disable printing of the key name when printing values\n" \
     3324       "    -w  Use this option when you want to change a sysctl setting\n" \
     3325       "    -p  Load in sysctl settings from the file specified or /etc/sysctl.conf if none given\n" \
     3326       "    -a  Display all values currently available\n" \
     3327       "    -A  Display all values currently available in table form"
    28563328#define sysctl_example_usage \
    2857     "sysctl [-n] variable ...\n" \
    2858     "sysctl [-n] -w variable=value ...\n" \
    2859     "sysctl [-n] -a\n" \
    2860     "sysctl [-n] -p <file>\t(default /etc/sysctl.conf)\n" \
    2861     "sysctl [-n] -A\n"
     3329       "sysctl [-n] variable ...\n" \
     3330       "sysctl [-n] -w variable=value ...\n" \
     3331       "sysctl [-n] -a\n" \
     3332       "sysctl [-n] -p file (default /etc/sysctl.conf)\n" \
     3333       "sysctl [-n] -A\n"
    28623334
    28633335#define syslogd_trivial_usage \
    2864     "[OPTION]..."
     3336       "[OPTION]..."
    28653337#define syslogd_full_usage \
    2866     "Linux system and kernel logging utility.\n" \
    2867     "Note that this version of syslogd ignores /etc/syslog.conf.\n\n" \
    2868     "Options:\n" \
    2869     "\t-m MIN\t\tMinutes between MARK lines (default=20, 0=off)\n" \
    2870     "\t-n\t\tRun as a foreground process\n" \
    2871     "\t-O FILE\t\tUse an alternate log file (default=/var/log/messages)\n" \
    2872     "\t-S\t\tMake logging output smaller." \
    2873     USAGE_ROTATE_LOGFILE( \
    2874     "\n\t-s SIZE\t\tMax size (KB) before rotate (default=200KB, 0=off)\n" \
    2875     "\t-b NUM\t\tNumber of rotated logs to keep (default=1, max=99, 0=purge)") \
    2876     USAGE_REMOTE_LOG( \
    2877     "\n\t-R HOST[:PORT]\tLog to IP or hostname on PORT (default PORT=514/UDP)\n" \
    2878     "\t-L\t\tLog locally and via network logging (default is network only)") \
    2879     USAGE_IPC_LOG( \
    2880     "\n\t-C [size(KiB)]\tLog to a circular buffer (read the buffer using logread)")
     3338       "System logging utility.\n" \
     3339       "Note that this version of syslogd ignores /etc/syslog.conf." \
     3340       "\n\nOptions:" \
     3341       "\n  -n      Run as foreground process" \
     3342       "\n  -O FILE     Log to given file (default=/var/log/messages)" \
     3343       "\n  -l n        Set local log level" \
     3344       "\n  -S      Smaller logging output" \
     3345    USE_FEATURE_ROTATE_LOGFILE( \
     3346       "\n  -s SIZE     Max size (KB) before rotate (default=200KB, 0=off)" \
     3347       "\n  -b NUM      Number of rotated logs to keep (default=1, max=99, 0=purge)") \
     3348    USE_FEATURE_REMOTE_LOG( \
     3349       "\n  -R HOST[:PORT]  Log to IP or hostname on PORT (default PORT=514/UDP)" \
     3350       "\n  -L      Log locally and via network (default is network only if -R)") \
     3351    USE_FEATURE_IPC_SYSLOG( \
     3352       "\n  -C[size(KiB)]   Log to shared mem buffer (read it using logread)")
     3353    /* NB: -Csize shouldn't have space (because size is optional) */
     3354/*     "\n  -m MIN      Minutes between MARK lines (default=20, 0=off)" */
    28813355#define syslogd_example_usage \
    2882     "$ syslogd -R masterlog:514\n" \
    2883     "$ syslogd -R 192.168.1.1:601\n"
    2884 
    2885 
    2886 #ifndef CONFIG_FEATURE_FANCY_TAIL
    2887 #  define USAGE_UNSIMPLE_TAIL(a)
    2888 #else
    2889 #  define USAGE_UNSIMPLE_TAIL(a) a
    2890 #endif
     3356       "$ syslogd -R masterlog:514\n" \
     3357       "$ syslogd -R 192.168.1.1:601\n"
     3358
    28913359#define tail_trivial_usage \
    2892     "[OPTION]... [FILE]..."
     3360       "[OPTION]... [FILE]..."
    28933361#define tail_full_usage \
    2894     "Print last 10 lines of each FILE to standard output.\n" \
    2895     "With more than one FILE, precede each with a header giving the\n" \
    2896     "file name. With no FILE, or when FILE is -, read standard input.\n\n" \
    2897     "Options:\n" \
    2898     USAGE_UNSIMPLE_TAIL("\t-c N[kbm]\toutput the last N bytes\n") \
    2899     "\t-n N[kbm]\tprint last N lines instead of last 10\n" \
    2900     "\t-f\t\toutput data as the file grows" \
    2901     USAGE_UNSIMPLE_TAIL( "\n\t-q\t\tnever output headers giving file names\n" \
    2902     "\t-s SEC\t\twait SEC seconds between reads with -f\n" \
    2903     "\t-v\t\talways output headers giving file names\n\n" \
    2904     "If the first character of N (bytes or lines) is a '+', output begins with \n" \
    2905     "the Nth item from the start of each file, otherwise, print the last N items\n" \
    2906     "in the file. N bytes may be suffixed by k (x1024), b (x512), or m (1024^2)." )
     3362       "Print last 10 lines of each FILE to standard output.\n" \
     3363       "With more than one FILE, precede each with a header giving the\n" \
     3364       "file name. With no FILE, or when FILE is -, read standard input." \
     3365       "\n\nOptions:" \
     3366    USE_FEATURE_FANCY_TAIL( \
     3367       "\n  -c N[kbm]   Output the last N bytes") \
     3368       "\n  -n N[kbm]   Print last N lines instead of last 10" \
     3369       "\n  -f      Output data as the file grows" \
     3370    USE_FEATURE_FANCY_TAIL( \
     3371       "\n  -q      Never output headers giving file names" \
     3372       "\n  -s SEC      Wait SEC seconds between reads with -f" \
     3373       "\n  -v      Always output headers giving file names" \
     3374       "\n\n" \
     3375       "If the first character of N (bytes or lines) is a '+', output begins with\n" \
     3376       "the Nth item from the start of each file, otherwise, print the last N items\n" \
     3377       "in the file. N bytes may be suffixed by k (x1024), b (x512), or m (1024^2)." )
    29073378#define tail_example_usage \
    2908     "$ tail -n 1 /etc/resolv.conf\n" \
    2909     "nameserver 10.0.0.1\n"
    2910 
    2911 #ifdef CONFIG_FEATURE_TAR_CREATE
    2912 #  define USAGE_TAR_CREATE(a) a
    2913 #else
    2914 #  define USAGE_TAR_CREATE(a)
    2915 #endif
    2916 #ifdef CONFIG_FEATURE_TAR_EXCLUDE
    2917 #  define USAGE_TAR_EXCLUDE(a) a
    2918 #else
    2919 #  define USAGE_TAR_EXCLUDE(a)
    2920 #endif
    2921 #ifdef CONFIG_FEATURE_TAR_GZIP
    2922 #  define USAGE_TAR_GZIP(a) a
    2923 #else
    2924 #  define USAGE_TAR_GZIP(a)
    2925 #endif
    2926 #ifdef CONFIG_FEATURE_TAR_BZIP2
    2927 #  define USAGE_TAR_BZIP2(a) a
    2928 #else
    2929 #  define USAGE_TAR_BZIP2(a)
    2930 #endif
    2931 #ifdef CONFIG_FEATURE_TAR_LZMA
    2932 #  define USAGE_TAR_LZMA(a) a
    2933 #else
    2934 #  define USAGE_TAR_LZMA(a)
    2935 #endif
    2936 #ifdef CONFIG_FEATURE_TAR_COMPRESS
    2937 #  define USAGE_TAR_COMPRESS(a) a
    2938 #else
    2939 #  define USAGE_TAR_COMPRESS(a)
    2940 #endif
     3379       "$ tail -n 1 /etc/resolv.conf\n" \
     3380       "nameserver 10.0.0.1\n"
    29413381
    29423382#define tar_trivial_usage \
    2943     "-[" USAGE_TAR_CREATE("c") USAGE_TAR_GZIP("z") USAGE_TAR_BZIP2("j") USAGE_TAR_LZMA("a") USAGE_TAR_COMPRESS("Z") "xtvO] " \
    2944     USAGE_TAR_EXCLUDE("[-X FILE]") \
    2945     "[-f TARFILE] [-C DIR] [FILE(s)] ..."
     3383       "-[" USE_FEATURE_TAR_CREATE("c") USE_FEATURE_TAR_GZIP("z") \
     3384    USE_FEATURE_TAR_BZIP2("j") USE_FEATURE_TAR_LZMA("a") \
     3385    USE_FEATURE_TAR_COMPRESS("Z") "xtvO] " \
     3386    USE_FEATURE_TAR_FROM("[-X FILE] ") \
     3387       "[-f TARFILE] [-C DIR] [FILE(s)] ..."
    29463388#define tar_full_usage \
    2947     "Create, extract, or list files from a tar file.\n\n" \
    2948     "Options:\n" \
    2949     USAGE_TAR_CREATE("\tc\t\tcreate\n") \
    2950     "\tx\t\textract\n" \
    2951     "\tt\t\tlist\n" \
    2952     "\nArchive format selection:\n" \
    2953     USAGE_TAR_GZIP("\tz\t\tFilter the archive through gzip\n") \
    2954     USAGE_TAR_BZIP2("\tj\t\tFilter the archive through bzip2\n") \
    2955     USAGE_TAR_LZMA("\ta\t\tFilter the archive through lzma\n") \
    2956     USAGE_TAR_COMPRESS("\tZ\t\tFilter the archive through compress\n") \
    2957     "\nFile selection:\n" \
    2958     "\tf\t\tname of TARFILE or \"-\" for stdin\n" \
    2959     "\tO\t\textract to stdout\n" \
    2960     USAGE_TAR_EXCLUDE( \
    2961     "\texclude\t\tfile to exclude\n" \
    2962      "\tX\t\tfile with names to exclude\n" \
    2963     ) \
    2964     "\tC\t\tchange to directory DIR before operation\n" \
    2965     "\tv\t\tverbosely list files processed"
     3389       "Create, extract, or list files from a tar file" \
     3390       "\n\nOptions:\n" \
     3391    USE_FEATURE_TAR_CREATE( \
     3392       "    c   Create\n") \
     3393       "    x   Extract\n" \
     3394       "    t   List\n" \
     3395       "\nArchive format selection:\n" \
     3396    USE_FEATURE_TAR_GZIP( \
     3397       "    z   Filter the archive through gzip\n") \
     3398    USE_FEATURE_TAR_BZIP2( \
     3399       "    j   Filter the archive through bzip2\n") \
     3400    USE_FEATURE_TAR_LZMA( \
     3401       "    a   Filter the archive through lzma\n") \
     3402    USE_FEATURE_TAR_COMPRESS( \
     3403       "    Z   Filter the archive through compress\n") \
     3404       "\nFile selection:\n" \
     3405       "    f   Name of TARFILE or \"-\" for stdin\n" \
     3406       "    O   Extract to stdout\n" \
     3407    USE_FEATURE_TAR_FROM( \
     3408       "    exclude File to exclude\n" \
     3409       "    X   File with names to exclude\n") \
     3410       "    C   Change to directory DIR before operation\n" \
     3411       "    v   Verbose"
    29663412#define tar_example_usage \
    2967     "$ zcat /tmp/tarball.tar.gz | tar -xf -\n" \
    2968     "$ tar -cf /tmp/tarball.tar /usr/local\n"
     3413       "$ zcat /tmp/tarball.tar.gz | tar -xf -\n" \
     3414       "$ tar -cf /tmp/tarball.tar /usr/local\n"
     3415
     3416#define taskset_trivial_usage \
     3417       "[OPTIONS] [mask] [pid | command [arg]...]"
     3418#define taskset_full_usage \
     3419       "Set or get CPU affinity" \
     3420       "\n\nOptions:\n" \
     3421       "    -p  Operate on an existing PID"
     3422#define taskset_example_usage \
     3423       "$ taskset 0x7 ./dgemm_test&\n" \
     3424       "$ taskset -p 0x1 $!\n" \
     3425       "pid 4790's current affinity mask: 7\n" \
     3426       "pid 4790's new affinity mask: 1\n" \
     3427       "$ taskset 0x7 /bin/sh -c './taskset -p 0x1 $$'\n" \
     3428       "pid 6671's current affinity mask: 1\n" \
     3429       "pid 6671's new affinity mask: 1\n" \
     3430       "$ taskset -p 1\n" \
     3431       "pid 1's current affinity mask: 3\n"
    29693432
    29703433#define tee_trivial_usage \
    2971     "[OPTION]... [FILE]..."
     3434       "[OPTION]... [FILE]..."
    29723435#define tee_full_usage \
    2973     "Copy standard input to each FILE, and also to standard output.\n\n" \
    2974     "Options:\n" \
    2975     "\t-a\tappend to the given FILEs, do not overwrite\n" \
    2976     "\t-i\tignore interrupt signals (SIGINT)"
     3436       "Copy standard input to each FILE, and also to standard output" \
     3437       "\n\nOptions:\n" \
     3438       "    -a  Append to the given FILEs, do not overwrite\n" \
     3439       "    -i  Ignore interrupt signals (SIGINT)"
    29773440#define tee_example_usage \
    2978     "$ echo \"Hello\" | tee /tmp/foo\n" \
    2979     "$ cat /tmp/foo\n" \
    2980     "Hello\n"
    2981 
    2982 #ifdef CONFIG_FEATURE_TELNET_AUTOLOGIN
     3441       "$ echo \"Hello\" | tee /tmp/foo\n" \
     3442       "$ cat /tmp/foo\n" \
     3443       "Hello\n"
     3444
     3445#if ENABLE_FEATURE_TELNET_AUTOLOGIN
    29833446#define telnet_trivial_usage \
    2984     "[-a] [-l USER] HOST [PORT]"
     3447       "[-a] [-l USER] HOST [PORT]"
    29853448#define telnet_full_usage \
    2986     "Telnet is used to establish interactive communication with another\n" \
    2987     "computer over a network using the TELNET protocol.\n\n" \
    2988     "Options:\n" \
    2989     "\t-a\t\tAttempt an automatic login with the USER variable\n" \
    2990     "\t-l USER\t\tAttempt an automatic login with the USER argument\n" \
    2991     "\tHOST\t\tThe official name, alias or the IP address of the\n" \
    2992     "\t\t\tremote host.\n" \
    2993     "\tPORT\t\tThe remote port number to connect to.  If it is not\n" \
    2994     "\t\t\tspecified, the default telnet (23) port is used."
     3449       "Connect to remote telnet server" \
     3450       "\n\nOptions:\n" \
     3451       "    -a  Attempt an automatic login with the USER variable\n" \
     3452       "    -l USER Attempt an automatic login with the USER argument\n" \
     3453       "    HOST    The official name, alias or the IP address of the\n" \
     3454       "        remote host\n" \
     3455       "    PORT    The remote port number to connect to. If it is not\n" \
     3456       "        specified, the default telnet (23) port is used."
    29953457#else
    29963458#define telnet_trivial_usage \
    2997     "HOST [PORT]"
     3459       "HOST [PORT]"
    29983460#define telnet_full_usage \
    2999     "Telnet is used to establish interactive communication with another\n" \
    3000     "computer over a network using the TELNET protocol."
     3461       "Connect to remote telnet server"
    30013462#endif
    30023463
    3003 #ifdef CONFIG_FEATURE_TELNETD_INETD
    30043464#define telnetd_trivial_usage \
    3005     "(inetd mode) [OPTION]"
     3465       "[OPTION]"
    30063466#define telnetd_full_usage \
    3007     "Telnetd uses incoming TELNET connections via inetd.\n" \
    3008     "Options:\n" \
    3009     "\t-l LOGIN\texec LOGIN on connect (default /bin/sh)\n" \
    3010     "\t-f issue_file\tDisplay issue_file instead of /etc/issue"
    3011 #else
    3012 #define telnetd_trivial_usage \
    3013     "[OPTION]"
    3014 #define telnetd_full_usage \
    3015     "Telnetd listens for incoming TELNET connections on PORT.\n" \
    3016     "Options:\n" \
    3017     "\t-p PORT\tlisten for connections on PORT (default 23)\n" \
    3018     "\t-l LOGIN\texec LOGIN on connect (default /bin/sh)\n" \
    3019     "\t-f issue_file\tDisplay issue_file instead of /etc/issue"
    3020 #endif
     3467       "Handle incoming telnet connections" \
     3468    SKIP_FEATURE_TELNETD_STANDALONE(" via inetd") \
     3469       "\n\nOptions:" \
     3470       "\n  -l LOGIN    Exec LOGIN on connect" \
     3471       "\n  -f issue_file   Display issue_file instead of /etc/issue" \
     3472    USE_FEATURE_TELNETD_STANDALONE( \
     3473       "\n  -p PORT     Port to listen to" \
     3474       "\n  -b ADDR     Address to bind to" \
     3475       "\n  -F      Stay in foreground" \
     3476       "\n  -i      Run as inetd subservice" \
     3477    )
    30213478
    30223479#define test_trivial_usage \
    3023     "EXPRESSION\n  or   [ EXPRESSION ]"
     3480       "EXPRESSION\n  or   [ EXPRESSION ]"
    30243481#define test_full_usage \
    3025     "Checks file types and compares values returning an exit\n" \
    3026     "code determined by the value of EXPRESSION."
     3482       "Check file types and compares values returning an exit code\n" \
     3483       "determined by the value of EXPRESSION"
    30273484#define test_example_usage \
    3028     "$ test 1 -eq 2\n" \
    3029     "$ echo $?\n" \
    3030     "1\n" \
    3031     "$ test 1 -eq 1\n" \
    3032     "$ echo $?\n" \
    3033     "0\n" \
    3034     "$ [ -d /etc ]\n" \
    3035     "$ echo $?\n" \
    3036     "0\n" \
    3037     "$ [ -d /junk ]\n" \
    3038     "$ echo $?\n" \
    3039     "1\n"
    3040 
    3041 #ifdef CONFIG_FEATURE_TFTP_GET
    3042 #  define USAGE_TFTP_GET(a) a
    3043 #else
    3044 #  define USAGE_TFTP_GET(a)
    3045 #endif
    3046 #ifdef CONFIG_FEATURE_TFTP_PUT
    3047 #  define USAGE_TFTP_PUT(a) a
    3048 #else
    3049 #  define USAGE_TFTP_PUT(a)
    3050 #endif
    3051 #ifdef CONFIG_FEATURE_TFTP_BLOCKSIZE
    3052 #  define USAGE_TFTP_BS(a) a
    3053 #else
    3054 #  define USAGE_TFTP_BS(a)
    3055 #endif
     3485       "$ test 1 -eq 2\n" \
     3486       "$ echo $?\n" \
     3487       "1\n" \
     3488       "$ test 1 -eq 1\n" \
     3489       "$ echo $?\n" \
     3490       "0\n" \
     3491       "$ [ -d /etc ]\n" \
     3492       "$ echo $?\n" \
     3493       "0\n" \
     3494       "$ [ -d /junk ]\n" \
     3495       "$ echo $?\n" \
     3496       "1\n"
     3497
     3498#define tcpsvd_trivial_usage \
     3499       "[-hEv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] ip port prog..."
     3500/* with not-implemented options: */
     3501/*     "[-hpEvv] [-c n] [-C n:msg] [-b n] [-u user] [-l name] [-i dir|-x cdb] [-t sec] ip port prog..." */
     3502#define tcpsvd_full_usage \
     3503       "Creates TCP socket, binds it to ip:port and listens on it\n" \
     3504       "for incoming connections. For each connection it runs prog." \
     3505     "\n" \
     3506     "\nip      IP to listen on. '0' = all" \
     3507     "\nport        Port to listen on" \
     3508     "\nprog [arg]  Program to run" \
     3509     "\n-l name     Local hostname (else looks up local hostname in DNS)" \
     3510     "\n-u user[:group] Change to user/group after bind" \
     3511     "\n-c n        Handle up to n connections simultaneously" \
     3512     "\n-b n        Allow a backlog of approximately n TCP SYNs" \
     3513     "\n-C n[:msg]  Allow only up to n connections from the same IP" \
     3514     "\n        New connections from this IP address are closed" \
     3515     "\n        immediately. 'msg' is written to the peer before close" \
     3516     "\n-h      Look up peer's hostname" \
     3517     "\n-E      Do not set up environment variables" \
     3518     "\n-v      Verbose"
     3519
     3520#define udpsvd_trivial_usage \
     3521       "[-hEv] [-c n] [-u user] [-l name] ip port prog"
     3522#define udpsvd_full_usage \
     3523       "Creates UDP socket, binds it to ip:port and listens on it\n" \
     3524       "for incoming packets. For each packet it runs prog\n" \
     3525       "(redirecting all further packets with same peer ip:port to it)." \
     3526     "\n" \
     3527     "\nip      IP to listen on. '0' = all" \
     3528     "\nport        Port to listen on" \
     3529     "\nprog [arg]  Program to run" \
     3530     "\n-l name     Local hostname (else looks up local hostname in DNS)" \
     3531     "\n-u user[:group] Change to user/group after bind" \
     3532     "\n-c n        Handle up to n connections simultaneously" \
     3533     "\n-h      Look up peer's hostname" \
     3534     "\n-E      Do not set up environment variables" \
     3535     "\n-v      Verbose"
    30563536
    30573537#define tftp_trivial_usage \
    3058     "[OPTION]... HOST [PORT]"
     3538       "[OPTION]... HOST [PORT]"
    30593539#define tftp_full_usage \
    3060     "Transfers a file from/to a tftp server using \"octet\" mode.\n\n" \
    3061     "Options:\n" \
    3062     "\t-l FILE\tLocal FILE\n" \
    3063     "\t-r FILE\tRemote FILE" \
    3064     USAGE_TFTP_GET( \
    3065     "\n\t-g\tGet file" \
     3540       "Transfer a file from/to tftp server using \"octet\" mode" \
     3541       "\n\nOptions:" \
     3542       "\n  -l FILE Local FILE" \
     3543       "\n  -r FILE Remote FILE" \
     3544    USE_FEATURE_TFTP_GET( \
     3545       "\n  -g  Get file" \
    30663546    ) \
    3067     USAGE_TFTP_PUT( \
    3068     "\n\t-p\tPut file" \
     3547    USE_FEATURE_TFTP_PUT( \
     3548       "\n  -p  Put file" \
    30693549    ) \
    3070     USAGE_TFTP_BS( \
    3071     "\n\t-b SIZE\tTransfer blocks of SIZE octets" \
     3550    USE_FEATURE_TFTP_BLOCKSIZE( \
     3551       "\n  -b SIZE Transfer blocks of SIZE octets" \
    30723552    )
    30733553#define time_trivial_usage \
    3074     "[OPTION]... COMMAND [ARGS...]"
     3554       "[OPTION]... COMMAND [ARGS...]"
    30753555#define time_full_usage \
    3076     "Runs the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \
    3077     "COMMAND's resource usage information is displayed\n\n" \
    3078     "Options:\n" \
    3079     "\t-v\tDisplays verbose resource usage information"
     3556       "Run the program COMMAND with arguments ARGS. When COMMAND finishes,\n" \
     3557       "COMMAND's resource usage information is displayed." \
     3558       "\n\nOptions:\n" \
     3559       "    -v  Verbose"
    30803560
    30813561#define top_trivial_usage \
    3082     "[-d <seconds>]"
     3562       "[-b] [-n count] [-d seconds]"
    30833563#define top_full_usage \
    3084     "top provides an view of processor activity in real time.\n" \
    3085     "This utility reads the status for all processes in /proc each <seconds>\n" \
    3086     "and shows the status for however many processes will fit on the screen.\n" \
    3087     "This utility will not show processes that are started after program startup,\n" \
    3088     "but it will show the EXIT status for and PIDs that exit while it is running."
     3564       "Provide a view of process activity in real time.\n" \
     3565       "Read the status of all processes from /proc each <seconds>\n" \
     3566       "and show the status for however many processes will fit on the screen."
    30893567
    30903568#define touch_trivial_usage \
    3091     "[-c] FILE [FILE ...]"
     3569       "[-c] FILE [FILE ...]"
    30923570#define touch_full_usage \
    3093     "Update the last-modified date on the given FILE[s].\n\n" \
    3094     "Options:\n" \
    3095     "\t-c\tDo not create any files"
     3571       "Update the last-modified date on the given FILE[s]" \
     3572       "\n\nOptions:\n" \
     3573       "    -c  Do not create any files"
    30963574#define touch_example_usage \
    3097     "$ ls -l /tmp/foo\n" \
    3098     "/bin/ls: /tmp/foo: No such file or directory\n" \
    3099     "$ touch /tmp/foo\n" \
    3100     "$ ls -l /tmp/foo\n" \
    3101     "-rw-rw-r--    1 andersen andersen        0 Apr 15 01:11 /tmp/foo\n"
     3575       "$ ls -l /tmp/foo\n" \
     3576       "/bin/ls: /tmp/foo: No such file or directory\n" \
     3577       "$ touch /tmp/foo\n" \
     3578       "$ ls -l /tmp/foo\n" \
     3579       "-rw-rw-r--    1 andersen andersen        0 Apr 15 01:11 /tmp/foo\n"
    31023580
    31033581#define tr_trivial_usage \
    3104     "[-cds] STRING1 [STRING2]"
     3582       "[-cds] STRING1 [STRING2]"
    31053583#define tr_full_usage \
    3106     "Translate, squeeze, and/or delete characters from\n" \
    3107     "standard input, writing to standard output.\n\n" \
    3108     "Options:\n" \
    3109     "\t-c\ttake complement of STRING1\n" \
    3110     "\t-d\tdelete input characters coded STRING1\n" \
    3111     "\t-s\tsqueeze multiple output characters of STRING2 into one character"
     3584       "Translate, squeeze, and/or delete characters from\n" \
     3585       "standard input, writing to standard output" \
     3586       "\n\nOptions:\n" \
     3587       "    -c  Take complement of STRING1\n" \
     3588       "    -d  Delete input characters coded STRING1\n" \
     3589       "    -s  Squeeze multiple output characters of STRING2 into one character"
    31123590#define tr_example_usage \
    3113     "$ echo \"gdkkn vnqkc\" | tr [a-y] [b-z]\n" \
    3114     "hello world\n"
     3591       "$ echo \"gdkkn vnqkc\" | tr [a-y] [b-z]\n" \
     3592       "hello world\n"
    31153593
    31163594#define traceroute_trivial_usage \
    3117     "[-FIldnrv] [-f 1st_ttl] [-m max_ttl] [-p port#] [-q nqueries]\n" \
    3118     "\t[-s src_addr] [-t tos] [-w wait] [-g gateway] [-i iface]\n" \
    3119     "\t[-z pausemsecs] host [data size]"
     3595       "[-FIldnrv] [-f 1st_ttl] [-m max_ttl] [-p port#] [-q nqueries]\n" \
     3596       "    [-s src_addr] [-t tos] [-w wait] [-g gateway] [-i iface]\n" \
     3597       "    [-z pausemsecs] host [data size]"
    31203598#define traceroute_full_usage \
    3121     "trace the route ip packets follow going to \"host\"\n" \
    3122     "Options:\n" \
    3123     "\t-F\tSet the don't fragment bit\n" \
    3124     "\t-I\tUse ICMP ECHO instead of UDP datagrams\n" \
    3125     "\t-l\tDisplay the ttl value of the returned packet\n" \
    3126     "\t-d\tSet SO_DEBUG options to socket\n" \
    3127     "\t-n\tPrint hop addresses numerically rather than symbolically\n" \
    3128     "\t-r\tBypass the normal routing tables and send directly to a host\n" \
    3129     "\t-v\tVerbose output\n" \
    3130     "\t-m max_ttl\tSet the max time-to-live (max number of hops)\n" \
    3131     "\t-p port#\tSet the base UDP port number used in probes\n" \
    3132     "\t\t(default is 33434)\n" \
    3133     "\t-q nqueries\tSet the number of probes per ``ttl'' to nqueries\n" \
    3134     "\t\t(default is 3)\n" \
    3135     "\t-s src_addr\tUse the following IP address as the source address\n" \
    3136     "\t-t tos\tSet the type-of-service in probe packets to the following value\n" \
    3137     "\t\t(default 0)\n" \
    3138     "\t-w wait\tSet the time (in seconds) to wait for a response to a probe\n" \
    3139     "\t\t(default 3 sec)\n" \
    3140     "\t-g\tSpecify a loose source route gateway (8 maximum)"
     3599       "Trace the route ip packets follow going to \"host\"" \
     3600       "\n\nOptions:\n" \
     3601       "    -F  Set the don't fragment bit\n" \
     3602       "    -I  Use ICMP ECHO instead of UDP datagrams\n" \
     3603       "    -l  Display the ttl value of the returned packet\n" \
     3604       "    -d  Set SO_DEBUG options to socket\n" \
     3605       "    -n  Print hop addresses numerically rather than symbolically\n" \
     3606       "    -r  Bypass the normal routing tables and send directly to a host\n" \
     3607       "    -v  Verbose\n" \
     3608       "    -m max_ttl  Max time-to-live (max number of hops)\n" \
     3609       "    -p port#    Base UDP port number used in probes\n" \
     3610       "            (default is 33434)\n" \
     3611       "    -q nqueries Number of probes per 'ttl' (default 3)\n" \
     3612       "    -s src_addr IP address to use as the source address\n" \
     3613       "    -t tos      Type-of-service in probe packets (default 0)\n" \
     3614       "    -w wait     Time in seconds to wait for a response to a probe\n" \
     3615       "            (default 3 sec)\n" \
     3616       "    -g      Specify a loose source route gateway (8 max)"
    31413617
    31423618
    31433619#define true_trivial_usage \
    3144     ""
     3620       ""
    31453621#define true_full_usage \
    3146     "Return an exit code of TRUE (0)."
     3622       "Return an exit code of TRUE (0)"
    31473623#define true_example_usage \
    3148     "$ true\n" \
    3149     "$ echo $?\n" \
    3150     "0\n"
     3624       "$ true\n" \
     3625       "$ echo $?\n" \
     3626       "0\n"
    31513627
    31523628#define tty_trivial_usage \
    3153     ""
     3629       ""
    31543630#define tty_full_usage \
    3155     "Print the file name of the terminal connected to standard input.\n\n" \
    3156     "Options:\n" \
    3157     "\t-s\tprint nothing, only return an exit status"
     3631       "Print file name of standard input's terminal" \
     3632    USE_INCLUDE_SUSv2( \
     3633       "\n\nOptions:\n" \
     3634       "    -s  Print nothing, only return exit status")
    31583635#define tty_example_usage \
    3159     "$ tty\n" \
    3160     "/dev/tty2\n"
     3636       "$ tty\n" \
     3637       "/dev/tty2\n"
     3638
     3639#define ttysize_trivial_usage \
     3640       "[w] [h]"
     3641#define ttysize_full_usage \
     3642       "Print dimension(s) of standard input's terminal, on error return 80x25"
    31613643
    31623644#define tune2fs_trivial_usage \
    3163     "[-c max-mounts-count] [-e errors-behavior] [-g group] " \
    3164     "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " \
    3165     "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " \
    3166     "[-r reserved-blocks-count] [-u user] [-C mount-count] " \
    3167     "[-L volume-label] [-M last-mounted-dir] [-O [^]feature[,...]] " \
    3168     "[-T last-check-time] [-U UUID] device"
     3645       "[-c max-mounts-count] [-e errors-behavior] [-g group] " \
     3646       "[-i interval[d|m|w]] [-j] [-J journal-options] [-l] [-s sparse-flag] " \
     3647       "[-m reserved-blocks-percent] [-o [^]mount-options[,...]] " \
     3648       "[-r reserved-blocks-count] [-u user] [-C mount-count] " \
     3649       "[-L volume-label] [-M last-mounted-dir] [-O [^]feature[,...]] " \
     3650       "[-T last-check-time] [-U UUID] device"
    31693651#define tune2fs_full_usage \
    3170     "Adjust filesystem options on ext[23] filesystems."
     3652       "Adjust filesystem options on ext[23] filesystems"
    31713653
    31723654#define udhcpc_trivial_usage \
    3173     "[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n[-p pidfile] [-r IP] [-s script]"
     3655       "[-Cfbnqtv] [-c CID] [-V VCLS] [-H HOSTNAME] [-i INTERFACE]\n" \
     3656       "    [-p pidfile] [-r IP] [-s script]"
    31743657#define udhcpc_full_usage \
    3175     "\t-c,\t--clientid=CLIENTID\tSet client identifier\n" \
    3176     "\t-C,\t--clientid-none\tSuppress default client identifier\n" \
    3177     "\t-V,\t--vendorclass=CLASSID\tSet vendor class identifier\n" \
    3178     "\t-H,\t--hostname=HOSTNAME\tClient hostname\n" \
    3179     "\t-h,\t                   \tAlias for -H\n" \
    3180     "\t-f,\t--foreground\tDo not fork after getting lease\n" \
    3181     "\t-b,\t--background\tFork to background if lease cannot be immediately negotiated\n" \
    3182     "\t-i,\t--interface=INTERFACE\tInterface to use (default: eth0)\n" \
    3183     "\t-n,\t--now\tExit with failure if lease cannot be immediately negotiated\n" \
    3184     "\t-p,\t--pidfile=file\tStore process ID of daemon in file\n" \
    3185     "\t-q,\t--quit\tQuit after obtaining lease\n" \
    3186     "\t-r,\t--request=IP\tIP address to request (default: none)\n" \
    3187     "\t-s,\t--script=file\tRun file at dhcp events (default: /usr/share/udhcpc/default.script)\n" \
    3188     "\t-t,\t--retries=NUM\tSend up to NUM request packets\n"\
    3189     "\t-v,\t--version\tDisplay version"
     3658       "    -V,--vendorclass=CLASSID    Set vendor class identifier" \
     3659       "\n  -i,--interface=INTERFACE    Interface to use (default: eth0)" \
     3660       "\n  -H,-h,--hostname=HOSTNAME   Client hostname" \
     3661       "\n  -c,--clientid=CLIENTID  Set client identifier" \
     3662       "\n  -C,--clientid-none  Suppress default client identifier" \
     3663       "\n  -p,--pidfile=file   Store process ID of daemon in file" \
     3664       "\n  -r,--request=IP     IP address to request" \
     3665       "\n  -s,--script=file    Run file at dhcp events (default: /usr/share/udhcpc/default.script)" \
     3666       "\n  -t,--retries=N      Send up to N request packets"\
     3667       "\n  -f,--foreground Stay in foreground" \
     3668       "\n  -b,--background Background if lease cannot be immediately negotiated" \
     3669       "\n  -S,--syslog Log to syslog too" \
     3670       "\n  -n,--now    Exit with failure if lease cannot be immediately negotiated" \
     3671       "\n  -q,--quit   Quit after obtaining lease" \
     3672       "\n  -R,--release    Release IP on quit" \
     3673       "\n  -v,--version    Display version" \
    31903674
    31913675#define udhcpd_trivial_usage \
    3192     "[configfile]\n" \
     3676       "[-fS] [configfile]" \
    31933677
    31943678#define udhcpd_full_usage \
    3195     ""
    3196 
    3197 #ifdef CONFIG_FEATURE_MOUNT_FORCE
    3198 #  define USAGE_MOUNT_FORCE(a) a
    3199 #else
    3200 #  define USAGE_MOUNT_FORCE(a)
    3201 #endif
     3679       "DHCP server" \
     3680       "\n  -f  Stay in foreground" \
     3681       "\n  -S  Log to syslog too"
     3682
    32023683#define umount_trivial_usage \
    3203     "[flags] FILESYSTEM|DIRECTORY"
     3684       "[flags] FILESYSTEM|DIRECTORY"
    32043685#define umount_full_usage \
    3205     "Unmount file systems\n" \
    3206     "\nFlags:\n" "\t-a\tUnmount all file systems" \
    3207     USAGE_MTAB(" in /etc/mtab\n\t-n\tDon't erase /etc/mtab entries") \
    3208     "\n\t-r\tTry to remount devices as read-only if mount is busy" \
    3209     "\n\t-l\tLazy umount (detach filesystem)" \
    3210     "\n\t-f\tForce umount (i.e., unreachable NFS server)" \
    3211     USAGE_MOUNT_LOOP("\n\t-D\tDo not free loop device (if a loop device has been used)")
     3686       "Unmount file systems" \
     3687       "\n\nOptions:\n" \
     3688    USE_FEATURE_UMOUNT_ALL( \
     3689       "\n  -a  Unmount all file systems" USE_FEATURE_MTAB_SUPPORT(" in /etc/mtab")) \
     3690    USE_FEATURE_MTAB_SUPPORT( \
     3691       "\n  -n  Don't erase /etc/mtab entries") \
     3692       "\n  -r  Try to remount devices as read-only if mount is busy" \
     3693       "\n  -l  Lazy umount (detach filesystem)" \
     3694       "\n  -f  Force umount (i.e., unreachable NFS server)" \
     3695    USE_FEATURE_MOUNT_LOOP( \
     3696       "\n  -D  Do not free loop device (if a loop device has been used)")
    32123697#define umount_example_usage \
    3213     "$ umount /dev/hdc1 \n"
     3698       "$ umount /dev/hdc1\n"
    32143699
    32153700#define uname_trivial_usage \
    3216     "[OPTION]..."
     3701       "[OPTION]..."
    32173702#define uname_full_usage \
    3218     "Print certain system information.  With no OPTION, same as -s.\n\n" \
    3219     "Options:\n" \
    3220     "\t-a\tprint all information\n" \
    3221     "\t-m\tthe machine (hardware) type\n" \
    3222     "\t-n\tprint the machine's network node hostname\n" \
    3223     "\t-r\tprint the operating system release\n" \
    3224     "\t-s\tprint the operating system name\n" \
    3225     "\t-p\tprint the host processor type\n" \
    3226     "\t-v\tprint the operating system version"
     3703       "Print certain system information. With no OPTION, same as -s." \
     3704       "\n\nOptions:\n" \
     3705       "    -a  Print all information\n" \
     3706       "    -m  The machine (hardware) type\n" \
     3707       "    -n  Print the machine's network node hostname\n" \
     3708       "    -r  Print the operating system release\n" \
     3709       "    -s  Print the operating system name\n" \
     3710       "    -p  Print the host processor type\n" \
     3711       "    -v  Print the operating system version"
    32273712#define uname_example_usage \
    3228     "$ uname -a\n" \
    3229     "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n"
     3713       "$ uname -a\n" \
     3714       "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n"
    32303715
    32313716#define uncompress_trivial_usage \
    3232     "[-c] [-f] [ name ... ]"
     3717       "[-c] [-f] [name...]"
    32333718#define uncompress_full_usage \
    3234     "Uncompress .Z file[s]\n" \
    3235     "Options:\n" \
    3236     "\t-c\textract to stdout\n" \
    3237     "\t-f\tforce overwrite an existing file"
     3719       "Uncompress .Z file[s]" \
     3720       "\n\nOptions:\n" \
     3721       "    -c  Extract to stdout\n" \
     3722       "    -f  Force overwrite an existing file"
     3723
     3724#define unexpand_trivial_usage \
     3725       "[-f][-a][-t NUM] [FILE|-]"
     3726#define unexpand_full_usage \
     3727       "Convert spaces to tabs, writing to standard output." \
     3728       "\n\nOptions:" \
     3729       "\n  -a" USE_FEATURE_UNEXPAND_LONG_OPTIONS(",--all") \
     3730       "    Convert all blanks" \
     3731       "\n  -f" USE_FEATURE_UNEXPAND_LONG_OPTIONS(",--first-only") \
     3732       "    Convert only leading sequences of blanks" \
     3733       "\n  -t" USE_FEATURE_UNEXPAND_LONG_OPTIONS(",--tabs=N") \
     3734       "    Tabstops every N chars"
    32383735
    32393736#define uniq_trivial_usage \
    3240     "[-fscdu]... [INPUT [OUTPUT]]"
     3737       "[-fscdu]... [INPUT [OUTPUT]]"
    32413738#define uniq_full_usage \
    3242     "Discard all but one of successive identical lines from INPUT\n" \
    3243     "(or standard input), writing to OUTPUT (or standard output).\n\n" \
    3244     "Options:\n" \
    3245     "\t-c\tprefix lines by the number of occurrences\n" \
    3246     "\t-d\tonly print duplicate lines\n" \
    3247     "\t-u\tonly print unique lines\n" \
    3248     "\t-f N\tskip the first N fields\n" \
    3249     "\t-s N\tskip the first N chars (after any skipped fields)"
     3739       "Discard all but one of successive identical lines from INPUT\n" \
     3740       "(or standard input), writing to OUTPUT (or standard output)" \
     3741       "\n\nOptions:\n" \
     3742       "    -c  Prefix lines by the number of occurrences\n" \
     3743       "    -d  Only print duplicate lines\n" \
     3744       "    -u  Only print unique lines\n" \
     3745       "    -f N    Skip the first N fields\n" \
     3746       "    -s N    Skip the first N chars (after any skipped fields)"
    32503747#define uniq_example_usage \
    3251     "$ echo -e \"a\\na\\nb\\nc\\nc\\na\" | sort | uniq\n" \
    3252     "a\n" \
    3253     "b\n" \
    3254     "c\n"
     3748       "$ echo -e \"a\\na\\nb\\nc\\nc\\na\" | sort | uniq\n" \
     3749       "a\n" \
     3750       "b\n" \
     3751       "c\n"
    32553752
    32563753#define unix2dos_trivial_usage \
    3257     "[option] [FILE]"
     3754       "[option] [FILE]"
    32583755#define unix2dos_full_usage \
    3259     "Converts FILE from unix format to dos format. When no option\n" \
    3260     "is given, the input is converted to the opposite output format.\n" \
    3261     "When no file is given, uses stdin for input and stdout for output.\n" \
    3262     "Options:\n" \
    3263     "\t-u\toutput will be in UNIX format\n" \
    3264     "\t-d\toutput will be in DOS format"
     3756       "Convert FILE from unix format to dos format. When no option\n" \
     3757       "is given, the input is converted to the opposite output format.\n" \
     3758       "When no file is given, use stdin/stdout." \
     3759       "\n\nOptions:\n" \
     3760       "    -u  Output will be in UNIX format\n" \
     3761       "    -d  Output will be in DOS format"
    32653762
    32663763#define unzip_trivial_usage \
    3267     "[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]"
     3764       "[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]"
    32683765#define unzip_full_usage \
    3269     "Extracts files from ZIP archives.\n\n" \
    3270     "Options:\n" \
    3271     "\t-l\tlist archive contents (short form)\n" \
    3272     "\t-n\tnever overwrite existing files (default)\n" \
    3273     "\t-o\toverwrite files without prompting\n" \
    3274     "\t-p\tsend output to stdout\n" \
    3275     "\t-q\tbe quiet\n" \
    3276     "\t-x\texclude these files\n" \
    3277     "\t-d\textract files into this directory"
     3766       "Extract files from ZIP archives" \
     3767       "\n\nOptions:\n" \
     3768       "    -l  List archive contents (short form)\n" \
     3769       "    -n  Never overwrite existing files (default)\n" \
     3770       "    -o  Overwrite files without prompting\n" \
     3771       "    -p  Send output to stdout\n" \
     3772       "    -q  Quiet\n" \
     3773       "    -x  Exclude these files\n" \
     3774       "    -d  Extract files into this directory"
    32783775
    32793776#define uptime_trivial_usage \
    3280     ""
     3777       ""
    32813778#define uptime_full_usage \
    3282     "Display the time since the last boot."
     3779       "Display the time since the last boot"
    32833780#define uptime_example_usage \
    3284     "$ uptime\n" \
    3285     "  1:55pm  up  2:30, load average: 0.09, 0.04, 0.00\n"
     3781       "$ uptime\n" \
     3782       "  1:55pm  up  2:30, load average: 0.09, 0.04, 0.00\n"
    32863783
    32873784#define usleep_trivial_usage \
    3288     "N"
     3785       "N"
    32893786#define usleep_full_usage \
    3290     "Pause for N microseconds."
     3787       "Pause for N microseconds"
    32913788#define usleep_example_usage \
    3292     "$ usleep 1000000\n" \
    3293     "[pauses for 1 second]\n"
     3789       "$ usleep 1000000\n" \
     3790       "[pauses for 1 second]\n"
    32943791
    32953792#define uudecode_trivial_usage \
    3296     "[FILE]..."
     3793       "[-o outfile] [infile]"
    32973794#define uudecode_full_usage \
    3298     "Uudecode a file that is uuencoded.\n\n" \
    3299     "Options:\n" \
    3300     "\t-o FILE\tdirect output to FILE"
     3795       "Uudecode a file\n" \
     3796       "NB: finds outfile name in uuencoded source unless -o is given"
    33013797#define uudecode_example_usage \
    3302     "$ uudecode -o busybox busybox.uu\n" \
    3303     "$ ls -l busybox\n" \
    3304     "-rwxr-xr-x   1 ams      ams        245264 Jun  7 21:35 busybox\n"
     3798       "$ uudecode -o busybox busybox.uu\n" \
     3799       "$ ls -l busybox\n" \
     3800       "-rwxr-xr-x   1 ams      ams        245264 Jun  7 21:35 busybox\n"
    33053801
    33063802#define uuencode_trivial_usage \
    3307     "[OPTION] [INFILE] REMOTEFILE"
     3803       "[-m] [infile] stored_filename"
    33083804#define uuencode_full_usage \
    3309     "Uuencode a file.\n\n" \
    3310     "Options:\n" \
    3311     "\t-m\tuse base64 encoding per RFC1521"
     3805       "Uuencode a file to stdout" \
     3806       "\n\nOptions:\n" \
     3807       "    -m  Use base64 encoding per RFC1521"
    33123808#define uuencode_example_usage \
    3313     "$ uuencode busybox busybox\n" \
    3314     "begin 755 busybox\n" \
    3315     "<encoded file snipped>\n" \
    3316     "$ uudecode busybox busybox > busybox.uu\n" \
    3317     "$\n"
     3809       "$ uuencode busybox busybox\n" \
     3810       "begin 755 busybox\n" \
     3811       "<encoded file snipped>\n" \
     3812       "$ uudecode busybox busybox > busybox.uu\n" \
     3813       "$\n"
    33183814
    33193815#define vconfig_trivial_usage \
    3320     "COMMAND [OPTIONS] ..."
     3816       "COMMAND [OPTIONS] ..."
    33213817#define vconfig_full_usage \
    3322     "vconfig lets you create and remove virtual ethernet devices.\n\n" \
    3323     "Options:\n" \
    3324     "\tadd             [interface-name] [vlan_id]\n" \
    3325     "\trem             [vlan-name]\n" \
    3326     "\tset_flag        [interface-name] [flag-num]      [0 | 1]\n" \
    3327     "\tset_egress_map  [vlan-name]      [skb_priority]  [vlan_qos]\n" \
    3328     "\tset_ingress_map [vlan-name]      [skb_priority]  [vlan_qos]\n" \
    3329     "\tset_name_type   [name-type]"
     3818       "Create and remove virtual ethernet devices" \
     3819       "\n\nOptions:\n" \
     3820       "    add     [interface-name] [vlan_id]\n" \
     3821       "    rem     [vlan-name]\n" \
     3822       "    set_flag    [interface-name] [flag-num] [0 | 1]\n" \
     3823       "    set_egress_map  [vlan-name] [skb_priority] [vlan_qos]\n" \
     3824       "    set_ingress_map [vlan-name] [skb_priority] [vlan_qos]\n" \
     3825       "    set_name_type   [name-type]"
    33303826
    33313827#define vi_trivial_usage \
    3332     "[OPTION] [FILE]..."
     3828       "[OPTION] [FILE]..."
    33333829#define vi_full_usage \
    3334     "edit FILE.\n\n" \
    3335     "Options:\n" \
    3336     "\t-R\tRead-only- do not write to the file"
     3830       "Edit FILE" \
     3831       "\n\nOptions:\n" \
     3832       "    -R  Read-only - do not write to the file"
    33373833
    33383834#define vlock_trivial_usage \
    3339     "[OPTIONS]"
     3835       "[OPTIONS]"
    33403836#define vlock_full_usage \
    3341     "Lock a virtual terminal.  A password is required to unlock\n" \
    3342     "Options:\n" \
    3343     "\t-a\tLock all VTs"
     3837       "Lock a virtual terminal. A password is required to unlock." \
     3838       "\n\nOptions:\n" \
     3839       "    -a  Lock all VTs"
    33443840
    33453841#define watch_trivial_usage \
    3346     "[-n <seconds>] COMMAND..."
     3842       "[-n seconds] [-t] COMMAND..."
    33473843#define watch_full_usage \
    3348     "Executes a program periodically.\n" \
    3349     "Options:\n" \
    3350     "\t-n\tLoop period in seconds - default is 2"
     3844       "Execute a program periodically" \
     3845       "\n\nOptions:\n" \
     3846       "    -n  Loop period in seconds - default is 2\n" \
     3847       "    -t  Don't print header"
    33513848#define watch_example_usage \
    3352     "$ watch date\n" \
    3353     "Mon Dec 17 10:31:40 GMT 2000\n" \
    3354     "Mon Dec 17 10:31:42 GMT 2000\n" \
    3355     "Mon Dec 17 10:31:44 GMT 2000"
     3849       "$ watch date\n" \
     3850       "Mon Dec 17 10:31:40 GMT 2000\n" \
     3851       "Mon Dec 17 10:31:42 GMT 2000\n" \
     3852       "Mon Dec 17 10:31:44 GMT 2000"
    33563853
    33573854#define watchdog_trivial_usage \
    3358     "[-t <seconds>] [-F] DEV"
     3855       "[-t seconds] [-F] DEV"
    33593856#define watchdog_full_usage \
    3360     "Periodically write to watchdog device DEV.\n" \
    3361     "Options:\n" \
    3362     "\t-t\tTimer period in seconds - default is 30\n" \
    3363     "\t-F\tStay in the foreground and don't fork"
     3857       "Periodically write to watchdog device DEV" \
     3858       "\n\nOptions:\n" \
     3859       "    -t  Timer period in seconds - default is 30\n" \
     3860       "    -F  Stay in the foreground and don't fork"
    33643861
    33653862#define wc_trivial_usage \
    3366     "[OPTION]... [FILE]..."
     3863       "[OPTION]... [FILE]..."
    33673864#define wc_full_usage \
    3368     "Print line, word, and byte counts for each FILE, and a total line if\n" \
    3369     "more than one FILE is specified.  With no FILE, read standard input.\n\n" \
    3370     "Options:\n" \
    3371     "\t-c\tprint the byte counts\n" \
    3372     "\t-l\tprint the newline counts\n" \
    3373     "\t-L\tprint the length of the longest line\n" \
    3374     "\t-w\tprint the word counts"
     3865       "Print line, word, and byte counts for each FILE, and a total line if\n" \
     3866       "more than one FILE is specified. With no FILE, read standard input." \
     3867       "\n\nOptions:\n" \
     3868       "    -c  Print the byte counts\n" \
     3869       "    -l  Print the newline counts\n" \
     3870       "    -L  Print the length of the longest line\n" \
     3871       "    -w  Print the word counts"
    33753872#define wc_example_usage \
    3376     "$ wc /etc/passwd\n" \
    3377     "     31      46    1365 /etc/passwd\n"
     3873       "$ wc /etc/passwd\n" \
     3874       "     31      46    1365 /etc/passwd\n"
    33783875
    33793876#define wget_trivial_usage \
    3380     "[-c|--continue] [-q|--quiet] [-O|--output-document file]\n" \
    3381     "\t\t[--header 'header: value'] [-Y|--proxy on/off] [-P DIR] url"
     3877       "[-c|--continue] [-s|--spider] [-q|--quiet] [-O|--output-document file]\n" \
     3878       "        [--header 'header: value'] [-Y|--proxy on/off] [-P DIR]\n" \
     3879       "        [-U|--user-agent agent] url"
    33823880#define wget_full_usage \
    3383     "wget retrieves files via HTTP or FTP\n\n" \
    3384     "Options:\n" \
    3385     "\t-c\tcontinue retrieval of aborted transfers\n" \
    3386     "\t-q\tquiet mode - do not print\n" \
    3387     "\t-P\tSet directory prefix to DIR\n" \
    3388     "\t-O\tsave to filename ('-' for stdout)\n" \
    3389     "\t-Y\tuse proxy ('on' or 'off')"
     3881       "Retrieve files via HTTP or FTP" \
     3882       "\n\nOptions:\n" \
     3883       "    -s  Spider mode - only check file existence\n" \
     3884       "    -c  Continue retrieval of aborted transfer\n" \
     3885       "    -q  Quiet\n" \
     3886       "    -P  Set directory prefix to DIR\n" \
     3887       "    -O  Save to filename ('-' for stdout)\n" \
     3888       "    -U  Adjust 'User-Agent' field\n" \
     3889       "    -Y  Use proxy ('on' or 'off')"
    33903890
    33913891#define which_trivial_usage \
    3392     "[COMMAND ...]"
     3892       "[COMMAND ...]"
    33933893#define which_full_usage \
    3394     "Locates a COMMAND."
     3894       "Locate a COMMAND"
    33953895#define which_example_usage \
    3396     "$ which login\n" \
    3397     "/bin/login\n"
     3896       "$ which login\n" \
     3897       "/bin/login\n"
    33983898
    33993899#define who_trivial_usage \
    3400     " "
     3900       " "
    34013901#define who_full_usage \
    3402     "Prints the current user names and related information"
     3902       "Print the current user names and related information"
    34033903
    34043904#define whoami_trivial_usage \
    3405     ""
     3905       ""
    34063906#define whoami_full_usage \
    3407     "Prints the user name associated with the current effective user id."
    3408 
    3409 #ifdef CONFIG_FEATURE_XARGS_SUPPORT_CONFIRMATION
    3410 #define USAGE_XARGS_CONFIRMATION(a) a
    3411 #else
    3412 #define USAGE_XARGS_CONFIRMATION(a)
    3413 #endif
    3414 #ifdef CONFIG_FEATURE_XARGS_SUPPORT_TERMOPT
    3415 #define USAGE_XARGS_TERMOPT(a) a
    3416 #else
    3417 #define USAGE_XARGS_TERMOPT(a)
    3418 #endif
    3419 #ifdef CONFIG_FEATURE_XARGS_SUPPORT_ZERO_TERM
    3420 #define USAGE_XARGS_ZERO_TERM(a) a
    3421 #else
    3422 #define USAGE_XARGS_ZERO_TERM(a)
    3423 #endif
    3424 
     3907       "Print the user name associated with the current effective user id"
    34253908
    34263909#define xargs_trivial_usage \
    3427     "[COMMAND] [OPTIONS] [ARGS...]"
     3910       "[OPTIONS] [COMMAND] [ARGS...]"
    34283911#define xargs_full_usage \
    3429     "Executes COMMAND on every item given by standard input.\n\n" \
    3430     "Options:\n" \
    3431     USAGE_XARGS_CONFIRMATION("\t-p\tPrompt the user about whether to run each command\n") \
    3432     "\t-r\tDo not run command for empty read lines\n" \
    3433     USAGE_XARGS_TERMOPT("\t-x\tExit if the size is exceeded\n") \
    3434     USAGE_XARGS_ZERO_TERM("\t-0\tInput filenames are terminated by a null character\n") \
    3435     "\t-t\tPrint the command line on stderr before executing it"
     3912       "Execute COMMAND on every item given by standard input" \
     3913       "\n\nOptions:\n" \
     3914    USE_FEATURE_XARGS_SUPPORT_CONFIRMATION( \
     3915       "    -p  Prompt the user about whether to run each command\n") \
     3916       "    -r  Do not run command for empty read lines\n" \
     3917    USE_FEATURE_XARGS_SUPPORT_TERMOPT( \
     3918       "    -x  Exit if the size is exceeded\n") \
     3919    USE_FEATURE_XARGS_SUPPORT_ZERO_TERM( \
     3920       "    -0  Input filenames are terminated by a null character\n") \
     3921       "    -t  Print the command line on stderr before executing it"
    34363922#define xargs_example_usage \
    3437     "$ ls | xargs gzip\n" \
    3438     "$ find . -name '*.c' -print | xargs rm\n"
     3923       "$ ls | xargs gzip\n" \
     3924       "$ find . -name '*.c' -print | xargs rm\n"
    34393925
    34403926#define yes_trivial_usage \
    3441     "[OPTION]... [STRING]..."
     3927       "[OPTION]... [STRING]..."
    34423928#define yes_full_usage \
    3443     "Repeatedly outputs a line with all specified STRING(s), or 'y'."
     3929       "Repeatedly output a line with all specified STRING(s), or 'y'"
    34443930
    34453931#define zcat_trivial_usage \
    3446     "FILE"
     3932       "FILE"
    34473933#define zcat_full_usage \
    3448     "Uncompress to stdout."
     3934       "Uncompress to stdout"
    34493935
    34503936#define zcip_trivial_usage \
    3451     "[OPTIONS] ifname script"
     3937       "[OPTIONS] ifname script"
    34523938#define zcip_full_usage \
    3453     "zcip manages a ZeroConf IPv4 link-local address.\n" \
    3454     "Options:\n" \
    3455     "\t-f              foreground mode\n" \
    3456     "\t-q              quit after address (no daemon)\n" \
    3457     "\t-r 169.254.x.x  request this address first\n" \
    3458     "\t-v              verbose"
     3939       "Manage a ZeroConf IPv4 link-local address" \
     3940       "\n\nOptions:\n" \
     3941       "    -f      Foreground mode\n" \
     3942       "    -q      Quit after address (no daemon)\n" \
     3943       "    -r 169.254.x.x  Request this address first\n" \
     3944       "    -v      Verbose"
    34593945
    34603946#endif /* __BB_USAGE_H__ */
  • branches/stable/mindi-busybox/include/xregex.h

    r821 r1770  
    11/* vi: set sw=4 ts=4: */
    22/*
    3  * Busybox xregcomp utility routine
    4  *
    5  *
    6  * This program is free software; you can redistribute it and/or modify
    7  * it under the terms of the GNU General Public License as published by
    8  * the Free Software Foundation; either version 2 of the License, or
    9  * (at your option) any later version.
    10  *
    11  * This program is distributed in the hope that it will be useful,
    12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
    13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    14  * General Public License for more details.
    15  *
    16  * You should have received a copy of the GNU General Public License
    17  * along with this program; if not, write to the Free Software
    18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
     3 * Busybox xregcomp utility routine.  This isn't in libbb.h because the
     4 * C library we're linking against may not support regex.h.
    195 *
    206 * Based in part on code from sash, Copyright (c) 1999 by David I. Bell
    217 * Permission has been granted to redistribute this code under the GPL.
    228 *
     9 * Licensed under GPLv2 or later, see file License in this tarball for details.
    2310 */
    2411#ifndef __BB_REGEX__
    2512#define __BB_REGEX__
    2613
    27 #include <sys/types.h>
    2814#include <regex.h>
    29 extern void xregcomp(regex_t *preg, const char *regex, int cflags);
     15char* regcomp_or_errmsg(regex_t *preg, const char *regex, int cflags);
     16void xregcomp(regex_t *preg, const char *regex, int cflags);
    3017
    3118#endif
Note: See TracChangeset for help on using the changeset viewer.