Changeset 1770 in MondoRescue for branches/stable/mindi-busybox/include
- Timestamp:
- Nov 6, 2007, 11:01:53 AM (16 years ago)
- 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: */ 1 2 /* 2 3 * applets.h - a listing of all busybox applets. … … 11 12 */ 12 13 13 #undef APPLET 14 #undef APPLET_ODDNAME 15 #undef APPLET_NOUSAGE 16 14 /* 15 name - applet name as it is typed on command line 16 name2 - applet name, converted to C (ether-wake: name2 = ether_wake) 17 main - corresponding <applet>_main to call (bzcat: main = bunzip2) 18 l - location to install link to: [/usr]/[s]bin 19 s - 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 */ 17 25 18 26 #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 32 47 #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 36 54 #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 44 64 # define _BB_DIR_USR_BIN _BB_DIR_BIN 45 65 # define _BB_DIR_USR_SBIN _BB_DIR_SBIN … … 47 67 48 68 49 USE_TEST(APPLET_NO USAGE([, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER))69 USE_TEST(APPLET_NOEXEC([, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER, test)) 50 70 USE_TEST(APPLET_NOUSAGE([[, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 51 71 USE_ADDGROUP(APPLET(addgroup, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 53 73 USE_ADJTIMEX(APPLET(adjtimex, _BB_DIR_SBIN, _BB_SUID_NEVER)) 54 74 USE_AR(APPLET(ar, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 75 USE_ARP(APPLET(arp, _BB_DIR_SBIN, _BB_SUID_NEVER)) 55 76 USE_ARPING(APPLET(arping, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 56 77 USE_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))78 USE_AWK(APPLET_NOEXEC(awk, awk, _BB_DIR_USR_BIN, _BB_SUID_NEVER, awk)) 79 USE_BASENAME(APPLET_NOFORK(basename, basename, _BB_DIR_USR_BIN, _BB_SUID_NEVER, basename)) 59 80 USE_BBCONFIG(APPLET(bbconfig, _BB_DIR_BIN, _BB_SUID_NEVER)) 81 //USE_BBSH(APPLET(bbsh, _BB_DIR_BIN, _BB_SUID_NEVER)) 60 82 USE_BUNZIP2(APPLET(bunzip2, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 61 /* Always enabled. */62 APPLET_NOUSAGE(busybox, busybox, _BB_DIR_BIN, _BB_SUID_MAYBE)63 83 USE_BUNZIP2(APPLET_ODDNAME(bzcat, bunzip2, _BB_DIR_USR_BIN, _BB_SUID_NEVER, bzcat)) 64 84 USE_CAL(APPLET(cal, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 65 USE_CAT(APPLET (cat, _BB_DIR_BIN, _BB_SUID_NEVER))85 USE_CAT(APPLET_NOFORK(cat, cat, _BB_DIR_BIN, _BB_SUID_NEVER, cat)) 66 86 USE_CATV(APPLET(catv, _BB_DIR_BIN, _BB_SUID_NEVER)) 67 87 USE_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)) 88 USE_CHCON(APPLET(chcon, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 89 USE_CHGRP(APPLET_NOEXEC(chgrp, chgrp, _BB_DIR_BIN, _BB_SUID_NEVER, chgrp)) 90 USE_CHMOD(APPLET_NOEXEC(chmod, chmod, _BB_DIR_BIN, _BB_SUID_NEVER, chmod)) 91 USE_CHOWN(APPLET_NOEXEC(chown, chown, _BB_DIR_BIN, _BB_SUID_NEVER, chown)) 92 USE_CHPASSWD(APPLET(chpasswd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 93 USE_CHPST(APPLET(chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 71 94 USE_CHROOT(APPLET(chroot, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 95 USE_CHRT(APPLET(chrt, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 72 96 USE_CHVT(APPLET(chvt, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 73 97 USE_CKSUM(APPLET(cksum, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) … … 75 99 USE_CMP(APPLET(cmp, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 76 100 USE_COMM(APPLET(comm, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 77 USE_CP(APPLET (cp, _BB_DIR_BIN, _BB_SUID_NEVER))101 USE_CP(APPLET_NOEXEC(cp, cp, _BB_DIR_BIN, _BB_SUID_NEVER, cp)) 78 102 USE_CPIO(APPLET(cpio, _BB_DIR_BIN, _BB_SUID_NEVER)) 79 103 USE_CROND(APPLET(crond, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 80 104 USE_CRONTAB(APPLET(crontab, _BB_DIR_USR_BIN, _BB_SUID_ALWAYS)) 81 USE_CUT(APPLET(cut, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 105 USE_CRYPTPW(APPLET(cryptpw, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 106 USE_CTTYHACK(APPLET_NOUSAGE(cttyhack, cttyhack, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 107 USE_CUT(APPLET_NOEXEC(cut, cut, _BB_DIR_USR_BIN, _BB_SUID_NEVER, cut)) 82 108 USE_DATE(APPLET(date, _BB_DIR_BIN, _BB_SUID_NEVER)) 83 109 USE_DC(APPLET(dc, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 84 USE_DD(APPLET (dd, _BB_DIR_BIN, _BB_SUID_NEVER))110 USE_DD(APPLET_NOEXEC(dd, dd, _BB_DIR_BIN, _BB_SUID_NEVER, dd)) 85 111 USE_DEALLOCVT(APPLET(deallocvt, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 86 112 USE_DELGROUP(APPLET_ODDNAME(delgroup, deluser, _BB_DIR_BIN, _BB_SUID_NEVER, delgroup)) … … 88 114 USE_DEVFSD(APPLET(devfsd, _BB_DIR_SBIN, _BB_SUID_NEVER)) 89 115 USE_DF(APPLET(df, _BB_DIR_BIN, _BB_SUID_NEVER)) 116 USE_APP_DHCPRELAY(APPLET(dhcprelay, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 90 117 USE_DIFF(APPLET(diff, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 91 USE_DIRNAME(APPLET (dirname, _BB_DIR_USR_BIN, _BB_SUID_NEVER))118 USE_DIRNAME(APPLET_NOFORK(dirname, dirname, _BB_DIR_USR_BIN, _BB_SUID_NEVER, dirname)) 92 119 USE_DMESG(APPLET(dmesg, _BB_DIR_BIN, _BB_SUID_NEVER)) 93 120 USE_DNSD(APPLET(dnsd, _BB_DIR_USR_SBIN, _BB_SUID_ALWAYS)) … … 98 125 USE_DUMPKMAP(APPLET(dumpkmap, _BB_DIR_BIN, _BB_SUID_NEVER)) 99 126 USE_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)) 129 USE_ECHO(APPLET_NOFORK(echo, echo, _BB_DIR_BIN, _BB_SUID_NEVER, echo)) 103 130 USE_ED(APPLET(ed, _BB_DIR_BIN, _BB_SUID_NEVER)) 104 131 USE_FEATURE_GREP_EGREP_ALIAS(APPLET_NOUSAGE(egrep, grep, _BB_DIR_BIN, _BB_SUID_NEVER)) 105 132 USE_EJECT(APPLET(eject, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 106 133 USE_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)) 134 USE_ENVDIR(APPLET_ODDNAME(envdir, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, envdir)) 135 USE_ENVUIDGID(APPLET_ODDNAME(envuidgid, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, envuidgid)) 136 USE_ETHER_WAKE(APPLET_ODDNAME(ether-wake, ether_wake, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ether_wake)) 137 USE_EXPAND(APPLET(expand, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 108 138 USE_EXPR(APPLET(expr, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 109 139 USE_FAKEIDENTD(APPLET(fakeidentd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 110 USE_FALSE(APPLET (false, _BB_DIR_BIN, _BB_SUID_NEVER))140 USE_FALSE(APPLET_NOFORK(false, false, _BB_DIR_BIN, _BB_SUID_NEVER, false)) 111 141 USE_FBSET(APPLET(fbset, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 112 142 USE_FDFLUSH(APPLET_ODDNAME(fdflush, freeramdisk, _BB_DIR_BIN, _BB_SUID_NEVER, fdflush)) … … 114 144 USE_FDISK(APPLET(fdisk, _BB_DIR_SBIN, _BB_SUID_NEVER)) 115 145 USE_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))146 USE_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)) 118 148 USE_FOLD(APPLET(fold, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 119 149 USE_FREE(APPLET(free, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 120 150 USE_FREERAMDISK(APPLET(freeramdisk, _BB_DIR_SBIN, _BB_SUID_NEVER)) 121 151 USE_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)) 124 154 USE_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))155 USE_FTPGET(APPLET_ODDNAME(ftpget, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ftpget)) 156 USE_FTPPUT(APPLET_ODDNAME(ftpput, ftpgetput, _BB_DIR_USR_BIN, _BB_SUID_NEVER, ftpput)) 127 157 USE_FUSER(APPLET(fuser, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 158 USE_GETENFORCE(APPLET(getenforce, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 128 159 USE_GETOPT(APPLET(getopt, _BB_DIR_BIN, _BB_SUID_NEVER)) 160 USE_GETSEBOOL(APPLET(getsebool, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 129 161 USE_GETTY(APPLET(getty, _BB_DIR_SBIN, _BB_SUID_NEVER)) 130 162 USE_GREP(APPLET(grep, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 134 166 USE_HDPARM(APPLET(hdparm, _BB_DIR_SBIN, _BB_SUID_NEVER)) 135 167 USE_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))168 USE_HEXDUMP(APPLET_NOEXEC(hexdump, hexdump, _BB_DIR_USR_BIN, _BB_SUID_NEVER, hexdump)) 169 USE_HOSTID(APPLET_NOFORK(hostid, hostid, _BB_DIR_USR_BIN, _BB_SUID_NEVER, hostid)) 138 170 USE_HOSTNAME(APPLET(hostname, _BB_DIR_BIN, _BB_SUID_NEVER)) 139 171 USE_HTTPD(APPLET(httpd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) … … 148 180 USE_INSMOD(APPLET(insmod, _BB_DIR_SBIN, _BB_SUID_NEVER)) 149 181 USE_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 150 187 USE_IP(APPLET(ip, _BB_DIR_BIN, _BB_SUID_NEVER)) 188 #endif 151 189 USE_IPADDR(APPLET(ipaddr, _BB_DIR_BIN, _BB_SUID_NEVER)) 152 190 USE_IPCALC(APPLET(ipcalc, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 155 193 USE_IPLINK(APPLET(iplink, _BB_DIR_BIN, _BB_SUID_NEVER)) 156 194 USE_IPROUTE(APPLET(iproute, _BB_DIR_BIN, _BB_SUID_NEVER)) 195 USE_IPRULE(APPLET(iprule, _BB_DIR_BIN, _BB_SUID_NEVER)) 157 196 USE_IPTUNNEL(APPLET(iptunnel, _BB_DIR_BIN, _BB_SUID_NEVER)) 158 197 USE_KILL(APPLET(kill, _BB_DIR_BIN, _BB_SUID_NEVER)) 159 198 USE_KILLALL(APPLET_ODDNAME(killall, kill, _BB_DIR_USR_BIN, _BB_SUID_NEVER, killall)) 199 USE_KILLALL5(APPLET_ODDNAME(killall5, kill, _BB_DIR_USR_BIN, _BB_SUID_NEVER, killall5)) 160 200 USE_KLOGD(APPLET(klogd, _BB_DIR_SBIN, _BB_SUID_NEVER)) 161 201 USE_LASH(APPLET(lash, _BB_DIR_BIN, _BB_SUID_NEVER)) 162 202 USE_LAST(APPLET(last, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 163 USE_LENGTH(APPLET (length, _BB_DIR_USR_BIN, _BB_SUID_NEVER))203 USE_LENGTH(APPLET_NOFORK(length, length, _BB_DIR_USR_BIN, _BB_SUID_NEVER, length)) 164 204 USE_LESS(APPLET(less, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 165 205 USE_SETARCH(APPLET_NOUSAGE(linux32, setarch, _BB_DIR_BIN, _BB_SUID_NEVER)) 166 206 USE_SETARCH(APPLET_NOUSAGE(linux64, setarch, _BB_DIR_BIN, _BB_SUID_NEVER)) 167 207 USE_FEATURE_INITRD(APPLET_NOUSAGE(linuxrc, init, _BB_DIR_ROOT, _BB_SUID_NEVER)) 168 USE_LN(APPLET(ln, _BB_DIR_BIN, _BB_SUID_NEVER)) 208 USE_LN(APPLET_NOEXEC(ln, ln, _BB_DIR_BIN, _BB_SUID_NEVER, ln)) 209 USE_LOAD_POLICY(APPLET(load_policy, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 169 210 USE_LOADFONT(APPLET(loadfont, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 170 211 USE_LOADKMAP(APPLET(loadkmap, _BB_DIR_SBIN, _BB_SUID_NEVER)) 171 212 USE_LOGGER(APPLET(logger, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 172 213 USE_LOGIN(APPLET(login, _BB_DIR_BIN, _BB_SUID_ALWAYS)) 173 USE_LOGNAME(APPLET (logname, _BB_DIR_USR_BIN, _BB_SUID_NEVER))214 USE_LOGNAME(APPLET_NOFORK(logname, logname, _BB_DIR_USR_BIN, _BB_SUID_NEVER, logname)) 174 215 USE_LOGREAD(APPLET(logread, _BB_DIR_SBIN, _BB_SUID_NEVER)) 175 216 USE_LOSETUP(APPLET(losetup, _BB_DIR_SBIN, _BB_SUID_NEVER)) 176 USE_LS(APPLET (ls, _BB_DIR_BIN, _BB_SUID_NEVER))217 USE_LS(APPLET_NOEXEC(ls, ls, _BB_DIR_BIN, _BB_SUID_NEVER, ls)) 177 218 USE_LSATTR(APPLET(lsattr, _BB_DIR_BIN, _BB_SUID_NEVER)) 178 219 USE_LSMOD(APPLET(lsmod, _BB_DIR_SBIN, _BB_SUID_NEVER)) 179 220 USE_UNLZMA(APPLET_ODDNAME(lzmacat, unlzma, _BB_DIR_USR_BIN, _BB_SUID_NEVER, lzmacat)) 180 221 USE_MAKEDEVS(APPLET(makedevs, _BB_DIR_SBIN, _BB_SUID_NEVER)) 181 USE_MD5SUM(APPLET(md5sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 222 USE_MATCHPATHCON(APPLET(matchpathcon, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 223 USE_MD5SUM(APPLET_ODDNAME(md5sum, md5_sha1_sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER, md5sum)) 182 224 USE_MDEV(APPLET(mdev, _BB_DIR_SBIN, _BB_SUID_NEVER)) 183 225 USE_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))226 USE_MKDIR(APPLET_NOFORK(mkdir, mkdir, _BB_DIR_BIN, _BB_SUID_NEVER, mkdir)) 227 //USE_MKE2FS(APPLET(mke2fs, _BB_DIR_SBIN, _BB_SUID_NEVER)) 186 228 USE_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)) 189 231 USE_MKFS_MINIX(APPLET_ODDNAME(mkfs.minix, mkfs_minix, _BB_DIR_SBIN, _BB_SUID_NEVER, mkfs_minix)) 190 232 USE_MKNOD(APPLET(mknod, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 193 235 USE_MODPROBE(APPLET(modprobe, _BB_DIR_SBIN, _BB_SUID_NEVER)) 194 236 USE_MORE(APPLET(more, _BB_DIR_BIN, _BB_SUID_NEVER)) 195 USE_MOUNT(APPLET(mount, _BB_DIR_BIN, _BB_SUID_NEVER))237 USE_MOUNT(APPLET(mount, _BB_DIR_BIN, USE_DESKTOP(_BB_SUID_MAYBE) SKIP_DESKTOP(_BB_SUID_NEVER))) 196 238 USE_MOUNTPOINT(APPLET(mountpoint, _BB_DIR_BIN, _BB_SUID_NEVER)) 197 239 USE_MSH(APPLET_NOUSAGE(msh, msh, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 202 244 USE_NETSTAT(APPLET(netstat, _BB_DIR_BIN, _BB_SUID_NEVER)) 203 245 USE_NICE(APPLET(nice, _BB_DIR_BIN, _BB_SUID_NEVER)) 246 USE_NMETER(APPLET(nmeter, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 204 247 USE_NOHUP(APPLET(nohup, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 205 248 USE_NSLOOKUP(APPLET(nslookup, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) … … 217 260 USE_PRINTF(APPLET(printf, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 218 261 USE_PS(APPLET(ps, _BB_DIR_BIN, _BB_SUID_NEVER)) 219 USE_PWD(APPLET(pwd, _BB_DIR_BIN, _BB_SUID_NEVER)) 262 USE_PSCAN(APPLET(pscan, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 263 USE_PWD(APPLET_NOFORK(pwd, pwd, _BB_DIR_BIN, _BB_SUID_NEVER, pwd)) 264 USE_RAIDAUTORUN(APPLET(raidautorun, _BB_DIR_SBIN, _BB_SUID_NEVER)) 220 265 USE_RDATE(APPLET(rdate, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 266 USE_READAHEAD(APPLET(readahead, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 221 267 USE_READLINK(APPLET(readlink, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 222 268 USE_READPROFILE(APPLET(readprofile, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) … … 225 271 USE_RENICE(APPLET(renice, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 226 272 USE_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)) 273 USE_RESIZE(APPLET(resize, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 274 USE_RESTORECON(APPLET_ODDNAME(restorecon, setfiles, _BB_DIR_SBIN, _BB_SUID_NEVER, restorecon)) 275 USE_RM(APPLET_NOFORK(rm, rm, _BB_DIR_BIN, _BB_SUID_NEVER, rm)) 276 USE_RMDIR(APPLET_NOFORK(rmdir, rmdir, _BB_DIR_BIN, _BB_SUID_NEVER, rmdir)) 229 277 USE_RMMOD(APPLET(rmmod, _BB_DIR_SBIN, _BB_SUID_NEVER)) 230 278 USE_ROUTE(APPLET(route, _BB_DIR_SBIN, _BB_SUID_NEVER)) … … 232 280 USE_RPM2CPIO(APPLET(rpm2cpio, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 233 281 USE_RUN_PARTS(APPLET_ODDNAME(run-parts, run_parts, _BB_DIR_BIN, _BB_SUID_NEVER, run_parts)) 282 USE_RUNCON(APPLET(runcon, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 234 283 USE_RUNLEVEL(APPLET(runlevel, _BB_DIR_SBIN, _BB_SUID_NEVER)) 284 USE_RUNSV(APPLET(runsv, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 285 USE_RUNSVDIR(APPLET(runsvdir, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 235 286 USE_RX(APPLET(rx, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 236 287 USE_SED(APPLET(sed, _BB_DIR_BIN, _BB_SUID_NEVER)) 237 USE_SEQ(APPLET(seq, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 288 USE_SELINUXENABLED(APPLET(selinuxenabled, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 289 USE_SEQ(APPLET_NOFORK(seq, seq, _BB_DIR_USR_BIN, _BB_SUID_NEVER, seq)) 238 290 USE_SETARCH(APPLET(setarch, _BB_DIR_BIN, _BB_SUID_NEVER)) 239 291 USE_SETCONSOLE(APPLET(setconsole, _BB_DIR_SBIN, _BB_SUID_NEVER)) 292 USE_SETENFORCE(APPLET(setenforce, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 293 USE_SETFILES(APPLET(setfiles, _BB_DIR_SBIN, _BB_SUID_NEVER)) 240 294 USE_SETKEYCODES(APPLET(setkeycodes, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 241 295 USE_SETLOGCONS(APPLET(setlogcons, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 242 296 USE_SETSID(APPLET(setsid, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 297 USE_SETUIDGID(APPLET_ODDNAME(setuidgid, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, setuidgid)) 243 298 USE_FEATURE_SH_IS_ASH(APPLET_NOUSAGE(sh, ash, _BB_DIR_BIN, _BB_SUID_NEVER)) 244 299 USE_FEATURE_SH_IS_HUSH(APPLET_NOUSAGE(sh, hush, _BB_DIR_BIN, _BB_SUID_NEVER)) 245 300 USE_FEATURE_SH_IS_LASH(APPLET_NOUSAGE(sh, lash, _BB_DIR_BIN, _BB_SUID_NEVER)) 246 301 USE_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)) 302 USE_SHA1SUM(APPLET_ODDNAME(sha1sum, md5_sha1_sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER, sha1sum)) 303 USE_SLATTACH(APPLET(slattach, _BB_DIR_SBIN, _BB_SUID_NEVER)) 304 USE_SLEEP(APPLET_NOFORK(sleep, sleep, _BB_DIR_BIN, _BB_SUID_NEVER, sleep)) 305 USE_SOFTLIMIT(APPLET_ODDNAME(softlimit, chpst, _BB_DIR_USR_BIN, _BB_SUID_NEVER, softlimit)) 306 USE_SORT(APPLET_NOEXEC(sort, sort, _BB_DIR_USR_BIN, _BB_SUID_NEVER, sort)) 307 USE_SPLIT(APPLET(split, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 250 308 USE_START_STOP_DAEMON(APPLET_ODDNAME(start-stop-daemon, start_stop_daemon, _BB_DIR_SBIN, _BB_SUID_NEVER, start_stop_daemon)) 251 309 USE_STAT(APPLET(stat, _BB_DIR_BIN, _BB_SUID_NEVER)) … … 255 313 USE_SULOGIN(APPLET(sulogin, _BB_DIR_SBIN, _BB_SUID_NEVER)) 256 314 USE_SUM(APPLET(sum, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 315 USE_SV(APPLET(sv, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 316 USE_SVLOGD(APPLET(svlogd, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 257 317 USE_SWAPONOFF(APPLET_ODDNAME(swapoff, swap_on_off, _BB_DIR_SBIN, _BB_SUID_NEVER,swapoff)) 258 318 USE_SWAPONOFF(APPLET_ODDNAME(swapon, swap_on_off, _BB_DIR_SBIN, _BB_SUID_NEVER, swapon)) 259 319 USE_SWITCH_ROOT(APPLET(switch_root, _BB_DIR_SBIN, _BB_SUID_NEVER)) 260 USE_SYNC(APPLET (sync, _BB_DIR_BIN, _BB_SUID_NEVER))320 USE_SYNC(APPLET_NOFORK(sync, sync, _BB_DIR_BIN, _BB_SUID_NEVER, sync)) 261 321 USE_BB_SYSCTL(APPLET(sysctl, _BB_DIR_SBIN, _BB_SUID_NEVER)) 262 322 USE_SYSLOGD(APPLET(syslogd, _BB_DIR_SBIN, _BB_SUID_NEVER)) 263 323 USE_TAIL(APPLET(tail, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 264 324 USE_TAR(APPLET(tar, _BB_DIR_BIN, _BB_SUID_NEVER)) 325 USE_TASKSET(APPLET(taskset, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 326 USE_TCPSVD(APPLET_ODDNAME(tcpsvd, tcpudpsvd, _BB_DIR_USR_BIN, _BB_SUID_NEVER, tcpsvd)) 265 327 USE_TEE(APPLET(tee, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 266 328 USE_TELNET(APPLET(telnet, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 267 329 USE_TELNETD(APPLET(telnetd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 268 USE_TEST(APPLET(test, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 330 USE_TEST(APPLET_NOEXEC(test, test, _BB_DIR_USR_BIN, _BB_SUID_NEVER, test)) 331 #if ENABLE_FEATURE_TFTP_GET || ENABLE_FEATURE_TFTP_PUT 269 332 USE_TFTP(APPLET(tftp, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 333 #endif 270 334 USE_TIME(APPLET(time, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 271 335 USE_TOP(APPLET(top, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 272 USE_TOUCH(APPLET (touch, _BB_DIR_BIN, _BB_SUID_NEVER))336 USE_TOUCH(APPLET_NOFORK(touch, touch, _BB_DIR_BIN, _BB_SUID_NEVER, touch)) 273 337 USE_TR(APPLET(tr, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 274 338 USE_TRACEROUTE(APPLET(traceroute, _BB_DIR_USR_BIN, _BB_SUID_MAYBE)) 275 USE_TRUE(APPLET (true, _BB_DIR_BIN, _BB_SUID_NEVER))339 USE_TRUE(APPLET_NOFORK(true, true, _BB_DIR_BIN, _BB_SUID_NEVER, true)) 276 340 USE_TTY(APPLET(tty, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 277 USE_TUNE2FS(APPLET(tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER)) 341 USE_TTYSIZE(APPLET(ttysize, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 342 //USE_TUNE2FS(APPLET(tune2fs, _BB_DIR_SBIN, _BB_SUID_NEVER)) 278 343 USE_APP_UDHCPC(APPLET(udhcpc, _BB_DIR_SBIN, _BB_SUID_NEVER)) 279 344 USE_APP_UDHCPD(APPLET(udhcpd, _BB_DIR_USR_SBIN, _BB_SUID_NEVER)) 345 USE_UDPSVD(APPLET_ODDNAME(udpsvd, tcpudpsvd, _BB_DIR_USR_BIN, _BB_SUID_NEVER, udpsvd)) 280 346 USE_UMOUNT(APPLET(umount, _BB_DIR_BIN, _BB_SUID_NEVER)) 281 347 USE_UNAME(APPLET(uname, _BB_DIR_BIN, _BB_SUID_NEVER)) 282 348 USE_UNCOMPRESS(APPLET(uncompress, _BB_DIR_BIN, _BB_SUID_NEVER)) 349 USE_UNEXPAND(APPLET_ODDNAME(unexpand, expand, _BB_DIR_USR_BIN, _BB_SUID_NEVER, unexpand)) 283 350 USE_UNIQ(APPLET(uniq, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 284 351 USE_UNIX2DOS(APPLET_ODDNAME(unix2dos, dos2unix, _BB_DIR_USR_BIN, _BB_SUID_NEVER, unix2dos)) … … 286 353 USE_UNZIP(APPLET(unzip, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 287 354 USE_UPTIME(APPLET(uptime, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 288 USE_USLEEP(APPLET (usleep, _BB_DIR_BIN, _BB_SUID_NEVER))355 USE_USLEEP(APPLET_NOFORK(usleep, usleep, _BB_DIR_BIN, _BB_SUID_NEVER, usleep)) 289 356 USE_UUDECODE(APPLET(uudecode, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 290 357 USE_UUENCODE(APPLET(uuencode, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) … … 298 365 USE_WHICH(APPLET(which, _BB_DIR_USR_BIN, _BB_SUID_NEVER)) 299 366 USE_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))367 USE_WHOAMI(APPLET_NOFORK(whoami, whoami, _BB_DIR_USR_BIN, _BB_SUID_NEVER, whoami)) 368 USE_XARGS(APPLET_NOEXEC(xargs, xargs, _BB_DIR_USR_BIN, _BB_SUID_NEVER, xargs)) 369 USE_YES(APPLET_NOFORK(yes, yes, _BB_DIR_USR_BIN, _BB_SUID_NEVER, yes)) 303 370 USE_GUNZIP(APPLET_ODDNAME(zcat, gunzip, _BB_DIR_BIN, _BB_SUID_NEVER, zcat)) 304 371 USE_ZCIP(APPLET(zcip, _BB_DIR_SBIN, _BB_SUID_NEVER)) 305 372 306 373 #if !defined(PROTOTYPES) && !defined(MAKE_USAGE) 307 { 0,NULL,0,0}374 { NULL } 308 375 }; 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 8 8 #define _BB_INTERNAL_H_ 1 9 9 10 #include "bb_config.h"11 12 10 #include "libbb.h" 13 11 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 */ 14 typedef enum bb_install_loc_t { 16 15 _BB_DIR_ROOT = 0, 17 16 _BB_DIR_BIN, … … 19 18 _BB_DIR_USR_BIN, 20 19 _BB_DIR_USR_SBIN 21 }; 20 } bb_install_loc_t; 21 #endif 22 22 23 enum SUIDRoot { 23 #if ENABLE_FEATURE_SUID 24 typedef enum bb_suid_t { 24 25 _BB_SUID_NEVER = 0, 25 26 _BB_SUID_MAYBE, 26 27 _BB_SUID_ALWAYS 28 } bb_suid_t; 29 #endif 30 31 struct 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 27 49 }; 28 50 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 */ 52 extern const struct bb_applet applets[]; 53 extern const unsigned short NUM_APPLETS; 35 54 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: */ 1 2 #define F_IGNORE 0x01 /* %_A */ 2 3 #define F_SETREP 0x02 /* rep count set, not default */ … … 40 41 41 42 extern void bb_dump_add(const char *fmt); 42 extern int bb_dump_dump 43 extern int bb_dump_dump(char **argv); 43 44 extern int bb_dump_size(FS * fs); 44 45 -
branches/stable/mindi-busybox/include/grp_.h
r821 r1770 1 /* vi: set sw=4 ts=4: */ 1 2 /* Copyright (C) 1991,92,95,96,97,98,99,2000,01 Free Software Foundation, Inc. 2 3 This file is part of the GNU C Library. … … 21 22 */ 22 23 24 #if !ENABLE_USE_BB_PWD_GRP 23 25 24 #if !defined CONFIG_USE_BB_PWD_GRP25 26 #include <grp.h> 26 27 … … 28 29 29 30 #ifndef _GRP_H 30 #define _GRP_H 1 31 #define _GRP_H 1 32 33 /* The group structure. */ 34 struct 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). */ 44 extern int setgroups(size_t __n, __const gid_t *__groups); 31 45 32 46 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 36 60 37 61 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 */ 46 66 47 67 48 68 /* Rewind the group-file stream. */ 49 extern void setgrent 69 extern void setgrent(void); 50 70 51 71 /* Close the group-file stream. */ 52 extern void endgrent 72 extern void endgrent(void); 53 73 54 74 /* Read an entry from the group-file stream, opening it if necessary. */ 55 extern struct group *getgrent 75 extern struct group *getgrent(void); 56 76 57 77 /* Read a group entry from STREAM. */ 58 extern struct group *fgetgrent 78 extern struct group *fgetgrent(FILE *__stream); 59 79 60 80 /* Write the given entry onto the given stream. */ 61 extern int putgrent 81 extern int putgrent(__const struct group *__restrict __p, 62 82 FILE *__restrict __f); 63 83 64 84 /* Search for an entry with a matching group ID. */ 65 extern struct group *getgrgid 85 extern struct group *getgrgid(gid_t __gid); 66 86 67 87 /* Search for an entry with a matching group name. */ 68 extern struct group *getgrnam 88 extern struct group *getgrnam(__const char *__name); 69 89 70 90 /* Reentrant versions of some of the functions above. … … 76 96 POSIX people would choose. */ 77 97 78 extern int getgrent_r 98 extern int getgrent_r(struct group *__restrict __resultbuf, 79 99 char *__restrict __buffer, size_t __buflen, 80 100 struct group **__restrict __result); 81 101 82 102 /* Search for an entry with a matching group ID. */ 83 extern int getgrgid_r 103 extern int getgrgid_r(gid_t __gid, struct group *__restrict __resultbuf, 84 104 char *__restrict __buffer, size_t __buflen, 85 105 struct group **__restrict __result); 86 106 87 107 /* Search for an entry with a matching group name. */ 88 extern int getgrnam_r 108 extern int getgrnam_r(__const char *__restrict __name, 89 109 struct group *__restrict __resultbuf, 90 110 char *__restrict __buffer, size_t __buflen, … … 93 113 /* Read a group entry from STREAM. This function is not standardized 94 114 an probably never will. */ 95 extern int fgetgrent_r 115 extern int fgetgrent_r(FILE *__restrict __stream, 96 116 struct group *__restrict __resultbuf, 97 117 char *__restrict __buffer, size_t __buflen, 98 118 struct group **__restrict __result); 99 119 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 103 120 /* Store at most *NGROUPS members of the group set for USER into 104 121 *GROUPS. Also include GROUP. The actual number of groups found is 105 122 returned in *NGROUPS. Return -1 if the if *NGROUPS is too small. */ 106 extern int getgrouplist 123 extern int getgrouplist(__const char *__user, gid_t __group, 107 124 gid_t *__groups, int *__ngroups); 108 125 … … 110 127 by reading the group database and using all groups 111 128 of which USER is a member. Also include GROUP. */ 112 extern int initgroups 129 extern int initgroups(__const char *__user, gid_t __group); 113 130 114 131 -
branches/stable/mindi-busybox/include/inet_common.h
r821 r1770 1 /* vi: set sw=4 ts=4: */ 1 2 /* 2 3 * stolen from net-tools-1.59 and stripped down for busybox by … … 5 6 * Heavily modified by Manuel Novoa III Mar 12, 2001 6 7 * 7 * Version: $Id: inet_common.h,v 1.4 2004/03/10 07:42:37 mjn3 Exp $8 *9 8 */ 10 9 11 #include <features.h>12 #include <sys/types.h>13 #include <sys/socket.h>14 10 #include "platform.h" 15 16 17 extern const char bb_INET_default[]; /* = "default" */18 11 19 12 /* hostfirst!=0 If we expect this to be a hostname, 20 13 try hostname database first 21 14 */ 22 externint INET_resolve(const char *name, struct sockaddr_in *s_in, int hostfirst);15 int INET_resolve(const char *name, struct sockaddr_in *s_in, int hostfirst); 23 16 24 25 /* numeric: & 0x8000: default instead of *, 17 /* numeric: & 0x8000: "default" instead of "*", 26 18 * & 0x4000: host instead of net, 27 19 * & 0x0fff: don't resolve 28 20 */ 29 extern int INET_rresolve(char *name, size_t len, struct sockaddr_in *s_in,30 int numeric, unsigned int netmask);31 21 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); 22 int INET6_resolve(const char *name, struct sockaddr_in6 *sin6); 23 24 /* These return malloced string */ 25 char *INET_rresolve(struct sockaddr_in *s_in, int numeric, uint32_t netmask); 26 char *INET6_rresolve(struct sockaddr_in6 *sin6, int numeric); -
branches/stable/mindi-busybox/include/libbb.h
r821 r1770 3 3 * Busybox main internal header file 4 4 * 5 * Licensed under the GPL v2 or later, see the file LICENSE in this tarball.6 *7 5 * Based in part on code from sash, Copyright (c) 1999 by David I. Bell 8 6 * Permission has been granted to redistribute this code under the GPL. 9 7 * 8 * Licensed under the GPL version 2, see the file LICENSE in this tarball. 10 9 */ 11 10 #ifndef __LIBBUSYBOX_H__ 12 11 #define __LIBBUSYBOX_H__ 1 13 12 14 #include "bb_config.h"15 13 #include "platform.h" 16 14 17 15 #include <ctype.h> 18 16 #include <dirent.h> 17 #include <errno.h> 19 18 #include <fcntl.h> 20 19 #include <inttypes.h> 20 #include <mntent.h> 21 21 #include <netdb.h> 22 #include <setjmp.h> 23 #include <signal.h> 22 24 #include <stdio.h> 23 25 #include <stdlib.h> 24 26 #include <stdarg.h> 27 #include <stddef.h> 25 28 #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> 27 32 #include <sys/socket.h> 28 33 #include <sys/stat.h> 34 #include <sys/statfs.h> 29 35 #include <sys/time.h> 30 36 #include <sys/types.h> 37 #include <sys/wait.h> 31 38 #include <termios.h> 39 #include <time.h> 32 40 #include <unistd.h> 33 34 #ifdef CONFIG_SELINUX 41 #include <utime.h> 42 43 #if ENABLE_SELINUX 35 44 #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) 36 52 #endif 37 53 38 54 #include "pwd_.h" 39 55 #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 41 59 #include "shadow_.h" 42 #endif43 #ifdef CONFIG_FEATURE_SHA1_PASSWORDS44 # include "sha1.h"45 60 #endif 46 61 … … 49 64 #include <sys/param.h> 50 65 #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))) 57 125 58 126 /* Some useful definitions */ … … 81 149 82 150 /* buffer allocation schemes */ 83 #if def CONFIG_FEATURE_BUFFERS_GO_ON_STACK84 #define RESERVE_CONFIG_BUFFER(buffer,len) 151 #if ENABLE_FEATURE_BUFFERS_GO_ON_STACK 152 #define RESERVE_CONFIG_BUFFER(buffer,len) char buffer[len] 85 153 #define RESERVE_CONFIG_UBUFFER(buffer,len) unsigned char buffer[len] 86 154 #define RELEASE_CONFIG_BUFFER(buffer) ((void)0) 87 155 #else 88 #if def CONFIG_FEATURE_BUFFERS_GO_IN_BSS156 #if ENABLE_FEATURE_BUFFERS_GO_IN_BSS 89 157 #define RESERVE_CONFIG_BUFFER(buffer,len) static char buffer[len] 90 158 #define RESERVE_CONFIG_UBUFFER(buffer,len) static unsigned char buffer[len] 91 159 #define RELEASE_CONFIG_BUFFER(buffer) ((void)0) 92 160 #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 :) */ 171 extern int *const bb_errno; 172 #undef errno 173 #define errno (*bb_errno) 174 #endif 175 176 #if defined(__GLIBC__) && __GLIBC__ < 2 177 int 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. 182 char *dirname(char *path); 283 183 /* Include our own copy of struct sysinfo to avoid binary compatibility 284 184 * problems with Linux 2.4, which changed things. Grumble, grumble. */ … … 299 199 char _f[20-2*sizeof(long)-sizeof(int)]; /* Padding: libc5 uses this.. */ 300 200 }; 301 extern int sysinfo (struct sysinfo* info); 302 201 int sysinfo(struct sysinfo* info); 202 203 unsigned long long monotonic_us(void); 204 unsigned monotonic_sec(void); 205 206 extern void chomp(char *s); 207 extern void trim(char *s); 208 extern char *skip_whitespace(const char *); 209 extern char *skip_non_whitespace(const char *); 210 211 //TODO: supply a pointer to char[11] buffer (avoid statics)? 212 extern const char *bb_mode_string(mode_t mode); 213 extern int is_directory(const char *name, int followLinks, struct stat *statBuf); 214 extern int remove_file(const char *path, int flags); 215 extern int copy_file(const char *source, const char *dest, int flags); 303 216 enum { 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 }; 223 extern 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); 227 extern int device_open(const char *device, int mode); 228 extern int get_console_fd(void); 229 extern char *find_block_device(const char *path); 230 /* bb_copyfd_XX print read/write errors and return -1 if they occur */ 231 extern off_t bb_copyfd_eof(int fd1, int fd2); 232 extern off_t bb_copyfd_size(int fd1, int fd2, off_t size); 233 extern 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 */ 236 extern void complain_copyfd_and_die(off_t sz) ATTRIBUTE_NORETURN; 237 extern char bb_process_escape_sequence(const char **ptr); 238 /* TODO: sometimes modifies its parameter, which 239 * makes it rather inconvenient at times: */ 240 extern char *bb_get_last_path_component(char *path); 241 242 int ndelay_on(int fd); 243 int ndelay_off(int fd); 244 void xdup2(int, int); 245 void xmove_fd(int, int); 246 247 248 DIR *xopendir(const char *path); 249 DIR *warn_opendir(const char *path); 250 251 /* UNUSED: char *xmalloc_realpath(const char *path); */ 252 char *xmalloc_readlink(const char *path); 253 char *xmalloc_readlink_or_warn(const char *path); 254 char *xrealloc_getcwd_or_warn(char *cwd); 255 256 257 //TODO: signal(sid, f) is the same? then why? 258 extern 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)) 261 extern void sig_block(int); 262 extern void sig_unblock(int); 263 /* UNUSED: extern void sig_blocknone(void); */ 264 extern void sig_pause(void); 265 266 267 void xsetgid(gid_t gid); 268 void xsetuid(uid_t uid); 269 void xchdir(const char *path); 270 void xsetenv(const char *key, const char *value); 271 void xunlink(const char *pathname); 272 void xstat(const char *pathname, struct stat *buf); 273 int xopen(const char *pathname, int flags); 274 int xopen3(const char *pathname, int flags, int mode); 275 int open_or_warn(const char *pathname, int flags); 276 int open3_or_warn(const char *pathname, int flags, int mode); 277 void xpipe(int filedes[2]); 278 off_t xlseek(int fd, off_t offset, int whence); 279 off_t fdlength(int fd); 280 281 int xsocket(int domain, int type, int protocol); 282 void xbind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen); 283 void xlisten(int s, int backlog); 284 void xconnect(int s, const struct sockaddr *s_addr, socklen_t addrlen); 285 ssize_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(). */ 293 void setsockopt_reuseaddr(int fd); /* On Linux this never fails. */ 294 int setsockopt_broadcast(int fd); 295 /* NB: returns port in host byte order */ 296 unsigned bb_lookup_port(const char *port, const char *protocol, unsigned default_port); 297 typedef 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; 307 enum { 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 */ 323 int xsocket_type(len_and_sockaddr **lsap, USE_FEATURE_IPV6(int af,) int sock_type); 324 int 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 */ 330 int create_and_bind_stream_or_die(const char *bindaddr, int port); 331 int 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 */ 336 int create_and_connect_stream_or_die(const char *peer, int port); 337 /* Connect to peer identified by lsa */ 338 int 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 */ 344 len_and_sockaddr* host2sockaddr(const char *host, int port); 345 /* Version which dies on error */ 346 len_and_sockaddr* xhost2sockaddr(const char *host, int port); 347 len_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) */ 350 len_and_sockaddr* host_and_af2sockaddr(const char *host, int port, sa_family_t af); 351 len_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. */ 360 void set_nport(len_and_sockaddr *lsa, unsigned port); 361 /* Retrieve sin[6]_port or return -1 for non-INET[6] lsa's */ 362 int get_nport(const struct sockaddr *sa); 363 /* Reverse DNS. Returns NULL on failure. */ 364 char* xmalloc_sockaddr2host(const struct sockaddr *sa); 365 /* This one doesn't append :PORTNUM */ 366 char* xmalloc_sockaddr2host_noport(const struct sockaddr *sa); 367 /* This one also doesn't fall back to dotted IP (returns NULL) */ 368 char* xmalloc_sockaddr2hostonly_noport(const struct sockaddr *sa); 369 /* inet_[ap]ton on steroids */ 370 char* xmalloc_sockaddr2dotted(const struct sockaddr *sa); 371 char* xmalloc_sockaddr2dotted_noport(const struct sockaddr *sa); 372 // "old" (ipv4 only) API 373 // users: traceroute.c hostname.c - use _list_ of all IPs 374 struct 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 379 void socket_want_pktinfo(int fd); 380 ssize_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); 383 ssize_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 388 extern char *xstrdup(const char *s); 389 extern char *xstrndup(const char *s, int n); 390 extern char *safe_strncpy(char *dst, const char *src, size_t size); 391 extern 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. */ 406 extern void *malloc_or_warn(size_t size); 407 extern void *xmalloc(size_t size); 408 extern void *xzalloc(size_t size); 409 extern void *xrealloc(void *old, size_t size); 410 411 extern ssize_t safe_read(int fd, void *buf, size_t count); 412 extern ssize_t full_read(int fd, void *buf, size_t count); 413 extern void xread(int fd, void *buf, size_t count); 414 extern unsigned char xread_char(int fd); 415 // Read one line a-la fgets. Uses one read(), works only on seekable streams 416 extern 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. 419 extern char *xmalloc_reads(int fd, char *pfx); 420 extern ssize_t read_close(int fd, void *buf, size_t count); 421 extern ssize_t open_read_close(const char *filename, void *buf, size_t count); 422 extern void *xmalloc_open_read_close(const char *filename, size_t *sizep); 423 424 extern ssize_t safe_write(int fd, const void *buf, size_t count); 425 extern ssize_t full_write(int fd, const void *buf, size_t count); 426 extern 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: */ 429 extern void xprint_and_close_file(FILE *file); 430 extern char *xmalloc_fgets(FILE *file); 431 /* Read up to (and including) TERMINATING_STRING: */ 432 extern char *xmalloc_fgets_str(FILE *file, const char *terminating_string); 433 /* Chops off '\n' from the end, unlike fgets: */ 434 extern char *xmalloc_getline(FILE *file); 435 extern char *bb_get_chunk_from_file(FILE *file, int *end); 436 extern void die_if_ferror(FILE *file, const char *msg); 437 extern void die_if_ferror_stdout(void); 438 extern void xfflush_stdout(void); 439 extern void fflush_stdout_and_exit(int retval) ATTRIBUTE_NORETURN; 440 extern int fclose_if_not_stdin(FILE *file); 441 extern FILE *xfopen(const char *filename, const char *mode); 442 /* Prints warning to stderr and returns NULL on failure: */ 443 extern FILE *fopen_or_warn(const char *filename, const char *mode); 444 /* "Opens" stdin if filename is special, else just opens file: */ 445 extern FILE *fopen_or_warn_stdin(const char *filename); 446 447 /* Convert each alpha char in str to lower-case */ 448 extern char* str_tolower(char *str); 449 450 char *utoa(unsigned n); 451 char *itoa(int n); 452 /* Returns a pointer past the formatted number, does NOT null-terminate */ 453 char *utoa_to_buf(unsigned n, char *buf, unsigned buflen); 454 char *itoa_to_buf(int n, char *buf, unsigned buflen); 455 void smart_ulltoa5(unsigned long long ul, char buf[5]); 456 //TODO: provide pointer to buf (avoid statics)? 308 457 const char *make_human_readable_str(unsigned long long size, 309 458 unsigned long block_size, unsigned long display_unit); 310 459 /* Put a string of hex bytes ("1b2e66fe"...), return advanced pointer */ 460 char *bin2hex(char *buf, const char *cp, int count); 461 462 /* Last element is marked by mult == 0 */ 463 struct 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 */ 473 int xatoi_u(const char *numstr); 474 /* Useful for reading port numbers */ 475 uint16_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. */ 481 long xuname2uid(const char *name); 482 long xgroup2gid(const char *name); 483 /* wrapper: allows string to contain numeric uid or gid */ 484 unsigned long get_ug_id(const char *s, long (*xname2id)(const char *)); 485 /* from chpst. Does not die, returns 0 on failure */ 486 struct bb_uidgid_t { 487 uid_t uid; 488 gid_t gid; 489 }; 490 /* always sets uid and gid */ 491 int get_uidgid(struct bb_uidgid_t*, const char*, int numeric_ok); 492 /* chown-like handling of "user[:[group]" */ 493 void 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 */ 500 char *bb_getpwuid(char *name, int bufsize, long uid); 501 char *bb_getgrgid(char *group, int bufsize, long gid); 502 /* versions which cache results (useful for ps, ls etc) */ 503 const char* get_cached_username(uid_t uid); 504 const char* get_cached_groupname(gid_t gid); 505 void clear_username_cache(void); 506 /* internally usernames are saved in fixed-sized char[] buffers */ 507 enum { USERNAME_MAX_SIZE = 16 - sizeof(int) }; 508 509 510 struct bb_applet; 511 int execable_file(const char *name); 512 char *find_execable(const char *filename); 513 int exists_execable(const char *filename); 514 515 #if ENABLE_FEATURE_PREFER_APPLETS 516 int 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 */ 527 pid_t spawn(char **argv); 528 pid_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 */ 537 int wait4pid(int pid); 538 int wait_pid(int *wstat, int pid); 539 int 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) */ 545 int spawn_and_wait(char **argv); 546 struct 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 }; 554 void save_nofork_data(struct nofork_save_area *save); 555 void restore_nofork_data(struct nofork_save_area *save); 556 /* Does NOT check that applet is NOFORK, just blindly runs it */ 557 int run_nofork_applet(const struct bb_applet *a, char **argv); 558 int 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 */ 583 enum { 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 603 void bb_daemonize_or_rexec(int flags, char **argv); 604 void bb_sanitize_stdio(void); 605 606 607 extern const char *opt_complementary; 608 #if ENABLE_GETOPT_LONG 609 #define No_argument "\0" 610 #define Required_argument "\001" 611 #define Optional_argument "\002" 612 extern const char *applet_long_options; 613 #endif 614 extern uint32_t option_mask32; 615 extern uint32_t getopt32(char **argv, const char *applet_opts, ...); 616 617 618 typedef struct llist_t { 619 char *data; 620 struct llist_t *link; 621 } llist_t; 622 void llist_add_to(llist_t **old_head, void *data); 623 void llist_add_to_end(llist_t **list_head, void *data); 624 void *llist_pop(llist_t **elm); 625 void llist_unlink(llist_t **head, llist_t *elm); 626 void llist_free(llist_t *elm, void (*freeit)(void *data)); 627 llist_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 */ 636 extern smallint wrote_pidfile; 637 void write_pidfile(const char *path); 638 #define remove_pidfile(path) do { if (wrote_pidfile) unlink(path); } while (0) 639 #else 640 enum { wrote_pidfile = 0 }; 641 #define write_pidfile(path) ((void)0) 642 #define remove_pidfile(path) ((void)0) 643 #endif 644 645 enum { 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 }; 651 extern const char *msg_eol; 652 extern smallint logmode; 653 extern int die_sleep; 654 extern int xfunc_error_retval; 655 extern jmp_buf die_jmp; 656 extern void xfunc_die(void) ATTRIBUTE_NORETURN; 657 extern void bb_show_usage(void) ATTRIBUTE_NORETURN ATTRIBUTE_EXTERNALLY_VISIBLE; 658 extern void bb_error_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2))); 659 extern void bb_error_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2))); 660 extern void bb_perror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2))); 661 extern void bb_perror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2))); 662 extern void bb_herror_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2))); 663 extern void bb_herror_msg_and_die(const char *s, ...) __attribute__ ((noreturn, format (printf, 1, 2))); 664 extern void bb_perror_nomsg_and_die(void) ATTRIBUTE_NORETURN; 665 extern void bb_perror_nomsg(void); 666 extern void bb_info_msg(const char *s, ...) __attribute__ ((format (printf, 1, 2))); 667 extern void bb_verror_msg(const char *s, va_list p, const char *strerr); 668 669 670 /* applets which are useful from another applets */ 671 int bb_cat(char** argv); 672 int bb_echo(char** argv); 673 int test_main(int argc, char** argv); 674 int kill_main(int argc, char **argv); 675 #if ENABLE_ROUTE 676 void bb_displayroutes(int noresolve, int netstatfmt); 677 #endif 678 int chown_main(int argc, char **argv); 679 #if ENABLE_GUNZIP 680 int gunzip_main(int argc, char **argv); 681 #endif 682 int bbunpack(char **argv, 683 char* (*make_new_name)(char *filename), 684 USE_DESKTOP(long long) int (*unpacker)(void) 685 ); 686 687 688 /* Networking */ 689 int create_icmp_socket(void); 690 int create_icmp6_socket(void); 691 /* interface.c */ 692 /* This structure defines protocol families and their handlers. */ 693 struct 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. */ 709 struct 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 }; 719 extern smallint interface_opt_a; 720 int display_interfaces(char *ifname); 721 const struct aftype *get_aftype(const char *name); 722 const struct hwtype *get_hwtype(const char *name); 723 const struct hwtype *get_hwntype(int type); 724 725 726 #ifndef BUILD_INDIVIDUAL 727 extern const struct bb_applet *find_applet_by_name(const char *name); 728 /* Returns only if applet is not found. */ 729 extern void run_applet_and_exit(const char *name, char **argv); 730 extern void run_current_applet_and_exit(char **argv) ATTRIBUTE_NORETURN; 731 #endif 732 733 extern int match_fstype(const struct mntent *mt, const char *fstypes); 734 extern struct mntent *find_mount_point(const char *name, const char *table); 735 extern void erase_mtab(const char * name); 736 extern unsigned int tty_baud_to_value(speed_t speed); 737 extern speed_t tty_value_to_baud(unsigned int value); 738 extern void bb_warn_ignoring_args(int n); 739 740 extern int get_linux_version_code(void); 741 742 extern char *query_loop(const char *device); 743 extern 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 */ 747 extern 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)? 751 char *bb_askpass(int timeout, const char * prompt); 311 752 int bb_ask_confirmation(void); 312 753 int klogctl(int type, char * b, int len); 313 754 314 char *xgetcwd(char *cwd);315 char *xreadlink(const char *path); 755 extern int bb_parse_mode(const char* s, mode_t* theMode); 756 316 757 char *concat_path_file(const char *path, const char *filename); 317 758 char *concat_subpath_file(const char *path, const char *filename); 759 const char *bb_basename(const char *name); 760 /* NB: can violate const-ness (similarly to strchr) */ 318 761 char *last_char_is(const char *s, int c); 319 762 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 764 USE_DESKTOP(long long) int uncompress(int fd_in, int fd_out); 765 int inflate(int in, int out); 766 767 768 int bb_make_directory(char *path, long mode, int flags); 769 770 int get_signum(const char *name); 771 const char *get_signame(int number); 772 341 773 char *bb_simplify_path(const char *path); 342 774 343 enum { /* DO NOT CHANGE THESE VALUES! cp.c depends on them. */ 775 #define FAIL_DELAY 3 776 extern void bb_do_delay(int seconds); 777 extern void change_identity(const struct passwd *pw); 778 extern const char *change_identity_e2str(const struct passwd *pw); 779 extern void run_shell(const char *shell, int loginshell, const char *command, const char **additional_args); 780 #if ENABLE_SELINUX 781 extern void renew_current_security_context(void); 782 extern void set_current_security_context(security_context_t sid); 783 extern context_t set_security_context_component(security_context_t cur_context, 784 char *user, char *role, char *type, char *range); 785 extern void setfscreatecon_or_die(security_context_t scontext); 786 #endif 787 extern void selinux_or_die(void); 788 extern int restricted_shell(const char *shell); 789 extern void setup_environment(const char *shell, int loginshell, int changeenv, const struct passwd *pw); 790 extern int correct_password(const struct passwd *pw); 791 /* Returns a ptr to static storage */ 792 extern char *pw_encrypt(const char *clear, const char *salt); 793 extern int obscure(const char *old, const char *newval, const struct passwd *pwdp); 794 extern int index_in_str_array(const char *const string_array[], const char *key); 795 extern int index_in_strings(const char *strings, const char *key); 796 extern int index_in_substr_array(const char *const string_array[], const char *key); 797 extern int index_in_substrings(const char *strings, const char *key); 798 extern void print_login_issue(const char *issue_file, const char *tty); 799 extern 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 */ 808 extern int crypt_make_salt(char *p, int cnt, int rnd); 809 810 /* Returns number of lines changed, or -1 on error */ 811 extern 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' */ 815 int get_terminal_width_height(int fd, int *width, int *height); 816 817 int ioctl_or_perror(int fd, int request, void *argp, const char *fmt,...) __attribute__ ((format (printf, 4, 5))); 818 void 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 820 int bb_ioctl_or_warn(int fd, int request, void *argp, const char *ioctl_name); 821 void 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 825 int bb_ioctl_or_warn(int fd, int request, void *argp); 826 void 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 831 char *is_in_ino_dev_hashtable(const struct stat *statbuf); 832 void add_to_ino_dev_hashtable(const struct stat *statbuf, const char *name); 833 void reset_ino_dev_hashtable(void); 834 #ifdef __GLIBC__ 835 /* At least glibc has horrendously large inline for this, so wrap it */ 836 unsigned 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 849 typedef 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; 859 enum { 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 }; 868 line_input_t *new_line_input_t(int flags); 869 int read_line_input(const char* prompt, char* command, int maxsize, line_input_t *state); 870 #else 871 int 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 879 enum { COMM_LEN = TASK_COMM_LEN }; 880 #else 881 /* synchronize with sizeof(task_struct.comm) in /usr/include/linux/sched.h */ 882 enum { COMM_LEN = 16 }; 883 #endif 884 #endif 885 typedef 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; 910 enum { 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 }; 934 procps_status_t* alloc_procps_scan(int flags); 935 void free_procps_scan(procps_status_t* sp); 936 procps_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) */ 939 void read_cmdline(char *buf, int col, unsigned pid, const char *comm); 940 pid_t *find_pid_by_name(const char* procName); 941 pid_t *pidlist_reverse(pid_t *pidList); 942 943 944 extern const char bb_uuenc_tbl_base64[]; 945 extern const char bb_uuenc_tbl_std[]; 946 void bb_uuencode(char *store, const void *s, int length, const char *tbl); 947 948 typedef struct sha1_ctx_t { 949 uint32_t count[2]; 950 uint32_t hash[5]; 951 uint32_t wbuf[16]; 952 } sha1_ctx_t; 953 void sha1_begin(sha1_ctx_t *ctx); 954 void sha1_hash(const void *data, size_t length, sha1_ctx_t *ctx); 955 void *sha1_end(void *resbuf, sha1_ctx_t *ctx); 956 957 typedef 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; 966 void md5_begin(md5_ctx_t *ctx); 967 void md5_hash(const void *data, size_t length, md5_ctx_t *ctx); 968 void *md5_end(void *resbuf, md5_ctx_t *ctx); 969 970 uint32_t *crc32_filltable(uint32_t *tbl256, int endian); 971 972 973 enum { /* DO NOT CHANGE THESE VALUES! cp.c, mv.c, install.c depend on them. */ 344 974 FILEUTILS_PRESERVE_STATUS = 1, 345 975 FILEUTILS_DEREFERENCE = 2, 346 976 FILEUTILS_RECUR = 4, 347 977 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") 988 extern const struct bb_applet *current_applet; 989 extern const char *applet_name; 990 /* "BusyBox vN.N.N (timestamp or extra_vestion)" */ 991 extern const char bb_banner[]; 992 extern const char bb_msg_memory_exhausted[]; 993 extern const char bb_msg_invalid_date[]; 994 extern const char bb_msg_read_error[]; 995 extern const char bb_msg_write_error[]; 996 extern const char bb_msg_unknown[]; 997 extern const char bb_msg_can_not_create_raw_socket[]; 998 extern const char bb_msg_perm_denied_are_you_root[]; 999 extern const char bb_msg_requires_arg[]; 1000 extern const char bb_msg_invalid_arg[]; 1001 extern const char bb_msg_standard_input[]; 1002 extern const char bb_msg_standard_output[]; 1003 1004 extern const char bb_str_default[]; 1005 /* NB: (bb_hexdigits_upcase[i] | 0x20) -> lowercase hex digit */ 1006 extern const char bb_hexdigits_upcase[]; 1007 1008 extern const char bb_path_mtab_file[]; 1009 extern const char bb_path_passwd_file[]; 1010 extern const char bb_path_shadow_file[]; 1011 extern const char bb_path_gshadow_file[]; 1012 extern const char bb_path_group_file[]; 1013 extern const char bb_path_motd_file[]; 1014 extern const char bb_path_wtmp_file[]; 1015 extern const char bb_dev_null[]; 1016 extern 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 */ 1019 extern 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 1023 extern const int const_int_0; 1024 extern const int const_int_1; 1025 377 1026 378 1027 #ifndef BUFSIZ 379 1028 #define BUFSIZ 4096 380 1029 #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) */ 1031 enum { COMMON_BUFSIZE = (BUFSIZ >= 256*sizeof(void*) ? BUFSIZ+1 : 256*sizeof(void*)) }; 1032 extern char bb_common_bufsiz1[COMMON_BUFSIZE]; 1033 /* This struct is deliberately not defined. */ 1034 /* See docs/keep_data_small.txt */ 1035 struct 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 */ 1039 extern 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. */ 389 1047 #define LIBBB_DEFAULT_LOGIN_SHELL "-/bin/sh" 390 391 extern const char * const bb_default_login_shell; 1048 extern const char bb_default_login_shell[]; 392 1049 /* "/bin/sh" */ 393 1050 #define DEFAULT_SHELL (bb_default_login_shell+1) … … 396 1053 397 1054 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 403 1056 # define CURRENT_VC "/dev/vc/0" 404 1057 # define VC_1 "/dev/vc/1" … … 421 1074 # define VC_FORMAT "/dev/vc/%d" 422 1075 # define LOOP_FORMAT "/dev/loop/%d" 1076 # define LOOP_NAMESIZE (sizeof("/dev/loop/") + sizeof(int)*3 + 1) 1077 # define LOOP_NAME "/dev/loop/" 423 1078 # define FB_0 "/dev/fb/0" 424 1079 #else … … 440 1095 # define VC_FORMAT "/dev/tty%d" 441 1096 # define LOOP_FORMAT "/dev/loop%d" 1097 # define LOOP_NAMESIZE (sizeof("/dev/loop") + sizeof(int)*3 + 1) 1098 # define LOOP_NAME "/dev/loop" 442 1099 # define FB_0 "/dev/fb0" 443 1100 #endif 444 445 //#warning put these in .o files446 1101 447 1102 /* The following devices are the same on devfs and non-devfs systems. */ 448 1103 #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 548 1106 549 1107 #ifndef RB_POWER_OFF … … 552 1110 #endif 553 1111 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])) 555 1137 556 1138 #endif /* __LIBBUSYBOX_H__ */ -
branches/stable/mindi-busybox/include/platform.h
r902 r1770 12 12 #if defined __GNUC__ && defined __GNUC_MINOR__ 13 13 # define __GNUC_PREREQ(maj, min) \ 14 14 ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min)) 15 15 #else 16 16 # define __GNUC_PREREQ(maj, min) 0 … … 35 35 36 36 #undef inline 37 #if __STDC_VERSION__ > 199901L37 #if defined(__STDC_VERSION__) && __STDC_VERSION__ > 199901L 38 38 /* it's a keyword */ 39 39 #else … … 54 54 # define ATTRIBUTE_ALIGNED(m) __attribute__ ((__aligned__(m))) 55 55 # 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 57 64 # 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 */ 59 68 # endif 60 69 … … 134 143 135 144 /* ---- 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. */ 136 153 #ifndef __GNUC__ 137 154 #if defined __INTEL_COMPILER … … 141 158 #endif /* ifndef __GNUC__ */ 142 159 143 #if (defined __digital__ && defined __unix__)144 # undef HAVE_MNTENT_H145 #else146 # define HAVE_MNTENT_H 1147 #endif /* ___digital__ && __unix__ */148 149 160 /*----- Kernel versioning ------------------------------------*/ 150 161 #define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c)) … … 159 170 #endif 160 171 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. */ 162 173 163 174 #if defined __GLIBC__ || defined __UCLIBC__ \ … … 170 181 /* Largest integral types. */ 171 182 #if __BIG_ENDIAN__ 172 typedef long intintmax_t;173 typedef unsigned long intuintmax_t;183 typedef long intmax_t; 184 typedef unsigned long uintmax_t; 174 185 #else 175 186 __extension__ 176 typedef long long intintmax_t;187 typedef long long intmax_t; 177 188 __extension__ 178 typedef unsigned long long int uintmax_t; 179 #endif 180 #endif 181 182 /* uclibc does not implement daemon for no-mmu systems. 189 typedef 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... */ 196 typedef signed char smallint; 197 typedef unsigned char smalluint; 198 #else 199 /* for arches where byte accesses generate larger code: */ 200 typedef int smallint; 201 typedef 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. 183 225 * For 0.9.29 and svn, __ARCH_USE_MMU__ indicates no-mmu reliably. 184 226 * For earlier versions there is no reliable way to check if we are building … … 188 230 #if defined __UCLIBC__ && __UCLIBC_MAJOR__ >= 0 && __UCLIBC_MINOR__ >= 9 && \ 189 231 __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__ 191 241 #endif 192 242 … … 194 244 * libbb. This would require a platform.c. It's not going to be cleaned 195 245 * 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) */ 196 250 #define fdprintf dprintf 251 #endif 252 253 #if defined(__dietlibc__) 254 static 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 197 266 198 267 /* THIS SHOULD BE CLEANED OUT OF THE TREE ENTIRELY */ … … 209 278 #define PRIu32 "u" 210 279 211 /* use legacy setpgrp(pid t_,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) 213 282 214 283 #if !defined ADJ_OFFSET_SINGLESHOT && defined MOD_CLKA && defined MOD_OFFSET … … 226 295 227 296 #else 228 #define bb_setpgrp setpgrp()297 #define bb_setpgrp() setpgrp() 229 298 #endif 230 299 231 300 #if defined(__linux__) 232 301 #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 233 331 #if !defined(BLKSSZGET) 234 332 #define BLKSSZGET _IO(0x12, 104) -
branches/stable/mindi-busybox/include/pwd_.h
r821 r1770 1 /* vi: set sw=4 ts=4: */ 1 2 /* Copyright (C) 1991,92,95,96,97,98,99,2001 Free Software Foundation, Inc. 2 3 This file is part of the GNU C Library. … … 21 22 */ 22 23 23 #if !defined CONFIG_USE_BB_PWD_GRP 24 #if !ENABLE_USE_BB_PWD_GRP 25 24 26 #include <pwd.h> 25 27 … … 27 29 28 30 #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 34 32 35 33 /* 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. */ 34 struct 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. */ 45 42 }; 46 43 47 44 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 48 65 /* Rewind the password-file stream. */ 49 extern void setpwent 66 extern void setpwent(void); 50 67 51 68 /* Close the password-file stream. */ 52 extern void endpwent 69 extern void endpwent(void); 53 70 54 71 /* Read an entry from the password-file stream, opening it if necessary. */ 55 extern struct passwd *getpwent 72 extern struct passwd *getpwent(void); 56 73 57 74 /* Read an entry from STREAM. */ 58 extern struct passwd *fgetpwent 75 extern struct passwd *fgetpwent(FILE *__stream); 59 76 60 77 /* Write the given entry onto the given stream. */ 61 extern int putpwent 78 extern int putpwent(__const struct passwd *__restrict __p, 62 79 FILE *__restrict __f); 63 80 64 81 /* Search for an entry with a matching user ID. */ 65 extern struct passwd *getpwuid 82 extern struct passwd *getpwuid(uid_t __uid); 66 83 67 84 /* Search for an entry with a matching username. */ 68 extern struct passwd *getpwnam 85 extern struct passwd *getpwnam(__const char *__name); 69 86 70 87 /* Reentrant versions of some of the functions above. … … 76 93 POSIX people would choose. */ 77 94 78 extern int getpwent_r 95 extern int getpwent_r(struct passwd *__restrict __resultbuf, 79 96 char *__restrict __buffer, size_t __buflen, 80 97 struct passwd **__restrict __result); 81 98 82 extern int getpwuid_r 99 extern int getpwuid_r(uid_t __uid, 83 100 struct passwd *__restrict __resultbuf, 84 101 char *__restrict __buffer, size_t __buflen, 85 102 struct passwd **__restrict __result); 86 103 87 extern int getpwnam_r 104 extern int getpwnam_r(__const char *__restrict __name, 88 105 struct passwd *__restrict __resultbuf, 89 106 char *__restrict __buffer, size_t __buflen, 90 107 struct passwd **__restrict __result); 91 108 92 93 109 /* Read an entry from STREAM. This function is not standardized and 94 110 probably never will. */ 95 extern int fgetpwent_r 111 extern int fgetpwent_r(FILE *__restrict __stream, 96 112 struct passwd *__restrict __resultbuf, 97 113 char *__restrict __buffer, size_t __buflen, … … 101 117 in the given buffer. This knows the format that the caller 102 118 will expect, but this need not be the format of the password file. */ 103 extern int getpw 119 extern int getpw(uid_t __uid, char *__buffer); 104 120 105 121 #endif /* pwd.h */ -
branches/stable/mindi-busybox/include/shadow_.h
r821 r1770 1 /* vi: set sw=4 ts=4: */ 1 2 /* Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc. 2 3 This file is part of the GNU C Library. … … 17 18 02111-1307 USA. */ 18 19 19 /* Declaration of types and functions for shadow password suite .*/20 /* Declaration of types and functions for shadow password suite */ 20 21 21 #if !defined CONFIG_USE_BB_SHADOW 22 #if !ENABLE_USE_BB_SHADOW 23 22 24 #include <shadow.h> 25 23 26 #else 24 27 25 28 #ifndef _SHADOW_H 26 #define _SHADOW_H 29 #define _SHADOW_H 1 27 30 28 #include <stdio.h> 31 /* Paths to the user database files */ 32 #ifndef _PATH_SHADOW 33 #define _PATH_SHADOW "/etc/shadow" 34 #endif 29 35 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 */ 37 struct 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 */ 52 47 }; 53 48 54 49 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 57 63 58 /* Close database. */59 extern void endspent (void);60 64 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 */ 63 69 64 /* Get shadow entry matching NAME. */65 extern struct spwd *getspnam (__const char *__name);66 70 67 /* Read shadow entry from STRING.*/68 extern struct spwd *sgetspent (__const char *__string);71 /* Open database for reading */ 72 extern void setspent(void); 69 73 70 /* Read next shadow entry from STREAM.*/71 extern struct spwd *fgetspent (FILE *__stream);74 /* Close database */ 75 extern void endspent(void); 72 76 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 */ 78 extern struct spwd *getspent(void); 75 79 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 */ 81 extern struct spwd *getspnam(__const char *__name); 82 83 /* Read shadow entry from STRING */ 84 extern struct spwd *sgetspent(__const char *__string); 85 86 /* Read next shadow entry from STREAM */ 87 extern struct spwd *fgetspent(FILE *__stream); 88 89 /* Write line containing shadow password entry to stream */ 90 extern int putspent(__const struct spwd *__p, FILE *__stream); 91 92 /* Reentrant versions of some of the functions above */ 93 extern int getspent_r(struct spwd *__result_buf, char *__buffer, 78 94 size_t __buflen, struct spwd **__result); 79 95 80 extern int getspnam_r 96 extern int getspnam_r(__const char *__name, struct spwd *__result_buf, 81 97 char *__buffer, size_t __buflen, 82 98 struct spwd **__result); 83 99 84 extern int sgetspent_r 100 extern int sgetspent_r(__const char *__string, struct spwd *__result_buf, 85 101 char *__buffer, size_t __buflen, 86 102 struct spwd **__result); 87 103 88 extern int fgetspent_r 104 extern int fgetspent_r(FILE *__stream, struct spwd *__result_buf, 89 105 char *__buffer, size_t __buflen, 90 106 struct spwd **__result); 91 /* Protect password file against multi writers .*/92 extern int lckpwdf 107 /* Protect password file against multi writers */ 108 extern int lckpwdf(void); 93 109 94 /* Unlock password file .*/95 extern int ulckpwdf 110 /* Unlock password file */ 111 extern int ulckpwdf(void); 96 112 97 113 #endif /* shadow.h */ -
branches/stable/mindi-busybox/include/unarchive.h
r821 r1770 11 11 #define ARCHIVE_NOPRESERVE_PERM 64 12 12 13 #include <sys/types.h> 14 #include <stdio.h> 15 #include "libbb.h" 16 17 typedef struct file_headers_s { 13 typedef struct file_header_t { 18 14 char *name; 19 char *link_ name;15 char *link_target; 20 16 off_t size; 21 17 uid_t uid; … … 26 22 } file_header_t; 27 23 28 typedef struct archive_handle_ s{29 /* define if the header and data component should processed */30 char (*filter)(struct archive_handle_ s*);24 typedef struct archive_handle_t { 25 /* define if the header and data component should be processed */ 26 char (*filter)(struct archive_handle_t *); 31 27 llist_t *accept; 32 28 /* List of files that have been rejected */ … … 42 38 43 39 /* 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 *); 45 41 46 42 /* 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 *); 48 44 49 45 /* Contains the handle to a sub archive */ 50 struct archive_handle_ s*sub_archive;46 struct archive_handle_t *sub_archive; 51 47 52 48 /* The raw stream as read from disk or stdin */ … … 57 53 58 54 /* Function that skips data: read_by_char or read_by_skip */ 59 void (*seek)(const struct archive_handle_ s *archive_handle, const unsigned intamount);55 void (*seek)(const struct archive_handle_t *archive_handle, const unsigned amount); 60 56 61 57 /* Temporary storage */ … … 66 62 67 63 } archive_handle_t; 64 68 65 69 66 extern archive_handle_t *init_handle(void); … … 85 82 extern void header_verbose_list(const file_header_t *file_header); 86 83 87 extern void check_header_gzip (int src_fd);84 extern void check_header_gzip_or_die(int src_fd); 88 85 89 86 extern char get_header_ar(archive_handle_t *archive_handle); … … 94 91 extern char get_header_tar_gz(archive_handle_t *archive_handle); 95 92 96 extern void seek_by_jump(const archive_handle_t *archive_handle, const unsigned intamount);97 extern void seek_by_ char(const archive_handle_t *archive_handle, const unsigned intamount);93 extern void seek_by_jump(const archive_handle_t *archive_handle, const unsigned amount); 94 extern void seek_by_read(const archive_handle_t *archive_handle, const unsigned amount); 98 95 99 extern void archive_xread_all(const archive_handle_t *archive_handle, void *buf, const size_t count);100 96 extern ssize_t archive_xread_all_eof(archive_handle_t *archive_handle, unsigned char *buf, size_t count); 101 97 102 98 extern void data_align(archive_handle_t *archive_handle, const unsigned short boundary); 103 99 extern const llist_t *find_list_entry(const llist_t *list, const char *filename); 100 extern const llist_t *find_list_entry2(const llist_t *list, const char *filename); 104 101 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: */ 103 typedef struct bunzip_data bunzip_data; 104 int start_bunzip(bunzip_data **bdp, int in_fd, const unsigned char *inbuf, int len); 105 int read_bunzip(bunzip_data *bd, char *outbuf, int len); 106 void dealloc_bunzip(bunzip_data *bd); 111 107 112 extern int open_transformer(int src_fd, int (*transformer)(int src_fd, int dst_fd)); 108 typedef struct inflate_unzip_result { 109 off_t bytes_out; 110 uint32_t crc; 111 } inflate_unzip_result; 113 112 113 extern USE_DESKTOP(long long) int unpack_bz2_stream(int src_fd, int dst_fd); 114 extern USE_DESKTOP(long long) int inflate_unzip(inflate_unzip_result *res, unsigned bufsize, int src_fd, int dst_fd); 115 extern USE_DESKTOP(long long) int unpack_gz_stream(int src_fd, int dst_fd); 116 extern USE_DESKTOP(long long) int unpack_lzma_stream(int src_fd, int dst_fd); 117 118 #if BB_MMU 119 extern 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 123 extern 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 114 126 115 127 #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 1 11 #ifndef __BB_USAGE_H__ 2 12 #define __BB_USAGE_H__ 3 13 4 14 #define addgroup_trivial_usage \ 5 "[-g GID] group_name [user_name]"15 "[-g GID]"USE_FEATURE_ADDUSER_TO_GROUP(" [user_name]")" group_name" 6 16 #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" 10 20 11 21 #define adduser_trivial_usage \ 12 22 "[OPTIONS] user_name" 13 23 #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" 23 33 24 34 #define adjtimex_trivial_usage \ 25 35 "[-q] [-o offset] [-f frequency] [-p timeconstant] [-t tick]" 26 36 #define adjtimex_full_usage \ 27 "Reads and optionally setssystem 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" 36 46 37 47 #define ar_trivial_usage \ 38 48 "[-o] [-v] [-p] [-t] [-x] ARCHIVE FILES" 39 49 #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" 47 77 48 78 #define arping_trivial_usage \ 49 79 "[-fqbDUA] [-c count] [-w timeout] [-i device] [-s sender] target" 50 80 #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" 64 94 65 95 #define ash_trivial_usage \ 66 67 96 "[FILE]...\n" \ 97 "or: ash -c command [args]..." 68 98 #define ash_full_usage \ 69 99 "The ash shell (command interpreter)" 70 100 71 101 #define awk_trivial_usage \ 72 102 "[OPTION]... [program-text] [FILE ...]" 73 103 #define awk_full_usage \ 74 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" 78 108 79 109 #define basename_trivial_usage \ 80 110 "FILE [SUFFIX]" 81 111 #define basename_full_usage \ 82 "Stripsdirectory path and suffixes from FILE.\n" \83 "If specified, also removesany trailing SUFFIX."112 "Strip directory path and suffixes from FILE.\n" \ 113 "If specified, also remove any trailing SUFFIX." 84 114 #define basename_example_usage \ 85 86 87 88 89 90 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" 91 121 92 122 #define bunzip2_trivial_usage \ 93 123 "[OPTION]... [FILE]" 94 124 #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" 99 129 100 130 #define busybox_notes_usage \ 101 131 "Hello world!\n" 102 132 103 133 #define bzcat_trivial_usage \ 104 134 "FILE" 105 135 #define bzcat_full_usage \ 106 "Uncompress to stdout."136 "Uncompress to stdout" 107 137 108 138 #define unlzma_trivial_usage \ 109 139 "[OPTION]... [FILE]" 110 140 #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" 115 145 116 146 #define lzmacat_trivial_usage \ 117 147 "FILE" 118 148 #define lzmacat_full_usage \ 119 "Uncompress to stdout."149 "Uncompress to stdout" 120 150 121 151 #define cal_trivial_usage \ 122 152 "[-jy] [[month] year]" 123 153 #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" 128 158 129 159 #define cat_trivial_usage \ 130 160 "[-u] [FILE]..." 131 161 #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)" 135 165 #define cat_example_usage \ 136 137 166 "$ cat /proc/uptime\n" \ 167 "110716.72 17.67" 138 168 139 169 #define catv_trivial_usage \ 140 170 "[-etv] [FILE]..." 141 171 #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" 146 177 #define chattr_trivial_usage \ 147 178 "[-R] [-+=AacDdijsStTu] [-v version] files..." 148 179 #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" 169 239 170 240 #define chgrp_trivial_usage \ 171 "[OPTION]... GROUP FILE..."241 "[-RhLHP"USE_DESKTOP("cvf")"]... GROUP FILE..." 172 242 #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 ) 176 255 #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" 199 261 200 262 #define chown_trivial_usage \ 201 "[ -Rh ]...OWNER[<.|:>[GROUP]] FILE..."263 "[-RhLHP"USE_DESKTOP("cvf")"]... OWNER[<.|:>[GROUP]] FILE..." 202 264 #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 ) 207 277 #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" 216 351 217 352 #define chroot_trivial_usage \ 218 353 "NEWROOT [COMMAND...]" 219 354 #define chroot_full_usage \ 220 "Run COMMAND with root directory set to NEWROOT."355 "Run COMMAND with root directory set to NEWROOT" 221 356 #define chroot_example_usage \ 222 223 224 225 226 227 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" 228 363 229 364 #define chvt_trivial_usage \ 230 365 "N" 231 366 #define chvt_full_usage \ 232 "Changesthe foreground virtual terminal to /dev/ttyN"367 "Change the foreground virtual terminal to /dev/ttyN" 233 368 234 369 #define cksum_trivial_usage \ 235 370 "FILES..." 236 371 #define cksum_full_usage \ 237 "Calculates the CRC32 checksums of FILES."372 "Calculate the CRC32 checksums of FILES" 238 373 239 374 #define clear_trivial_usage \ 240 375 "" 241 376 #define clear_full_usage \ 242 "Clear screen."377 "Clear screen" 243 378 244 379 #define cmp_trivial_usage \ 245 "[-l] [-s] FILE1 [FILE2]"380 "[-l] [-s] FILE1 [FILE2" USE_DESKTOP(" [SKIP1 [SKIP2]") "]]" 246 381 #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\tfor 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" 252 387 253 388 #define comm_trivial_usage \ 254 389 "[-123] FILE1 FILE2" 255 390 #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" 261 396 262 397 #define bbconfig_trivial_usage \ 263 398 "" 264 399 #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" 266 423 267 424 #define cp_trivial_usage \ 268 425 "[OPTION]... SOURCE DEST" 269 426 #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" 279 440 280 441 #define cpio_trivial_usage \ 281 442 "-[dimtuv][F cpiofile]" 282 443 #define cpio_full_usage \ 283 284 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" 292 453 293 454 #define crond_trivial_usage \ 294 "-d[#] -c <crondir>-f -b"455 "-d[#] -c crondir -f -b" 295 456 #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" 304 465 305 466 #define crontab_trivial_usage \ 306 467 "[-c dir] {file|-}|[-u|-l|-e|-d user]" 307 468 #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)" 316 484 317 485 #define cut_trivial_usage \ 318 486 "[OPTION]... [FILE]..." 319 487 #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" 328 496 #define cut_example_usage \ 329 330 331 332 497 "$ echo \"Hello world\" | cut -f 1 -d ' '\n" \ 498 "Hello\n" \ 499 "$ echo \"Hello world\" | cut -f 2 -d ' '\n" \ 500 "world\n" 333 501 334 502 #define date_trivial_usage \ 335 503 "[OPTION]... [MMDDhhmm[[CC]YY][.ss]] [+FORMAT]" 336 504 #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" 351 519 #define date_example_usage \ 352 353 520 "$ date\n" \ 521 "Wed Apr 12 18:52:41 MDT 2000\n" 354 522 355 523 #define dc_trivial_usage \ 356 524 "expression ..." 357 525 #define dc_full_usage \ 358 359 360 361 "For example: 'dc 2 2 add' -> 4, and 'dc 8 8 \\* 2 2 + /' -> 16.\n" \362 "\nOptions:\n" \363 364 365 366 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" 367 535 #define dc_example_usage \ 368 369 370 371 372 373 374 375 376 377 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" 378 546 379 547 #define dd_trivial_usage \ 380 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]") 382 550 #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" \ 392 556 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)" 400 570 #define dd_example_usage \ 401 402 403 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" 404 574 405 575 #define deallocvt_trivial_usage \ 406 576 "[N]" 407 577 #define deallocvt_full_usage \ 408 578 "Deallocate unused virtual terminal /dev/ttyN" 409 579 410 580 #define delgroup_trivial_usage \ 411 "GROUP"581 USE_FEATURE_DEL_USER_FROM_GROUP("[USER] ")"GROUP" 412 582 #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") 414 585 415 586 #define deluser_trivial_usage \ 416 587 "USER" 417 588 #define deluser_full_usage \ 418 "Deletesuser USER from the system"589 "Delete user USER from the system" 419 590 420 591 #define devfsd_trivial_usage \ 421 592 "mntpnt [-v]" \ 422 593 USE_DEVFSD_FG_NP("[-fg][-np]" ) 423 594 #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") 433 605 434 606 #define df_trivial_usage \ 435 607 "[-" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILESYSTEM ...]" 436 608 #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" \ 439 610 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") 445 618 #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" 453 636 454 637 #define diff_trivial_usage \ 455 638 "[-abdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2" 456 639 #define diff_full_usage \ 457 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 anysubdirectories\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" 474 657 475 658 #define dirname_trivial_usage \ 476 659 "FILENAME" 477 660 #define dirname_full_usage \ 478 "Stripsnon-directory suffix from FILENAME"661 "Strip non-directory suffix from FILENAME" 479 662 #define dirname_example_usage \ 480 481 482 483 663 "$ dirname /tmp/foo\n" \ 664 "/tmp\n" \ 665 "$ dirname /tmp/foo/\n" \ 666 "/tmp\n" 484 667 485 668 #define dmesg_trivial_usage \ 486 669 "[-c] [-n LEVEL] [-s SIZE]" 487 670 #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" 493 676 494 677 #define dnsd_trivial_usage \ 495 678 "[-c config] [-t seconds] [-p port] [-i iface-ip] [-d]" 496 679 #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 ifaceip (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" 504 687 505 688 #define dos2unix_trivial_usage \ 506 689 "[option] [FILE]" 507 690 #define dos2unix_full_usage \ 508 "Converts FILE from dos format to unix format.When no option\n" \509 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" 514 697 515 698 #define dpkg_trivial_usage \ 516 699 "[-ilCPru] [-F option] package_name" 517 700 #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" 527 710 528 711 #define dpkg_deb_trivial_usage \ 529 712 "[-cefxX] FILE [argument]" 530 713 #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" 538 721 #define dpkg_deb_example_usage \ 539 722 "$ dpkg-deb -X ./busybox_0.48-1_i386.deb /tmp\n" 540 723 541 724 #define du_trivial_usage \ 542 725 "[-aHLdclsx" USE_FEATURE_HUMAN_READABLE("hm") "k] [FILE]..." 543 726 #define du_full_usage \ 544 "Summarizesdisk space used for each FILE and/or directory.\n" \545 727 "Summarize disk space used for each FILE and/or directory.\n" \ 728 "Disk space is printed in units of " \ 546 729 USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("1024") \ 547 730 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 symboliclinks that are FILE command line args\n" \552 "\t-L\tfollow all symboliclinks 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" \ 558 741 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" \ 561 744 ) \ 562 "\t-k\tprint sizes in kilobytes" \745 " -k Print sizes in kilobytes" \ 563 746 USE_FEATURE_DU_DEFAULT_BLOCKSIZE_1K("(default)") 564 747 #define du_example_usage \ 565 566 567 568 569 570 571 572 573 574 575 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" 576 759 577 760 #define dumpkmap_trivial_usage \ 578 761 "> keymap" 579 762 #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" 581 764 #define dumpkmap_example_usage \ 582 765 "$ dumpkmap > keymap\n" 583 766 584 767 #define dumpleases_trivial_usage \ 585 768 "[-r|-a] [-f LEASEFILE]" 586 769 #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" 592 775 593 776 #define e2fsck_trivial_usage \ 594 595 596 597 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" 598 781 #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" 612 795 613 796 #define echo_trivial_usage \ 614 797 USE_FEATURE_FANCY_ECHO("[-neE] ") "[ARG ...]" 615 798 #define echo_full_usage \ 616 "Prints the specified ARGs to stdout\n\n" \799 "Print the specified ARGs to stdout" \ 617 800 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" \ 622 805 ) 623 806 #define echo_example_usage \ 624 625 626 USE_FEATURE_FANCY_ECHO("$ 627 628 629 630 631 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") 632 815 633 816 #define eject_trivial_usage \ 634 "[-t] [DEVICE]"817 "[-t] [-T] [DEVICE]" 635 818 #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)" 639 823 640 824 #define ed_trivial_usage "" … … 642 826 643 827 #define env_trivial_usage \ 644 828 "[-iu] [-] [name=value]... [command]" 645 829 #define env_full_usage \ 646 "Prints the current environment or runsa 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" 651 835 652 836 #define ether_wake_trivial_usage \ 653 837 "[-b] [-i iface] [-p aa:bb:cc:dd[:ee:ff]] MAC" 654 838 #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" 662 856 663 857 #define expr_trivial_usage \ 664 858 "EXPRESSION" 665 859 #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." 696 889 697 890 #define fakeidentd_trivial_usage \ 698 "[-b ip] [STRING]"891 "[-fiw] [-b ADDR] [STRING]" 699 892 #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')" 703 900 704 901 #define false_trivial_usage \ 705 902 "" 706 903 #define false_full_usage \ 707 "Return an exit code of FALSE (1)."904 "Return an exit code of FALSE (1)" 708 905 #define false_example_usage \ 709 710 711 906 "$ false\n" \ 907 "$ echo $?\n" \ 908 "1\n" 712 909 713 910 #define fbset_trivial_usage \ 714 911 "[options] [mode]" 715 912 #define fbset_full_usage \ 716 913 "Show and modify frame buffer settings" 717 914 #define fbset_example_usage \ 718 719 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 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" 726 923 727 924 #define fdflush_trivial_usage \ 728 925 "DEVICE" 729 926 #define fdflush_full_usage \ 730 "Forcesfloppy disk drive to detect disk change"927 "Force floppy disk drive to detect disk change" 731 928 732 929 #define fdformat_trivial_usage \ 733 930 "[-n] DEVICE" 734 931 #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" 738 935 739 936 #define fdisk_trivial_usage \ 740 937 "[-luv] [-C CYLINDERS] [-H HEADS] [-S SECTORS] [-b SSZ] DISK" 741 938 #define fdisk_full_usage \ 742 "Change partition table\n" \743 "Options:\n" \744 "\t-lList partition table(s)\n" \745 "\t-uGive Start and End in sector (instead of cylinder) units\n" \746 "\t-s PARTITIONGive partition size(s) in blocks\n" \747 "\t-b 2048:(for certain MO disks) use 2048-byte sectors\n" \748 "\t-C CYLINDERSSet the number of cylinders\n" \749 "\t-H HEADSSet the number of heads\n" \750 "\t-S SECTORSSet the number of sectors\n" \751 "\t-vGive 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" 752 949 753 950 #define find_trivial_usage \ 754 951 "[PATH...] [EXPRESSION]" 755 952 #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)" \ 762 992 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") \ 779 1006 780 1007 #define find_example_usage \ 781 782 1008 "$ find / -name passwd\n" \ 1009 "/etc/passwd\n" 783 1010 784 1011 #define fold_trivial_usage \ 785 1012 "[-bs] [-w WIDTH] [FILE]" 786 1013 #define fold_full_usage \ 787 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" 793 1020 794 1021 #define free_trivial_usage \ 795 1022 "" 796 1023 #define free_full_usage \ 797 "Displaysthe amount of free and used system memory"1024 "Display the amount of free and used system memory" 798 1025 #define free_example_usage \ 799 800 801 802 803 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" \ 804 1031 805 1032 #define freeramdisk_trivial_usage \ 806 1033 "DEVICE" 807 1034 #define freeramdisk_full_usage \ 808 "Frees all memory used by the specified ramdisk."1035 "Free all memory used by the specified ramdisk" 809 1036 #define freeramdisk_example_usage \ 810 1037 "$ freeramdisk /dev/ram2\n" 811 1038 812 1039 #define fsck_trivial_usage \ 813 "[-ANPRTV] [ -C [ fd ]] [-t fstype] [fs-options] [filesys ...]"1040 "[-ANPRTV] [-C fd] [-t fstype] [fs-options] [filesys ...]" 814 1041 #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" 825 1052 826 1053 #define fsck_minix_trivial_usage \ 827 1054 "[-larvsmf] /dev/name" 828 1055 #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" 838 1065 839 1066 #define ftpget_trivial_usage \ 840 1067 "[options] remote-host local-file remote-file" 841 1068 #define ftpget_full_usage \ 842 "Retrieve a remote file via FTP.\n\n" \843 "Options:\n" \844 "\t-c, --continueContinue a previous transfer\n" \845 "\t-v, --verboseVerbose\n" \846 "\t-u, --usernameUsername to be used\n" \847 "\t-p, --passwordPassword to be used\n" \848 "\t-P, --portPort 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" 849 1076 850 1077 #define ftpput_trivial_usage \ 851 1078 "[options] remote-host remote-file local-file" 852 1079 #define ftpput_full_usage \ 853 "Store a local file on a remote machine via FTP.\n\n" \854 "Options:\n" \855 "\t-v, --verboseVerbose\n" \856 "\t-u, --usernameUsername to be used\n" \857 "\t-p, --passwordPassword to be used\n" \858 "\t-P, --portPort 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" 859 1086 860 1087 #define fuser_trivial_usage \ 861 1088 "[options] file OR port/proto" 862 1089 #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 870 1100 871 1101 #define getopt_trivial_usage \ 872 1102 "[OPTIONS]..." 873 1103 #define getopt_full_usage \ 874 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=optstringShort 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, --unquotedDo 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" 884 1114 #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" 904 1139 905 1140 #define getty_trivial_usage \ 906 1141 "[OPTIONS]... baud_rate,... line [termtype]" 907 1142 #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" 921 1156 922 1157 #define grep_trivial_usage \ 923 "[-ihHnqvs" \ 1158 "[-HhrilLnqvso" \ 1159 USE_DESKTOP("w") \ 1160 "eF" \ 924 1161 USE_FEATURE_GREP_EGREP_ALIAS("E") \ 925 1162 USE_FEATURE_GREP_CONTEXT("ABC") \ 926 1163 "] PATTERN [FILEs...]" 927 1164 #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") \ 947 1191 948 1192 #define grep_example_usage \ 949 950 951 952 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" 953 1197 954 1198 #define gunzip_trivial_usage \ 955 1199 "[OPTION]... FILE" 956 1200 #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" 962 1206 #define gunzip_example_usage \ 963 964 965 966 967 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" 968 1212 969 1213 #define gzip_trivial_usage \ 970 1214 "[OPTION]... [FILE]..." 971 1215 #define gzip_full_usage \ 972 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" 978 1222 #define gzip_example_usage \ 979 980 981 982 983 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" 984 1228 985 1229 #define halt_trivial_usage \ 986 "[-d<delay>] [-n<nosync>] [-f<force>]"1230 "[-d delay] [-n] [-f]" 987 1231 #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)" 993 1237 994 1238 #define hdparm_trivial_usage \ 995 1239 "[options] [device] .." 996 1240 #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" 1038 1290 1039 1291 #define head_trivial_usage \ 1040 1292 "[OPTION]... [FILE]..." 1041 1293 #define head_full_usage \ 1042 1043 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" \ 1047 1299 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") 1051 1303 #define head_example_usage \ 1052 1053 1054 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" 1055 1307 1056 1308 #define hexdump_trivial_usage \ 1057 1309 "[-[bcCdefnosvx]] [OPTION] FILE" 1058 1310 #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" 1073 1324 1074 1325 #define hostid_trivial_usage \ 1075 1326 "" 1076 1327 #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" 1078 1329 1079 1330 #define hostname_trivial_usage \ 1080 1331 "[OPTION] {hostname | -F FILE}" 1081 1332 #define hostname_full_usage \ 1082 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" 1090 1341 #define hostname_example_usage \ 1091 1092 1342 "$ hostname\n" \ 1343 "sage\n" 1093 1344 1094 1345 #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]") \ 1099 1351 USE_FEATURE_HTTPD_AUTH_MD5(" [-m pass]") \ 1100 1101 " [-d/-e <string>]"1352 " [-h home]" \ 1353 " [-d/-e string]" 1102 1354 #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" \ 1113 1371 1114 1372 #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]" 1116 1376 #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)" 1130 1385 1131 1386 #define id_trivial_usage \ 1132 1387 "[OPTIONS]... [USERNAME]" 1133 1388 #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" 1141 1398 #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" 1170 1401 1171 1402 #define ifconfig_trivial_usage \ 1172 US AGE_IFCONFIG_OPT_A("[-a]") " <interface> [<address>]"1403 USE_FEATURE_IFCONFIG_STATUS("[-a]") " interface [address]" 1173 1404 #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] ..." 1187 1421 1188 1422 #define ifup_trivial_usage \ 1189 "<-ahinv> <ifaces...>"1423 "[-ahinv] ifaces..." 1190 1424 #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" 1201 1433 1202 1434 #define ifdown_trivial_usage \ 1203 "<-ahinv> <ifaces...>"1435 "[-ahinv] ifaces..." 1204 1436 #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" 1215 1445 1216 1446 #define inetd_trivial_usage \ 1217 1447 "[-f] [-q len] [conf]" 1218 1448 #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)" 1224 1454 1225 1455 #define init_trivial_usage \ 1226 1456 "" 1227 1457 #define init_full_usage \ 1228 "Init is the parent of all processes."1458 "Init is the parent of all processes" 1229 1459 #define init_notes_usage \ 1230 1460 "This version of init is designed to be run only by the kernel.\n" \ 1231 1461 "\n" \ 1232 "BusyBox init doesn't support multiple runlevels. 1233 "the /etc/inittab file is completely ignored by BusyBox init. If you want 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" \ 1234 1464 "runlevels, use sysvinit.\n" \ 1235 1465 "\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" \ 1237 1467 "it has the following default behavior:\n" \ 1238 1468 "\n" \ … … 1258 1488 " WARNING: This field has a non-traditional meaning for BusyBox init!\n" \ 1259 1489 " The id field is used by BusyBox init to specify the controlling tty for\n" \ 1260 " the specified process to run on. 1261 " appended to \"/dev/\" and used as-is. 1262 " be unique, although if it isn't you may have strange results. 1263 " field is left blank, the controlling tty is set to the console. 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" \ 1264 1494 " note that if BusyBox detects that a serial console is in use, then only\n" \ 1265 1495 " 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" \ 1267 1497 " stinkin' utmp.\n" \ 1268 1498 "\n" \ … … 1282 1512 " Run only-once actions:\n" \ 1283 1513 "\n" \ 1284 " 'sysinit' is the first item run on boot. 1285 " sysinit actions are completed before continuing. 1514 " 'sysinit' is the first item run on boot. init waits until all\n" \ 1515 " sysinit actions are completed before continuing. Following the\n" \ 1286 1516 " completion of all sysinit actions, all 'wait' actions are run.\n" \ 1287 " 'wait' actions, like 1288 " the specified task completes. 1289 " therefore, init does not wait for them to complete. 1290 " the action taken to restart the init process. 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" \ 1291 1521 " 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. 1522 " can do all sorts of other interesting things. The 'ctrlaltdel' init\n" \ 1293 1523 " 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 " 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" \ 1296 1526 " 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" \ 1299 1529 "\n" \ 1300 1530 " Run repeatedly actions:\n" \ 1301 1531 "\n" \ 1302 " 'respawn' actions are run after the 'once' actions. 1532 " 'respawn' actions are run after the 'once' actions. When a process\n" \ 1303 1533 " started with a 'respawn' action exits, init automatically restarts\n" \ 1304 " it. 1305 " respawning out of control. 1534 " it. Unlike sysvinit, BusyBox init does not stop processes from\n" \ 1535 " respawning out of control. The 'askfirst' actions acts just like\n" \ 1306 1536 " respawn, except that before running the specified process it\n" \ 1307 1537 " displays the line \"Please press Enter to activate this console.\"\n" \ … … 1310 1540 "\n" \ 1311 1541 " Unrecognized actions (like initdefault) will cause init to emit an\n" \ 1312 " error message, and then go along with its business. 1542 " error message, and then go along with its business. All actions are\n" \ 1313 1543 " run in the order they appear in /etc/inittab.\n" \ 1314 1544 "\n" \ … … 1319 1549 "Example /etc/inittab file:\n" \ 1320 1550 "\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" \ 1322 1552 " #\n" \ 1323 1553 " ::sysinit:/etc/init.d/rcS\n" \ … … 1343 1573 " #::respawn:/sbin/getty -L ttyS1 9600 vt100\n" \ 1344 1574 " #\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" \ 1346 1576 " #::respawn:/sbin/getty 57600 ttyS2\n" \ 1347 1577 " \n" \ … … 1354 1584 " ::shutdown:/sbin/swapoff -a\n" 1355 1585 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" 1360 1982 #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" 1411 2016 #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" 1773 2026 1774 2027 #define md5sum_trivial_usage \ 1775 1776 US AGE_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]") 1777 2030 #define md5sum_full_usage \ 1778 "Print" USAGE_MD5_SHA1_SUM_CHECK(" or check") " MD5 checksums.\n\n" \1779 "Options:\n" \1780 1781 US AGE_MD5_SHA1_SUM_CHECK("\n\n" \1782 "\t-c\tcheck MD5 sums against given list\n" \1783 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") 1786 2039 #define md5sum_example_usage \ 1787 1788 1789 1790 1791 1792 1793 1794 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" 1795 2048 1796 2049 #define mdev_trivial_usage \ 1797 2050 "[-s]" 1798 2051 #define mdev_full_usage \ 1799 "\t-s\tScan /sys and populate /dev during system boot\n\n" \1800 1801 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." 1802 2055 #define mdev_notes_usage "" \ 1803 USE_FEATURE_MDEV_CONFIG( \1804 1805 1806 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" \ 1807 2060 USE_FEATURE_MDEV_EXEC( \ 1808 1809 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 1813 1814 "and * (run both after creating and before deleting).The commands run in\n" \1815 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" \ 1816 2069 ) \ 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 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 ) 1821 2074 1822 2075 #define mesg_trivial_usage \ 1823 2076 "[y|n]" 1824 2077 #define mesg_full_usage \ 1825 "mesg controlswrite 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" 1828 2081 1829 2082 #define mkdir_trivial_usage \ 1830 2083 "[OPTION] DIRECTORY..." 1831 2084 #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 1836 2093 #define mkdir_example_usage \ 1837 1838 1839 1840 1841 1842 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" 1843 2100 1844 2101 #define mke2fs_trivial_usage \ 1845 1846 1847 1848 1849 1850 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]" 1851 2108 #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" 1874 2131 1875 2132 #define mkfifo_trivial_usage \ 1876 2133 "[OPTIONS] name" 1877 2134 #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 ) 1881 2141 1882 2142 #define mkfs_minix_trivial_usage \ 1883 2143 "[-c | -l filename] [-nXX] [-iXX] /dev/name [blocks]" 1884 2144 #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" 1892 2152 1893 2153 #define mknod_trivial_usage \ 1894 2154 "[OPTIONS] NAME TYPE MAJOR MINOR" 1895 2155 #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 1903 2167 #define mknod_example_usage \ 1904 1905 2168 "$ mknod /dev/fd0 b 2 0\n" \ 2169 "$ mknod -m 644 /tmp/pipe p\n" 1906 2170 1907 2171 #define mkswap_trivial_usage \ 1908 2172 "[-c] [-v0|-v1] device [block-count]" 1909 2173 #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)" 1916 2180 1917 2181 #define mktemp_trivial_usage \ 1918 2182 "[-dq] TEMPLATE" 1919 2183 #define mktemp_full_usage \ 1920 "Createsa 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" 1925 2189 #define mktemp_example_usage \ 1926 1927 1928 1929 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" 1930 2194 1931 2195 #define modprobe_trivial_usage \ 1932 2196 "[-knqrsv] MODULE [symbol=value ...]" 1933 2197 #define modprobe_full_usage \ 1934 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" 1941 2205 #define modprobe_notes_usage \ 1942 2206 "modprobe can (un)load a stack of modules, passing each module options (when\n" \ … … 1982 2246 "file, and override them for a specific usage from the command line.\n" 1983 2247 #define modprobe_example_usage \ 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 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" 2000 2264 2001 2265 #define more_trivial_usage \ 2002 2266 "[FILE ...]" 2003 2267 #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" 2005 2269 #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:" 2010 2373 #else 2011 # define USAGE_MOUNT_LOOP(a)2374 #define NC_OPTIONS_STR 2012 2375 #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 2017 2439 #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_HOLE2108 # define USAGE_NC_EXEC(a) a2109 #else2110 # define USAGE_NC_EXEC(a)2111 #endif2112 #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"2133 2440 2134 2441 #define netstat_trivial_usage \ 2135 "[-laenrtuwx]"2442 "[-laentuwxr"USE_FEATURE_NETSTAT_WIDE("W")"]" 2136 2443 #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 ) 2148 2458 2149 2459 #define nice_trivial_usage \ 2150 2460 "[-n ADJUST] [COMMAND [ARG] ...]" 2151 2461 #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'" 2155 2489 2156 2490 #define nohup_trivial_usage \ 2157 2491 "COMMAND [ARGS]" 2158 2492 #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" 2160 2494 #define nohup_example_usage \ 2161 2495 "$ nohup make &" 2162 2496 2163 2497 #define nslookup_trivial_usage \ 2164 2498 "[HOST] [SERVER]" 2165 2499 #define nslookup_full_usage \ 2166 "Queriesthe nameserver for the IP address of the given HOST\n" \2167 2500 "Query the nameserver for the IP address of the given HOST\n" \ 2501 "optionally using a specified DNS server" 2168 2502 #define nslookup_example_usage \ 2169 2170 2171 2172 2173 2174 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" 2175 2509 2176 2510 #define od_trivial_usage \ 2177 2511 "[-aBbcDdeFfHhIiLlOovXx] [FILE]" 2178 2512 #define od_full_usage \ 2179 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." 2181 2515 2182 2516 #define openvt_trivial_usage \ 2183 "<vtnum> <COMMAND>[ARGS...]"2517 "VTNUM COMMAND [ARGS...]" 2184 2518 #define openvt_full_usage \ 2185 2519 "Start a command on a new virtual terminal" 2186 2520 #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 2194 2523 #define passwd_trivial_usage \ 2195 2524 "[OPTION] [name]" 2196 2525 #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" 2206 2543 2207 2544 #define patch_trivial_usage \ 2208 "[-p<num>] [-i <diff>]"2545 "[-p num] [-i diff]" 2209 2546 #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" 2212 2549 #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 2226 2553 #if (ENABLE_FEATURE_PIDOF_SINGLE || ENABLE_FEATURE_PIDOF_OMIT) 2227 2554 #define USAGE_PIDOF "Options:" 2228 2555 #else 2229 #define USAGE_PIDOF "\n \tThis version of pidof accepts no options."2556 #define USAGE_PIDOF "\nThis version of pidof accepts no options." 2230 2557 #endif 2231 2558 2232 2559 #define pidof_trivial_usage \ 2233 2560 "process-name [OPTION] [process-name ...]" 2234 2561 2235 2562 #define pidof_full_usage \ 2236 "Liststhe 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" \ 2238 2565 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") 2242 2572 #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" 2251 2589 #else 2252 2590 #define ping_trivial_usage \ 2253 2591 "[OPTION]... host" 2254 2592 #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" 2261 2611 #endif 2262 2612 #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" 2285 2620 #define ping6_example_usage \ 2286 2287 2288 2289 2290 2291 2292 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" 2293 2628 2294 2629 #define pivot_root_trivial_usage \ 2295 2630 "NEW_ROOT PUT_OLD" 2296 2631 #define pivot_root_full_usage \ 2297 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" 2299 2634 2300 2635 #define poweroff_trivial_usage \ 2301 "[-d<delay>] [-n<nosync>] [-f<force>]"2636 "[-d delay] [-n] [-f]" 2302 2637 #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)" 2308 2643 2309 2644 #define printenv_trivial_usage \ 2310 2645 "[VARIABLES...]" 2311 2646 #define printenv_full_usage \ 2312 "print all or part of environment\n\n" \2313 2647 "Print all or part of environment.\n" \ 2648 "If no environment VARIABLE specified, print them all." 2314 2649 2315 2650 #define printf_trivial_usage \ 2316 2651 "FORMAT [ARGUMENT...]" 2317 2652 #define printf_full_usage \ 2318 "Formats and printsARGUMENT(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" 2320 2655 #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 */ 2323 2670 2324 2671 #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" 2326 2673 #else 2327 2674 #define USAGE_PS "\nOptions:" 2328 2675 #endif 2329 #if ENABLE_FEATURE_PS_WIDE2330 #define USAGE_PS_WIDE(a) a2331 #else2332 #define USAGE_PS_WIDE(a)2333 #endif2334 2676 2335 2677 #define ps_trivial_usage \ 2336 2678 "" 2337 2679 #define ps_full_usage \ 2338 2680 "Report process status\n" \ 2339 2681 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 */ 2342 2688 2343 2689 #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)" \ 2355 2711 2356 2712 #define pwd_trivial_usage \ 2357 2713 "" 2358 2714 #define pwd_full_usage \ 2359 "Print the full filename of the current working directory."2715 "Print the full filename of the current working directory" 2360 2716 #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" 2363 2726 2364 2727 #define rdate_trivial_usage \ 2365 2728 "[-sp] HOST" 2366 2729 #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_FOLLOW2373 #define USAGE_READLINK_FOLLOW(a) a 2374 # else2375 #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" 2377 2740 2378 2741 #define readlink_trivial_usage \ 2379 US AGE_READLINK_FOLLOW("[-f] ") "FILE"2742 USE_FEATURE_READLINK_FOLLOW("[-f] ") "FILE" 2380 2743 #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") 2384 2748 2385 2749 #define readprofile_trivial_usage \ 2386 2750 "[OPTIONS]..." 2387 2751 #define readprofile_full_usage \ 2388 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" 2399 2763 2400 2764 #define realpath_trivial_usage \ 2401 "pathname..."2765 "pathname ..." 2402 2766 #define realpath_full_usage \ 2403 "Returns the absolute pathnames of given argument."2767 "Return the absolute pathnames of given argument" 2404 2768 2405 2769 #define reboot_trivial_usage \ 2406 "[-d<delay>] [-n<nosync>] [-f<force>]"2770 "[-d delay] [-n] [-f]" 2407 2771 #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)" 2413 2777 2414 2778 #define renice_trivial_usage \ 2415 "{{-n INCREMENT} | PRIORITY} [[ -p | -g | -u] ID ...]"2779 "{{-n INCREMENT} | PRIORITY} [[-p | -g | -u] ID ...]" 2416 2780 #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)" 2423 2787 2424 2788 #define reset_trivial_usage \ 2425 2789 "" 2426 2790 #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" 2428 2813 2429 2814 #define rm_trivial_usage \ 2430 2815 "[OPTION]... FILE..." 2431 2816 #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" 2438 2823 #define rm_example_usage \ 2439 2824 "$ rm -rf /tmp/foo\n" 2440 2825 2441 2826 #define rmdir_trivial_usage \ 2442 2827 "[OPTION]... DIRECTORY..." 2443 2828 #define rmdir_full_usage \ 2444 "Remove the DIRECTORY(ies), if they are empty."2829 "Remove the DIRECTORY, if it is empty" 2445 2830 #define rmdir_example_usage \ 2446 2831 "# rmdir /tmp/foo\n" 2447 2832 2448 2833 #define rmmod_trivial_usage \ 2449 2834 "[OPTION]... [MODULE]..." 2450 2835 #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)" 2454 2839 #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" 2463 2841 2464 2842 #define route_trivial_usage \ 2465 2843 "[{add|del|delete}]" 2466 2844 #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" 2472 2850 2473 2851 #define rpm_trivial_usage \ 2474 2852 "-i -q[ildc]p package.rpm" 2475 2853 #define rpm_full_usage \ 2476 "ManipulatesRPM packages" \2477 2478 "\n\t-iInstall package" \2479 "\n\t-qQuery package" \2480 "\n\t-pQuery uninstalled package" \2481 "\n\t-iShow information" \2482 "\n\t-lList contents" \2483 "\n\t-dList documents" \2484 "\n\t-cList 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" 2485 2863 2486 2864 #define rpm2cpio_trivial_usage \ 2487 2865 "package.rpm" 2488 2866 #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" \ 2490 2882 2491 2883 #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" 2493 2885 #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" \ 2891 USE_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" 2499 2906 2500 2907 #define runlevel_trivial_usage \ 2501 2908 "[utmp]" 2502 2909 #define runlevel_full_usage \ 2503 2504 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\"" 2506 2913 #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" 2509 2926 2510 2927 #define rx_trivial_usage \ 2511 2928 "FILE" 2512 2929 #define rx_full_usage \ 2513 "Receive a file using the xmodem protocol."2930 "Receive a file using the xmodem protocol" 2514 2931 #define rx_example_usage \ 2515 2932 "$ rx /tmp/foo\n" 2516 2933 2517 2934 #define sed_trivial_usage \ 2518 2935 "[-efinr] pattern [files...]" 2519 2936 #define sed_full_usage \ 2520 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 2528 2529 2530 "input files are specified, then the standard input is read.Source files\n" \2531 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." 2532 2949 2533 2950 #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 2536 2956 2537 2957 #define seq_trivial_usage \ 2538 2958 "[first [increment]] last" 2539 2959 #define seq_full_usage \ 2540 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" 2546 2966 2547 2967 #define setconsole_trivial_usage \ 2548 2968 "[-r|--reset] [DEVICE]" 2549 2969 #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" 2553 3002 2554 3003 #define setkeycodes_trivial_usage \ 2555 3004 "SCANCODE KEYCODE ..." 2556 3005 #define setkeycodes_full_usage \ 2557 2558 2559 2560 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" 2561 3010 #define setkeycodes_example_usage \ 2562 3011 "$ setkeycodes e030 127\n" 2563 3012 2564 3013 #define setlogcons_trivial_usage \ 2565 3014 "N" 2566 3015 #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)" 2568 3017 2569 3018 #define setsid_trivial_usage \ 2570 3019 "program [arg ...]" 2571 3020 #define setsid_full_usage \ 2572 "Runsany 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." 2574 3023 2575 3024 #define lash_trivial_usage \ 2576 2577 3025 "[FILE]...\n" \ 3026 "or: sh -c command [args]..." 2578 3027 #define lash_full_usage \ 2579 3028 "The BusyBox LAme SHell (command interpreter)" 2580 3029 #define lash_notes_usage \ 2581 2582 "Use lash just as you would use any other shell.It properly handles pipes,\n" \2583 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 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." 2588 3037 2589 3038 #define last_trivial_usage \ 2590 3039 "" 2591 3040 #define last_full_usage \ 2592 "Showslisting of the last users that logged into the system"3041 "Show listing of the last users that logged into the system" 2593 3042 2594 3043 #define sha1sum_trivial_usage \ 2595 2596 US AGE_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]") 2597 3046 #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" \ 2614 3069 2615 3070 #define sleep_trivial_usage \ 2616 US AGE_FANCY_SLEEP("[") "N" USAGE_FANCY_SLEEP("]...")3071 USE_FEATURE_FANCY_SLEEP("[") "N" USE_FEATURE_FANCY_SLEEP("]...") 2617 3072 #define sleep_full_usage \ 2618 USAGE_NOT_FANCY_SLEEP("Pause for N seconds.") \2619 US AGE_FANCY_SLEEP( \2620 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") 2622 3077 #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") 2633 3083 2634 3084 #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]..." 2636 3088 #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 "" 2661 3114 #define sort_example_usage \ 2662 2663 2664 2665 2666 2667 2668 2669 US AGE_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( \ 2670 3123 "$ echo -e \"c 3\\nb 2\\nd 2\" | $SORT -k 2,2n -k 1,1r\n" \ 2671 3124 "d 2\n" \ … … 2673 3126 "c 3\n" \ 2674 3127 ) \ 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" 2676 3140 2677 3141 #define start_stop_daemon_trivial_usage \ 2678 3142 "[OPTIONS] [--start|--stop] ... [-- arguments...]" 2679 3143 #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 2703 3164 #define stat_trivial_usage \ 2704 3165 "[OPTION] FILE..." 2705 3166 #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" \ 2753 3221 ) 2754 3222 2755 3223 #define strings_trivial_usage \ 2756 "[-afo] [-n length] [file ...]"3224 "[-afo] [-n length] [file ...]" 2757 3225 #define strings_full_usage \ 2758 "Display printable strings in a binary file." \2759 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" 2764 3232 2765 3233 #define stty_trivial_usage \ 2766 3234 "[-a|g] [-F DEVICE] [SETTING]..." 2767 3235 #define stty_full_usage \ 2768 "Without arguments, prints baud rate, line discipline," \2769 "\nand deviations from stty sane." \2770 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" 2775 3243 2776 3244 #define su_trivial_usage \ 2777 3245 "[OPTION]... [-] [username]" 2778 3246 #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" 2784 3252 2785 3253 #define sulogin_trivial_usage \ 2786 3254 "[OPTION]... [tty-device]" 2787 3255 #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" 2793 3259 2794 3260 #define sum_trivial_usage \ 2795 3261 "[rs] [files...]" 2796 3262 #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" 2801 3290 2802 3291 #define swapoff_trivial_usage \ 2803 3292 "[-a] [DEVICE]" 2804 3293 #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" 2808 3297 2809 3298 #define swapon_trivial_usage \ 2810 3299 "[-a] [DEVICE]" 2811 3300 #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" 2815 3304 2816 3305 #define switch_root_trivial_usage \ 2817 3306 "[-c /dev/console] NEW_ROOT NEW_INIT [ARGUMENTS_TO_INIT]" 2818 3307 #define switch_root_full_usage \ 2819 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" 2823 3312 2824 3313 #define sync_trivial_usage \ 2825 3314 "" 2826 3315 #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" 2845 3317 2846 3318 #define sysctl_trivial_usage \ 2847 3319 "[OPTIONS]... [VALUE]..." 2848 3320 #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" 2856 3328 #define sysctl_example_usage \ 2857 2858 2859 2860 "sysctl [-n] -p <file>\t(default /etc/sysctl.conf)\n" \2861 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" 2862 3334 2863 3335 #define syslogd_trivial_usage \ 2864 3336 "[OPTION]..." 2865 3337 #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)" */ 2881 3355 #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 2891 3359 #define tail_trivial_usage \ 2892 3360 "[OPTION]... [FILE]..." 2893 3361 #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)." ) 2907 3378 #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" 2941 3381 2942 3382 #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)] ..." 2946 3388 #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" 2966 3412 #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" 2969 3432 2970 3433 #define tee_trivial_usage \ 2971 3434 "[OPTION]... [FILE]..." 2972 3435 #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)" 2977 3440 #define tee_example_usage \ 2978 2979 2980 2981 2982 #if def CONFIG_FEATURE_TELNET_AUTOLOGIN3441 "$ echo \"Hello\" | tee /tmp/foo\n" \ 3442 "$ cat /tmp/foo\n" \ 3443 "Hello\n" 3444 3445 #if ENABLE_FEATURE_TELNET_AUTOLOGIN 2983 3446 #define telnet_trivial_usage \ 2984 3447 "[-a] [-l USER] HOST [PORT]" 2985 3448 #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." 2995 3457 #else 2996 3458 #define telnet_trivial_usage \ 2997 3459 "HOST [PORT]" 2998 3460 #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" 3001 3462 #endif 3002 3463 3003 #ifdef CONFIG_FEATURE_TELNETD_INETD3004 3464 #define telnetd_trivial_usage \ 3005 "(inetd mode)[OPTION]"3465 "[OPTION]" 3006 3466 #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 ) 3021 3478 3022 3479 #define test_trivial_usage \ 3023 3480 "EXPRESSION\n or [ EXPRESSION ]" 3024 3481 #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" 3027 3484 #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" 3056 3536 3057 3537 #define tftp_trivial_usage \ 3058 3538 "[OPTION]... HOST [PORT]" 3059 3539 #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 US AGE_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" \ 3066 3546 ) \ 3067 US AGE_TFTP_PUT( \3068 "\n\t-p\tPut file" \3547 USE_FEATURE_TFTP_PUT( \ 3548 "\n -p Put file" \ 3069 3549 ) \ 3070 US AGE_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" \ 3072 3552 ) 3073 3553 #define time_trivial_usage \ 3074 3554 "[OPTION]... COMMAND [ARGS...]" 3075 3555 #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" 3080 3560 3081 3561 #define top_trivial_usage \ 3082 "[-d <seconds>]"3562 "[-b] [-n count] [-d seconds]" 3083 3563 #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." 3089 3567 3090 3568 #define touch_trivial_usage \ 3091 3569 "[-c] FILE [FILE ...]" 3092 3570 #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" 3096 3574 #define touch_example_usage \ 3097 3098 3099 3100 3101 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" 3102 3580 3103 3581 #define tr_trivial_usage \ 3104 3582 "[-cds] STRING1 [STRING2]" 3105 3583 #define tr_full_usage \ 3106 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" 3112 3590 #define tr_example_usage \ 3113 3114 3591 "$ echo \"gdkkn vnqkc\" | tr [a-y] [b-z]\n" \ 3592 "hello world\n" 3115 3593 3116 3594 #define traceroute_trivial_usage \ 3117 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]" 3120 3598 #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)" 3141 3617 3142 3618 3143 3619 #define true_trivial_usage \ 3144 3620 "" 3145 3621 #define true_full_usage \ 3146 "Return an exit code of TRUE (0)."3622 "Return an exit code of TRUE (0)" 3147 3623 #define true_example_usage \ 3148 3149 3150 3624 "$ true\n" \ 3625 "$ echo $?\n" \ 3626 "0\n" 3151 3627 3152 3628 #define tty_trivial_usage \ 3153 3629 "" 3154 3630 #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") 3158 3635 #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" 3161 3643 3162 3644 #define tune2fs_trivial_usage \ 3163 3164 3165 3166 3167 3168 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" 3169 3651 #define tune2fs_full_usage \ 3170 "Adjust filesystem options on ext[23] filesystems."3652 "Adjust filesystem options on ext[23] filesystems" 3171 3653 3172 3654 #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]" 3174 3657 #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" \ 3190 3674 3191 3675 #define udhcpd_trivial_usage \ 3192 "[configfile]\n" \3676 "[-fS] [configfile]" \ 3193 3677 3194 3678 #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 3202 3683 #define umount_trivial_usage \ 3203 3684 "[flags] FILESYSTEM|DIRECTORY" 3204 3685 #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)") 3212 3697 #define umount_example_usage \ 3213 "$ umount /dev/hdc1\n"3698 "$ umount /dev/hdc1\n" 3214 3699 3215 3700 #define uname_trivial_usage \ 3216 3701 "[OPTION]..." 3217 3702 #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" 3227 3712 #define uname_example_usage \ 3228 3229 3713 "$ uname -a\n" \ 3714 "Linux debian 2.4.23 #2 Tue Dec 23 17:09:10 MST 2003 i686 GNU/Linux\n" 3230 3715 3231 3716 #define uncompress_trivial_usage \ 3232 "[-c] [-f] [ name ...]"3717 "[-c] [-f] [name...]" 3233 3718 #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" 3238 3735 3239 3736 #define uniq_trivial_usage \ 3240 3737 "[-fscdu]... [INPUT [OUTPUT]]" 3241 3738 #define uniq_full_usage \ 3242 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)" 3250 3747 #define uniq_example_usage \ 3251 3252 3253 3254 3748 "$ echo -e \"a\\na\\nb\\nc\\nc\\na\" | sort | uniq\n" \ 3749 "a\n" \ 3750 "b\n" \ 3751 "c\n" 3255 3752 3256 3753 #define unix2dos_trivial_usage \ 3257 3754 "[option] [FILE]" 3258 3755 #define unix2dos_full_usage \ 3259 "Converts FILE from unix format to dos format.When no option\n" \3260 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" 3265 3762 3266 3763 #define unzip_trivial_usage \ 3267 3764 "[-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]" 3268 3765 #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" 3278 3775 3279 3776 #define uptime_trivial_usage \ 3280 3777 "" 3281 3778 #define uptime_full_usage \ 3282 "Display the time since the last boot."3779 "Display the time since the last boot" 3283 3780 #define uptime_example_usage \ 3284 3285 3781 "$ uptime\n" \ 3782 " 1:55pm up 2:30, load average: 0.09, 0.04, 0.00\n" 3286 3783 3287 3784 #define usleep_trivial_usage \ 3288 3785 "N" 3289 3786 #define usleep_full_usage \ 3290 "Pause for N microseconds."3787 "Pause for N microseconds" 3291 3788 #define usleep_example_usage \ 3292 3293 3789 "$ usleep 1000000\n" \ 3790 "[pauses for 1 second]\n" 3294 3791 3295 3792 #define uudecode_trivial_usage \ 3296 "[FILE]..."3793 "[-o outfile] [infile]" 3297 3794 #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" 3301 3797 #define uudecode_example_usage \ 3302 3303 3304 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" 3305 3801 3306 3802 #define uuencode_trivial_usage \ 3307 "[OPTION] [INFILE] REMOTEFILE"3803 "[-m] [infile] stored_filename" 3308 3804 #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" 3312 3808 #define uuencode_example_usage \ 3313 3314 3315 3316 3317 3809 "$ uuencode busybox busybox\n" \ 3810 "begin 755 busybox\n" \ 3811 "<encoded file snipped>\n" \ 3812 "$ uudecode busybox busybox > busybox.uu\n" \ 3813 "$\n" 3318 3814 3319 3815 #define vconfig_trivial_usage \ 3320 3816 "COMMAND [OPTIONS] ..." 3321 3817 #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]" 3330 3826 3331 3827 #define vi_trivial_usage \ 3332 3828 "[OPTION] [FILE]..." 3333 3829 #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" 3337 3833 3338 3834 #define vlock_trivial_usage \ 3339 3835 "[OPTIONS]" 3340 3836 #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" 3344 3840 3345 3841 #define watch_trivial_usage \ 3346 "[-n <seconds>] COMMAND..."3842 "[-n seconds] [-t] COMMAND..." 3347 3843 #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" 3351 3848 #define watch_example_usage \ 3352 3353 3354 3355 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" 3356 3853 3357 3854 #define watchdog_trivial_usage \ 3358 "[-t <seconds>] [-F] DEV"3855 "[-t seconds] [-F] DEV" 3359 3856 #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" 3364 3861 3365 3862 #define wc_trivial_usage \ 3366 3863 "[OPTION]... [FILE]..." 3367 3864 #define wc_full_usage \ 3368 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" 3375 3872 #define wc_example_usage \ 3376 3377 3873 "$ wc /etc/passwd\n" \ 3874 " 31 46 1365 /etc/passwd\n" 3378 3875 3379 3876 #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" 3382 3880 #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')" 3390 3890 3391 3891 #define which_trivial_usage \ 3392 3892 "[COMMAND ...]" 3393 3893 #define which_full_usage \ 3394 "Locates a COMMAND."3894 "Locate a COMMAND" 3395 3895 #define which_example_usage \ 3396 3397 3896 "$ which login\n" \ 3897 "/bin/login\n" 3398 3898 3399 3899 #define who_trivial_usage \ 3400 3900 " " 3401 3901 #define who_full_usage \ 3402 "Printsthe current user names and related information"3902 "Print the current user names and related information" 3403 3903 3404 3904 #define whoami_trivial_usage \ 3405 3905 "" 3406 3906 #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" 3425 3908 3426 3909 #define xargs_trivial_usage \ 3427 "[COMMAND] [OPTIONS] [ARGS...]"3910 "[OPTIONS] [COMMAND] [ARGS...]" 3428 3911 #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" 3436 3922 #define xargs_example_usage \ 3437 3438 3923 "$ ls | xargs gzip\n" \ 3924 "$ find . -name '*.c' -print | xargs rm\n" 3439 3925 3440 3926 #define yes_trivial_usage \ 3441 3927 "[OPTION]... [STRING]..." 3442 3928 #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'" 3444 3930 3445 3931 #define zcat_trivial_usage \ 3446 3932 "FILE" 3447 3933 #define zcat_full_usage \ 3448 "Uncompress to stdout."3934 "Uncompress to stdout" 3449 3935 3450 3936 #define zcip_trivial_usage \ 3451 3937 "[OPTIONS] ifname script" 3452 3938 #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" 3459 3945 3460 3946 #endif /* __BB_USAGE_H__ */ -
branches/stable/mindi-busybox/include/xregex.h
r821 r1770 1 1 /* vi: set sw=4 ts=4: */ 2 2 /* 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. 19 5 * 20 6 * Based in part on code from sash, Copyright (c) 1999 by David I. Bell 21 7 * Permission has been granted to redistribute this code under the GPL. 22 8 * 9 * Licensed under GPLv2 or later, see file License in this tarball for details. 23 10 */ 24 11 #ifndef __BB_REGEX__ 25 12 #define __BB_REGEX__ 26 13 27 #include <sys/types.h>28 14 #include <regex.h> 29 extern void xregcomp(regex_t *preg, const char *regex, int cflags); 15 char* regcomp_or_errmsg(regex_t *preg, const char *regex, int cflags); 16 void xregcomp(regex_t *preg, const char *regex, int cflags); 30 17 31 18 #endif
Note:
See TracChangeset
for help on using the changeset viewer.