aboutsummaryrefslogtreecommitdiffstats
path: root/appendixa/utillinux-desc.xml
diff options
context:
space:
mode:
Diffstat (limited to 'appendixa/utillinux-desc.xml')
-rw-r--r--appendixa/utillinux-desc.xml248
1 files changed, 100 insertions, 148 deletions
diff --git a/appendixa/utillinux-desc.xml b/appendixa/utillinux-desc.xml
index a0b049cff..51a543d27 100644
--- a/appendixa/utillinux-desc.xml
+++ b/appendixa/utillinux-desc.xml
@@ -6,214 +6,166 @@
<sect3><title>Program file descriptions</title>
-<sect4><title>agetty</title>
-<para>agetty opens a tty port, prompts for a login name and invokes the
-/bin/login command.</para></sect4>
+<para><command>agetty</command> opens a tty port, prompts for a login name,
+and then invokes the login program.</para>
-<sect4><title>arch</title>
-<para>arch prints the machine architecture.</para></sect4>
+<para><command>arch</command> reports the machine's architecture.</para>
-<sect4><title>blockdev</title>
-<para>blockdev allows to call block device ioctls from the command
-line.</para></sect4>
+<para><command>blockdev</command> allows you to call block device ioctls
+from the command line.</para>
-<sect4><title>cal</title>
-<para>cal displays a simple calender.</para></sect4>
+<para><command>cal</command> displays a simple calender.</para>
-<sect4><title>cfdisk</title>
-<para>cfdisk is a libncurses based disk partition table
-manipulator.</para></sect4>
+<para><command>cfdisk</command> is used to manipulate the partition table
+of the given device.</para>
-<sect4><title>chkdupexe</title>
-<para>chkdupexe finds duplicate executables.</para></sect4>
+<para><command>chkdupexe</command> finds duplicate executables.</para>
-<sect4><title>col</title>
-<para>col filters reverse line feeds from input.</para></sect4>
+<para><command>col</command> filters out reverse line feeds.</para>
-<sect4><title>colcrt</title>
-<para>colcrt filters nroff output for CRT previewing.</para></sect4>
+<para><command>colcrt</command> is used to filter nroff output for terminals
+that lack some capabilities such as overstriking and half-lines.</para>
-<sect4><title>colrm</title>
-<para>colrm removes columns from a file.</para></sect4>
+<para><command>colrm</command> filters out the given columns.</para>
-<sect4><title>column</title>
-<para>column columnates lists.</para></sect4>
+<para><command>column</command> formats a given file into multiple
+columns.</para>
-<sect4><title>ctrlaltdel</title>
-<para>ctrlaltdel sets the function of the CTRL+ALT+DEL key combination (hard
-or soft reset).</para></sect4>
+<para><command>ctrlaltdel</command> sets the function of the Ctrl+Alt+Del
+ key combination, to a hard or a soft reset.</para>
-<sect4><title>cytune</title>
-<para>cytune queries and modifies the interruption threshold for the Cyclades
-driver.</para></sect4>
+<para><command>cytune</command> was used to tune the parameters of the
+serial line drivers for Cyclades cards.</para>
-<sect4><title>ddate</title>
-<para>ddate converts Gregorian dates to Discordian dates.</para></sect4>
+<para><command>ddate</command> gives the Discordian date, or converts the
+given Gregorian date to a Discordian one.</para>
-<sect4><title>dmesg</title>
-<para>dmesg is used to examine or control the kernel ring buffer (boot
-messages from the kernel).</para></sect4>
+<para><command>dmesg</command> dumps the kernel boot messages.</para>
-<sect4><title>elvtune</title>
-<para>elvtune lets you tune the I/O elevator per block device queue
-basis.</para></sect4>
+<para><command>elvtune</command> can be used to tune the performance
+and interactiveness of a block device.</para>
-<sect4><title>fdformat</title>
-<para>fdformat low-level formats a floppy disk.</para></sect4>
+<para><command>fdformat</command> low-level formats a floppy disk.</para>
-<sect4><title>fdisk</title>
-<para>fdisk is a disk partition table manipulator.</para></sect4>
+<para><command>fdisk</command> could be used to manipulate the partition
+table of the given device.</para>
-<sect4><title>fsck.cramfs</title>
-<para>No description is currently available.</para></sect4>
+<para><command>fsck.cramfs</command>...</para>
-<sect4><title>fsck.minix</title>
-<para>fsck.minix performs a consistency check for the Linux MINIX
-filesystem.</para></sect4>
+<para><command>fsck.minix</command> performs a consistency check on the
+Minix filesystem on the given device.</para>
-<sect4><title>getopt</title>
-<para>getopt parses command options the same way as the getopt C
-command.</para></sect4>
+<para><command>getopt</command> parses options in the given command line.</para>
-<sect4><title>hexdump</title>
-<para>hexdump displays specified files, or standard input, in a user specified
-format (ascii, decimal, hexadecimal, octal).</para></sect4>
+<para><command>hexdump</command> dumps the given file in hexadecimal, or
+in another given format.</para>
-<sect4><title>hwclock</title>
-<para>hwclock queries and sets the hardware clock (also called the RTC or BIOS
-clock).</para></sect4>
+<para><command>hwclock</command> is used to read or set the system's
+hardware clock (also called the RTC or BIOS clock).</para>
-<sect4><title>ipcrm</title>
-<para>ipcrm removes a specified resource.</para></sect4>
+<para><command>ipcrm</command> removes the given IPC resource.</para>
-<sect4><title>ipcs</title>
-<para>ipcs provides information on IPC facilities.</para></sect4>
+<para><command>ipcs</command> provides IPC status information.</para>
-<sect4><title>isosize</title>
-<para>isosize outputs the length of an iso9660 file system.</para></sect4>
+<para><command>isosize</command> reports the size of an iso9660
+filesystem.</para>
-<sect4><title>line</title>
-<para>line copies one line (up to a newline) from standard input and writes it
-to standard output.</para></sect4>
+<para><command>line</command> copies a single line.</para>
-<sect4><title>logger</title>
-<para>logger makes entries in the system log.</para></sect4>
+<para><command>logger</command> enters the given message into the system
+log.</para>
-<sect4><title>look</title>
-<para>look displays lines beginning with a given string.</para></sect4>
+<para><command>look</command> displays lines that begin with the given
+string.</para>
-<sect4><title>losetup</title>
-<para>losetup sets up and controls loop devices.</para></sect4>
+<para><command>losetup</command> is used to set up and control loop devices.</para>
-<sect4><title>mcookie</title>
-<para>mcookie generates magic cookies for xauth.</para></sect4>
+<para><command>mcookie</command> generates magic cookies, 128-bit random
+hexadecimal numbers, for xauth.</para>
-<sect4><title>mkfs</title>
-<para>mkfs builds a Linux filesystem on a device, usually a harddisk
-partition.</para></sect4>
+<para><command>mkfs</command> is used to build a filesystem on a device
+(usually a harddisk partition).</para>
-<sect4><title>mkfs.bfs</title>
-<para>mkfs.bfs creates an SCO bfs file system on a device, usually a harddisk
-partition.</para></sect4>
+<para><command>mkfs.bfs</command> creates an SCO bfs filesystem.</para>
-<sect4><title>mkfs.cramfs</title>
-<para>No description is currently available.</para></sect4>
+<para><command>mkfs.cramfs</command>...</para>
-<sect4><title>mkfs.minix</title>
-<para>mkfs.minix creates a Linux MINIX filesystem on a device, usually a
-harddisk partition.</para></sect4>
+<para><command>mkfs.minix</command> creates a Minix filesystem.</para>
-<sect4><title>mkswap</title>
-<para>mkswap sets up a Linux swap area on a device or in a file.</para></sect4>
+<para><command>mkswap</command> initializes the given device or file to be
+used as a swap area.</para>
-<sect4><title>more</title>
-<para>more is a filter for paging through text one screen full at a
-time.</para></sect4>
+<para><command>more</command> is a filter for paging through text one
+screenful at a time. But less is much better.</para>
-<sect4><title>mount</title>
-<para>mount mounts, from many possible sources, filesystems or directories
-on a directory (mount point).</para></sect4>
+<para><command>mount</command> attaches the filesystem on the given device
+to the given directory in the system's file tree.</para>
-<sect4><title>namei</title>
-<para>namei follows a pathname until a terminal point is found.</para></sect4>
+<para><command>namei</command> shows the symbolic links in the given
+pathnames.</para>
-<sect4><title>parse.bash, parse.tcsh, test.bash, test.tcsh</title>
-<para>These are example scripts for using the getopt program with either
-BASH or TCSH.</para></sect4>
+<para><command>pg</command>...</para>
-<sect4><title>pg</title>
-<para>No description is currently available.</para></sect4>
+<para><command>pivot_root</command> makes the given filesystem the new
+root filesystem of the current process.</para>
-<sect4><title>pivot_root</title>
-<para>pivot_root moves the root file system of the current process.</para></sect4>
+<para><command>ramsize</command> could be used to set the size of the
+RAM disk in a bootable image.</para>
-<sect4><title>ramsize</title>
-<para>ramsize queries and sets RAM disk size.</para></sect4>
+<para><command>rdev</command> could be used to query and set the root
+device and other things in a bootable image.</para>
-<sect4><title>raw</title>
-<para>raw is used to bind a Linux raw character device to a block device.</para></sect4>
+<para><command>readprofile</command> reads kernel profiling information.</para>
-<sect4><title>rdev</title>
-<para>rdev queries and sets image root device, swap device, RAM disk size or
-video mode.</para></sect4>
+<para><command>rename</command> renames the given files, replacing a given
+string with another.</para>
-<sect4><title>readprofile</title>
-<para>readprofile reads kernel profiling information.</para></sect4>
+<para><command>renice</command> is used to alter the priority of running
+processes.</para>
-<sect4><title>rename</title>
-<para>rename renames files.</para></sect4>
+<para><command>rev</command> reverses the lines of a given file.</para>
-<sect4><title>renice</title>
-<para>renice alters priority of running processes.</para></sect4>
+<para><command>rootflags</command> could be used to set the rootflags
+in a bootable image.</para>
-<sect4><title>rev</title>
-<para>rev reverses lines of a file.</para></sect4>
+<para><command>script</command> makes a typescript of a terminal
+session, of everything printed to the terminal.</para>
-<sect4><title>rootflags</title>
-<para>rootflags queries and sets extra information used when mounting
-root.</para></sect4>
+<para><command>setfdprm</command> sets user-provided floppy disk
+parameters.</para>
-<sect4><title>script</title>
-<para>script makes a typescript of terminal session.</para></sect4>
+<para><command>setsid</command> runs the given program in a new session.</para>
-<sect4><title>setfdprm</title>
-<para>setfdprm sets user-provided floppy disk parameters.</para></sect4>
+<para><command>setterm</command> is used to set terminal attributes.</para>
-<sect4><title>setsid</title>
-<para>setsid runs programs in a new session.</para></sect4>
+<para><command>sfdisk</command> is a disk partition table manipulator.</para>
-<sect4><title>setterm</title>
-<para>setterm sets terminal attributes.</para></sect4>
+<para><command>swapdev</command> could be used to set the swap device
+in a bootable image.</para>
-<sect4><title>sfdisk</title>
-<para>sfdisk is a disk partition table manipulator.</para></sect4>
+<para><command>swapoff</command> disables devices and files for paging
+and swapping.</para>
-<sect4><title>swapoff</title>
-<para>swapoff disables devices and files for paging and swapping.</para></sect4>
+<para><command>swapon</command> enables devices and files for paging
+and swapping.</para>
-<sect4><title>swapon</title>
-<para>swapon enables devices and files for paging and swapping.</para></sect4>
+<para><command>tunelp</command> is used to tune the parameters of the
+line printer.</para>
-<sect4><title>tunelp</title>
-<para>tunelp sets various parameters for the LP device.</para></sect4>
+<para><command>ul</command> is a filter for translating underscores into
+escape sequences indicating underlining for the terminal in use.</para>
-<sect4><title>ul</title>
-<para>ul reads a file and translates occurrences of underscores to the sequence
-which indicates underlining for the terminal in use.</para></sect4>
+<para><command>umount</command> disconnects a filesystem from the
+system's file tree.</para>
-<sect4><title>umount</title>
-<para>umount unmounts a mounted filesystem or directory.</para></sect4>
+<para><command>vidmode</command> could be used to set the video mode
+in a bootable image.</para>
-<sect4><title>vidmode</title>
-<para>vidmode queries and sets the video mode.</para></sect4>
+<para><command>whereis</command> reports the location of binary, the
+source, and the manual page for the given command.</para>
-<sect4><title>whereis</title>
-<para>whereis locates a binary, source and manual page for a
-command.</para></sect4>
-
-<sect4><title>write</title>
-<para>write sends a message to another user, if that user has writing
-enabled (usually by using mesg).</para></sect4>
+<para><command>write</command> sends a message to the given user. That is,
+if that user has not disabled such messages.</para>
</sect3>