From 72089cf6b4a77214ec4fd21d5ee5bf56958781cb Mon Sep 17 00:00:00 2001 From: Denys Vlasenko Date: Fri, 21 Jul 2017 09:50:55 +0200 Subject: [PATCH] config: deindent all help texts Those two spaces after tab have no effect, and always a nuisance when editing. Signed-off-by: Denys Vlasenko --- Config.in | 618 ++++++++++++++++---------------- archival/Config.src | 4 +- archival/ar.c | 20 +- archival/bbunzip.c | 50 +-- archival/bzip2.c | 20 +- archival/cpio.c | 20 +- archival/dpkg.c | 8 +- archival/dpkg_deb.c | 8 +- archival/gzip.c | 28 +- archival/lzop.c | 12 +- archival/rpm.c | 2 +- archival/rpm2cpio.c | 2 +- archival/tar.c | 44 +-- archival/unzip.c | 16 +- console-tools/chvt.c | 4 +- console-tools/clear.c | 2 +- console-tools/deallocvt.c | 2 +- console-tools/dumpkmap.c | 4 +- console-tools/fgconsole.c | 2 +- console-tools/kbd_mode.c | 2 +- console-tools/loadfont.c | 10 +- console-tools/loadkmap.c | 4 +- console-tools/openvt.c | 4 +- console-tools/reset.c | 4 +- console-tools/resize.c | 12 +- console-tools/setconsole.c | 4 +- console-tools/setkeycodes.c | 4 +- console-tools/setlogcons.c | 2 +- console-tools/showkey.c | 2 +- coreutils/Config.src | 10 +- coreutils/basename.c | 6 +- coreutils/cat.c | 8 +- coreutils/chgrp.c | 2 +- coreutils/chmod.c | 2 +- coreutils/chown.c | 4 +- coreutils/chroot.c | 4 +- coreutils/cksum.c | 2 +- coreutils/comm.c | 4 +- coreutils/cp.c | 6 +- coreutils/cut.c | 4 +- coreutils/date.c | 28 +- coreutils/dd.c | 30 +- coreutils/df.c | 10 +- coreutils/dirname.c | 4 +- coreutils/dos2unix.c | 8 +- coreutils/du.c | 6 +- coreutils/echo.c | 2 +- coreutils/env.c | 6 +- coreutils/expand.c | 4 +- coreutils/expr.c | 10 +- coreutils/factor.c | 2 +- coreutils/false.c | 2 +- coreutils/fold.c | 2 +- coreutils/fsync.c | 2 +- coreutils/head.c | 4 +- coreutils/hostid.c | 4 +- coreutils/id.c | 4 +- coreutils/install.c | 2 +- coreutils/link.c | 2 +- coreutils/ln.c | 2 +- coreutils/logname.c | 2 +- coreutils/ls.c | 20 +- coreutils/md5_sha1_sum.c | 16 +- coreutils/mkdir.c | 2 +- coreutils/mkfifo.c | 4 +- coreutils/mknod.c | 4 +- coreutils/mktemp.c | 2 +- coreutils/mv.c | 2 +- coreutils/nice.c | 2 +- coreutils/nl.c | 2 +- coreutils/nohup.c | 2 +- coreutils/nproc.c | 2 +- coreutils/od.c | 2 +- coreutils/paste.c | 4 +- coreutils/printenv.c | 2 +- coreutils/printf.c | 4 +- coreutils/pwd.c | 2 +- coreutils/readlink.c | 6 +- coreutils/realpath.c | 4 +- coreutils/rm.c | 2 +- coreutils/rmdir.c | 6 +- coreutils/seq.c | 2 +- coreutils/shred.c | 2 +- coreutils/shuf.c | 2 +- coreutils/sleep.c | 22 +- coreutils/sort.c | 12 +- coreutils/split.c | 8 +- coreutils/stat.c | 12 +- coreutils/stty.c | 2 +- coreutils/sum.c | 2 +- coreutils/sync.c | 6 +- coreutils/tac.c | 2 +- coreutils/tail.c | 16 +- coreutils/tee.c | 6 +- coreutils/test.c | 12 +- coreutils/timeout.c | 4 +- coreutils/touch.c | 10 +- coreutils/tr.c | 18 +- coreutils/true.c | 2 +- coreutils/truncate.c | 4 +- coreutils/tty.c | 4 +- coreutils/uname.c | 8 +- coreutils/uniq.c | 2 +- coreutils/unlink.c | 2 +- coreutils/usleep.c | 2 +- coreutils/uudecode.c | 4 +- coreutils/uuencode.c | 2 +- coreutils/wc.c | 6 +- coreutils/who.c | 30 +- coreutils/whoami.c | 4 +- coreutils/yes.c | 4 +- debianutils/pipe_progress.c | 2 +- debianutils/run_parts.c | 20 +- debianutils/start_stop_daemon.c | 12 +- debianutils/which.c | 4 +- e2fsprogs/chattr.c | 2 +- e2fsprogs/fsck.c | 6 +- e2fsprogs/lsattr.c | 2 +- e2fsprogs/tune2fs.c | 4 +- editors/Config.src | 4 +- editors/awk.c | 18 +- editors/cmp.c | 4 +- editors/diff.c | 10 +- editors/ed.c | 6 +- editors/patch.c | 2 +- editors/sed.c | 4 +- editors/vi.c | 82 ++--- findutils/find.c | 66 ++-- findutils/grep.c | 12 +- findutils/xargs.c | 22 +- init/bootchartd.c | 42 +-- init/halt.c | 20 +- init/init.c | 86 ++--- libbb/Config.src | 286 +++++++-------- libbb/common_bufsiz.c | 46 +-- libbb/parse_config.c | 2 +- libbb/u_signal_names.c | 4 +- loginutils/Config.src | 104 +++--- loginutils/add-remove-shell.c | 16 +- loginutils/addgroup.c | 8 +- loginutils/adduser.c | 20 +- loginutils/chpasswd.c | 6 +- loginutils/cryptpw.c | 10 +- loginutils/deluser.c | 8 +- loginutils/getty.c | 22 +- loginutils/login.c | 30 +- loginutils/passwd.c | 14 +- loginutils/su.c | 8 +- loginutils/sulogin.c | 4 +- loginutils/vlock.c | 6 +- mailutils/Config.src | 2 +- mailutils/makemime.c | 2 +- mailutils/popmaildir.c | 12 +- mailutils/reformime.c | 6 +- mailutils/sendmail.c | 2 +- miscutils/adjtimex.c | 4 +- miscutils/bbconfig.c | 18 +- miscutils/beep.c | 6 +- miscutils/chat.c | 40 +-- miscutils/conspy.c | 8 +- miscutils/crond.c | 40 +-- miscutils/crontab.c | 8 +- miscutils/dc.c | 8 +- miscutils/devfsd.c | 45 ++- miscutils/devmem.c | 4 +- miscutils/fbsplash.c | 16 +- miscutils/flash_eraseall.c | 4 +- miscutils/flash_lock_unlock.c | 8 +- miscutils/flashcp.c | 4 +- miscutils/hdparm.c | 32 +- miscutils/i2c_tools.c | 8 +- miscutils/inotifyd.c | 4 +- miscutils/less.c | 36 +- miscutils/lsscsi.c | 6 +- miscutils/makedevs.c | 22 +- miscutils/man.c | 2 +- miscutils/microcom.c | 2 +- miscutils/mt.c | 6 +- miscutils/nandwrite.c | 4 +- miscutils/partprobe.c | 2 +- miscutils/raidautorun.c | 4 +- miscutils/readahead.c | 18 +- miscutils/rfkill.c | 10 +- miscutils/runlevel.c | 6 +- miscutils/rx.c | 2 +- miscutils/setserial.c | 2 +- miscutils/strings.c | 4 +- miscutils/time.c | 6 +- miscutils/ttysize.c | 8 +- miscutils/ubi_tools.c | 12 +- miscutils/ubirename.c | 2 +- miscutils/volname.c | 2 +- miscutils/watchdog.c | 12 +- modutils/Config.src | 150 ++++---- modutils/depmod.c | 6 +- modutils/insmod.c | 2 +- modutils/lsmod.c | 8 +- modutils/modinfo.c | 2 +- modutils/modprobe.c | 14 +- modutils/rmmod.c | 2 +- networking/Config.src | 42 +-- networking/arp.c | 2 +- networking/arping.c | 2 +- networking/brctl.c | 18 +- networking/dnsd.c | 2 +- networking/ether-wake.c | 2 +- networking/ftpd.c | 16 +- networking/ftpgetput.c | 4 +- networking/hostname.c | 4 +- networking/httpd.c | 96 ++--- networking/ifconfig.c | 24 +- networking/ifenslave.c | 4 +- networking/ifplugd.c | 2 +- networking/ifupdown.c | 64 ++-- networking/inetd.c | 14 +- networking/ip.c | 40 +-- networking/ipcalc.c | 8 +- networking/isrv_identd.c | 4 +- networking/nameif.c | 34 +- networking/nbd-client.c | 2 +- networking/nc.c | 20 +- networking/netstat.c | 10 +- networking/nslookup.c | 2 +- networking/ntpd.c | 10 +- networking/ping.c | 10 +- networking/pscan.c | 2 +- networking/route.c | 2 +- networking/slattach.c | 4 +- networking/ssl_client.c | 2 +- networking/tcpudp.c | 8 +- networking/telnet.c | 18 +- networking/telnetd.c | 58 +-- networking/tftp.c | 40 +-- networking/traceroute.c | 8 +- networking/tunctl.c | 6 +- networking/udhcp/Config.src | 128 +++---- networking/udhcp/d6_dhcpc.c | 14 +- networking/vconfig.c | 2 +- networking/wget.c | 120 +++---- networking/whois.c | 2 +- networking/zcip.c | 10 +- printutils/lpd.c | 2 +- printutils/lpr.c | 4 +- procps/Config.src | 4 +- procps/free.c | 6 +- procps/fuser.c | 6 +- procps/iostat.c | 2 +- procps/kill.c | 20 +- procps/lsof.c | 4 +- procps/mpstat.c | 2 +- procps/nmeter.c | 2 +- procps/pgrep.c | 4 +- procps/pidof.c | 12 +- procps/pmap.c | 8 +- procps/powertop.c | 6 +- procps/ps.c | 16 +- procps/pstree.c | 2 +- procps/pwdx.c | 2 +- procps/smemcap.c | 4 +- procps/sysctl.c | 2 +- procps/top.c | 30 +- procps/uptime.c | 8 +- procps/watch.c | 4 +- runit/chpst.c | 14 +- runit/runsv.c | 4 +- runit/runsvdir.c | 12 +- runit/sv.c | 12 +- runit/svlogd.c | 6 +- selinux/chcon.c | 2 +- selinux/getenforce.c | 2 +- selinux/getsebool.c | 2 +- selinux/load_policy.c | 2 +- selinux/matchpathcon.c | 4 +- selinux/runcon.c | 2 +- selinux/selinuxenabled.c | 4 +- selinux/sestatus.c | 2 +- selinux/setenforce.c | 2 +- selinux/setfiles.c | 16 +- selinux/setsebool.c | 4 +- shell/Config.src | 124 +++---- shell/ash.c | 50 +-- shell/cttyhack.c | 54 +-- shell/hush.c | 54 +-- sysklogd/klogd.c | 26 +- sysklogd/logger.c | 8 +- sysklogd/logread.c | 18 +- sysklogd/syslogd.c | 82 ++--- util-linux/Config.src | 60 ++-- util-linux/acpid.c | 18 +- util-linux/blkdiscard.c | 2 +- util-linux/blkid.c | 8 +- util-linux/blockdev.c | 2 +- util-linux/cal.c | 2 +- util-linux/chrt.c | 4 +- util-linux/dmesg.c | 40 +-- util-linux/eject.c | 6 +- util-linux/fallocate.c | 2 +- util-linux/fatattr.c | 2 +- util-linux/fbset.c | 22 +- util-linux/fdformat.c | 2 +- util-linux/fdisk.c | 42 +-- util-linux/findfs.c | 6 +- util-linux/flock.c | 2 +- util-linux/freeramdisk.c | 26 +- util-linux/fsck_minix.c | 12 +- util-linux/fsfreeze.c | 2 +- util-linux/fstrim.c | 2 +- util-linux/getopt.c | 14 +- util-linux/hexdump.c | 14 +- util-linux/hexdump_xxd.c | 4 +- util-linux/hwclock.c | 18 +- util-linux/ionice.c | 4 +- util-linux/ipcrm.c | 6 +- util-linux/ipcs.c | 4 +- util-linux/last.c | 6 +- util-linux/losetup.c | 6 +- util-linux/lspci.c | 6 +- util-linux/lsusb.c | 6 +- util-linux/mdev.c | 34 +- util-linux/mesg.c | 14 +- util-linux/mkfs_ext2.c | 4 +- util-linux/mkfs_minix.c | 12 +- util-linux/mkfs_reiser.c | 4 +- util-linux/mkfs_vfat.c | 4 +- util-linux/mkswap.c | 18 +- util-linux/more.c | 10 +- util-linux/mount.c | 62 ++-- util-linux/mountpoint.c | 2 +- util-linux/nsenter.c | 6 +- util-linux/pivot_root.c | 12 +- util-linux/rdate.c | 8 +- util-linux/rdev.c | 2 +- util-linux/readprofile.c | 2 +- util-linux/renice.c | 4 +- util-linux/rev.c | 2 +- util-linux/rtcwake.c | 2 +- util-linux/script.c | 2 +- util-linux/scriptreplay.c | 4 +- util-linux/setarch.c | 12 +- util-linux/setpriv.c | 24 +- util-linux/setsid.c | 2 +- util-linux/swaponoff.c | 18 +- util-linux/switch_root.c | 24 +- util-linux/taskset.c | 10 +- util-linux/uevent.c | 4 +- util-linux/umount.c | 10 +- util-linux/unshare.c | 2 +- util-linux/volume_id/exfat.c | 6 +- util-linux/volume_id/f2fs.c | 8 +- util-linux/volume_id/nilfs.c | 18 +- util-linux/volume_id/squashfs.c | 8 +- util-linux/volume_id/ubifs.c | 4 +- util-linux/wall.c | 2 +- 353 files changed, 2643 insertions(+), 2644 deletions(-) diff --git a/Config.in b/Config.in index cf72287be..c1cc591f3 100644 --- a/Config.in +++ b/Config.in @@ -15,314 +15,314 @@ config DESKTOP bool "Enable compatibility for full-blown desktop systems" default y help - Enable applet options and features which are not essential. - Many applet options have dedicated config options to (de)select them - under that applet; this options enables those options which have no - individual config item for them. + Enable applet options and features which are not essential. + Many applet options have dedicated config options to (de)select them + under that applet; this options enables those options which have no + individual config item for them. - Select this if you plan to use busybox on full-blown desktop machine - with common Linux distro, which needs higher level of command-line - compatibility. + Select this if you plan to use busybox on full-blown desktop machine + with common Linux distro, which needs higher level of command-line + compatibility. - If you are preparing your build to be used on an embedded box - where you have tighter control over the entire set of userspace - tools, you can unselect this option for smaller code size. + If you are preparing your build to be used on an embedded box + where you have tighter control over the entire set of userspace + tools, you can unselect this option for smaller code size. config EXTRA_COMPAT bool "Provide compatible behavior for rare corner cases (bigger code)" default n help - This option makes grep, sed etc handle rare corner cases - (embedded NUL bytes and such). This makes code bigger and uses - some GNU extensions in libc. You probably only need this option - if you plan to run busybox on desktop. + This option makes grep, sed etc handle rare corner cases + (embedded NUL bytes and such). This makes code bigger and uses + some GNU extensions in libc. You probably only need this option + if you plan to run busybox on desktop. config INCLUDE_SUSv2 bool "Enable obsolete features removed before SUSv3" default y help - This option will enable backwards compatibility with SuSv2, - specifically, old-style numeric options ('command -1 ') - will be supported in head, tail, and fold. (Note: should - affect renice too.) + This option will enable backwards compatibility with SuSv2, + specifically, old-style numeric options ('command -1 ') + will be supported in head, tail, and fold. (Note: should + affect renice too.) config LONG_OPTS bool "Support --long-options" default y help - Enable this if you want busybox applets to use the gnu --long-option - style, in addition to single character -a -b -c style options. + Enable this if you want busybox applets to use the gnu --long-option + style, in addition to single character -a -b -c style options. config SHOW_USAGE bool "Show applet usage messages" default y help - Enabling this option, BusyBox applets will show terse help messages - when invoked with wrong arguments. - If you do not want to show any (helpful) usage message when - issuing wrong command syntax, you can say 'N' here, - saving approximately 7k. + Enabling this option, BusyBox applets will show terse help messages + when invoked with wrong arguments. + If you do not want to show any (helpful) usage message when + issuing wrong command syntax, you can say 'N' here, + saving approximately 7k. config FEATURE_VERBOSE_USAGE bool "Show verbose applet usage messages" default y depends on SHOW_USAGE help - All BusyBox applets will show verbose help messages when - busybox is invoked with --help. This will add a lot of text to the - busybox binary. In the default configuration, this will add about - 13k, but it can add much more depending on your configuration. + All BusyBox applets will show verbose help messages when + busybox is invoked with --help. This will add a lot of text to the + busybox binary. In the default configuration, this will add about + 13k, but it can add much more depending on your configuration. config FEATURE_COMPRESS_USAGE bool "Store applet usage messages in compressed form" default y depends on SHOW_USAGE help - Store usage messages in .bz compressed form, uncompress them - on-the-fly when --help is called. + Store usage messages in .bz compressed form, uncompress them + on-the-fly when --help is called. - If you have a really tiny busybox with few applets enabled (and - bunzip2 isn't one of them), the overhead of the decompressor might - be noticeable. Also, if you run executables directly from ROM - and have very little memory, this might not be a win. Otherwise, - you probably want this. + If you have a really tiny busybox with few applets enabled (and + bunzip2 isn't one of them), the overhead of the decompressor might + be noticeable. Also, if you run executables directly from ROM + and have very little memory, this might not be a win. Otherwise, + you probably want this. config LFS bool "Support files > 2 GB" default y help - If you want to build BusyBox with large file support, then enable - this option. This will have no effect if your kernel or your C - library lacks large file support for large files. Some of the - programs that can benefit from large file support include dd, gzip, - cp, mount, tar, and many others. If you want to access files larger - than 2 Gigabytes, enable this option. + If you want to build BusyBox with large file support, then enable + this option. This will have no effect if your kernel or your C + library lacks large file support for large files. Some of the + programs that can benefit from large file support include dd, gzip, + cp, mount, tar, and many others. If you want to access files larger + than 2 Gigabytes, enable this option. config PAM bool "Support PAM (Pluggable Authentication Modules)" default n help - Use PAM in some busybox applets (currently login and httpd) instead - of direct access to password database. + Use PAM in some busybox applets (currently login and httpd) instead + of direct access to password database. config FEATURE_DEVPTS bool "Use the devpts filesystem for Unix98 PTYs" default y help - Enable if you want BusyBox to use Unix98 PTY support. If enabled, - busybox will use /dev/ptmx for the master side of the pseudoterminal - and /dev/pts/ for the slave side. Otherwise, BSD style - /dev/ttyp will be used. To use this option, you should have - devpts mounted. + Enable if you want BusyBox to use Unix98 PTY support. If enabled, + busybox will use /dev/ptmx for the master side of the pseudoterminal + and /dev/pts/ for the slave side. Otherwise, BSD style + /dev/ttyp will be used. To use this option, you should have + devpts mounted. config FEATURE_UTMP bool "Support utmp file" default y help - The file /var/run/utmp is used to track who is currently logged in. - With this option on, certain applets (getty, login, telnetd etc) - will create and delete entries there. - "who" applet requires this option. + The file /var/run/utmp is used to track who is currently logged in. + With this option on, certain applets (getty, login, telnetd etc) + will create and delete entries there. + "who" applet requires this option. config FEATURE_WTMP bool "Support wtmp file" default y depends on FEATURE_UTMP help - The file /var/run/wtmp is used to track when users have logged into - and logged out of the system. - With this option on, certain applets (getty, login, telnetd etc) - will append new entries there. - "last" applet requires this option. + The file /var/run/wtmp is used to track when users have logged into + and logged out of the system. + With this option on, certain applets (getty, login, telnetd etc) + will append new entries there. + "last" applet requires this option. config FEATURE_PIDFILE bool "Support writing pidfiles" default y help - This option makes some applets (e.g. crond, syslogd, inetd) write - a pidfile at the configured PID_FILE_PATH. It has no effect - on applets which require pidfiles to run. + This option makes some applets (e.g. crond, syslogd, inetd) write + a pidfile at the configured PID_FILE_PATH. It has no effect + on applets which require pidfiles to run. config PID_FILE_PATH string "Directory for pidfiles" default "/var/run" depends on FEATURE_PIDFILE help - This is the default path where pidfiles are created. Applets which - allow you to set the pidfile path on the command line will override - this value. The option has no effect on applets that require you to - specify a pidfile path. + This is the default path where pidfiles are created. Applets which + allow you to set the pidfile path on the command line will override + this value. The option has no effect on applets that require you to + specify a pidfile path. config BUSYBOX bool "Include busybox applet" default y help - The busybox applet provides general help regarding busybox and - allows the included applets to be listed. It's also required - if applet links are to be installed at runtime. If you unselect - this option, running busybox without any arguments will give - just a cryptic error message: + The busybox applet provides general help regarding busybox and + allows the included applets to be listed. It's also required + if applet links are to be installed at runtime. If you unselect + this option, running busybox without any arguments will give + just a cryptic error message: - $ busybox - busybox: applet not found + $ busybox + busybox: applet not found - Running "busybox APPLET [ARGS...]" will still work, of course. + Running "busybox APPLET [ARGS...]" will still work, of course. config FEATURE_INSTALLER bool "Support --install [-s] to install applet links at runtime" default y depends on BUSYBOX help - Enable 'busybox --install [-s]' support. This will allow you to use - busybox at runtime to create hard links or symlinks for all the - applets that are compiled into busybox. + Enable 'busybox --install [-s]' support. This will allow you to use + busybox at runtime to create hard links or symlinks for all the + applets that are compiled into busybox. config INSTALL_NO_USR bool "Don't use /usr" default n help - Disable use of /usr. busybox --install and "make install" - will install applets only to /bin and /sbin, - never to /usr/bin or /usr/sbin. + Disable use of /usr. busybox --install and "make install" + will install applets only to /bin and /sbin, + never to /usr/bin or /usr/sbin. config FEATURE_SUID bool "Drop SUID state for most applets" default y help - With this option you can install the busybox binary belonging - to root with the suid bit set, enabling some applets to perform - root-level operations even when run by ordinary users - (for example, mounting of user mounts in fstab needs this). + With this option you can install the busybox binary belonging + to root with the suid bit set, enabling some applets to perform + root-level operations even when run by ordinary users + (for example, mounting of user mounts in fstab needs this). - With this option enabled, Busybox drops privileges for applets - that don't need root access, before entering their main() function. + With this option enabled, Busybox drops privileges for applets + that don't need root access, before entering their main() function. - If you are really paranoid and don't want even initial busybox code - to run under root for evey applet, build two busybox binaries with - different applets in them (and the appropriate symlinks pointing - to each binary), and only set the suid bit on the one that needs it. + If you are really paranoid and don't want even initial busybox code + to run under root for evey applet, build two busybox binaries with + different applets in them (and the appropriate symlinks pointing + to each binary), and only set the suid bit on the one that needs it. - Some applets which require root rights (need suid bit on the binary - or to be run by root) and will refuse to execute otherwise: - crontab, login, passwd, su, vlock, wall. + Some applets which require root rights (need suid bit on the binary + or to be run by root) and will refuse to execute otherwise: + crontab, login, passwd, su, vlock, wall. - The applets which will use root rights if they have them - (via suid bit, or because run by root), but would try to work - without root right nevertheless: - findfs, ping[6], traceroute[6], mount. + The applets which will use root rights if they have them + (via suid bit, or because run by root), but would try to work + without root right nevertheless: + findfs, ping[6], traceroute[6], mount. - Note that if you DO NOT select this option, but DO make busybox - suid root, ALL applets will run under root, which is a huge - security hole (think "cp /some/file /etc/passwd"). + Note that if you DO NOT select this option, but DO make busybox + suid root, ALL applets will run under root, which is a huge + security hole (think "cp /some/file /etc/passwd"). config FEATURE_SUID_CONFIG bool "Enable SUID configuration via /etc/busybox.conf" default y depends on FEATURE_SUID help - Allow the SUID/SGID state of an applet to be determined at runtime - by checking /etc/busybox.conf. (This is sort of a poor man's sudo.) - The format of this file is as follows: - - APPLET = [Ssx-][Ssx-][x-] [USER.GROUP] - - s: USER or GROUP is allowed to execute APPLET. - APPLET will run under USER or GROUP - (reagardless of who's running it). - S: USER or GROUP is NOT allowed to execute APPLET. - APPLET will run under USER or GROUP. - This option is not very sensical. - x: USER/GROUP/others are allowed to execute APPLET. - No UID/GID change will be done when it is run. - -: USER/GROUP/others are not allowed to execute APPLET. - - An example might help: - - [SUID] - su = ssx root.0 # applet su can be run by anyone and runs with - # euid=0,egid=0 - su = ssx # exactly the same - - mount = sx- root.disk # applet mount can be run by root and members - # of group disk (but not anyone else) - # and runs with euid=0 (egid is not changed) - - cp = --- # disable applet cp for everyone - - The file has to be owned by user root, group root and has to be - writeable only by root: - (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf) - The busybox executable has to be owned by user root, group - root and has to be setuid root for this to work: - (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox) - - Robert 'sandman' Griebl has more information here: - . + Allow the SUID/SGID state of an applet to be determined at runtime + by checking /etc/busybox.conf. (This is sort of a poor man's sudo.) + The format of this file is as follows: + + APPLET = [Ssx-][Ssx-][x-] [USER.GROUP] + + s: USER or GROUP is allowed to execute APPLET. + APPLET will run under USER or GROUP + (regardless of who's running it). + S: USER or GROUP is NOT allowed to execute APPLET. + APPLET will run under USER or GROUP. + This option is not very sensical. + x: USER/GROUP/others are allowed to execute APPLET. + No UID/GID change will be done when it is run. + -: USER/GROUP/others are not allowed to execute APPLET. + + An example might help: + + |[SUID] + |su = ssx root.0 # applet su can be run by anyone and runs with + | # euid=0,egid=0 + |su = ssx # exactly the same + | + |mount = sx- root.disk # applet mount can be run by root and members + | # of group disk (but not anyone else) + | # and runs with euid=0 (egid is not changed) + | + |cp = --- # disable applet cp for everyone + + The file has to be owned by user root, group root and has to be + writeable only by root: + (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf) + The busybox executable has to be owned by user root, group + root and has to be setuid root for this to work: + (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox) + + Robert 'sandman' Griebl has more information here: + . config FEATURE_SUID_CONFIG_QUIET bool "Suppress warning message if /etc/busybox.conf is not readable" default y depends on FEATURE_SUID_CONFIG help - /etc/busybox.conf should be readable by the user needing the SUID, - check this option to avoid users to be notified about missing - permissions. + /etc/busybox.conf should be readable by the user needing the SUID, + check this option to avoid users to be notified about missing + permissions. config FEATURE_PREFER_APPLETS bool "exec prefers applets" default n help - This is an experimental option which directs applets about to - call 'exec' to try and find an applicable busybox applet before - searching the PATH. This is typically done by exec'ing - /proc/self/exe. + This is an experimental option which directs applets about to + call 'exec' to try and find an applicable busybox applet before + searching the PATH. This is typically done by exec'ing + /proc/self/exe. - This may affect shell, find -exec, xargs and similar applets. - They will use applets even if /bin/APPLET -> busybox link - is missing (or is not a link to busybox). However, this causes - problems in chroot jails without mounted /proc and with ps/top - (command name can be shown as 'exe' for applets started this way). + This may affect shell, find -exec, xargs and similar applets. + They will use applets even if /bin/APPLET -> busybox link + is missing (or is not a link to busybox). However, this causes + problems in chroot jails without mounted /proc and with ps/top + (command name can be shown as 'exe' for applets started this way). config BUSYBOX_EXEC_PATH string "Path to BusyBox executable" default "/proc/self/exe" help - When Busybox applets need to run other busybox applets, BusyBox - sometimes needs to exec() itself. When the /proc filesystem is - mounted, /proc/self/exe always points to the currently running - executable. If you haven't got /proc, set this to wherever you - want to run BusyBox from. + When Busybox applets need to run other busybox applets, BusyBox + sometimes needs to exec() itself. When the /proc filesystem is + mounted, /proc/self/exe always points to the currently running + executable. If you haven't got /proc, set this to wherever you + want to run BusyBox from. config SELINUX bool "Support NSA Security Enhanced Linux" default n select PLATFORM_LINUX help - Enable support for SELinux in applets ls, ps, and id. Also provide - the option of compiling in SELinux applets. + Enable support for SELinux in applets ls, ps, and id. Also provide + the option of compiling in SELinux applets. - If you do not have a complete SELinux userland installed, this stuff - will not compile. Specifially, libselinux 1.28 or better is - directly required by busybox. If the installation is located in a - non-standard directory, provide it by invoking make as follows: + If you do not have a complete SELinux userland installed, this stuff + will not compile. Specifially, libselinux 1.28 or better is + directly required by busybox. If the installation is located in a + non-standard directory, provide it by invoking make as follows: CFLAGS=-I \ LDFLAGS=-L \ make - Most people will leave this set to 'N'. + Most people will leave this set to 'N'. config FEATURE_CLEAN_UP bool "Clean up all memory before exiting (usually not needed)" default n help - As a size optimization, busybox normally exits without explicitly - freeing dynamically allocated memory or closing files. This saves - space since the OS will clean up for us, but it can confuse debuggers - like valgrind, which report tons of memory and resource leaks. + As a size optimization, busybox normally exits without explicitly + freeing dynamically allocated memory or closing files. This saves + space since the OS will clean up for us, but it can confuse debuggers + like valgrind, which report tons of memory and resource leaks. - Don't enable this unless you have a really good reason to clean - things up manually. + Don't enable this unless you have a really good reason to clean + things up manually. # These are auto-selected by other options @@ -330,26 +330,26 @@ config FEATURE_SYSLOG bool #No description makes it a hidden option default n #help - # This option is auto-selected when you select any applet which may - # send its output to syslog. You do not need to select it manually. + #This option is auto-selected when you select any applet which may + #send its output to syslog. You do not need to select it manually. config FEATURE_HAVE_RPC bool #No description makes it a hidden option default n #help - # This is automatically selected if any of enabled applets need it. - # You do not need to select it manually. + #This is automatically selected if any of enabled applets need it. + #You do not need to select it manually. config PLATFORM_LINUX bool #No description makes it a hidden option default n #help - # For the most part, busybox requires only POSIX compatibility - # from the target system, but some applets and features use - # Linux-specific interfaces. + #For the most part, busybox requires only POSIX compatibility + #from the target system, but some applets and features use + #Linux-specific interfaces. # - # This is automatically selected if any applet or feature requires - # Linux-specific interfaces. You do not need to select it manually. + #This is automatically selected if any applet or feature requires + #Linux-specific interfaces. You do not need to select it manually. comment 'Build Options' @@ -357,37 +357,37 @@ config STATIC bool "Build BusyBox as a static binary (no shared libs)" default n help - If you want to build a static BusyBox binary, which does not - use or require any shared libraries, then enable this option. - This can cause BusyBox to be considerably larger, so you should - leave this option false unless you have a good reason (i.e. - your target platform does not support shared libraries, or - you are building an initrd which doesn't need anything but - BusyBox, etc). + If you want to build a static BusyBox binary, which does not + use or require any shared libraries, then enable this option. + This can cause BusyBox to be considerably larger, so you should + leave this option false unless you have a good reason (i.e. + your target platform does not support shared libraries, or + you are building an initrd which doesn't need anything but + BusyBox, etc). - Most people will leave this set to 'N'. + Most people will leave this set to 'N'. config PIE bool "Build BusyBox as a position independent executable" default n depends on !STATIC help - Hardened code option. PIE binaries are loaded at a different - address at each invocation. This has some overhead, - particularly on x86-32 which is short on registers. + Hardened code option. PIE binaries are loaded at a different + address at each invocation. This has some overhead, + particularly on x86-32 which is short on registers. - Most people will leave this set to 'N'. + Most people will leave this set to 'N'. config NOMMU bool "Force NOMMU build" default n help - Busybox tries to detect whether architecture it is being - built against supports MMU or not. If this detection fails, - or if you want to build NOMMU version of busybox for testing, - you may force NOMMU build here. + Busybox tries to detect whether architecture it is being + built against supports MMU or not. If this detection fails, + or if you want to build NOMMU version of busybox for testing, + you may force NOMMU build here. - Most people will leave this set to 'N'. + Most people will leave this set to 'N'. # PIE can be made to work with BUILD_LIBBUSYBOX, but currently # build system does not support that @@ -396,128 +396,128 @@ config BUILD_LIBBUSYBOX default n depends on !FEATURE_PREFER_APPLETS && !PIE && !STATIC help - Build a shared library libbusybox.so.N.N.N which contains all - busybox code. + Build a shared library libbusybox.so.N.N.N which contains all + busybox code. - This feature allows every applet to be built as a really tiny - separate executable linked against the library: - $ size 0_lib/l* - text data bss dec hex filename - 939 212 28 1179 49b 0_lib/last - 939 212 28 1179 49b 0_lib/less - 919138 8328 1556 929022 e2cfe 0_lib/libbusybox.so.1.N.M + This feature allows every applet to be built as a really tiny + separate executable linked against the library: + |$ size 0_lib/l* + | text data bss dec hex filename + | 939 212 28 1179 49b 0_lib/last + | 939 212 28 1179 49b 0_lib/less + | 919138 8328 1556 929022 e2cfe 0_lib/libbusybox.so.1.N.M - This is useful on NOMMU systems which are not capable - of sharing executables, but are capable of sharing code - in dynamic libraries. + This is useful on NOMMU systems which are not capable + of sharing executables, but are capable of sharing code + in dynamic libraries. config FEATURE_LIBBUSYBOX_STATIC bool "Pull in all external references into libbusybox" default n depends on BUILD_LIBBUSYBOX help - Make libbusybox library independent, not using or requiring - any other shared libraries. + Make libbusybox library independent, not using or requiring + any other shared libraries. config FEATURE_INDIVIDUAL bool "Produce a binary for each applet, linked against libbusybox" default y depends on BUILD_LIBBUSYBOX help - If your CPU architecture doesn't allow for sharing text/rodata - sections of running binaries, but allows for runtime dynamic - libraries, this option will allow you to reduce memory footprint - when you have many different applets running at once. + If your CPU architecture doesn't allow for sharing text/rodata + sections of running binaries, but allows for runtime dynamic + libraries, this option will allow you to reduce memory footprint + when you have many different applets running at once. - If your CPU architecture allows for sharing text/rodata, - having single binary is more optimal. + If your CPU architecture allows for sharing text/rodata, + having single binary is more optimal. - Each applet will be a tiny program, dynamically linked - against libbusybox.so.N.N.N. + Each applet will be a tiny program, dynamically linked + against libbusybox.so.N.N.N. - You need to have a working dynamic linker. + You need to have a working dynamic linker. config FEATURE_SHARED_BUSYBOX bool "Produce additional busybox binary linked against libbusybox" default y depends on BUILD_LIBBUSYBOX help - Build busybox, dynamically linked against libbusybox.so.N.N.N. + Build busybox, dynamically linked against libbusybox.so.N.N.N. - You need to have a working dynamic linker. + You need to have a working dynamic linker. ### config BUILD_AT_ONCE ### bool "Compile all sources at once" ### default n ### help -### Normally each source-file is compiled with one invocation of -### the compiler. -### If you set this option, all sources are compiled at once. -### This gives the compiler more opportunities to optimize which can -### result in smaller and/or faster binaries. +### Normally each source-file is compiled with one invocation of +### the compiler. +### If you set this option, all sources are compiled at once. +### This gives the compiler more opportunities to optimize which can +### result in smaller and/or faster binaries. ### -### Setting this option will consume alot of memory, e.g. if you -### enable all applets with all features, gcc uses more than 300MB -### RAM during compilation of busybox. +### Setting this option will consume alot of memory, e.g. if you +### enable all applets with all features, gcc uses more than 300MB +### RAM during compilation of busybox. ### -### This option is most likely only beneficial for newer compilers -### such as gcc-4.1 and above. +### This option is most likely only beneficial for newer compilers +### such as gcc-4.1 and above. ### -### Say 'N' unless you know what you are doing. +### Say 'N' unless you know what you are doing. config CROSS_COMPILER_PREFIX string "Cross Compiler prefix" default "" help - If you want to build BusyBox with a cross compiler, then you - will need to set this to the cross-compiler prefix, for example, - "i386-uclibc-". + If you want to build BusyBox with a cross compiler, then you + will need to set this to the cross-compiler prefix, for example, + "i386-uclibc-". - Note that CROSS_COMPILE environment variable or - "make CROSS_COMPILE=xxx ..." will override this selection. + Note that CROSS_COMPILE environment variable or + "make CROSS_COMPILE=xxx ..." will override this selection. - Native builds leave this empty. + Native builds leave this empty. config SYSROOT string "Path to sysroot" default "" help - If you want to build BusyBox with a cross compiler, then you - might also need to specify where /usr/include and /usr/lib - will be found. + If you want to build BusyBox with a cross compiler, then you + might also need to specify where /usr/include and /usr/lib + will be found. - For example, BusyBox can be built against an installed - Android NDK, platform version 9, for ARM ABI with + For example, BusyBox can be built against an installed + Android NDK, platform version 9, for ARM ABI with - CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm + CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm - Native builds leave this empty. + Native builds leave this empty. config EXTRA_CFLAGS string "Additional CFLAGS" default "" help - Additional CFLAGS to pass to the compiler verbatim. + Additional CFLAGS to pass to the compiler verbatim. config EXTRA_LDFLAGS string "Additional LDFLAGS" default "" help - Additional LDFLAGS to pass to the linker verbatim. + Additional LDFLAGS to pass to the linker verbatim. config EXTRA_LDLIBS string "Additional LDLIBS" default "" help - Additional LDLIBS to pass to the linker with -l. + Additional LDLIBS to pass to the linker with -l. config USE_PORTABLE_CODE bool "Avoid using GCC-specific code constructs" default n help - Use this option if you are trying to compile busybox with - compiler other than gcc. - If you do use gcc, this option may needlessly increase code size. + Use this option if you are trying to compile busybox with + compiler other than gcc. + If you do use gcc, this option may needlessly increase code size. comment 'Installation Options ("make install" behavior)' @@ -525,32 +525,32 @@ choice prompt "What kind of applet links to install" default INSTALL_APPLET_SYMLINKS help - Choose what kind of links to applets are created by "make install". + Choose what kind of links to applets are created by "make install". config INSTALL_APPLET_SYMLINKS bool "as soft-links" help - Install applets as soft-links to the busybox binary. This needs some - free inodes on the filesystem, but might help with filesystem - generators that can't cope with hard-links. + Install applets as soft-links to the busybox binary. This needs some + free inodes on the filesystem, but might help with filesystem + generators that can't cope with hard-links. config INSTALL_APPLET_HARDLINKS bool "as hard-links" help - Install applets as hard-links to the busybox binary. This might - count on a filesystem with few inodes. + Install applets as hard-links to the busybox binary. This might + count on a filesystem with few inodes. config INSTALL_APPLET_SCRIPT_WRAPPERS bool "as script wrappers" help - Install applets as script wrappers that call the busybox binary. + Install applets as script wrappers that call the busybox binary. config INSTALL_APPLET_DONT bool "not installed" help - Do not install applet links. Useful when you plan to use - busybox --install for installing links, or plan to use - a standalone shell and thus don't need applet links. + Do not install applet links. Useful when you plan to use + busybox --install for installing links, or plan to use + a standalone shell and thus don't need applet links. endchoice @@ -559,23 +559,23 @@ choice default INSTALL_SH_APPLET_SYMLINK depends on INSTALL_APPLET_SCRIPT_WRAPPERS help - Choose how you install /bin/sh applet link. + Choose how you install /bin/sh applet link. config INSTALL_SH_APPLET_SYMLINK bool "as soft-link" help - Install /bin/sh applet as soft-link to the busybox binary. + Install /bin/sh applet as soft-link to the busybox binary. config INSTALL_SH_APPLET_HARDLINK bool "as hard-link" help - Install /bin/sh applet as hard-link to the busybox binary. + Install /bin/sh applet as hard-link to the busybox binary. config INSTALL_SH_APPLET_SCRIPT_WRAPPER bool "as script wrapper" help - Install /bin/sh applet as script wrapper that calls - the busybox binary. + Install /bin/sh applet as script wrapper that calls + the busybox binary. endchoice @@ -583,7 +583,7 @@ config PREFIX string "BusyBox installation prefix" default "./_install" help - Define your directory to install BusyBox files/subdirs in. + Define your directory to install BusyBox files/subdirs in. comment 'Debugging Options' @@ -591,81 +591,81 @@ config DEBUG bool "Build BusyBox with extra Debugging symbols" default n help - Say Y here if you wish to examine BusyBox internals while applets are - running. This increases the size of the binary considerably, and - should only be used when doing development. If you are doing - development and want to debug BusyBox, answer Y. + Say Y here if you wish to examine BusyBox internals while applets are + running. This increases the size of the binary considerably, and + should only be used when doing development. If you are doing + development and want to debug BusyBox, answer Y. - Most people should answer N. + Most people should answer N. config DEBUG_PESSIMIZE bool "Disable compiler optimizations" default n depends on DEBUG help - The compiler's optimization of source code can eliminate and reorder - code, resulting in an executable that's hard to understand when - stepping through it with a debugger. This switches it off, resulting - in a much bigger executable that more closely matches the source - code. + The compiler's optimization of source code can eliminate and reorder + code, resulting in an executable that's hard to understand when + stepping through it with a debugger. This switches it off, resulting + in a much bigger executable that more closely matches the source + code. config DEBUG_SANITIZE bool "Enable runtime sanitizers (ASAN/LSAN/USAN/etc...)" default n help - Say Y here if you want to enable runtime sanitizers. These help - catch bad memory accesses (e.g. buffer overflows), but will make - the executable larger and slow down runtime a bit. + Say Y here if you want to enable runtime sanitizers. These help + catch bad memory accesses (e.g. buffer overflows), but will make + the executable larger and slow down runtime a bit. - This adds -fsanitize=foo options to gcc command line. + This adds -fsanitize=foo options to gcc command line. - If you aren't developing/testing busybox, say N here. + If you aren't developing/testing busybox, say N here. config UNIT_TEST bool "Build unit tests" default n help - Say Y here if you want to build unit tests (both the framework and - test cases) as a Busybox applet. This results in bigger code, so you - probably don't want this option in production builds. + Say Y here if you want to build unit tests (both the framework and + test cases) as a Busybox applet. This results in bigger code, so you + probably don't want this option in production builds. config WERROR bool "Abort compilation on any warning" default n help - This adds -Werror to gcc command line. + This adds -Werror to gcc command line. - Most people should answer N. + Most people should answer N. choice prompt "Additional debugging library" default NO_DEBUG_LIB help - Using an additional debugging library will make BusyBox become - considerable larger and will cause it to run more slowly. You - should always leave this option disabled for production use. - - dmalloc support: - ---------------- - This enables compiling with dmalloc ( http://dmalloc.com/ ) - which is an excellent public domain mem leak and malloc problem - detector. To enable dmalloc, before running busybox you will - want to properly set your environment, for example: - export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile - The 'debug=' value is generated using the following command - dmalloc -p log-stats -p log-non-free -p log-bad-space \ - -p log-elapsed-time -p check-fence -p check-heap \ - -p check-lists -p check-blank -p check-funcs -p realloc-copy \ - -p allow-free-null - - Electric-fence support: - ----------------------- - This enables compiling with Electric-fence support. Electric - fence is another very useful malloc debugging library which uses - your computer's virtual memory hardware to detect illegal memory - accesses. This support will make BusyBox be considerable larger - and run slower, so you should leave this option disabled unless - you are hunting a hard to find memory problem. + Using an additional debugging library will make BusyBox become + considerable larger and will cause it to run more slowly. You + should always leave this option disabled for production use. + + dmalloc support: + ---------------- + This enables compiling with dmalloc ( http://dmalloc.com/ ) + which is an excellent public domain mem leak and malloc problem + detector. To enable dmalloc, before running busybox you will + want to properly set your environment, for example: + export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile + The 'debug=' value is generated using the following command + dmalloc -p log-stats -p log-non-free -p log-bad-space \ + -p log-elapsed-time -p check-fence -p check-heap \ + -p check-lists -p check-blank -p check-funcs -p realloc-copy \ + -p allow-free-null + + Electric-fence support: + ----------------------- + This enables compiling with Electric-fence support. Electric + fence is another very useful malloc debugging library which uses + your computer's virtual memory hardware to detect illegal memory + accesses. This support will make BusyBox be considerable larger + and run slower, so you should leave this option disabled unless + you are hunting a hard to find memory problem. config NO_DEBUG_LIB diff --git a/archival/Config.src b/archival/Config.src index 4bb46f167..449914565 100644 --- a/archival/Config.src +++ b/archival/Config.src @@ -32,7 +32,7 @@ config FEATURE_LZMA_FAST default n depends on UNLZMA || LZCAT || LZMA || FEATURE_SEAMLESS_LZMA help - This option reduces decompression time by about 25% at the cost of - a 1K bigger binary. + This option reduces decompression time by about 25% at the cost of + a 1K bigger binary. endmenu diff --git a/archival/ar.c b/archival/ar.c index 8e4d81eeb..2886d155b 100644 --- a/archival/ar.c +++ b/archival/ar.c @@ -21,29 +21,29 @@ //config: bool "ar (9.5 kb)" //config: default n # needs to be improved to be able to replace binutils ar //config: help -//config: ar is an archival utility program used to create, modify, and -//config: extract contents from archives. In practice, it is used exclusively -//config: for object module archives used by compilers. +//config: ar is an archival utility program used to create, modify, and +//config: extract contents from archives. In practice, it is used exclusively +//config: for object module archives used by compilers. //config: -//config: Unless you have a specific application which requires ar, you should -//config: probably say N here: most compilers come with their own ar utility. +//config: Unless you have a specific application which requires ar, you should +//config: probably say N here: most compilers come with their own ar utility. //config: //config:config FEATURE_AR_LONG_FILENAMES //config: bool "Support long filenames (not needed for debs)" //config: default y //config: depends on AR //config: help -//config: By default the ar format can only store the first 15 characters -//config: of the filename, this option removes that limitation. -//config: It supports the GNU ar long filename method which moves multiple long -//config: filenames into a the data section of a new ar entry. +//config: By default the ar format can only store the first 15 characters +//config: of the filename, this option removes that limitation. +//config: It supports the GNU ar long filename method which moves multiple long +//config: filenames into a the data section of a new ar entry. //config: //config:config FEATURE_AR_CREATE //config: bool "Support archive creation" //config: default y //config: depends on AR //config: help -//config: This enables archive creation (-c and -r) with busybox ar. +//config: This enables archive creation (-c and -r) with busybox ar. //applet:IF_AR(APPLET(ar, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_AR) += ar.o diff --git a/archival/bbunzip.c b/archival/bbunzip.c index bf18a7485..d2b162d5e 100644 --- a/archival/bbunzip.c +++ b/archival/bbunzip.c @@ -240,8 +240,8 @@ char* FAST_FUNC make_new_name_generic(char *filename, const char *expected_ext) //config: bool "uncompress (7.1 kb)" //config: default n # ancient //config: help -//config: uncompress is used to decompress archives created by compress. -//config: Not much used anymore, replaced by gzip/gunzip. +//config: uncompress is used to decompress archives created by compress. +//config: Not much used anymore, replaced by gzip/gunzip. //applet:IF_UNCOMPRESS(APPLET(uncompress, BB_DIR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_UNCOMPRESS) += bbunzip.o @@ -316,16 +316,16 @@ int uncompress_main(int argc UNUSED_PARAM, char **argv) //config: default y //config: select FEATURE_GZIP_DECOMPRESS //config: help -//config: gunzip is used to decompress archives created by gzip. -//config: You can use the `-t' option to test the integrity of -//config: an archive, without decompressing it. +//config: gunzip is used to decompress archives created by gzip. +//config: You can use the `-t' option to test the integrity of +//config: an archive, without decompressing it. //config: //config:config ZCAT //config: bool "zcat (25 kb)" //config: default y //config: select FEATURE_GZIP_DECOMPRESS //config: help -//config: Alias to "gunzip -c". +//config: Alias to "gunzip -c". //config: //config:config FEATURE_GUNZIP_LONG_OPTIONS //config: bool "Enable long options" @@ -429,21 +429,21 @@ int gunzip_main(int argc UNUSED_PARAM, char **argv) //config: default y //config: select FEATURE_BZIP2_DECOMPRESS //config: help -//config: bunzip2 is a compression utility using the Burrows-Wheeler block -//config: sorting text compression algorithm, and Huffman coding. Compression -//config: is generally considerably better than that achieved by more -//config: conventional LZ77/LZ78-based compressors, and approaches the -//config: performance of the PPM family of statistical compressors. +//config: bunzip2 is a compression utility using the Burrows-Wheeler block +//config: sorting text compression algorithm, and Huffman coding. Compression +//config: is generally considerably better than that achieved by more +//config: conventional LZ77/LZ78-based compressors, and approaches the +//config: performance of the PPM family of statistical compressors. //config: -//config: Unless you have a specific application which requires bunzip2, you -//config: should probably say N here. +//config: Unless you have a specific application which requires bunzip2, you +//config: should probably say N here. //config: //config:config BZCAT //config: bool "bzcat (8.8 kb)" //config: default y //config: select FEATURE_BZIP2_DECOMPRESS //config: help -//config: Alias to "bunzip2 -c". +//config: Alias to "bunzip2 -c". //applet:IF_BUNZIP2(APPLET(bunzip2, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help @@ -496,23 +496,23 @@ int bunzip2_main(int argc UNUSED_PARAM, char **argv) //config: bool "unlzma (8.6 kb)" //config: default y //config: help -//config: unlzma is a compression utility using the Lempel-Ziv-Markov chain -//config: compression algorithm, and range coding. Compression -//config: is generally considerably better than that achieved by the bzip2 -//config: compressors. +//config: unlzma is a compression utility using the Lempel-Ziv-Markov chain +//config: compression algorithm, and range coding. Compression +//config: is generally considerably better than that achieved by the bzip2 +//config: compressors. //config: //config:config LZCAT //config: bool "lzcat (8.5 kb)" //config: default y //config: help -//config: Alias to "unlzma -c". +//config: Alias to "unlzma -c". //config: //config:config LZMA //config: bool "lzma -d" //config: default y //config: help -//config: Enable this option if you want commands like "lzma -d" to work. -//config: IOW: you'll get lzma applet, but it will always require -d option. +//config: Enable this option if you want commands like "lzma -d" to work. +//config: IOW: you'll get lzma applet, but it will always require -d option. //applet:IF_UNLZMA(APPLET(unlzma, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help @@ -567,20 +567,20 @@ int unlzma_main(int argc UNUSED_PARAM, char **argv) //config: bool "unxz (13 kb)" //config: default y //config: help -//config: unxz is a unlzma successor. +//config: unxz is a unlzma successor. //config: //config:config XZCAT //config: bool "xzcat (13 kb)" //config: default y //config: help -//config: Alias to "unxz -c". +//config: Alias to "unxz -c". //config: //config:config XZ //config: bool "xz -d" //config: default y //config: help -//config: Enable this option if you want commands like "xz -d" to work. -//config: IOW: you'll get xz applet, but it will always require -d option. +//config: Enable this option if you want commands like "xz -d" to work. +//config: IOW: you'll get xz applet, but it will always require -d option. //applet:IF_UNXZ(APPLET(unxz, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/archival/bzip2.c b/archival/bzip2.c index a115cb6ea..0b9c508df 100644 --- a/archival/bzip2.c +++ b/archival/bzip2.c @@ -11,23 +11,23 @@ //config: bool "bzip2 (18 kb)" //config: default y //config: help -//config: bzip2 is a compression utility using the Burrows-Wheeler block -//config: sorting text compression algorithm, and Huffman coding. Compression -//config: is generally considerably better than that achieved by more -//config: conventional LZ77/LZ78-based compressors, and approaches the -//config: performance of the PPM family of statistical compressors. +//config: bzip2 is a compression utility using the Burrows-Wheeler block +//config: sorting text compression algorithm, and Huffman coding. Compression +//config: is generally considerably better than that achieved by more +//config: conventional LZ77/LZ78-based compressors, and approaches the +//config: performance of the PPM family of statistical compressors. //config: -//config: Unless you have a specific application which requires bzip2, you -//config: should probably say N here. +//config: Unless you have a specific application which requires bzip2, you +//config: should probably say N here. //config: //config:config FEATURE_BZIP2_DECOMPRESS //config: bool "Enable decompression" //config: default y //config: depends on BZIP2 || BUNZIP2 || BZCAT //config: help -//config: Enable -d (--decompress) and -t (--test) options for bzip2. -//config: This will be automatically selected if bunzip2 or bzcat is -//config: enabled. +//config: Enable -d (--decompress) and -t (--test) options for bzip2. +//config: This will be automatically selected if bunzip2 or bzcat is +//config: enabled. //applet:IF_BZIP2(APPLET(bzip2, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_BZIP2) += bzip2.o diff --git a/archival/cpio.c b/archival/cpio.c index 4416348b6..38bab8257 100644 --- a/archival/cpio.c +++ b/archival/cpio.c @@ -18,30 +18,30 @@ //config: bool "cpio (14 kb)" //config: default y //config: help -//config: cpio is an archival utility program used to create, modify, and -//config: extract contents from archives. -//config: cpio has 110 bytes of overheads for every stored file. +//config: cpio is an archival utility program used to create, modify, and +//config: extract contents from archives. +//config: cpio has 110 bytes of overheads for every stored file. //config: -//config: This implementation of cpio can extract cpio archives created in the -//config: "newc" or "crc" format. +//config: This implementation of cpio can extract cpio archives created in the +//config: "newc" or "crc" format. //config: -//config: Unless you have a specific application which requires cpio, you -//config: should probably say N here. +//config: Unless you have a specific application which requires cpio, you +//config: should probably say N here. //config: //config:config FEATURE_CPIO_O //config: bool "Support archive creation" //config: default y //config: depends on CPIO //config: help -//config: This implementation of cpio can create cpio archives in the "newc" -//config: format only. +//config: This implementation of cpio can create cpio archives in the "newc" +//config: format only. //config: //config:config FEATURE_CPIO_P //config: bool "Support passthrough mode" //config: default y //config: depends on FEATURE_CPIO_O //config: help -//config: Passthrough mode. Rarely used. +//config: Passthrough mode. Rarely used. //applet:IF_CPIO(APPLET(cpio, BB_DIR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_CPIO) += cpio.o diff --git a/archival/dpkg.c b/archival/dpkg.c index 41c8fc5d1..90ad8766c 100644 --- a/archival/dpkg.c +++ b/archival/dpkg.c @@ -31,11 +31,11 @@ //config: default y //config: select FEATURE_SEAMLESS_GZ //config: help -//config: dpkg is a medium-level tool to install, build, remove and manage -//config: Debian packages. +//config: dpkg is a medium-level tool to install, build, remove and manage +//config: Debian packages. //config: -//config: This implementation of dpkg has a number of limitations, -//config: you should use the official dpkg if possible. +//config: This implementation of dpkg has a number of limitations, +//config: you should use the official dpkg if possible. //applet:IF_DPKG(APPLET(dpkg, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_DPKG) += dpkg.o diff --git a/archival/dpkg_deb.c b/archival/dpkg_deb.c index ebbc7f035..029bc4af1 100644 --- a/archival/dpkg_deb.c +++ b/archival/dpkg_deb.c @@ -10,12 +10,12 @@ //config: default y //config: select FEATURE_SEAMLESS_GZ //config: help -//config: dpkg-deb unpacks and provides information about Debian archives. +//config: dpkg-deb unpacks and provides information about Debian archives. //config: -//config: This implementation of dpkg-deb cannot pack archives. +//config: This implementation of dpkg-deb cannot pack archives. //config: -//config: Unless you have a specific application which requires dpkg-deb, -//config: say N here. +//config: Unless you have a specific application which requires dpkg-deb, +//config: say N here. //applet:IF_DPKG_DEB(APPLET_ODDNAME(dpkg-deb, dpkg_deb, BB_DIR_USR_BIN, BB_SUID_DROP, dpkg_deb)) diff --git a/archival/gzip.c b/archival/gzip.c index a883a1fff..4cf34ac28 100644 --- a/archival/gzip.c +++ b/archival/gzip.c @@ -41,8 +41,8 @@ aa: 85.1% -- replaced with aa.gz //config: bool "gzip (19 kb)" //config: default y //config: help -//config: gzip is used to compress files. -//config: It's probably the most widely used UNIX compression program. +//config: gzip is used to compress files. +//config: It's probably the most widely used UNIX compression program. //config: //config:config FEATURE_GZIP_LONG_OPTIONS //config: bool "Enable long options" @@ -55,30 +55,30 @@ aa: 85.1% -- replaced with aa.gz //config: range 0 2 //config: depends on GZIP //config: help -//config: Enable big memory options for gzip. -//config: 0: small buffers, small hash-tables -//config: 1: larger buffers, larger hash-tables -//config: 2: larger buffers, largest hash-tables -//config: Larger models may give slightly better compression +//config: Enable big memory options for gzip. +//config: 0: small buffers, small hash-tables +//config: 1: larger buffers, larger hash-tables +//config: 2: larger buffers, largest hash-tables +//config: Larger models may give slightly better compression //config: //config:config FEATURE_GZIP_LEVELS //config: bool "Enable compression levels" //config: default n //config: depends on GZIP //config: help -//config: Enable support for compression levels 4-9. The default level -//config: is 6. If levels 1-3 are specified, 4 is used. -//config: If this option is not selected, -N options are ignored and -9 -//config: is used. +//config: Enable support for compression levels 4-9. The default level +//config: is 6. If levels 1-3 are specified, 4 is used. +//config: If this option is not selected, -N options are ignored and -9 +//config: is used. //config: //config:config FEATURE_GZIP_DECOMPRESS //config: bool "Enable decompression" //config: default y //config: depends on GZIP || GUNZIP || ZCAT //config: help -//config: Enable -d (--decompress) and -t (--test) options for gzip. -//config: This will be automatically selected if gunzip or zcat is -//config: enabled. +//config: Enable -d (--decompress) and -t (--test) options for gzip. +//config: This will be automatically selected if gunzip or zcat is +//config: enabled. //applet:IF_GZIP(APPLET(gzip, BB_DIR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_GZIP) += gzip.o diff --git a/archival/lzop.c b/archival/lzop.c index 967d4b74d..df18ff170 100644 --- a/archival/lzop.c +++ b/archival/lzop.c @@ -29,28 +29,28 @@ //config: bool "lzop (13 kb)" //config: default y //config: help -//config: Lzop compression/decompresion. +//config: Lzop compression/decompresion. //config: //config:config UNLZOP //config: bool "unlzop (13 kb)" //config: default n # INCOMPAT: upstream lzop does not provide such tool //config: help -//config: Lzop decompresion. +//config: Lzop decompresion. //config: //config:config LZOPCAT //config: bool "lzopcat (13 kb)" //config: default n # INCOMPAT: upstream lzop does not provide such tool //config: help -//config: Alias to "lzop -dc". +//config: Alias to "lzop -dc". //config: //config:config LZOP_COMPR_HIGH //config: bool "lzop compression levels 7,8,9 (not very useful)" //config: default n //config: depends on LZOP || UNLZOP || LZOPCAT //config: help -//config: High levels (7,8,9) of lzop compression. These levels -//config: are actually slower than gzip at equivalent compression ratios -//config: and take up 3.2K of code. +//config: High levels (7,8,9) of lzop compression. These levels +//config: are actually slower than gzip at equivalent compression ratios +//config: and take up 3.2K of code. //applet:IF_LZOP(APPLET(lzop, BB_DIR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/archival/rpm.c b/archival/rpm.c index 2974dfc61..98039d499 100644 --- a/archival/rpm.c +++ b/archival/rpm.c @@ -11,7 +11,7 @@ //config: bool "rpm (33 kb)" //config: default y //config: help -//config: Mini RPM applet - queries and extracts RPM packages. +//config: Mini RPM applet - queries and extracts RPM packages. //applet:IF_RPM(APPLET(rpm, BB_DIR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_RPM) += rpm.o diff --git a/archival/rpm2cpio.c b/archival/rpm2cpio.c index 9d503be52..3e4a6a249 100644 --- a/archival/rpm2cpio.c +++ b/archival/rpm2cpio.c @@ -11,7 +11,7 @@ //config: bool "rpm2cpio (20 kb)" //config: default y //config: help -//config: Converts a RPM file into a CPIO archive. +//config: Converts a RPM file into a CPIO archive. //applet:IF_RPM2CPIO(APPLET(rpm2cpio, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_RPM2CPIO) += rpm2cpio.o diff --git a/archival/tar.c b/archival/tar.c index fcabb0126..0fc574dfd 100644 --- a/archival/tar.c +++ b/archival/tar.c @@ -45,9 +45,9 @@ //config: bool "tar (40 kb)" //config: default y //config: help -//config: tar is an archiving program. It's commonly used with gzip to -//config: create compressed archives. It's probably the most widely used -//config: UNIX archive program. +//config: tar is an archiving program. It's commonly used with gzip to +//config: create compressed archives. It's probably the most widely used +//config: UNIX archive program. //config: //config:config FEATURE_TAR_LONG_OPTIONS //config: bool "Enable long options" @@ -64,35 +64,35 @@ //config: default y //config: depends on TAR && (FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA || FEATURE_SEAMLESS_XZ) //config: help -//config: With this option tar can automatically detect compressed -//config: tarballs. Currently it works only on files (not pipes etc). +//config: With this option tar can automatically detect compressed +//config: tarballs. Currently it works only on files (not pipes etc). //config: //config:config FEATURE_TAR_FROM //config: bool "Enable -X (exclude from) and -T (include from) options)" //config: default y //config: depends on TAR //config: help -//config: If you enable this option you'll be able to specify -//config: a list of files to include or exclude from an archive. +//config: If you enable this option you'll be able to specify +//config: a list of files to include or exclude from an archive. //config: //config:config FEATURE_TAR_OLDGNU_COMPATIBILITY //config: bool "Support old tar header format" //config: default y //config: depends on TAR || DPKG //config: help -//config: This option is required to unpack archives created in -//config: the old GNU format; help to kill this old format by -//config: repacking your ancient archives with the new format. +//config: This option is required to unpack archives created in +//config: the old GNU format; help to kill this old format by +//config: repacking your ancient archives with the new format. //config: //config:config FEATURE_TAR_OLDSUN_COMPATIBILITY //config: bool "Enable untarring of tarballs with checksums produced by buggy Sun tar" //config: default y //config: depends on TAR || DPKG //config: help -//config: This option is required to unpack archives created by some old -//config: version of Sun's tar (it was calculating checksum using signed -//config: arithmetic). It is said to be fixed in newer Sun tar, but "old" -//config: tarballs still exist. +//config: This option is required to unpack archives created by some old +//config: version of Sun's tar (it was calculating checksum using signed +//config: arithmetic). It is said to be fixed in newer Sun tar, but "old" +//config: tarballs still exist. //config: //config:config FEATURE_TAR_GNU_EXTENSIONS //config: bool "Support GNU tar extensions (long filenames)" @@ -104,18 +104,18 @@ //config: default y //config: depends on TAR && FEATURE_TAR_LONG_OPTIONS //config: help -//config: If you enable this option you'll be able to instruct tar to send -//config: the contents of each extracted file to the standard input of an -//config: external program. +//config: If you enable this option you'll be able to instruct tar to send +//config: the contents of each extracted file to the standard input of an +//config: external program. //config: //config:config FEATURE_TAR_UNAME_GNAME //config: bool "Enable use of user and group names" //config: default y //config: depends on TAR //config: help -//config: Enable use of user and group names in tar. This affects contents -//config: listings (-t) and preserving permissions when unpacking (-p). -//config: +200 bytes. +//config: Enable use of user and group names in tar. This affects contents +//config: listings (-t) and preserving permissions when unpacking (-p). +//config: +200 bytes. //config: //config:config FEATURE_TAR_NOPRESERVE_TIME //config: bool "Enable -m (do not preserve time) GNU option" @@ -127,8 +127,8 @@ //config: default n //config: depends on TAR && SELINUX //config: help -//config: With this option busybox supports restoring SELinux labels -//config: when extracting files from tar archives. +//config: With this option busybox supports restoring SELinux labels +//config: when extracting files from tar archives. //applet:IF_TAR(APPLET(tar, BB_DIR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_TAR) += tar.o diff --git a/archival/unzip.c b/archival/unzip.c index b618c3617..bb39d954e 100644 --- a/archival/unzip.c +++ b/archival/unzip.c @@ -20,20 +20,20 @@ //config: bool "unzip (24 kb)" //config: default y //config: help -//config: unzip will list or extract files from a ZIP archive, -//config: commonly found on DOS/WIN systems. The default behavior -//config: (with no options) is to extract the archive into the -//config: current directory. +//config: unzip will list or extract files from a ZIP archive, +//config: commonly found on DOS/WIN systems. The default behavior +//config: (with no options) is to extract the archive into the +//config: current directory. //config: //config:config FEATURE_UNZIP_CDF //config: bool "Read and use Central Directory data" //config: default y //config: depends on UNZIP //config: help -//config: If you know that you only need to deal with simple -//config: ZIP files without deleted/updated files, SFX archives etc, -//config: you can reduce code size by unselecting this option. -//config: To support less trivial ZIPs, say Y. +//config: If you know that you only need to deal with simple +//config: ZIP files without deleted/updated files, SFX archives etc, +//config: you can reduce code size by unselecting this option. +//config: To support less trivial ZIPs, say Y. //config: //config:config FEATURE_UNZIP_BZIP2 //config: bool "Support compression method 12 (bzip2)" diff --git a/console-tools/chvt.c b/console-tools/chvt.c index 729f13ba2..d8152de6b 100644 --- a/console-tools/chvt.c +++ b/console-tools/chvt.c @@ -11,8 +11,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program is used to change to another terminal. -//config: Example: chvt 4 (change to terminal /dev/tty4) +//config: This program is used to change to another terminal. +//config: Example: chvt 4 (change to terminal /dev/tty4) //applet:IF_CHVT(APPLET(chvt, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/clear.c b/console-tools/clear.c index 0c11ec817..13eec498b 100644 --- a/console-tools/clear.c +++ b/console-tools/clear.c @@ -10,7 +10,7 @@ //config: bool "clear (tiny)" //config: default y //config: help -//config: This program clears the terminal screen. +//config: This program clears the terminal screen. //applet:IF_CLEAR(APPLET(clear, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/deallocvt.c b/console-tools/deallocvt.c index cf74a03ed..6ffb1471e 100644 --- a/console-tools/deallocvt.c +++ b/console-tools/deallocvt.c @@ -12,7 +12,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program deallocates unused virtual consoles. +//config: This program deallocates unused virtual consoles. //applet:IF_DEALLOCVT(APPLET(deallocvt, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/dumpkmap.c b/console-tools/dumpkmap.c index a8d8e3572..d4e2cf281 100644 --- a/console-tools/dumpkmap.c +++ b/console-tools/dumpkmap.c @@ -12,8 +12,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program dumps the kernel's keyboard translation table to -//config: stdout, in binary format. You can then use loadkmap to load it. +//config: This program dumps the kernel's keyboard translation table to +//config: stdout, in binary format. You can then use loadkmap to load it. //applet:IF_DUMPKMAP(APPLET(dumpkmap, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/console-tools/fgconsole.c b/console-tools/fgconsole.c index 2582162a5..64311f6ea 100644 --- a/console-tools/fgconsole.c +++ b/console-tools/fgconsole.c @@ -11,7 +11,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program prints active (foreground) console number. +//config: This program prints active (foreground) console number. //applet:IF_FGCONSOLE(APPLET(fgconsole, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/kbd_mode.c b/console-tools/kbd_mode.c index 815a65ad9..d81c56e92 100644 --- a/console-tools/kbd_mode.c +++ b/console-tools/kbd_mode.c @@ -13,7 +13,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program reports and sets keyboard mode. +//config: This program reports and sets keyboard mode. //applet:IF_KBD_MODE(APPLET(kbd_mode, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/console-tools/loadfont.c b/console-tools/loadfont.c index b7d291723..6dc8fa831 100644 --- a/console-tools/loadfont.c +++ b/console-tools/loadfont.c @@ -14,29 +14,29 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program loads a console font from standard input. +//config: This program loads a console font from standard input. //config: //config:config SETFONT //config: bool "setfont (26 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Allows to load console screen map. Useful for i18n. +//config: Allows to load console screen map. Useful for i18n. //config: //config:config FEATURE_SETFONT_TEXTUAL_MAP //config: bool "Support reading textual screen maps" //config: default y //config: depends on SETFONT //config: help -//config: Support reading textual screen maps. +//config: Support reading textual screen maps. //config: //config:config DEFAULT_SETFONT_DIR //config: string "Default directory for console-tools files" //config: default "" //config: depends on SETFONT //config: help -//config: Directory to use if setfont's params are simple filenames -//config: (not /path/to/file or ./file). Default is "" (no default directory). +//config: Directory to use if setfont's params are simple filenames +//config: (not /path/to/file or ./file). Default is "" (no default directory). //config: //config:comment "Common options for loadfont and setfont" //config: depends on LOADFONT || SETFONT diff --git a/console-tools/loadkmap.c b/console-tools/loadkmap.c index 7e8f82497..839dc2083 100644 --- a/console-tools/loadkmap.c +++ b/console-tools/loadkmap.c @@ -11,8 +11,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program loads a keyboard translation table from -//config: standard input. +//config: This program loads a keyboard translation table from +//config: standard input. //applet:IF_LOADKMAP(APPLET(loadkmap, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/console-tools/openvt.c b/console-tools/openvt.c index 7ed3a28d5..f3db28367 100644 --- a/console-tools/openvt.c +++ b/console-tools/openvt.c @@ -12,8 +12,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program is used to start a command on an unused -//config: virtual terminal. +//config: This program is used to start a command on an unused +//config: virtual terminal. //applet:IF_OPENVT(APPLET(openvt, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/reset.c b/console-tools/reset.c index a0ce5c73d..04e5b0ca1 100644 --- a/console-tools/reset.c +++ b/console-tools/reset.c @@ -13,8 +13,8 @@ //config: bool "reset (275 bytes)" //config: default y //config: help -//config: This program is used to reset the terminal screen, if it -//config: gets messed up. +//config: This program is used to reset the terminal screen, if it +//config: gets messed up. //applet:IF_RESET(APPLET(reset, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/resize.c b/console-tools/resize.c index 4ac5ee1aa..62928a01e 100644 --- a/console-tools/resize.c +++ b/console-tools/resize.c @@ -10,18 +10,18 @@ //config: bool "resize (756 bytes)" //config: default y //config: help -//config: This program is used to (re)set the width and height of your current -//config: terminal. +//config: This program is used to (re)set the width and height of your current +//config: terminal. //config: //config:config FEATURE_RESIZE_PRINT //config: bool "Print environment variables" //config: default y //config: depends on RESIZE //config: help -//config: Prints the newly set size (number of columns and rows) of -//config: the terminal. -//config: E.g.: -//config: COLUMNS=80;LINES=44;export COLUMNS LINES; +//config: Prints the newly set size (number of columns and rows) of +//config: the terminal. +//config: E.g.: +//config: COLUMNS=80;LINES=44;export COLUMNS LINES; //applet:IF_RESIZE(APPLET(resize, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/setconsole.c b/console-tools/setconsole.c index 7ba5a0eed..ad0f756ca 100644 --- a/console-tools/setconsole.c +++ b/console-tools/setconsole.c @@ -12,8 +12,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program redirects the system console to another device, -//config: like the current tty while logged in via telnet. +//config: This program redirects the system console to another device, +//config: like the current tty while logged in via telnet. //config: //config:config FEATURE_SETCONSOLE_LONG_OPTIONS //config: bool "Enable long options" diff --git a/console-tools/setkeycodes.c b/console-tools/setkeycodes.c index cc668ec8a..543fbe3e0 100644 --- a/console-tools/setkeycodes.c +++ b/console-tools/setkeycodes.c @@ -13,8 +13,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program loads entries into the kernel's scancode-to-keycode -//config: map, allowing unusual keyboards to generate usable keycodes. +//config: This program loads entries into the kernel's scancode-to-keycode +//config: map, allowing unusual keyboards to generate usable keycodes. //applet:IF_SETKEYCODES(APPLET(setkeycodes, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/console-tools/setlogcons.c b/console-tools/setlogcons.c index 350a71d43..1b5814eee 100644 --- a/console-tools/setlogcons.c +++ b/console-tools/setlogcons.c @@ -13,7 +13,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: This program redirects the output console of kernel messages. +//config: This program redirects the output console of kernel messages. //applet:IF_SETLOGCONS(APPLET(setlogcons, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/console-tools/showkey.c b/console-tools/showkey.c index 8a485245d..c322ce99d 100644 --- a/console-tools/showkey.c +++ b/console-tools/showkey.c @@ -11,7 +11,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Shows keys pressed. +//config: Shows keys pressed. //applet:IF_SHOWKEY(APPLET(showkey, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/Config.src b/coreutils/Config.src index 1d2fea1fb..7a8a3a634 100644 --- a/coreutils/Config.src +++ b/coreutils/Config.src @@ -13,9 +13,9 @@ config FEATURE_VERBOSE bool "Support verbose options (usually -v) for various applets" default y help - Enable cp -v, rm -v and similar messages. - Also enables long option (--verbose) if it exists. - Without this option, -v is accepted but ignored. + Enable cp -v, rm -v and similar messages. + Also enables long option (--verbose) if it exists. + Without this option, -v is accepted but ignored. comment "Common options for cp and mv" depends on CP || MV @@ -25,7 +25,7 @@ config FEATURE_PRESERVE_HARDLINKS default y depends on CP || MV help - Allow cp and mv to preserve hard links. + Allow cp and mv to preserve hard links. comment "Common options for df, du, ls" depends on DF || DU || LS @@ -35,6 +35,6 @@ config FEATURE_HUMAN_READABLE default y depends on DF || DU || LS help - Allow df, du, and ls to have human readable output. + Allow df, du, and ls to have human readable output. endmenu diff --git a/coreutils/basename.c b/coreutils/basename.c index 6d8215895..481cdcee9 100644 --- a/coreutils/basename.c +++ b/coreutils/basename.c @@ -18,9 +18,9 @@ //config: bool "basename (371 bytes)" //config: default y //config: help -//config: basename is used to strip the directory and suffix from filenames, -//config: leaving just the filename itself. Enable this option if you wish -//config: to enable the 'basename' utility. +//config: basename is used to strip the directory and suffix from filenames, +//config: leaving just the filename itself. Enable this option if you wish +//config: to enable the 'basename' utility. //applet:IF_BASENAME(APPLET_NOFORK(basename, basename, BB_DIR_USR_BIN, BB_SUID_DROP, basename)) diff --git a/coreutils/cat.c b/coreutils/cat.c index 41bef8f1d..390254512 100644 --- a/coreutils/cat.c +++ b/coreutils/cat.c @@ -10,22 +10,22 @@ //config: bool "cat (5.6 kb)" //config: default y //config: help -//config: cat is used to concatenate files and print them to the standard -//config: output. Enable this option if you wish to enable the 'cat' utility. +//config: cat is used to concatenate files and print them to the standard +//config: output. Enable this option if you wish to enable the 'cat' utility. //config: //config:config FEATURE_CATN //config: bool "Enable -n and -b options" //config: default y //config: depends on CAT //config: help -//config: -n numbers all output lines while -b numbers nonempty output lines. +//config: -n numbers all output lines while -b numbers nonempty output lines. //config: //config:config FEATURE_CATV //config: bool "cat -v[etA]" //config: default y //config: depends on CAT //config: help -//config: Display nonprinting characters as escape sequences +//config: Display nonprinting characters as escape sequences //applet:IF_CAT(APPLET(cat, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/chgrp.c b/coreutils/chgrp.c index 834346b4d..27a0edf0d 100644 --- a/coreutils/chgrp.c +++ b/coreutils/chgrp.c @@ -10,7 +10,7 @@ //config: bool "chgrp (7.2 kb)" //config: default y //config: help -//config: chgrp is used to change the group ownership of files. +//config: chgrp is used to change the group ownership of files. //applet:IF_CHGRP(APPLET_NOEXEC(chgrp, chgrp, BB_DIR_BIN, BB_SUID_DROP, chgrp)) diff --git a/coreutils/chmod.c b/coreutils/chmod.c index ec075f7c9..2174334d1 100644 --- a/coreutils/chmod.c +++ b/coreutils/chmod.c @@ -13,7 +13,7 @@ //config: bool "chmod (5.1 kb)" //config: default y //config: help -//config: chmod is used to change the access permission of files. +//config: chmod is used to change the access permission of files. //applet:IF_CHMOD(APPLET_NOEXEC(chmod, chmod, BB_DIR_BIN, BB_SUID_DROP, chmod)) diff --git a/coreutils/chown.c b/coreutils/chown.c index 5c04bc39a..1bfc725cc 100644 --- a/coreutils/chown.c +++ b/coreutils/chown.c @@ -10,8 +10,8 @@ //config: bool "chown (7.2 kb)" //config: default y //config: help -//config: chown is used to change the user and/or group ownership -//config: of files. +//config: chown is used to change the user and/or group ownership +//config: of files. //config: //config:config FEATURE_CHOWN_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/chroot.c b/coreutils/chroot.c index 6fa3a3f27..44a587fe0 100644 --- a/coreutils/chroot.c +++ b/coreutils/chroot.c @@ -10,8 +10,8 @@ //config: bool "chroot (3.7 kb)" //config: default y //config: help -//config: chroot is used to change the root directory and run a command. -//config: The default command is `/bin/sh'. +//config: chroot is used to change the root directory and run a command. +//config: The default command is `/bin/sh'. //applet:IF_CHROOT(APPLET(chroot, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/coreutils/cksum.c b/coreutils/cksum.c index dce17d94b..c0cf65d2a 100644 --- a/coreutils/cksum.c +++ b/coreutils/cksum.c @@ -10,7 +10,7 @@ //config: bool "cksum (4.2 kb)" //config: default y //config: help -//config: cksum is used to calculate the CRC32 checksum of a file. +//config: cksum is used to calculate the CRC32 checksum of a file. //applet:IF_CKSUM(APPLET_NOEXEC(cksum, cksum, BB_DIR_USR_BIN, BB_SUID_DROP, cksum)) diff --git a/coreutils/comm.c b/coreutils/comm.c index 8f9dcde29..5be11468c 100644 --- a/coreutils/comm.c +++ b/coreutils/comm.c @@ -10,8 +10,8 @@ //config: bool "comm (3.9 kb)" //config: default y //config: help -//config: comm is used to compare two files line by line and return -//config: a three-column output. +//config: comm is used to compare two files line by line and return +//config: a three-column output. //applet:IF_COMM(APPLET(comm, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/cp.c b/coreutils/cp.c index 726859c5f..092e39583 100644 --- a/coreutils/cp.c +++ b/coreutils/cp.c @@ -15,15 +15,15 @@ //config: bool "cp (9.7 kb)" //config: default y //config: help -//config: cp is used to copy files and directories. +//config: cp is used to copy files and directories. //config: //config:config FEATURE_CP_LONG_OPTIONS //config: bool "Enable long options" //config: default y //config: depends on CP && LONG_OPTS //config: help -//config: Enable long options. -//config: Also add support for --parents option. +//config: Enable long options. +//config: Also add support for --parents option. //applet:IF_CP(APPLET_NOEXEC(cp, cp, BB_DIR_BIN, BB_SUID_DROP, cp)) diff --git a/coreutils/cut.c b/coreutils/cut.c index 2338702f3..6578ce8ce 100644 --- a/coreutils/cut.c +++ b/coreutils/cut.c @@ -12,8 +12,8 @@ //config: bool "cut (5.3 kb)" //config: default y //config: help -//config: cut is used to print selected parts of lines from -//config: each file to stdout. +//config: cut is used to print selected parts of lines from +//config: each file to stdout. //applet:IF_CUT(APPLET_NOEXEC(cut, cut, BB_DIR_USR_BIN, BB_SUID_DROP, cut)) diff --git a/coreutils/date.c b/coreutils/date.c index c658d000b..0fb9f1f00 100644 --- a/coreutils/date.c +++ b/coreutils/date.c @@ -22,16 +22,16 @@ //config: bool "date (7.1 kb)" //config: default y //config: help -//config: date is used to set the system date or display the -//config: current time in the given format. +//config: date is used to set the system date or display the +//config: current time in the given format. //config: //config:config FEATURE_DATE_ISOFMT //config: bool "Enable ISO date format output (-I)" //config: default y //config: depends on DATE //config: help -//config: Enable option (-I) to output an ISO-8601 compliant -//config: date/time string. +//config: Enable option (-I) to output an ISO-8601 compliant +//config: date/time string. //config: //config:# defaults to "no": stat's nanosecond field is a bit non-portable //config:config FEATURE_DATE_NANO @@ -40,23 +40,23 @@ //config: depends on DATE # syscall(__NR_clock_gettime) //config: select PLATFORM_LINUX //config: help -//config: Support %[num]N format specifier. Adds ~250 bytes of code. +//config: Support %[num]N format specifier. Adds ~250 bytes of code. //config: //config:config FEATURE_DATE_COMPAT //config: bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format" //config: default y //config: depends on DATE //config: help -//config: System time can be set by 'date -s DATE' and simply 'date DATE', -//config: but formats of DATE string are different. 'date DATE' accepts -//config: a rather weird MMDDhhmm[[YY]YY][.ss] format with completely -//config: unnatural placement of year between minutes and seconds. -//config: date -s (and other commands like touch -d) use more sensible -//config: formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss). +//config: System time can be set by 'date -s DATE' and simply 'date DATE', +//config: but formats of DATE string are different. 'date DATE' accepts +//config: a rather weird MMDDhhmm[[YY]YY][.ss] format with completely +//config: unnatural placement of year between minutes and seconds. +//config: date -s (and other commands like touch -d) use more sensible +//config: formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss). //config: -//config: With this option off, 'date DATE' is 'date -s DATE' support -//config: the same format. With it on, 'date DATE' additionally supports -//config: MMDDhhmm[[YY]YY][.ss] format. +//config: With this option off, 'date DATE' is 'date -s DATE' support +//config: the same format. With it on, 'date DATE' additionally supports +//config: MMDDhhmm[[YY]YY][.ss] format. //applet:IF_DATE(APPLET(date, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/dd.c b/coreutils/dd.c index 0150aff96..43545c010 100644 --- a/coreutils/dd.c +++ b/coreutils/dd.c @@ -10,46 +10,46 @@ //config: bool "dd (7.1 kb)" //config: default y //config: help -//config: dd copies a file (from standard input to standard output, -//config: by default) using specific input and output blocksizes, -//config: while optionally performing conversions on it. +//config: dd copies a file (from standard input to standard output, +//config: by default) using specific input and output blocksizes, +//config: while optionally performing conversions on it. //config: //config:config FEATURE_DD_SIGNAL_HANDLING //config: bool "Enable signal handling for status reporting" //config: default y //config: depends on DD //config: help -//config: Sending a SIGUSR1 signal to a running `dd' process makes it -//config: print to standard error the number of records read and written -//config: so far, then to resume copying. +//config: Sending a SIGUSR1 signal to a running `dd' process makes it +//config: print to standard error the number of records read and written +//config: so far, then to resume copying. //config: -//config: $ dd if=/dev/zero of=/dev/null & -//config: $ pid=$!; kill -USR1 $pid; sleep 1; kill $pid -//config: 10899206+0 records in -//config: 10899206+0 records out +//config: $ dd if=/dev/zero of=/dev/null & +//config: $ pid=$!; kill -USR1 $pid; sleep 1; kill $pid +//config: 10899206+0 records in +//config: 10899206+0 records out //config: //config:config FEATURE_DD_THIRD_STATUS_LINE //config: bool "Enable the third status line upon signal" //config: default y //config: depends on DD && FEATURE_DD_SIGNAL_HANDLING //config: help -//config: Displays a coreutils-like third status line with transferred bytes, -//config: elapsed time and speed. +//config: Displays a coreutils-like third status line with transferred bytes, +//config: elapsed time and speed. //config: //config:config FEATURE_DD_IBS_OBS //config: bool "Enable ibs, obs and conv options" //config: default y //config: depends on DD //config: help -//config: Enable support for writing a certain number of bytes in and out, -//config: at a time, and performing conversions on the data stream. +//config: Enable support for writing a certain number of bytes in and out, +//config: at a time, and performing conversions on the data stream. //config: //config:config FEATURE_DD_STATUS //config: bool "Enable status display options" //config: default y //config: depends on DD //config: help -//config: Enable support for status=noxfer/none option. +//config: Enable support for status=noxfer/none option. //applet:IF_DD(APPLET_NOEXEC(dd, dd, BB_DIR_BIN, BB_SUID_DROP, dd)) diff --git a/coreutils/df.c b/coreutils/df.c index 900c57ea2..27dd2b5a8 100644 --- a/coreutils/df.c +++ b/coreutils/df.c @@ -21,17 +21,17 @@ //config: bool "df (7.5 kb)" //config: default y //config: help -//config: df reports the amount of disk space used and available -//config: on filesystems. +//config: df reports the amount of disk space used and available +//config: on filesystems. //config: //config:config FEATURE_DF_FANCY //config: bool "Enable -a, -i, -B" //config: default y //config: depends on DF //config: help -//config: -a Show all filesystems -//config: -i Inodes -//config: -B Blocksize +//config: -a Show all filesystems +//config: -i Inodes +//config: -B Blocksize //applet:IF_DF(APPLET(df, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/dirname.c b/coreutils/dirname.c index 7fa31365f..511267b78 100644 --- a/coreutils/dirname.c +++ b/coreutils/dirname.c @@ -10,8 +10,8 @@ //config: bool "dirname (289 bytes)" //config: default y //config: help -//config: dirname is used to strip a non-directory suffix from -//config: a file name. +//config: dirname is used to strip a non-directory suffix from +//config: a file name. //applet:IF_DIRNAME(APPLET_NOFORK(dirname, dirname, BB_DIR_USR_BIN, BB_SUID_DROP, dirname)) diff --git a/coreutils/dos2unix.c b/coreutils/dos2unix.c index e595bf558..a3d008051 100644 --- a/coreutils/dos2unix.c +++ b/coreutils/dos2unix.c @@ -15,15 +15,15 @@ //config: bool "dos2unix (5.1 kb)" //config: default y //config: help -//config: dos2unix is used to convert a text file from DOS format to -//config: UNIX format, and vice versa. +//config: dos2unix is used to convert a text file from DOS format to +//config: UNIX format, and vice versa. //config: //config:config UNIX2DOS //config: bool "unix2dos (5.1 kb)" //config: default y //config: help -//config: unix2dos is used to convert a text file from UNIX format to -//config: DOS format, and vice versa. +//config: unix2dos is used to convert a text file from UNIX format to +//config: DOS format, and vice versa. //applet:IF_DOS2UNIX(APPLET_NOEXEC(dos2unix, dos2unix, BB_DIR_USR_BIN, BB_SUID_DROP, dos2unix)) //applet:IF_UNIX2DOS(APPLET_NOEXEC(unix2dos, dos2unix, BB_DIR_USR_BIN, BB_SUID_DROP, unix2dos)) diff --git a/coreutils/du.c b/coreutils/du.c index 03e31a0e4..947c46e74 100644 --- a/coreutils/du.c +++ b/coreutils/du.c @@ -22,15 +22,15 @@ //config: bool "du (default blocksize of 512 bytes)" //config: default y //config: help -//config: du is used to report the amount of disk space used -//config: for specified files. +//config: du is used to report the amount of disk space used +//config: for specified files. //config: //config:config FEATURE_DU_DEFAULT_BLOCKSIZE_1K //config: bool "Use a default blocksize of 1024 bytes (1K)" //config: default y //config: depends on DU //config: help -//config: Use a blocksize of (1K) instead of the default 512b. +//config: Use a blocksize of (1K) instead of the default 512b. //applet:IF_DU(APPLET(du, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/echo.c b/coreutils/echo.c index a7e4ca9ac..af33319a1 100644 --- a/coreutils/echo.c +++ b/coreutils/echo.c @@ -22,7 +22,7 @@ //config: bool "echo (basic SuSv3 version taking no options)" //config: default y //config: help -//config: echo is used to print a specified string to stdout. +//config: echo is used to print a specified string to stdout. //config: //config:# this entry also appears in shell/Config.in, next to the echo builtin //config:config FEATURE_FANCY_ECHO diff --git a/coreutils/env.c b/coreutils/env.c index 7037a44c2..8def9c2da 100644 --- a/coreutils/env.c +++ b/coreutils/env.c @@ -27,9 +27,9 @@ //config: bool "env (3.8 kb)" //config: default y //config: help -//config: env is used to set an environment variable and run -//config: a command; without options it displays the current -//config: environment. +//config: env is used to set an environment variable and run +//config: a command; without options it displays the current +//config: environment. //config: //config:config FEATURE_ENV_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/expand.c b/coreutils/expand.c index dff0ce558..64f2a539d 100644 --- a/coreutils/expand.c +++ b/coreutils/expand.c @@ -24,7 +24,7 @@ //config: bool "expand (5.8 kb)" //config: default y //config: help -//config: By default, convert all tabs to spaces. +//config: By default, convert all tabs to spaces. //config: //config:config FEATURE_EXPAND_LONG_OPTIONS //config: bool "Enable long options" @@ -35,7 +35,7 @@ //config: bool "unexpand (6 kb)" //config: default y //config: help -//config: By default, convert only leading sequences of blanks to tabs. +//config: By default, convert only leading sequences of blanks to tabs. //config: //config:config FEATURE_UNEXPAND_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/expr.c b/coreutils/expr.c index ecb7534b2..a2bbfdd69 100644 --- a/coreutils/expr.c +++ b/coreutils/expr.c @@ -26,17 +26,17 @@ //config: bool "expr (6.1 kb)" //config: default y //config: help -//config: expr is used to calculate numbers and print the result -//config: to standard output. +//config: expr is used to calculate numbers and print the result +//config: to standard output. //config: //config:config EXPR_MATH_SUPPORT_64 //config: bool "Extend Posix numbers support to 64 bit" //config: default y //config: depends on EXPR //config: help -//config: Enable 64-bit math support in the expr applet. This will make -//config: the applet slightly larger, but will allow computation with very -//config: large numbers. +//config: Enable 64-bit math support in the expr applet. This will make +//config: the applet slightly larger, but will allow computation with very +//config: large numbers. //applet:IF_EXPR(APPLET(expr, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/factor.c b/coreutils/factor.c index 4ccc3fee4..467e23a4d 100644 --- a/coreutils/factor.c +++ b/coreutils/factor.c @@ -7,7 +7,7 @@ //config: bool "factor (2.6 kb)" //config: default y //config: help -//config: factor factorizes integers +//config: factor factorizes integers //applet:IF_FACTOR(APPLET(factor, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/false.c b/coreutils/false.c index 171ad813b..e3903efd0 100644 --- a/coreutils/false.c +++ b/coreutils/false.c @@ -10,7 +10,7 @@ //config: bool "false (tiny)" //config: default y //config: help -//config: false returns an exit code of FALSE (1). +//config: false returns an exit code of FALSE (1). //applet:IF_FALSE(APPLET_NOFORK(false, false, BB_DIR_BIN, BB_SUID_DROP, false)) diff --git a/coreutils/fold.c b/coreutils/fold.c index 35905f3df..286db228d 100644 --- a/coreutils/fold.c +++ b/coreutils/fold.c @@ -13,7 +13,7 @@ //config: bool "fold (4.6 kb)" //config: default y //config: help -//config: Wrap text to fit a specific width. +//config: Wrap text to fit a specific width. //applet:IF_FOLD(APPLET_NOEXEC(fold, fold, BB_DIR_USR_BIN, BB_SUID_DROP, fold)) diff --git a/coreutils/fsync.c b/coreutils/fsync.c index 8524047a5..5e77e2c16 100644 --- a/coreutils/fsync.c +++ b/coreutils/fsync.c @@ -10,7 +10,7 @@ //config: bool "fsync (3.7 kb)" //config: default y //config: help -//config: fsync is used to flush file-related cached blocks to disk. +//config: fsync is used to flush file-related cached blocks to disk. //applet:IF_FSYNC(APPLET_NOFORK(fsync, fsync, BB_DIR_BIN, BB_SUID_DROP, fsync)) diff --git a/coreutils/head.c b/coreutils/head.c index b4b16abea..fc3a48d5b 100644 --- a/coreutils/head.c +++ b/coreutils/head.c @@ -10,8 +10,8 @@ //config: bool "head (3.7 kb)" //config: default y //config: help -//config: head is used to print the first specified number of lines -//config: from files. +//config: head is used to print the first specified number of lines +//config: from files. //config: //config:config FEATURE_FANCY_HEAD //config: bool "Enable -c, -q, and -v" diff --git a/coreutils/hostid.c b/coreutils/hostid.c index 790384c95..d21e6d6ac 100644 --- a/coreutils/hostid.c +++ b/coreutils/hostid.c @@ -10,8 +10,8 @@ //config: bool "hostid (247 bytes)" //config: default y //config: help -//config: hostid prints the numeric identifier (in hexadecimal) for -//config: the current host. +//config: hostid prints the numeric identifier (in hexadecimal) for +//config: the current host. //applet:IF_HOSTID(APPLET_NOFORK(hostid, hostid, BB_DIR_USR_BIN, BB_SUID_DROP, hostid)) diff --git a/coreutils/id.c b/coreutils/id.c index 93ca0acf6..6043bca61 100644 --- a/coreutils/id.c +++ b/coreutils/id.c @@ -16,13 +16,13 @@ //config: bool "id (6.7 kb)" //config: default y //config: help -//config: id displays the current user and group ID names. +//config: id displays the current user and group ID names. //config: //config:config GROUPS //config: bool "groups (6.5 kb)" //config: default y //config: help -//config: Print the group names associated with current user id. +//config: Print the group names associated with current user id. //applet:IF_GROUPS(APPLET_NOEXEC(groups, id, BB_DIR_USR_BIN, BB_SUID_DROP, groups)) //applet:IF_ID( APPLET_NOEXEC(id, id, BB_DIR_USR_BIN, BB_SUID_DROP, id )) diff --git a/coreutils/install.c b/coreutils/install.c index 4c44f0d4d..a1342bb13 100644 --- a/coreutils/install.c +++ b/coreutils/install.c @@ -9,7 +9,7 @@ //config: bool "install (12 kb)" //config: default y //config: help -//config: Copy files and set attributes. +//config: Copy files and set attributes. //config: //config:config FEATURE_INSTALL_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/link.c b/coreutils/link.c index c6417fef8..56832fdf6 100644 --- a/coreutils/link.c +++ b/coreutils/link.c @@ -9,7 +9,7 @@ //config: bool "link (3.1 kb)" //config: default y //config: help -//config: link creates hard links between files. +//config: link creates hard links between files. //applet:IF_LINK(APPLET_NOFORK(link, link, BB_DIR_BIN, BB_SUID_DROP, link)) diff --git a/coreutils/ln.c b/coreutils/ln.c index 0bd323b2a..fed96af42 100644 --- a/coreutils/ln.c +++ b/coreutils/ln.c @@ -10,7 +10,7 @@ //config: bool "ln (4.5 kb)" //config: default y //config: help -//config: ln is used to create hard or soft links between files. +//config: ln is used to create hard or soft links between files. //applet:IF_LN(APPLET_NOEXEC(ln, ln, BB_DIR_BIN, BB_SUID_DROP, ln)) diff --git a/coreutils/logname.c b/coreutils/logname.c index bf3748338..e614ca7cf 100644 --- a/coreutils/logname.c +++ b/coreutils/logname.c @@ -19,7 +19,7 @@ //config: bool "logname (894 bytes)" //config: default y //config: help -//config: logname is used to print the current user's login name. +//config: logname is used to print the current user's login name. //applet:IF_LOGNAME(APPLET_NOFORK(logname, logname, BB_DIR_USR_BIN, BB_SUID_DROP, logname)) diff --git a/coreutils/ls.c b/coreutils/ls.c index cf5228745..0fe0345b3 100644 --- a/coreutils/ls.c +++ b/coreutils/ls.c @@ -31,7 +31,7 @@ //config: bool "ls (14 kb)" //config: default y //config: help -//config: ls is used to list the contents of directories. +//config: ls is used to list the contents of directories. //config: //config:config FEATURE_LS_FILETYPES //config: bool "Enable filetyping options (-p and -F)" @@ -58,39 +58,39 @@ //config: default y //config: depends on LS //config: help -//config: Allow ls to sort file names alphabetically. +//config: Allow ls to sort file names alphabetically. //config: //config:config FEATURE_LS_TIMESTAMPS //config: bool "Show file timestamps" //config: default y //config: depends on LS //config: help -//config: Allow ls to display timestamps for files. +//config: Allow ls to display timestamps for files. //config: //config:config FEATURE_LS_USERNAME //config: bool "Show username/groupnames" //config: default y //config: depends on LS //config: help -//config: Allow ls to display username/groupname for files. +//config: Allow ls to display username/groupname for files. //config: //config:config FEATURE_LS_COLOR //config: bool "Allow use of color to identify file types" //config: default y //config: depends on LS && LONG_OPTS //config: help -//config: This enables the --color option to ls. +//config: This enables the --color option to ls. //config: //config:config FEATURE_LS_COLOR_IS_DEFAULT //config: bool "Produce colored ls output by default" //config: default y //config: depends on FEATURE_LS_COLOR //config: help -//config: Saying yes here will turn coloring on by default, -//config: even if no "--color" option is given to the ls command. -//config: This is not recommended, since the colors are not -//config: configurable, and the output may not be legible on -//config: many output screens. +//config: Saying yes here will turn coloring on by default, +//config: even if no "--color" option is given to the ls command. +//config: This is not recommended, since the colors are not +//config: configurable, and the output may not be legible on +//config: many output screens. //applet:IF_LS(APPLET_NOEXEC(ls, ls, BB_DIR_BIN, BB_SUID_DROP, ls)) diff --git a/coreutils/md5_sha1_sum.c b/coreutils/md5_sha1_sum.c index 6d08d2e40..bcccdd64f 100644 --- a/coreutils/md5_sha1_sum.c +++ b/coreutils/md5_sha1_sum.c @@ -9,31 +9,31 @@ //config: bool "md5sum (6.8 kb)" //config: default y //config: help -//config: md5sum is used to print or check MD5 checksums. +//config: md5sum is used to print or check MD5 checksums. //config: //config:config SHA1SUM //config: bool "sha1sum (6 kb)" //config: default y //config: help -//config: Compute and check SHA1 message digest +//config: Compute and check SHA1 message digest //config: //config:config SHA256SUM //config: bool "sha256sum (7.1 kb)" //config: default y //config: help -//config: Compute and check SHA256 message digest +//config: Compute and check SHA256 message digest //config: //config:config SHA512SUM //config: bool "sha512sum (7.6 kb)" //config: default y //config: help -//config: Compute and check SHA512 message digest +//config: Compute and check SHA512 message digest //config: //config:config SHA3SUM //config: bool "sha3sum (6.3 kb)" //config: default y //config: help -//config: Compute and check SHA3 message digest +//config: Compute and check SHA3 message digest //config: //config:comment "Common options for md5sum, sha1sum, sha256sum, sha512sum, sha3sum" //config: depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM @@ -43,9 +43,9 @@ //config: default y //config: depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM //config: help -//config: Enabling the -c options allows files to be checked -//config: against pre-calculated hash values. -//config: -s and -w are useful options when verifying checksums. +//config: Enabling the -c options allows files to be checked +//config: against pre-calculated hash values. +//config: -s and -w are useful options when verifying checksums. //applet:IF_MD5SUM(APPLET_NOEXEC(md5sum, md5_sha1_sum, BB_DIR_USR_BIN, BB_SUID_DROP, md5sum)) //applet:IF_SHA1SUM(APPLET_NOEXEC(sha1sum, md5_sha1_sum, BB_DIR_USR_BIN, BB_SUID_DROP, sha1sum)) diff --git a/coreutils/mkdir.c b/coreutils/mkdir.c index d0b74bfde..22851187c 100644 --- a/coreutils/mkdir.c +++ b/coreutils/mkdir.c @@ -17,7 +17,7 @@ //config: bool "mkdir (4.4 kb)" //config: default y //config: help -//config: mkdir is used to create directories with the specified names. +//config: mkdir is used to create directories with the specified names. //config: //config:config FEATURE_MKDIR_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/mkfifo.c b/coreutils/mkfifo.c index 8a2f20553..0f614017e 100644 --- a/coreutils/mkfifo.c +++ b/coreutils/mkfifo.c @@ -10,8 +10,8 @@ //config: bool "mkfifo (3.7 kb)" //config: default y //config: help -//config: mkfifo is used to create FIFOs (named pipes). -//config: The 'mknod' program can also create FIFOs. +//config: mkfifo is used to create FIFOs (named pipes). +//config: The 'mknod' program can also create FIFOs. //applet:IF_MKFIFO(APPLET_NOEXEC(mkfifo, mkfifo, BB_DIR_USR_BIN, BB_SUID_DROP, mkfifo)) diff --git a/coreutils/mknod.c b/coreutils/mknod.c index 321415e17..565b33d20 100644 --- a/coreutils/mknod.c +++ b/coreutils/mknod.c @@ -10,8 +10,8 @@ //config: bool "mknod (4 kb)" //config: default y //config: help -//config: mknod is used to create FIFOs or block/character special -//config: files with the specified names. +//config: mknod is used to create FIFOs or block/character special +//config: files with the specified names. //applet:IF_MKNOD(APPLET_NOEXEC(mknod, mknod, BB_DIR_BIN, BB_SUID_DROP, mknod)) diff --git a/coreutils/mktemp.c b/coreutils/mktemp.c index 3e35befeb..bfef0b4a6 100644 --- a/coreutils/mktemp.c +++ b/coreutils/mktemp.c @@ -34,7 +34,7 @@ //config: bool "mktemp (4 kb)" //config: default y //config: help -//config: mktemp is used to create unique temporary files +//config: mktemp is used to create unique temporary files //applet:IF_MKTEMP(APPLET(mktemp, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/mv.c b/coreutils/mv.c index d620c43ab..147dd3bb2 100644 --- a/coreutils/mv.c +++ b/coreutils/mv.c @@ -15,7 +15,7 @@ //config: bool "mv (9.8 kb)" //config: default y //config: help -//config: mv is used to move or rename files or directories. +//config: mv is used to move or rename files or directories. //config: //config:config FEATURE_MV_LONG_OPTIONS //config: bool "Enable long options" diff --git a/coreutils/nice.c b/coreutils/nice.c index e30242ffa..0bf055299 100644 --- a/coreutils/nice.c +++ b/coreutils/nice.c @@ -10,7 +10,7 @@ //config: bool "nice (1.8 kb)" //config: default y //config: help -//config: nice runs a program with modified scheduling priority. +//config: nice runs a program with modified scheduling priority. //applet:IF_NICE(APPLET(nice, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/nl.c b/coreutils/nl.c index 9f303fe6c..93e78c490 100644 --- a/coreutils/nl.c +++ b/coreutils/nl.c @@ -8,7 +8,7 @@ //config: bool "nl (4.3 kb)" //config: default y //config: help -//config: nl is used to number lines of files. +//config: nl is used to number lines of files. //applet:IF_NL(APPLET(nl, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/nohup.c b/coreutils/nohup.c index 4366cdc8d..8e28f9029 100644 --- a/coreutils/nohup.c +++ b/coreutils/nohup.c @@ -13,7 +13,7 @@ //config: bool "nohup (2 kb)" //config: default y //config: help -//config: run a command immune to hangups, with output to a non-tty. +//config: run a command immune to hangups, with output to a non-tty. //applet:IF_NOHUP(APPLET(nohup, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/nproc.c b/coreutils/nproc.c index 7144f73e8..68a831865 100644 --- a/coreutils/nproc.c +++ b/coreutils/nproc.c @@ -7,7 +7,7 @@ //config: bool "nproc (248 bytes)" //config: default y //config: help -//config: Print number of CPUs +//config: Print number of CPUs //applet:IF_NPROC(APPLET(nproc, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/od.c b/coreutils/od.c index edcd12a54..e3a68435b 100644 --- a/coreutils/od.c +++ b/coreutils/od.c @@ -14,7 +14,7 @@ //config: bool "od (11 kb)" //config: default y //config: help -//config: od is used to dump binary files in octal and other formats. +//config: od is used to dump binary files in octal and other formats. //applet:IF_OD(APPLET(od, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/paste.c b/coreutils/paste.c index e4e9c7565..52f67f951 100644 --- a/coreutils/paste.c +++ b/coreutils/paste.c @@ -10,8 +10,8 @@ //config: bool "paste (4.5 kb)" //config: default y //config: help -//config: paste is used to paste lines of different files together -//config: and write the result to stdout +//config: paste is used to paste lines of different files together +//config: and write the result to stdout //applet:IF_PASTE(APPLET_NOEXEC(paste, paste, BB_DIR_USR_BIN, BB_SUID_DROP, paste)) diff --git a/coreutils/printenv.c b/coreutils/printenv.c index 767a27525..b0468b3f7 100644 --- a/coreutils/printenv.c +++ b/coreutils/printenv.c @@ -11,7 +11,7 @@ //config: bool "printenv (1 kb)" //config: default y //config: help -//config: printenv is used to print all or part of environment. +//config: printenv is used to print all or part of environment. //applet:IF_PRINTENV(APPLET_NOFORK(printenv, printenv, BB_DIR_BIN, BB_SUID_DROP, printenv)) diff --git a/coreutils/printf.c b/coreutils/printf.c index acaf076ff..d3fc72adb 100644 --- a/coreutils/printf.c +++ b/coreutils/printf.c @@ -42,8 +42,8 @@ //config: bool "printf (3.3 kb)" //config: default y //config: help -//config: printf is used to format and print specified strings. -//config: It's similar to `echo' except it has more options. +//config: printf is used to format and print specified strings. +//config: It's similar to `echo' except it has more options. //applet:IF_PRINTF(APPLET_NOFORK(printf, printf, BB_DIR_USR_BIN, BB_SUID_DROP, printf)) diff --git a/coreutils/pwd.c b/coreutils/pwd.c index e0a195d37..345d85100 100644 --- a/coreutils/pwd.c +++ b/coreutils/pwd.c @@ -10,7 +10,7 @@ //config: bool "pwd (3.4 kb)" //config: default y //config: help -//config: pwd is used to print the current directory. +//config: pwd is used to print the current directory. //applet:IF_PWD(APPLET_NOFORK(pwd, pwd, BB_DIR_BIN, BB_SUID_DROP, pwd)) diff --git a/coreutils/readlink.c b/coreutils/readlink.c index e593bb9a4..9690290e3 100644 --- a/coreutils/readlink.c +++ b/coreutils/readlink.c @@ -10,15 +10,15 @@ //config: bool "readlink (3.6 kb)" //config: default y //config: help -//config: This program reads a symbolic link and returns the name -//config: of the file it points to +//config: This program reads a symbolic link and returns the name +//config: of the file it points to //config: //config:config FEATURE_READLINK_FOLLOW //config: bool "Enable canonicalization by following all symlinks (-f)" //config: default y //config: depends on READLINK //config: help -//config: Enable the readlink option (-f). +//config: Enable the readlink option (-f). //applet:IF_READLINK(APPLET(readlink, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/realpath.c b/coreutils/realpath.c index a2661c461..6a61c3dc8 100644 --- a/coreutils/realpath.c +++ b/coreutils/realpath.c @@ -10,8 +10,8 @@ //config: bool "realpath (1.1 kb)" //config: default y //config: help -//config: Return the canonicalized absolute pathname. -//config: This isn't provided by GNU shellutils, but where else does it belong. +//config: Return the canonicalized absolute pathname. +//config: This isn't provided by GNU shellutils, but where else does it belong. //applet:IF_REALPATH(APPLET(realpath, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/rm.c b/coreutils/rm.c index 70530a458..f91c94570 100644 --- a/coreutils/rm.c +++ b/coreutils/rm.c @@ -14,7 +14,7 @@ //config: bool "rm (4.9 kb)" //config: default y //config: help -//config: rm is used to remove files or directories. +//config: rm is used to remove files or directories. //applet:IF_RM(APPLET_NOFORK(rm, rm, BB_DIR_BIN, BB_SUID_DROP, rm)) diff --git a/coreutils/rmdir.c b/coreutils/rmdir.c index 2486ea67e..c04ce78f8 100644 --- a/coreutils/rmdir.c +++ b/coreutils/rmdir.c @@ -10,15 +10,15 @@ //config: bool "rmdir (3.4 kb)" //config: default y //config: help -//config: rmdir is used to remove empty directories. +//config: rmdir is used to remove empty directories. //config: //config:config FEATURE_RMDIR_LONG_OPTIONS //config: bool "Enable long options" //config: default y //config: depends on RMDIR && LONG_OPTS //config: help -//config: Support long options for the rmdir applet, including -//config: --ignore-fail-on-non-empty for compatibility with GNU rmdir. +//config: Support long options for the rmdir applet, including +//config: --ignore-fail-on-non-empty for compatibility with GNU rmdir. //applet:IF_RMDIR(APPLET_NOFORK(rmdir, rmdir, BB_DIR_BIN, BB_SUID_DROP, rmdir)) diff --git a/coreutils/seq.c b/coreutils/seq.c index c66bed94a..f36dbb4ec 100644 --- a/coreutils/seq.c +++ b/coreutils/seq.c @@ -10,7 +10,7 @@ //config: bool "seq (3.6 kb)" //config: default y //config: help -//config: print a sequence of numbers +//config: print a sequence of numbers //applet:IF_SEQ(APPLET_NOFORK(seq, seq, BB_DIR_USR_BIN, BB_SUID_DROP, seq)) diff --git a/coreutils/shred.c b/coreutils/shred.c index 93319e24d..3ceb58d19 100644 --- a/coreutils/shred.c +++ b/coreutils/shred.c @@ -8,7 +8,7 @@ //config: bool "shred (5 kb)" //config: default y //config: help -//config: Overwrite a file to hide its contents, and optionally delete it +//config: Overwrite a file to hide its contents, and optionally delete it //applet:IF_SHRED(APPLET(shred, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/shuf.c b/coreutils/shuf.c index b1a9d1254..403041534 100644 --- a/coreutils/shuf.c +++ b/coreutils/shuf.c @@ -11,7 +11,7 @@ //config: bool "shuf (5.4 kb)" //config: default y //config: help -//config: Generate random permutations +//config: Generate random permutations //kbuild:lib-$(CONFIG_SHUF) += shuf.o //applet:IF_SHUF(APPLET_NOEXEC(shuf, shuf, BB_DIR_USR_BIN, BB_SUID_DROP, shuf)) diff --git a/coreutils/sleep.c b/coreutils/sleep.c index 6b3aa1ffa..9b9581ca9 100644 --- a/coreutils/sleep.c +++ b/coreutils/sleep.c @@ -16,29 +16,29 @@ //config: bool "sleep (1.7 kb)" //config: default y //config: help -//config: sleep is used to pause for a specified number of seconds. -//config: It comes in 3 versions: -//config: - small: takes one integer parameter -//config: - fancy: takes multiple integer arguments with suffixes: -//config: sleep 1d 2h 3m 15s -//config: - fancy with fractional numbers: -//config: sleep 2.3s 4.5h sleeps for 16202.3 seconds -//config: Last one is "the most compatible" with coreutils sleep, -//config: but it adds around 1k of code. +//config: sleep is used to pause for a specified number of seconds. +//config: It comes in 3 versions: +//config: - small: takes one integer parameter +//config: - fancy: takes multiple integer arguments with suffixes: +//config: sleep 1d 2h 3m 15s +//config: - fancy with fractional numbers: +//config: sleep 2.3s 4.5h sleeps for 16202.3 seconds +//config: Last one is "the most compatible" with coreutils sleep, +//config: but it adds around 1k of code. //config: //config:config FEATURE_FANCY_SLEEP //config: bool "Enable multiple arguments and s/m/h/d suffixes" //config: default y //config: depends on SLEEP //config: help -//config: Allow sleep to pause for specified minutes, hours, and days. +//config: Allow sleep to pause for specified minutes, hours, and days. //config: //config:config FEATURE_FLOAT_SLEEP //config: bool "Enable fractional arguments" //config: default y //config: depends on FEATURE_FANCY_SLEEP //config: help -//config: Allow for fractional numeric parameters. +//config: Allow for fractional numeric parameters. /* Do not make this applet NOFORK. It breaks ^C-ing of pauses in shells */ //applet:IF_SLEEP(APPLET(sleep, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/sort.c b/coreutils/sort.c index a8803819d..9860dca64 100644 --- a/coreutils/sort.c +++ b/coreutils/sort.c @@ -15,19 +15,19 @@ //config: bool "sort (7.4 kb)" //config: default y //config: help -//config: sort is used to sort lines of text in specified files. +//config: sort is used to sort lines of text in specified files. //config: //config:config FEATURE_SORT_BIG //config: bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)" //config: default y //config: depends on SORT //config: help -//config: Without this, sort only supports -r, -u, and an integer version -//config: of -n. Selecting this adds sort keys, floating point support, and -//config: more. This adds a little over 3k to a nonstatic build on x86. +//config: Without this, sort only supports -r, -u, and an integer version +//config: of -n. Selecting this adds sort keys, floating point support, and +//config: more. This adds a little over 3k to a nonstatic build on x86. //config: -//config: The SuSv3 sort standard is available at: -//config: http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html +//config: The SuSv3 sort standard is available at: +//config: http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html //applet:IF_SORT(APPLET_NOEXEC(sort, sort, BB_DIR_USR_BIN, BB_SUID_DROP, sort)) diff --git a/coreutils/split.c b/coreutils/split.c index dc6f62109..d0c63573a 100644 --- a/coreutils/split.c +++ b/coreutils/split.c @@ -9,16 +9,16 @@ //config: bool "split (5.4 kb)" //config: default y //config: help -//config: Split a file into pieces. +//config: Split a file into pieces. //config: //config:config FEATURE_SPLIT_FANCY //config: bool "Fancy extensions" //config: default y //config: depends on SPLIT //config: help -//config: Add support for features not required by SUSv3. -//config: Supports additional suffixes 'b' for 512 bytes, -//config: 'g' for 1GiB for the -b option. +//config: Add support for features not required by SUSv3. +//config: Supports additional suffixes 'b' for 512 bytes, +//config: 'g' for 1GiB for the -b option. //applet:IF_SPLIT(APPLET(split, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/stat.c b/coreutils/stat.c index e2f9a223d..3b85808b5 100644 --- a/coreutils/stat.c +++ b/coreutils/stat.c @@ -16,16 +16,16 @@ //config: bool "stat (10 kb)" //config: default y //config: help -//config: display file or filesystem status. +//config: display file or filesystem status. //config: //config:config FEATURE_STAT_FORMAT //config: bool "Enable custom formats (-c)" //config: default y //config: depends on STAT //config: help -//config: Without this, stat will not support the '-c format' option where -//config: users can pass a custom format string for output. This adds about -//config: 7k to a nonstatic build on amd64. +//config: Without this, stat will not support the '-c format' option where +//config: users can pass a custom format string for output. This adds about +//config: 7k to a nonstatic build on amd64. //config: //config:config FEATURE_STAT_FILESYSTEM //config: bool "Enable display of filesystem status (-f)" @@ -33,8 +33,8 @@ //config: depends on STAT //config: select PLATFORM_LINUX # statfs() //config: help -//config: Without this, stat will not support the '-f' option to display -//config: information about filesystem status. +//config: Without this, stat will not support the '-f' option to display +//config: information about filesystem status. //applet:IF_STAT(APPLET(stat, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/stty.c b/coreutils/stty.c index 3a4b32ce0..f987fbbcf 100644 --- a/coreutils/stty.c +++ b/coreutils/stty.c @@ -23,7 +23,7 @@ //config: bool "stty (8.6 kb)" //config: default y //config: help -//config: stty is used to change and print terminal line settings. +//config: stty is used to change and print terminal line settings. //applet:IF_STTY(APPLET(stty, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/coreutils/sum.c b/coreutils/sum.c index ef2f94e45..487e93f4a 100644 --- a/coreutils/sum.c +++ b/coreutils/sum.c @@ -16,7 +16,7 @@ //config: bool "sum (4.3 kb)" //config: default y //config: help -//config: checksum and count the blocks in a file +//config: checksum and count the blocks in a file //applet:IF_SUM(APPLET(sum, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/sync.c b/coreutils/sync.c index 5557103b3..66445281a 100644 --- a/coreutils/sync.c +++ b/coreutils/sync.c @@ -11,14 +11,14 @@ //config: bool "sync (769 bytes)" //config: default y //config: help -//config: sync is used to flush filesystem buffers. +//config: sync is used to flush filesystem buffers. //config:config FEATURE_SYNC_FANCY //config: bool "Enable -d and -f flags (requires syncfs(2) in libc)" //config: default y //config: depends on SYNC //config: help -//config: sync -d FILE... executes fdatasync() on each FILE. -//config: sync -f FILE... executes syncfs() on each FILE. +//config: sync -d FILE... executes fdatasync() on each FILE. +//config: sync -f FILE... executes syncfs() on each FILE. //applet:IF_SYNC(APPLET_NOFORK(sync, sync, BB_DIR_BIN, BB_SUID_DROP, sync)) diff --git a/coreutils/tac.c b/coreutils/tac.c index 1f5b34a84..6d3ea9c19 100644 --- a/coreutils/tac.c +++ b/coreutils/tac.c @@ -16,7 +16,7 @@ //config: bool "tac (4.1 kb)" //config: default y //config: help -//config: tac is used to concatenate and print files in reverse. +//config: tac is used to concatenate and print files in reverse. //applet:IF_TAC(APPLET_NOEXEC(tac, tac, BB_DIR_USR_BIN, BB_SUID_DROP, tac)) diff --git a/coreutils/tail.c b/coreutils/tail.c index a834e241e..fd310f422 100644 --- a/coreutils/tail.c +++ b/coreutils/tail.c @@ -22,20 +22,20 @@ //config: bool "tail (7.1 kb)" //config: default y //config: help -//config: tail is used to print the last specified number of lines -//config: from files. +//config: tail is used to print the last specified number of lines +//config: from files. //config: //config:config FEATURE_FANCY_TAIL //config: bool "Enable -q, -s, -v, and -F options" //config: default y //config: depends on TAIL //config: help -//config: These options are provided by GNU tail, but -//config: are not specific in the SUSv3 standard: -//config: -q Never output headers giving file names -//config: -s SEC Wait SEC seconds between reads with -f -//config: -v Always output headers giving file names -//config: -F Same as -f, but keep retrying +//config: These options are provided by GNU tail, but +//config: are not specified in the SUSv3 standard: +//config: -q Never output headers giving file names +//config: -s SEC Wait SEC seconds between reads with -f +//config: -v Always output headers giving file names +//config: -F Same as -f, but keep retrying //applet:IF_TAIL(APPLET(tail, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/tee.c b/coreutils/tee.c index f7676ce9e..f0ec791bb 100644 --- a/coreutils/tee.c +++ b/coreutils/tee.c @@ -10,15 +10,15 @@ //config: bool "tee (4.3 kb)" //config: default y //config: help -//config: tee is used to read from standard input and write -//config: to standard output and files. +//config: tee is used to read from standard input and write +//config: to standard output and files. //config: //config:config FEATURE_TEE_USE_BLOCK_IO //config: bool "Enable block I/O (larger/faster) instead of byte I/O" //config: default y //config: depends on TEE //config: help -//config: Enable this option for a faster tee, at expense of size. +//config: Enable this option for a faster tee, at expense of size. //applet:IF_TEE(APPLET(tee, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/test.c b/coreutils/test.c index 5cca5d1f2..d8ac42e22 100644 --- a/coreutils/test.c +++ b/coreutils/test.c @@ -23,28 +23,28 @@ //config: bool "test (3.6 kb)" //config: default y //config: help -//config: test is used to check file types and compare values, -//config: returning an appropriate exit code. The bash shell -//config: has test built in, ash can build it in optionally. +//config: test is used to check file types and compare values, +//config: returning an appropriate exit code. The bash shell +//config: has test built in, ash can build it in optionally. //config: //config:config TEST1 //config: bool "test as [" //config: default y //config: help -//config: Provide test command in the "[ EXPR ]" form +//config: Provide test command in the "[ EXPR ]" form //config: //config:config TEST2 //config: bool "test as [[" //config: default y //config: help -//config: Provide test command in the "[[ EXPR ]]" form +//config: Provide test command in the "[[ EXPR ]]" form //config: //config:config FEATURE_TEST_64 //config: bool "Extend test to 64 bit" //config: default y //config: depends on TEST || TEST1 || TEST2 || ASH_TEST || HUSH_TEST //config: help -//config: Enable 64-bit support in test. +//config: Enable 64-bit support in test. //applet:IF_TEST(APPLET_NOFORK(test, test, BB_DIR_USR_BIN, BB_SUID_DROP, test)) //applet:IF_TEST1(APPLET_NOFORK([, test, BB_DIR_USR_BIN, BB_SUID_DROP, test)) diff --git a/coreutils/timeout.c b/coreutils/timeout.c index 5981c7bcb..4a6117f59 100644 --- a/coreutils/timeout.c +++ b/coreutils/timeout.c @@ -31,8 +31,8 @@ //config: bool "timeout (5.5 kb)" //config: default y //config: help -//config: Runs a program and watches it. If it does not terminate in -//config: specified number of seconds, it is sent a signal. +//config: Runs a program and watches it. If it does not terminate in +//config: specified number of seconds, it is sent a signal. //applet:IF_TIMEOUT(APPLET(timeout, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/touch.c b/coreutils/touch.c index 7b7b9f8a1..11b40d427 100644 --- a/coreutils/touch.c +++ b/coreutils/touch.c @@ -16,23 +16,23 @@ //config: bool "touch (5.8 kb)" //config: default y //config: help -//config: touch is used to create or change the access and/or -//config: modification timestamp of specified files. +//config: touch is used to create or change the access and/or +//config: modification timestamp of specified files. //config: //config:config FEATURE_TOUCH_NODEREF //config: bool "Add support for -h" //config: default y //config: depends on TOUCH //config: help -//config: Enable touch to have the -h option. -//config: This requires libc support for lutimes() function. +//config: Enable touch to have the -h option. +//config: This requires libc support for lutimes() function. //config: //config:config FEATURE_TOUCH_SUSV3 //config: bool "Add support for SUSV3 features (-d -t -r)" //config: default y //config: depends on TOUCH //config: help -//config: Enable touch to use a reference file or a given date/time argument. +//config: Enable touch to use a reference file or a given date/time argument. //applet:IF_TOUCH(APPLET_NOFORK(touch, touch, BB_DIR_BIN, BB_SUID_DROP, touch)) diff --git a/coreutils/tr.c b/coreutils/tr.c index 4281a2c69..64e4efc91 100644 --- a/coreutils/tr.c +++ b/coreutils/tr.c @@ -22,27 +22,27 @@ //config: bool "tr (5.5 kb)" //config: default y //config: help -//config: tr is used to squeeze, and/or delete characters from standard -//config: input, writing to standard output. +//config: tr is used to squeeze, and/or delete characters from standard +//config: input, writing to standard output. //config: //config:config FEATURE_TR_CLASSES //config: bool "Enable character classes (such as [:upper:])" //config: default y //config: depends on TR //config: help -//config: Enable character classes, enabling commands such as: -//config: tr [:upper:] [:lower:] to convert input into lowercase. +//config: Enable character classes, enabling commands such as: +//config: tr [:upper:] [:lower:] to convert input into lowercase. //config: //config:config FEATURE_TR_EQUIV //config: bool "Enable equivalence classes" //config: default y //config: depends on TR //config: help -//config: Enable equivalence classes, which essentially add the enclosed -//config: character to the current set. For instance, tr [=a=] xyz would -//config: replace all instances of 'a' with 'xyz'. This option is mainly -//config: useful for cases when no other way of expressing a character -//config: is possible. +//config: Enable equivalence classes, which essentially add the enclosed +//config: character to the current set. For instance, tr [=a=] xyz would +//config: replace all instances of 'a' with 'xyz'. This option is mainly +//config: useful for cases when no other way of expressing a character +//config: is possible. //applet:IF_TR(APPLET(tr, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/true.c b/coreutils/true.c index 29386b021..400388c34 100644 --- a/coreutils/true.c +++ b/coreutils/true.c @@ -10,7 +10,7 @@ //config: bool "true (tiny)" //config: default y //config: help -//config: true returns an exit code of TRUE (0). +//config: true returns an exit code of TRUE (0). //applet:IF_TRUE(APPLET_NOFORK(true, true, BB_DIR_BIN, BB_SUID_DROP, true)) diff --git a/coreutils/truncate.c b/coreutils/truncate.c index eefe2b4fc..f67abaf40 100644 --- a/coreutils/truncate.c +++ b/coreutils/truncate.c @@ -9,8 +9,8 @@ //config: bool "truncate (4.7 kb)" //config: default y //config: help -//config: truncate truncates files to a given size. If a file does -//config: not exist, it is created unless told otherwise. +//config: truncate truncates files to a given size. If a file does +//config: not exist, it is created unless told otherwise. //applet:IF_TRUNCATE(APPLET_NOFORK(truncate, truncate, BB_DIR_USR_BIN, BB_SUID_DROP, truncate)) diff --git a/coreutils/tty.c b/coreutils/tty.c index 9a5f1ef52..331941a01 100644 --- a/coreutils/tty.c +++ b/coreutils/tty.c @@ -10,8 +10,8 @@ //config: bool "tty (3.3 kb)" //config: default y //config: help -//config: tty is used to print the name of the current terminal to -//config: standard output. +//config: tty is used to print the name of the current terminal to +//config: standard output. //applet:IF_TTY(APPLET(tty, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/uname.c b/coreutils/uname.c index 8a33cf3b5..aad58cab0 100644 --- a/coreutils/uname.c +++ b/coreutils/uname.c @@ -46,22 +46,22 @@ //config: bool "uname (3.7 kb)" //config: default y //config: help -//config: uname is used to print system information. +//config: uname is used to print system information. //config: //config:config UNAME_OSNAME //config: string "Operating system name" //config: default "GNU/Linux" //config: depends on UNAME //config: help -//config: Sets the operating system name reported by uname -o. The -//config: default is "GNU/Linux". +//config: Sets the operating system name reported by uname -o. The +//config: default is "GNU/Linux". //config: //can't use "ARCH" for this applet, all hell breaks loose in build system :) //config:config BB_ARCH //config: bool "arch (1.6 kb)" //config: default y //config: help -//config: Same as uname -m. +//config: Same as uname -m. //applet:IF_UNAME(APPLET(uname, BB_DIR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/coreutils/uniq.c b/coreutils/uniq.c index 3f9c56e74..f71557b67 100644 --- a/coreutils/uniq.c +++ b/coreutils/uniq.c @@ -10,7 +10,7 @@ //config: bool "uniq (4.8 kb)" //config: default y //config: help -//config: uniq is used to remove duplicate lines from a sorted file. +//config: uniq is used to remove duplicate lines from a sorted file. //applet:IF_UNIQ(APPLET(uniq, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/unlink.c b/coreutils/unlink.c index fcc86da97..3322d5b47 100644 --- a/coreutils/unlink.c +++ b/coreutils/unlink.c @@ -9,7 +9,7 @@ //config: bool "unlink (3.5 kb)" //config: default y //config: help -//config: unlink deletes a file by calling unlink() +//config: unlink deletes a file by calling unlink() //applet:IF_UNLINK(APPLET(unlink, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/usleep.c b/coreutils/usleep.c index 1675b2fc9..7c25aada1 100644 --- a/coreutils/usleep.c +++ b/coreutils/usleep.c @@ -10,7 +10,7 @@ //config: bool "usleep (1.1 kb)" //config: default y //config: help -//config: usleep is used to pause for a specified number of microseconds. +//config: usleep is used to pause for a specified number of microseconds. //applet:IF_USLEEP(APPLET_NOFORK(usleep, usleep, BB_DIR_BIN, BB_SUID_DROP, usleep)) diff --git a/coreutils/uudecode.c b/coreutils/uudecode.c index 418d0238f..4e72e86ee 100644 --- a/coreutils/uudecode.c +++ b/coreutils/uudecode.c @@ -14,7 +14,7 @@ //config: bool "uudecode (5.9 kb)" //config: default y //config: help -//config: uudecode is used to decode a uuencoded file. +//config: uudecode is used to decode a uuencoded file. //applet:IF_UUDECODE(APPLET(uudecode, BB_DIR_USR_BIN, BB_SUID_DROP)) @@ -179,7 +179,7 @@ int uudecode_main(int argc UNUSED_PARAM, char **argv) //config: bool "base64 (5 kb)" //config: default y //config: help -//config: Base64 encode and decode +//config: Base64 encode and decode //usage:#define base64_trivial_usage //usage: "[-d] [FILE]" diff --git a/coreutils/uuencode.c b/coreutils/uuencode.c index cd167aeda..7164f838a 100644 --- a/coreutils/uuencode.c +++ b/coreutils/uuencode.c @@ -11,7 +11,7 @@ //config: bool "uuencode (4.6 kb)" //config: default y //config: help -//config: uuencode is used to uuencode a file. +//config: uuencode is used to uuencode a file. //applet:IF_UUENCODE(APPLET(uuencode, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/wc.c b/coreutils/wc.c index 716119d6c..c74b7a65f 100644 --- a/coreutils/wc.c +++ b/coreutils/wc.c @@ -36,15 +36,15 @@ //config: bool "wc (4.4 kb)" //config: default y //config: help -//config: wc is used to print the number of bytes, words, and lines, -//config: in specified files. +//config: wc is used to print the number of bytes, words, and lines, +//config: in specified files. //config: //config:config FEATURE_WC_LARGE //config: bool "Support very large counts" //config: default y //config: depends on WC //config: help -//config: Use "unsigned long long" for counter variables. +//config: Use "unsigned long long" for counter variables. //applet:IF_WC(APPLET(wc, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/coreutils/who.c b/coreutils/who.c index 73167904f..91f99138c 100644 --- a/coreutils/who.c +++ b/coreutils/who.c @@ -17,26 +17,26 @@ *---------------------------------------------------------------------- */ //config:config WHO -//config: bool "who (3.7 kb)" -//config: default y -//config: depends on FEATURE_UTMP -//config: help -//config: who is used to show who is logged on. +//config: bool "who (3.7 kb)" +//config: default y +//config: depends on FEATURE_UTMP +//config: help +//config: Print users currently logged on. //config: // procps-ng has this variation of "who": //config:config W -//config: bool "w (3.7 kb)" -//config: default y -//config: depends on FEATURE_UTMP -//config: help -//config: w is used to show who is logged on. +//config: bool "w (3.7 kb)" +//config: default y +//config: depends on FEATURE_UTMP +//config: help +//config: Print users currently logged on. //config: //config:config USERS -//config: bool "users (3.2 kb)" -//config: default y -//config: depends on FEATURE_UTMP -//config: help -//config: Print users currently logged on. +//config: bool "users (3.2 kb)" +//config: default y +//config: depends on FEATURE_UTMP +//config: help +//config: Print users currently logged on. // APPLET_ODDNAME:name main location suid_type help //applet:IF_USERS(APPLET_ODDNAME(users, who, BB_DIR_USR_BIN, BB_SUID_DROP, users)) diff --git a/coreutils/whoami.c b/coreutils/whoami.c index 02a51084a..9dab15817 100644 --- a/coreutils/whoami.c +++ b/coreutils/whoami.c @@ -10,8 +10,8 @@ //config: bool "whoami (2.9 kb)" //config: default y //config: help -//config: whoami is used to print the username of the current -//config: user id (same as id -un). +//config: whoami is used to print the username of the current +//config: user id (same as id -un). //applet:IF_WHOAMI(APPLET_NOFORK(whoami, whoami, BB_DIR_USR_BIN, BB_SUID_DROP, whoami)) diff --git a/coreutils/yes.c b/coreutils/yes.c index e8edc0c0d..493b7b1c3 100644 --- a/coreutils/yes.c +++ b/coreutils/yes.c @@ -14,8 +14,8 @@ //config: bool "yes (956 bytes)" //config: default y //config: help -//config: yes is used to repeatedly output a specific string, or -//config: the default string `y'. +//config: yes is used to repeatedly output a specific string, or +//config: the default string `y'. //applet:IF_YES(APPLET_NOFORK(yes, yes, BB_DIR_USR_BIN, BB_SUID_DROP, yes)) diff --git a/debianutils/pipe_progress.c b/debianutils/pipe_progress.c index af5de2d52..e6b7601fa 100644 --- a/debianutils/pipe_progress.c +++ b/debianutils/pipe_progress.c @@ -10,7 +10,7 @@ //config: bool "pipe_progress (225 bytes)" //config: default y //config: help -//config: Display a dot to indicate pipe activity. +//config: Display a dot to indicate pipe activity. //applet:IF_PIPE_PROGRESS(APPLET(pipe_progress, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/debianutils/run_parts.c b/debianutils/run_parts.c index 011066bd4..c6a90a486 100644 --- a/debianutils/run_parts.c +++ b/debianutils/run_parts.c @@ -26,16 +26,16 @@ //config: bool "run-parts (5.6 kb)" //config: default y //config: help -//config: run-parts is a utility designed to run all the scripts in a directory. +//config: run-parts is a utility designed to run all the scripts in a directory. //config: -//config: It is useful to set up a directory like cron.daily, where you need to -//config: execute all the scripts in that directory. +//config: It is useful to set up a directory like cron.daily, where you need to +//config: execute all the scripts in that directory. //config: -//config: In this implementation of run-parts some features (such as report -//config: mode) are not implemented. +//config: In this implementation of run-parts some features (such as report +//config: mode) are not implemented. //config: -//config: Unless you know that run-parts is used in some of your scripts -//config: you can safely say N here. +//config: Unless you know that run-parts is used in some of your scripts +//config: you can safely say N here. //config: //config:config FEATURE_RUN_PARTS_LONG_OPTIONS //config: bool "Enable long options" @@ -47,9 +47,9 @@ //config: default y //config: depends on RUN_PARTS //config: help -//config: Support additional options: -//config: -l --list print the names of the all matching files (not -//config: limited to executables), but don't actually run them. +//config: Support additional options: +//config: -l --list print the names of the all matching files (not +//config: limited to executables), but don't actually run them. //applet:IF_RUN_PARTS(APPLET_ODDNAME(run-parts, run_parts, BB_DIR_BIN, BB_SUID_DROP, run_parts)) diff --git a/debianutils/start_stop_daemon.c b/debianutils/start_stop_daemon.c index 584158fe8..9d60b2c7f 100644 --- a/debianutils/start_stop_daemon.c +++ b/debianutils/start_stop_daemon.c @@ -60,9 +60,9 @@ Misc options: //config: bool "start-stop-daemon (12 kb)" //config: default y //config: help -//config: start-stop-daemon is used to control the creation and -//config: termination of system-level processes, usually the ones -//config: started during the startup of the system. +//config: start-stop-daemon is used to control the creation and +//config: termination of system-level processes, usually the ones +//config: started during the startup of the system. //config: //config:config FEATURE_START_STOP_DAEMON_LONG_OPTIONS //config: bool "Enable long options" @@ -74,9 +74,9 @@ Misc options: //config: default y //config: depends on START_STOP_DAEMON //config: help -//config: -o|--oknodo ignored since we exit with 0 anyway -//config: -v|--verbose -//config: -N|--nicelevel N +//config: -o|--oknodo ignored since we exit with 0 anyway +//config: -v|--verbose +//config: -N|--nicelevel N //applet:IF_START_STOP_DAEMON(APPLET_ODDNAME(start-stop-daemon, start_stop_daemon, BB_DIR_SBIN, BB_SUID_DROP, start_stop_daemon)) diff --git a/debianutils/which.c b/debianutils/which.c index bdf6b9b14..3197ddac1 100644 --- a/debianutils/which.c +++ b/debianutils/which.c @@ -9,8 +9,8 @@ //config: bool "which (3.7 kb)" //config: default y //config: help -//config: which is used to find programs in your PATH and -//config: print out their pathnames. +//config: which is used to find programs in your PATH and +//config: print out their pathnames. //applet:IF_WHICH(APPLET(which, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/e2fsprogs/chattr.c b/e2fsprogs/chattr.c index f84ff0d0c..72327d728 100644 --- a/e2fsprogs/chattr.c +++ b/e2fsprogs/chattr.c @@ -13,7 +13,7 @@ //config: bool "chattr (3.2 kb)" //config: default y //config: help -//config: chattr changes the file attributes on a second extended file system. +//config: chattr changes the file attributes on a second extended file system. //applet:IF_CHATTR(APPLET(chattr, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/e2fsprogs/fsck.c b/e2fsprogs/fsck.c index 8d03e0cee..1c285bb92 100644 --- a/e2fsprogs/fsck.c +++ b/e2fsprogs/fsck.c @@ -37,9 +37,9 @@ //config: bool "fsck (6.7 kb)" //config: default y //config: help -//config: fsck is used to check and optionally repair one or more filesystems. -//config: In actuality, fsck is simply a front-end for the various file system -//config: checkers (fsck.fstype) available under Linux. +//config: fsck is used to check and optionally repair one or more filesystems. +//config: In actuality, fsck is simply a front-end for the various file system +//config: checkers (fsck.fstype) available under Linux. //applet:IF_FSCK(APPLET(fsck, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/e2fsprogs/lsattr.c b/e2fsprogs/lsattr.c index f59fe93a2..756d26832 100644 --- a/e2fsprogs/lsattr.c +++ b/e2fsprogs/lsattr.c @@ -14,7 +14,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: lsattr lists the file attributes on a second extended file system. +//config: lsattr lists the file attributes on a second extended file system. //applet:IF_LSATTR(APPLET(lsattr, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/e2fsprogs/tune2fs.c b/e2fsprogs/tune2fs.c index d9fac4e42..95411db5f 100644 --- a/e2fsprogs/tune2fs.c +++ b/e2fsprogs/tune2fs.c @@ -10,8 +10,8 @@ //config: bool "tune2fs (4.4 kb)" //config: default n # off: it is too limited compared to upstream version //config: help -//config: tune2fs allows the system administrator to adjust various tunable -//config: filesystem parameters on Linux ext2/ext3 filesystems. +//config: tune2fs allows the system administrator to adjust various tunable +//config: filesystem parameters on Linux ext2/ext3 filesystems. //applet:IF_TUNE2FS(APPLET(tune2fs, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/editors/Config.src b/editors/Config.src index 8f2b265bd..0920bc494 100644 --- a/editors/Config.src +++ b/editors/Config.src @@ -12,7 +12,7 @@ config FEATURE_ALLOW_EXEC default y depends on VI || AWK help - Enables vi and awk features which allow user to execute - shell commands (using system() C call). + Enables vi and awk features which allow user to execute + shell commands (using system() C call). endmenu diff --git a/editors/awk.c b/editors/awk.c index 9d859b820..aa927db1a 100644 --- a/editors/awk.c +++ b/editors/awk.c @@ -11,27 +11,27 @@ //config: bool "awk (22 kb)" //config: default y //config: help -//config: Awk is used as a pattern scanning and processing language. This is -//config: the BusyBox implementation of that programming language. +//config: Awk is used as a pattern scanning and processing language. This is +//config: the BusyBox implementation of that programming language. //config: //config:config FEATURE_AWK_LIBM //config: bool "Enable math functions (requires libm)" //config: default y //config: depends on AWK //config: help -//config: Enable math functions of the Awk programming language. -//config: NOTE: This requires libm to be present for linking. +//config: Enable math functions of the Awk programming language. +//config: NOTE: This requires libm to be present for linking. //config: //config:config FEATURE_AWK_GNU_EXTENSIONS //config: bool "Enable a few GNU extensions" //config: default y //config: depends on AWK //config: help -//config: Enable a few features from gawk: -//config: * command line option -e AWK_PROGRAM -//config: * simultaneous use of -f and -e on the command line. -//config: This enables the use of awk library files. -//config: Ex: awk -f mylib.awk -e '{print myfunction($1);}' ... +//config: Enable a few features from gawk: +//config: * command line option -e AWK_PROGRAM +//config: * simultaneous use of -f and -e on the command line. +//config: This enables the use of awk library files. +//config: Example: awk -f mylib.awk -e '{print myfunction($1);}' ... //applet:IF_AWK(APPLET_NOEXEC(awk, awk, BB_DIR_USR_BIN, BB_SUID_DROP, awk)) diff --git a/editors/cmp.c b/editors/cmp.c index 6e5500c17..f53d9603c 100644 --- a/editors/cmp.c +++ b/editors/cmp.c @@ -14,8 +14,8 @@ //config: bool "cmp (5.4 kb)" //config: default y //config: help -//config: cmp is used to compare two files and returns the result -//config: to standard output. +//config: cmp is used to compare two files and returns the result +//config: to standard output. //kbuild:lib-$(CONFIG_CMP) += cmp.o diff --git a/editors/diff.c b/editors/diff.c index b6a5ca606..03c13908e 100644 --- a/editors/diff.c +++ b/editors/diff.c @@ -80,9 +80,9 @@ //config: bool "diff (13 kb)" //config: default y //config: help -//config: diff compares two files or directories and outputs the -//config: differences between them in a form that can be given to -//config: the patch command. +//config: diff compares two files or directories and outputs the +//config: differences between them in a form that can be given to +//config: the patch command. //config: //config:config FEATURE_DIFF_LONG_OPTIONS //config: bool "Enable long options" @@ -94,8 +94,8 @@ //config: default y //config: depends on DIFF //config: help -//config: This option enables support for directory and subdirectory -//config: comparison. +//config: This option enables support for directory and subdirectory +//config: comparison. //kbuild:lib-$(CONFIG_DIFF) += diff.o diff --git a/editors/ed.c b/editors/ed.c index 863a99366..c594d3da1 100644 --- a/editors/ed.c +++ b/editors/ed.c @@ -11,9 +11,9 @@ //config: bool "ed (25 kb)" //config: default y //config: help -//config: The original 1970's Unix text editor, from the days of teletypes. -//config: Small, simple, evil. Part of SUSv3. If you're not already using -//config: this, you don't need it. +//config: The original 1970's Unix text editor, from the days of teletypes. +//config: Small, simple, evil. Part of SUSv3. If you're not already using +//config: this, you don't need it. //kbuild:lib-$(CONFIG_ED) += ed.o diff --git a/editors/patch.c b/editors/patch.c index 86a0193a1..81316fae3 100644 --- a/editors/patch.c +++ b/editors/patch.c @@ -26,7 +26,7 @@ //config: bool "patch (9.1 kb)" //config: default y //config: help -//config: Apply a unified diff formatted patch. +//config: Apply a unified diff formatted patch. //applet:IF_PATCH(APPLET(patch, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/editors/sed.c b/editors/sed.c index c5df5d9e7..bec20040a 100644 --- a/editors/sed.c +++ b/editors/sed.c @@ -60,8 +60,8 @@ //config: bool "sed (12 kb)" //config: default y //config: help -//config: sed is used to perform text transformations on a file -//config: or input from a pipeline. +//config: sed is used to perform text transformations on a file +//config: or input from a pipeline. //kbuild:lib-$(CONFIG_SED) += sed.o diff --git a/editors/vi.c b/editors/vi.c index 015938585..116022c93 100644 --- a/editors/vi.c +++ b/editors/vi.c @@ -24,10 +24,10 @@ //config: bool "vi (22 kb)" //config: default y //config: help -//config: 'vi' is a text editor. More specifically, it is the One True -//config: text editor . It does, however, have a rather steep -//config: learning curve. If you are not already comfortable with 'vi' -//config: you may wish to use something else. +//config: 'vi' is a text editor. More specifically, it is the One True +//config: text editor . It does, however, have a rather steep +//config: learning curve. If you are not already comfortable with 'vi' +//config: you may wish to use something else. //config: //config:config FEATURE_VI_MAX_LEN //config: int "Maximum screen width" @@ -35,77 +35,77 @@ //config: default 4096 //config: depends on VI //config: help -//config: Contrary to what you may think, this is not eating much. -//config: Make it smaller than 4k only if you are very limited on memory. +//config: Contrary to what you may think, this is not eating much. +//config: Make it smaller than 4k only if you are very limited on memory. //config: //config:config FEATURE_VI_8BIT //config: bool "Allow to display 8-bit chars (otherwise shows dots)" //config: default n //config: depends on VI //config: help -//config: If your terminal can display characters with high bit set, -//config: you may want to enable this. Note: vi is not Unicode-capable. -//config: If your terminal combines several 8-bit bytes into one character -//config: (as in Unicode mode), this will not work properly. +//config: If your terminal can display characters with high bit set, +//config: you may want to enable this. Note: vi is not Unicode-capable. +//config: If your terminal combines several 8-bit bytes into one character +//config: (as in Unicode mode), this will not work properly. //config: //config:config FEATURE_VI_COLON //config: bool "Enable \":\" colon commands (no \"ex\" mode)" //config: default y //config: depends on VI //config: help -//config: Enable a limited set of colon commands. This does not -//config: provide an "ex" mode. +//config: Enable a limited set of colon commands. This does not +//config: provide an "ex" mode. //config: //config:config FEATURE_VI_YANKMARK //config: bool "Enable yank/put commands and mark cmds" //config: default y //config: depends on VI //config: help -//config: This enables you to use yank and put, as well as mark. +//config: This enables you to use yank and put, as well as mark. //config: //config:config FEATURE_VI_SEARCH //config: bool "Enable search and replace cmds" //config: default y //config: depends on VI //config: help -//config: Select this if you wish to be able to do search and replace. +//config: Select this if you wish to be able to do search and replace. //config: //config:config FEATURE_VI_REGEX_SEARCH //config: bool "Enable regex in search and replace" //config: default n # Uses GNU regex, which may be unavailable. FIXME //config: depends on FEATURE_VI_SEARCH //config: help -//config: Use extended regex search. +//config: Use extended regex search. //config: //config:config FEATURE_VI_USE_SIGNALS //config: bool "Catch signals" //config: default y //config: depends on VI //config: help -//config: Selecting this option will make vi signal aware. This will support -//config: SIGWINCH to deal with Window Changes, catch ^Z and ^C and alarms. +//config: Selecting this option will make vi signal aware. This will support +//config: SIGWINCH to deal with Window Changes, catch ^Z and ^C and alarms. //config: //config:config FEATURE_VI_DOT_CMD //config: bool "Remember previous cmd and \".\" cmd" //config: default y //config: depends on VI //config: help -//config: Make vi remember the last command and be able to repeat it. +//config: Make vi remember the last command and be able to repeat it. //config: //config:config FEATURE_VI_READONLY //config: bool "Enable -R option and \"view\" mode" //config: default y //config: depends on VI //config: help -//config: Enable the read-only command line option, which allows the user to -//config: open a file in read-only mode. +//config: Enable the read-only command line option, which allows the user to +//config: open a file in read-only mode. //config: //config:config FEATURE_VI_SETOPTS //config: bool "Enable settable options, ai ic showmatch" //config: default y //config: depends on VI //config: help -//config: Enable the editor to set some (ai, ic, showmatch) options. +//config: Enable the editor to set some (ai, ic, showmatch) options. //config: //config:config FEATURE_VI_SET //config: bool "Support :set" @@ -117,37 +117,37 @@ //config: default y //config: depends on VI //config: help -//config: Behave nicely with terminals that get resized. +//config: Behave nicely with terminals that get resized. //config: //config:config FEATURE_VI_ASK_TERMINAL //config: bool "Use 'tell me cursor position' ESC sequence to measure window" //config: default y //config: depends on VI //config: help -//config: If terminal size can't be retrieved and $LINES/$COLUMNS are not set, -//config: this option makes vi perform a last-ditch effort to find it: -//config: position cursor to 999,999 and ask terminal to report real -//config: cursor position using "ESC [ 6 n" escape sequence, then read stdin. -//config: This is not clean but helps a lot on serial lines and such. +//config: If terminal size can't be retrieved and $LINES/$COLUMNS are not set, +//config: this option makes vi perform a last-ditch effort to find it: +//config: position cursor to 999,999 and ask terminal to report real +//config: cursor position using "ESC [ 6 n" escape sequence, then read stdin. +//config: This is not clean but helps a lot on serial lines and such. //config: //config:config FEATURE_VI_UNDO //config: bool "Support undo command \"u\"" //config: default y //config: depends on VI //config: help -//config: Support the 'u' command to undo insertion, deletion, and replacement -//config: of text. +//config: Support the 'u' command to undo insertion, deletion, and replacement +//config: of text. //config: //config:config FEATURE_VI_UNDO_QUEUE //config: bool "Enable undo operation queuing" //config: default y //config: depends on FEATURE_VI_UNDO //config: help -//config: The vi undo functions can use an intermediate queue to greatly lower -//config: malloc() calls and overhead. When the maximum size of this queue is -//config: reached, the contents of the queue are committed to the undo stack. -//config: This increases the size of the undo code and allows some undo -//config: operations (especially un-typing/backspacing) to be far more useful. +//config: The vi undo functions can use an intermediate queue to greatly lower +//config: malloc() calls and overhead. When the maximum size of this queue is +//config: reached, the contents of the queue are committed to the undo stack. +//config: This increases the size of the undo code and allows some undo +//config: operations (especially un-typing/backspacing) to be far more useful. //config: //config:config FEATURE_VI_UNDO_QUEUE_MAX //config: int "Maximum undo character queue size" @@ -155,13 +155,13 @@ //config: range 32 65536 //config: depends on FEATURE_VI_UNDO_QUEUE //config: help -//config: This option sets the number of bytes used at runtime for the queue. -//config: Smaller values will create more undo objects and reduce the amount -//config: of typed or backspaced characters that are grouped into one undo -//config: operation; larger values increase the potential size of each undo -//config: and will generally malloc() larger objects and less frequently. -//config: Unless you want more (or less) frequent "undo points" while typing, -//config: you should probably leave this unchanged. +//config: This option sets the number of bytes used at runtime for the queue. +//config: Smaller values will create more undo objects and reduce the amount +//config: of typed or backspaced characters that are grouped into one undo +//config: operation; larger values increase the potential size of each undo +//config: and will generally malloc() larger objects and less frequently. +//config: Unless you want more (or less) frequent "undo points" while typing, +//config: you should probably leave this unchanged. //applet:IF_VI(APPLET(vi, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/findutils/find.c b/findutils/find.c index 70ad03208..69baf065d 100644 --- a/findutils/find.c +++ b/findutils/find.c @@ -57,33 +57,33 @@ //config: bool "find (14 kb)" //config: default y //config: help -//config: find is used to search your system to find specified files. +//config: find is used to search your system to find specified files. //config: //config:config FEATURE_FIND_PRINT0 //config: bool "Enable -print0: NUL-terminated output" //config: default y //config: depends on FIND //config: help -//config: Causes output names to be separated by a NUL character -//config: rather than a newline. This allows names that contain -//config: newlines and other whitespace to be more easily -//config: interpreted by other programs. +//config: Causes output names to be separated by a NUL character +//config: rather than a newline. This allows names that contain +//config: newlines and other whitespace to be more easily +//config: interpreted by other programs. //config: //config:config FEATURE_FIND_MTIME //config: bool "Enable -mtime: modified time matching" //config: default y //config: depends on FIND //config: help -//config: Allow searching based on the modification time of -//config: files, in days. +//config: Allow searching based on the modification time of +//config: files, in days. //config: //config:config FEATURE_FIND_MMIN //config: bool "Enable -mmin: modified time matching by minutes" //config: default y //config: depends on FIND //config: help -//config: Allow searching based on the modification time of -//config: files, in minutes. +//config: Allow searching based on the modification time of +//config: files, in minutes. //config: //config:config FEATURE_FIND_PERM //config: bool "Enable -perm: permissions matching" @@ -95,8 +95,8 @@ //config: default y //config: depends on FIND //config: help -//config: Enable searching based on file type (file, -//config: directory, socket, device, etc.). +//config: Enable searching based on file type (file, +//config: directory, socket, device, etc.). //config: //config:config FEATURE_FIND_XDEV //config: bool "Enable -xdev: 'stay in filesystem'" @@ -113,8 +113,8 @@ //config: default y //config: depends on FIND //config: help -//config: Support the 'find -newer' option for finding any files which have -//config: modification time that is more recent than the specified FILE. +//config: Support the 'find -newer' option for finding any files which have +//config: modification time that is more recent than the specified FILE. //config: //config:config FEATURE_FIND_INUM //config: bool "Enable -inum: inode number matching" @@ -126,18 +126,18 @@ //config: default y //config: depends on FIND //config: help -//config: Support the 'find -exec' option for executing commands based upon -//config: the files matched. +//config: Support the 'find -exec' option for executing commands based upon +//config: the files matched. //config: //config:config FEATURE_FIND_EXEC_PLUS //config: bool "Enable -exec ... {} +" //config: default y //config: depends on FEATURE_FIND_EXEC //config: help -//config: Support the 'find -exec ... {} +' option for executing commands -//config: for all matched files at once. -//config: Without this option, -exec + is a synonym for -exec ; -//config: (IOW: it works correctly, but without expected speedup) +//config: Support the 'find -exec ... {} +' option for executing commands +//config: for all matched files at once. +//config: Without this option, -exec + is a synonym for -exec ; +//config: (IOW: it works correctly, but without expected speedup) //config: //config:config FEATURE_FIND_USER //config: bool "Enable -user: username/uid matching" @@ -154,23 +154,23 @@ //config: default y //config: depends on FIND //config: help -//config: Support the '!' operator to invert the test results. -//config: If 'Enable full-blown desktop' is enabled, then will also support -//config: the non-POSIX notation '-not'. +//config: Support the '!' operator to invert the test results. +//config: If 'Enable full-blown desktop' is enabled, then will also support +//config: the non-POSIX notation '-not'. //config: //config:config FEATURE_FIND_DEPTH //config: bool "Enable -depth" //config: default y //config: depends on FIND //config: help -//config: Process each directory's contents before the directory itself. +//config: Process each directory's contents before the directory itself. //config: //config:config FEATURE_FIND_PAREN //config: bool "Enable parens in options" //config: default y //config: depends on FIND //config: help -//config: Enable usage of parens '(' to specify logical order of arguments. +//config: Enable usage of parens '(' to specify logical order of arguments. //config: //config:config FEATURE_FIND_SIZE //config: bool "Enable -size: file size matching" @@ -182,45 +182,45 @@ //config: default y //config: depends on FIND //config: help -//config: If the file is a directory, don't descend into it. Useful for -//config: exclusion .svn and CVS directories. +//config: If the file is a directory, don't descend into it. Useful for +//config: exclusion .svn and CVS directories. //config: //config:config FEATURE_FIND_DELETE //config: bool "Enable -delete: delete files/dirs" //config: default y //config: depends on FIND && FEATURE_FIND_DEPTH //config: help -//config: Support the 'find -delete' option for deleting files and directories. -//config: WARNING: This option can do much harm if used wrong. Busybox will not -//config: try to protect the user from doing stupid things. Use with care. +//config: Support the 'find -delete' option for deleting files and directories. +//config: WARNING: This option can do much harm if used wrong. Busybox will not +//config: try to protect the user from doing stupid things. Use with care. //config: //config:config FEATURE_FIND_PATH //config: bool "Enable -path: match pathname with shell pattern" //config: default y //config: depends on FIND //config: help -//config: The -path option matches whole pathname instead of just filename. +//config: The -path option matches whole pathname instead of just filename. //config: //config:config FEATURE_FIND_REGEX //config: bool "Enable -regex: match pathname with regex" //config: default y //config: depends on FIND //config: help -//config: The -regex option matches whole pathname against regular expression. +//config: The -regex option matches whole pathname against regular expression. //config: //config:config FEATURE_FIND_CONTEXT //config: bool "Enable -context: security context matching" //config: default n //config: depends on FIND && SELINUX //config: help -//config: Support the 'find -context' option for matching security context. +//config: Support the 'find -context' option for matching security context. //config: //config:config FEATURE_FIND_LINKS //config: bool "Enable -links: link count matching" //config: default y //config: depends on FIND //config: help -//config: Support the 'find -links' option for matching number of links. +//config: Support the 'find -links' option for matching number of links. //applet:IF_FIND(APPLET_NOEXEC(find, find, BB_DIR_USR_BIN, BB_SUID_DROP, find)) diff --git a/findutils/grep.c b/findutils/grep.c index cbbad731c..568ab12c2 100644 --- a/findutils/grep.c +++ b/findutils/grep.c @@ -22,28 +22,28 @@ //config: bool "grep (8.5 kb)" //config: default y //config: help -//config: grep is used to search files for a specified pattern. +//config: grep is used to search files for a specified pattern. //config: //config:config EGREP //config: bool "egrep (7.6 kb)" //config: default y //config: help -//config: Alias to "grep -E". +//config: Alias to "grep -E". //config: //config:config FGREP //config: bool "fgrep (7.6 kb)" //config: default y //config: help -//config: Alias to "grep -F". +//config: Alias to "grep -F". //config: //config:config FEATURE_GREP_CONTEXT //config: bool "Enable before and after context flags (-A, -B and -C)" //config: default y //config: depends on GREP || EGREP || FGREP //config: help -//config: Print the specified number of leading (-B) and/or trailing (-A) -//config: context surrounding our matching lines. -//config: Print the specified number of context lines (-C). +//config: Print the specified number of leading (-B) and/or trailing (-A) +//config: context surrounding our matching lines. +//config: Print the specified number of context lines (-C). //applet:IF_GREP(APPLET(grep, BB_DIR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/findutils/xargs.c b/findutils/xargs.c index 078ce3bc7..2d0d1c8b9 100644 --- a/findutils/xargs.c +++ b/findutils/xargs.c @@ -19,47 +19,47 @@ //config: bool "xargs (6.7 kb)" //config: default y //config: help -//config: xargs is used to execute a specified command for -//config: every item from standard input. +//config: xargs is used to execute a specified command for +//config: every item from standard input. //config: //config:config FEATURE_XARGS_SUPPORT_CONFIRMATION //config: bool "Enable -p: prompt and confirmation" //config: default y //config: depends on XARGS //config: help -//config: Support -p: prompt the user whether to run each command -//config: line and read a line from the terminal. +//config: Support -p: prompt the user whether to run each command +//config: line and read a line from the terminal. //config: //config:config FEATURE_XARGS_SUPPORT_QUOTES //config: bool "Enable single and double quotes and backslash" //config: default y //config: depends on XARGS //config: help -//config: Support quoting in the input. +//config: Support quoting in the input. //config: //config:config FEATURE_XARGS_SUPPORT_TERMOPT //config: bool "Enable -x: exit if -s or -n is exceeded" //config: default y //config: depends on XARGS //config: help -//config: Support -x: exit if the command size (see the -s or -n option) -//config: is exceeded. +//config: Support -x: exit if the command size (see the -s or -n option) +//config: is exceeded. //config: //config:config FEATURE_XARGS_SUPPORT_ZERO_TERM //config: bool "Enable -0: NUL-terminated input" //config: default y //config: depends on XARGS //config: help -//config: Support -0: input items are terminated by a NUL character -//config: instead of whitespace, and the quotes and backslash -//config: are not special. +//config: Support -0: input items are terminated by a NUL character +//config: instead of whitespace, and the quotes and backslash +//config: are not special. //config: //config:config FEATURE_XARGS_SUPPORT_REPL_STR //config: bool "Enable -I STR: string to replace" //config: default y //config: depends on XARGS //config: help -//config: Support -I STR and -i[STR] options. +//config: Support -I STR and -i[STR] options. //applet:IF_XARGS(APPLET_NOEXEC(xargs, xargs, BB_DIR_USR_BIN, BB_SUID_DROP, xargs)) diff --git a/init/bootchartd.c b/init/bootchartd.c index d7d6f1483..b5dd17439 100644 --- a/init/bootchartd.c +++ b/init/bootchartd.c @@ -11,40 +11,40 @@ //config: bool "bootchartd (10 kb)" //config: default y //config: help -//config: bootchartd is commonly used to profile the boot process -//config: for the purpose of speeding it up. In this case, it is started -//config: by the kernel as the init process. This is configured by adding -//config: the init=/sbin/bootchartd option to the kernel command line. +//config: bootchartd is commonly used to profile the boot process +//config: for the purpose of speeding it up. In this case, it is started +//config: by the kernel as the init process. This is configured by adding +//config: the init=/sbin/bootchartd option to the kernel command line. //config: -//config: It can also be used to monitor the resource usage of a specific -//config: application or the running system in general. In this case, -//config: bootchartd is started interactively by running bootchartd start -//config: and stopped using bootchartd stop. +//config: It can also be used to monitor the resource usage of a specific +//config: application or the running system in general. In this case, +//config: bootchartd is started interactively by running bootchartd start +//config: and stopped using bootchartd stop. //config: //config:config FEATURE_BOOTCHARTD_BLOATED_HEADER //config: bool "Compatible, bloated header" //config: default y //config: depends on BOOTCHARTD //config: help -//config: Create extended header file compatible with "big" bootchartd. -//config: "Big" bootchartd is a shell script and it dumps some -//config: "convenient" info int the header, such as: -//config: title = Boot chart for `hostname` (`date`) -//config: system.uname = `uname -srvm` -//config: system.release = `cat /etc/DISTRO-release` -//config: system.cpu = `grep '^model name' /proc/cpuinfo | head -1` ($cpucount) -//config: system.kernel.options = `cat /proc/cmdline` -//config: This data is not mandatory for bootchart graph generation, -//config: and is considered bloat. Nevertheless, this option -//config: makes bootchartd applet to dump a subset of it. +//config: Create extended header file compatible with "big" bootchartd. +//config: "Big" bootchartd is a shell script and it dumps some +//config: "convenient" info int the header, such as: +//config: title = Boot chart for `hostname` (`date`) +//config: system.uname = `uname -srvm` +//config: system.release = `cat /etc/DISTRO-release` +//config: system.cpu = `grep '^model name' /proc/cpuinfo | head -1` ($cpucount) +//config: system.kernel.options = `cat /proc/cmdline` +//config: This data is not mandatory for bootchart graph generation, +//config: and is considered bloat. Nevertheless, this option +//config: makes bootchartd applet to dump a subset of it. //config: //config:config FEATURE_BOOTCHARTD_CONFIG_FILE //config: bool "Support bootchartd.conf" //config: default y //config: depends on BOOTCHARTD //config: help -//config: Enable reading and parsing of $PWD/bootchartd.conf -//config: and /etc/bootchartd.conf files. +//config: Enable reading and parsing of $PWD/bootchartd.conf +//config: and /etc/bootchartd.conf files. #include "libbb.h" #include "common_bufsiz.h" diff --git a/init/halt.c b/init/halt.c index e6eb28fc9..632c6cc56 100644 --- a/init/halt.c +++ b/init/halt.c @@ -11,39 +11,39 @@ //config: bool "halt (3.7 kb)" //config: default y //config: help -//config: Stop all processes and halt the system. +//config: Stop all processes and halt the system. //config: //config:config POWEROFF //config: bool "poweroff (3.7 kb)" //config: default y //config: help -//config: Stop all processes and power off the system. +//config: Stop all processes and power off the system. //config: //config:config REBOOT //config: bool "reboot (3.7 kb)" //config: default y //config: help -//config: Stop all processes and reboot the system. +//config: Stop all processes and reboot the system. //config: //config:config FEATURE_CALL_TELINIT //config: bool "Call telinit on shutdown and reboot" //config: default y //config: depends on (HALT || POWEROFF || REBOOT) && !INIT //config: help -//config: Call an external program (normally telinit) to facilitate -//config: a switch to a proper runlevel. +//config: Call an external program (normally telinit) to facilitate +//config: a switch to a proper runlevel. //config: -//config: This option is only available if you selected halt and friends, -//config: but did not select init. +//config: This option is only available if you selected halt and friends, +//config: but did not select init. //config: //config:config TELINIT_PATH //config: string "Path to telinit executable" //config: default "/sbin/telinit" //config: depends on FEATURE_CALL_TELINIT //config: help -//config: When busybox halt and friends have to call external telinit -//config: to facilitate proper shutdown, this path is to be used when -//config: locating telinit executable. +//config: When busybox halt and friends have to call external telinit +//config: to facilitate proper shutdown, this path is to be used when +//config: locating telinit executable. //applet:IF_HALT(APPLET(halt, BB_DIR_SBIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/init/init.c b/init/init.c index 3427e1cc8..ab137a981 100644 --- a/init/init.c +++ b/init/init.c @@ -14,34 +14,34 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: init is the first program run when the system boots. +//config: init is the first program run when the system boots. //config: //config:config LINUXRC //config: bool "linuxrc: support running init from initrd (not initramfs)" //config: default y //config: select FEATURE_SYSLOG //config: help -//config: Legacy support for running init under the old-style initrd. Allows -//config: the name linuxrc to act as init, and it doesn't assume init is PID 1. +//config: Legacy support for running init under the old-style initrd. Allows +//config: the name linuxrc to act as init, and it doesn't assume init is PID 1. //config: -//config: This does not apply to initramfs, which runs /init as PID 1 and -//config: requires no special support. +//config: This does not apply to initramfs, which runs /init as PID 1 and +//config: requires no special support. //config: //config:config FEATURE_USE_INITTAB //config: bool "Support reading an inittab file" //config: default y //config: depends on INIT || LINUXRC //config: help -//config: Allow init to read an inittab file when the system boot. +//config: Allow init to read an inittab file when the system boot. //config: //config:config FEATURE_KILL_REMOVED //config: bool "Support killing processes that have been removed from inittab" //config: default n //config: depends on FEATURE_USE_INITTAB //config: help -//config: When respawn entries are removed from inittab and a SIGHUP is -//config: sent to init, this option will make init kill the processes -//config: that have been removed. +//config: When respawn entries are removed from inittab and a SIGHUP is +//config: sent to init, this option will make init kill the processes +//config: that have been removed. //config: //config:config FEATURE_KILL_DELAY //config: int "How long to wait between TERM and KILL (0 - send TERM only)" if FEATURE_KILL_REMOVED @@ -49,34 +49,34 @@ //config: default 0 //config: depends on FEATURE_KILL_REMOVED //config: help -//config: With nonzero setting, init sends TERM, forks, child waits N -//config: seconds, sends KILL and exits. Setting it too high is unwise -//config: (child will hang around for too long and could actually kill -//config: the wrong process!) +//config: With nonzero setting, init sends TERM, forks, child waits N +//config: seconds, sends KILL and exits. Setting it too high is unwise +//config: (child will hang around for too long and could actually kill +//config: the wrong process!) //config: //config:config FEATURE_INIT_SCTTY //config: bool "Run commands with leading dash with controlling tty" //config: default y //config: depends on INIT || LINUXRC //config: help -//config: If this option is enabled, init will try to give a controlling -//config: tty to any command which has leading hyphen (often it's "-/bin/sh"). -//config: More precisely, init will do "ioctl(STDIN_FILENO, TIOCSCTTY, 0)". -//config: If device attached to STDIN_FILENO can be a ctty but is not yet -//config: a ctty for other session, it will become this process' ctty. -//config: This is not the traditional init behavour, but is often what you want -//config: in an embedded system where the console is only accessed during -//config: development or for maintenance. -//config: NB: using cttyhack applet may work better. +//config: If this option is enabled, init will try to give a controlling +//config: tty to any command which has leading hyphen (often it's "-/bin/sh"). +//config: More precisely, init will do "ioctl(STDIN_FILENO, TIOCSCTTY, 0)". +//config: If device attached to STDIN_FILENO can be a ctty but is not yet +//config: a ctty for other session, it will become this process' ctty. +//config: This is not the traditional init behavour, but is often what you want +//config: in an embedded system where the console is only accessed during +//config: development or for maintenance. +//config: NB: using cttyhack applet may work better. //config: //config:config FEATURE_INIT_SYSLOG //config: bool "Enable init to write to syslog" //config: default y //config: depends on INIT || LINUXRC //config: help -//config: If selected, some init messages are sent to syslog. -//config: Otherwise, they are sent to VT #5 if linux virtual tty is detected -//config: (if not, no separate logging is done). +//config: If selected, some init messages are sent to syslog. +//config: Otherwise, they are sent to VT #5 if linux virtual tty is detected +//config: (if not, no separate logging is done). //config: //config:config FEATURE_INIT_QUIET //config: bool "Be quiet on boot (no 'init started:' message)" @@ -88,37 +88,37 @@ //config: default n # not Y because this is a debug option //config: depends on INIT || LINUXRC //config: help -//config: If this option is enabled and the file /.init_enable_core -//config: exists, then init will call setrlimit() to allow unlimited -//config: core file sizes. If this option is disabled, processes -//config: will not generate any core files. +//config: If this option is enabled and the file /.init_enable_core +//config: exists, then init will call setrlimit() to allow unlimited +//config: core file sizes. If this option is disabled, processes +//config: will not generate any core files. //config: //config:config INIT_TERMINAL_TYPE //config: string "Initial terminal type" //config: default "linux" //config: depends on INIT || LINUXRC //config: help -//config: This is the initial value set by init for the TERM environment -//config: variable. This variable is used by programs which make use of -//config: extended terminal capabilities. +//config: This is the initial value set by init for the TERM environment +//config: variable. This variable is used by programs which make use of +//config: extended terminal capabilities. //config: -//config: Note that on Linux, init attempts to detect serial terminal and -//config: sets TERM to "vt102" if one is found. +//config: Note that on Linux, init attempts to detect serial terminal and +//config: sets TERM to "vt102" if one is found. //config: //config:config FEATURE_INIT_MODIFY_CMDLINE //config: bool "Clear init's command line" //config: default y //config: depends on INIT || LINUXRC //config: help -//config: When launched as PID 1 and after parsing its arguments, init -//config: wipes all the arguments but argv[0] and rewrites argv[0] to -//config: contain only "init", so that its command line appears solely as -//config: "init" in tools such as ps. -//config: If this option is set to Y, init will keep its original behavior, -//config: otherwise, all the arguments including argv[0] will be preserved, -//config: be they parsed or ignored by init. -//config: The original command-line used to launch init can then be -//config: retrieved in /proc/1/cmdline on Linux, for example. +//config: When launched as PID 1 and after parsing its arguments, init +//config: wipes all the arguments but argv[0] and rewrites argv[0] to +//config: contain only "init", so that its command line appears solely as +//config: "init" in tools such as ps. +//config: If this option is set to Y, init will keep its original behavior, +//config: otherwise, all the arguments including argv[0] will be preserved, +//config: be they parsed or ignored by init. +//config: The original command-line used to launch init can then be +//config: retrieved in /proc/1/cmdline on Linux, for example. //applet:IF_INIT(APPLET(init, BB_DIR_SBIN, BB_SUID_DROP)) //applet:IF_LINUXRC(APPLET_ODDNAME(linuxrc, init, BB_DIR_ROOT, BB_SUID_DROP, linuxrc)) diff --git a/libbb/Config.src b/libbb/Config.src index 16c79dbf0..9da8b65ee 100644 --- a/libbb/Config.src +++ b/libbb/Config.src @@ -11,14 +11,14 @@ choice prompt "Buffer allocation policy" default FEATURE_BUFFERS_USE_MALLOC help - There are 3 ways BusyBox can handle buffer allocations: - - Use malloc. This costs code size for the call to xmalloc. - - Put them on stack. For some very small machines with limited stack - space, this can be deadly. For most folks, this works just fine. - - Put them in BSS. This works beautifully for computers with a real - MMU (and OS support), but wastes runtime RAM for uCLinux. This - behavior was the only one available for BusyBox versions 0.48 and - earlier. + There are 3 ways BusyBox can handle buffer allocations: + - Use malloc. This costs code size for the call to xmalloc. + - Put them on stack. For some very small machines with limited stack + space, this can be deadly. For most folks, this works just fine. + - Put them in BSS. This works beautifully for computers with a real + MMU (and OS support), but wastes runtime RAM for uCLinux. This + behavior was the only one available for BusyBox versions 0.48 and + earlier. config FEATURE_BUFFERS_USE_MALLOC bool "Allocate with Malloc" @@ -36,52 +36,52 @@ config PASSWORD_MINLEN default 6 range 5 32 help - Minimum allowable password length. + Minimum allowable password length. config MD5_SMALL int "MD5: Trade bytes for speed (0:fast, 3:slow)" default 1 # all "fast or small" options default to small range 0 3 help - Trade binary size versus speed for the md5sum algorithm. - Approximate values running uClibc and hashing - linux-2.4.4.tar.bz2 were: - user times (sec) text size (386) - 0 (fastest) 1.1 6144 - 1 1.4 5392 - 2 3.0 5088 - 3 (smallest) 5.1 4912 + Trade binary size versus speed for the md5sum algorithm. + Approximate values running uClibc and hashing + linux-2.4.4.tar.bz2 were: + value user times (sec) text size (386) + 0 (fastest) 1.1 6144 + 1 1.4 5392 + 2 3.0 5088 + 3 (smallest) 5.1 4912 config SHA3_SMALL int "SHA3: Trade bytes for speed (0:fast, 1:slow)" default 1 # all "fast or small" options default to small range 0 1 help - Trade binary size versus speed for the sha3sum algorithm. - SHA3_SMALL=0 compared to SHA3_SMALL=1 (approximate): - 64-bit x86: +270 bytes of code, 45% faster - 32-bit x86: +450 bytes of code, 75% faster + Trade binary size versus speed for the sha3sum algorithm. + SHA3_SMALL=0 compared to SHA3_SMALL=1 (approximate): + 64-bit x86: +270 bytes of code, 45% faster + 32-bit x86: +450 bytes of code, 75% faster config FEATURE_FAST_TOP bool "Faster /proc scanning code (+100 bytes)" default n # all "fast or small" options default to small help - This option makes top and ps ~20% faster (or 20% less CPU hungry), - but code size is slightly bigger. + This option makes top and ps ~20% faster (or 20% less CPU hungry), + but code size is slightly bigger. config FEATURE_ETC_NETWORKS bool "Support /etc/networks" default n help - Enable support for network names in /etc/networks. This is - a rarely used feature which allows you to use names - instead of IP/mask pairs in route command. + Enable support for network names in /etc/networks. This is + a rarely used feature which allows you to use names + instead of IP/mask pairs in route command. config FEATURE_EDITING bool "Command line editing" default y help - Enable line editing (mainly for shell command line). + Enable line editing (mainly for shell command line). config FEATURE_EDITING_MAX_LEN int "Maximum length of input" @@ -89,17 +89,17 @@ config FEATURE_EDITING_MAX_LEN default 1024 depends on FEATURE_EDITING help - Line editing code uses on-stack buffers for storage. - You may want to decrease this parameter if your target machine - benefits from smaller stack usage. + Line editing code uses on-stack buffers for storage. + You may want to decrease this parameter if your target machine + benefits from smaller stack usage. config FEATURE_EDITING_VI bool "vi-style line editing commands" default n depends on FEATURE_EDITING help - Enable vi-style line editing. In shells, this mode can be - turned on and off with "set -o vi" and "set +o vi". + Enable vi-style line editing. In shells, this mode can be + turned on and off with "set -o vi" and "set +o vi". config FEATURE_EDITING_HISTORY int "History size" @@ -108,29 +108,29 @@ config FEATURE_EDITING_HISTORY default 255 depends on FEATURE_EDITING help - Specify command history size (0 - disable). + Specify command history size (0 - disable). config FEATURE_EDITING_SAVEHISTORY bool "History saving" default y depends on FEATURE_EDITING help - Enable history saving in shells. + Enable history saving in shells. config FEATURE_EDITING_SAVE_ON_EXIT bool "Save history on shell exit, not after every command" default n depends on FEATURE_EDITING_SAVEHISTORY help - Save history on shell exit, not after every command. + Save history on shell exit, not after every command. config FEATURE_REVERSE_SEARCH bool "Reverse history search" default y depends on FEATURE_EDITING help - Enable readline-like Ctrl-R combination for reverse history search. - Increases code by about 0.5k. + Enable readline-like Ctrl-R combination for reverse history search. + Increases code by about 0.5k. config FEATURE_TAB_COMPLETION bool "Tab completion" @@ -147,237 +147,237 @@ config FEATURE_EDITING_FANCY_PROMPT default y depends on FEATURE_EDITING help - Setting this option allows for prompts to use things like \w and - \$ and escape codes. + Setting this option allows for prompts to use things like \w and + \$ and escape codes. config FEATURE_EDITING_ASK_TERMINAL bool "Query cursor position from terminal" default n depends on FEATURE_EDITING help - Allow usage of "ESC [ 6 n" sequence. Terminal answers back with - current cursor position. This information is used to make line - editing more robust in some cases. - If you are not sure whether your terminals respond to this code - correctly, or want to save on code size (about 400 bytes), - then do not turn this option on. + Allow usage of "ESC [ 6 n" sequence. Terminal answers back with + current cursor position. This information is used to make line + editing more robust in some cases. + If you are not sure whether your terminals respond to this code + correctly, or want to save on code size (about 400 bytes), + then do not turn this option on. config LOCALE_SUPPORT bool "Enable locale support (system needs locale for this to work)" default n help - Enable this if your system has locale support and you would like - busybox to support locale settings. + Enable this if your system has locale support and you would like + busybox to support locale settings. config UNICODE_SUPPORT bool "Support Unicode" default y help - This makes various applets aware that one byte is not - one character on screen. + This makes various applets aware that one byte is not + one character on screen. - Busybox aims to eventually work correctly with Unicode displays. - Any older encodings are not guaranteed to work. - Probably by the time when busybox will be fully Unicode-clean, - other encodings will be mainly of historic interest. + Busybox aims to eventually work correctly with Unicode displays. + Any older encodings are not guaranteed to work. + Probably by the time when busybox will be fully Unicode-clean, + other encodings will be mainly of historic interest. config UNICODE_USING_LOCALE bool "Use libc routines for Unicode (else uses internal ones)" default n depends on UNICODE_SUPPORT && LOCALE_SUPPORT help - With this option on, Unicode support is implemented using libc - routines. Otherwise, internal implementation is used. - Internal implementation is smaller. + With this option on, Unicode support is implemented using libc + routines. Otherwise, internal implementation is used. + Internal implementation is smaller. config FEATURE_CHECK_UNICODE_IN_ENV bool "Check $LC_ALL, $LC_CTYPE and $LANG environment variables" default n depends on UNICODE_SUPPORT && !UNICODE_USING_LOCALE help - With this option on, Unicode support is activated - only if locale-related variables have the value of the form - "xxxx.utf8" + With this option on, Unicode support is activated + only if locale-related variables have the value of the form + "xxxx.utf8" - Otherwise, Unicode support will be always enabled and active. + Otherwise, Unicode support will be always enabled and active. config SUBST_WCHAR int "Character code to substitute unprintable characters with" depends on UNICODE_SUPPORT default 63 help - Typical values are 63 for '?' (works with any output device), - 30 for ASCII substitute control code, - 65533 (0xfffd) for Unicode replacement character. + Typical values are 63 for '?' (works with any output device), + 30 for ASCII substitute control code, + 65533 (0xfffd) for Unicode replacement character. config LAST_SUPPORTED_WCHAR int "Range of supported Unicode characters" depends on UNICODE_SUPPORT default 767 help - Any character with Unicode value bigger than this is assumed - to be non-printable on output device. Many applets replace - such characters with substitution character. - - The idea is that many valid printable Unicode chars - nevertheless are not displayed correctly. Think about - combining charachers, double-wide hieroglyphs, obscure - characters in dozens of ancient scripts... - Many terminals, terminal emulators, xterms etc will fail - to handle them correctly. Choose the smallest value - which suits your needs. - - Typical values are: - 126 - ASCII only - 767 (0x2ff) - there are no combining chars in [0..767] range + Any character with Unicode value bigger than this is assumed + to be non-printable on output device. Many applets replace + such characters with substitution character. + + The idea is that many valid printable Unicode chars + nevertheless are not displayed correctly. Think about + combining charachers, double-wide hieroglyphs, obscure + characters in dozens of ancient scripts... + Many terminals, terminal emulators, xterms etc will fail + to handle them correctly. Choose the smallest value + which suits your needs. + + Typical values are: + 126 - ASCII only + 767 (0x2ff) - there are no combining chars in [0..767] range (the range includes Latin 1, Latin Ext. A and B), code is ~700 bytes smaller for this case. - 4351 (0x10ff) - there are no double-wide chars in [0..4351] range, + 4351 (0x10ff) - there are no double-wide chars in [0..4351] range, code is ~300 bytes smaller for this case. - 12799 (0x31ff) - nearly all non-ideographic characters are + 12799 (0x31ff) - nearly all non-ideographic characters are available in [0..12799] range, including East Asian scripts like katakana, hiragana, hangul, bopomofo... - 0 - off, any valid printable Unicode character will be printed. + 0 - off, any valid printable Unicode character will be printed. config UNICODE_COMBINING_WCHARS bool "Allow zero-width Unicode characters on output" default n depends on UNICODE_SUPPORT help - With this option off, any Unicode char with width of 0 - is substituted on output. + With this option off, any Unicode char with width of 0 + is substituted on output. config UNICODE_WIDE_WCHARS bool "Allow wide Unicode characters on output" default n depends on UNICODE_SUPPORT help - With this option off, any Unicode char with width > 1 - is substituted on output. + With this option off, any Unicode char with width > 1 + is substituted on output. config UNICODE_BIDI_SUPPORT bool "Bidirectional character-aware line input" default n depends on UNICODE_SUPPORT && !UNICODE_USING_LOCALE help - With this option on, right-to-left Unicode characters - are treated differently on input (e.g. cursor movement). + With this option on, right-to-left Unicode characters + are treated differently on input (e.g. cursor movement). config UNICODE_NEUTRAL_TABLE bool "In bidi input, support non-ASCII neutral chars too" default n depends on UNICODE_BIDI_SUPPORT help - In most cases it's enough to treat only ASCII non-letters - (i.e. punctuation, numbers and space) as characters - with neutral directionality. - With this option on, more extensive (and bigger) table - of neutral chars will be used. + In most cases it's enough to treat only ASCII non-letters + (i.e. punctuation, numbers and space) as characters + with neutral directionality. + With this option on, more extensive (and bigger) table + of neutral chars will be used. config UNICODE_PRESERVE_BROKEN bool "Make it possible to enter sequences of chars which are not Unicode" default n depends on UNICODE_SUPPORT help - With this option on, on line-editing input (such as used by shells) - invalid UTF-8 bytes are not substituted with the selected - substitution character. - For example, this means that entering 'l', 's', ' ', 0xff, [Enter] - at shell prompt will list file named 0xff (single char name - with char value 255), not file named '?'. + With this option on, on line-editing input (such as used by shells) + invalid UTF-8 bytes are not substituted with the selected + substitution character. + For example, this means that entering 'l', 's', ' ', 0xff, [Enter] + at shell prompt will list file named 0xff (single char name + with char value 255), not file named '?'. config FEATURE_NON_POSIX_CP bool "Non-POSIX, but safer, copying to special nodes" default y help - With this option, "cp file symlink" will delete symlink - and create a regular file. This does not conform to POSIX, - but prevents a symlink attack. - Similarly, "cp file device" will not send file's data - to the device. (To do that, use "cat file >device") + With this option, "cp file symlink" will delete symlink + and create a regular file. This does not conform to POSIX, + but prevents a symlink attack. + Similarly, "cp file device" will not send file's data + to the device. (To do that, use "cat file >device") config FEATURE_VERBOSE_CP_MESSAGE bool "Give more precise messages when copy fails (cp, mv etc)" default n help - Error messages with this feature enabled: + Error messages with this feature enabled: - $ cp file /does_not_exist/file - cp: cannot create '/does_not_exist/file': Path does not exist - $ cp file /vmlinuz/file - cp: cannot stat '/vmlinuz/file': Path has non-directory component + $ cp file /does_not_exist/file + cp: cannot create '/does_not_exist/file': Path does not exist + $ cp file /vmlinuz/file + cp: cannot stat '/vmlinuz/file': Path has non-directory component - If this feature is not enabled, they will be, respectively: + If this feature is not enabled, they will be, respectively: - cp: cannot create '/does_not_exist/file': No such file or directory - cp: cannot stat '/vmlinuz/file': Not a directory + cp: cannot create '/does_not_exist/file': No such file or directory + cp: cannot stat '/vmlinuz/file': Not a directory - This will cost you ~60 bytes. + This will cost you ~60 bytes. config FEATURE_USE_SENDFILE bool "Use sendfile system call" default y select PLATFORM_LINUX help - When enabled, busybox will use the kernel sendfile() function - instead of read/write loops to copy data between file descriptors - (for example, cp command does this a lot). - If sendfile() doesn't work, copying code falls back to read/write - loop. sendfile() was originally implemented for faster I/O - from files to sockets, but since Linux 2.6.33 it was extended - to work for many more file types. + When enabled, busybox will use the kernel sendfile() function + instead of read/write loops to copy data between file descriptors + (for example, cp command does this a lot). + If sendfile() doesn't work, copying code falls back to read/write + loop. sendfile() was originally implemented for faster I/O + from files to sockets, but since Linux 2.6.33 it was extended + to work for many more file types. config FEATURE_COPYBUF_KB int "Copy buffer size, in kilobytes" range 1 1024 default 4 help - Size of buffer used by cp, mv, install, wget etc. - Buffers which are 4 kb or less will be allocated on stack. - Bigger buffers will be allocated with mmap, with fallback to 4 kb - stack buffer if mmap fails. + Size of buffer used by cp, mv, install, wget etc. + Buffers which are 4 kb or less will be allocated on stack. + Bigger buffers will be allocated with mmap, with fallback to 4 kb + stack buffer if mmap fails. config FEATURE_SKIP_ROOTFS bool "Skip rootfs in mount table" default y help - Ignore rootfs entry in mount table. + Ignore rootfs entry in mount table. - In Linux, kernel has a special filesystem, rootfs, which is initially - mounted on /. It contains initramfs data, if kernel is configured - to have one. Usually, another file system is mounted over / early - in boot process, and therefore most tools which manipulate - mount table, such as df, will skip rootfs entry. + In Linux, kernel has a special filesystem, rootfs, which is initially + mounted on /. It contains initramfs data, if kernel is configured + to have one. Usually, another file system is mounted over / early + in boot process, and therefore most tools which manipulate + mount table, such as df, will skip rootfs entry. - However, some systems do not mount anything on /. - If you need to configure busybox for one of these systems, - you may find it useful to turn this option off to make df show - initramfs statistics. + However, some systems do not mount anything on /. + If you need to configure busybox for one of these systems, + you may find it useful to turn this option off to make df show + initramfs statistics. - Otherwise, choose Y. + Otherwise, choose Y. config MONOTONIC_SYSCALL bool "Use clock_gettime(CLOCK_MONOTONIC) syscall" default y select PLATFORM_LINUX help - Use clock_gettime(CLOCK_MONOTONIC) syscall for measuring - time intervals (time, ping, traceroute etc need this). - Probably requires Linux 2.6+. If not selected, gettimeofday - will be used instead (which gives wrong results if date/time - is reset). + Use clock_gettime(CLOCK_MONOTONIC) syscall for measuring + time intervals (time, ping, traceroute etc need this). + Probably requires Linux 2.6+. If not selected, gettimeofday + will be used instead (which gives wrong results if date/time + is reset). config IOCTL_HEX2STR_ERROR bool "Use ioctl names rather than hex values in error messages" default y help - Use ioctl names rather than hex values in error messages - (e.g. VT_DISALLOCATE rather than 0x5608). If disabled this - saves about 1400 bytes. + Use ioctl names rather than hex values in error messages + (e.g. VT_DISALLOCATE rather than 0x5608). If disabled this + saves about 1400 bytes. config FEATURE_HWIB bool "Support infiniband HW" default y help - Support for printing infiniband addresses in network applets. + Support for printing infiniband addresses in network applets. diff --git a/libbb/common_bufsiz.c b/libbb/common_bufsiz.c index f1124ba0e..6bc6d7bc9 100644 --- a/libbb/common_bufsiz.c +++ b/libbb/common_bufsiz.c @@ -10,35 +10,35 @@ //config: bool "Use the end of BSS page" //config: default n //config: help -//config: Attempt to reclaim a small unused part of BSS. +//config: Attempt to reclaim a small unused part of BSS. //config: -//config: Executables have the following parts: -//config: = read-only executable code and constants, also known as "text" -//config: = read-write data -//config: = non-initialized (zeroed on demand) data, also known as "bss" +//config: Executables have the following parts: +//config: = read-only executable code and constants, also known as "text" +//config: = read-write data +//config: = non-initialized (zeroed on demand) data, also known as "bss" //config: -//config: At link time, "text" is padded to a full page. At runtime, all "text" -//config: pages are mapped RO and executable. +//config: At link time, "text" is padded to a full page. At runtime, all "text" +//config: pages are mapped RO and executable. //config: -//config: "Data" starts on the next page boundary, but is not padded -//config: to a full page at the end. "Bss" starts wherever "data" ends. -//config: At runtime, "data" pages are mapped RW and they are file-backed -//config: (this includes a small portion of "bss" which may live in the last -//config: partial page of "data"). -//config: Pages which are fully in "bss" are mapped to anonymous memory. +//config: "Data" starts on the next page boundary, but is not padded +//config: to a full page at the end. "Bss" starts wherever "data" ends. +//config: At runtime, "data" pages are mapped RW and they are file-backed +//config: (this includes a small portion of "bss" which may live in the last +//config: partial page of "data"). +//config: Pages which are fully in "bss" are mapped to anonymous memory. //config: -//config: "Bss" end is usually not page-aligned. There is an unused space -//config: in the last page. Linker marks its start with the "_end" symbol. +//config: "Bss" end is usually not page-aligned. There is an unused space +//config: in the last page. Linker marks its start with the "_end" symbol. //config: -//config: This option will attempt to use that space for bb_common_bufsiz1[] -//config: array. If it fits after _end, it will be used, and COMMON_BUFSIZE -//config: will be enlarged from its guaranteed minimum size of 1 kbyte. -//config: This may require recompilation a second time, since value of _end -//config: is known only after final link. +//config: This option will attempt to use that space for bb_common_bufsiz1[] +//config: array. If it fits after _end, it will be used, and COMMON_BUFSIZE +//config: will be enlarged from its guaranteed minimum size of 1 kbyte. +//config: This may require recompilation a second time, since value of _end +//config: is known only after final link. //config: -//config: If you are getting a build error like this: -//config: appletlib.c:(.text.main+0xd): undefined reference to '_end' -//config: disable this option. +//config: If you are getting a build error like this: +//config: appletlib.c:(.text.main+0xd): undefined reference to '_end' +//config: disable this option. //kbuild:lib-y += common_bufsiz.o diff --git a/libbb/parse_config.c b/libbb/parse_config.c index 408439766..307ae2cd2 100644 --- a/libbb/parse_config.c +++ b/libbb/parse_config.c @@ -13,7 +13,7 @@ ////config: bool "Uniform config file parser debugging applet: parse" ////config: default n ////config: help -////config: Typical usage of parse API: +////config: Typical usage of parse API: ////config: char *t[3]; ////config: parser_t *p = config_open(filename); ////config: while (config_read(p, t, 3, 0, delimiters, flags)) { // 1..3 tokens diff --git a/libbb/u_signal_names.c b/libbb/u_signal_names.c index b49714f2a..bf984a44e 100644 --- a/libbb/u_signal_names.c +++ b/libbb/u_signal_names.c @@ -11,8 +11,8 @@ //config: bool "Support RTMIN[+n] and RTMAX[-n] signal names" //config: default y //config: help -//config: Support RTMIN[+n] and RTMAX[-n] signal names -//config: in kill, killall etc. This costs ~250 bytes. +//config: Support RTMIN[+n] and RTMAX[-n] signal names +//config: in kill, killall etc. This costs ~250 bytes. #include "libbb.h" diff --git a/loginutils/Config.src b/loginutils/Config.src index beb4eb855..680f42118 100644 --- a/loginutils/Config.src +++ b/loginutils/Config.src @@ -9,87 +9,87 @@ config FEATURE_SHADOWPASSWDS bool "Support shadow passwords" default y help - Build support for shadow password in /etc/shadow. This file is only - readable by root and thus the encrypted passwords are no longer - publicly readable. + Build support for shadow password in /etc/shadow. This file is only + readable by root and thus the encrypted passwords are no longer + publicly readable. config USE_BB_PWD_GRP bool "Use internal password and group functions rather than system functions" default y help - If you leave this disabled, busybox will use the system's password - and group functions. And if you are using the GNU C library - (glibc), you will then need to install the /etc/nsswitch.conf - configuration file and the required /lib/libnss_* libraries in - order for the password and group functions to work. This generally - makes your embedded system quite a bit larger. + If you leave this disabled, busybox will use the system's password + and group functions. And if you are using the GNU C library + (glibc), you will then need to install the /etc/nsswitch.conf + configuration file and the required /lib/libnss_* libraries in + order for the password and group functions to work. This generally + makes your embedded system quite a bit larger. - Enabling this option will cause busybox to directly access the - system's /etc/password, /etc/group files (and your system will be - smaller, and I will get fewer emails asking about how glibc NSS - works). When this option is enabled, you will not be able to use - PAM to access remote LDAP password servers and whatnot. And if you - want hostname resolution to work with glibc, you still need the - /lib/libnss_* libraries. + Enabling this option will cause busybox to directly access the + system's /etc/password, /etc/group files (and your system will be + smaller, and I will get fewer emails asking about how glibc NSS + works). When this option is enabled, you will not be able to use + PAM to access remote LDAP password servers and whatnot. And if you + want hostname resolution to work with glibc, you still need the + /lib/libnss_* libraries. - If you need to use glibc's nsswitch.conf mechanism - (e.g. if user/group database is NOT stored in /etc/passwd etc), - you must NOT use this option. + If you need to use glibc's nsswitch.conf mechanism + (e.g. if user/group database is NOT stored in /etc/passwd etc), + you must NOT use this option. - If you enable this option, it will add about 1.5k. + If you enable this option, it will add about 1.5k. config USE_BB_SHADOW bool "Use internal shadow password functions" default y depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS help - If you leave this disabled, busybox will use the system's shadow - password handling functions. And if you are using the GNU C library - (glibc), you will then need to install the /etc/nsswitch.conf - configuration file and the required /lib/libnss_* libraries in - order for the shadow password functions to work. This generally - makes your embedded system quite a bit larger. + If you leave this disabled, busybox will use the system's shadow + password handling functions. And if you are using the GNU C library + (glibc), you will then need to install the /etc/nsswitch.conf + configuration file and the required /lib/libnss_* libraries in + order for the shadow password functions to work. This generally + makes your embedded system quite a bit larger. - Enabling this option will cause busybox to directly access the - system's /etc/shadow file when handling shadow passwords. This - makes your system smaller (and I will get fewer emails asking about - how glibc NSS works). When this option is enabled, you will not be - able to use PAM to access shadow passwords from remote LDAP - password servers and whatnot. + Enabling this option will cause busybox to directly access the + system's /etc/shadow file when handling shadow passwords. This + makes your system smaller (and I will get fewer emails asking about + how glibc NSS works). When this option is enabled, you will not be + able to use PAM to access shadow passwords from remote LDAP + password servers and whatnot. config USE_BB_CRYPT bool "Use internal crypt functions" default y help - Busybox has internal DES and MD5 crypt functions. - They produce results which are identical to corresponding - standard C library functions. + Busybox has internal DES and MD5 crypt functions. + They produce results which are identical to corresponding + standard C library functions. - If you leave this disabled, busybox will use the system's - crypt functions. Most C libraries use large (~70k) - static buffers there, and also combine them with more general - DES encryption/decryption. + If you leave this disabled, busybox will use the system's + crypt functions. Most C libraries use large (~70k) + static buffers there, and also combine them with more general + DES encryption/decryption. - For busybox, having large static buffers is undesirable, - especially on NOMMU machines. Busybox also doesn't need - DES encryption/decryption and can do with smaller code. + For busybox, having large static buffers is undesirable, + especially on NOMMU machines. Busybox also doesn't need + DES encryption/decryption and can do with smaller code. - If you enable this option, it will add about 4.8k of code - if you are building dynamically linked executable. - In static build, it makes code _smaller_ by about 1.2k, - and likely many kilobytes less of bss. + If you enable this option, it will add about 4.8k of code + if you are building dynamically linked executable. + In static build, it makes code _smaller_ by about 1.2k, + and likely many kilobytes less of bss. config USE_BB_CRYPT_SHA bool "Enable SHA256/512 crypt functions" default y depends on USE_BB_CRYPT help - Enable this if you have passwords starting with "$5$" or "$6$" - in your /etc/passwd or /etc/shadow files. These passwords - are hashed using SHA256 and SHA512 algorithms. Support for them - was added to glibc in 2008. - With this option off, login will fail password check for any - user which has password encrypted with these algorithms. + Enable this if you have passwords starting with "$5$" or "$6$" + in your /etc/passwd or /etc/shadow files. These passwords + are hashed using SHA256 and SHA512 algorithms. Support for them + was added to glibc in 2008. + With this option off, login will fail password check for any + user which has password encrypted with these algorithms. INSERT diff --git a/loginutils/add-remove-shell.c b/loginutils/add-remove-shell.c index eb16c6ead..750b44bd6 100644 --- a/loginutils/add-remove-shell.c +++ b/loginutils/add-remove-shell.c @@ -8,16 +8,16 @@ * for details. */ //config:config ADD_SHELL -//config: bool "add-shell (2.8 kb)" -//config: default y if DESKTOP -//config: help -//config: Add shells to /etc/shells. +//config: bool "add-shell (2.8 kb)" +//config: default y if DESKTOP +//config: help +//config: Add shells to /etc/shells. //config: //config:config REMOVE_SHELL -//config: bool "remove-shell (2.7 kb)" -//config: default y if DESKTOP -//config: help -//config: Remove shells from /etc/shells. +//config: bool "remove-shell (2.7 kb)" +//config: default y if DESKTOP +//config: help +//config: Remove shells from /etc/shells. // APPLET_ODDNAME:name main location suid_type help //applet:IF_ADD_SHELL( APPLET_ODDNAME(add-shell , add_remove_shell, BB_DIR_USR_SBIN, BB_SUID_DROP, add_shell )) diff --git a/loginutils/addgroup.c b/loginutils/addgroup.c index c02ff10e9..b197fc149 100644 --- a/loginutils/addgroup.c +++ b/loginutils/addgroup.c @@ -13,7 +13,7 @@ //config: bool "addgroup (8.2 kb)" //config: default y //config: help -//config: Utility for creating a new group account. +//config: Utility for creating a new group account. //config: //config:config FEATURE_ADDGROUP_LONG_OPTIONS //config: bool "Enable long options" @@ -25,9 +25,9 @@ //config: default y //config: depends on ADDGROUP //config: help -//config: If called with two non-option arguments, -//config: addgroup will add an existing user to an -//config: existing group. +//config: If called with two non-option arguments, +//config: addgroup will add an existing user to an +//config: existing group. //applet:IF_ADDGROUP(APPLET(addgroup, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/loginutils/adduser.c b/loginutils/adduser.c index e2818f852..ef18278ac 100644 --- a/loginutils/adduser.c +++ b/loginutils/adduser.c @@ -11,7 +11,7 @@ //config: bool "adduser (15 kb)" //config: default y //config: help -//config: Utility for creating a new user account. +//config: Utility for creating a new user account. //config: //config:config FEATURE_ADDUSER_LONG_OPTIONS //config: bool "Enable long options" @@ -23,19 +23,19 @@ //config: default n //config: depends on ADDUSER || ADDGROUP //config: help -//config: Enable sanity check on user and group names in adduser and addgroup. -//config: To avoid problems, the user or group name should consist only of -//config: letters, digits, underscores, periods, at signs and dashes, -//config: and not start with a dash (as defined by IEEE Std 1003.1-2001). -//config: For compatibility with Samba machine accounts "$" is also supported -//config: at the end of the user or group name. +//config: Enable sanity check on user and group names in adduser and addgroup. +//config: To avoid problems, the user or group name should consist only of +//config: letters, digits, underscores, periods, at signs and dashes, +//config: and not start with a dash (as defined by IEEE Std 1003.1-2001). +//config: For compatibility with Samba machine accounts "$" is also supported +//config: at the end of the user or group name. //config: //config:config LAST_ID //config: int "Last valid uid or gid for adduser and addgroup" //config: depends on ADDUSER || ADDGROUP //config: default 60000 //config: help -//config: Last valid uid or gid for adduser and addgroup +//config: Last valid uid or gid for adduser and addgroup //config: //config:config FIRST_SYSTEM_ID //config: int "First valid system uid or gid for adduser and addgroup" @@ -43,7 +43,7 @@ //config: range 0 LAST_ID //config: default 100 //config: help -//config: First valid system uid or gid for adduser and addgroup +//config: First valid system uid or gid for adduser and addgroup //config: //config:config LAST_SYSTEM_ID //config: int "Last valid system uid or gid for adduser and addgroup" @@ -51,7 +51,7 @@ //config: range FIRST_SYSTEM_ID LAST_ID //config: default 999 //config: help -//config: Last valid system uid or gid for adduser and addgroup +//config: Last valid system uid or gid for adduser and addgroup //applet:IF_ADDUSER(APPLET(adduser, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/loginutils/chpasswd.c b/loginutils/chpasswd.c index 60f54ab01..e390da647 100644 --- a/loginutils/chpasswd.c +++ b/loginutils/chpasswd.c @@ -9,15 +9,15 @@ //config: bool "chpasswd (18 kb)" //config: default y //config: help -//config: Reads a file of user name and password pairs from standard input -//config: and uses this information to update a group of existing users. +//config: Reads a file of user name and password pairs from standard input +//config: and uses this information to update a group of existing users. //config: //config:config FEATURE_DEFAULT_PASSWD_ALGO //config: string "Default encryption method (passwd -a, cryptpw -m, chpasswd -c ALG)" //config: default "des" //config: depends on PASSWD || CRYPTPW || CHPASSWD //config: help -//config: Possible choices are "d[es]", "m[d5]", "s[ha256]" or "sha512". +//config: Possible choices are "d[es]", "m[d5]", "s[ha256]" or "sha512". //applet:IF_CHPASSWD(APPLET(chpasswd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/loginutils/cryptpw.c b/loginutils/cryptpw.c index 75769c813..f8906c59a 100644 --- a/loginutils/cryptpw.c +++ b/loginutils/cryptpw.c @@ -13,16 +13,16 @@ //config: bool "cryptpw (14 kb)" //config: default y //config: help -//config: Encrypts the given password with the crypt(3) libc function -//config: using the given salt. +//config: Encrypts the given password with the crypt(3) libc function +//config: using the given salt. //config: //config:config MKPASSWD //config: bool "mkpasswd (15 kb)" //config: default y //config: help -//config: Encrypts the given password with the crypt(3) libc function -//config: using the given salt. Debian has this utility under mkpasswd -//config: name. Busybox provides mkpasswd as an alias for cryptpw. +//config: Encrypts the given password with the crypt(3) libc function +//config: using the given salt. Debian has this utility under mkpasswd +//config: name. Busybox provides mkpasswd as an alias for cryptpw. //applet:IF_CRYPTPW(APPLET(cryptpw, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/loginutils/deluser.c b/loginutils/deluser.c index 5b05faf3a..3b6bd952d 100644 --- a/loginutils/deluser.c +++ b/loginutils/deluser.c @@ -12,21 +12,21 @@ //config: bool "deluser (8.4 kb)" //config: default y //config: help -//config: Utility for deleting a user account. +//config: Utility for deleting a user account. //config: //config:config DELGROUP //config: bool "delgroup (5.6 kb)" //config: default y //config: help -//config: Utility for deleting a group account. +//config: Utility for deleting a group account. //config: //config:config FEATURE_DEL_USER_FROM_GROUP //config: bool "Support removing users from groups" //config: default y //config: depends on DELGROUP //config: help -//config: If called with two non-option arguments, deluser -//config: or delgroup will remove an user from a specified group. +//config: If called with two non-option arguments, deluser +//config: or delgroup will remove an user from a specified group. //applet:IF_DELUSER(APPLET(deluser, BB_DIR_USR_SBIN, BB_SUID_DROP)) //applet:IF_DELGROUP(APPLET_ODDNAME(delgroup, deluser, BB_DIR_USR_SBIN, BB_SUID_DROP, delgroup)) diff --git a/loginutils/getty.c b/loginutils/getty.c index d38471a42..fd5116d08 100644 --- a/loginutils/getty.c +++ b/loginutils/getty.c @@ -26,19 +26,19 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: getty lets you log in on a tty. It is normally invoked by init. +//config: getty lets you log in on a tty. It is normally invoked by init. //config: -//config: Note that you can save a few bytes by disabling it and -//config: using login applet directly. -//config: If you need to reset tty attributes before calling login, -//config: this script approximates getty: +//config: Note that you can save a few bytes by disabling it and +//config: using login applet directly. +//config: If you need to reset tty attributes before calling login, +//config: this script approximates getty: //config: -//config: exec /dev/$1 2>&1 || exit 1 -//config: reset -//config: stty sane; stty ispeed 38400; stty ospeed 38400 -//config: printf "%s login: " "`hostname`" -//config: read -r login -//config: exec /bin/login "$login" +//config: exec /dev/$1 2>&1 || exit 1 +//config: reset +//config: stty sane; stty ispeed 38400; stty ospeed 38400 +//config: printf "%s login: " "`hostname`" +//config: read -r login +//config: exec /bin/login "$login" //applet:IF_GETTY(APPLET(getty, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/loginutils/login.c b/loginutils/login.c index fbdfd2925..39f703f07 100644 --- a/loginutils/login.c +++ b/loginutils/login.c @@ -7,46 +7,46 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: login is used when signing onto a system. +//config: login is used when signing onto a system. //config: -//config: Note that Busybox binary must be setuid root for this applet to -//config: work properly. +//config: Note that Busybox binary must be setuid root for this applet to +//config: work properly. //config: //config:config LOGIN_SESSION_AS_CHILD //config: bool "Run logged in session in a child process" //config: default y if PAM //config: depends on LOGIN //config: help -//config: Run the logged in session in a child process. This allows -//config: login to clean up things such as utmp entries or PAM sessions -//config: when the login session is complete. If you use PAM, you -//config: almost always would want this to be set to Y, else PAM session -//config: will not be cleaned up. +//config: Run the logged in session in a child process. This allows +//config: login to clean up things such as utmp entries or PAM sessions +//config: when the login session is complete. If you use PAM, you +//config: almost always would want this to be set to Y, else PAM session +//config: will not be cleaned up. //config: //config:config LOGIN_SCRIPTS //config: bool "Support login scripts" //config: depends on LOGIN //config: default y //config: help -//config: Enable this if you want login to execute $LOGIN_PRE_SUID_SCRIPT -//config: just prior to switching from root to logged-in user. +//config: Enable this if you want login to execute $LOGIN_PRE_SUID_SCRIPT +//config: just prior to switching from root to logged-in user. //config: //config:config FEATURE_NOLOGIN //config: bool "Support /etc/nologin" //config: default y //config: depends on LOGIN //config: help -//config: The file /etc/nologin is used by (some versions of) login(1). -//config: If it exists, non-root logins are prohibited. +//config: The file /etc/nologin is used by (some versions of) login(1). +//config: If it exists, non-root logins are prohibited. //config: //config:config FEATURE_SECURETTY //config: bool "Support /etc/securetty" //config: default y //config: depends on LOGIN //config: help -//config: The file /etc/securetty is used by (some versions of) login(1). -//config: The file contains the device names of tty lines (one per line, -//config: without leading /dev/) on which root is allowed to login. +//config: The file /etc/securetty is used by (some versions of) login(1). +//config: The file contains the device names of tty lines (one per line, +//config: without leading /dev/) on which root is allowed to login. //applet:/* Needs to be run by root or be suid root - needs to change uid and gid: */ //applet:IF_LOGIN(APPLET(login, BB_DIR_BIN, BB_SUID_REQUIRE)) diff --git a/loginutils/passwd.c b/loginutils/passwd.c index ea8f07474..03f8ad0a4 100644 --- a/loginutils/passwd.c +++ b/loginutils/passwd.c @@ -7,20 +7,20 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: passwd changes passwords for user and group accounts. A normal user -//config: may only change the password for his/her own account, the super user -//config: may change the password for any account. The administrator of a group -//config: may change the password for the group. +//config: passwd changes passwords for user and group accounts. A normal user +//config: may only change the password for his/her own account, the super user +//config: may change the password for any account. The administrator of a group +//config: may change the password for the group. //config: -//config: Note that Busybox binary must be setuid root for this applet to -//config: work properly. +//config: Note that Busybox binary must be setuid root for this applet to +//config: work properly. //config: //config:config FEATURE_PASSWD_WEAK_CHECK //config: bool "Check new passwords for weakness" //config: default y //config: depends on PASSWD //config: help -//config: With this option passwd will refuse new passwords which are "weak". +//config: With this option passwd will refuse new passwords which are "weak". //applet:/* Needs to be run by root or be suid root - needs to change /etc/{passwd,shadow}: */ //applet:IF_PASSWD(APPLET(passwd, BB_DIR_USR_BIN, BB_SUID_REQUIRE)) diff --git a/loginutils/su.c b/loginutils/su.c index b70696fe7..41291ea8f 100644 --- a/loginutils/su.c +++ b/loginutils/su.c @@ -9,10 +9,10 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: su is used to become another user during a login session. -//config: Invoked without a username, su defaults to becoming the super user. -//config: Note that busybox binary must be setuid root for this applet to -//config: work properly. +//config: su is used to become another user during a login session. +//config: Invoked without a username, su defaults to becoming the super user. +//config: Note that busybox binary must be setuid root for this applet to +//config: work properly. //config: //config:config FEATURE_SU_SYSLOG //config: bool "Log to syslog all attempts to use su" diff --git a/loginutils/sulogin.c b/loginutils/sulogin.c index cdc2c8c5a..d5a463cac 100644 --- a/loginutils/sulogin.c +++ b/loginutils/sulogin.c @@ -9,8 +9,8 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: sulogin is invoked when the system goes into single user -//config: mode (this is done through an entry in inittab). +//config: sulogin is invoked when the system goes into single user +//config: mode (this is done through an entry in inittab). //applet:IF_SULOGIN(APPLET(sulogin, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/loginutils/vlock.c b/loginutils/vlock.c index e3b701d53..f22abd3aa 100644 --- a/loginutils/vlock.c +++ b/loginutils/vlock.c @@ -19,10 +19,10 @@ //config: bool "vlock (17 kb)" //config: default y //config: help -//config: Build the "vlock" applet which allows you to lock (virtual) terminals. +//config: Build the "vlock" applet which allows you to lock (virtual) terminals. //config: -//config: Note that Busybox binary must be setuid root for this applet to -//config: work properly. +//config: Note that Busybox binary must be setuid root for this applet to +//config: work properly. //applet:/* Needs to be run by root or be suid root - needs to change uid and gid: */ //applet:IF_VLOCK(APPLET(vlock, BB_DIR_USR_BIN, BB_SUID_REQUIRE)) diff --git a/mailutils/Config.src b/mailutils/Config.src index e45a0f8fb..6d47163e4 100644 --- a/mailutils/Config.src +++ b/mailutils/Config.src @@ -7,6 +7,6 @@ config FEATURE_MIME_CHARSET default "us-ascii" depends on MAKEMIME || REFORMIME || SENDMAIL help - Default charset of the message. + Default charset of the message. endmenu diff --git a/mailutils/makemime.c b/mailutils/makemime.c index 9c79133b6..577bcde39 100644 --- a/mailutils/makemime.c +++ b/mailutils/makemime.c @@ -10,7 +10,7 @@ //config: bool "makemime (5.9 kb)" //config: default y //config: help -//config: Create MIME-formatted messages. +//config: Create MIME-formatted messages. //applet:IF_MAKEMIME(APPLET(makemime, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/mailutils/popmaildir.c b/mailutils/popmaildir.c index ad9a04a89..1695a9bb8 100644 --- a/mailutils/popmaildir.c +++ b/mailutils/popmaildir.c @@ -13,18 +13,18 @@ //config: bool "popmaildir (10 kb)" //config: default y //config: help -//config: Simple yet powerful POP3 mail popper. Delivers content -//config: of remote mailboxes to local Maildir. +//config: Simple yet powerful POP3 mail popper. Delivers content +//config: of remote mailboxes to local Maildir. //config: //config:config FEATURE_POPMAILDIR_DELIVERY //config: bool "Allow message filters and custom delivery program" //config: default y //config: depends on POPMAILDIR //config: help -//config: Allow to use a custom program to filter the content -//config: of the message before actual delivery (-F "prog [args...]"). -//config: Allow to use a custom program for message actual delivery -//config: (-M "prog [args...]"). +//config: Allow to use a custom program to filter the content +//config: of the message before actual delivery (-F "prog [args...]"). +//config: Allow to use a custom program for message actual delivery +//config: (-M "prog [args...]"). //applet:IF_POPMAILDIR(APPLET(popmaildir, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/mailutils/reformime.c b/mailutils/reformime.c index 4f29f68e8..6a0254803 100644 --- a/mailutils/reformime.c +++ b/mailutils/reformime.c @@ -10,15 +10,15 @@ //config: bool "reformime (7.5 kb)" //config: default y //config: help -//config: Parse MIME-formatted messages. +//config: Parse MIME-formatted messages. //config: //config:config FEATURE_REFORMIME_COMPAT //config: bool "Accept and ignore options other than -x and -X" //config: default y //config: depends on REFORMIME //config: help -//config: Accept (for compatibility only) and ignore options -//config: other than -x and -X. +//config: Accept (for compatibility only) and ignore options +//config: other than -x and -X. //applet:IF_REFORMIME(APPLET(reformime, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/mailutils/sendmail.c b/mailutils/sendmail.c index c70d06263..346de2712 100644 --- a/mailutils/sendmail.c +++ b/mailutils/sendmail.c @@ -10,7 +10,7 @@ //config: bool "sendmail (14 kb)" //config: default y //config: help -//config: Barebones sendmail. +//config: Barebones sendmail. //applet:IF_SENDMAIL(APPLET(sendmail, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/adjtimex.c b/miscutils/adjtimex.c index c91527ffb..04ba5636f 100644 --- a/miscutils/adjtimex.c +++ b/miscutils/adjtimex.c @@ -15,8 +15,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Adjtimex reads and optionally sets adjustment parameters for -//config: the Linux clock adjustment algorithm. +//config: Adjtimex reads and optionally sets adjustment parameters for +//config: the Linux clock adjustment algorithm. //applet:IF_ADJTIMEX(APPLET(adjtimex, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/bbconfig.c b/miscutils/bbconfig.c index faaacad18..045aca211 100644 --- a/miscutils/bbconfig.c +++ b/miscutils/bbconfig.c @@ -5,22 +5,22 @@ //config: bool "bbconfig (9.7 kb)" //config: default n //config: help -//config: The bbconfig applet will print the config file with which -//config: busybox was built. +//config: The bbconfig applet will print the config file with which +//config: busybox was built. //config: //config:config FEATURE_COMPRESS_BBCONFIG //config: bool "Compress bbconfig data" //config: default y //config: depends on BBCONFIG //config: help -//config: Store bbconfig data in compressed form, uncompress them on-the-fly -//config: before output. +//config: Store bbconfig data in compressed form, uncompress them on-the-fly +//config: before output. //config: -//config: If you have a really tiny busybox with few applets enabled (and -//config: bunzip2 isn't one of them), the overhead of the decompressor might -//config: be noticeable. Also, if you run executables directly from ROM -//config: and have very little memory, this might not be a win. Otherwise, -//config: you probably want this. +//config: If you have a really tiny busybox with few applets enabled (and +//config: bunzip2 isn't one of them), the overhead of the decompressor might +//config: be noticeable. Also, if you run executables directly from ROM +//config: and have very little memory, this might not be a win. Otherwise, +//config: you probably want this. //applet:IF_BBCONFIG(APPLET(bbconfig, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/miscutils/beep.c b/miscutils/beep.c index 782656fc5..b9b62f79b 100644 --- a/miscutils/beep.c +++ b/miscutils/beep.c @@ -12,7 +12,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The beep applets beeps in a given freq/Hz. +//config: The beep applets beeps in a given freq/Hz. //config: //config:config FEATURE_BEEP_FREQ //config: int "default frequency" @@ -20,7 +20,7 @@ //config: default 4000 //config: depends on BEEP //config: help -//config: Frequency for default beep. +//config: Frequency for default beep. //config: //config:config FEATURE_BEEP_LENGTH_MS //config: int "default length" @@ -28,7 +28,7 @@ //config: default 30 //config: depends on BEEP //config: help -//config: Length in ms for default beep. +//config: Length in ms for default beep. //applet:IF_BEEP(APPLET(beep, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/chat.c b/miscutils/chat.c index a1dc753bb..216a899a0 100644 --- a/miscutils/chat.c +++ b/miscutils/chat.c @@ -11,68 +11,68 @@ //config: bool "chat (6.6 kb)" //config: default y //config: help -//config: Simple chat utility. +//config: Simple chat utility. //config: //config:config FEATURE_CHAT_NOFAIL //config: bool "Enable NOFAIL expect strings" //config: depends on CHAT //config: default y //config: help -//config: When enabled expect strings which are started with a dash trigger -//config: no-fail mode. That is when expectation is not met within timeout -//config: the script is not terminated but sends next SEND string and waits -//config: for next EXPECT string. This allows to compose far more flexible -//config: scripts. +//config: When enabled expect strings which are started with a dash trigger +//config: no-fail mode. That is when expectation is not met within timeout +//config: the script is not terminated but sends next SEND string and waits +//config: for next EXPECT string. This allows to compose far more flexible +//config: scripts. //config: //config:config FEATURE_CHAT_TTY_HIFI //config: bool "Force STDIN to be a TTY" //config: depends on CHAT //config: default n //config: help -//config: Original chat always treats STDIN as a TTY device and sets for it -//config: so-called raw mode. This option turns on such behaviour. +//config: Original chat always treats STDIN as a TTY device and sets for it +//config: so-called raw mode. This option turns on such behaviour. //config: //config:config FEATURE_CHAT_IMPLICIT_CR //config: bool "Enable implicit Carriage Return" //config: depends on CHAT //config: default y //config: help -//config: When enabled make chat to terminate all SEND strings with a "\r" -//config: unless "\c" is met anywhere in the string. +//config: When enabled make chat to terminate all SEND strings with a "\r" +//config: unless "\c" is met anywhere in the string. //config: //config:config FEATURE_CHAT_SWALLOW_OPTS //config: bool "Swallow options" //config: depends on CHAT //config: default y //config: help -//config: Busybox chat require no options. To make it not fail when used -//config: in place of original chat (which has a bunch of options) turn -//config: this on. +//config: Busybox chat require no options. To make it not fail when used +//config: in place of original chat (which has a bunch of options) turn +//config: this on. //config: //config:config FEATURE_CHAT_SEND_ESCAPES //config: bool "Support weird SEND escapes" //config: depends on CHAT //config: default y //config: help -//config: Original chat uses some escape sequences in SEND arguments which -//config: are not sent to device but rather performs special actions. -//config: E.g. "\K" means to send a break sequence to device. -//config: "\d" delays execution for a second, "\p" -- for a 1/100 of second. -//config: Before turning this option on think twice: do you really need them? +//config: Original chat uses some escape sequences in SEND arguments which +//config: are not sent to device but rather performs special actions. +//config: E.g. "\K" means to send a break sequence to device. +//config: "\d" delays execution for a second, "\p" -- for a 1/100 of second. +//config: Before turning this option on think twice: do you really need them? //config: //config:config FEATURE_CHAT_VAR_ABORT_LEN //config: bool "Support variable-length ABORT conditions" //config: depends on CHAT //config: default y //config: help -//config: Original chat uses fixed 50-bytes length ABORT conditions. Say N here. +//config: Original chat uses fixed 50-bytes length ABORT conditions. Say N here. //config: //config:config FEATURE_CHAT_CLR_ABORT //config: bool "Support revoking of ABORT conditions" //config: depends on CHAT //config: default y //config: help -//config: Support CLR_ABORT directive. +//config: Support CLR_ABORT directive. //applet:IF_CHAT(APPLET(chat, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/conspy.c b/miscutils/conspy.c index 22a6918e1..47b9e7207 100644 --- a/miscutils/conspy.c +++ b/miscutils/conspy.c @@ -14,10 +14,10 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: A text-mode VNC like program for Linux virtual terminals. -//config: example: conspy NUM shared access to console num -//config: or conspy -nd NUM screenshot of console num -//config: or conspy -cs NUM poor man's GNU screen like +//config: A text-mode VNC like program for Linux virtual terminals. +//config: example: conspy NUM shared access to console num +//config: or conspy -nd NUM screenshot of console num +//config: or conspy -cs NUM poor man's GNU screen like //applet:IF_CONSPY(APPLET(conspy, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/miscutils/crond.c b/miscutils/crond.c index 8d24f294c..6c54e1a8f 100644 --- a/miscutils/crond.c +++ b/miscutils/crond.c @@ -13,50 +13,50 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: Crond is a background daemon that parses individual crontab -//config: files and executes commands on behalf of the users in question. -//config: This is a port of dcron from slackware. It uses files of the -//config: format /var/spool/cron/crontabs/ files, for example: -//config: $ cat /var/spool/cron/crontabs/root -//config: # Run daily cron jobs at 4:40 every day: -//config: 40 4 * * * /etc/cron/daily > /dev/null 2>&1 +//config: Crond is a background daemon that parses individual crontab +//config: files and executes commands on behalf of the users in question. +//config: This is a port of dcron from slackware. It uses files of the +//config: format /var/spool/cron/crontabs/ files, for example: +//config: $ cat /var/spool/cron/crontabs/root +//config: # Run daily cron jobs at 4:40 every day: +//config: 40 4 * * * /etc/cron/daily > /dev/null 2>&1 //config: //config:config FEATURE_CROND_D //config: bool "Support option -d to redirect output to stderr" //config: depends on CROND //config: default y //config: help -//config: -d N sets loglevel (0:most verbose) and directs all output to stderr. +//config: -d N sets loglevel (0:most verbose) and directs all output to stderr. //config: //config:config FEATURE_CROND_CALL_SENDMAIL //config: bool "Report command output via email (using sendmail)" //config: default y //config: depends on CROND //config: help -//config: Command output will be sent to corresponding user via email. +//config: Command output will be sent to corresponding user via email. //config: //config:config FEATURE_CROND_SPECIAL_TIMES //config: bool "Support special times (@reboot, @daily, etc) in crontabs" //config: default y //config: depends on CROND //config: help -//config: string meaning -//config: ------ ------- -//config: @reboot Run once, at startup -//config: @yearly Run once a year: "0 0 1 1 *" -//config: @annually Same as @yearly: "0 0 1 1 *" -//config: @monthly Run once a month: "0 0 1 * *" -//config: @weekly Run once a week: "0 0 * * 0" -//config: @daily Run once a day: "0 0 * * *" -//config: @midnight Same as @daily: "0 0 * * *" -//config: @hourly Run once an hour: "0 * * * *" +//config: string meaning +//config: ------ ------- +//config: @reboot Run once, at startup +//config: @yearly Run once a year: "0 0 1 1 *" +//config: @annually Same as @yearly: "0 0 1 1 *" +//config: @monthly Run once a month: "0 0 1 * *" +//config: @weekly Run once a week: "0 0 * * 0" +//config: @daily Run once a day: "0 0 * * *" +//config: @midnight Same as @daily: "0 0 * * *" +//config: @hourly Run once an hour: "0 * * * *" //config: //config:config FEATURE_CROND_DIR //config: string "crond spool directory" //config: default "/var/spool/cron" //config: depends on CROND || CRONTAB //config: help -//config: Location of crond spool. +//config: Location of crond spool. //applet:IF_CROND(APPLET(crond, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/crontab.c b/miscutils/crontab.c index 409307567..23cb54887 100644 --- a/miscutils/crontab.c +++ b/miscutils/crontab.c @@ -13,10 +13,10 @@ //config: bool "crontab (9.7 kb)" //config: default y //config: help -//config: Crontab manipulates the crontab for a particular user. Only -//config: the superuser may specify a different user and/or crontab directory. -//config: Note that Busybox binary must be setuid root for this applet to -//config: work properly. +//config: Crontab manipulates the crontab for a particular user. Only +//config: the superuser may specify a different user and/or crontab directory. +//config: Note that Busybox binary must be setuid root for this applet to +//config: work properly. /* Needs to be run by root or be suid root - needs to change /var/spool/cron* files: */ //applet:IF_CRONTAB(APPLET(crontab, BB_DIR_USR_BIN, BB_SUID_REQUIRE)) diff --git a/miscutils/dc.c b/miscutils/dc.c index d4cd49998..b922a7184 100644 --- a/miscutils/dc.c +++ b/miscutils/dc.c @@ -6,16 +6,16 @@ //config: bool "dc (4.2 kb)" //config: default y //config: help -//config: Dc is a reverse-polish desk calculator which supports unlimited -//config: precision arithmetic. +//config: Dc is a reverse-polish desk calculator which supports unlimited +//config: precision arithmetic. //config: //config:config FEATURE_DC_LIBM //config: bool "Enable power and exp functions (requires libm)" //config: default y //config: depends on DC //config: help -//config: Enable power and exp functions. -//config: NOTE: This will require libm to be present for linking. +//config: Enable power and exp functions. +//config: NOTE: This will require libm to be present for linking. //applet:IF_DC(APPLET(dc, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/devfsd.c b/miscutils/devfsd.c index 334f1071b..814714f53 100644 --- a/miscutils/devfsd.c +++ b/miscutils/devfsd.c @@ -59,56 +59,55 @@ //config: select PLATFORM_LINUX //config: select FEATURE_SYSLOG //config: help -//config: This is deprecated and should NOT be used anymore. -//config: Use linux >= 2.6 (optionally with hotplug) and mdev instead! -//config: See docs/mdev.txt for detailed instructions on how to use mdev -//config: instead. +//config: This is deprecated and should NOT be used anymore. +//config: Use linux >= 2.6 (optionally with hotplug) and mdev instead! +//config: See docs/mdev.txt for detailed instructions on how to use mdev +//config: instead. //config: -//config: Provides compatibility with old device names on a devfs systems. -//config: You should set it to true if you have devfs enabled. -//config: The following keywords in devsfd.conf are supported: -//config: "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE", -//config: "PERMISSIONS", "EXECUTE", "COPY", "IGNORE", -//config: "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT". +//config: Provides compatibility with old device names on a devfs systems. +//config: You should set it to true if you have devfs enabled. +//config: The following keywords in devsfd.conf are supported: +//config: "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE", +//config: "PERMISSIONS", "EXECUTE", "COPY", "IGNORE", +//config: "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT". //config: -//config: But only if they are written UPPERCASE!!!!!!!! +//config: But only if they are written UPPERCASE!!!!!!!! //config: //config:config DEVFSD_MODLOAD //config: bool "Adds support for MODLOAD keyword in devsfd.conf" //config: default y //config: depends on DEVFSD //config: help -//config: This actually doesn't work with busybox modutils but needs -//config: the external modutils. +//config: This actually doesn't work with busybox modutils but needs +//config: the external modutils. //config: //config:config DEVFSD_FG_NP //config: bool "Enable the -fg and -np options" //config: default y //config: depends on DEVFSD //config: help -//config: -fg Run the daemon in the foreground. -//config: -np Exit after parsing the configuration file. -//config: Do not poll for events. +//config: -fg Run the daemon in the foreground. +//config: -np Exit after parsing config. Do not poll for events. //config: //config:config DEVFSD_VERBOSE //config: bool "Increases logging (and size)" //config: default y //config: depends on DEVFSD //config: help -//config: Increases logging to stderr or syslog. +//config: Increases logging to stderr or syslog. //config: //config:config FEATURE_DEVFS //config: bool "Use devfs names for all devices (obsolete)" //config: default n //config: select PLATFORM_LINUX //config: help -//config: This is obsolete and should NOT be used anymore. -//config: Use linux >= 2.6 (optionally with hotplug) and mdev instead! +//config: This is obsolete and should NOT be used anymore. +//config: Use linux >= 2.6 (optionally with hotplug) and mdev instead! //config: -//config: For legacy systems -- if there is no way around devfsd -- this -//config: tells busybox to look for names like /dev/loop/0 instead of -//config: /dev/loop0. If your /dev directory has normal names instead of -//config: devfs names, you don't want this. +//config: For legacy systems -- if there is no way around devfsd -- this +//config: tells busybox to look for names like /dev/loop/0 instead of +//config: /dev/loop0. If your /dev directory has normal names instead of +//config: devfs names, you don't want this. //applet:IF_DEVFSD(APPLET(devfsd, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/devmem.c b/miscutils/devmem.c index ec911a707..624054770 100644 --- a/miscutils/devmem.c +++ b/miscutils/devmem.c @@ -7,8 +7,8 @@ //config: bool "devmem (2.5 kb)" //config: default y //config: help -//config: devmem is a small program that reads and writes from physical -//config: memory using /dev/mem. +//config: devmem is a small program that reads and writes from physical +//config: memory using /dev/mem. //applet:IF_DEVMEM(APPLET(devmem, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/fbsplash.c b/miscutils/fbsplash.c index 4c891deb0..9ac91e01e 100644 --- a/miscutils/fbsplash.c +++ b/miscutils/fbsplash.c @@ -25,20 +25,20 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Shows splash image and progress bar on framebuffer device. -//config: Can be used during boot phase of an embedded device. ~2kb. -//config: Usage: -//config: - use kernel option 'vga=xxx' or otherwise enable fb device. -//config: - put somewhere fbsplash.cfg file and an image in .ppm format. -//config: - $ setsid fbsplash [params] & +//config: Shows splash image and progress bar on framebuffer device. +//config: Can be used during boot phase of an embedded device. +//config: Usage: +//config: - use kernel option 'vga=xxx' or otherwise enable fb device. +//config: - put somewhere fbsplash.cfg file and an image in .ppm format. +//config: - $ setsid fbsplash [params] & //config: -c: hide cursor //config: -d /dev/fbN: framebuffer device (if not /dev/fb0) //config: -s path_to_image_file (can be "-" for stdin) //config: -i path_to_cfg_file (can be "-" for stdin) //config: -f path_to_fifo (can be "-" for stdin) -//config: - if you want to run it only in presence of kernel parameter: +//config: - if you want to run it only in presence of kernel parameter: //config: grep -q "fbsplash=on" = 2.6.13 +//config: Simple inotify daemon. Reports filesystem changes. Requires +//config: kernel >= 2.6.13 //applet:IF_INOTIFYD(APPLET(inotifyd, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/less.c b/miscutils/less.c index a4ef1518f..c1d5e1b39 100644 --- a/miscutils/less.c +++ b/miscutils/less.c @@ -25,8 +25,8 @@ //config: bool "less (15 kb)" //config: default y //config: help -//config: 'less' is a pager, meaning that it displays text files. It possesses -//config: a wide array of features, and is an improvement over 'more'. +//config: 'less' is a pager, meaning that it displays text files. It possesses +//config: a wide array of features, and is an improvement over 'more'. //config: //config:config FEATURE_LESS_MAXLINES //config: int "Max number of input lines less will try to eat" @@ -38,64 +38,64 @@ //config: default y //config: depends on LESS //config: help -//config: This option adds the capability to search for matching left and right -//config: brackets, facilitating programming. +//config: This option adds the capability to search for matching left and right +//config: brackets, facilitating programming. //config: //config:config FEATURE_LESS_FLAGS //config: bool "Enable -m/-M" //config: default y //config: depends on LESS //config: help -//config: The -M/-m flag enables a more sophisticated status line. +//config: The -M/-m flag enables a more sophisticated status line. //config: //config:config FEATURE_LESS_TRUNCATE //config: bool "Enable -S" //config: default y //config: depends on LESS //config: help -//config: The -S flag causes long lines to be truncated rather than -//config: wrapped. +//config: The -S flag causes long lines to be truncated rather than +//config: wrapped. //config: //config:config FEATURE_LESS_MARKS //config: bool "Enable marks" //config: default y //config: depends on LESS //config: help -//config: Marks enable positions in a file to be stored for easy reference. +//config: Marks enable positions in a file to be stored for easy reference. //config: //config:config FEATURE_LESS_REGEXP //config: bool "Enable regular expressions" //config: default y //config: depends on LESS //config: help -//config: Enable regular expressions, allowing complex file searches. +//config: Enable regular expressions, allowing complex file searches. //config: //config:config FEATURE_LESS_WINCH //config: bool "Enable automatic resizing on window size changes" //config: default y //config: depends on LESS //config: help -//config: Makes less track window size changes. +//config: Makes less track window size changes. //config: //config:config FEATURE_LESS_ASK_TERMINAL //config: bool "Use 'tell me cursor position' ESC sequence to measure window" //config: default y //config: depends on FEATURE_LESS_WINCH //config: help -//config: Makes less track window size changes. -//config: If terminal size can't be retrieved and $LINES/$COLUMNS are not set, -//config: this option makes less perform a last-ditch effort to find it: -//config: position cursor to 999,999 and ask terminal to report real -//config: cursor position using "ESC [ 6 n" escape sequence, then read stdin. -//config: This is not clean but helps a lot on serial lines and such. +//config: Makes less track window size changes. +//config: If terminal size can't be retrieved and $LINES/$COLUMNS are not set, +//config: this option makes less perform a last-ditch effort to find it: +//config: position cursor to 999,999 and ask terminal to report real +//config: cursor position using "ESC [ 6 n" escape sequence, then read stdin. +//config: This is not clean but helps a lot on serial lines and such. //config: //config:config FEATURE_LESS_DASHCMD //config: bool "Enable flag changes ('-' command)" //config: default y //config: depends on LESS //config: help -//config: This enables the ability to change command-line flags within -//config: less itself ('-' keyboard command). +//config: This enables the ability to change command-line flags within +//config: less itself ('-' keyboard command). //config: //config:config FEATURE_LESS_LINENUMS //config: bool "Enable -N (dynamic switching of line numbers)" diff --git a/miscutils/lsscsi.c b/miscutils/lsscsi.c index 72fafefb0..b69ff1eef 100644 --- a/miscutils/lsscsi.c +++ b/miscutils/lsscsi.c @@ -11,10 +11,10 @@ //config: default y //config: #select PLATFORM_LINUX //config: help -//config: lsscsi is a utility for displaying information about SCSI buses in the -//config: system and devices connected to them. +//config: lsscsi is a utility for displaying information about SCSI buses in the +//config: system and devices connected to them. //config: -//config: This version uses sysfs (/sys/bus/scsi/devices) only. +//config: This version uses sysfs (/sys/bus/scsi/devices) only. //applet:IF_LSSCSI(APPLET(lsscsi, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/makedevs.c b/miscutils/makedevs.c index 5f8593a0c..c2f86df01 100644 --- a/miscutils/makedevs.c +++ b/miscutils/makedevs.c @@ -10,20 +10,20 @@ //config: bool "makedevs (9.3 kb)" //config: default y //config: help -//config: 'makedevs' is a utility used to create a batch of devices with -//config: one command. +//config: 'makedevs' is a utility used to create a batch of devices with +//config: one command. //config: -//config: There are two choices for command line behaviour, the interface -//config: as used by LEAF/Linux Router Project, or a device table file. +//config: There are two choices for command line behaviour, the interface +//config: as used by LEAF/Linux Router Project, or a device table file. //config: -//config: 'leaf' is traditionally what busybox follows, it allows multiple -//config: devices of a particluar type to be created per command. -//config: e.g. /dev/hda[0-9] -//config: Device properties are passed as command line arguments. +//config: 'leaf' is traditionally what busybox follows, it allows multiple +//config: devices of a particluar type to be created per command. +//config: e.g. /dev/hda[0-9] +//config: Device properties are passed as command line arguments. //config: -//config: 'table' reads device properties from a file or stdin, allowing -//config: a batch of unrelated devices to be made with one command. -//config: User/group names are allowed as an alternative to uid/gid. +//config: 'table' reads device properties from a file or stdin, allowing +//config: a batch of unrelated devices to be made with one command. +//config: User/group names are allowed as an alternative to uid/gid. //config: //config:choice //config: prompt "Choose makedevs behaviour" diff --git a/miscutils/man.c b/miscutils/man.c index de6ef1961..a16202f25 100644 --- a/miscutils/man.c +++ b/miscutils/man.c @@ -6,7 +6,7 @@ //config: bool "man (27 kb)" //config: default y //config: help -//config: Format and display manual pages. +//config: Format and display manual pages. //applet:IF_MAN(APPLET(man, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/microcom.c b/miscutils/microcom.c index 436509c47..14b9f3baf 100644 --- a/miscutils/microcom.c +++ b/miscutils/microcom.c @@ -11,7 +11,7 @@ //config: bool "microcom (5.6 kb)" //config: default y //config: help -//config: The poor man's minicom utility for chatting with serial port devices. +//config: The poor man's minicom utility for chatting with serial port devices. //applet:IF_MICROCOM(APPLET(microcom, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/mt.c b/miscutils/mt.c index aec7bf775..fad656e95 100644 --- a/miscutils/mt.c +++ b/miscutils/mt.c @@ -6,9 +6,9 @@ //config: bool "mt (2.6 kb)" //config: default y //config: help -//config: mt is used to control tape devices. You can use the mt utility -//config: to advance or rewind a tape past a specified number of archive -//config: files on the tape. +//config: mt is used to control tape devices. You can use the mt utility +//config: to advance or rewind a tape past a specified number of archive +//config: files on the tape. //applet:IF_MT(APPLET(mt, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/miscutils/nandwrite.c b/miscutils/nandwrite.c index 8659b491f..14b1ed056 100644 --- a/miscutils/nandwrite.c +++ b/miscutils/nandwrite.c @@ -13,14 +13,14 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Write to the specified MTD device, with bad blocks awareness +//config: Write to the specified MTD device, with bad blocks awareness //config: //config:config NANDDUMP //config: bool "nanddump (6.3 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Dump the content of raw NAND chip +//config: Dump the content of raw NAND chip //applet:IF_NANDWRITE(APPLET(nandwrite, BB_DIR_USR_SBIN, BB_SUID_DROP)) //applet:IF_NANDDUMP(APPLET_ODDNAME(nanddump, nandwrite, BB_DIR_USR_SBIN, BB_SUID_DROP, nanddump)) diff --git a/miscutils/partprobe.c b/miscutils/partprobe.c index 787def8cd..2c12a7d20 100644 --- a/miscutils/partprobe.c +++ b/miscutils/partprobe.c @@ -9,7 +9,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Ask kernel to rescan partition table. +//config: Ask kernel to rescan partition table. //applet:IF_PARTPROBE(APPLET(partprobe, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/raidautorun.c b/miscutils/raidautorun.c index 45e398ebf..ecedf9ce2 100644 --- a/miscutils/raidautorun.c +++ b/miscutils/raidautorun.c @@ -12,8 +12,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: raidautorun tells the kernel md driver to -//config: search and start RAID arrays. +//config: raidautorun tells the kernel md driver to +//config: search and start RAID arrays. //applet:IF_RAIDAUTORUN(APPLET(raidautorun, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/readahead.c b/miscutils/readahead.c index eb966b0f0..972302a18 100644 --- a/miscutils/readahead.c +++ b/miscutils/readahead.c @@ -15,17 +15,17 @@ //config: depends on LFS //config: select PLATFORM_LINUX //config: help -//config: Preload the files listed on the command line into RAM cache so that -//config: subsequent reads on these files will not block on disk I/O. +//config: Preload the files listed on the command line into RAM cache so that +//config: subsequent reads on these files will not block on disk I/O. //config: -//config: This applet just calls the readahead(2) system call on each file. -//config: It is mainly useful in system startup scripts to preload files -//config: or executables before they are used. When used at the right time -//config: (in particular when a CPU bound process is running) it can -//config: significantly speed up system startup. +//config: This applet just calls the readahead(2) system call on each file. +//config: It is mainly useful in system startup scripts to preload files +//config: or executables before they are used. When used at the right time +//config: (in particular when a CPU bound process is running) it can +//config: significantly speed up system startup. //config: -//config: As readahead(2) blocks until each file has been read, it is best to -//config: run this applet as a background job. +//config: As readahead(2) blocks until each file has been read, it is best to +//config: run this applet as a background job. //applet:IF_READAHEAD(APPLET(readahead, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/rfkill.c b/miscutils/rfkill.c index 2c083b144..546928402 100644 --- a/miscutils/rfkill.c +++ b/miscutils/rfkill.c @@ -12,12 +12,12 @@ //config: default n # doesn't build on Ubuntu 9.04 //config: select PLATFORM_LINUX //config: help -//config: Enable/disable wireless devices. +//config: Enable/disable wireless devices. //config: -//config: rfkill list : list all wireless devices -//config: rfkill list bluetooth : list all bluetooth devices -//config: rfkill list 1 : list device corresponding to the given index -//config: rfkill block|unblock wlan : block/unblock all wlan(wifi) devices +//config: rfkill list : list all wireless devices +//config: rfkill list bluetooth : list all bluetooth devices +//config: rfkill list 1 : list device corresponding to the given index +//config: rfkill block|unblock wlan : block/unblock all wlan(wifi) devices //config: //applet:IF_RFKILL(APPLET(rfkill, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/runlevel.c b/miscutils/runlevel.c index 79fa3c834..6b4742255 100644 --- a/miscutils/runlevel.c +++ b/miscutils/runlevel.c @@ -16,10 +16,10 @@ //config: default y //config: depends on FEATURE_UTMP //config: help -//config: find the current and previous system runlevel. +//config: find the current and previous system runlevel. //config: -//config: This applet uses utmp but does not rely on busybox supporing -//config: utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc. +//config: This applet uses utmp but does not rely on busybox supporing +//config: utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc. //applet:IF_RUNLEVEL(APPLET(runlevel, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/rx.c b/miscutils/rx.c index 3cf17843f..874a3f0a3 100644 --- a/miscutils/rx.c +++ b/miscutils/rx.c @@ -19,7 +19,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Receive files using the Xmodem protocol. +//config: Receive files using the Xmodem protocol. //applet:IF_RX(APPLET(rx, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/setserial.c b/miscutils/setserial.c index a60950206..28a1bef18 100644 --- a/miscutils/setserial.c +++ b/miscutils/setserial.c @@ -13,7 +13,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Retrieve or set Linux serial port. +//config: Retrieve or set Linux serial port. //applet:IF_SETSERIAL(APPLET(setserial, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/miscutils/strings.c b/miscutils/strings.c index 17c047079..ccb05f6d4 100644 --- a/miscutils/strings.c +++ b/miscutils/strings.c @@ -10,8 +10,8 @@ //config: bool "strings (4.3 kb)" //config: default y //config: help -//config: strings prints the printable character sequences for each file -//config: specified. +//config: strings prints the printable character sequences for each file +//config: specified. //applet:IF_STRINGS(APPLET(strings, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/time.c b/miscutils/time.c index c443ef909..60fc11f6e 100644 --- a/miscutils/time.c +++ b/miscutils/time.c @@ -12,9 +12,9 @@ //config: bool "time (7 kb)" //config: default y //config: help -//config: The time command runs the specified program with the given arguments. -//config: When the command finishes, time writes a message to standard output -//config: giving timing statistics about this program run. +//config: The time command runs the specified program with the given arguments. +//config: When the command finishes, time writes a message to standard output +//config: giving timing statistics about this program run. //applet:IF_TIME(APPLET(time, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/ttysize.c b/miscutils/ttysize.c index a2eeb9347..7f6a84308 100644 --- a/miscutils/ttysize.c +++ b/miscutils/ttysize.c @@ -13,10 +13,10 @@ //config: bool "ttysize (372 bytes)" //config: default y //config: help -//config: A replacement for "stty size". Unlike stty, can report only width, -//config: only height, or both, in any order. It also does not complain on -//config: error, but returns default 80x24. -//config: Usage in shell scripts: width=`ttysize w`. +//config: A replacement for "stty size". Unlike stty, can report only width, +//config: only height, or both, in any order. It also does not complain on +//config: error, but returns default 80x24. +//config: Usage in shell scripts: width=`ttysize w`. //applet:IF_TTYSIZE(APPLET(ttysize, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/ubi_tools.c b/miscutils/ubi_tools.c index 07f9a72ea..c6ba22adf 100644 --- a/miscutils/ubi_tools.c +++ b/miscutils/ubi_tools.c @@ -8,42 +8,42 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Attach MTD device to an UBI device. +//config: Attach MTD device to an UBI device. //config: //config:config UBIDETACH //config: bool "ubidetach (4.6 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Detach MTD device from an UBI device. +//config: Detach MTD device from an UBI device. //config: //config:config UBIMKVOL //config: bool "ubimkvol (5.8 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Create a UBI volume. +//config: Create a UBI volume. //config: //config:config UBIRMVOL //config: bool "ubirmvol (5.2 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Delete a UBI volume. +//config: Delete a UBI volume. //config: //config:config UBIRSVOL //config: bool "ubirsvol (4.6 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Resize a UBI volume. +//config: Resize a UBI volume. //config: //config:config UBIUPDATEVOL //config: bool "ubiupdatevol (5.6 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Update a UBI volume. +//config: Update a UBI volume. // APPLET_ODDNAME:name main location suid_type help //applet:IF_UBIATTACH( APPLET_ODDNAME(ubiattach, ubi_tools, BB_DIR_USR_SBIN, BB_SUID_DROP, ubiattach)) diff --git a/miscutils/ubirename.c b/miscutils/ubirename.c index 8fb42ee81..786c4b9fa 100644 --- a/miscutils/ubirename.c +++ b/miscutils/ubirename.c @@ -11,7 +11,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Utility to rename UBI volumes +//config: Utility to rename UBI volumes //applet:IF_UBIRENAME(APPLET(ubirename, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/miscutils/volname.c b/miscutils/volname.c index d80787f1a..6e6bbaa44 100644 --- a/miscutils/volname.c +++ b/miscutils/volname.c @@ -31,7 +31,7 @@ //config: bool "volname (1.7 kb)" //config: default y //config: help -//config: Prints a CD-ROM volume name. +//config: Prints a CD-ROM volume name. //applet:IF_VOLNAME(APPLET(volname, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/miscutils/watchdog.c b/miscutils/watchdog.c index 2ef4997b1..ec06bcb51 100644 --- a/miscutils/watchdog.c +++ b/miscutils/watchdog.c @@ -13,12 +13,12 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The watchdog utility is used with hardware or software watchdog -//config: device drivers. It opens the specified watchdog device special file -//config: and periodically writes a magic character to the device. If the -//config: watchdog applet ever fails to write the magic character within a -//config: certain amount of time, the watchdog device assumes the system has -//config: hung, and will cause the hardware to reboot. +//config: The watchdog utility is used with hardware or software watchdog +//config: device drivers. It opens the specified watchdog device special file +//config: and periodically writes a magic character to the device. If the +//config: watchdog applet ever fails to write the magic character within a +//config: certain amount of time, the watchdog device assumes the system has +//config: hung, and will cause the hardware to reboot. //applet:IF_WATCHDOG(APPLET(watchdog, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/modutils/Config.src b/modutils/Config.src index 9b76c83d2..e413702bb 100644 --- a/modutils/Config.src +++ b/modutils/Config.src @@ -9,29 +9,29 @@ config MODPROBE_SMALL bool "Simplified modutils" default y help - Build smaller (~1.5 kbytes), simplified module tools. + Build smaller (~1.5 kbytes), simplified module tools. - This option by itself does not enable any applets - - you need to select applets individually below. + This option by itself does not enable any applets - + you need to select applets individually below. - With this option modprobe does not require modules.dep file - and does not use /etc/modules.conf file. - It scans module files in /lib/modules/`uname -r` and - determines dependencies and module alias names on the fly. - This may make module loading slower, most notably - when one needs to load module by alias (this requires - scanning through module _bodies_). + With this option modprobe does not require modules.dep file + and does not use /etc/modules.conf file. + It scans module files in /lib/modules/`uname -r` and + determines dependencies and module alias names on the fly. + This may make module loading slower, most notably + when one needs to load module by alias (this requires + scanning through module _bodies_). - At the first attempt to load a module by alias modprobe - will try to generate modules.dep.bb file in order to speed up - future loads by alias. Failure to do so (read-only /lib/modules, - etc) is not reported, and future modprobes will be slow too. + At the first attempt to load a module by alias modprobe + will try to generate modules.dep.bb file in order to speed up + future loads by alias. Failure to do so (read-only /lib/modules, + etc) is not reported, and future modprobes will be slow too. - NB: modules.dep.bb file format is not compatible - with modules.dep file as created/used by standard module tools. + NB: modules.dep.bb file format is not compatible + with modules.dep file as created/used by standard module tools. - Additional module parameters can be stored in - /etc/modules/$module_name files. + Additional module parameters can be stored in + /etc/modules/$module_name files. INSERT @@ -42,145 +42,145 @@ config FEATURE_CMDLINE_MODULE_OPTIONS default y depends on INSMOD || MODPROBE help - Allow insmod and modprobe take module options from the applets' - command line. + Allow insmod and modprobe take module options from the applets' + command line. config FEATURE_MODPROBE_SMALL_CHECK_ALREADY_LOADED bool "Skip loading of already loaded modules" default y depends on MODPROBE_SMALL && (DEPMOD || INSMOD || MODPROBE) help - Check if the module is already loaded. + Check if the module is already loaded. config FEATURE_2_4_MODULES bool "Support version 2.2/2.4 Linux kernels" default n depends on (INSMOD || LSMOD || MODPROBE || RMMOD) && !MODPROBE_SMALL help - Support module loading for 2.2.x and 2.4.x Linux kernels. - This increases size considerably. Say N unless you plan - to run ancient kernels. + Support module loading for 2.2.x and 2.4.x Linux kernels. + This increases size considerably. Say N unless you plan + to run ancient kernels. config FEATURE_INSMOD_VERSION_CHECKING bool "Enable module version checking" default n depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE) help - Support checking of versions for modules. This is used to - ensure that the kernel and module are made for each other. + Support checking of versions for modules. This is used to + ensure that the kernel and module are made for each other. config FEATURE_INSMOD_KSYMOOPS_SYMBOLS bool "Add module symbols to kernel symbol table" default n depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE) help - By adding module symbols to the kernel symbol table, Oops messages - occurring within kernel modules can be properly debugged. By enabling - this feature, module symbols will always be added to the kernel symbol - table for proper debugging support. If you are not interested in - Oops messages from kernel modules, say N. + By adding module symbols to the kernel symbol table, Oops messages + occurring within kernel modules can be properly debugged. By enabling + this feature, module symbols will always be added to the kernel symbol + table for proper debugging support. If you are not interested in + Oops messages from kernel modules, say N. config FEATURE_INSMOD_LOADINKMEM bool "In kernel memory optimization (uClinux only)" default n depends on FEATURE_2_4_MODULES && (INSMOD || MODPROBE) help - This is a special uClinux only memory optimization that lets insmod - load the specified kernel module directly into kernel space, reducing - memory usage by preventing the need for two copies of the module - being loaded into memory. + This is a special uClinux only memory optimization that lets insmod + load the specified kernel module directly into kernel space, reducing + memory usage by preventing the need for two copies of the module + being loaded into memory. config FEATURE_INSMOD_LOAD_MAP bool "Enable insmod load map (-m) option" default n depends on FEATURE_2_4_MODULES && INSMOD help - Enabling this, one would be able to get a load map - output on stdout. This makes kernel module debugging - easier. - If you don't plan to debug kernel modules, you - don't need this option. + Enabling this, one would be able to get a load map + output on stdout. This makes kernel module debugging + easier. + If you don't plan to debug kernel modules, you + don't need this option. config FEATURE_INSMOD_LOAD_MAP_FULL bool "Symbols in load map" default y depends on FEATURE_INSMOD_LOAD_MAP help - Without this option, -m will only output section - load map. With this option, -m will also output - symbols load map. + Without this option, -m will only output section + load map. With this option, -m will also output + symbols load map. config FEATURE_CHECK_TAINTED_MODULE bool "Support tainted module checking with new kernels" default y depends on (LSMOD || FEATURE_2_4_MODULES) && !MODPROBE_SMALL help - Support checking for tainted modules. These are usually binary - only modules that will make the linux-kernel list ignore your - support request. - This option is required to support GPLONLY modules. + Support checking for tainted modules. These are usually binary + only modules that will make the linux-kernel list ignore your + support request. + This option is required to support GPLONLY modules. config FEATURE_INSMOD_TRY_MMAP bool "Try to load module from a mmap'ed area" default n depends on (INSMOD || MODPROBE) && !MODPROBE_SMALL help - This option causes module loading code to try to mmap - module first. If it does not work (for example, - it does not work for compressed modules), module will be read - (and unpacked if needed) into a memory block allocated by malloc. + This option causes module loading code to try to mmap + module first. If it does not work (for example, + it does not work for compressed modules), module will be read + (and unpacked if needed) into a memory block allocated by malloc. - The only case when mmap works but malloc does not is when - you are trying to load a big module on a very memory-constrained - machine. Malloc will momentarily need 2x as much memory as mmap. + The only case when mmap works but malloc does not is when + you are trying to load a big module on a very memory-constrained + machine. Malloc will momentarily need 2x as much memory as mmap. - Choosing N saves about 250 bytes of code (on 32-bit x86). + Choosing N saves about 250 bytes of code (on 32-bit x86). config FEATURE_MODUTILS_ALIAS bool "Support module.aliases file" default y depends on (DEPMOD || MODPROBE) && !MODPROBE_SMALL help - Generate and parse modules.alias containing aliases for bus - identifiers: - alias pcmcia:m*c*f03fn*pfn*pa*pb*pc*pd* parport_cs + Generate and parse modules.alias containing aliases for bus + identifiers: + alias pcmcia:m*c*f03fn*pfn*pa*pb*pc*pd* parport_cs - and aliases for logical modules names e.g.: - alias padlock_aes aes - alias aes_i586 aes - alias aes_generic aes + and aliases for logical modules names e.g.: + alias padlock_aes aes + alias aes_i586 aes + alias aes_generic aes - Say Y if unsure. + Say Y if unsure. config FEATURE_MODUTILS_SYMBOLS bool "Support module.symbols file" default y depends on (DEPMOD || MODPROBE) && !MODPROBE_SMALL help - Generate and parse modules.symbols containing aliases for - symbol_request() kernel calls, such as: - alias symbol:usb_sg_init usbcore + Generate and parse modules.symbols containing aliases for + symbol_request() kernel calls, such as: + alias symbol:usb_sg_init usbcore - Say Y if unsure. + Say Y if unsure. config DEFAULT_MODULES_DIR string "Default directory containing modules" default "/lib/modules" depends on DEPMOD || MODPROBE || MODINFO help - Directory that contains kernel modules. - Defaults to "/lib/modules" + Directory that contains kernel modules. + Defaults to "/lib/modules" config DEFAULT_DEPMOD_FILE string "Default name of modules.dep" default "modules.dep" depends on DEPMOD || MODPROBE || MODINFO help - Filename that contains kernel modules dependencies. - Defaults to "modules.dep". - If you configured the "simplified modutils" (MODPROBE_SMALL), a - ".bb" suffix will be added after this name. Do not specify ".bb" - here unless you intend your depmod or modprobe to work on - "modules.dep.bb.bb" or such. + Filename that contains kernel modules dependencies. + Defaults to "modules.dep". + If you configured the "simplified modutils" (MODPROBE_SMALL), a + ".bb" suffix will be added after this name. Do not specify ".bb" + here unless you intend your depmod or modprobe to work on + "modules.dep.bb.bb" or such. endmenu diff --git a/modutils/depmod.c b/modutils/depmod.c index f6e889d8f..004c67a11 100644 --- a/modutils/depmod.c +++ b/modutils/depmod.c @@ -12,9 +12,9 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: depmod generates modules.dep (and potentially modules.alias -//config: and modules.symbols) that contain dependency information -//config: for modprobe. +//config: depmod generates modules.dep (and potentially modules.alias +//config: and modules.symbols) that contain dependency information +//config: for modprobe. //applet:IF_DEPMOD(IF_NOT_MODPROBE_SMALL(APPLET(depmod, BB_DIR_SBIN, BB_SUID_DROP))) diff --git a/modutils/insmod.c b/modutils/insmod.c index 6f448f34d..b8ede8a81 100644 --- a/modutils/insmod.c +++ b/modutils/insmod.c @@ -11,7 +11,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: insmod is used to load specified modules in the running kernel. +//config: insmod is used to load specified modules in the running kernel. //applet:IF_INSMOD(IF_NOT_MODPROBE_SMALL(APPLET(insmod, BB_DIR_SBIN, BB_SUID_DROP))) diff --git a/modutils/lsmod.c b/modutils/lsmod.c index 9fe0eff22..4bf8f8481 100644 --- a/modutils/lsmod.c +++ b/modutils/lsmod.c @@ -12,16 +12,16 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: lsmod is used to display a list of loaded modules. +//config: lsmod is used to display a list of loaded modules. //config: //config:config FEATURE_LSMOD_PRETTY_2_6_OUTPUT //config: bool "Pretty output" //config: default y //config: depends on LSMOD && !MODPROBE_SMALL //config: help -//config: This option makes output format of lsmod adjusted to -//config: the format of module-init-tools for Linux kernel 2.6. -//config: Increases size somewhat. +//config: This option makes output format of lsmod adjusted to +//config: the format of module-init-tools for Linux kernel 2.6. +//config: Increases size somewhat. //applet:IF_LSMOD(IF_NOT_MODPROBE_SMALL(APPLET(lsmod, BB_DIR_SBIN, BB_SUID_DROP))) diff --git a/modutils/modinfo.c b/modutils/modinfo.c index 6eae1b7b1..371c93991 100644 --- a/modutils/modinfo.c +++ b/modutils/modinfo.c @@ -10,7 +10,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Show information about a Linux Kernel module +//config: Show information about a Linux Kernel module //applet:IF_MODINFO(APPLET(modinfo, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/modutils/modprobe.c b/modutils/modprobe.c index 6bcfb9bcd..1a7db09f2 100644 --- a/modutils/modprobe.c +++ b/modutils/modprobe.c @@ -12,19 +12,19 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Handle the loading of modules, and their dependencies on a high -//config: level. +//config: Handle the loading of modules, and their dependencies on a high +//config: level. //config: //config:config FEATURE_MODPROBE_BLACKLIST //config: bool "Blacklist support" //config: default y //config: depends on MODPROBE && !MODPROBE_SMALL //config: help -//config: Say 'y' here to enable support for the 'blacklist' command in -//config: modprobe.conf. This prevents the alias resolver to resolve -//config: blacklisted modules. This is useful if you want to prevent your -//config: hardware autodetection scripts to load modules like evdev, frame -//config: buffer drivers etc. +//config: Say 'y' here to enable support for the 'blacklist' command in +//config: modprobe.conf. This prevents the alias resolver to resolve +//config: blacklisted modules. This is useful if you want to prevent your +//config: hardware autodetection scripts to load modules like evdev, frame +//config: buffer drivers etc. //applet:IF_MODPROBE(IF_NOT_MODPROBE_SMALL(APPLET(modprobe, BB_DIR_SBIN, BB_SUID_DROP))) diff --git a/modutils/rmmod.c b/modutils/rmmod.c index 1e87abf3a..d60e49413 100644 --- a/modutils/rmmod.c +++ b/modutils/rmmod.c @@ -12,7 +12,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: rmmod is used to unload specified modules from the kernel. +//config: rmmod is used to unload specified modules from the kernel. //applet:IF_RMMOD(IF_NOT_MODPROBE_SMALL(APPLET(rmmod, BB_DIR_SBIN, BB_SUID_DROP))) diff --git a/networking/Config.src b/networking/Config.src index 0adb1e2f9..492c60da4 100644 --- a/networking/Config.src +++ b/networking/Config.src @@ -9,42 +9,42 @@ config FEATURE_IPV6 bool "Enable IPv6 support" default y help - Enable IPv6 support in busybox. - This adds IPv6 support in the networking applets. + Enable IPv6 support in busybox. + This adds IPv6 support in the networking applets. config FEATURE_UNIX_LOCAL bool "Enable Unix domain socket support (usually not needed)" default n help - Enable Unix domain socket support in all busybox networking - applets. Address of the form local:/path/to/unix/socket - will be recognized. + Enable Unix domain socket support in all busybox networking + applets. Address of the form local:/path/to/unix/socket + will be recognized. - This extension is almost never used in real world usage. - You most likely want to say N. + This extension is almost never used in real world usage. + You most likely want to say N. config FEATURE_PREFER_IPV4_ADDRESS bool "Prefer IPv4 addresses from DNS queries" default y depends on FEATURE_IPV6 help - Use IPv4 address of network host if it has one. + Use IPv4 address of network host if it has one. - If this option is off, the first returned address will be used. - This may cause problems when your DNS server is IPv6-capable and - is returning IPv6 host addresses too. If IPv6 address - precedes IPv4 one in DNS reply, busybox network applets - (e.g. wget) will use IPv6 address. On an IPv6-incapable host - or network applets will fail to connect to the host - using IPv6 address. + If this option is off, the first returned address will be used. + This may cause problems when your DNS server is IPv6-capable and + is returning IPv6 host addresses too. If IPv6 address + precedes IPv4 one in DNS reply, busybox network applets + (e.g. wget) will use IPv6 address. On an IPv6-incapable host + or network applets will fail to connect to the host + using IPv6 address. config VERBOSE_RESOLUTION_ERRORS bool "Verbose resolution errors" default n help - Enable if you are not satisfied with simplistic - "can't resolve 'hostname.com'" and want to know more. - This may increase size of your executable a bit. + Enable if you are not satisfied with simplistic + "can't resolve 'hostname.com'" and want to know more. + This may increase size of your executable a bit. INSERT @@ -55,8 +55,8 @@ config IFUPDOWN_UDHCPC_CMD_OPTIONS default "-R -n" depends on IFUP || IFDOWN help - Command line options to pass to udhcpc from ifup. - Intended to alter options not available in /etc/network/interfaces. - (IE: --syslog --background etc...) + Command line options to pass to udhcpc from ifup. + Intended to alter options not available in /etc/network/interfaces. + (IE: --syslog --background etc...) endmenu diff --git a/networking/arp.c b/networking/arp.c index f23ec8629..177ab1571 100644 --- a/networking/arp.c +++ b/networking/arp.c @@ -17,7 +17,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Manipulate the system ARP cache. +//config: Manipulate the system ARP cache. //applet:IF_ARP(APPLET(arp, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/arping.c b/networking/arping.c index bc6b6be6a..71672957e 100644 --- a/networking/arping.c +++ b/networking/arping.c @@ -10,7 +10,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Ping hosts by ARP packets. +//config: Ping hosts by ARP packets. //config: //applet:IF_ARPING(APPLET(arping, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/brctl.c b/networking/brctl.c index bedf8031a..690791e4c 100644 --- a/networking/brctl.c +++ b/networking/brctl.c @@ -17,27 +17,27 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Manage ethernet bridges. -//config: Supports addbr/delbr and addif/delif. +//config: Manage ethernet bridges. +//config: Supports addbr/delbr and addif/delif. //config: //config:config FEATURE_BRCTL_FANCY //config: bool "Fancy options" //config: default y //config: depends on BRCTL //config: help -//config: Add support for extended option like: -//config: setageing, setfd, sethello, setmaxage, -//config: setpathcost, setportprio, setbridgeprio, -//config: stp -//config: This adds about 600 bytes. +//config: Add support for extended option like: +//config: setageing, setfd, sethello, setmaxage, +//config: setpathcost, setportprio, setbridgeprio, +//config: stp +//config: This adds about 600 bytes. //config: //config:config FEATURE_BRCTL_SHOW //config: bool "Support show" //config: default y //config: depends on BRCTL && FEATURE_BRCTL_FANCY //config: help -//config: Add support for option which prints the current config: -//config: show +//config: Add support for option which prints the current config: +//config: show //applet:IF_BRCTL(APPLET(brctl, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/dnsd.c b/networking/dnsd.c index 9e058584a..37a80309d 100644 --- a/networking/dnsd.c +++ b/networking/dnsd.c @@ -20,7 +20,7 @@ //config: bool "dnsd (9.8 kb)" //config: default y //config: help -//config: Small and static DNS server daemon. +//config: Small and static DNS server daemon. //applet:IF_DNSD(APPLET(dnsd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ether-wake.c b/networking/ether-wake.c index 16155df54..52522e76d 100644 --- a/networking/ether-wake.c +++ b/networking/ether-wake.c @@ -68,7 +68,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Send a magic packet to wake up sleeping machines. +//config: Send a magic packet to wake up sleeping machines. //applet:IF_ETHER_WAKE(APPLET_ODDNAME(ether-wake, ether_wake, BB_DIR_USR_SBIN, BB_SUID_DROP, ether_wake)) diff --git a/networking/ftpd.c b/networking/ftpd.c index e923e78b2..aee00e1c3 100644 --- a/networking/ftpd.c +++ b/networking/ftpd.c @@ -15,32 +15,32 @@ //config: bool "ftpd (30 kb)" //config: default y //config: help -//config: Simple FTP daemon. You have to run it via inetd. +//config: Simple FTP daemon. You have to run it via inetd. //config: //config:config FEATURE_FTPD_WRITE //config: bool "Enable upload commands" //config: default y //config: depends on FTPD //config: help -//config: Enable all kinds of FTP upload commands (-w option) +//config: Enable all kinds of FTP upload commands (-w option) //config: //config:config FEATURE_FTPD_ACCEPT_BROKEN_LIST //config: bool "Enable workaround for RFC-violating clients" //config: default y //config: depends on FTPD //config: help -//config: Some ftp clients (among them KDE's Konqueror) issue illegal -//config: "LIST -l" requests. This option works around such problems. -//config: It might prevent you from listing files starting with "-" and -//config: it increases the code size by ~40 bytes. -//config: Most other ftp servers seem to behave similar to this. +//config: Some ftp clients (among them KDE's Konqueror) issue illegal +//config: "LIST -l" requests. This option works around such problems. +//config: It might prevent you from listing files starting with "-" and +//config: it increases the code size by ~40 bytes. +//config: Most other ftp servers seem to behave similar to this. //config: //config:config FEATURE_FTPD_AUTHENTICATION //config: bool "Enable authentication" //config: default y //config: depends on FTPD //config: help -//config: Enable basic system login as seen in telnet etc. +//config: Enable basic system login as seen in telnet etc. //applet:IF_FTPD(APPLET(ftpd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ftpgetput.c b/networking/ftpgetput.c index b967cd7d9..d70f4ca77 100644 --- a/networking/ftpgetput.c +++ b/networking/ftpgetput.c @@ -16,13 +16,13 @@ //config: bool "ftpget (8 kb)" //config: default y //config: help -//config: Retrieve a remote file via FTP. +//config: Retrieve a remote file via FTP. //config: //config:config FTPPUT //config: bool "ftpput (7.7 kb)" //config: default y //config: help -//config: Store a remote file via FTP. +//config: Store a remote file via FTP. //config: //config:config FEATURE_FTPGETPUT_LONG_OPTIONS //config: bool "Enable long options in ftpget/ftpput" diff --git a/networking/hostname.c b/networking/hostname.c index 07d746c0f..4b305d2b6 100644 --- a/networking/hostname.c +++ b/networking/hostname.c @@ -14,13 +14,13 @@ //config: bool "hostname (5.6 kb)" //config: default y //config: help -//config: Show or set the system's host name. +//config: Show or set the system's host name. //config: //config:config DNSDOMAINNAME //config: bool "dnsdomainname (3.6 kb)" //config: default y //config: help -//config: Alias to "hostname -d". +//config: Alias to "hostname -d". // APPLET_ODDNAME:name main location suid_type help //applet:IF_DNSDOMAINNAME(APPLET_ODDNAME(dnsdomainname, hostname, BB_DIR_BIN, BB_SUID_DROP, dnsdomainname)) diff --git a/networking/httpd.c b/networking/httpd.c index 7ad6d0878..cfc07075b 100644 --- a/networking/httpd.c +++ b/networking/httpd.c @@ -102,120 +102,120 @@ //config: bool "httpd (32 kb)" //config: default y //config: help -//config: HTTP server. +//config: HTTP server. //config: //config:config FEATURE_HTTPD_RANGES //config: bool "Support 'Ranges:' header" //config: default y //config: depends on HTTPD //config: help -//config: Makes httpd emit "Accept-Ranges: bytes" header and understand -//config: "Range: bytes=NNN-[MMM]" header. Allows for resuming interrupted -//config: downloads, seeking in multimedia players etc. +//config: Makes httpd emit "Accept-Ranges: bytes" header and understand +//config: "Range: bytes=NNN-[MMM]" header. Allows for resuming interrupted +//config: downloads, seeking in multimedia players etc. //config: //config:config FEATURE_HTTPD_SETUID //config: bool "Enable -u option" //config: default y //config: depends on HTTPD //config: help -//config: This option allows the server to run as a specific user -//config: rather than defaulting to the user that starts the server. -//config: Use of this option requires special privileges to change to a -//config: different user. +//config: This option allows the server to run as a specific user +//config: rather than defaulting to the user that starts the server. +//config: Use of this option requires special privileges to change to a +//config: different user. //config: //config:config FEATURE_HTTPD_BASIC_AUTH //config: bool "Enable Basic http Authentication" //config: default y //config: depends on HTTPD //config: help -//config: Utilizes password settings from /etc/httpd.conf for basic -//config: authentication on a per url basis. -//config: Example for httpd.conf file: -//config: /adm:toor:PaSsWd +//config: Utilizes password settings from /etc/httpd.conf for basic +//config: authentication on a per url basis. +//config: Example for httpd.conf file: +//config: /adm:toor:PaSsWd //config: //config:config FEATURE_HTTPD_AUTH_MD5 //config: bool "Support MD5 crypted passwords for http Authentication" //config: default y //config: depends on FEATURE_HTTPD_BASIC_AUTH //config: help -//config: Enables encrypted passwords, and wildcard user/passwords -//config: in httpd.conf file. -//config: User '*' means 'any system user name is ok', -//config: password of '*' means 'use system password for this user' -//config: Examples: -//config: /adm:toor:$1$P/eKnWXS$aI1aPGxT.dJD5SzqAKWrF0 -//config: /adm:root:* -//config: /wiki:*:* +//config: Enables encrypted passwords, and wildcard user/passwords +//config: in httpd.conf file. +//config: User '*' means 'any system user name is ok', +//config: password of '*' means 'use system password for this user' +//config: Examples: +//config: /adm:toor:$1$P/eKnWXS$aI1aPGxT.dJD5SzqAKWrF0 +//config: /adm:root:* +//config: /wiki:*:* //config: //config:config FEATURE_HTTPD_CGI //config: bool "Support Common Gateway Interface (CGI)" //config: default y //config: depends on HTTPD //config: help -//config: This option allows scripts and executables to be invoked -//config: when specific URLs are requested. +//config: This option allows scripts and executables to be invoked +//config: when specific URLs are requested. //config: //config:config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR //config: bool "Support running scripts through an interpreter" //config: default y //config: depends on FEATURE_HTTPD_CGI //config: help -//config: This option enables support for running scripts through an -//config: interpreter. Turn this on if you want PHP scripts to work -//config: properly. You need to supply an additional line in your -//config: httpd.conf file: -//config: *.php:/path/to/your/php +//config: This option enables support for running scripts through an +//config: interpreter. Turn this on if you want PHP scripts to work +//config: properly. You need to supply an additional line in your +//config: httpd.conf file: +//config: *.php:/path/to/your/php //config: //config:config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV //config: bool "Set REMOTE_PORT environment variable for CGI" //config: default y //config: depends on FEATURE_HTTPD_CGI //config: help -//config: Use of this option can assist scripts in generating -//config: references that contain a unique port number. +//config: Use of this option can assist scripts in generating +//config: references that contain a unique port number. //config: //config:config FEATURE_HTTPD_ENCODE_URL_STR //config: bool "Enable -e option (useful for CGIs written as shell scripts)" //config: default y //config: depends on HTTPD //config: help -//config: This option allows html encoding of arbitrary strings for display -//config: by the browser. Output goes to stdout. -//config: For example, httpd -e "" produces -//config: "<Hello World>". +//config: This option allows html encoding of arbitrary strings for display +//config: by the browser. Output goes to stdout. +//config: For example, httpd -e "" produces +//config: "<Hello World>". //config: //config:config FEATURE_HTTPD_ERROR_PAGES //config: bool "Support custom error pages" //config: default y //config: depends on HTTPD //config: help -//config: This option allows you to define custom error pages in -//config: the configuration file instead of the default HTTP status -//config: error pages. For instance, if you add the line: -//config: E404:/path/e404.html -//config: in the config file, the server will respond the specified -//config: '/path/e404.html' file instead of the terse '404 NOT FOUND' -//config: message. +//config: This option allows you to define custom error pages in +//config: the configuration file instead of the default HTTP status +//config: error pages. For instance, if you add the line: +//config: E404:/path/e404.html +//config: in the config file, the server will respond the specified +//config: '/path/e404.html' file instead of the terse '404 NOT FOUND' +//config: message. //config: //config:config FEATURE_HTTPD_PROXY //config: bool "Support reverse proxy" //config: default y //config: depends on HTTPD //config: help -//config: This option allows you to define URLs that will be forwarded -//config: to another HTTP server. To setup add the following line to the -//config: configuration file -//config: P:/url/:http://hostname[:port]/new/path/ -//config: Then a request to /url/myfile will be forwarded to -//config: http://hostname[:port]/new/path/myfile. +//config: This option allows you to define URLs that will be forwarded +//config: to another HTTP server. To setup add the following line to the +//config: configuration file +//config: P:/url/:http://hostname[:port]/new/path/ +//config: Then a request to /url/myfile will be forwarded to +//config: http://hostname[:port]/new/path/myfile. //config: //config:config FEATURE_HTTPD_GZIP //config: bool "Support GZIP content encoding" //config: default y //config: depends on HTTPD //config: help -//config: Makes httpd send files using GZIP content encoding if the -//config: client supports it and a pre-compressed .gz exists. +//config: Makes httpd send files using GZIP content encoding if the +//config: client supports it and a pre-compressed .gz exists. //applet:IF_HTTPD(APPLET(httpd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ifconfig.c b/networking/ifconfig.c index a08a0a18d..d1e9c58dc 100644 --- a/networking/ifconfig.c +++ b/networking/ifconfig.c @@ -30,48 +30,48 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Ifconfig is used to configure the kernel-resident network interfaces. +//config: Ifconfig is used to configure the kernel-resident network interfaces. //config: //config:config FEATURE_IFCONFIG_STATUS //config: bool "Enable status reporting output (+7k)" //config: default y //config: depends on IFCONFIG //config: help -//config: If ifconfig is called with no arguments it will display the status -//config: of the currently active interfaces. +//config: If ifconfig is called with no arguments it will display the status +//config: of the currently active interfaces. //config: //config:config FEATURE_IFCONFIG_SLIP //config: bool "Enable slip-specific options \"keepalive\" and \"outfill\"" //config: default y //config: depends on IFCONFIG //config: help -//config: Allow "keepalive" and "outfill" support for SLIP. If you're not -//config: planning on using serial lines, leave this unchecked. +//config: Allow "keepalive" and "outfill" support for SLIP. If you're not +//config: planning on using serial lines, leave this unchecked. //config: //config:config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ //config: bool "Enable options \"mem_start\", \"io_addr\", and \"irq\"" //config: default y //config: depends on IFCONFIG //config: help -//config: Allow the start address for shared memory, start address for I/O, -//config: and/or the interrupt line used by the specified device. +//config: Allow the start address for shared memory, start address for I/O, +//config: and/or the interrupt line used by the specified device. //config: //config:config FEATURE_IFCONFIG_HW //config: bool "Enable option \"hw\" (ether only)" //config: default y //config: depends on IFCONFIG //config: help -//config: Set the hardware address of this interface, if the device driver -//config: supports this operation. Currently, we only support the 'ether' -//config: class. +//config: Set the hardware address of this interface, if the device driver +//config: supports this operation. Currently, we only support the 'ether' +//config: class. //config: //config:config FEATURE_IFCONFIG_BROADCAST_PLUS //config: bool "Set the broadcast automatically" //config: default y //config: depends on IFCONFIG //config: help -//config: Setting this will make ifconfig attempt to find the broadcast -//config: automatically if the value '+' is used. +//config: Setting this will make ifconfig attempt to find the broadcast +//config: automatically if the value '+' is used. //applet:IF_IFCONFIG(APPLET(ifconfig, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/ifenslave.c b/networking/ifenslave.c index 7619fc376..26e5e8cf3 100644 --- a/networking/ifenslave.c +++ b/networking/ifenslave.c @@ -102,8 +102,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Userspace application to bind several interfaces -//config: to a logical interface (use with kernel bonding driver). +//config: Userspace application to bind several interfaces +//config: to a logical interface (use with kernel bonding driver). //applet:IF_IFENSLAVE(APPLET(ifenslave, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/ifplugd.c b/networking/ifplugd.c index 635417e05..c36bc9524 100644 --- a/networking/ifplugd.c +++ b/networking/ifplugd.c @@ -11,7 +11,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Network interface plug detection daemon. +//config: Network interface plug detection daemon. //applet:IF_IFPLUGD(APPLET(ifplugd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ifupdown.c b/networking/ifupdown.c index e067543fa..f8c29ab00 100644 --- a/networking/ifupdown.c +++ b/networking/ifupdown.c @@ -21,63 +21,63 @@ //config: bool "ifup (17 kb)" //config: default y //config: help -//config: Activate the specified interfaces. This applet makes use -//config: of either "ifconfig" and "route" or the "ip" command to actually -//config: configure network interfaces. Therefore, you will probably also want -//config: to enable either IFCONFIG and ROUTE, or enable -//config: FEATURE_IFUPDOWN_IP and the various IP options. Of -//config: course you could use non-busybox versions of these programs, so -//config: against my better judgement (since this will surely result in plenty -//config: of support questions on the mailing list), I do not force you to -//config: enable these additional options. It is up to you to supply either -//config: "ifconfig", "route" and "run-parts" or the "ip" command, either -//config: via busybox or via standalone utilities. +//config: Activate the specified interfaces. This applet makes use +//config: of either "ifconfig" and "route" or the "ip" command to actually +//config: configure network interfaces. Therefore, you will probably also want +//config: to enable either IFCONFIG and ROUTE, or enable +//config: FEATURE_IFUPDOWN_IP and the various IP options. Of +//config: course you could use non-busybox versions of these programs, so +//config: against my better judgement (since this will surely result in plenty +//config: of support questions on the mailing list), I do not force you to +//config: enable these additional options. It is up to you to supply either +//config: "ifconfig", "route" and "run-parts" or the "ip" command, either +//config: via busybox or via standalone utilities. //config: //config:config IFDOWN //config: bool "ifdown (15 kb)" //config: default y //config: help -//config: Deactivate the specified interfaces. +//config: Deactivate the specified interfaces. //config: //config:config IFUPDOWN_IFSTATE_PATH //config: string "Absolute path to ifstate file" //config: default "/var/run/ifstate" //config: depends on IFUP || IFDOWN //config: help -//config: ifupdown keeps state information in a file called ifstate. -//config: Typically it is located in /var/run/ifstate, however -//config: some distributions tend to put it in other places -//config: (debian, for example, uses /etc/network/run/ifstate). -//config: This config option defines location of ifstate. +//config: ifupdown keeps state information in a file called ifstate. +//config: Typically it is located in /var/run/ifstate, however +//config: some distributions tend to put it in other places +//config: (debian, for example, uses /etc/network/run/ifstate). +//config: This config option defines location of ifstate. //config: //config:config FEATURE_IFUPDOWN_IP //config: bool "Use ip tool (else ifconfig/route is used)" //config: default y //config: depends on IFUP || IFDOWN //config: help -//config: Use the iproute "ip" command to implement "ifup" and "ifdown", rather -//config: than the default of using the older "ifconfig" and "route" utilities. +//config: Use the iproute "ip" command to implement "ifup" and "ifdown", rather +//config: than the default of using the older "ifconfig" and "route" utilities. //config: -//config: If Y: you must install either the full-blown iproute2 package -//config: or enable "ip" applet in Busybox, or the "ifup" and "ifdown" applets -//config: will not work. +//config: If Y: you must install either the full-blown iproute2 package +//config: or enable "ip" applet in Busybox, or the "ifup" and "ifdown" applets +//config: will not work. //config: -//config: If N: you must install either the full-blown ifconfig and route -//config: utilities, or enable these applets in Busybox. +//config: If N: you must install either the full-blown ifconfig and route +//config: utilities, or enable these applets in Busybox. //config: //config:config FEATURE_IFUPDOWN_IPV4 //config: bool "Support IPv4" //config: default y //config: depends on IFUP || IFDOWN //config: help -//config: If you want ifup/ifdown to talk IPv4, leave this on. +//config: If you want ifup/ifdown to talk IPv4, leave this on. //config: //config:config FEATURE_IFUPDOWN_IPV6 //config: bool "Support IPv6" //config: default y //config: depends on (IFUP || IFDOWN) && FEATURE_IPV6 //config: help -//config: If you need support for IPv6, turn this option on. +//config: If you need support for IPv6, turn this option on. //config: //UNUSED: ////////:config FEATURE_IFUPDOWN_IPX @@ -93,18 +93,18 @@ //config: default y //config: depends on IFUP || IFDOWN //config: help -//config: This enables support for the "mapping" stanza, unless you have -//config: a weird network setup you don't need it. +//config: This enables support for the "mapping" stanza, unless you have +//config: a weird network setup you don't need it. //config: //config:config FEATURE_IFUPDOWN_EXTERNAL_DHCP //config: bool "Support external DHCP clients" //config: default n //config: depends on IFUP || IFDOWN //config: help -//config: This enables support for the external dhcp clients. Clients are -//config: tried in the following order: dhcpcd, dhclient, pump and udhcpc. -//config: Otherwise, if udhcpc applet is enabled, it is used. -//config: Otherwise, ifup/ifdown will have no support for DHCP. +//config: This enables support for the external dhcp clients. Clients are +//config: tried in the following order: dhcpcd, dhclient, pump and udhcpc. +//config: Otherwise, if udhcpc applet is enabled, it is used. +//config: Otherwise, ifup/ifdown will have no support for DHCP. // APPLET_ODDNAME:name main location suid_type help //applet:IF_IFUP( APPLET_ODDNAME(ifup, ifupdown, BB_DIR_SBIN, BB_SUID_DROP, ifup)) diff --git a/networking/inetd.c b/networking/inetd.c index 9a9956857..2991edc09 100644 --- a/networking/inetd.c +++ b/networking/inetd.c @@ -158,42 +158,42 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: Internet superserver daemon +//config: Internet superserver daemon //config: //config:config FEATURE_INETD_SUPPORT_BUILTIN_ECHO //config: bool "Support echo service" //config: default y //config: depends on INETD //config: help -//config: Echo received data internal inetd service +//config: Echo received data internal inetd service //config: //config:config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD //config: bool "Support discard service" //config: default y //config: depends on INETD //config: help -//config: Internet /dev/null internal inetd service +//config: Internet /dev/null internal inetd service //config: //config:config FEATURE_INETD_SUPPORT_BUILTIN_TIME //config: bool "Support time service" //config: default y //config: depends on INETD //config: help -//config: Return 32 bit time since 1900 internal inetd service +//config: Return 32 bit time since 1900 internal inetd service //config: //config:config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME //config: bool "Support daytime service" //config: default y //config: depends on INETD //config: help -//config: Return human-readable time internal inetd service +//config: Return human-readable time internal inetd service //config: //config:config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN //config: bool "Support chargen service" //config: default y //config: depends on INETD //config: help -//config: Familiar character generator internal inetd service +//config: Familiar character generator internal inetd service //config: //config:config FEATURE_INETD_RPC //config: bool "Support RPC services" @@ -201,7 +201,7 @@ //config: depends on INETD //config: select FEATURE_HAVE_RPC //config: help -//config: Support Sun-RPC based services +//config: Support Sun-RPC based services //applet:IF_INETD(APPLET(inetd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ip.c b/networking/ip.c index de3a65bae..cca7cbe12 100644 --- a/networking/ip.c +++ b/networking/ip.c @@ -13,9 +13,9 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The "ip" applet is a TCP/IP interface configuration and routing -//config: utility. You generally don't need "ip" to use busybox with -//config: TCP/IP. +//config: The "ip" applet is a TCP/IP interface configuration and routing +//config: utility. You generally don't need "ip" to use busybox with +//config: TCP/IP. //config: //config:config IPADDR //config: bool "ipaddr (14 kb)" @@ -23,7 +23,7 @@ //config: select FEATURE_IP_ADDRESS //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip addr: ipaddr +//config: Support short form of ip addr: ipaddr //config: //config:config IPLINK //config: bool "iplink (16 kb)" @@ -31,7 +31,7 @@ //config: select FEATURE_IP_LINK //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip link: iplink +//config: Support short form of ip link: iplink //config: //config:config IPROUTE //config: bool "iproute (15 kb)" @@ -39,7 +39,7 @@ //config: select FEATURE_IP_ROUTE //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip route: iproute +//config: Support short form of ip route: iproute //config: //config:config IPTUNNEL //config: bool "iptunnel (9.6 kb)" @@ -47,7 +47,7 @@ //config: select FEATURE_IP_TUNNEL //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip tunnel: iptunnel +//config: Support short form of ip tunnel: iptunnel //config: //config:config IPRULE //config: bool "iprule (10 kb)" @@ -55,7 +55,7 @@ //config: select FEATURE_IP_RULE //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip rule: iprule +//config: Support short form of ip rule: iprule //config: //config:config IPNEIGH //config: bool "ipneigh (8.3 kb)" @@ -63,66 +63,66 @@ //config: select FEATURE_IP_NEIGH //config: select PLATFORM_LINUX //config: help -//config: Support short form of ip neigh: ipneigh +//config: Support short form of ip neigh: ipneigh //config: //config:config FEATURE_IP_ADDRESS //config: bool "ip address" //config: default y //config: depends on IP || IPADDR //config: help -//config: Address manipulation support for the "ip" applet. +//config: Address manipulation support for the "ip" applet. //config: //config:config FEATURE_IP_LINK //config: bool "ip link" //config: default y //config: depends on IP || IPLINK //config: help -//config: Configure network devices with "ip". +//config: Configure network devices with "ip". //config: //config:config FEATURE_IP_ROUTE //config: bool "ip route" //config: default y //config: depends on IP || IPROUTE //config: help -//config: Add support for routing table management to "ip". +//config: Add support for routing table management to "ip". //config: //config:config FEATURE_IP_ROUTE_DIR //config: string "ip route configuration directory" //config: default "/etc/iproute2" //config: depends on FEATURE_IP_ROUTE //config: help -//config: Location of the "ip" applet routing configuration. +//config: Location of the "ip" applet routing configuration. //config: //config:config FEATURE_IP_TUNNEL //config: bool "ip tunnel" //config: default y //config: depends on IP || IPTUNNEL //config: help -//config: Add support for tunneling commands to "ip". +//config: Add support for tunneling commands to "ip". //config: //config:config FEATURE_IP_RULE //config: bool "ip rule" //config: default y //config: depends on IP || IPRULE //config: help -//config: Add support for rule commands to "ip". +//config: Add support for rule commands to "ip". //config: //config:config FEATURE_IP_NEIGH //config: bool "ip neighbor" //config: default y //config: depends on IP || IPNEIGH //config: help -//config: Add support for neighbor commands to "ip". +//config: Add support for neighbor commands to "ip". //config: //config:config FEATURE_IP_RARE_PROTOCOLS //config: bool "Support displaying rarely used link types" //config: default n //config: depends on IP || IPADDR || IPLINK || IPROUTE || IPTUNNEL || IPRULE || IPNEIGH //config: help -//config: If you are not going to use links of type "frad", "econet", -//config: "bif" etc, you probably don't need to enable this. -//config: Ethernet, wireless, infrared, ppp/slip, ip tunnelling -//config: link types are supported without this option selected. +//config: If you are not going to use links of type "frad", "econet", +//config: "bif" etc, you probably don't need to enable this. +//config: Ethernet, wireless, infrared, ppp/slip, ip tunnelling +//config: link types are supported without this option selected. //applet:IF_IP(APPLET(ip, BB_DIR_SBIN, BB_SUID_DROP)) //applet:IF_IPADDR(APPLET(ipaddr, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/ipcalc.c b/networking/ipcalc.c index 5975e6fd7..9888a6ff2 100644 --- a/networking/ipcalc.c +++ b/networking/ipcalc.c @@ -15,8 +15,8 @@ //config: bool "ipcalc (4.3 kb)" //config: default y //config: help -//config: ipcalc takes an IP address and netmask and calculates the -//config: resulting broadcast, network, and host range. +//config: ipcalc takes an IP address and netmask and calculates the +//config: resulting broadcast, network, and host range. //config: //config:config FEATURE_IPCALC_LONG_OPTIONS //config: bool "Enable long options" @@ -28,8 +28,8 @@ //config: default y //config: depends on IPCALC //config: help -//config: Adds the options hostname, prefix and silent to the output of -//config: "ipcalc". +//config: Adds the options hostname, prefix and silent to the output of +//config: "ipcalc". //applet:IF_IPCALC(APPLET(ipcalc, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/networking/isrv_identd.c b/networking/isrv_identd.c index 3384fddf2..133d62a65 100644 --- a/networking/isrv_identd.c +++ b/networking/isrv_identd.c @@ -11,8 +11,8 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: fakeidentd listens on the ident port and returns a predefined -//config: fake value on any query. +//config: fakeidentd listens on the ident port and returns a predefined +//config: fake value on any query. //applet:IF_FAKEIDENTD(APPLET(fakeidentd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/nameif.c b/networking/nameif.c index e65aef417..31ee98a39 100644 --- a/networking/nameif.c +++ b/networking/nameif.c @@ -16,29 +16,29 @@ //config: select PLATFORM_LINUX //config: select FEATURE_SYSLOG //config: help -//config: nameif is used to rename network interface by its MAC address. -//config: Renamed interfaces MUST be in the down state. -//config: It is possible to use a file (default: /etc/mactab) -//config: with list of new interface names and MACs. -//config: Maximum interface name length: IFNAMSIZ = 16 -//config: File fields are separated by space or tab. -//config: File format: -//config: # Comment -//config: new_interface_name XX:XX:XX:XX:XX:XX +//config: nameif is used to rename network interface by its MAC address. +//config: Renamed interfaces MUST be in the down state. +//config: It is possible to use a file (default: /etc/mactab) +//config: with list of new interface names and MACs. +//config: Maximum interface name length: IFNAMSIZ = 16 +//config: File fields are separated by space or tab. +//config: File format: +//config: # Comment +//config: new_interface_name XX:XX:XX:XX:XX:XX //config: //config:config FEATURE_NAMEIF_EXTENDED //config: bool "Extended nameif" //config: default y //config: depends on NAMEIF //config: help -//config: This extends the nameif syntax to support the bus_info, driver, -//config: phyaddr selectors. The syntax is compatible to the normal nameif. -//config: File format: -//config: new_interface_name driver=asix bus=usb-0000:00:08.2-3 -//config: new_interface_name bus=usb-0000:00:08.2-3 00:80:C8:38:91:B5 -//config: new_interface_name phy_address=2 00:80:C8:38:91:B5 -//config: new_interface_name mac=00:80:C8:38:91:B5 -//config: new_interface_name 00:80:C8:38:91:B5 +//config: This extends the nameif syntax to support the bus_info, driver, +//config: phyaddr selectors. The syntax is compatible to the normal nameif. +//config: File format: +//config: new_interface_name driver=asix bus=usb-0000:00:08.2-3 +//config: new_interface_name bus=usb-0000:00:08.2-3 00:80:C8:38:91:B5 +//config: new_interface_name phy_address=2 00:80:C8:38:91:B5 +//config: new_interface_name mac=00:80:C8:38:91:B5 +//config: new_interface_name 00:80:C8:38:91:B5 //applet:IF_NAMEIF(APPLET(nameif, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/nbd-client.c b/networking/nbd-client.c index ca71e4232..a5e25e6aa 100644 --- a/networking/nbd-client.c +++ b/networking/nbd-client.c @@ -15,7 +15,7 @@ //config: bool "nbd-client (4.6 kb)" //config: default y //config: help -//config: Network block device client +//config: Network block device client #define NBD_SET_SOCK _IO(0xab, 0) #define NBD_SET_BLKSIZE _IO(0xab, 1) diff --git a/networking/nc.c b/networking/nc.c index ac80d425a..a13d77a00 100644 --- a/networking/nc.c +++ b/networking/nc.c @@ -10,34 +10,34 @@ //config: bool "nc (11 kb)" //config: default y //config: help -//config: A simple Unix utility which reads and writes data across network -//config: connections. +//config: A simple Unix utility which reads and writes data across network +//config: connections. //config: //config:config NC_SERVER //config: bool "Netcat server options (-l)" //config: default y //config: depends on NC //config: help -//config: Allow netcat to act as a server. +//config: Allow netcat to act as a server. //config: //config:config NC_EXTRA //config: bool "Netcat extensions (-eiw and -f FILE)" //config: default y //config: depends on NC //config: help -//config: Add -e (support for executing the rest of the command line after -//config: making or receiving a successful connection), -i (delay interval for -//config: lines sent), -w (timeout for initial connection). +//config: Add -e (support for executing the rest of the command line after +//config: making or receiving a successful connection), -i (delay interval for +//config: lines sent), -w (timeout for initial connection). //config: //config:config NC_110_COMPAT //config: bool "Netcat 1.10 compatibility (+2.5k)" //config: default n # off specially for Rob //config: depends on NC //config: help -//config: This option makes nc closely follow original nc-1.10. -//config: The code is about 2.5k bigger. It enables -//config: -s ADDR, -n, -u, -v, -o FILE, -z options, but loses -//config: busybox-specific extensions: -f FILE. +//config: This option makes nc closely follow original nc-1.10. +//config: The code is about 2.5k bigger. It enables +//config: -s ADDR, -n, -u, -v, -o FILE, -z options, but loses +//config: busybox-specific extensions: -f FILE. //applet:IF_NC(APPLET(nc, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/netstat.c b/networking/netstat.c index 003c2ba6f..33281e333 100644 --- a/networking/netstat.c +++ b/networking/netstat.c @@ -18,23 +18,23 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: netstat prints information about the Linux networking subsystem. +//config: netstat prints information about the Linux networking subsystem. //config: //config:config FEATURE_NETSTAT_WIDE //config: bool "Enable wide output" //config: default y //config: depends on NETSTAT //config: help -//config: Add support for wide columns. Useful when displaying IPv6 addresses -//config: (-W option). +//config: Add support for wide columns. Useful when displaying IPv6 addresses +//config: (-W option). //config: //config:config FEATURE_NETSTAT_PRG //config: bool "Enable PID/Program name output" //config: default y //config: depends on NETSTAT //config: help -//config: Add support for -p flag to print out PID and program name. -//config: +700 bytes of code. +//config: Add support for -p flag to print out PID and program name. +//config: +700 bytes of code. //applet:IF_NETSTAT(APPLET(netstat, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/networking/nslookup.c b/networking/nslookup.c index 4e479730c..45c218e6c 100644 --- a/networking/nslookup.c +++ b/networking/nslookup.c @@ -14,7 +14,7 @@ //config: bool "nslookup (4.5 kb)" //config: default y //config: help -//config: nslookup is a tool to query Internet name servers. +//config: nslookup is a tool to query Internet name servers. //applet:IF_NSLOOKUP(APPLET(nslookup, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/ntpd.c b/networking/ntpd.c index fdcb27fb2..f21f9513d 100644 --- a/networking/ntpd.c +++ b/networking/ntpd.c @@ -45,23 +45,23 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The NTP client/server daemon. +//config: The NTP client/server daemon. //config: //config:config FEATURE_NTPD_SERVER //config: bool "Make ntpd usable as a NTP server" //config: default y //config: depends on NTPD //config: help -//config: Make ntpd usable as a NTP server. If you disable this option -//config: ntpd will be usable only as a NTP client. +//config: Make ntpd usable as a NTP server. If you disable this option +//config: ntpd will be usable only as a NTP client. //config: //config:config FEATURE_NTPD_CONF //config: bool "Make ntpd understand /etc/ntp.conf" //config: default y //config: depends on NTPD //config: help -//config: Make ntpd look in /etc/ntp.conf for peers. Only "server address" -//config: is supported. +//config: Make ntpd look in /etc/ntp.conf for peers. Only "server address" +//config: is supported. //applet:IF_NTPD(APPLET(ntpd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/ping.c b/networking/ping.c index 31a085984..cdfb297e9 100644 --- a/networking/ping.c +++ b/networking/ping.c @@ -51,23 +51,23 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to -//config: elicit an ICMP ECHO_RESPONSE from a host or gateway. +//config: ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to +//config: elicit an ICMP ECHO_RESPONSE from a host or gateway. //config: //config:config PING6 //config: bool "ping6 (10 kb)" //config: default y //config: depends on FEATURE_IPV6 //config: help -//config: Alias to "ping -6". +//config: Alias to "ping -6". //config: //config:config FEATURE_FANCY_PING //config: bool "Enable fancy ping output" //config: default y //config: depends on PING || PING6 //config: help -//config: Make the output from the ping applet include statistics, and at the -//config: same time provide full support for ICMP packets. +//config: Make the output from the ping applet include statistics, and at the +//config: same time provide full support for ICMP packets. /* Needs socket(AF_INET, SOCK_RAW, IPPROTO_ICMP), therefore BB_SUID_MAYBE: */ //applet:IF_PING(APPLET(ping, BB_DIR_BIN, BB_SUID_MAYBE)) diff --git a/networking/pscan.c b/networking/pscan.c index 2859ff30f..17985d2c8 100644 --- a/networking/pscan.c +++ b/networking/pscan.c @@ -9,7 +9,7 @@ //config: bool "pscan (6.6 kb)" //config: default y //config: help -//config: Simple network port scanner. +//config: Simple network port scanner. //applet:IF_PSCAN(APPLET(pscan, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/route.c b/networking/route.c index 38b95b2f2..32789eecc 100644 --- a/networking/route.c +++ b/networking/route.c @@ -29,7 +29,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Route displays or manipulates the kernel's IP routing tables. +//config: Route displays or manipulates the kernel's IP routing tables. //applet:IF_ROUTE(APPLET(route, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/slattach.c b/networking/slattach.c index 3be5bd27e..71b5bf427 100644 --- a/networking/slattach.c +++ b/networking/slattach.c @@ -17,8 +17,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: slattach is a small utility to attach network interfaces to serial -//config: lines. +//config: slattach is a small utility to attach network interfaces to serial +//config: lines. //applet:IF_SLATTACH(APPLET(slattach, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/ssl_client.c b/networking/ssl_client.c index 6cbdafbfa..d479846d7 100644 --- a/networking/ssl_client.c +++ b/networking/ssl_client.c @@ -8,7 +8,7 @@ //config: default y //config: select TLS //config: help -//config: This tool pipes data to/from a socket, TLS-encrypting it. +//config: This tool pipes data to/from a socket, TLS-encrypting it. //applet:IF_SSL_CLIENT(APPLET(ssl_client, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/tcpudp.c b/networking/tcpudp.c index b970c4723..270325164 100644 --- a/networking/tcpudp.c +++ b/networking/tcpudp.c @@ -32,15 +32,15 @@ //config: bool "tcpsvd (13 kb)" //config: default y //config: help -//config: tcpsvd listens on a TCP port and runs a program for each new -//config: connection. +//config: tcpsvd listens on a TCP port and runs a program for each new +//config: connection. //config: //config:config UDPSVD //config: bool "udpsvd (13 kb)" //config: default y //config: help -//config: udpsvd listens on an UDP port and runs a program for each new -//config: connection. +//config: udpsvd listens on an UDP port and runs a program for each new +//config: connection. //applet:IF_TCPSVD(APPLET_ODDNAME(tcpsvd, tcpudpsvd, BB_DIR_USR_BIN, BB_SUID_DROP, tcpsvd)) //applet:IF_UDPSVD(APPLET_ODDNAME(udpsvd, tcpudpsvd, BB_DIR_USR_BIN, BB_SUID_DROP, udpsvd)) diff --git a/networking/telnet.c b/networking/telnet.c index 1c4811d5d..9f191f7ad 100644 --- a/networking/telnet.c +++ b/networking/telnet.c @@ -24,27 +24,27 @@ //config: bool "telnet (8.7 kb)" //config: default y //config: help -//config: Telnet is an interface to the TELNET protocol, but is also commonly -//config: used to test other simple protocols. +//config: Telnet is an interface to the TELNET protocol, but is also commonly +//config: used to test other simple protocols. //config: //config:config FEATURE_TELNET_TTYPE //config: bool "Pass TERM type to remote host" //config: default y //config: depends on TELNET //config: help -//config: Setting this option will forward the TERM environment variable to the -//config: remote host you are connecting to. This is useful to make sure that -//config: things like ANSI colors and other control sequences behave. +//config: Setting this option will forward the TERM environment variable to the +//config: remote host you are connecting to. This is useful to make sure that +//config: things like ANSI colors and other control sequences behave. //config: //config:config FEATURE_TELNET_AUTOLOGIN //config: bool "Pass USER type to remote host" //config: default y //config: depends on TELNET //config: help -//config: Setting this option will forward the USER environment variable to the -//config: remote host you are connecting to. This is useful when you need to -//config: log into a machine without telling the username (autologin). This -//config: option enables `-a' and `-l USER' arguments. +//config: Setting this option will forward the USER environment variable to the +//config: remote host you are connecting to. This is useful when you need to +//config: log into a machine without telling the username (autologin). This +//config: option enables `-a' and `-l USER' arguments. //config: //config:config FEATURE_TELNET_WIDTH //config: bool "Enable window size autodetection" diff --git a/networking/telnetd.c b/networking/telnetd.c index b617c2889..6e12de07a 100644 --- a/networking/telnetd.c +++ b/networking/telnetd.c @@ -25,69 +25,69 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: A daemon for the TELNET protocol, allowing you to log onto the host -//config: running the daemon. Please keep in mind that the TELNET protocol -//config: sends passwords in plain text. If you can't afford the space for an -//config: SSH daemon and you trust your network, you may say 'y' here. As a -//config: more secure alternative, you should seriously consider installing the -//config: very small Dropbear SSH daemon instead: +//config: A daemon for the TELNET protocol, allowing you to log onto the host +//config: running the daemon. Please keep in mind that the TELNET protocol +//config: sends passwords in plain text. If you can't afford the space for an +//config: SSH daemon and you trust your network, you may say 'y' here. As a +//config: more secure alternative, you should seriously consider installing the +//config: very small Dropbear SSH daemon instead: //config: http://matt.ucc.asn.au/dropbear/dropbear.html //config: -//config: Note that for busybox telnetd to work you need several things: -//config: First of all, your kernel needs: +//config: Note that for busybox telnetd to work you need several things: +//config: First of all, your kernel needs: //config: CONFIG_UNIX98_PTYS=y //config: -//config: Next, you need a /dev/pts directory on your root filesystem: +//config: Next, you need a /dev/pts directory on your root filesystem: //config: //config: $ ls -ld /dev/pts //config: drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/ //config: -//config: Next you need the pseudo terminal master multiplexer /dev/ptmx: +//config: Next you need the pseudo terminal master multiplexer /dev/ptmx: //config: //config: $ ls -la /dev/ptmx //config: crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx //config: -//config: Any /dev/ttyp[0-9]* files you may have can be removed. -//config: Next, you need to mount the devpts filesystem on /dev/pts using: +//config: Any /dev/ttyp[0-9]* files you may have can be removed. +//config: Next, you need to mount the devpts filesystem on /dev/pts using: //config: //config: mount -t devpts devpts /dev/pts //config: -//config: You need to be sure that busybox has LOGIN and -//config: FEATURE_SUID enabled. And finally, you should make -//config: certain that Busybox has been installed setuid root: +//config: You need to be sure that busybox has LOGIN and +//config: FEATURE_SUID enabled. And finally, you should make +//config: certain that Busybox has been installed setuid root: //config: //config: chown root.root /bin/busybox //config: chmod 4755 /bin/busybox //config: -//config: with all that done, telnetd _should_ work.... +//config: with all that done, telnetd _should_ work.... //config: //config:config FEATURE_TELNETD_STANDALONE //config: bool "Support standalone telnetd (not inetd only)" //config: default y //config: depends on TELNETD //config: help -//config: Selecting this will make telnetd able to run standalone. +//config: Selecting this will make telnetd able to run standalone. //config: //config:config FEATURE_TELNETD_INETD_WAIT //config: bool "Support -w SEC option (inetd wait mode)" //config: default y //config: depends on FEATURE_TELNETD_STANDALONE //config: help -//config: This option allows you to run telnetd in "inet wait" mode. -//config: Example inetd.conf line (note "wait", not usual "nowait"): +//config: This option allows you to run telnetd in "inet wait" mode. +//config: Example inetd.conf line (note "wait", not usual "nowait"): //config: -//config: telnet stream tcp wait root /bin/telnetd telnetd -w10 +//config: telnet stream tcp wait root /bin/telnetd telnetd -w10 //config: -//config: In this example, inetd passes _listening_ socket_ as fd 0 -//config: to telnetd when connection appears. -//config: telnetd will wait for connections until all existing -//config: connections are closed, and no new connections -//config: appear during 10 seconds. Then it exits, and inetd continues -//config: to listen for new connections. +//config: In this example, inetd passes _listening_ socket_ as fd 0 +//config: to telnetd when connection appears. +//config: telnetd will wait for connections until all existing +//config: connections are closed, and no new connections +//config: appear during 10 seconds. Then it exits, and inetd continues +//config: to listen for new connections. //config: -//config: This option is rarely used. "tcp nowait" is much more usual -//config: way of running tcp services, including telnetd. -//config: You most probably want to say N here. +//config: This option is rarely used. "tcp nowait" is much more usual +//config: way of running tcp services, including telnetd. +//config: You most probably want to say N here. //applet:IF_TELNETD(APPLET(telnetd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/networking/tftp.c b/networking/tftp.c index 3fe1fcb82..947e65169 100644 --- a/networking/tftp.c +++ b/networking/tftp.c @@ -22,19 +22,19 @@ //config: bool "tftp (12 kb)" //config: default y //config: help -//config: This enables the Trivial File Transfer Protocol client program. TFTP -//config: is usually used for simple, small transfers such as a root image -//config: for a network-enabled bootloader. +//config: This enables the Trivial File Transfer Protocol client program. TFTP +//config: is usually used for simple, small transfers such as a root image +//config: for a network-enabled bootloader. //config: //config:config TFTPD //config: bool "tftpd (10 kb)" //config: default y //config: help -//config: This enables the Trivial File Transfer Protocol server program. -//config: It expects that stdin is a datagram socket and a packet -//config: is already pending on it. It will exit after one transfer. -//config: In other words: it should be run from inetd in nowait mode, -//config: or from udpsvd. Example: "udpsvd -E 0 69 tftpd DIR" +//config: This enables the Trivial File Transfer Protocol server program. +//config: It expects that stdin is a datagram socket and a packet +//config: is already pending on it. It will exit after one transfer. +//config: In other words: it should be run from inetd in nowait mode, +//config: or from udpsvd. Example: "udpsvd -E 0 69 tftpd DIR" //config: //config:comment "Common options for tftp/tftpd" //config: depends on TFTP || TFTPD @@ -44,29 +44,29 @@ //config: default y //config: depends on TFTP || TFTPD //config: help -//config: Add support for the GET command within the TFTP client. This allows -//config: a client to retrieve a file from a TFTP server. -//config: Also enable upload support in tftpd, if tftpd is selected. +//config: Add support for the GET command within the TFTP client. This allows +//config: a client to retrieve a file from a TFTP server. +//config: Also enable upload support in tftpd, if tftpd is selected. //config: -//config: Note: this option does _not_ make tftpd capable of download -//config: (the usual operation people need from it)! +//config: Note: this option does _not_ make tftpd capable of download +//config: (the usual operation people need from it)! //config: //config:config FEATURE_TFTP_PUT //config: bool "Enable 'tftp put' and/or tftpd download code" //config: default y //config: depends on TFTP || TFTPD //config: help -//config: Add support for the PUT command within the TFTP client. This allows -//config: a client to transfer a file to a TFTP server. -//config: Also enable download support in tftpd, if tftpd is selected. +//config: Add support for the PUT command within the TFTP client. This allows +//config: a client to transfer a file to a TFTP server. +//config: Also enable download support in tftpd, if tftpd is selected. //config: //config:config FEATURE_TFTP_BLOCKSIZE //config: bool "Enable 'blksize' and 'tsize' protocol options" //config: default y //config: depends on TFTP || TFTPD //config: help -//config: Allow tftp to specify block size, and tftpd to understand -//config: "blksize" and "tsize" options. +//config: Allow tftp to specify block size, and tftpd to understand +//config: "blksize" and "tsize" options. //config: //config:config FEATURE_TFTP_PROGRESS_BAR //config: bool "Enable progress bar" @@ -78,8 +78,8 @@ //config: default n //config: depends on TFTP || TFTPD //config: help -//config: Make tftp[d] print debugging messages on stderr. -//config: This is useful if you are diagnosing a bug in tftp[d]. +//config: Make tftp[d] print debugging messages on stderr. +//config: This is useful if you are diagnosing a bug in tftp[d]. //applet:#if ENABLE_FEATURE_TFTP_GET || ENABLE_FEATURE_TFTP_PUT //applet:IF_TFTP(APPLET(tftp, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/traceroute.c b/networking/traceroute.c index 408f43c55..a958a2c6c 100644 --- a/networking/traceroute.c +++ b/networking/traceroute.c @@ -214,22 +214,22 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Utility to trace the route of IP packets. +//config: Utility to trace the route of IP packets. //config: //config:config TRACEROUTE6 //config: bool "traceroute6 (12 kb)" //config: default y //config: depends on FEATURE_IPV6 //config: help -//config: Utility to trace the route of IPv6 packets. +//config: Utility to trace the route of IPv6 packets. //config: //config:config FEATURE_TRACEROUTE_VERBOSE //config: bool "Enable verbose output" //config: default y //config: depends on TRACEROUTE || TRACEROUTE6 //config: help -//config: Add some verbosity to traceroute. This includes among other things -//config: hostnames and ICMP response types. +//config: Add some verbosity to traceroute. This includes among other things +//config: hostnames and ICMP response types. //config: //config:config FEATURE_TRACEROUTE_USE_ICMP //config: bool "Enable -I option (use ICMP instead of UDP)" diff --git a/networking/tunctl.c b/networking/tunctl.c index 97ee1961b..0a26ff7fb 100644 --- a/networking/tunctl.c +++ b/networking/tunctl.c @@ -14,15 +14,15 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: tunctl creates or deletes tun devices. +//config: tunctl creates or deletes tun devices. //config: //config:config FEATURE_TUNCTL_UG //config: bool "Support owner:group assignment" //config: default y //config: depends on TUNCTL //config: help -//config: Allow to specify owner and group of newly created interface. -//config: 340 bytes of pure bloat. Say no here. +//config: Allow to specify owner and group of newly created interface. +//config: 340 bytes of pure bloat. Say no here. //applet:IF_TUNCTL(APPLET(tunctl, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/udhcp/Config.src b/networking/udhcp/Config.src index 43f3676e4..af2fe1835 100644 --- a/networking/udhcp/Config.src +++ b/networking/udhcp/Config.src @@ -10,105 +10,105 @@ config UDHCPD default y select PLATFORM_LINUX help - udhcpd is a DHCP server geared primarily toward embedded systems, - while striving to be fully functional and RFC compliant. + udhcpd is a DHCP server geared primarily toward embedded systems, + while striving to be fully functional and RFC compliant. config FEATURE_UDHCPD_WRITE_LEASES_EARLY bool "Rewrite the lease file at every new acknowledge" default y depends on UDHCPD help - If selected, udhcpd will write a new file with leases every - time a new lease has been accepted, thus eliminating the need - to send SIGUSR1 for the initial writing or updating. Any timed - rewriting remains undisturbed. + If selected, udhcpd will write a new file with leases every + time a new lease has been accepted, thus eliminating the need + to send SIGUSR1 for the initial writing or updating. Any timed + rewriting remains undisturbed. config FEATURE_UDHCPD_BASE_IP_ON_MAC bool "Select IP address based on client MAC" default n depends on UDHCPD help - If selected, udhcpd will base its selection of IP address to offer - on the client's hardware address. Otherwise udhcpd uses the next - consecutive free address. + If selected, udhcpd will base its selection of IP address to offer + on the client's hardware address. Otherwise udhcpd uses the next + consecutive free address. - This reduces the frequency of IP address changes for clients - which let their lease expire, and makes consecutive DHCPOFFERS - for the same client to (almost always) contain the same - IP address. + This reduces the frequency of IP address changes for clients + which let their lease expire, and makes consecutive DHCPOFFERS + for the same client to (almost always) contain the same + IP address. config DHCPD_LEASES_FILE string "Absolute path to lease file" default "/var/lib/misc/udhcpd.leases" depends on UDHCPD help - udhcpd stores addresses in a lease file. This is the absolute path - of the file. Normally it is safe to leave it untouched. + udhcpd stores addresses in a lease file. This is the absolute path + of the file. Normally it is safe to leave it untouched. config DUMPLEASES bool "dumpleases (6.4 kb)" default y help - dumpleases displays the leases written out by the udhcpd. - Lease times are stored in the file by time remaining in lease, or - by the absolute time that it expires in seconds from epoch. + dumpleases displays the leases written out by the udhcpd. + Lease times are stored in the file by time remaining in lease, or + by the absolute time that it expires in seconds from epoch. config DHCPRELAY bool "dhcprelay (5.8 kb)" default y help - dhcprelay listens for dhcp requests on one or more interfaces - and forwards these requests to a different interface or dhcp - server. + dhcprelay listens for dhcp requests on one or more interfaces + and forwards these requests to a different interface or dhcp + server. config UDHCPC bool "udhcpc (DHCP client)" default y select PLATFORM_LINUX help - udhcpc is a DHCP client geared primarily toward embedded systems, - while striving to be fully functional and RFC compliant. + udhcpc is a DHCP client geared primarily toward embedded systems, + while striving to be fully functional and RFC compliant. - The udhcp client negotiates a lease with the DHCP server and - runs a script when a lease is obtained or lost. + The udhcp client negotiates a lease with the DHCP server and + runs a script when a lease is obtained or lost. config FEATURE_UDHCPC_ARPING bool "Verify that the offered address is free, using ARP ping" default y depends on UDHCPC help - If selected, udhcpc will send ARP probes and make sure - the offered address is really not in use by anyone. The client - will DHCPDECLINE the offer if the address is in use, - and restart the discover process. + If selected, udhcpc will send ARP probes and make sure + the offered address is really not in use by anyone. The client + will DHCPDECLINE the offer if the address is in use, + and restart the discover process. config FEATURE_UDHCPC_SANITIZEOPT bool "Do not pass malformed host and domain names" default y depends on UDHCPC help - If selected, udhcpc will check some options (such as option 12 - - hostname) and if they don't look like valid hostnames - (for example, if they start with dash or contain spaces), - they will be replaced with string "bad" when exporting - to the environment. + If selected, udhcpc will check some options (such as option 12 - + hostname) and if they don't look like valid hostnames + (for example, if they start with dash or contain spaces), + they will be replaced with string "bad" when exporting + to the environment. config UDHCPC_DEFAULT_SCRIPT string "Absolute path to config script" default "/usr/share/udhcpc/default.script" depends on UDHCPC help - This script is called after udhcpc receives an answer. See - examples/udhcp for a working example. Normally it is safe - to leave this untouched. + This script is called after udhcpc receives an answer. See + examples/udhcp for a working example. Normally it is safe + to leave this untouched. config FEATURE_UDHCP_PORT bool "Enable '-P port' option for udhcpd and udhcpc" default n depends on UDHCPD || UDHCPC help - At the cost of ~300 bytes, enables -P port option. - This feature is typically not needed. + At the cost of ~300 bytes, enables -P port option. + This feature is typically not needed. config UDHCP_DEBUG int "Maximum verbosity level for udhcp applets (0..9)" @@ -116,28 +116,28 @@ config UDHCP_DEBUG range 0 9 depends on UDHCPD || UDHCPC || DHCPRELAY help - Verbosity can be increased with multiple -v options. - This option controls how high it can be cranked up. + Verbosity can be increased with multiple -v options. + This option controls how high it can be cranked up. - Bigger values result in bigger code. Levels above 1 - are very verbose and useful for debugging only. + Bigger values result in bigger code. Levels above 1 + are very verbose and useful for debugging only. config FEATURE_UDHCP_RFC3397 bool "Support RFC3397 domain search (experimental)" default y depends on UDHCPD || UDHCPC help - If selected, both client and server will support passing of domain - search lists via option 119, specified in RFC 3397, - and SIP servers option 120, specified in RFC 3361. + If selected, both client and server will support passing of domain + search lists via option 119, specified in RFC 3397, + and SIP servers option 120, specified in RFC 3361. config FEATURE_UDHCP_8021Q bool "Support 802.1Q VLAN parameters" default y depends on UDHCPD || UDHCPC help - If selected, both client and server will support passing of VLAN - ID and priority via options 132 and 133 as per 802.1Q. + If selected, both client and server will support passing of VLAN + ID and priority via options 132 and 133 as per 802.1Q. config UDHCPC_SLACK_FOR_BUGGY_SERVERS int "DHCP options slack buffer size" @@ -145,19 +145,19 @@ config UDHCPC_SLACK_FOR_BUGGY_SERVERS range 0 924 depends on UDHCPD || UDHCPC help - Some buggy DHCP servers send DHCP offer packets with option - field larger than we expect (which might also be considered a - buffer overflow attempt). These packets are normally discarded. - If circumstances beyond your control force you to support such - servers, this may help. The upper limit (924) makes dhcpc accept - even 1500 byte packets (maximum-sized ethernet packets). - - This option does not make dhcp[cd] emit non-standard - sized packets. - - Known buggy DHCP servers: - 3Com OfficeConnect Remote 812 ADSL Router: - seems to confuse maximum allowed UDP packet size with - maximum size of entire IP packet, and sends packets which are - 28 bytes too large. - Seednet (ISP) VDSL: sends packets 2 bytes too large. + Some buggy DHCP servers send DHCP offer packets with option + field larger than we expect (which might also be considered a + buffer overflow attempt). These packets are normally discarded. + If circumstances beyond your control force you to support such + servers, this may help. The upper limit (924) makes dhcpc accept + even 1500 byte packets (maximum-sized ethernet packets). + + This option does not make dhcp[cd] emit non-standard + sized packets. + + Known buggy DHCP servers: + 3Com OfficeConnect Remote 812 ADSL Router: + seems to confuse maximum allowed UDP packet size with + maximum size of entire IP packet, and sends packets + which are 28 bytes too large. + Seednet (ISP) VDSL: sends packets 2 bytes too large. diff --git a/networking/udhcp/d6_dhcpc.c b/networking/udhcp/d6_dhcpc.c index f6d3fb98b..ebf793438 100644 --- a/networking/udhcp/d6_dhcpc.c +++ b/networking/udhcp/d6_dhcpc.c @@ -14,31 +14,31 @@ //config: default n # not yet ready //config: depends on FEATURE_IPV6 //config: help -//config: udhcpc6 is a DHCPv6 client +//config: udhcpc6 is a DHCPv6 client //config: //config:config FEATURE_UDHCPC6_RFC3646 //config: bool "Support RFC 3646 (DNS server and search list)" //config: default y //config: depends on UDHCPC6 //config: help -//config: List of DNS servers and domain search list can be requested with -//config: "-O dns" and "-O search". If server gives these values, -//config: they will be set in environment variables "dns" and "search". +//config: List of DNS servers and domain search list can be requested with +//config: "-O dns" and "-O search". If server gives these values, +//config: they will be set in environment variables "dns" and "search". //config: //config:config FEATURE_UDHCPC6_RFC4704 //config: bool "Support RFC 4704 (Client FQDN)" //config: default y //config: depends on UDHCPC6 //config: help -//config: You can request FQDN to be given by server using "-O fqdn". +//config: You can request FQDN to be given by server using "-O fqdn". //config: //config:config FEATURE_UDHCPC6_RFC4833 //config: bool "Support RFC 4833 (Timezones)" //config: default y //config: depends on UDHCPC6 //config: help -//config: You can request POSIX timezone with "-O tz" and timezone name -//config: with "-O timezone". +//config: You can request POSIX timezone with "-O tz" and timezone name +//config: with "-O timezone". //applet:IF_UDHCPC6(APPLET(udhcpc6, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/vconfig.c b/networking/vconfig.c index 9efb79c16..e6e2872bf 100644 --- a/networking/vconfig.c +++ b/networking/vconfig.c @@ -14,7 +14,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Creates, removes, and configures VLAN interfaces +//config: Creates, removes, and configures VLAN interfaces //applet:IF_VCONFIG(APPLET(vconfig, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/networking/wget.c b/networking/wget.c index 6d78dd56f..e47c9a51b 100644 --- a/networking/wget.c +++ b/networking/wget.c @@ -13,8 +13,8 @@ //config: bool "wget (35 kb)" //config: default y //config: help -//config: wget is a utility for non-interactive download of files from HTTP -//config: and FTP servers. +//config: wget is a utility for non-interactive download of files from HTTP +//config: and FTP servers. //config: //config:config FEATURE_WGET_LONG_OPTIONS //config: bool "Enable long options" @@ -31,21 +31,21 @@ //config: default y //config: depends on WGET //config: help -//config: Support authenticated HTTP transfers. +//config: Support authenticated HTTP transfers. //config: //config:config FEATURE_WGET_TIMEOUT //config: bool "Enable timeout option -T SEC" //config: default y //config: depends on WGET //config: help -//config: Supports network read and connect timeouts for wget, -//config: so that wget will give up and timeout, through the -T -//config: command line option. +//config: Supports network read and connect timeouts for wget, +//config: so that wget will give up and timeout, through the -T +//config: command line option. //config: -//config: Currently only connect and network data read timeout are -//config: supported (i.e., timeout is not applied to the DNS query). When -//config: FEATURE_WGET_LONG_OPTIONS is also enabled, the --timeout option -//config: will work in addition to -T. +//config: Currently only connect and network data read timeout are +//config: supported (i.e., timeout is not applied to the DNS query). When +//config: FEATURE_WGET_LONG_OPTIONS is also enabled, the --timeout option +//config: will work in addition to -T. //config: //config:config FEATURE_WGET_HTTPS //config: bool "Support HTTPS using internal TLS code" @@ -53,68 +53,68 @@ //config: depends on WGET //config: select TLS //config: help -//config: wget will use internal TLS code to connect to https:// URLs. -//config: Note: -//config: On NOMMU machines, ssl_helper applet should be available -//config: in the $PATH for this to work. Make sure to select that applet. +//config: wget will use internal TLS code to connect to https:// URLs. +//config: Note: +//config: On NOMMU machines, ssl_helper applet should be available +//config: in the $PATH for this to work. Make sure to select that applet. //config: -//config: Note: currently, TLS code only makes TLS I/O work, it -//config: does *not* check that the peer is who it claims to be, etc. -//config: IOW: it uses peer-supplied public keys to establish encryption -//config: and signing keys, then encrypts and signs outgoing data and -//config: decrypts incoming data. -//config: It does not check signature hashes on the incoming data: -//config: this means that attackers manipulating TCP packets can -//config: send altered data and we unknowingly receive garbage. -//config: (This check might be relatively easy to add). -//config: It does not check public key's certificate: -//config: this means that the peer may be an attacker impersonating -//config: the server we think we are talking to. +//config: Note: currently, TLS code only makes TLS I/O work, it +//config: does *not* check that the peer is who it claims to be, etc. +//config: IOW: it uses peer-supplied public keys to establish encryption +//config: and signing keys, then encrypts and signs outgoing data and +//config: decrypts incoming data. +//config: It does not check signature hashes on the incoming data: +//config: this means that attackers manipulating TCP packets can +//config: send altered data and we unknowingly receive garbage. +//config: (This check might be relatively easy to add). +//config: It does not check public key's certificate: +//config: this means that the peer may be an attacker impersonating +//config: the server we think we are talking to. //config: -//config: If you think this is unacceptable, consider this. As more and more -//config: servers switch to HTTPS-only operation, without such "crippled" -//config: TLS code it is *impossible* to simply download a kernel source -//config: from kernel.org. Which can in real world translate into -//config: "my small automatic tooling to build cross-compilers from sources -//config: no longer works, I need to additionally keep a local copy -//config: of ~4 megabyte source tarball of a SSL library and ~2 megabyte -//config: source of wget, need to compile and built both before I can -//config: download anything. All this despite the fact that the build -//config: is done in a QEMU sandbox on a machine with absolutely nothing -//config: worth stealing, so I don't care if someone would go to a lot -//config: of trouble to intercept my HTTPS download to send me an altered -//config: kernel tarball". +//config: If you think this is unacceptable, consider this. As more and more +//config: servers switch to HTTPS-only operation, without such "crippled" +//config: TLS code it is *impossible* to simply download a kernel source +//config: from kernel.org. Which can in real world translate into +//config: "my small automatic tooling to build cross-compilers from sources +//config: no longer works, I need to additionally keep a local copy +//config: of ~4 megabyte source tarball of a SSL library and ~2 megabyte +//config: source of wget, need to compile and built both before I can +//config: download anything. All this despite the fact that the build +//config: is done in a QEMU sandbox on a machine with absolutely nothing +//config: worth stealing, so I don't care if someone would go to a lot +//config: of trouble to intercept my HTTPS download to send me an altered +//config: kernel tarball". //config: -//config: If you still think this is unacceptable, send patches. +//config: If you still think this is unacceptable, send patches. //config: -//config: If you still think this is unacceptable, do not want to send -//config: patches, but do want to waste bandwidth expaining how wrong -//config: it is, you will be ignored. +//config: If you still think this is unacceptable, do not want to send +//config: patches, but do want to waste bandwidth expaining how wrong +//config: it is, you will be ignored. //config: //config:config FEATURE_WGET_OPENSSL //config: bool "Try to connect to HTTPS using openssl" //config: default y //config: depends on WGET //config: help -//config: Try to use openssl to handle HTTPS. +//config: Try to use openssl to handle HTTPS. //config: -//config: OpenSSL has a simple SSL client for debug purposes. -//config: If you select this option, wget will effectively run: -//config: "openssl s_client -quiet -connect hostname:443 -//config: -servername hostname 2>/dev/null" and pipe its data -//config: through it. -servername is not used if hostname is numeric. -//config: Note inconvenient API: host resolution is done twice, -//config: and there is no guarantee openssl's idea of IPv6 address -//config: format is the same as ours. -//config: Another problem is that s_client prints debug information -//config: to stderr, and it needs to be suppressed. This means -//config: all error messages get suppressed too. -//config: openssl is also a big binary, often dynamically linked -//config: against ~15 libraries. +//config: OpenSSL has a simple SSL client for debug purposes. +//config: If you select this option, wget will effectively run: +//config: "openssl s_client -quiet -connect hostname:443 +//config: -servername hostname 2>/dev/null" and pipe its data +//config: through it. -servername is not used if hostname is numeric. +//config: Note inconvenient API: host resolution is done twice, +//config: and there is no guarantee openssl's idea of IPv6 address +//config: format is the same as ours. +//config: Another problem is that s_client prints debug information +//config: to stderr, and it needs to be suppressed. This means +//config: all error messages get suppressed too. +//config: openssl is also a big binary, often dynamically linked +//config: against ~15 libraries. //config: -//config: If openssl can't be executed, internal TLS code will be used -//config: (if you enabled it); if openssl can be executed but fails later, -//config: wget can't detect this, and download will fail. +//config: If openssl can't be executed, internal TLS code will be used +//config: (if you enabled it); if openssl can be executed but fails later, +//config: wget can't detect this, and download will fail. //applet:IF_WGET(APPLET(wget, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/whois.c b/networking/whois.c index ee5a6011f..0cb7e5411 100644 --- a/networking/whois.c +++ b/networking/whois.c @@ -14,7 +14,7 @@ //config: bool "whois (6.6 kb)" //config: default y //config: help -//config: whois is a client for the whois directory service +//config: whois is a client for the whois directory service //applet:IF_WHOIS(APPLET(whois, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/networking/zcip.c b/networking/zcip.c index 20543700a..232165efa 100644 --- a/networking/zcip.c +++ b/networking/zcip.c @@ -20,12 +20,12 @@ //config: select PLATFORM_LINUX //config: select FEATURE_SYSLOG //config: help -//config: ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927. -//config: It's a daemon that allocates and defends a dynamically assigned -//config: address on the 169.254/16 network, requiring no system administrator. +//config: ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927. +//config: It's a daemon that allocates and defends a dynamically assigned +//config: address on the 169.254/16 network, requiring no system administrator. //config: -//config: See http://www.zeroconf.org for further details, and "zcip.script" -//config: in the busybox examples. +//config: See http://www.zeroconf.org for further details, and "zcip.script" +//config: in the busybox examples. //applet:IF_ZCIP(APPLET(zcip, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/printutils/lpd.c b/printutils/lpd.c index 2be485a69..3fdba5d2b 100644 --- a/printutils/lpd.c +++ b/printutils/lpd.c @@ -73,7 +73,7 @@ //config: bool "lpd (5.3 kb)" //config: default y //config: help -//config: lpd is a print spooling daemon. +//config: lpd is a print spooling daemon. //applet:IF_LPD(APPLET(lpd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/printutils/lpr.c b/printutils/lpr.c index 23bf8cdaf..808ecb5dc 100644 --- a/printutils/lpr.c +++ b/printutils/lpr.c @@ -15,13 +15,13 @@ //config: bool "lpr (10 kb)" //config: default y //config: help -//config: lpr sends files (or standard input) to a print spooling daemon. +//config: lpr sends files (or standard input) to a print spooling daemon. //config: //config:config LPQ //config: bool "lpq (10 kb)" //config: default y //config: help -//config: lpq is a print spool queue examination and manipulation program. +//config: lpq is a print spool queue examination and manipulation program. // APPLET_ODDNAME:name main location suid_type help //applet:IF_LPQ(APPLET_ODDNAME(lpq, lpqr, BB_DIR_USR_BIN, BB_SUID_DROP, lpq)) diff --git a/procps/Config.src b/procps/Config.src index 35fef2eda..515d79938 100644 --- a/procps/Config.src +++ b/procps/Config.src @@ -12,7 +12,7 @@ config FEATURE_SHOW_THREADS default y depends on PS || TOP || PSTREE help - Enables the ps -T option, showing of threads in pstree, - and 'h' command in top. + Enables the ps -T option, showing of threads in pstree, + and 'h' command in top. endmenu diff --git a/procps/free.c b/procps/free.c index 497bf1911..618664e08 100644 --- a/procps/free.c +++ b/procps/free.c @@ -11,9 +11,9 @@ //config: default y //config: select PLATFORM_LINUX #sysinfo() //config: help -//config: free displays the total amount of free and used physical and swap -//config: memory in the system, as well as the buffers used by the kernel. -//config: The shared memory column should be ignored; it is obsolete. +//config: free displays the total amount of free and used physical and swap +//config: memory in the system, as well as the buffers used by the kernel. +//config: The shared memory column should be ignored; it is obsolete. //applet:IF_FREE(APPLET(free, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/fuser.c b/procps/fuser.c index 463d8800c..2585a4203 100644 --- a/procps/fuser.c +++ b/procps/fuser.c @@ -10,9 +10,9 @@ //config: bool "fuser (7 kb)" //config: default y //config: help -//config: fuser lists all PIDs (Process IDs) that currently have a given -//config: file open. fuser can also list all PIDs that have a given network -//config: (TCP or UDP) port open. +//config: fuser lists all PIDs (Process IDs) that currently have a given +//config: file open. fuser can also list all PIDs that have a given network +//config: (TCP or UDP) port open. //applet:IF_FUSER(APPLET(fuser, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/iostat.c b/procps/iostat.c index 94a928020..608d41364 100644 --- a/procps/iostat.c +++ b/procps/iostat.c @@ -11,7 +11,7 @@ //config: bool "iostat (7.4 kb)" //config: default y //config: help -//config: Report CPU and I/O statistics +//config: Report CPU and I/O statistics //applet:IF_IOSTAT(APPLET(iostat, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/procps/kill.c b/procps/kill.c index 3c330e5b9..5cff24475 100644 --- a/procps/kill.c +++ b/procps/kill.c @@ -11,26 +11,26 @@ //config: bool "kill (2.6 kb)" //config: default y //config: help -//config: The command kill sends the specified signal to the specified -//config: process or process group. If no signal is specified, the TERM -//config: signal is sent. +//config: The command kill sends the specified signal to the specified +//config: process or process group. If no signal is specified, the TERM +//config: signal is sent. //config: //config:config KILLALL //config: bool "killall (5.6 kb)" //config: default y //config: help -//config: killall sends a signal to all processes running any of the -//config: specified commands. If no signal name is specified, SIGTERM is -//config: sent. +//config: killall sends a signal to all processes running any of the +//config: specified commands. If no signal name is specified, SIGTERM is +//config: sent. //config: //config:config KILLALL5 //config: bool "killall5 (5.3 kb)" //config: default y //config: help -//config: The SystemV killall command. killall5 sends a signal -//config: to all processes except kernel threads and the processes -//config: in its own session, so it won't kill the shell that is running -//config: the script it was called from. +//config: The SystemV killall command. killall5 sends a signal +//config: to all processes except kernel threads and the processes +//config: in its own session, so it won't kill the shell that is running +//config: the script it was called from. //applet:IF_KILL(APPLET(kill, BB_DIR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/procps/lsof.c b/procps/lsof.c index d1e994ab9..8d3a23cc8 100644 --- a/procps/lsof.c +++ b/procps/lsof.c @@ -11,8 +11,8 @@ //config: bool "lsof (3.6 kb)" //config: default y //config: help -//config: Show open files in the format of: -//config: PID /path/to/executable /path/to/opened/file +//config: Show open files in the format of: +//config: PID /path/to/executable /path/to/opened/file //applet:IF_LSOF(APPLET(lsof, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/mpstat.c b/procps/mpstat.c index 455cdb1b2..1eabd8e38 100644 --- a/procps/mpstat.c +++ b/procps/mpstat.c @@ -15,7 +15,7 @@ //config: bool "mpstat (10 kb)" //config: default y //config: help -//config: Per-processor statistics +//config: Per-processor statistics #include "libbb.h" #include /* struct utsname */ diff --git a/procps/nmeter.c b/procps/nmeter.c index a7c548d98..9463f94dc 100644 --- a/procps/nmeter.c +++ b/procps/nmeter.c @@ -10,7 +10,7 @@ //config: bool "nmeter (10 kb)" //config: default y //config: help -//config: Prints selected system stats continuously, one line per update. +//config: Prints selected system stats continuously, one line per update. //applet:IF_NMETER(APPLET(nmeter, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/pgrep.c b/procps/pgrep.c index 335f2d226..327f6a934 100644 --- a/procps/pgrep.c +++ b/procps/pgrep.c @@ -10,13 +10,13 @@ //config: bool "pgrep (6.8 kb)" //config: default y //config: help -//config: Look for processes by name. +//config: Look for processes by name. //config: //config:config PKILL //config: bool "pkill (7.6 kb)" //config: default y //config: help -//config: Send signals to processes by name. +//config: Send signals to processes by name. //applet:IF_PGREP(APPLET(pgrep, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/procps/pidof.c b/procps/pidof.c index 0d08c6095..41247a02c 100644 --- a/procps/pidof.c +++ b/procps/pidof.c @@ -10,24 +10,24 @@ //config: bool "pidof (6.6 kb)" //config: default y //config: help -//config: Pidof finds the process id's (pids) of the named programs. It prints -//config: those id's on the standard output. +//config: Pidof finds the process id's (pids) of the named programs. It prints +//config: those id's on the standard output. //config: //config:config FEATURE_PIDOF_SINGLE //config: bool "Enable single shot (-s)" //config: default y //config: depends on PIDOF //config: help -//config: Support '-s' for returning only the first pid found. +//config: Support '-s' for returning only the first pid found. //config: //config:config FEATURE_PIDOF_OMIT //config: bool "Enable omitting pids (-o PID)" //config: default y //config: depends on PIDOF //config: help -//config: Support '-o PID' for omitting the given pid(s) in output. -//config: The special pid %PPID can be used to name the parent process -//config: of the pidof, in other words the calling shell or shell script. +//config: Support '-o PID' for omitting the given pid(s) in output. +//config: The special pid %PPID can be used to name the parent process +//config: of the pidof, in other words the calling shell or shell script. //applet:IF_PIDOF(APPLET(pidof, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/procps/pmap.c b/procps/pmap.c index bbcd54482..c8f728897 100644 --- a/procps/pmap.c +++ b/procps/pmap.c @@ -9,10 +9,10 @@ */ //config:config PMAP -//config: bool "pmap (6 kb)" -//config: default y -//config: help -//config: Display processes' memory mappings. +//config: bool "pmap (6 kb)" +//config: default y +//config: help +//config: Display processes' memory mappings. //applet:IF_PMAP(APPLET(pmap, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_PMAP) += pmap.o diff --git a/procps/powertop.c b/procps/powertop.c index ae3aa8938..ebd659bdb 100644 --- a/procps/powertop.c +++ b/procps/powertop.c @@ -17,15 +17,15 @@ //config: bool "powertop (9.1 kb)" //config: default y //config: help -//config: Analyze power consumption on Intel-based laptops +//config: Analyze power consumption on Intel-based laptops //config: //config:config FEATURE_POWERTOP_INTERACTIVE //config: bool "Accept keyboard commands" //config: default y //config: depends on POWERTOP //config: help -//config: Without this, powertop will only refresh display every 10 seconds. -//config: No keyboard commands will work, only ^C to terminate. +//config: Without this, powertop will only refresh display every 10 seconds. +//config: No keyboard commands will work, only ^C to terminate. // XXX This should be configurable #define ENABLE_FEATURE_POWERTOP_PROCIRQ 1 diff --git a/procps/ps.c b/procps/ps.c index a8d2d188a..d4d787d78 100644 --- a/procps/ps.c +++ b/procps/ps.c @@ -12,24 +12,24 @@ //config: bool "ps (11 kb)" //config: default y //config: help -//config: ps gives a snapshot of the current processes. +//config: ps gives a snapshot of the current processes. //config: //config:config FEATURE_PS_WIDE //config: bool "Enable wide output option (-w)" //config: default y //config: depends on PS && !DESKTOP //config: help -//config: Support argument 'w' for wide output. -//config: If given once, 132 chars are printed, and if given more -//config: than once, the length is unlimited. +//config: Support argument 'w' for wide output. +//config: If given once, 132 chars are printed, and if given more +//config: than once, the length is unlimited. //config: //config:config FEATURE_PS_LONG //config: bool "Enable long output option (-l)" //config: default y //config: depends on PS && !DESKTOP //config: help -//config: Support argument 'l' for long output. -//config: Adds fields PPID, RSS, START, TIME & TTY +//config: Support argument 'l' for long output. +//config: Adds fields PPID, RSS, START, TIME & TTY //config: //config:config FEATURE_PS_TIME //config: bool "Support -o time and -o etime output specifiers" @@ -42,8 +42,8 @@ //config: default n //config: depends on FEATURE_PS_TIME //config: help -//config: Include support for measuring HZ on old kernels and non-ELF systems -//config: (if you are on Linux 2.4.0+ and use ELF, you don't need this) +//config: Include support for measuring HZ on old kernels and non-ELF systems +//config: (if you are on Linux 2.4.0+ and use ELF, you don't need this) //config: //config:config FEATURE_PS_ADDITIONAL_COLUMNS //config: bool "Support -o rgroup, -o ruser, -o nice specifiers" diff --git a/procps/pstree.c b/procps/pstree.c index cf8b81f8d..212cda23c 100644 --- a/procps/pstree.c +++ b/procps/pstree.c @@ -14,7 +14,7 @@ //config: bool "pstree (9.4 kb)" //config: default y //config: help -//config: Display a tree of processes. +//config: Display a tree of processes. //applet:IF_PSTREE(APPLET(pstree, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/pwdx.c b/procps/pwdx.c index 936153861..dac238950 100644 --- a/procps/pwdx.c +++ b/procps/pwdx.c @@ -12,7 +12,7 @@ //config: bool "pwdx (3.5 kb)" //config: default y //config: help -//config: Report current working directory of a process +//config: Report current working directory of a process //applet:IF_PWDX(APPLET(pwdx, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/smemcap.c b/procps/smemcap.c index 327a37cdb..c15fef1c3 100644 --- a/procps/smemcap.c +++ b/procps/smemcap.c @@ -16,8 +16,8 @@ //config: bool "smemcap (2.5 kb)" //config: default y //config: help -//config: smemcap is a tool for capturing process data for smem, -//config: a memory usage statistic tool. +//config: smemcap is a tool for capturing process data for smem, +//config: a memory usage statistic tool. #include "libbb.h" #include "bb_archive.h" diff --git a/procps/sysctl.c b/procps/sysctl.c index 305783be6..b17f5e896 100644 --- a/procps/sysctl.c +++ b/procps/sysctl.c @@ -14,7 +14,7 @@ //config: bool "sysctl (6.9 kb)" //config: default y //config: help -//config: Configure kernel parameters at runtime. +//config: Configure kernel parameters at runtime. //applet:IF_BB_SYSCTL(APPLET(sysctl, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/procps/top.c b/procps/top.c index f43cd9c2c..015d1ab74 100644 --- a/procps/top.c +++ b/procps/top.c @@ -53,63 +53,63 @@ //config: bool "top (17 kb)" //config: default y //config: help -//config: The top program provides a dynamic real-time view of a running -//config: system. +//config: The top program provides a dynamic real-time view of a running +//config: system. //config: //config:config FEATURE_TOP_INTERACTIVE //config: bool "Accept keyboard commands" //config: default y //config: depends on TOP //config: help -//config: Without this, top will only refresh display every 5 seconds. -//config: No keyboard commands will work, only ^C to terminate. +//config: Without this, top will only refresh display every 5 seconds. +//config: No keyboard commands will work, only ^C to terminate. //config: //config:config FEATURE_TOP_CPU_USAGE_PERCENTAGE //config: bool "Show CPU per-process usage percentage" //config: default y //config: depends on TOP //config: help -//config: Make top display CPU usage for each process. -//config: This adds about 2k. +//config: Make top display CPU usage for each process. +//config: This adds about 2k. //config: //config:config FEATURE_TOP_CPU_GLOBAL_PERCENTS //config: bool "Show CPU global usage percentage" //config: default y //config: depends on FEATURE_TOP_CPU_USAGE_PERCENTAGE //config: help -//config: Makes top display "CPU: NN% usr NN% sys..." line. -//config: This adds about 0.5k. +//config: Makes top display "CPU: NN% usr NN% sys..." line. +//config: This adds about 0.5k. //config: //config:config FEATURE_TOP_SMP_CPU //config: bool "SMP CPU usage display ('c' key)" //config: default y //config: depends on FEATURE_TOP_CPU_GLOBAL_PERCENTS //config: help -//config: Allow 'c' key to switch between individual/cumulative CPU stats -//config: This adds about 0.5k. +//config: Allow 'c' key to switch between individual/cumulative CPU stats +//config: This adds about 0.5k. //config: //config:config FEATURE_TOP_DECIMALS //config: bool "Show 1/10th of a percent in CPU/mem statistics" //config: default y //config: depends on FEATURE_TOP_CPU_USAGE_PERCENTAGE //config: help -//config: Show 1/10th of a percent in CPU/mem statistics. -//config: This adds about 0.3k. +//config: Show 1/10th of a percent in CPU/mem statistics. +//config: This adds about 0.3k. //config: //config:config FEATURE_TOP_SMP_PROCESS //config: bool "Show CPU process runs on ('j' field)" //config: default y //config: depends on TOP //config: help -//config: Show CPU where process was last found running on. -//config: This is the 'j' field. +//config: Show CPU where process was last found running on. +//config: This is the 'j' field. //config: //config:config FEATURE_TOPMEM //config: bool "Topmem command ('s' key)" //config: default y //config: depends on TOP //config: help -//config: Enable 's' in top (gives lots of memory info). +//config: Enable 's' in top (gives lots of memory info). //applet:IF_TOP(APPLET(top, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/uptime.c b/procps/uptime.c index 53fbe547e..24b2b39df 100644 --- a/procps/uptime.c +++ b/procps/uptime.c @@ -16,16 +16,16 @@ //config: default y //config: select PLATFORM_LINUX #sysinfo() //config: help -//config: uptime gives a one line display of the current time, how long -//config: the system has been running, how many users are currently logged -//config: on, and the system load averages for the past 1, 5, and 15 minutes. +//config: uptime gives a one line display of the current time, how long +//config: the system has been running, how many users are currently logged +//config: on, and the system load averages for the past 1, 5, and 15 minutes. //config: //config:config FEATURE_UPTIME_UTMP_SUPPORT //config: bool "Show the number of users" //config: default y //config: depends on UPTIME && FEATURE_UTMP //config: help -//config: Display the number of users currently logged on. +//config: Display the number of users currently logged on. //applet:IF_UPTIME(APPLET(uptime, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/procps/watch.c b/procps/watch.c index 3127a0ca6..2bb7cca90 100644 --- a/procps/watch.c +++ b/procps/watch.c @@ -15,8 +15,8 @@ //config: bool "watch (4.1 kb)" //config: default y //config: help -//config: watch is used to execute a program periodically, showing -//config: output to the screen. +//config: watch is used to execute a program periodically, showing +//config: output to the screen. //applet:IF_WATCH(APPLET(watch, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/runit/chpst.c b/runit/chpst.c index 2e94a37c0..3a2f9e616 100644 --- a/runit/chpst.c +++ b/runit/chpst.c @@ -31,33 +31,33 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. //config: bool "chpst (8.7 kb)" //config: default y //config: help -//config: chpst changes the process state according to the given options, and -//config: execs specified program. +//config: chpst changes the process state according to the given options, and +//config: execs specified program. //config: //config:config SETUIDGID //config: bool "setuidgid (4.2 kb)" //config: default y //config: help -//config: Sets soft resource limits as specified by options +//config: Sets soft resource limits as specified by options //config: //config:config ENVUIDGID //config: bool "envuidgid (3.6 kb)" //config: default y //config: help -//config: Sets $UID to account's uid and $GID to account's gid +//config: Sets $UID to account's uid and $GID to account's gid //config: //config:config ENVDIR //config: bool "envdir (2.5 kb)" //config: default y //config: help -//config: Sets various environment variables as specified by files -//config: in the given directory +//config: Sets various environment variables as specified by files +//config: in the given directory //config: //config:config SOFTLIMIT //config: bool "softlimit (4.3 kb)" //config: default y //config: help -//config: Sets soft resource limits as specified by options +//config: Sets soft resource limits as specified by options //applet:IF_CHPST(APPLET(chpst, BB_DIR_USR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/runit/runsv.c b/runit/runsv.c index 79f02f4c5..ad7d82cb8 100644 --- a/runit/runsv.c +++ b/runit/runsv.c @@ -31,8 +31,8 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. //config: bool "runsv (7.2 kb)" //config: default y //config: help -//config: runsv starts and monitors a service and optionally an appendant log -//config: service. +//config: runsv starts and monitors a service and optionally an appendant log +//config: service. //applet:IF_RUNSV(APPLET(runsv, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/runit/runsvdir.c b/runit/runsvdir.c index 946ae697d..b4f5c303b 100644 --- a/runit/runsvdir.c +++ b/runit/runsvdir.c @@ -31,18 +31,18 @@ ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. //config: bool "runsvdir (6 kb)" //config: default y //config: help -//config: runsvdir starts a runsv process for each subdirectory, or symlink to -//config: a directory, in the services directory dir, up to a limit of 1000 -//config: subdirectories, and restarts a runsv process if it terminates. +//config: runsvdir starts a runsv process for each subdirectory, or symlink to +//config: a directory, in the services directory dir, up to a limit of 1000 +//config: subdirectories, and restarts a runsv process if it terminates. //config: //config:config FEATURE_RUNSVDIR_LOG //config: bool "Enable scrolling argument log" //config: depends on RUNSVDIR //config: default n //config: help -//config: Enable feature where second parameter of runsvdir holds last error -//config: message (viewable via top/ps). Otherwise (feature is off -//config: or no parameter), error messages go to stderr only. +//config: Enable feature where second parameter of runsvdir holds last error +//config: message (viewable via top/ps). Otherwise (feature is off +//config: or no parameter), error messages go to stderr only. //applet:IF_RUNSVDIR(APPLET(runsvdir, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/runit/sv.c b/runit/sv.c index a0c7953da..2d5b466bf 100644 --- a/runit/sv.c +++ b/runit/sv.c @@ -157,23 +157,23 @@ Exit Codes //config: bool "sv (7.8 kb)" //config: default y //config: help -//config: sv reports the current status and controls the state of services -//config: monitored by the runsv supervisor. +//config: sv reports the current status and controls the state of services +//config: monitored by the runsv supervisor. //config: //config:config SV_DEFAULT_SERVICE_DIR //config: string "Default directory for services" //config: default "/var/service" //config: depends on SV //config: help -//config: Default directory for services. -//config: Defaults to "/var/service" +//config: Default directory for services. +//config: Defaults to "/var/service" //config: //config:config SVC //config: bool "svc (7.8 kb)" //config: default y //config: help -//config: svc controls the state of services monitored by the runsv supervisor. -//config: It is comaptible with daemontools command with the same name. +//config: svc controls the state of services monitored by the runsv supervisor. +//config: It is comaptible with daemontools command with the same name. //applet:IF_SV(APPLET(sv, BB_DIR_USR_BIN, BB_SUID_DROP)) //applet:IF_SVC(APPLET(svc, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/runit/svlogd.c b/runit/svlogd.c index 1346994ca..8dbf67106 100644 --- a/runit/svlogd.c +++ b/runit/svlogd.c @@ -128,9 +128,9 @@ log message, you can use a pattern like this instead //config: bool "svlogd (15 kb)" //config: default y //config: help -//config: svlogd continuously reads log data from its standard input, optionally -//config: filters log messages, and writes the data to one or more automatically -//config: rotated logs. +//config: svlogd continuously reads log data from its standard input, optionally +//config: filters log messages, and writes the data to one or more automatically +//config: rotated logs. //applet:IF_SVLOGD(APPLET(svlogd, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/chcon.c b/selinux/chcon.c index 6caf14750..ae87fb554 100644 --- a/selinux/chcon.c +++ b/selinux/chcon.c @@ -12,7 +12,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to change the security context of file. +//config: Enable support to change the security context of file. //config: //config:config FEATURE_CHCON_LONG_OPTIONS //config: bool "Enable long options" diff --git a/selinux/getenforce.c b/selinux/getenforce.c index 44bcdfd24..0286dd0be 100644 --- a/selinux/getenforce.c +++ b/selinux/getenforce.c @@ -11,7 +11,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to get the current mode of SELinux. +//config: Enable support to get the current mode of SELinux. //applet:IF_GETENFORCE(APPLET(getenforce, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/getsebool.c b/selinux/getsebool.c index 2c56a05fc..6d7805c8d 100644 --- a/selinux/getsebool.c +++ b/selinux/getsebool.c @@ -11,7 +11,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to get SELinux boolean values. +//config: Enable support to get SELinux boolean values. //applet:IF_GETSEBOOL(APPLET(getsebool, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/load_policy.c b/selinux/load_policy.c index 22ee0527d..b7930839c 100644 --- a/selinux/load_policy.c +++ b/selinux/load_policy.c @@ -9,7 +9,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to load SELinux policy. +//config: Enable support to load SELinux policy. //applet:IF_LOAD_POLICY(APPLET(load_policy, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/matchpathcon.c b/selinux/matchpathcon.c index 7814f62ed..3388d0857 100644 --- a/selinux/matchpathcon.c +++ b/selinux/matchpathcon.c @@ -10,8 +10,8 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to get default security context of the -//config: specified path from the file contexts configuration. +//config: Enable support to get default security context of the +//config: specified path from the file contexts configuration. //applet:IF_MATCHPATHCON(APPLET(matchpathcon, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/runcon.c b/selinux/runcon.c index f7d6fcd29..09082d6c2 100644 --- a/selinux/runcon.c +++ b/selinux/runcon.c @@ -33,7 +33,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to run command in specified security context. +//config: Enable support to run command in specified security context. //config: //config:config FEATURE_RUNCON_LONG_OPTIONS //config: bool "Enable long options" diff --git a/selinux/selinuxenabled.c b/selinux/selinuxenabled.c index e2c44b3b8..e70a452cf 100644 --- a/selinux/selinuxenabled.c +++ b/selinux/selinuxenabled.c @@ -11,8 +11,8 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support for this command to be used within shell scripts -//config: to determine if selinux is enabled. +//config: Enable support for this command to be used within shell scripts +//config: to determine if selinux is enabled. //applet:IF_SELINUXENABLED(APPLET(selinuxenabled, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/sestatus.c b/selinux/sestatus.c index 719832e8f..daf4b223b 100644 --- a/selinux/sestatus.c +++ b/selinux/sestatus.c @@ -12,7 +12,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Displays the status of SELinux. +//config: Displays the status of SELinux. //applet:IF_SESTATUS(APPLET(sestatus, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/setenforce.c b/selinux/setenforce.c index 2e4ab77b1..c28de6ec5 100644 --- a/selinux/setenforce.c +++ b/selinux/setenforce.c @@ -11,7 +11,7 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to modify the mode SELinux is running in. +//config: Enable support to modify the mode SELinux is running in. //applet:IF_SETENFORCE(APPLET(setenforce, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/selinux/setfiles.c b/selinux/setfiles.c index ceba36326..01106bd67 100644 --- a/selinux/setfiles.c +++ b/selinux/setfiles.c @@ -8,26 +8,26 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support to modify to relabel files. -//config: Notice: If you built libselinux with -D_FILE_OFFSET_BITS=64, -//config: (It is default in libselinux's Makefile), you _must_ enable -//config: CONFIG_LFS. +//config: Enable support to modify to relabel files. +//config: Notice: If you built libselinux with -D_FILE_OFFSET_BITS=64, +//config: (It is default in libselinux's Makefile), you _must_ enable +//config: CONFIG_LFS. //config: //config:config FEATURE_SETFILES_CHECK_OPTION //config: bool "Enable check option" //config: default n //config: depends on SETFILES //config: help -//config: Support "-c" option (check the validity of the contexts against -//config: the specified binary policy) for setfiles. Requires libsepol. +//config: Support "-c" option (check the validity of the contexts against +//config: the specified binary policy) for setfiles. Requires libsepol. //config: //config:config RESTORECON //config: bool "restorecon (12 kb)" //config: default n //config: depends on SELINUX //config: help -//config: Enable support to relabel files. The feature is almost -//config: the same as setfiles, but usage is a little different. +//config: Enable support to relabel files. The feature is almost +//config: the same as setfiles, but usage is a little different. //applet:IF_SETFILES(APPLET(setfiles, BB_DIR_SBIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/selinux/setsebool.c b/selinux/setsebool.c index 9005a384d..579118172 100644 --- a/selinux/setsebool.c +++ b/selinux/setsebool.c @@ -12,8 +12,8 @@ //config: default n //config: depends on SELINUX //config: help -//config: Enable support for change boolean. -//config: semanage and -P option is not supported yet. +//config: Enable support for change boolean. +//config: semanage and -P option is not supported yet. //applet:IF_SETSEBOOL(APPLET(setsebool, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/shell/Config.src b/shell/Config.src index 0dbf304ae..81c4ec874 100644 --- a/shell/Config.src +++ b/shell/Config.src @@ -10,26 +10,26 @@ choice prompt "Choose which shell is aliased to 'sh' name" default SH_IS_ASH help - Choose which shell you want to be executed by 'sh' alias. - The ash shell is the most bash compatible and full featured one. + Choose which shell you want to be executed by 'sh' alias. + The ash shell is the most bash compatible and full featured one. # note: cannot use "select ASH" here, it breaks "make allnoconfig" config SH_IS_ASH depends on !NOMMU bool "ash" help - Choose ash to be the shell executed by 'sh' name. - The ash code will be built into busybox. If you don't select - "ash" choice (CONFIG_ASH), this shell may only be invoked by - the name 'sh' (and not 'ash'). + Choose ash to be the shell executed by 'sh' name. + The ash code will be built into busybox. If you don't select + "ash" choice (CONFIG_ASH), this shell may only be invoked by + the name 'sh' (and not 'ash'). config SH_IS_HUSH bool "hush" help - Choose hush to be the shell executed by 'sh' name. - The hush code will be built into busybox. If you don't select - "hush" choice (CONFIG_HUSH), this shell may only be invoked by - the name 'sh' (and not 'hush'). + Choose hush to be the shell executed by 'sh' name. + The hush code will be built into busybox. If you don't select + "hush" choice (CONFIG_HUSH), this shell may only be invoked by + the name 'sh' (and not 'hush'). config SH_IS_NONE bool "none" @@ -40,36 +40,36 @@ choice prompt "Choose which shell is aliased to 'bash' name" default BASH_IS_NONE help - Choose which shell you want to be executed by 'bash' alias. - The ash shell is the most bash compatible and full featured one, - although compatibility is far from being complete. + Choose which shell you want to be executed by 'bash' alias. + The ash shell is the most bash compatible and full featured one, + although compatibility is far from being complete. - Note that selecting this option does not switch on any bash - compatibility code. It merely makes it possible to install - /bin/bash (sym)link and run scripts which start with - #!/bin/bash line. + Note that selecting this option does not switch on any bash + compatibility code. It merely makes it possible to install + /bin/bash (sym)link and run scripts which start with + #!/bin/bash line. - Many systems use it in scripts which use bash-specific features, - even simple ones like $RANDOM. Without this option, busybox - can't be used for running them because it won't recongnize - "bash" as a supported applet name. + Many systems use it in scripts which use bash-specific features, + even simple ones like $RANDOM. Without this option, busybox + can't be used for running them because it won't recongnize + "bash" as a supported applet name. config BASH_IS_ASH depends on !NOMMU bool "ash" help - Choose ash to be the shell executed by 'bash' name. - The ash code will be built into busybox. If you don't select - "ash" choice (CONFIG_ASH), this shell may only be invoked by - the name 'bash' (and not 'ash'). + Choose ash to be the shell executed by 'bash' name. + The ash code will be built into busybox. If you don't select + "ash" choice (CONFIG_ASH), this shell may only be invoked by + the name 'bash' (and not 'ash'). config BASH_IS_HUSH bool "hush" help - Choose hush to be the shell executed by 'bash' name. - The hush code will be built into busybox. If you don't select - "hush" choice (CONFIG_HUSH), this shell may only be invoked by - the name 'bash' (and not 'hush'). + Choose hush to be the shell executed by 'bash' name. + The hush code will be built into busybox. If you don't select + "hush" choice (CONFIG_HUSH), this shell may only be invoked by + the name 'bash' (and not 'hush'). config BASH_IS_NONE bool "none" @@ -88,78 +88,78 @@ config FEATURE_SH_MATH default y depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - Enable math support in the shell via $((...)) syntax. + Enable math support in the shell via $((...)) syntax. config FEATURE_SH_MATH_64 bool "Extend POSIX math support to 64 bit" default y depends on FEATURE_SH_MATH help - Enable 64-bit math support in the shell. This will make the shell - slightly larger, but will allow computation with very large numbers. - This is not in POSIX, so do not rely on this in portable code. + Enable 64-bit math support in the shell. This will make the shell + slightly larger, but will allow computation with very large numbers. + This is not in POSIX, so do not rely on this in portable code. config FEATURE_SH_EXTRA_QUIET bool "Hide message on interactive shell startup" default y depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - Remove the busybox introduction when starting a shell. + Remove the busybox introduction when starting a shell. config FEATURE_SH_STANDALONE bool "Standalone shell" default n depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - This option causes busybox shells to use busybox applets - in preference to executables in the PATH whenever possible. For - example, entering the command 'ifconfig' into the shell would cause - busybox to use the ifconfig busybox applet. Specifying the fully - qualified executable name, such as '/sbin/ifconfig' will still - execute the /sbin/ifconfig executable on the filesystem. This option - is generally used when creating a statically linked version of busybox - for use as a rescue shell, in the event that you screw up your system. - - This is implemented by re-execing /proc/self/exe (typically) - with right parameters. - - However, there are drawbacks: it is problematic in chroot jails - without mounted /proc, and ps/top may show command name as 'exe' - for applets started this way. + This option causes busybox shells to use busybox applets + in preference to executables in the PATH whenever possible. For + example, entering the command 'ifconfig' into the shell would cause + busybox to use the ifconfig busybox applet. Specifying the fully + qualified executable name, such as '/sbin/ifconfig' will still + execute the /sbin/ifconfig executable on the filesystem. This option + is generally used when creating a statically linked version of busybox + for use as a rescue shell, in the event that you screw up your system. + + This is implemented by re-execing /proc/self/exe (typically) + with right parameters. + + However, there are drawbacks: it is problematic in chroot jails + without mounted /proc, and ps/top may show command name as 'exe' + for applets started this way. config FEATURE_SH_NOFORK bool "Run 'nofork' applets directly" default n depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - This option causes busybox shells to not execute typical - fork/exec/wait sequence, but call _main directly, - if possible. (Sometimes it is not possible: for example, - this is not possible in pipes). + This option causes busybox shells to not execute typical + fork/exec/wait sequence, but call _main directly, + if possible. (Sometimes it is not possible: for example, + this is not possible in pipes). - This will be done only for some applets (those which are marked - NOFORK in include/applets.h). + This will be done only for some applets (those which are marked + NOFORK in include/applets.h). - This may significantly speed up some shell scripts. + This may significantly speed up some shell scripts. - This feature is relatively new. Use with care. Report bugs - to project mailing list. + This feature is relatively new. Use with care. Report bugs + to project mailing list. config FEATURE_SH_READ_FRAC bool "read -t N.NNN support (+110 bytes)" default y depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - Enable support for fractional second timeout in read builtin. + Enable support for fractional second timeout in read builtin. config FEATURE_SH_HISTFILESIZE bool "Use $HISTFILESIZE" default y depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH help - This option makes busybox shells to use $HISTFILESIZE variable - to set shell history size. Note that its max value is capped - by "History size" setting in library tuning section. + This option makes busybox shells to use $HISTFILESIZE variable + to set shell history size. Note that its max value is capped + by "History size" setting in library tuning section. endif # Options common to all shells diff --git a/shell/ash.c b/shell/ash.c index 9d81f4ba8..b28731eb1 100644 --- a/shell/ash.c +++ b/shell/ash.c @@ -20,10 +20,10 @@ //config: default y //config: depends on !NOMMU //config: help -//config: The most complete and most pedantically correct shell included with -//config: busybox. This shell is actually a derivative of the Debian 'dash' -//config: shell (by Herbert Xu), which was created by porting the 'ash' shell -//config: (written by Kenneth Almquist) from NetBSD. +//config: The most complete and most pedantically correct shell included with +//config: busybox. This shell is actually a derivative of the Debian 'dash' +//config: shell (by Herbert Xu), which was created by porting the 'ash' shell +//config: (written by Kenneth Almquist) from NetBSD. //config: //config:# ash options //config:# note: Don't remove !NOMMU part in the next line; it would break @@ -40,11 +40,11 @@ //config: default y # Y is bigger, but because of uclibc glob() bug, let Y be default for now //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: Do not use glob() function from libc, use internal implementation. -//config: Use this if you are getting "glob.h: No such file or directory" -//config: or similar build errors. -//config: Note that as of now (2017-01), uclibc and musl glob() both have bugs -//config: which would break ash if you select N here. +//config: Do not use glob() function from libc, use internal implementation. +//config: Use this if you are getting "glob.h: No such file or directory" +//config: or similar build errors. +//config: Note that as of now (2017-01), uclibc and musl glob() both have bugs +//config: which would break ash if you select N here. //config: //config:config ASH_BASH_COMPAT //config: bool "bash-compatible extensions" @@ -66,37 +66,37 @@ //config: default y //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: Enable pseudorandom generator and dynamic variable "$RANDOM". -//config: Each read of "$RANDOM" will generate a new pseudorandom value. -//config: You can reset the generator by using a specified start value. -//config: After "unset RANDOM" the generator will switch off and this -//config: variable will no longer have special treatment. +//config: Enable pseudorandom generator and dynamic variable "$RANDOM". +//config: Each read of "$RANDOM" will generate a new pseudorandom value. +//config: You can reset the generator by using a specified start value. +//config: After "unset RANDOM" the generator will switch off and this +//config: variable will no longer have special treatment. //config: //config:config ASH_EXPAND_PRMT //config: bool "Expand prompt string" //config: default y //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: $PS# may contain volatile content, such as backquote commands. -//config: This option recreates the prompt string from the environment -//config: variable each time it is displayed. +//config: $PS# may contain volatile content, such as backquote commands. +//config: This option recreates the prompt string from the environment +//config: variable each time it is displayed. //config: //config:config ASH_IDLE_TIMEOUT //config: bool "Idle timeout variable $TMOUT" //config: default y //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: Enable bash-like auto-logout after $TMOUT seconds of idle time. +//config: Enable bash-like auto-logout after $TMOUT seconds of idle time. //config: //config:config ASH_MAIL //config: bool "Check for new mail in interactive shell" //config: default y //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: Enable "check for new mail" function: -//config: if set, $MAIL file and $MAILPATH list of files -//config: are checked for mtime changes, and "you have mail" -//config: message is printed if change is detected. +//config: Enable "check for new mail" function: +//config: if set, $MAIL file and $MAILPATH list of files +//config: are checked for mtime changes, and "you have mail" +//config: message is printed if change is detected. //config: //config:config ASH_ECHO //config: bool "echo builtin" @@ -128,9 +128,9 @@ //config: default y //config: depends on ASH || SH_IS_ASH || BASH_IS_ASH //config: help -//config: Enable support for the 'command' builtin, which allows -//config: you to run the specified command or builtin, -//config: even when there is a function with the same name. +//config: Enable support for the 'command' builtin, which allows +//config: you to run the specified command or builtin, +//config: even when there is a function with the same name. //config: //config:endif # ash options diff --git a/shell/cttyhack.c b/shell/cttyhack.c index 9a5f4bb52..9004b4763 100644 --- a/shell/cttyhack.c +++ b/shell/cttyhack.c @@ -14,45 +14,45 @@ //config: bool "cttyhack (2.5 kb)" //config: default y //config: help -//config: One common problem reported on the mailing list is the "can't -//config: access tty; job control turned off" error message, which typically -//config: appears when one tries to use a shell with stdin/stdout on -//config: /dev/console. -//config: This device is special - it cannot be a controlling tty. +//config: One common problem reported on the mailing list is the "can't +//config: access tty; job control turned off" error message, which typically +//config: appears when one tries to use a shell with stdin/stdout on +//config: /dev/console. +//config: This device is special - it cannot be a controlling tty. //config: -//config: The proper solution is to use the correct device instead of -//config: /dev/console. +//config: The proper solution is to use the correct device instead of +//config: /dev/console. //config: -//config: cttyhack provides a "quick and dirty" solution to this problem. -//config: It analyzes stdin with various ioctls, trying to determine whether -//config: it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line). -//config: On Linux it also checks sysfs for a pointer to the active console. -//config: If cttyhack is able to find the real console device, it closes -//config: stdin/out/err and reopens that device. -//config: Then it executes the given program. Opening the device will make -//config: that device a controlling tty. This may require cttyhack -//config: to be a session leader. +//config: cttyhack provides a "quick and dirty" solution to this problem. +//config: It analyzes stdin with various ioctls, trying to determine whether +//config: it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line). +//config: On Linux it also checks sysfs for a pointer to the active console. +//config: If cttyhack is able to find the real console device, it closes +//config: stdin/out/err and reopens that device. +//config: Then it executes the given program. Opening the device will make +//config: that device a controlling tty. This may require cttyhack +//config: to be a session leader. //config: -//config: Example for /etc/inittab (for busybox init): +//config: Example for /etc/inittab (for busybox init): //config: -//config: ::respawn:/bin/cttyhack /bin/sh +//config: ::respawn:/bin/cttyhack /bin/sh //config: -//config: Starting an interactive shell from boot shell script: +//config: Starting an interactive shell from boot shell script: //config: -//config: setsid cttyhack sh +//config: setsid cttyhack sh //config: -//config: Giving controlling tty to shell running with PID 1: +//config: Giving controlling tty to shell running with PID 1: //config: -//config: # exec cttyhack sh +//config: # exec cttyhack sh //config: -//config: Without cttyhack, you need to know exact tty name, -//config: and do something like this: +//config: Without cttyhack, you need to know exact tty name, +//config: and do something like this: //config: -//config: # exec setsid sh -c 'exec sh /dev/tty1 2>&1' +//config: # exec setsid sh -c 'exec sh /dev/tty1 2>&1' //config: -//config: Starting getty on a controlling tty from a shell script: +//config: Starting getty on a controlling tty from a shell script: //config: -//config: # getty 115200 $(cttyhack) +//config: # getty 115200 $(cttyhack) //usage:#define cttyhack_trivial_usage //usage: "[PROG ARGS]" diff --git a/shell/hush.c b/shell/hush.c index 4f1f81f31..170d5f33b 100644 --- a/shell/hush.c +++ b/shell/hush.c @@ -104,15 +104,15 @@ //config: bool "hush (64 kb)" //config: default y //config: help -//config: hush is a small shell. It handles the normal flow control -//config: constructs such as if/then/elif/else/fi, for/in/do/done, while loops, -//config: case/esac. Redirections, here documents, $((arithmetic)) -//config: and functions are supported. +//config: hush is a small shell. It handles the normal flow control +//config: constructs such as if/then/elif/else/fi, for/in/do/done, while loops, +//config: case/esac. Redirections, here documents, $((arithmetic)) +//config: and functions are supported. //config: -//config: It will compile and work on no-mmu systems. +//config: It will compile and work on no-mmu systems. //config: -//config: It does not handle select, aliases, tilde expansion, -//config: &>file and >&file redirection of stdout+stderr. +//config: It does not handle select, aliases, tilde expansion, +//config: &>file and >&file redirection of stdout+stderr. //config: //config:config HUSH_BASH_COMPAT //config: bool "bash-compatible extensions" @@ -124,17 +124,17 @@ //config: default y //config: depends on HUSH_BASH_COMPAT //config: help -//config: Enable {abc,def} extension. +//config: Enable {abc,def} extension. //config: //config:config HUSH_INTERACTIVE //config: bool "Interactive mode" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable interactive mode (prompt and command editing). -//config: Without this, hush simply reads and executes commands -//config: from stdin just like a shell script from a file. -//config: No prompt, no PS1/PS2 magic shell variables. +//config: Enable interactive mode (prompt and command editing). +//config: Without this, hush simply reads and executes commands +//config: from stdin just like a shell script from a file. +//config: No prompt, no PS1/PS2 magic shell variables. //config: //config:config HUSH_SAVEHISTORY //config: bool "Save command history to .hush_history" @@ -146,18 +146,18 @@ //config: default y //config: depends on HUSH_INTERACTIVE //config: help -//config: Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current -//config: command (not entire shell), fg/bg builtins work. Without this option, -//config: "cmd &" still works by simply spawning a process and immediately -//config: prompting for next command (or executing next command in a script), -//config: but no separate process group is formed. +//config: Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current +//config: command (not entire shell), fg/bg builtins work. Without this option, +//config: "cmd &" still works by simply spawning a process and immediately +//config: prompting for next command (or executing next command in a script), +//config: but no separate process group is formed. //config: //config:config HUSH_TICK //config: bool "Support process substitution" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable `command` and $(command). +//config: Enable `command` and $(command). //config: //config:config HUSH_IF //config: bool "Support if/then/elif/else/fi" @@ -174,37 +174,37 @@ //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable case ... esac statement. +400 bytes. +//config: Enable case ... esac statement. +400 bytes. //config: //config:config HUSH_FUNCTIONS //config: bool "Support funcname() { commands; } syntax" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable support for shell functions. +800 bytes. +//config: Enable support for shell functions. +800 bytes. //config: //config:config HUSH_LOCAL //config: bool "local builtin" //config: default y //config: depends on HUSH_FUNCTIONS //config: help -//config: Enable support for local variables in functions. +//config: Enable support for local variables in functions. //config: //config:config HUSH_RANDOM_SUPPORT //config: bool "Pseudorandom generator and $RANDOM variable" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable pseudorandom generator and dynamic variable "$RANDOM". -//config: Each read of "$RANDOM" will generate a new pseudorandom value. +//config: Enable pseudorandom generator and dynamic variable "$RANDOM". +//config: Each read of "$RANDOM" will generate a new pseudorandom value. //config: //config:config HUSH_MODE_X //config: bool "Support 'hush -x' option and 'set -x' command" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: This instructs hush to print commands before execution. -//config: Adds ~300 bytes. +//config: This instructs hush to print commands before execution. +//config: Adds ~300 bytes. //config: //config:config HUSH_ECHO //config: bool "echo builtin" @@ -236,14 +236,14 @@ //config: default y //config: depends on HUSH_EXPORT //config: help -//config: export -n unexports variables. It is a bash extension. +//config: export -n unexports variables. It is a bash extension. //config: //config:config HUSH_READONLY //config: bool "readonly builtin" //config: default y //config: depends on HUSH || SH_IS_HUSH || BASH_IS_HUSH //config: help -//config: Enable support for read-only variables. +//config: Enable support for read-only variables. //config: //config:config HUSH_KILL //config: bool "kill builtin (supports kill %jobspec)" diff --git a/sysklogd/klogd.c b/sysklogd/klogd.c index b20d86174..728cc8d38 100644 --- a/sysklogd/klogd.c +++ b/sysklogd/klogd.c @@ -20,11 +20,11 @@ //config: bool "klogd (5.5 kb)" //config: default y //config: help -//config: klogd is a utility which intercepts and logs all -//config: messages from the Linux kernel and sends the messages -//config: out to the 'syslogd' utility so they can be logged. If -//config: you wish to record the messages produced by the kernel, -//config: you should enable this option. +//config: klogd is a utility which intercepts and logs all +//config: messages from the Linux kernel and sends the messages +//config: out to the 'syslogd' utility so they can be logged. If +//config: you wish to record the messages produced by the kernel, +//config: you should enable this option. //config: //config:comment "klogd should not be used together with syslog to kernel printk buffer" //config: depends on KLOGD && FEATURE_KMSG_SYSLOG @@ -35,16 +35,16 @@ //config: depends on KLOGD //config: select PLATFORM_LINUX //config: help -//config: The klogd applet supports two interfaces for reading -//config: kernel messages. Linux provides the klogctl() interface -//config: which allows reading messages from the kernel ring buffer -//config: independently from the file system. +//config: The klogd applet supports two interfaces for reading +//config: kernel messages. Linux provides the klogctl() interface +//config: which allows reading messages from the kernel ring buffer +//config: independently from the file system. //config: -//config: If you answer 'N' here, klogd will use the more portable -//config: approach of reading them from /proc or a device node. -//config: However, this method requires the file to be available. +//config: If you answer 'N' here, klogd will use the more portable +//config: approach of reading them from /proc or a device node. +//config: However, this method requires the file to be available. //config: -//config: If in doubt, say 'Y'. +//config: If in doubt, say 'Y'. //applet:IF_KLOGD(APPLET(klogd, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/sysklogd/logger.c b/sysklogd/logger.c index 09fed0c73..6769a8175 100644 --- a/sysklogd/logger.c +++ b/sysklogd/logger.c @@ -11,10 +11,10 @@ //config: default y //config: select FEATURE_SYSLOG //config: help -//config: The logger utility allows you to send arbitrary text -//config: messages to the system log (i.e. the 'syslogd' utility) so -//config: they can be logged. This is generally used to help locate -//config: problems that occur within programs and scripts. +//config: The logger utility allows you to send arbitrary text +//config: messages to the system log (i.e. the 'syslogd' utility) so +//config: they can be logged. This is generally used to help locate +//config: problems that occur within programs and scripts. //applet:IF_LOGGER(APPLET(logger, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/sysklogd/logread.c b/sysklogd/logread.c index dd4c7cb6d..da552e087 100644 --- a/sysklogd/logread.c +++ b/sysklogd/logread.c @@ -14,21 +14,21 @@ //WRONG: it should be compilable without SYSLOG=y: //WRONG: depends on FEATURE_IPC_SYSLOG //config: help -//config: If you enabled Circular Buffer support, you almost -//config: certainly want to enable this feature as well. This -//config: utility will allow you to read the messages that are -//config: stored in the syslogd circular buffer. +//config: If you enabled Circular Buffer support, you almost +//config: certainly want to enable this feature as well. This +//config: utility will allow you to read the messages that are +//config: stored in the syslogd circular buffer. //config: //config:config FEATURE_LOGREAD_REDUCED_LOCKING //config: bool "Double buffering" //config: default y //config: depends on LOGREAD //config: help -//config: 'logread' output to slow serial terminals can have -//config: side effects on syslog because of the semaphore. -//config: This option make logread to double buffer copy -//config: from circular buffer, minimizing semaphore -//config: contention at some minor memory expense. +//config: 'logread' output to slow serial terminals can have +//config: side effects on syslog because of the semaphore. +//config: This option make logread to double buffer copy +//config: from circular buffer, minimizing semaphore +//config: contention at some minor memory expense. //config: //applet:IF_LOGREAD(APPLET(logread, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/sysklogd/syslogd.c b/sysklogd/syslogd.c index a9c9c69bc..31730a7f9 100644 --- a/sysklogd/syslogd.c +++ b/sysklogd/syslogd.c @@ -16,53 +16,53 @@ //config: bool "syslogd (12 kb)" //config: default y //config: help -//config: The syslogd utility is used to record logs of all the -//config: significant events that occur on a system. Every -//config: message that is logged records the date and time of the -//config: event, and will generally also record the name of the -//config: application that generated the message. When used in -//config: conjunction with klogd, messages from the Linux kernel -//config: can also be recorded. This is terribly useful, -//config: especially for finding what happened when something goes -//config: wrong. And something almost always will go wrong if -//config: you wait long enough.... +//config: The syslogd utility is used to record logs of all the +//config: significant events that occur on a system. Every +//config: message that is logged records the date and time of the +//config: event, and will generally also record the name of the +//config: application that generated the message. When used in +//config: conjunction with klogd, messages from the Linux kernel +//config: can also be recorded. This is terribly useful, +//config: especially for finding what happened when something goes +//config: wrong. And something almost always will go wrong if +//config: you wait long enough.... //config: //config:config FEATURE_ROTATE_LOGFILE //config: bool "Rotate message files" //config: default y //config: depends on SYSLOGD //config: help -//config: This enables syslogd to rotate the message files -//config: on his own. No need to use an external rotate script. +//config: This enables syslogd to rotate the message files +//config: on his own. No need to use an external rotate script. //config: //config:config FEATURE_REMOTE_LOG //config: bool "Remote Log support" //config: default y //config: depends on SYSLOGD //config: help -//config: When you enable this feature, the syslogd utility can -//config: be used to send system log messages to another system -//config: connected via a network. This allows the remote -//config: machine to log all the system messages, which can be -//config: terribly useful for reducing the number of serial -//config: cables you use. It can also be a very good security -//config: measure to prevent system logs from being tampered with -//config: by an intruder. +//config: When you enable this feature, the syslogd utility can +//config: be used to send system log messages to another system +//config: connected via a network. This allows the remote +//config: machine to log all the system messages, which can be +//config: terribly useful for reducing the number of serial +//config: cables you use. It can also be a very good security +//config: measure to prevent system logs from being tampered with +//config: by an intruder. //config: //config:config FEATURE_SYSLOGD_DUP //config: bool "Support -D (drop dups) option" //config: default y //config: depends on SYSLOGD //config: help -//config: Option -D instructs syslogd to drop consecutive messages -//config: which are totally the same. +//config: Option -D instructs syslogd to drop consecutive messages +//config: which are totally the same. //config: //config:config FEATURE_SYSLOGD_CFG //config: bool "Support syslog.conf" //config: default y //config: depends on SYSLOGD //config: help -//config: Supports restricted syslogd config. See docs/syslog.conf.txt +//config: Supports restricted syslogd config. See docs/syslog.conf.txt //config: //config:config FEATURE_SYSLOGD_READ_BUFFER_SIZE //config: int "Read buffer size in bytes" @@ -70,23 +70,23 @@ //config: range 256 20000 //config: depends on SYSLOGD //config: help -//config: This option sets the size of the syslog read buffer. -//config: Actual memory usage increases around five times the -//config: change done here. +//config: This option sets the size of the syslog read buffer. +//config: Actual memory usage increases around five times the +//config: change done here. //config: //config:config FEATURE_IPC_SYSLOG //config: bool "Circular Buffer support" //config: default y //config: depends on SYSLOGD //config: help -//config: When you enable this feature, the syslogd utility will -//config: use a circular buffer to record system log messages. -//config: When the buffer is filled it will continue to overwrite -//config: the oldest messages. This can be very useful for -//config: systems with little or no permanent storage, since -//config: otherwise system logs can eventually fill up your -//config: entire filesystem, which may cause your system to -//config: break badly. +//config: When you enable this feature, the syslogd utility will +//config: use a circular buffer to record system log messages. +//config: When the buffer is filled it will continue to overwrite +//config: the oldest messages. This can be very useful for +//config: systems with little or no permanent storage, since +//config: otherwise system logs can eventually fill up your +//config: entire filesystem, which may cause your system to +//config: break badly. //config: //config:config FEATURE_IPC_SYSLOG_BUFFER_SIZE //config: int "Circular buffer size in Kbytes (minimum 4KB)" @@ -94,8 +94,8 @@ //config: range 4 2147483647 //config: depends on FEATURE_IPC_SYSLOG //config: help -//config: This option sets the size of the circular buffer -//config: used to record system log messages. +//config: This option sets the size of the circular buffer +//config: used to record system log messages. //config: //config:config FEATURE_KMSG_SYSLOG //config: bool "Linux kernel printk buffer support" @@ -103,12 +103,12 @@ //config: depends on SYSLOGD //config: select PLATFORM_LINUX //config: help -//config: When you enable this feature, the syslogd utility will -//config: write system log message to the Linux kernel's printk buffer. -//config: This can be used as a smaller alternative to the syslogd IPC -//config: support, as klogd and logread aren't needed. +//config: When you enable this feature, the syslogd utility will +//config: write system log message to the Linux kernel's printk buffer. +//config: This can be used as a smaller alternative to the syslogd IPC +//config: support, as klogd and logread aren't needed. //config: -//config: NOTICE: Syslog facilities in log entries needs kernel 3.5+. +//config: NOTICE: Syslog facilities in log entries needs kernel 3.5+. //applet:IF_SYSLOGD(APPLET(syslogd, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/Config.src b/util-linux/Config.src index 0971d714a..68fcc266f 100644 --- a/util-linux/Config.src +++ b/util-linux/Config.src @@ -15,29 +15,29 @@ config FEATURE_MOUNT_LOOP default y depends on MOUNT || UMOUNT help - Enabling this feature allows automatic mounting of files (containing - filesystem images) via the linux kernel's loopback devices. - The mount command will detect you are trying to mount a file instead - of a block device, and transparently associate the file with a - loopback device. The umount command will also free that loopback - device. + Enabling this feature allows automatic mounting of files (containing + filesystem images) via the linux kernel's loopback devices. + The mount command will detect you are trying to mount a file instead + of a block device, and transparently associate the file with a + loopback device. The umount command will also free that loopback + device. - You can still use the 'losetup' utility (to manually associate files - with loop devices) if you need to do something advanced, such as - specify an offset or cryptographic options to the loopback device. - (If you don't want umount to free the loop device, use "umount -D".) + You can still use the 'losetup' utility (to manually associate files + with loop devices) if you need to do something advanced, such as + specify an offset or cryptographic options to the loopback device. + (If you don't want umount to free the loop device, use "umount -D".) config FEATURE_MOUNT_LOOP_CREATE bool "Create new loopback devices if needed" default y depends on FEATURE_MOUNT_LOOP help - Linux kernels >= 2.6.24 support unlimited loopback devices. They are - allocated for use when trying to use a loop device. The loop device - must however exist. + Linux kernels >= 2.6.24 support unlimited loopback devices. They are + allocated for use when trying to use a loop device. The loop device + must however exist. - This feature lets mount to try to create next /dev/loopN device - if it does not find a free one. + This feature lets mount to try to create next /dev/loopN device + if it does not find a free one. config FEATURE_MTAB_SUPPORT bool "Support old /etc/mtab file" @@ -45,23 +45,23 @@ config FEATURE_MTAB_SUPPORT depends on MOUNT || UMOUNT select FEATURE_MOUNT_FAKE help - Historically, Unix systems kept track of the currently mounted - partitions in the file "/etc/mtab". These days, the kernel exports - the list of currently mounted partitions in "/proc/mounts", rendering - the old mtab file obsolete. (In modern systems, /etc/mtab should be - a symlink to /proc/mounts.) + Historically, Unix systems kept track of the currently mounted + partitions in the file "/etc/mtab". These days, the kernel exports + the list of currently mounted partitions in "/proc/mounts", rendering + the old mtab file obsolete. (In modern systems, /etc/mtab should be + a symlink to /proc/mounts.) - The only reason to have mount maintain an /etc/mtab file itself is if - your stripped-down embedded system does not have a /proc directory. - If you must use this, keep in mind it's inherently brittle (for - example a mount under chroot won't update it), can't handle modern - features like separate per-process filesystem namespaces, requires - that your /etc directory be writable, tends to get easily confused - by --bind or --move mounts, won't update if you rename a directory - that contains a mount point, and so on. (In brief: avoid.) + The only reason to have mount maintain an /etc/mtab file itself is if + your stripped-down embedded system does not have a /proc directory. + If you must use this, keep in mind it's inherently brittle (for + example a mount under chroot won't update it), can't handle modern + features like separate per-process filesystem namespaces, requires + that your /etc directory be writable, tends to get easily confused + by --bind or --move mounts, won't update if you rename a directory + that contains a mount point, and so on. (In brief: avoid.) - About the only reason to use this is if you've removed /proc from - your kernel. + About the only reason to use this is if you've removed /proc from + your kernel. source util-linux/volume_id/Config.in diff --git a/util-linux/acpid.c b/util-linux/acpid.c index 7abea1400..3c3811752 100644 --- a/util-linux/acpid.c +++ b/util-linux/acpid.c @@ -11,23 +11,23 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: acpid listens to ACPI events coming either in textual form from -//config: /proc/acpi/event (though it is marked deprecated it is still widely -//config: used and _is_ a standard) or in binary form from specified evdevs -//config: (just use /dev/input/event*). +//config: acpid listens to ACPI events coming either in textual form from +//config: /proc/acpi/event (though it is marked deprecated it is still widely +//config: used and _is_ a standard) or in binary form from specified evdevs +//config: (just use /dev/input/event*). //config: -//config: It parses the event to retrieve ACTION and a possible PARAMETER. -//config: It then spawns /etc/acpi/[/] either via run-parts -//config: (if the resulting path is a directory) or directly as an executable. +//config: It parses the event to retrieve ACTION and a possible PARAMETER. +//config: It then spawns /etc/acpi/[/] either via run-parts +//config: (if the resulting path is a directory) or directly as an executable. //config: -//config: N.B. acpid relies on run-parts so have the latter installed. +//config: N.B. acpid relies on run-parts so have the latter installed. //config: //config:config FEATURE_ACPID_COMPAT //config: bool "Accept and ignore redundant options" //config: default y //config: depends on ACPID //config: help -//config: Accept and ignore compatibility options -g -m -s -S -v. +//config: Accept and ignore compatibility options -g -m -s -S -v. //applet:IF_ACPID(APPLET(acpid, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/blkdiscard.c b/util-linux/blkdiscard.c index 690062970..8f6a4ab6c 100644 --- a/util-linux/blkdiscard.c +++ b/util-linux/blkdiscard.c @@ -9,7 +9,7 @@ //config: bool "blkdiscard (5.3 kb)" //config: default y //config: help -//config: blkdiscard discards sectors on a given device. +//config: blkdiscard discards sectors on a given device. //kbuild:lib-$(CONFIG_BLKDISCARD) += blkdiscard.o //applet:IF_BLKDISCARD(APPLET(blkdiscard, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/blkid.c b/util-linux/blkid.c index 08fa07968..f353cf248 100644 --- a/util-linux/blkid.c +++ b/util-linux/blkid.c @@ -12,16 +12,16 @@ //config: select PLATFORM_LINUX //config: select VOLUMEID //config: help -//config: Lists labels and UUIDs of all filesystems. -//config: WARNING: -//config: With all submodules selected, it will add ~8k to busybox. +//config: Lists labels and UUIDs of all filesystems. +//config: WARNING: +//config: With all submodules selected, it will add ~8k to busybox. //config: //config:config FEATURE_BLKID_TYPE //config: bool "Print filesystem type" //config: default n //config: depends on BLKID //config: help -//config: Show TYPE="filesystem type" +//config: Show TYPE="filesystem type" //applet:IF_BLKID(APPLET(blkid, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/blockdev.c b/util-linux/blockdev.c index 9924ef06f..9e1fef206 100644 --- a/util-linux/blockdev.c +++ b/util-linux/blockdev.c @@ -9,7 +9,7 @@ //config: bool "blockdev (2.4 kb)" //config: default y //config: help -//config: Performs some ioctls with block devices. +//config: Performs some ioctls with block devices. //applet:IF_BLOCKDEV(APPLET(blockdev, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/cal.c b/util-linux/cal.c index f7a965619..091fdbd2b 100644 --- a/util-linux/cal.c +++ b/util-linux/cal.c @@ -14,7 +14,7 @@ //config: bool "cal (6.5 kb)" //config: default y //config: help -//config: cal is used to display a monthly calendar. +//config: cal is used to display a monthly calendar. //applet:IF_CAL(APPLET(cal, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/chrt.c b/util-linux/chrt.c index ad13dd512..4bc8b6cfa 100644 --- a/util-linux/chrt.c +++ b/util-linux/chrt.c @@ -9,8 +9,8 @@ //config: bool "chrt (4.4 kb)" //config: default y //config: help -//config: manipulate real-time attributes of a process. -//config: This requires sched_{g,s}etparam support in your libc. +//config: manipulate real-time attributes of a process. +//config: This requires sched_{g,s}etparam support in your libc. //applet:IF_CHRT(APPLET(chrt, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/dmesg.c b/util-linux/dmesg.c index 5822d0290..6da9d9f4e 100644 --- a/util-linux/dmesg.c +++ b/util-linux/dmesg.c @@ -13,34 +13,34 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: dmesg is used to examine or control the kernel ring buffer. When the -//config: Linux kernel prints messages to the system log, they are stored in -//config: the kernel ring buffer. You can use dmesg to print the kernel's ring -//config: buffer, clear the kernel ring buffer, change the size of the kernel -//config: ring buffer, and change the priority level at which kernel messages -//config: are also logged to the system console. Enable this option if you -//config: wish to enable the 'dmesg' utility. +//config: dmesg is used to examine or control the kernel ring buffer. When the +//config: Linux kernel prints messages to the system log, they are stored in +//config: the kernel ring buffer. You can use dmesg to print the kernel's ring +//config: buffer, clear the kernel ring buffer, change the size of the kernel +//config: ring buffer, and change the priority level at which kernel messages +//config: are also logged to the system console. Enable this option if you +//config: wish to enable the 'dmesg' utility. //config: //config:config FEATURE_DMESG_PRETTY //config: bool "Pretty output" //config: default y //config: depends on DMESG //config: help -//config: If you wish to scrub the syslog level from the output, say 'Y' here. -//config: The syslog level is a string prefixed to every line with the form -//config: "<#>". +//config: If you wish to scrub the syslog level from the output, say 'Y' here. +//config: The syslog level is a string prefixed to every line with the form +//config: "<#>". //config: -//config: With this option you will see: -//config: # dmesg -//config: Linux version 2.6.17.4 ..... -//config: BIOS-provided physical RAM map: -//config: BIOS-e820: 0000000000000000 - 000000000009f000 (usable) +//config: With this option you will see: +//config: # dmesg +//config: Linux version 2.6.17.4 ..... +//config: BIOS-provided physical RAM map: +//config: BIOS-e820: 0000000000000000 - 000000000009f000 (usable) //config: -//config: Without this option you will see: -//config: # dmesg -//config: <5>Linux version 2.6.17.4 ..... -//config: <6>BIOS-provided physical RAM map: -//config: <6> BIOS-e820: 0000000000000000 - 000000000009f000 (usable) +//config: Without this option you will see: +//config: # dmesg +//config: <5>Linux version 2.6.17.4 ..... +//config: <6>BIOS-provided physical RAM map: +//config: <6> BIOS-e820: 0000000000000000 - 000000000009f000 (usable) //applet:IF_DMESG(APPLET(dmesg, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/eject.c b/util-linux/eject.c index 07ac2fd54..8095cbef0 100644 --- a/util-linux/eject.c +++ b/util-linux/eject.c @@ -17,15 +17,15 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Used to eject cdroms. (defaults to /dev/cdrom) +//config: Used to eject cdroms. (defaults to /dev/cdrom) //config: //config:config FEATURE_EJECT_SCSI //config: bool "SCSI support" //config: default y //config: depends on EJECT //config: help -//config: Add the -s option to eject, this allows to eject SCSI-Devices and -//config: usb-storage devices. +//config: Add the -s option to eject, this allows to eject SCSI-Devices and +//config: usb-storage devices. //applet:IF_EJECT(APPLET(eject, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/fallocate.c b/util-linux/fallocate.c index 34f01ebd5..70e7e178f 100644 --- a/util-linux/fallocate.c +++ b/util-linux/fallocate.c @@ -9,7 +9,7 @@ //config: bool "fallocate (5 kb)" //config: default y //config: help -//config: Preallocate space for files. +//config: Preallocate space for files. //applet:IF_FALLOCATE(APPLET(fallocate, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/fatattr.c b/util-linux/fatattr.c index e69cb93e7..9fb566d5a 100644 --- a/util-linux/fatattr.c +++ b/util-linux/fatattr.c @@ -13,7 +13,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: fatattr lists or changes the file attributes on a fat file system. +//config: fatattr lists or changes the file attributes on a fat file system. //applet:IF_FATATTR(APPLET(fatattr, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/fbset.c b/util-linux/fbset.c index 0b141816d..11cb20cb2 100644 --- a/util-linux/fbset.c +++ b/util-linux/fbset.c @@ -16,29 +16,29 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: fbset is used to show or change the settings of a Linux frame buffer -//config: device. The frame buffer device provides a simple and unique -//config: interface to access a graphics display. Enable this option -//config: if you wish to enable the 'fbset' utility. +//config: fbset is used to show or change the settings of a Linux frame buffer +//config: device. The frame buffer device provides a simple and unique +//config: interface to access a graphics display. Enable this option +//config: if you wish to enable the 'fbset' utility. //config: //config:config FEATURE_FBSET_FANCY //config: bool "Enable extra options" //config: default y //config: depends on FBSET //config: help -//config: This option enables extended fbset options, allowing one to set the -//config: framebuffer size, color depth, etc. interface to access a graphics -//config: display. Enable this option if you wish to enable extended fbset -//config: options. +//config: This option enables extended fbset options, allowing one to set the +//config: framebuffer size, color depth, etc. interface to access a graphics +//config: display. Enable this option if you wish to enable extended fbset +//config: options. //config: //config:config FEATURE_FBSET_READMODE //config: bool "Enable readmode support" //config: default y //config: depends on FBSET //config: help -//config: This option allows fbset to read the video mode database stored by -//config: default as /etc/fb.modes, which can be used to set frame buffer -//config: device to pre-defined video modes. +//config: This option allows fbset to read the video mode database stored by +//config: default as /etc/fb.modes, which can be used to set frame buffer +//config: device to pre-defined video modes. //applet:IF_FBSET(APPLET(fbset, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/fdformat.c b/util-linux/fdformat.c index 62077ff3b..6faaf1b10 100644 --- a/util-linux/fdformat.c +++ b/util-linux/fdformat.c @@ -9,7 +9,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: fdformat is used to low-level format a floppy disk. +//config: fdformat is used to low-level format a floppy disk. //applet:IF_FDFORMAT(APPLET(fdformat, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/fdisk.c b/util-linux/fdisk.c index c3784c28d..e00f85864 100644 --- a/util-linux/fdisk.c +++ b/util-linux/fdisk.c @@ -11,10 +11,10 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The fdisk utility is used to divide hard disks into one or more -//config: logical disks, which are generally called partitions. This utility -//config: can be used to list and edit the set of partitions or BSD style -//config: 'disk slices' that are defined on a hard drive. +//config: The fdisk utility is used to divide hard disks into one or more +//config: logical disks, which are generally called partitions. This utility +//config: can be used to list and edit the set of partitions or BSD style +//config: 'disk slices' that are defined on a hard drive. //config: //config:config FDISK_SUPPORT_LARGE_DISKS //config: bool "Support over 4GB disks" @@ -27,59 +27,59 @@ //config: default y //config: depends on FDISK //config: help -//config: Enabling this option allows you to create or change a partition table -//config: and write those changes out to disk. If you leave this option -//config: disabled, you will only be able to view the partition table. +//config: Enabling this option allows you to create or change a partition table +//config: and write those changes out to disk. If you leave this option +//config: disabled, you will only be able to view the partition table. //config: //config:config FEATURE_AIX_LABEL //config: bool "Support AIX disklabels" //config: default n //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to create or change AIX disklabels. -//config: Most people can safely leave this option disabled. +//config: Enabling this option allows you to create or change AIX disklabels. +//config: Most people can safely leave this option disabled. //config: //config:config FEATURE_SGI_LABEL //config: bool "Support SGI disklabels" //config: default n //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to create or change SGI disklabels. -//config: Most people can safely leave this option disabled. +//config: Enabling this option allows you to create or change SGI disklabels. +//config: Most people can safely leave this option disabled. //config: //config:config FEATURE_SUN_LABEL //config: bool "Support SUN disklabels" //config: default n //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to create or change SUN disklabels. -//config: Most people can safely leave this option disabled. +//config: Enabling this option allows you to create or change SUN disklabels. +//config: Most people can safely leave this option disabled. //config: //config:config FEATURE_OSF_LABEL //config: bool "Support BSD disklabels" //config: default n //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to create or change BSD disklabels -//config: and define and edit BSD disk slices. +//config: Enabling this option allows you to create or change BSD disklabels +//config: and define and edit BSD disk slices. //config: //config:config FEATURE_GPT_LABEL //config: bool "Support GPT disklabels" //config: default n //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to view GUID Partition Table -//config: disklabels. +//config: Enabling this option allows you to view GUID Partition Table +//config: disklabels. //config: //config:config FEATURE_FDISK_ADVANCED //config: bool "Support expert mode" //config: default y //config: depends on FDISK && FEATURE_FDISK_WRITABLE //config: help -//config: Enabling this option allows you to do terribly unsafe things like -//config: define arbitrary drive geometry, move the beginning of data in a -//config: partition, and similarly evil things. Unless you have a very good -//config: reason you would be wise to leave this disabled. +//config: Enabling this option allows you to do terribly unsafe things like +//config: define arbitrary drive geometry, move the beginning of data in a +//config: partition, and similarly evil things. Unless you have a very good +//config: reason you would be wise to leave this disabled. //applet:IF_FDISK(APPLET(fdisk, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/findfs.c b/util-linux/findfs.c index b9cd95687..359da581f 100644 --- a/util-linux/findfs.c +++ b/util-linux/findfs.c @@ -13,9 +13,9 @@ //config: select PLATFORM_LINUX //config: select VOLUMEID //config: help -//config: Prints the name of a filesystem with given label or UUID. -//config: WARNING: -//config: With all submodules selected, it will add ~8k to busybox. +//config: Prints the name of a filesystem with given label or UUID. +//config: WARNING: +//config: With all submodules selected, it will add ~8k to busybox. /* Benefits from suid root: better access to /dev/BLOCKDEVs: */ //applet:IF_FINDFS(APPLET(findfs, BB_DIR_SBIN, BB_SUID_MAYBE)) diff --git a/util-linux/flock.c b/util-linux/flock.c index e77718869..ec35af18f 100644 --- a/util-linux/flock.c +++ b/util-linux/flock.c @@ -7,7 +7,7 @@ //config: bool "flock (6.1 kb)" //config: default y //config: help -//config: Manage locks from shell scripts +//config: Manage locks from shell scripts //applet:IF_FLOCK(APPLET(flock, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/freeramdisk.c b/util-linux/freeramdisk.c index 0b8d2bc5b..55187cb40 100644 --- a/util-linux/freeramdisk.c +++ b/util-linux/freeramdisk.c @@ -13,25 +13,25 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: fdflush is only needed when changing media on slightly-broken -//config: removable media drives. It is used to make Linux believe that a -//config: hardware disk-change switch has been actuated, which causes Linux to -//config: forget anything it has cached from the previous media. If you have -//config: such a slightly-broken drive, you will need to run fdflush every time -//config: you change a disk. Most people have working hardware and can safely -//config: leave this disabled. +//config: fdflush is only needed when changing media on slightly-broken +//config: removable media drives. It is used to make Linux believe that a +//config: hardware disk-change switch has been actuated, which causes Linux to +//config: forget anything it has cached from the previous media. If you have +//config: such a slightly-broken drive, you will need to run fdflush every time +//config: you change a disk. Most people have working hardware and can safely +//config: leave this disabled. //config: //config:config FREERAMDISK //config: bool "freeramdisk (1.4 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Linux allows you to create ramdisks. This utility allows you to -//config: delete them and completely free all memory that was used for the -//config: ramdisk. For example, if you boot Linux into a ramdisk and later -//config: pivot_root, you may want to free the memory that is allocated to the -//config: ramdisk. If you have no use for freeing memory from a ramdisk, leave -//config: this disabled. +//config: Linux allows you to create ramdisks. This utility allows you to +//config: delete them and completely free all memory that was used for the +//config: ramdisk. For example, if you boot Linux into a ramdisk and later +//config: pivot_root, you may want to free the memory that is allocated to the +//config: ramdisk. If you have no use for freeing memory from a ramdisk, leave +//config: this disabled. // APPLET_ODDNAME:name main location suid_type help //applet:IF_FDFLUSH(APPLET_ODDNAME(fdflush, freeramdisk, BB_DIR_BIN, BB_SUID_DROP, fdflush)) diff --git a/util-linux/fsck_minix.c b/util-linux/fsck_minix.c index 2ab7530ea..8c2b7d8de 100644 --- a/util-linux/fsck_minix.c +++ b/util-linux/fsck_minix.c @@ -89,12 +89,12 @@ //config: bool "fsck_minix" //config: default y //config: help -//config: The minix filesystem is a nice, small, compact, read-write filesystem -//config: with little overhead. It is not a journaling filesystem however and -//config: can experience corruption if it is not properly unmounted or if the -//config: power goes off in the middle of a write. This utility allows you to -//config: check for and attempt to repair any corruption that occurs to a minix -//config: filesystem. +//config: The minix filesystem is a nice, small, compact, read-write filesystem +//config: with little overhead. It is not a journaling filesystem however and +//config: can experience corruption if it is not properly unmounted or if the +//config: power goes off in the middle of a write. This utility allows you to +//config: check for and attempt to repair any corruption that occurs to a minix +//config: filesystem. //applet:IF_FSCK_MINIX(APPLET_ODDNAME(fsck.minix, fsck_minix, BB_DIR_SBIN, BB_SUID_DROP, fsck_minix)) diff --git a/util-linux/fsfreeze.c b/util-linux/fsfreeze.c index 8bc4c471f..5c10c8044 100644 --- a/util-linux/fsfreeze.c +++ b/util-linux/fsfreeze.c @@ -11,7 +11,7 @@ //config: select PLATFORM_LINUX //config: select LONG_OPTS //config: help -//config: Halt new accesses and flush writes on a mounted filesystem. +//config: Halt new accesses and flush writes on a mounted filesystem. //applet:IF_FSFREEZE(APPLET(fsfreeze, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/fstrim.c b/util-linux/fstrim.c index c07da8a62..6d0d61d92 100644 --- a/util-linux/fstrim.c +++ b/util-linux/fstrim.c @@ -13,7 +13,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Discard unused blocks on a mounted filesystem. +//config: Discard unused blocks on a mounted filesystem. //applet:IF_FSTRIM(APPLET(fstrim, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/getopt.c b/util-linux/getopt.c index 7c65a6a1f..cd5679cff 100644 --- a/util-linux/getopt.c +++ b/util-linux/getopt.c @@ -33,19 +33,19 @@ //config: bool "getopt (5.6 kb)" //config: default y //config: help -//config: The getopt utility is used to break up (parse) options in command -//config: lines to make it easy to write complex shell scripts that also check -//config: for legal (and illegal) options. If you want to write horribly -//config: complex shell scripts, or use some horribly complex shell script -//config: written by others, this utility may be for you. Most people will -//config: wisely leave this disabled. +//config: The getopt utility is used to break up (parse) options in command +//config: lines to make it easy to write complex shell scripts that also check +//config: for legal (and illegal) options. If you want to write horribly +//config: complex shell scripts, or use some horribly complex shell script +//config: written by others, this utility may be for you. Most people will +//config: wisely leave this disabled. //config: //config:config FEATURE_GETOPT_LONG //config: bool "Support option -l" //config: default y if LONG_OPTS //config: depends on GETOPT //config: help -//config: Enable support for long options (option -l). +//config: Enable support for long options (option -l). //applet:IF_GETOPT(APPLET(getopt, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/hexdump.c b/util-linux/hexdump.c index e8c0ee0f5..719feaf4e 100644 --- a/util-linux/hexdump.c +++ b/util-linux/hexdump.c @@ -12,24 +12,24 @@ //config: bool "hexdump (8.8 kb)" //config: default y //config: help -//config: The hexdump utility is used to display binary data in a readable -//config: way that is comparable to the output from most hex editors. +//config: The hexdump utility is used to display binary data in a readable +//config: way that is comparable to the output from most hex editors. //config: //config:config FEATURE_HEXDUMP_REVERSE //config: bool "Support -R, reverse of 'hexdump -Cv'" //config: default y //config: depends on HEXDUMP //config: help -//config: The hexdump utility is used to display binary data in an ascii -//config: readable way. This option creates binary data from an ascii input. -//config: NB: this option is non-standard. It's unwise to use it in scripts -//config: aimed to be portable. +//config: The hexdump utility is used to display binary data in an ascii +//config: readable way. This option creates binary data from an ascii input. +//config: NB: this option is non-standard. It's unwise to use it in scripts +//config: aimed to be portable. //config: //config:config HD //config: bool "hd (8 kb)" //config: default y //config: help -//config: hd is an alias to hexdump -C. +//config: hd is an alias to hexdump -C. //applet:IF_HEXDUMP(APPLET_NOEXEC(hexdump, hexdump, BB_DIR_USR_BIN, BB_SUID_DROP, hexdump)) //applet:IF_HD(APPLET_NOEXEC(hd, hexdump, BB_DIR_USR_BIN, BB_SUID_DROP, hd)) diff --git a/util-linux/hexdump_xxd.c b/util-linux/hexdump_xxd.c index 5f72d3be4..37e58f2d0 100644 --- a/util-linux/hexdump_xxd.c +++ b/util-linux/hexdump_xxd.c @@ -10,8 +10,8 @@ //config: bool "xxd (8.9 kb)" //config: default y //config: help -//config: The xxd utility is used to display binary data in a readable -//config: way that is comparable to the output from most hex editors. +//config: The xxd utility is used to display binary data in a readable +//config: way that is comparable to the output from most hex editors. //applet:IF_XXD(APPLET_NOEXEC(xxd, xxd, BB_DIR_USR_BIN, BB_SUID_DROP, xxd)) diff --git a/util-linux/hwclock.c b/util-linux/hwclock.c index c2721dbac..5df56de15 100644 --- a/util-linux/hwclock.c +++ b/util-linux/hwclock.c @@ -11,10 +11,10 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The hwclock utility is used to read and set the hardware clock -//config: on a system. This is primarily used to set the current time on -//config: shutdown in the hardware clock, so the hardware will keep the -//config: correct time when Linux is _not_ running. +//config: The hwclock utility is used to read and set the hardware clock +//config: on a system. This is primarily used to set the current time on +//config: shutdown in the hardware clock, so the hardware will keep the +//config: correct time when Linux is _not_ running. //config: //config:config FEATURE_HWCLOCK_LONG_OPTIONS //config: bool "Support long options (--hctosys,...)" @@ -26,12 +26,12 @@ //config: default n # util-linux-ng in Fedora 13 still uses /etc/adjtime //config: depends on HWCLOCK //config: help -//config: Starting with FHS 2.3, the adjtime state file is supposed to exist -//config: at /var/lib/hwclock/adjtime instead of /etc/adjtime. If you wish -//config: to use the FHS behavior, answer Y here, otherwise answer N for the -//config: classic /etc/adjtime path. +//config: Starting with FHS 2.3, the adjtime state file is supposed to exist +//config: at /var/lib/hwclock/adjtime instead of /etc/adjtime. If you wish +//config: to use the FHS behavior, answer Y here, otherwise answer N for the +//config: classic /etc/adjtime path. //config: -//config: pathname.com/fhs/pub/fhs-2.3.html#VARLIBHWCLOCKSTATEDIRECTORYFORHWCLO +//config: pathname.com/fhs/pub/fhs-2.3.html#VARLIBHWCLOCKSTATEDIRECTORYFORHWCLO //applet:IF_HWCLOCK(APPLET(hwclock, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/ionice.c b/util-linux/ionice.c index cda5a90d6..c7b7f0373 100644 --- a/util-linux/ionice.c +++ b/util-linux/ionice.c @@ -11,8 +11,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Set/set program io scheduling class and priority -//config: Requires kernel >= 2.6.13 +//config: Set/set program io scheduling class and priority +//config: Requires kernel >= 2.6.13 //applet:IF_IONICE(APPLET(ionice, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/ipcrm.c b/util-linux/ipcrm.c index cabd8b9e7..c51d33143 100644 --- a/util-linux/ipcrm.c +++ b/util-linux/ipcrm.c @@ -11,9 +11,9 @@ //config: bool "ipcrm (2.9 kb)" //config: default y //config: help -//config: The ipcrm utility allows the removal of System V interprocess -//config: communication (IPC) objects and the associated data structures -//config: from the system. +//config: The ipcrm utility allows the removal of System V interprocess +//config: communication (IPC) objects and the associated data structures +//config: from the system. //applet:IF_IPCRM(APPLET(ipcrm, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/ipcs.c b/util-linux/ipcs.c index 0d5a16a2b..1404930d4 100644 --- a/util-linux/ipcs.c +++ b/util-linux/ipcs.c @@ -12,8 +12,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The ipcs utility is used to provide information on the currently -//config: allocated System V interprocess (IPC) objects in the system. +//config: The ipcs utility is used to provide information on the currently +//config: allocated System V interprocess (IPC) objects in the system. //applet:IF_IPCS(APPLET(ipcs, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/last.c b/util-linux/last.c index 5bce85753..f5ee8e5f4 100644 --- a/util-linux/last.c +++ b/util-linux/last.c @@ -11,15 +11,15 @@ //config: default y //config: depends on FEATURE_WTMP //config: help -//config: 'last' displays a list of the last users that logged into the system. +//config: 'last' displays a list of the last users that logged into the system. //config: //config:config FEATURE_LAST_FANCY //config: bool "Output extra information" //config: default y //config: depends on LAST //config: help -//config: 'last' displays detailed information about the last users that -//config: logged into the system (mimics sysvinit last). +900 bytes. +//config: 'last' displays detailed information about the last users that +//config: logged into the system (mimics sysvinit last). +900 bytes. //applet:IF_LAST(APPLET(last, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/losetup.c b/util-linux/losetup.c index cbd1c6052..c608de6cc 100644 --- a/util-linux/losetup.c +++ b/util-linux/losetup.c @@ -11,9 +11,9 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: losetup is used to associate or detach a loop device with a regular -//config: file or block device, and to query the status of a loop device. This -//config: version does not currently support enabling data encryption. +//config: losetup is used to associate or detach a loop device with a regular +//config: file or block device, and to query the status of a loop device. This +//config: version does not currently support enabling data encryption. //kbuild:lib-$(CONFIG_LOSETUP) += losetup.o diff --git a/util-linux/lspci.c b/util-linux/lspci.c index c4f43bd12..3877deb67 100644 --- a/util-linux/lspci.c +++ b/util-linux/lspci.c @@ -11,10 +11,10 @@ //config: default y //config: #select PLATFORM_LINUX //config: help -//config: lspci is a utility for displaying information about PCI buses in the -//config: system and devices connected to them. +//config: lspci is a utility for displaying information about PCI buses in the +//config: system and devices connected to them. //config: -//config: This version uses sysfs (/sys/bus/pci/devices) only. +//config: This version uses sysfs (/sys/bus/pci/devices) only. //applet:IF_LSPCI(APPLET(lspci, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/lsusb.c b/util-linux/lsusb.c index 9d12d8752..cabf047cf 100644 --- a/util-linux/lsusb.c +++ b/util-linux/lsusb.c @@ -11,10 +11,10 @@ //config: default y //config: #select PLATFORM_LINUX //config: help -//config: lsusb is a utility for displaying information about USB buses in the -//config: system and devices connected to them. +//config: lsusb is a utility for displaying information about USB buses in the +//config: system and devices connected to them. //config: -//config: This version uses sysfs (/sys/bus/usb/devices) only. +//config: This version uses sysfs (/sys/bus/usb/devices) only. //applet:IF_LSUSB(APPLET(lsusb, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/mdev.c b/util-linux/mdev.c index a68e3f4e6..23b6f8285 100644 --- a/util-linux/mdev.c +++ b/util-linux/mdev.c @@ -13,58 +13,58 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: mdev is a mini-udev implementation for dynamically creating device -//config: nodes in the /dev directory. +//config: mdev is a mini-udev implementation for dynamically creating device +//config: nodes in the /dev directory. //config: -//config: For more information, please see docs/mdev.txt +//config: For more information, please see docs/mdev.txt //config: //config:config FEATURE_MDEV_CONF //config: bool "Support /etc/mdev.conf" //config: default y //config: depends on MDEV //config: help -//config: Add support for the mdev config file to control ownership and -//config: permissions of the device nodes. +//config: Add support for the mdev config file to control ownership and +//config: permissions of the device nodes. //config: -//config: For more information, please see docs/mdev.txt +//config: For more information, please see docs/mdev.txt //config: //config:config FEATURE_MDEV_RENAME //config: bool "Support subdirs/symlinks" //config: default y //config: depends on FEATURE_MDEV_CONF //config: help -//config: Add support for renaming devices and creating symlinks. +//config: Add support for renaming devices and creating symlinks. //config: -//config: For more information, please see docs/mdev.txt +//config: For more information, please see docs/mdev.txt //config: //config:config FEATURE_MDEV_RENAME_REGEXP //config: bool "Support regular expressions substitutions when renaming device" //config: default y //config: depends on FEATURE_MDEV_RENAME //config: help -//config: Add support for regular expressions substitutions when renaming -//config: device. +//config: Add support for regular expressions substitutions when renaming +//config: device. //config: //config:config FEATURE_MDEV_EXEC //config: bool "Support command execution at device addition/removal" //config: default y //config: depends on FEATURE_MDEV_CONF //config: help -//config: This adds support for an optional field to /etc/mdev.conf for -//config: executing commands when devices are created/removed. +//config: This adds support for an optional field to /etc/mdev.conf for +//config: executing commands when devices are created/removed. //config: -//config: For more information, please see docs/mdev.txt +//config: For more information, please see docs/mdev.txt //config: //config:config FEATURE_MDEV_LOAD_FIRMWARE //config: bool "Support loading of firmwares" //config: default y //config: depends on MDEV //config: help -//config: Some devices need to load firmware before they can be usable. +//config: Some devices need to load firmware before they can be usable. //config: -//config: These devices will request userspace look up the files in -//config: /lib/firmware/ and if it exists, send it to the kernel for -//config: loading into the hardware. +//config: These devices will request userspace look up the files in +//config: /lib/firmware/ and if it exists, send it to the kernel for +//config: loading into the hardware. //applet:IF_MDEV(APPLET(mdev, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/mesg.c b/util-linux/mesg.c index a83da03e6..c4371eb24 100644 --- a/util-linux/mesg.c +++ b/util-linux/mesg.c @@ -11,20 +11,20 @@ //config: bool "mesg (1.2 kb)" //config: default y //config: help -//config: Mesg controls access to your terminal by others. It is typically -//config: used to allow or disallow other users to write to your terminal +//config: Mesg controls access to your terminal by others. It is typically +//config: used to allow or disallow other users to write to your terminal //config: //config:config FEATURE_MESG_ENABLE_ONLY_GROUP //config: bool "Enable writing to tty only by group, not by everybody" //config: default y //config: depends on MESG //config: help -//config: Usually, ttys are owned by group "tty", and "write" tool is -//config: setgid to this group. This way, "mesg y" only needs to enable -//config: "write by owning group" bit in tty mode. +//config: Usually, ttys are owned by group "tty", and "write" tool is +//config: setgid to this group. This way, "mesg y" only needs to enable +//config: "write by owning group" bit in tty mode. //config: -//config: If you set this option to N, "mesg y" will enable writing -//config: by anybody at all. This is not recommended. +//config: If you set this option to N, "mesg y" will enable writing +//config: by anybody at all. This is not recommended. //applet:IF_MESG(APPLET(mesg, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/mkfs_ext2.c b/util-linux/mkfs_ext2.c index f646f368c..8434dd6ad 100644 --- a/util-linux/mkfs_ext2.c +++ b/util-linux/mkfs_ext2.c @@ -12,14 +12,14 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Utility to create EXT2 filesystems. +//config: Utility to create EXT2 filesystems. //config: //config:config MKFS_EXT2 //config: bool "mkfs.ext2 (9.8 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Alias to "mke2fs". +//config: Alias to "mke2fs". // APPLET_ODDNAME:name main location suid_type help //applet:IF_MKE2FS( APPLET_ODDNAME(mke2fs, mkfs_ext2, BB_DIR_SBIN, BB_SUID_DROP, mkfs_ext2)) diff --git a/util-linux/mkfs_minix.c b/util-linux/mkfs_minix.c index 0dfe34705..88647e9d8 100644 --- a/util-linux/mkfs_minix.c +++ b/util-linux/mkfs_minix.c @@ -67,18 +67,18 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The minix filesystem is a nice, small, compact, read-write filesystem -//config: with little overhead. If you wish to be able to create minix -//config: filesystems this utility will do the job for you. +//config: The minix filesystem is a nice, small, compact, read-write filesystem +//config: with little overhead. If you wish to be able to create minix +//config: filesystems this utility will do the job for you. //config: //config:config FEATURE_MINIX2 //config: bool "Support Minix fs v2 (fsck_minix/mkfs_minix)" //config: default y //config: depends on FSCK_MINIX || MKFS_MINIX //config: help -//config: If you wish to be able to create version 2 minix filesystems, enable -//config: this. If you enabled 'mkfs_minix' then you almost certainly want to -//config: be using the version 2 filesystem support. +//config: If you wish to be able to create version 2 minix filesystems, enable +//config: this. If you enabled 'mkfs_minix' then you almost certainly want to +//config: be using the version 2 filesystem support. // APPLET_ODDNAME:name main location suid_type help //applet:IF_MKFS_MINIX(APPLET_ODDNAME(mkfs.minix, mkfs_minix, BB_DIR_SBIN, BB_SUID_DROP, mkfs_minix)) diff --git a/util-linux/mkfs_reiser.c b/util-linux/mkfs_reiser.c index d01119f7f..c7d99b018 100644 --- a/util-linux/mkfs_reiser.c +++ b/util-linux/mkfs_reiser.c @@ -11,8 +11,8 @@ //config: default n //config: select PLATFORM_LINUX //config: help -//config: Utility to create ReiserFS filesystems. -//config: Note: this applet needs a lot of testing and polishing. +//config: Utility to create ReiserFS filesystems. +//config: Note: this applet needs a lot of testing and polishing. //applet:IF_MKFS_REISER(APPLET_ODDNAME(mkfs.reiser, mkfs_reiser, BB_DIR_SBIN, BB_SUID_DROP, mkfs_reiser)) diff --git a/util-linux/mkfs_vfat.c b/util-linux/mkfs_vfat.c index a191c03d6..f9768ed56 100644 --- a/util-linux/mkfs_vfat.c +++ b/util-linux/mkfs_vfat.c @@ -12,14 +12,14 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Utility to create FAT32 filesystems. +//config: Utility to create FAT32 filesystems. //config: //config:config MKFS_VFAT //config: bool "mkfs.vfat (6.8 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Alias to "mkdosfs". +//config: Alias to "mkdosfs". // APPLET_ODDNAME:name main location suid_type help //applet:IF_MKDOSFS( APPLET_ODDNAME(mkdosfs, mkfs_vfat, BB_DIR_SBIN, BB_SUID_DROP, mkfs_vfat)) diff --git a/util-linux/mkswap.c b/util-linux/mkswap.c index deb911485..e44e13c0d 100644 --- a/util-linux/mkswap.c +++ b/util-linux/mkswap.c @@ -9,21 +9,21 @@ //config: bool "mkswap (5.8 kb)" //config: default y //config: help -//config: The mkswap utility is used to configure a file or disk partition as -//config: Linux swap space. This allows Linux to use the entire file or -//config: partition as if it were additional RAM, which can greatly increase -//config: the capability of low-memory machines. This additional memory is -//config: much slower than real RAM, but can be very helpful at preventing your -//config: applications being killed by the Linux out of memory (OOM) killer. -//config: Once you have created swap space using 'mkswap' you need to enable -//config: the swap space using the 'swapon' utility. +//config: The mkswap utility is used to configure a file or disk partition as +//config: Linux swap space. This allows Linux to use the entire file or +//config: partition as if it were additional RAM, which can greatly increase +//config: the capability of low-memory machines. This additional memory is +//config: much slower than real RAM, but can be very helpful at preventing your +//config: applications being killed by the Linux out of memory (OOM) killer. +//config: Once you have created swap space using 'mkswap' you need to enable +//config: the swap space using the 'swapon' utility. //config: //config:config FEATURE_MKSWAP_UUID //config: bool "UUID support" //config: default y //config: depends on MKSWAP //config: help -//config: Generate swap spaces with universally unique identifiers. +//config: Generate swap spaces with universally unique identifiers. //applet:IF_MKSWAP(APPLET(mkswap, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/more.c b/util-linux/more.c index 11546a8f8..926cf5f26 100644 --- a/util-linux/more.c +++ b/util-linux/more.c @@ -17,11 +17,11 @@ //config: bool "more (6.7 kb)" //config: default y //config: help -//config: more is a simple utility which allows you to read text one screen -//config: sized page at a time. If you want to read text that is larger than -//config: the screen, and you are using anything faster than a 300 baud modem, -//config: you will probably find this utility very helpful. If you don't have -//config: any need to reading text files, you can leave this disabled. +//config: more is a simple utility which allows you to read text one screen +//config: sized page at a time. If you want to read text that is larger than +//config: the screen, and you are using anything faster than a 300 baud modem, +//config: you will probably find this utility very helpful. If you don't have +//config: any need to reading text files, you can leave this disabled. //applet:IF_MORE(APPLET(more, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/mount.c b/util-linux/mount.c index 423e89d5b..1a39da2db 100644 --- a/util-linux/mount.c +++ b/util-linux/mount.c @@ -22,40 +22,40 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: All files and filesystems in Unix are arranged into one big directory -//config: tree. The 'mount' utility is used to graft a filesystem onto a -//config: particular part of the tree. A filesystem can either live on a block -//config: device, or it can be accessible over the network, as is the case with -//config: NFS filesystems. Most people using BusyBox will also want to enable -//config: the 'mount' utility. +//config: All files and filesystems in Unix are arranged into one big directory +//config: tree. The 'mount' utility is used to graft a filesystem onto a +//config: particular part of the tree. A filesystem can either live on a block +//config: device, or it can be accessible over the network, as is the case with +//config: NFS filesystems. Most people using BusyBox will also want to enable +//config: the 'mount' utility. //config: //config:config FEATURE_MOUNT_FAKE //config: bool "Support option -f" //config: default y //config: depends on MOUNT //config: help -//config: Enable support for faking a file system mount. +//config: Enable support for faking a file system mount. //config: //config:config FEATURE_MOUNT_VERBOSE //config: bool "Support option -v" //config: default y //config: depends on MOUNT //config: help -//config: Enable multi-level -v[vv...] verbose messages. Useful if you -//config: debug mount problems and want to see what is exactly passed -//config: to the kernel. +//config: Enable multi-level -v[vv...] verbose messages. Useful if you +//config: debug mount problems and want to see what is exactly passed +//config: to the kernel. //config: //config:config FEATURE_MOUNT_HELPERS //config: bool "Support mount helpers" //config: default n //config: depends on MOUNT //config: help -//config: Enable mounting of virtual file systems via external helpers. -//config: E.g. "mount obexfs#-b00.11.22.33.44.55 /mnt" will in effect call -//config: "obexfs -b00.11.22.33.44.55 /mnt" -//config: Also "mount -t sometype [-o opts] fs /mnt" will try -//config: "sometype [-o opts] fs /mnt" if simple mount syscall fails. -//config: The idea is to use such virtual filesystems in /etc/fstab. +//config: Enable mounting of virtual file systems via external helpers. +//config: E.g. "mount obexfs#-b00.11.22.33.44.55 /mnt" will in effect call +//config: "obexfs -b00.11.22.33.44.55 /mnt" +//config: Also "mount -t sometype [-o opts] fs /mnt" will try +//config: "sometype [-o opts] fs /mnt" if simple mount syscall fails. +//config: The idea is to use such virtual filesystems in /etc/fstab. //config: //config:config FEATURE_MOUNT_LABEL //config: bool "Support specifying devices by label or UUID" @@ -63,9 +63,9 @@ //config: depends on MOUNT //config: select VOLUMEID //config: help -//config: This allows for specifying a device by label or uuid, rather than by -//config: name. This feature utilizes the same functionality as blkid/findfs. -//config: This also enables label or uuid support for swapon. +//config: This allows for specifying a device by label or uuid, rather than by +//config: name. This feature utilizes the same functionality as blkid/findfs. +//config: This also enables label or uuid support for swapon. //config: //config:config FEATURE_MOUNT_NFS //config: bool "Support mounting NFS file systems on Linux < 2.6.23" @@ -74,43 +74,43 @@ //config: select FEATURE_HAVE_RPC //config: select FEATURE_SYSLOG //config: help -//config: Enable mounting of NFS file systems on Linux kernels prior -//config: to version 2.6.23. Note that in this case mounting of NFS -//config: over IPv6 will not be possible. +//config: Enable mounting of NFS file systems on Linux kernels prior +//config: to version 2.6.23. Note that in this case mounting of NFS +//config: over IPv6 will not be possible. //config: -//config: Note that this option links in RPC support from libc, -//config: which is rather large (~10 kbytes on uclibc). +//config: Note that this option links in RPC support from libc, +//config: which is rather large (~10 kbytes on uclibc). //config: //config:config FEATURE_MOUNT_CIFS //config: bool "Support mounting CIFS/SMB file systems" //config: default y //config: depends on MOUNT //config: help -//config: Enable support for samba mounts. +//config: Enable support for samba mounts. //config: //config:config FEATURE_MOUNT_FLAGS //config: depends on MOUNT //config: bool "Support lots of -o flags" //config: default y //config: help -//config: Without this, mount only supports ro/rw/remount. With this, it -//config: supports nosuid, suid, dev, nodev, exec, noexec, sync, async, atime, -//config: noatime, diratime, nodiratime, loud, bind, move, shared, slave, -//config: private, unbindable, rshared, rslave, rprivate, and runbindable. +//config: Without this, mount only supports ro/rw/remount. With this, it +//config: supports nosuid, suid, dev, nodev, exec, noexec, sync, async, atime, +//config: noatime, diratime, nodiratime, loud, bind, move, shared, slave, +//config: private, unbindable, rshared, rslave, rprivate, and runbindable. //config: //config:config FEATURE_MOUNT_FSTAB //config: depends on MOUNT //config: bool "Support /etc/fstab and -a" //config: default y //config: help -//config: Support mount all and looking for files in /etc/fstab. +//config: Support mount all and looking for files in /etc/fstab. //config: //config:config FEATURE_MOUNT_OTHERTAB //config: depends on FEATURE_MOUNT_FSTAB //config: bool "Support -T " //config: default y //config: help -//config: Support mount -T (specifying an alternate fstab) +//config: Support mount -T (specifying an alternate fstab) /* On full-blown systems, requires suid for user mounts. * But it's not unthinkable to have it available in non-suid flavor on some systems, diff --git a/util-linux/mountpoint.c b/util-linux/mountpoint.c index 0ba4a308e..b7f048196 100644 --- a/util-linux/mountpoint.c +++ b/util-linux/mountpoint.c @@ -12,7 +12,7 @@ //config: bool "mountpoint (4.5 kb)" //config: default y //config: help -//config: mountpoint checks if the directory is a mountpoint. +//config: mountpoint checks if the directory is a mountpoint. //applet:IF_MOUNTPOINT(APPLET(mountpoint, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/nsenter.c b/util-linux/nsenter.c index 315e3420b..12c86b0ed 100644 --- a/util-linux/nsenter.c +++ b/util-linux/nsenter.c @@ -12,15 +12,15 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Run program with namespaces of other processes. +//config: Run program with namespaces of other processes. //config: //config:config FEATURE_NSENTER_LONG_OPTS //config: bool "Enable long options" //config: default y //config: depends on NSENTER && LONG_OPTS //config: help -//config: Support long options for the nsenter applet. This makes -//config: the busybox implementation more compatible with upstream. +//config: Support long options for the nsenter applet. This makes +//config: the busybox implementation more compatible with upstream. //applet:IF_NSENTER(APPLET(nsenter, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/pivot_root.c b/util-linux/pivot_root.c index c21291ba0..331038057 100644 --- a/util-linux/pivot_root.c +++ b/util-linux/pivot_root.c @@ -13,13 +13,13 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The pivot_root utility swaps the mount points for the root filesystem -//config: with some other mounted filesystem. This allows you to do all sorts -//config: of wild and crazy things with your Linux system and is far more -//config: powerful than 'chroot'. +//config: The pivot_root utility swaps the mount points for the root filesystem +//config: with some other mounted filesystem. This allows you to do all sorts +//config: of wild and crazy things with your Linux system and is far more +//config: powerful than 'chroot'. //config: -//config: Note: This is for initrd in linux 2.4. Under initramfs (introduced -//config: in linux 2.6) use switch_root instead. +//config: Note: This is for initrd in linux 2.4. Under initramfs (introduced +//config: in linux 2.6) use switch_root instead. //applet:IF_PIVOT_ROOT(APPLET(pivot_root, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/rdate.c b/util-linux/rdate.c index d950b45b5..66b877e24 100644 --- a/util-linux/rdate.c +++ b/util-linux/rdate.c @@ -11,10 +11,10 @@ //config: bool "rdate (6 kb)" //config: default y //config: help -//config: The rdate utility allows you to synchronize the date and time of your -//config: system clock with the date and time of a remote networked system using -//config: the RFC868 protocol, which is built into the inetd daemon on most -//config: systems. +//config: The rdate utility allows you to synchronize the date and time of your +//config: system clock with the date and time of a remote networked system using +//config: the RFC868 protocol, which is built into the inetd daemon on most +//config: systems. //applet:IF_RDATE(APPLET(rdate, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/rdev.c b/util-linux/rdev.c index 6ea9c2a8a..2ffe07688 100644 --- a/util-linux/rdev.c +++ b/util-linux/rdev.c @@ -12,7 +12,7 @@ //config: bool "rdev (1.4 kb)" //config: default y //config: help -//config: Print the device node associated with the filesystem mounted at '/'. +//config: Print the device node associated with the filesystem mounted at '/'. //applet:IF_RDEV(APPLET(rdev, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/readprofile.c b/util-linux/readprofile.c index b4cb5804f..b045657d8 100644 --- a/util-linux/readprofile.c +++ b/util-linux/readprofile.c @@ -36,7 +36,7 @@ //config: default y //config: #select PLATFORM_LINUX //config: help -//config: This allows you to parse /proc/profile for basic profiling. +//config: This allows you to parse /proc/profile for basic profiling. //applet:IF_READPROFILE(APPLET(readprofile, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/renice.c b/util-linux/renice.c index 751af4548..23cbca88d 100644 --- a/util-linux/renice.c +++ b/util-linux/renice.c @@ -22,8 +22,8 @@ //config: bool "renice (3.8 kb)" //config: default y //config: help -//config: Renice alters the scheduling priority of one or more running -//config: processes. +//config: Renice alters the scheduling priority of one or more running +//config: processes. //applet:IF_RENICE(APPLET(renice, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/rev.c b/util-linux/rev.c index 3d07b2247..2bef9b9be 100644 --- a/util-linux/rev.c +++ b/util-linux/rev.c @@ -9,7 +9,7 @@ //config: bool "rev (4.5 kb)" //config: default y //config: help -//config: Reverse lines of a file or files. +//config: Reverse lines of a file or files. //applet:IF_REV(APPLET(rev, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/rtcwake.c b/util-linux/rtcwake.c index 01ab8ebb9..4c47c5369 100644 --- a/util-linux/rtcwake.c +++ b/util-linux/rtcwake.c @@ -27,7 +27,7 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Enter a system sleep state until specified wakeup time. +//config: Enter a system sleep state until specified wakeup time. //applet:IF_RTCWAKE(APPLET(rtcwake, BB_DIR_USR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/script.c b/util-linux/script.c index d82a92d1e..9eebb51a4 100644 --- a/util-linux/script.c +++ b/util-linux/script.c @@ -14,7 +14,7 @@ //config: bool "script (8 kb)" //config: default y //config: help -//config: The script makes typescript of terminal session. +//config: The script makes typescript of terminal session. //applet:IF_SCRIPT(APPLET(script, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/scriptreplay.c b/util-linux/scriptreplay.c index d0050f26b..7e9850103 100644 --- a/util-linux/scriptreplay.c +++ b/util-linux/scriptreplay.c @@ -11,8 +11,8 @@ //config: bool "scriptreplay (2.6 kb)" //config: default y //config: help -//config: This program replays a typescript, using timing information -//config: given by script -t. +//config: This program replays a typescript, using timing information +//config: given by script -t. //applet:IF_SCRIPTREPLAY(APPLET(scriptreplay, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/setarch.c b/util-linux/setarch.c index 07de7f4db..d4b568832 100644 --- a/util-linux/setarch.c +++ b/util-linux/setarch.c @@ -11,24 +11,24 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The linux32 utility is used to create a 32bit environment for the -//config: specified program (usually a shell). It only makes sense to have -//config: this util on a system that supports both 64bit and 32bit userland -//config: (like amd64/x86, ppc64/ppc, sparc64/sparc, etc...). +//config: The linux32 utility is used to create a 32bit environment for the +//config: specified program (usually a shell). It only makes sense to have +//config: this util on a system that supports both 64bit and 32bit userland +//config: (like amd64/x86, ppc64/ppc, sparc64/sparc, etc...). //config: //config:config LINUX32 //config: bool "linux32 (3.2 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Alias to "setarch linux32". +//config: Alias to "setarch linux32". //config: //config:config LINUX64 //config: bool "linux64 (3.2 kb)" //config: default y //config: select PLATFORM_LINUX //config: help -//config: Alias to "setarch linux64". +//config: Alias to "setarch linux64". //applet:IF_SETARCH(APPLET(setarch, BB_DIR_BIN, BB_SUID_DROP)) // APPLET_ODDNAME:name main location suid_type help diff --git a/util-linux/setpriv.c b/util-linux/setpriv.c index 89181085a..0f85428ab 100644 --- a/util-linux/setpriv.c +++ b/util-linux/setpriv.c @@ -13,36 +13,36 @@ //config: select PLATFORM_LINUX //config: select LONG_OPTS //config: help -//config: Run a program with different Linux privilege settings. -//config: Requires kernel >= 3.5 +//config: Run a program with different Linux privilege settings. +//config: Requires kernel >= 3.5 //config: //config:config FEATURE_SETPRIV_DUMP //config: bool "Support dumping current privilege state" //config: default y //config: depends on SETPRIV //config: help -//config: Enables the "--dump" switch to print out the current privilege -//config: state. This is helpful for diagnosing problems. +//config: Enables the "--dump" switch to print out the current privilege +//config: state. This is helpful for diagnosing problems. //config: //config:config FEATURE_SETPRIV_CAPABILITIES //config: bool "Support capabilities" //config: default y //config: depends on SETPRIV //config: help -//config: Capabilities can be used to grant processes additional rights -//config: without the necessity to always execute as the root user. -//config: Enabling this option enables "--dump" to show information on -//config: capabilities. +//config: Capabilities can be used to grant processes additional rights +//config: without the necessity to always execute as the root user. +//config: Enabling this option enables "--dump" to show information on +//config: capabilities. //config: //config:config FEATURE_SETPRIV_CAPABILITY_NAMES //config: bool "Support capability names" //config: default y //config: depends on SETPRIV && FEATURE_SETPRIV_CAPABILITIES //config: help -//config: Capabilities can be either referenced via a human-readble name, -//config: e.g. "net_admin", or using their index, e.g. "cap_12". Enabling -//config: this option allows using the human-readable names in addition to -//config: the index-based names. +//config: Capabilities can be either referenced via a human-readble name, +//config: e.g. "net_admin", or using their index, e.g. "cap_12". Enabling +//config: this option allows using the human-readable names in addition to +//config: the index-based names. //applet:IF_SETPRIV(APPLET(setpriv, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/setsid.c b/util-linux/setsid.c index 15a7c05e9..60cab2fcf 100644 --- a/util-linux/setsid.c +++ b/util-linux/setsid.c @@ -17,7 +17,7 @@ //config: bool "setsid (3.9 kb)" //config: default y //config: help -//config: setsid runs a program in a new session +//config: setsid runs a program in a new session //applet:IF_SETSID(APPLET(setsid, BB_DIR_USR_BIN, BB_SUID_DROP)) diff --git a/util-linux/swaponoff.c b/util-linux/swaponoff.c index dc8dd9df6..bda0687d6 100644 --- a/util-linux/swaponoff.c +++ b/util-linux/swaponoff.c @@ -11,27 +11,27 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: Once you have created some swap space using 'mkswap', you also need -//config: to enable your swap space with the 'swapon' utility. The 'swapoff' -//config: utility is used, typically at system shutdown, to disable any swap -//config: space. If you are not using any swap space, you can leave this -//config: option disabled. +//config: Once you have created some swap space using 'mkswap', you also need +//config: to enable your swap space with the 'swapon' utility. The 'swapoff' +//config: utility is used, typically at system shutdown, to disable any swap +//config: space. If you are not using any swap space, you can leave this +//config: option disabled. //config: //config:config FEATURE_SWAPON_DISCARD //config: bool "Support discard option -d" //config: default y //config: depends on SWAPON //config: help -//config: Enable support for discarding swap area blocks at swapon and/or as -//config: the kernel frees them. This option enables both the -d option on -//config: 'swapon' and the 'discard' option for swap entries in /etc/fstab. +//config: Enable support for discarding swap area blocks at swapon and/or as +//config: the kernel frees them. This option enables both the -d option on +//config: 'swapon' and the 'discard' option for swap entries in /etc/fstab. //config: //config:config FEATURE_SWAPON_PRI //config: bool "Support priority option -p" //config: default y //config: depends on SWAPON //config: help -//config: Enable support for setting swap device priority in swapon. +//config: Enable support for setting swap device priority in swapon. //config: //config:config SWAPOFF //config: bool "swapoff (4.3 kb)" diff --git a/util-linux/switch_root.c b/util-linux/switch_root.c index 92e385b98..32708934e 100644 --- a/util-linux/switch_root.c +++ b/util-linux/switch_root.c @@ -10,20 +10,20 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: The switch_root utility is used from initramfs to select a new -//config: root device. Under initramfs, you have to use this instead of -//config: pivot_root. (Stop reading here if you don't care why.) +//config: The switch_root utility is used from initramfs to select a new +//config: root device. Under initramfs, you have to use this instead of +//config: pivot_root. (Stop reading here if you don't care why.) //config: -//config: Booting with initramfs extracts a gzipped cpio archive into rootfs -//config: (which is a variant of ramfs/tmpfs). Because rootfs can't be moved -//config: or unmounted*, pivot_root will not work from initramfs. Instead, -//config: switch_root deletes everything out of rootfs (including itself), -//config: does a mount --move that overmounts rootfs with the new root, and -//config: then execs the specified init program. +//config: Booting with initramfs extracts a gzipped cpio archive into rootfs +//config: (which is a variant of ramfs/tmpfs). Because rootfs can't be moved +//config: or unmounted*, pivot_root will not work from initramfs. Instead, +//config: switch_root deletes everything out of rootfs (including itself), +//config: does a mount --move that overmounts rootfs with the new root, and +//config: then execs the specified init program. //config: -//config: * Because the Linux kernel uses rootfs internally as the starting -//config: and ending point for searching through the kernel's doubly linked -//config: list of active mount points. That's why. +//config: * Because the Linux kernel uses rootfs internally as the starting +//config: and ending point for searching through the kernel's doubly linked +//config: list of active mount points. That's why. //applet:IF_SWITCH_ROOT(APPLET(switch_root, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/taskset.c b/util-linux/taskset.c index 581b0d144..9957b1a71 100644 --- a/util-linux/taskset.c +++ b/util-linux/taskset.c @@ -10,17 +10,17 @@ //config: bool "taskset (4.1 kb)" //config: default y //config: help -//config: Retrieve or set a processes's CPU affinity. -//config: This requires sched_{g,s}etaffinity support in your libc. +//config: Retrieve or set a processes's CPU affinity. +//config: This requires sched_{g,s}etaffinity support in your libc. //config: //config:config FEATURE_TASKSET_FANCY //config: bool "Fancy output" //config: default y //config: depends on TASKSET //config: help -//config: Needed for machines with more than 32-64 CPUs: -//config: affinity parameter 0xHHHHHHHHHHHHHHHHHHHH can be arbitrarily long -//config: in this case. Otherwise, it is limited to sizeof(long). +//config: Needed for machines with more than 32-64 CPUs: +//config: affinity parameter 0xHHHHHHHHHHHHHHHHHHHH can be arbitrarily long +//config: in this case. Otherwise, it is limited to sizeof(long). //applet:IF_TASKSET(APPLET(taskset, BB_DIR_USR_BIN, BB_SUID_DROP)) //kbuild:lib-$(CONFIG_TASKSET) += taskset.o diff --git a/util-linux/uevent.c b/util-linux/uevent.c index cef93adf6..252e8fb64 100644 --- a/util-linux/uevent.c +++ b/util-linux/uevent.c @@ -8,8 +8,8 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: uevent is a netlink listener for kernel uevent notifications -//config: sent via netlink. It is usually used for dynamic device creation. +//config: uevent is a netlink listener for kernel uevent notifications +//config: sent via netlink. It is usually used for dynamic device creation. //applet:IF_UEVENT(APPLET(uevent, BB_DIR_SBIN, BB_SUID_DROP)) diff --git a/util-linux/umount.c b/util-linux/umount.c index f970f9f84..31bf671c1 100644 --- a/util-linux/umount.c +++ b/util-linux/umount.c @@ -12,17 +12,17 @@ //config: default y //config: select PLATFORM_LINUX //config: help -//config: When you want to remove a mounted filesystem from its current mount -//config: point, for example when you are shutting down the system, the -//config: 'umount' utility is the tool to use. If you enabled the 'mount' -//config: utility, you almost certainly also want to enable 'umount'. +//config: When you want to remove a mounted filesystem from its current mount +//config: point, for example when you are shutting down the system, the +//config: 'umount' utility is the tool to use. If you enabled the 'mount' +//config: utility, you almost certainly also want to enable 'umount'. //config: //config:config FEATURE_UMOUNT_ALL //config: bool "Support option -a" //config: default y //config: depends on UMOUNT //config: help -//config: Support -a option to unmount all currently mounted filesystems. +//config: Support -a option to unmount all currently mounted filesystems. //applet:IF_UMOUNT(APPLET(umount, BB_DIR_BIN, BB_SUID_DROP)) diff --git a/util-linux/unshare.c b/util-linux/unshare.c index 892d3b6c7..e7b95c72b 100644 --- a/util-linux/unshare.c +++ b/util-linux/unshare.c @@ -13,7 +13,7 @@ //config: select PLATFORM_LINUX //config: select LONG_OPTS //config: help -//config: Run program with some namespaces unshared from parent. +//config: Run program with some namespaces unshared from parent. // needs LONG_OPTS: it is awkward to exclude code which handles --propagation // and --setgroups based on LONG_OPTS, so instead applet requires LONG_OPTS. diff --git a/util-linux/volume_id/exfat.c b/util-linux/volume_id/exfat.c index 7ed13a70e..14bf9d691 100644 --- a/util-linux/volume_id/exfat.c +++ b/util-linux/volume_id/exfat.c @@ -25,9 +25,9 @@ //config: default y //config: depends on VOLUMEID //config: help -//config: exFAT (extended FAT) is a proprietary file system designed especially -//config: for flash drives. It has many features from NTFS, but with less -//config: overhead. exFAT is used on most SDXC cards for consumer electronics. +//config: exFAT (extended FAT) is a proprietary file system designed especially +//config: for flash drives. It has many features from NTFS, but with less +//config: overhead. exFAT is used on most SDXC cards for consumer electronics. #include "volume_id_internal.h" diff --git a/util-linux/volume_id/f2fs.c b/util-linux/volume_id/f2fs.c index 1d3bdae36..3027f178e 100644 --- a/util-linux/volume_id/f2fs.c +++ b/util-linux/volume_id/f2fs.c @@ -13,10 +13,10 @@ //config: default y //config: depends on VOLUMEID //config: help -//config: F2FS (aka Flash-Friendly File System) is a log-structured file system, -//config: which is adapted to newer forms of storage. F2FS also remedies some -//config: known issues of the older log structured file systems, such as high -//config: cleaning overhead. +//config: F2FS (aka Flash-Friendly File System) is a log-structured file system, +//config: which is adapted to newer forms of storage. F2FS also remedies some +//config: known issues of the older log structured file systems, such as high +//config: cleaning overhead. #include "volume_id_internal.h" diff --git a/util-linux/volume_id/nilfs.c b/util-linux/volume_id/nilfs.c index ffe919f36..9d6c57fba 100644 --- a/util-linux/volume_id/nilfs.c +++ b/util-linux/volume_id/nilfs.c @@ -26,16 +26,16 @@ //config: default y //config: depends on VOLUMEID //config: help -//config: NILFS is a New Implementation of a Log-Structured File System (LFS) -//config: that supports continuous snapshots. This provides features like -//config: versioning of the entire filesystem, restoration of files that -//config: were deleted a few minutes ago. NILFS keeps consistency like -//config: conventional LFS, so it provides quick recovery after system crashes. +//config: NILFS is a New Implementation of a Log-Structured File System (LFS) +//config: that supports continuous snapshots. This provides features like +//config: versioning of the entire filesystem, restoration of files that +//config: were deleted a few minutes ago. NILFS keeps consistency like +//config: conventional LFS, so it provides quick recovery after system crashes. //config: -//config: The possible use of NILFS includes versioning, tamper detection, -//config: SOX compliance logging, and so forth. It can serve as an alternative -//config: filesystem for Linux desktop environment, or as a basis of advanced -//config: storage appliances. +//config: The possible use of NILFS includes versioning, tamper detection, +//config: SOX compliance logging, and so forth. It can serve as an alternative +//config: filesystem for Linux desktop environment, or as a basis of advanced +//config: storage appliances. #include "volume_id_internal.h" diff --git a/util-linux/volume_id/squashfs.c b/util-linux/volume_id/squashfs.c index 6bba199cd..e3ffce35e 100644 --- a/util-linux/volume_id/squashfs.c +++ b/util-linux/volume_id/squashfs.c @@ -13,10 +13,10 @@ //config: default y //config: depends on VOLUMEID && FEATURE_BLKID_TYPE //config: help -//config: Squashfs is a compressed read-only filesystem for Linux. Squashfs is -//config: intended for general read-only filesystem use and in constrained block -//config: device/memory systems (e.g. embedded systems) where low overhead is -//config: needed. +//config: Squashfs is a compressed read-only filesystem for Linux. Squashfs is +//config: intended for general read-only filesystem use and in constrained block +//config: device/memory systems (e.g. embedded systems) where low overhead is +//config: needed. #include "volume_id_internal.h" diff --git a/util-linux/volume_id/ubifs.c b/util-linux/volume_id/ubifs.c index 99b0aa830..7512b84b0 100644 --- a/util-linux/volume_id/ubifs.c +++ b/util-linux/volume_id/ubifs.c @@ -13,8 +13,8 @@ //config: default y //config: depends on VOLUMEID //config: help -//config: UBIFS (Unsorted Block Image File System) is a file -//config: system for use with raw flash memory media. +//config: UBIFS (Unsorted Block Image File System) is a file +//config: system for use with raw flash memory media. #include "volume_id_internal.h" diff --git a/util-linux/wall.c b/util-linux/wall.c index 4550f0b68..e214d8c3f 100644 --- a/util-linux/wall.c +++ b/util-linux/wall.c @@ -11,7 +11,7 @@ //config: default y //config: depends on FEATURE_UTMP //config: help -//config: Write a message to all users that are logged in. +//config: Write a message to all users that are logged in. /* Needs to be run by root or be suid root - needs to write to /dev/TTY: */ //applet:IF_WALL(APPLET(wall, BB_DIR_USR_BIN, BB_SUID_REQUIRE)) -- 2.25.1