diff options
Diffstat (limited to 'util-linux')
66 files changed, 355 insertions, 355 deletions
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/<ACTION>[/<PARAMETER>] 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/<ACTION>[/<PARAMETER>] 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 <alt_fstab>" //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)) |