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