Correct typos in some Util-Linux-NG command descriptions, that attributed them to...
[linux_from_scratch.git] / BOOK / chapter06 / util-linux-ng.xml
blob9ba39f5704345e4f48f1f42c135a2abdc9925469
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4   <!ENTITY % general-entities SYSTEM "../general.ent">
5   %general-entities;
6 ]>
8 <sect1 id="ch-system-util-linux-ng" role="wrap">
9   <?dbhtml filename="util-linux-ng.html"?>
11   <sect1info condition="script">
12     <productname>util-linux-ng</productname>
13     <productnumber>&util-linux-ng-version;</productnumber>
14     <address>&util-linux-ng-url;</address>
15   </sect1info>
17   <title>Util-linux-ng-&util-linux-ng-version;</title>
19   <indexterm zone="ch-system-util-linux-ng">
20     <primary sortas="a-Util-linux-ng">Util-linux-ng</primary>
21   </indexterm>
23   <sect2 role="package">
24     <title/>
26     <para>The Util-linux-ng package contains miscellaneous utility programs.
27     Among them are utilities for handling file systems, consoles, partitions,
28     and messages.</para>
30     <segmentedlist>
31       <segtitle>&buildtime;</segtitle>
32       <segtitle>&diskspace;</segtitle>
34       <seglistitem>
35         <seg>&util-linux-ng-ch6-sbu;</seg>
36         <seg>&util-linux-ng-ch6-du;</seg>
37       </seglistitem>
38     </segmentedlist>
40   </sect2>
42   <sect2 role="installation">
43     <title>FHS compliance notes</title>
45     <para>The FHS recommends using the <filename
46     class="directory">/var/lib/hwclock</filename> directory instead of the
47     usual <filename class="directory">/etc</filename> directory as the
48     location for the <filename>adjtime</filename> file. To make the
49     <command>hwclock</command> program FHS-compliant, run the
50     following:</para>
52 <screen><userinput remap="pre">sed -e 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
53     -i $(grep -rl '/etc/adjtime' .)
54 mkdir -pv /var/lib/hwclock</userinput></screen>
56   </sect2>
58   <sect2 role="installation">
59     <title>Installation of Util-linux-ng</title>
61 <screen><userinput remap="configure">./configure --enable-arch --enable-partx --enable-write</userinput></screen>
63     <variablelist>
64       <title>The meaning of the configure options:</title>
66       <varlistentry>
67         <term><parameter>--enable-arch</parameter></term>
68         <listitem>
69           <para>Enables building the <command>arch</command> program</para>
70         </listitem>
71       </varlistentry>
72       <varlistentry>
73         <term><parameter>--enable-partx</parameter></term>
74         <listitem>
75           <para>Enables building the <command>addpart</command>,
76           <command>delpart</command> and <command>partx</command>
77           programs</para>
78         </listitem>
79       </varlistentry>
80       <varlistentry>
81         <term><parameter>--enable-write</parameter></term>
82         <listitem>
83           <para>Enables building the <command>write</command> program</para>
84         </listitem>
85       </varlistentry>
87     </variablelist>
89     <para>Compile the package:</para>
91 <screen><userinput remap="make">make</userinput></screen>
93     <para>This package does not come with a test suite.</para>
95     <para>Install the package:</para>
97 <screen><userinput remap="install">make install</userinput></screen>
99   </sect2>
101   <sect2 id="contents-utillinux" role="content">
102     <title>Contents of Util-linux-ng</title>
104     <segmentedlist>
105       <segtitle>Installed programs</segtitle>
106       <segtitle>Installed libraries</segtitle>
108       <seglistitem>
109         <seg>addpart, agetty, arch, blkid, blockdev, cal, cfdisk, chkdupexe,
110         chrt, col, colcrt, colrm, column, ctrlaltdel, cytune, ddate, delpart,
111         dmesg, fdformat, fdisk, findfs, flock, fsck, fsck.cramfs, fsck.minix,
112         getopt, hexdump, hwclock, i386, ionice, ipcmk, ipcrm, ipcs, isosize,
113         ldattach, line, linux32, linux64, logger, look, losetup, lscpu,
114         mcookie, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap, more, mount,
115         namei, partx, pg, pivot_root, readprofile, rename, renice, rev,
116         rtcwake, script, scriptreplay, setarch, setsid, setterm, sfdisk,
117         swapoff (link to swapon), swapon, switch_root, tailf, taskset, tunelp,
118         ul, umount, uuidd, uuidgen, wall, whereis, and write</seg>
119         <seg>libblkid.{a,so}, libuuid.{a,so}</seg>
120       </seglistitem>
121     </segmentedlist>
123     <variablelist>
124       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
125       <?dbfo list-presentation="list"?>
126       <?dbhtml list-presentation="table"?>
128       <varlistentry id="addpart">
129         <term><command>addpart</command></term>
130         <listitem>
131           <para>Informs the Linux kernel of new partitions</para>
132           <indexterm zone="ch-system-util-linux-ng addpart">
133             <primary sortas="b-addpart">addpart</primary>
134           </indexterm>
135         </listitem>
136       </varlistentry>
138       <varlistentry id="agetty">
139         <term><command>agetty</command></term>
140         <listitem>
141           <para>Opens a tty port, prompts for a login name,
142           and then invokes the <command>login</command> program</para>
143           <indexterm zone="ch-system-util-linux-ng agetty">
144             <primary sortas="b-agetty">agetty</primary>
145           </indexterm>
146         </listitem>
147       </varlistentry>
149       <varlistentry id="arch">
150         <term><command>arch</command></term>
151         <listitem>
152           <para>Reports the machine's architecture</para>
153           <indexterm zone="ch-system-util-linux-ng arch">
154             <primary sortas="b-arch">arch</primary>
155           </indexterm>
156         </listitem>
157       </varlistentry>
159       <varlistentry id="blkid">
160         <term><command>blkid</command></term>
161         <listitem>
162           <para>A command line utility to locate and print block device
163           attributes</para>
164           <indexterm zone="ch-system-util-linux-ng blkid">
165             <primary sortas="b-blkid">blkid</primary>
166           </indexterm>
167         </listitem>
168       </varlistentry>
170       <varlistentry id="blockdev">
171         <term><command>blockdev</command></term>
172         <listitem>
173           <para>Allows users to call block device ioctls from the command
174           line</para>
175           <indexterm zone="ch-system-util-linux-ng blockdev">
176             <primary sortas="b-blockdev">blockdev</primary>
177           </indexterm>
178         </listitem>
179       </varlistentry>
181       <varlistentry id="cal">
182         <term><command>cal</command></term>
183         <listitem>
184           <para>Displays a simple calendar</para>
185           <indexterm zone="ch-system-util-linux-ng cal">
186             <primary sortas="b-cal">cal</primary>
187           </indexterm>
188         </listitem>
189       </varlistentry>
191       <varlistentry id="cfdisk">
192         <term><command>cfdisk</command></term>
193         <listitem>
194           <para>Manipulates the partition table of the given device</para>
195           <indexterm zone="ch-system-util-linux-ng cfdisk">
196             <primary sortas="b-cfdisk">cfdisk</primary>
197           </indexterm>
198         </listitem>
199       </varlistentry>
201       <varlistentry id="chkdupexe">
202         <term><command>chkdupexe</command></term>
203         <listitem>
204           <para>Finds duplicate executables</para>
205           <indexterm zone="ch-system-util-linux-ng chkdupexe">
206             <primary sortas="b-chkdupexe">chkdupexe</primary>
207           </indexterm>
208         </listitem>
209       </varlistentry>
211       <varlistentry id="chrt">
212         <term><command>chrt</command></term>
213         <listitem>
214           <para>Manipulates real-time attributes of a process</para>
215           <indexterm zone="ch-system-util-linux-ng chrt">
216             <primary sortas="b-chrt">chrt</primary>
217           </indexterm>
218         </listitem>
219       </varlistentry>
221       <varlistentry id="col">
222         <term><command>col</command></term>
223         <listitem>
224           <para>Filters out reverse line feeds</para>
225           <indexterm zone="ch-system-util-linux-ng col">
226             <primary sortas="b-col">col</primary>
227           </indexterm>
228         </listitem>
229       </varlistentry>
231       <varlistentry id="colcrt">
232         <term><command>colcrt</command></term>
233         <listitem>
234           <para>Filters <command>nroff</command> output for terminals
235           that lack some capabilities, such as overstriking and half-lines</para>
236           <indexterm zone="ch-system-util-linux-ng colcrt">
237             <primary sortas="b-colcrt">colcrt</primary>
238           </indexterm>
239         </listitem>
240       </varlistentry>
242       <varlistentry id="colrm">
243         <term><command>colrm</command></term>
244         <listitem>
245           <para>Filters out the given columns</para>
246           <indexterm zone="ch-system-util-linux-ng colrm">
247             <primary sortas="b-colrm">colrm</primary>
248           </indexterm>
249         </listitem>
250       </varlistentry>
252       <varlistentry id="column">
253         <term><command>column</command></term>
254         <listitem>
255           <para>Formats a given file into multiple columns</para>
256           <indexterm zone="ch-system-util-linux-ng column">
257             <primary sortas="b-column">column</primary>
258           </indexterm>
259         </listitem>
260       </varlistentry>
262       <varlistentry id="ctrlaltdel">
263         <term><command>ctrlaltdel</command></term>
264         <listitem>
265           <para>Sets the function of the Ctrl+Alt+Del key combination to a
266           hard or a soft reset</para>
267           <indexterm zone="ch-system-util-linux-ng ctrlaltdel">
268             <primary sortas="b-ctrlaltdel">ctrlaltdel</primary>
269           </indexterm>
270         </listitem>
271       </varlistentry>
273       <varlistentry id="cytune">
274         <term><command>cytune</command></term>
275         <listitem>
276           <para>Tunes the parameters of the serial line drivers for
277           Cyclades cards</para>
278           <indexterm zone="ch-system-util-linux-ng cytune">
279             <primary sortas="b-cytune">cytune</primary>
280           </indexterm>
281         </listitem>
282       </varlistentry>
284       <varlistentry id="ddate">
285         <term><command>ddate</command></term>
286         <listitem>
287           <para>Gives the Discordian date or converts the given Gregorian date
288           to a Discordian one</para>
289           <indexterm zone="ch-system-util-linux-ng ddate">
290             <primary sortas="b-ddate">ddate</primary>
291           </indexterm>
292         </listitem>
293       </varlistentry>
295       <varlistentry id="delpart">
296         <term><command>delpart</command></term>
297         <listitem>
298           <para>Asks the Linux kernel to remove a partition</para>
299           <indexterm zone="ch-system-util-linux-ng delpart">
300             <primary sortas="b-delpart">delpart</primary>
301           </indexterm>
302         </listitem>
303       </varlistentry>
305       <varlistentry id="dmesg">
306         <term><command>dmesg</command></term>
307         <listitem>
308           <para>Dumps the kernel boot messages</para>
309           <indexterm zone="ch-system-util-linux-ng dmesg">
310             <primary sortas="b-dmesg">dmesg</primary>
311           </indexterm>
312         </listitem>
313       </varlistentry>
315       <varlistentry id="fdformat">
316         <term><command>fdformat</command></term>
317         <listitem>
318           <para>Low-level formats a floppy disk</para>
319           <indexterm zone="ch-system-util-linux-ng fdformat">
320             <primary sortas="b-fdformat">fdformat</primary>
321           </indexterm>
322         </listitem>
323       </varlistentry>
325       <varlistentry id="fdisk">
326         <term><command>fdisk</command></term>
327         <listitem>
328           <para>Manipulates the paritition table of the given device</para>
329           <indexterm zone="ch-system-util-linux-ng fdisk">
330             <primary sortas="b-fdisk">fdisk</primary>
331           </indexterm>
332         </listitem>
333       </varlistentry>
335       <varlistentry id="findfs">
336         <term><command>findfs</command></term>
337         <listitem>
338           <para>Finds a file system by label or Universally Unique Identifier
339           (UUID)</para>
340           <indexterm zone="ch-system-util-linux-ng findfs">
341             <primary sortas="b-findfs">findfs</primary>
342           </indexterm>
343         </listitem>
344       </varlistentry>
346       <varlistentry id="flock">
347         <term><command>flock</command></term>
348         <listitem>
349           <para>Acquires a file lock and then executes a command with the lock
350           held</para>
351           <indexterm zone="ch-system-util-linux-ng flock">
352             <primary sortas="b-flock">flock</primary>
353           </indexterm>
354         </listitem>
355       </varlistentry>
357       <varlistentry id="fsck">
358         <term><command>fsck</command></term>
359         <listitem>
360           <para>Is used to check, and optionally repair, file systems</para>
361           <indexterm zone="ch-system-util-linux-ng fsck">
362             <primary sortas="b-fsck">fsck</primary>
363           </indexterm>
364         </listitem>
365       </varlistentry>
367       <varlistentry id="fsck.cramfs">
368         <term><command>fsck.cramfs</command></term>
369         <listitem>
370           <para>Performs a consistency check on the Cramfs file system on the
371           given device</para>
372           <indexterm zone="ch-system-util-linux-ng fsck.cramfs">
373             <primary sortas="b-fsck.cramfs">fsck.cramfs</primary>
374           </indexterm>
375         </listitem>
376       </varlistentry>
378       <varlistentry id="fsck.minix">
379         <term><command>fsck.minix</command></term>
380         <listitem>
381           <para>Performs a consistency check on the Minix file system on the
382           given device</para>
383           <indexterm zone="ch-system-util-linux-ng fsck.minix">
384             <primary sortas="b-fsck.minix">fsck.minix</primary>
385           </indexterm>
386         </listitem>
387       </varlistentry>
389       <varlistentry id="getopt">
390         <term><command>getopt</command></term>
391         <listitem>
392           <para>Parses options in the given command line</para>
393           <indexterm zone="ch-system-util-linux-ng getopt">
394             <primary sortas="b-getopt">getopt</primary>
395           </indexterm>
396         </listitem>
397       </varlistentry>
399       <varlistentry id="hexdump">
400         <term><command>hexdump</command></term>
401         <listitem>
402           <para>Dumps the given file in hexadecimal or in another given
403           format</para>
404           <indexterm zone="ch-system-util-linux-ng hexdump">
405             <primary sortas="b-hexdump">hexdump</primary>
406           </indexterm>
407         </listitem>
408       </varlistentry>
410       <varlistentry id="hwclock">
411         <term><command>hwclock</command></term>
412         <listitem>
413           <para>Reads or sets the system's hardware clock, also called
414           the Real-Time Clock (RTC) or Basic Input-Output System (BIOS)
415           clock</para>
416           <indexterm zone="ch-system-util-linux-ng hwclock">
417             <primary sortas="b-hwclock">hwclock</primary>
418           </indexterm>
419         </listitem>
420       </varlistentry>
422       <varlistentry id="i386">
423         <term><command>i386</command></term>
424         <listitem>
425           <para>A symbolic link to setarch</para>
426           <indexterm zone="ch-system-util-linux-ng i386">
427             <primary sortas="b-i386">i386</primary>
428           </indexterm>
429         </listitem>
430       </varlistentry>
432       <varlistentry id="ionice">
433         <term><command>ionice</command></term>
434         <listitem>
435           <para>Gets or sets the io scheduling class and priority for a program</para>
436           <indexterm zone="ch-system-util-linux-ng ionice">
437             <primary sortas="b-ionice">ionice</primary>
438           </indexterm>
439         </listitem>
440       </varlistentry>
442       <varlistentry id="ipcmk">
443         <term><command>ipcmk</command></term>
444         <listitem>
445           <para>Creates various IPC resources</para>
446           <indexterm zone="ch-system-util-linux-ng ipcmk">
447             <primary sortas="b-ipcmk">ipcmk</primary>
448           </indexterm>
449         </listitem>
450       </varlistentry>
452       <varlistentry id="ipcrm">
453         <term><command>ipcrm</command></term>
454         <listitem>
455           <para>Removes the given Inter-Process Communication (IPC) resource</para>
456           <indexterm zone="ch-system-util-linux-ng ipcrm">
457             <primary sortas="b-ipcrm">ipcrm</primary>
458           </indexterm>
459         </listitem>
460       </varlistentry>
462       <varlistentry id="ipcs">
463         <term><command>ipcs</command></term>
464         <listitem>
465           <para>Provides IPC status information</para>
466           <indexterm zone="ch-system-util-linux-ng ipcs">
467             <primary sortas="b-ipcs">ipcs</primary>
468           </indexterm>
469         </listitem>
470       </varlistentry>
472       <varlistentry id="isosize">
473         <term><command>isosize</command></term>
474         <listitem>
475           <para>Reports the size of an iso9660 file system</para>
476           <indexterm zone="ch-system-util-linux-ng isosize">
477             <primary sortas="b-isosize">isosize</primary>
478           </indexterm>
479         </listitem>
480       </varlistentry>
482       <varlistentry id="ldattach">
483         <term><command>ldattach</command></term>
484         <listitem>
485           <para>Attaches a line discipline to a serial line</para>
486           <indexterm zone="ch-system-util-linux-ng ldattach">
487             <primary sortas="b-ldattach">ldattach</primary>
488           </indexterm>
489         </listitem>
490       </varlistentry>
492       <varlistentry id="line">
493         <term><command>line</command></term>
494         <listitem>
495           <para>Copies a single line</para>
496           <indexterm zone="ch-system-util-linux-ng line">
497             <primary sortas="b-line">line</primary>
498           </indexterm>
499         </listitem>
500       </varlistentry>
502       <varlistentry id="linux32">
503         <term><command>linux32</command></term>
504         <listitem>
505           <para>A symbolic link to setarch</para>
506           <indexterm zone="ch-system-util-linux-ng linux32">
507             <primary sortas="b-linux32">linux32</primary>
508           </indexterm>
509         </listitem>
510       </varlistentry>
512       <varlistentry id="linux64">
513         <term><command>linux64</command></term>
514         <listitem>
515           <para>A symbolic link to setarch</para>
516           <indexterm zone="ch-system-util-linux-ng linux64">
517             <primary sortas="b-linux64">linux64</primary>
518           </indexterm>
519         </listitem>
520       </varlistentry>
522       <varlistentry id="logger">
523         <term><command>logger</command></term>
524         <listitem>
525           <para>Enters the given message into the system log</para>
526           <indexterm zone="ch-system-util-linux-ng logger">
527             <primary sortas="b-logger">logger</primary>
528           </indexterm>
529         </listitem>
530       </varlistentry>
532       <varlistentry id="look">
533         <term><command>look</command></term>
534         <listitem>
535           <para>Displays lines that begin with the given string</para>
536           <indexterm zone="ch-system-util-linux-ng look">
537             <primary sortas="b-look">look</primary>
538           </indexterm>
539         </listitem>
540       </varlistentry>
542       <varlistentry id="losetup">
543         <term><command>losetup</command></term>
544         <listitem>
545           <para>Sets up and controls loop devices</para>
546           <indexterm zone="ch-system-util-linux-ng losetup">
547             <primary sortas="b-losetup">losetup</primary>
548           </indexterm>
549         </listitem>
550       </varlistentry>
552       <varlistentry id="lscpu">
553         <term><command>lscpu</command></term>
554         <listitem>
555           <para>Prints CPU architechture information</para>
556           <indexterm zone="ch-system-util-linux-ng lscpu">
557             <primary sortas="b-lscpu">lscpu</primary>
558           </indexterm>
559         </listitem>
560       </varlistentry>
562       <varlistentry id="mcookie">
563         <term><command>mcookie</command></term>
564         <listitem>
565           <para>Generates magic cookies (128-bit random hexadecimal numbers) for
566           <command>xauth</command></para>
567           <indexterm zone="ch-system-util-linux-ng mcookie">
568             <primary sortas="b-mcookie">mcookie</primary>
569           </indexterm>
570         </listitem>
571       </varlistentry>
573       <varlistentry id="mkfs">
574         <term><command>mkfs</command></term>
575         <listitem>
576           <para>Builds a file system on a device (usually a hard disk
577           partition)</para>
578           <indexterm zone="ch-system-util-linux-ng mkfs">
579             <primary sortas="b-mkfs">mkfs</primary>
580           </indexterm>
581         </listitem>
582       </varlistentry>
584       <varlistentry id="mkfs.bfs">
585         <term><command>mkfs.bfs</command></term>
586         <listitem>
587           <para>Creates a Santa Cruz Operations (SCO) bfs file system</para>
588           <indexterm zone="ch-system-util-linux-ng mkfs.bfs">
589             <primary sortas="b-mkfs.bfs">mkfs.bfs</primary>
590           </indexterm>
591         </listitem>
592       </varlistentry>
594       <varlistentry id="mkfs.cramfs">
595         <term><command>mkfs.cramfs</command></term>
596         <listitem>
597           <para>Creates a cramfs file system</para>
598           <indexterm zone="ch-system-util-linux-ng mkfs.cramfs">
599             <primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary>
600           </indexterm>
601         </listitem>
602       </varlistentry>
604       <varlistentry id="mkfs.minix">
605         <term><command>mkfs.minix</command></term>
606         <listitem>
607           <para>Creates a Minix file system</para>
608           <indexterm zone="ch-system-util-linux-ng mkfs.minix">
609             <primary sortas="b-mkfs.minix">mkfs.minix</primary>
610           </indexterm>
611         </listitem>
612       </varlistentry>
614       <varlistentry id="mkswap">
615         <term><command>mkswap</command></term>
616         <listitem>
617           <para>Initializes the given device or file to be used as a swap
618           area</para>
619           <indexterm zone="ch-system-util-linux-ng mkswap">
620             <primary sortas="b-mkswap">mkswap</primary>
621           </indexterm>
622         </listitem>
623       </varlistentry>
625       <varlistentry id="more">
626         <term><command>more</command></term>
627         <listitem>
628           <para>A filter for paging through text one screen at a time</para>
629           <indexterm zone="ch-system-util-linux-ng more">
630             <primary sortas="b-more">more</primary>
631           </indexterm>
632         </listitem>
633       </varlistentry>
635       <varlistentry id="mount">
636         <term><command>mount</command></term>
637         <listitem>
638           <para>Attaches the file system on the given device to a specified
639           directory in the file-system tree</para>
640           <indexterm zone="ch-system-util-linux-ng mount">
641             <primary sortas="b-mount">mount</primary>
642           </indexterm>
643         </listitem>
644       </varlistentry>
646       <varlistentry id="namei">
647         <term><command>namei</command></term>
648         <listitem>
649           <para>Shows the symbolic links in the given pathnames</para>
650           <indexterm zone="ch-system-util-linux-ng namei">
651             <primary sortas="b-namei">namei</primary>
652           </indexterm>
653         </listitem>
654       </varlistentry>
656       <varlistentry id="partx">
657         <term><command>partx</command></term>
658         <listitem>
659           <para>Tells the kernel about the presence and numbering of on-disk
660           partitions</para>
661           <indexterm zone="ch-system-util-linux-ng partx">
662             <primary sortas="b-partx">partx</primary>
663           </indexterm>
664         </listitem>
665       </varlistentry>
667       <varlistentry id="pg">
668         <term><command>pg</command></term>
669         <listitem>
670           <para>Displays a text file one screen full at a time</para>
671           <indexterm zone="ch-system-util-linux-ng pg">
672             <primary sortas="b-pg">pg</primary>
673           </indexterm>
674         </listitem>
675       </varlistentry>
677       <varlistentry id="pivot_root">
678         <term><command>pivot_root</command></term>
679         <listitem>
680           <para>Makes the given file system the new root file system of the
681           current process</para>
682           <indexterm zone="ch-system-util-linux-ng pivot_root">
683             <primary sortas="b-pivot_root">pivot_root</primary>
684           </indexterm>
685         </listitem>
686       </varlistentry>
688       <varlistentry id="readprofile">
689         <term><command>readprofile</command></term>
690         <listitem>
691           <para>Reads kernel profiling information</para>
692           <indexterm zone="ch-system-util-linux-ng readprofile">
693             <primary sortas="b-readprofile">readprofile</primary>
694           </indexterm>
695         </listitem>
696       </varlistentry>
698       <varlistentry id="rename">
699         <term><command>rename</command></term>
700         <listitem>
701           <para>Renames the given files, replacing a given string with
702           another</para>
703           <indexterm zone="ch-system-util-linux-ng rename">
704             <primary sortas="b-rename">rename</primary>
705           </indexterm>
706         </listitem>
707       </varlistentry>
709       <varlistentry id="renice">
710         <term><command>renice</command></term>
711         <listitem>
712           <para>Alters the priority of running processes</para>
713           <indexterm zone="ch-system-util-linux-ng renice">
714             <primary sortas="b-renice">renice</primary>
715           </indexterm>
716         </listitem>
717       </varlistentry>
719       <varlistentry id="rev">
720         <term><command>rev</command></term>
721         <listitem>
722           <para>Reverses the lines of a given file</para>
723           <indexterm zone="ch-system-util-linux-ng rev">
724             <primary sortas="b-rev">rev</primary>
725           </indexterm>
726         </listitem>
727       </varlistentry>
729       <varlistentry id="rtcwake">
730         <term><command>rtcwake</command></term>
731         <listitem>
732           <para>Used to enter a system sleep state until specified wakeup
733           time</para>
734           <indexterm zone="ch-system-util-linux-ng rtcwake">
735             <primary sortas="b-rtcwake">rtcwake</primary>
736           </indexterm>
737         </listitem>
738       </varlistentry>
740       <varlistentry id="script">
741         <term><command>script</command></term>
742         <listitem>
743           <para>Makes a typescript of a terminal session</para>
744           <indexterm zone="ch-system-util-linux-ng script">
745             <primary sortas="b-script">script</primary>
746           </indexterm>
747         </listitem>
748       </varlistentry>
750       <varlistentry id="scriptreplay">
751         <term><command>scriptreplay</command></term>
752         <listitem>
753           <para>Plays back typescripts using timing information</para>
754           <indexterm zone="ch-system-util-linux-ng scriptreplay">
755             <primary sortas="b-scriptreplay">scriptreplay</primary>
756           </indexterm>
757         </listitem>
758       </varlistentry>
760       <varlistentry id="setarch">
761         <term><command>setarch</command></term>
762         <listitem>
763           <para>Changes reported architecture in a new program environment and
764           sets personality flags</para>
765           <indexterm zone="ch-system-util-linux-ng setarch">
766             <primary sortas="b-setarch">setarch</primary>
767           </indexterm>
768         </listitem>
769       </varlistentry>
771       <varlistentry id="setsid">
772         <term><command>setsid</command></term>
773         <listitem>
774           <para>Runs the given program in a new session</para>
775           <indexterm zone="ch-system-util-linux-ng setsid">
776             <primary sortas="b-setsid">setsid</primary>
777           </indexterm>
778         </listitem>
779       </varlistentry>
781       <varlistentry id="setterm">
782         <term><command>setterm</command></term>
783         <listitem>
784           <para>Sets terminal attributes</para>
785           <indexterm zone="ch-system-util-linux-ng setterm">
786             <primary sortas="b-setterm">setterm</primary>
787           </indexterm>
788         </listitem>
789       </varlistentry>
791       <varlistentry id="sfdisk">
792         <term><command>sfdisk</command></term>
793         <listitem>
794           <para>A disk partition table manipulator</para>
795           <indexterm zone="ch-system-util-linux-ng sfdisk">
796             <primary sortas="b-sfdisk">sfdisk</primary>
797           </indexterm>
798         </listitem>
799       </varlistentry>
801       <varlistentry id="swapoff">
802         <term><command>swapoff</command></term>
803         <listitem>
804           <para>Disables devices and files for paging and swapping</para>
805           <indexterm zone="ch-system-util-linux-ng swapoff">
806             <primary sortas="b-swapoff">swapoff</primary>
807           </indexterm>
808         </listitem>
809       </varlistentry>
811       <varlistentry id="swapon">
812         <term><command>swapon</command></term>
813         <listitem>
814           <para>Enables devices and files for paging and swapping and
815           lists the devices and files currently in use</para>
816           <indexterm zone="ch-system-util-linux-ng swapon">
817             <primary sortas="b-swapon">swapon</primary>
818           </indexterm>
819         </listitem>
820       </varlistentry>
822       <varlistentry id="switch_root">
823         <term><command>switch_root</command></term>
824         <listitem>
825           <para>Switches to another filesystem as the root of the mount tree</para>
826           <indexterm zone="ch-system-util-linux-ng switch_root">
827             <primary sortas="b-switch_root">switch_root</primary>
828           </indexterm>
829         </listitem>
830       </varlistentry>
832       <varlistentry id="tailf">
833         <term><command>tailf</command></term>
834         <listitem>
835           <para>Tracks the growth of a log file. Displays the last 10 lines
836           of a log file, then continues displaying any new entries in the
837           log file as they are created</para>
838           <indexterm zone="ch-system-util-linux-ng tailf">
839             <primary sortas="b-tailf">tailf</primary>
840           </indexterm>
841         </listitem>
842       </varlistentry>
844       <varlistentry id="taskset">
845         <term><command>taskset</command></term>
846         <listitem>
847           <para>Retrieves or sets a process' CPU affinity</para>
848           <indexterm zone="ch-system-util-linux-ng taskset">
849             <primary sortas="b-taskset">taskset</primary>
850           </indexterm>
851         </listitem>
852       </varlistentry>
854       <varlistentry id="tunelp">
855         <term><command>tunelp</command></term>
856         <listitem>
857           <para>Tunes the parameters of the line printer</para>
858           <indexterm zone="ch-system-util-linux-ng tunelp">
859             <primary sortas="b-tunelp">tunelp</primary>
860           </indexterm>
861         </listitem>
862       </varlistentry>
864       <varlistentry id="ul">
865         <term><command>ul</command></term>
866         <listitem>
867           <para>A filter for translating underscores into escape sequences
868           indicating underlining for the terminal in use</para>
869           <indexterm zone="ch-system-util-linux-ng ul">
870             <primary sortas="b-ul">ul</primary>
871           </indexterm>
872         </listitem>
873       </varlistentry>
875       <varlistentry id="umount">
876         <term><command>umount</command></term>
877         <listitem>
878           <para>Disconnects a file system from the system's file tree</para>
879           <indexterm zone="ch-system-util-linux-ng umount">
880             <primary sortas="b-umount">umount</primary>
881           </indexterm>
882         </listitem>
883       </varlistentry>
885       <varlistentry id="uuidd">
886         <term><command>uuidd</command></term>
887         <listitem>
888           <para>A daemon used by the UUID library to generate time-based
889           UUIDs in a secure and guranteed-unique fashion.</para>
890           <indexterm zone="ch-system-util-linux-ng uuidd">
891             <primary sortas="b-uuidd">uuidd</primary>
892           </indexterm>
893         </listitem>
894       </varlistentry>
896       <varlistentry id="uuidgen">
897         <term><command>uuidgen</command></term>
898         <listitem>
899           <para>Creates new UUIDs. Each new UUID can reasonably be considered
900           unique among all UUIDs created, on the local system and on other
901           systems, in the past and in the future</para>
902           <indexterm zone="ch-system-util-linux-ng uuidgen">
903             <primary sortas="b-uuidgen">uuidgen</primary>
904           </indexterm>
905         </listitem>
906       </varlistentry>
908       <varlistentry id="wall">
909         <term><command>wall</command></term>
910         <listitem>
911           <para>Displays the contents of a file or, by default, its standard
912           input, on the terminals of all currently logged in users</para>
913           <indexterm zone="ch-system-util-linux-ng wall">
914             <primary sortas="b-wall">wall</primary>
915           </indexterm>
916         </listitem>
917       </varlistentry>
919       <varlistentry id="whereis">
920         <term><command>whereis</command></term>
921         <listitem>
922           <para>Reports the location of the binary, source, and man page
923           for the given command</para>
924           <indexterm zone="ch-system-util-linux-ng whereis">
925             <primary sortas="b-whereis">whereis</primary>
926           </indexterm>
927         </listitem>
928       </varlistentry>
930       <varlistentry id="write">
931         <term><command>write</command></term>
932         <listitem>
933           <para>Sends a message to the given user <emphasis>if</emphasis> that
934           user has not disabled receipt of such messages</para>
935           <indexterm zone="ch-system-util-linux-ng write">
936             <primary sortas="b-write">write</primary>
937           </indexterm>
938         </listitem>
939       </varlistentry>
941       <varlistentry id="libblkid">
942         <term><filename class="libraryfile">libblkid</filename></term>
943         <listitem>
944           <para>Contains routines for device identification and token
945           extraction</para>
946           <indexterm zone="ch-system-util-linux-ng libblkid">
947             <primary sortas="c-libblkid">libblkid</primary>
948           </indexterm>
949         </listitem>
950       </varlistentry>
952       <varlistentry id="libuuid">
953         <term><filename class="libraryfile">libuuid</filename></term>
954         <listitem>
955           <para>Contains routines for generating unique identifiers for objects
956           that may be accessible beyond the local system</para>
957           <indexterm zone="ch-system-util-linux-ng libuuid">
958             <primary sortas="c-libuuid">libuuid</primary>
959           </indexterm>
960         </listitem>
961       </varlistentry>
963     </variablelist>
965   </sect2>
967 </sect1>