Update to Python-3.8.2.
[linux_from_scratch.git] / chapter06 / util-linux.xml
blobde24d670f9b065c375c1061b2f90dfe7806b935b
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" role="wrap">
9   <?dbhtml filename="util-linux.html"?>
11   <sect1info condition="script">
12     <productname>util-linux</productname>
13     <productnumber>&util-linux-version;</productnumber>
14     <address>&util-linux-url;</address>
15   </sect1info>
17   <title>Util-linux-&util-linux-version;</title>
19   <indexterm zone="ch-system-util-linux">
20     <primary sortas="a-Util-linux">Util-linux</primary>
21   </indexterm>
23   <sect2 role="package">
24     <title/>
26     <para>The Util-linux 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-ch6-sbu;</seg>
36         <seg>&util-linux-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.  First create a directory
49     to enable storage for the <command>hwclock</command> program:</para>
51 <screen><userinput remap="pre">mkdir -pv /var/lib/hwclock</userinput></screen>
53   </sect2>
55   <sect2 role="installation">
56     <title>Installation of Util-linux</title>
57 <!--
58     <para>First, fix one of the regression tests:</para>
60 <screen><userinput remap="pre">sed -e 's/2^64/(2^64/' -e 's/E &lt;/E) &lt;=/' -e 's/ne /eq /' \
61     -i tests/ts/ipcs/limits2</userinput></screen>
62 -->
63     <para revision="systemd">Remove the earlier created symlinks:</para>
65 <screen revision="systemd"><userinput remap="pre">rm -vf /usr/include/{blkid,libmount,uuid}</userinput></screen>
67     <para>Prepare Util-linux for compilation:</para>
69 <screen revision="sysv"><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime   \
70             --docdir=/usr/share/doc/util-linux-&util-linux-version; \
71             --disable-chfn-chsh  \
72             --disable-login      \
73             --disable-nologin    \
74             --disable-su         \
75             --disable-setpriv    \
76             --disable-runuser    \
77             --disable-pylibmount \
78             --disable-static     \
79             --without-python     \
80             --without-systemd    \
81             --without-systemdsystemunitdir</userinput></screen>
83 <screen revision="systemd"><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime   \
84             --docdir=/usr/share/doc/util-linux-&util-linux-version; \
85             --disable-chfn-chsh  \
86             --disable-login      \
87             --disable-nologin    \
88             --disable-su         \
89             --disable-setpriv    \
90             --disable-runuser    \
91             --disable-pylibmount \
92             --disable-static     \
93             --without-python</userinput></screen>
95     <para>The --disable and --without options prevent warnings about
96     building components that require packages not in LFS or are 
97     inconsistent with programs installed by other packages.</para>
99     <para>Compile the package:</para>
101 <screen><userinput remap="make">make</userinput></screen>
103     <para>If desired, run the test suite as a non-root user:</para>
105     <warning><para>Running the test suite as the root user can be harmful to
106     your system.  To run it, the CONFIG_SCSI_DEBUG option for the kernel must
107     be available in the currently running system, and must be built as a
108     module.  Building it into the kernel will prevent booting.  For complete
109     coverage, other BLFS packages must be installed.  If desired, this test can
110     be run after rebooting into the completed LFS system and running:</para>
112     <screen role="nodump"><userinput>bash tests/run.sh --srcdir=$PWD --builddir=$PWD</userinput></screen> 
113     </warning>
115     <screen><userinput remap="test">chown -Rv nobody .
116 su nobody -s /bin/bash -c "PATH=$PATH make -k check"</userinput></screen>
118     <para>Install the package:</para>
120 <screen><userinput remap="install">make install</userinput></screen>
122   </sect2>
124   <sect2 id="contents-utillinux" role="content">
125     <title>Contents of Util-linux</title>
127     <segmentedlist>
128       <segtitle>Installed programs</segtitle>
129       <segtitle>Installed libraries</segtitle>
130       <segtitle>Installed directories</segtitle>
132       <seglistitem>
133         <seg>addpart, agetty, blkdiscard, blkid, blkzone, blockdev, cal, cfdisk, chcpu,
134         chmem, choom, chrt, col, colcrt, colrm, column, ctrlaltdel, delpart, dmesg,
135         eject, fallocate, fdformat, fdisk, fincore, findfs, findmnt, flock, fsck,
136         fsck.cramfs, fsck.minix, fsfreeze, fstrim, getopt, hexdump, hwclock,
137         i386, ionice, ipcmk, ipcrm, ipcs, isosize, kill, last, lastb (link to
138         last), ldattach, linux32, linux64, logger, look, losetup, lsblk, lscpu,
139         lsipc, lslocks, lslogins, lsmem, lsns, mcookie, mesg, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap,
140         more, mount, mountpoint, namei, nsenter, partx, pivot_root, prlimit, raw,
141         readprofile, rename, renice, resizepart, rev, rfkill, rtcwake, script,
142         scriptreplay, setarch, setsid, setterm, sfdisk, sulogin, swaplabel,
143         swapoff (link to swapon), swapon, switch_root, taskset, ul,
144         umount, uname26, unshare, utmpdump, uuidd, uuidgen, uuidparse, wall, wdctl, whereis,
145         wipefs, x86_64, and zramctl</seg>
146         <seg>libblkid.so, libfdisk.so, libmount.so, 
147         libsmartcols.so, and libuuid.so</seg>
148         <seg>/usr/include/blkid, 
149              /usr/include/libfdisk, 
150              /usr/include/libmount, 
151              /usr/include/libsmartcols, 
152              /usr/include/uuid, 
153              /usr/share/doc/util-linux-&util-linux-version;, 
154          and /var/lib/hwclock</seg>
155       </seglistitem>
156     </segmentedlist>
158     <variablelist>
159       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
160       <?dbfo list-presentation="list"?>
161       <?dbhtml list-presentation="table"?>
163       <varlistentry id="addpart">
164         <term><command>addpart</command></term>
165         <listitem>
166           <para>Informs the Linux kernel of new partitions</para>
167           <indexterm zone="ch-system-util-linux addpart">
168             <primary sortas="b-addpart">addpart</primary>
169           </indexterm>
170         </listitem>
171       </varlistentry>
173       <varlistentry id="agetty">
174         <term><command>agetty</command></term>
175         <listitem>
176           <para>Opens a tty port, prompts for a login name,
177           and then invokes the <command>login</command> program</para>
178           <indexterm zone="ch-system-util-linux agetty">
179             <primary sortas="b-agetty">agetty</primary>
180           </indexterm>
181         </listitem>
182       </varlistentry>
184       <varlistentry id="blkdiscard">
185         <term><command>blkdiscard</command></term>
186         <listitem>
187           <para>Discards sectors on a device</para>
188           <indexterm zone="ch-system-util-linux blkdiscard">
189             <primary sortas="b-blkdiscard">blkdiscard</primary>
190           </indexterm>
191         </listitem>
192       </varlistentry>
194       <varlistentry id="blkid">
195         <term><command>blkid</command></term>
196         <listitem>
197           <para>A command line utility to locate and print block device
198           attributes</para>
199           <indexterm zone="ch-system-util-linux blkid">
200             <primary sortas="b-blkid">blkid</primary>
201           </indexterm>
202         </listitem>
203       </varlistentry>
205       <varlistentry id="blkzone">
206         <term><command>blkzone</command></term>
207         <listitem>
208           <para>Runs zone command on the given block device</para>
209           <indexterm zone="ch-system-util-linux blkzone">
210             <primary sortas="b-blkzone">blkzone</primary>
211           </indexterm>
212         </listitem>
213       </varlistentry>
215       <varlistentry id="blockdev">
216         <term><command>blockdev</command></term>
217         <listitem>
218           <para>Allows users to call block device ioctls from the command
219           line</para>
220           <indexterm zone="ch-system-util-linux blockdev">
221             <primary sortas="b-blockdev">blockdev</primary>
222           </indexterm>
223         </listitem>
224       </varlistentry>
226       <varlistentry id="cal">
227         <term><command>cal</command></term>
228         <listitem>
229           <para>Displays a simple calendar</para>
230           <indexterm zone="ch-system-util-linux cal">
231             <primary sortas="b-cal">cal</primary>
232           </indexterm>
233         </listitem>
234       </varlistentry>
236       <varlistentry id="cfdisk">
237         <term><command>cfdisk</command></term>
238         <listitem>
239           <para>Manipulates the partition table of the given device</para>
240           <indexterm zone="ch-system-util-linux cfdisk">
241             <primary sortas="b-cfdisk">cfdisk</primary>
242           </indexterm>
243         </listitem>
244       </varlistentry>
246       <varlistentry id="chcpu">
247         <term><command>chcpu</command></term>
248         <listitem>
249           <para>Modifies the state of CPUs</para>
250           <indexterm zone="ch-system-util-linux chcpu">
251             <primary sortas="b-chcpu">chcpu</primary>
252           </indexterm>
253         </listitem>
254       </varlistentry>
256       <varlistentry id="chmem">
257         <term><command>chmem</command></term>
258         <listitem>
259           <para>Configures memory</para>
260           <indexterm zone="ch-system-util-linux chmem">
261             <primary sortas="b-chmem">chmem</primary>
262           </indexterm>
263         </listitem>
264       </varlistentry>
266       <varlistentry id="choom">
267         <term><command>choom</command></term>
268         <listitem>
269           <para>Displays and adjusts OOM-killer score</para>
270           <indexterm zone="ch-system-util-linux choom">
271             <primary sortas="b-choom">choom</primary>
272           </indexterm>
273         </listitem>
274       </varlistentry>
276       <varlistentry id="chrt">
277         <term><command>chrt</command></term>
278         <listitem>
279           <para>Manipulates real-time attributes of a process</para>
280           <indexterm zone="ch-system-util-linux chrt">
281             <primary sortas="b-chrt">chrt</primary>
282           </indexterm>
283         </listitem>
284       </varlistentry>
286       <varlistentry id="col">
287         <term><command>col</command></term>
288         <listitem>
289           <para>Filters out reverse line feeds</para>
290           <indexterm zone="ch-system-util-linux col">
291             <primary sortas="b-col">col</primary>
292           </indexterm>
293         </listitem>
294       </varlistentry>
296       <varlistentry id="colcrt">
297         <term><command>colcrt</command></term>
298         <listitem>
299           <para>Filters <command>nroff</command> output for terminals
300           that lack some capabilities, such as overstriking and half-lines</para>
301           <indexterm zone="ch-system-util-linux colcrt">
302             <primary sortas="b-colcrt">colcrt</primary>
303           </indexterm>
304         </listitem>
305       </varlistentry>
307       <varlistentry id="colrm">
308         <term><command>colrm</command></term>
309         <listitem>
310           <para>Filters out the given columns</para>
311           <indexterm zone="ch-system-util-linux colrm">
312             <primary sortas="b-colrm">colrm</primary>
313           </indexterm>
314         </listitem>
315       </varlistentry>
317       <varlistentry id="column">
318         <term><command>column</command></term>
319         <listitem>
320           <para>Formats a given file into multiple columns</para>
321           <indexterm zone="ch-system-util-linux column">
322             <primary sortas="b-column">column</primary>
323           </indexterm>
324         </listitem>
325       </varlistentry>
327       <varlistentry id="ctrlaltdel">
328         <term><command>ctrlaltdel</command></term>
329         <listitem>
330           <para>Sets the function of the Ctrl+Alt+Del key combination to a
331           hard or a soft reset</para>
332           <indexterm zone="ch-system-util-linux ctrlaltdel">
333             <primary sortas="b-ctrlaltdel">ctrlaltdel</primary>
334           </indexterm>
335         </listitem>
336       </varlistentry>
338       <varlistentry id="delpart">
339         <term><command>delpart</command></term>
340         <listitem>
341           <para>Asks the Linux kernel to remove a partition</para>
342           <indexterm zone="ch-system-util-linux delpart">
343             <primary sortas="b-delpart">delpart</primary>
344           </indexterm>
345         </listitem>
346       </varlistentry>
348       <varlistentry id="dmesg">
349         <term><command>dmesg</command></term>
350         <listitem>
351           <para>Dumps the kernel boot messages</para>
352           <indexterm zone="ch-system-util-linux dmesg">
353             <primary sortas="b-dmesg">dmesg</primary>
354           </indexterm>
355         </listitem>
356       </varlistentry>
358       <varlistentry id="eject">
359         <term><command>eject</command></term>
360         <listitem>
361           <para>Ejects removable media</para>
362           <indexterm zone="ch-system-util-linux eject">
363             <primary sortas="b-eject">eject</primary>
364           </indexterm>
365         </listitem>
366       </varlistentry>
368       <varlistentry id="fallocate">
369         <term><command>fallocate</command></term>
370         <listitem>
371           <para>Preallocates space to a file</para>
372           <indexterm zone="ch-system-util-linux fallocate">
373             <primary sortas="b-fallocate">fallocate</primary>
374           </indexterm>
375         </listitem>
376       </varlistentry>
378       <varlistentry id="fdformat">
379         <term><command>fdformat</command></term>
380         <listitem>
381           <para>Low-level formats a floppy disk</para>
382           <indexterm zone="ch-system-util-linux fdformat">
383             <primary sortas="b-fdformat">fdformat</primary>
384           </indexterm>
385         </listitem>
386       </varlistentry>
388       <varlistentry id="fdisk">
389         <term><command>fdisk</command></term>
390         <listitem>
391           <para>Manipulates the partition table of the given device</para>
392           <indexterm zone="ch-system-util-linux fdisk">
393             <primary sortas="b-fdisk">fdisk</primary>
394           </indexterm>
395         </listitem>
396       </varlistentry>
398       <varlistentry id="fincore">
399         <term><command>fincore</command></term>
400         <listitem>
401           <para>Counts pages of file contents in core</para>
402           <indexterm zone="ch-system-util-linux fincore">
403             <primary sortas="b-fincore">fincore</primary>
404           </indexterm>
405         </listitem>
406       </varlistentry>
408       <varlistentry id="findfs">
409         <term><command>findfs</command></term>
410         <listitem>
411           <para>Finds a file system by label or Universally Unique Identifier
412           (UUID)</para>
413           <indexterm zone="ch-system-util-linux findfs">
414             <primary sortas="b-findfs">findfs</primary>
415           </indexterm>
416         </listitem>
417       </varlistentry>
419       <varlistentry id="findmnt">
420         <term><command>findmnt</command></term>
421         <listitem>
422           <para>Is a command line interface to the libmount library
423           for work with mountinfo, fstab and mtab files</para>
424           <indexterm zone="ch-system-util-linux findmnt">
425             <primary sortas="b-findmnt">findmnt</primary>
426           </indexterm>
427         </listitem>
428       </varlistentry>
430       <varlistentry id="flock">
431         <term><command>flock</command></term>
432         <listitem>
433           <para>Acquires a file lock and then executes a command with the lock
434           held</para>
435           <indexterm zone="ch-system-util-linux flock">
436             <primary sortas="b-flock">flock</primary>
437           </indexterm>
438         </listitem>
439       </varlistentry>
441       <varlistentry id="fsck">
442         <term><command>fsck</command></term>
443         <listitem>
444           <para>Is used to check, and optionally repair, file systems</para>
445           <indexterm zone="ch-system-util-linux fsck">
446             <primary sortas="b-fsck">fsck</primary>
447           </indexterm>
448         </listitem>
449       </varlistentry>
451       <varlistentry id="fsck.cramfs">
452         <term><command>fsck.cramfs</command></term>
453         <listitem>
454           <para>Performs a consistency check on the Cramfs file system on the
455           given device</para>
456           <indexterm zone="ch-system-util-linux fsck.cramfs">
457             <primary sortas="b-fsck.cramfs">fsck.cramfs</primary>
458           </indexterm>
459         </listitem>
460       </varlistentry>
462       <varlistentry id="fsck.minix">
463         <term><command>fsck.minix</command></term>
464         <listitem>
465           <para>Performs a consistency check on the Minix file system on the
466           given device</para>
467           <indexterm zone="ch-system-util-linux fsck.minix">
468             <primary sortas="b-fsck.minix">fsck.minix</primary>
469           </indexterm>
470         </listitem>
471       </varlistentry>
473       <varlistentry id="fsfreeze">
474         <term><command>fsfreeze</command></term>
475         <listitem>
476           <para>Is a very simple wrapper around FIFREEZE/FITHAW ioctl
477           kernel driver operations</para>
478           <indexterm zone="ch-system-util-linux fsfreeze">
479             <primary sortas="b-fsfreeze">fsfreeze</primary>
480           </indexterm>
481         </listitem>
482       </varlistentry>
484       <varlistentry id="fstrim">
485         <term><command>fstrim</command></term>
486         <listitem>
487           <para>Discards unused blocks on a mounted filesystem</para>
488           <indexterm zone="ch-system-util-linux fstrim">
489             <primary sortas="b-fstrim">fstrim</primary>
490           </indexterm>
491         </listitem>
492       </varlistentry>
494       <varlistentry id="getopt">
495         <term><command>getopt</command></term>
496         <listitem>
497           <para>Parses options in the given command line</para>
498           <indexterm zone="ch-system-util-linux getopt">
499             <primary sortas="b-getopt">getopt</primary>
500           </indexterm>
501         </listitem>
502       </varlistentry>
504       <varlistentry id="hexdump">
505         <term><command>hexdump</command></term>
506         <listitem>
507           <para>Dumps the given file in hexadecimal or in another given
508           format</para>
509           <indexterm zone="ch-system-util-linux hexdump">
510             <primary sortas="b-hexdump">hexdump</primary>
511           </indexterm>
512         </listitem>
513       </varlistentry>
515       <varlistentry id="hwclock">
516         <term><command>hwclock</command></term>
517         <listitem>
518           <para>Reads or sets the system's hardware clock, also called
519           the Real-Time Clock (RTC) or Basic Input-Output System (BIOS)
520           clock</para>
521           <indexterm zone="ch-system-util-linux hwclock">
522             <primary sortas="b-hwclock">hwclock</primary>
523           </indexterm>
524         </listitem>
525       </varlistentry>
527       <varlistentry id="i386">
528         <term><command>i386</command></term>
529         <listitem>
530           <para>A symbolic link to setarch</para>
531           <indexterm zone="ch-system-util-linux i386">
532             <primary sortas="b-i386">i386</primary>
533           </indexterm>
534         </listitem>
535       </varlistentry>
537       <varlistentry id="ionice">
538         <term><command>ionice</command></term>
539         <listitem>
540           <para>Gets or sets the io scheduling class and priority for a program</para>
541           <indexterm zone="ch-system-util-linux ionice">
542             <primary sortas="b-ionice">ionice</primary>
543           </indexterm>
544         </listitem>
545       </varlistentry>
547       <varlistentry id="ipcmk">
548         <term><command>ipcmk</command></term>
549         <listitem>
550           <para>Creates various IPC resources</para>
551           <indexterm zone="ch-system-util-linux ipcmk">
552             <primary sortas="b-ipcmk">ipcmk</primary>
553           </indexterm>
554         </listitem>
555       </varlistentry>
557       <varlistentry id="ipcrm">
558         <term><command>ipcrm</command></term>
559         <listitem>
560           <para>Removes the given Inter-Process Communication (IPC) resource</para>
561           <indexterm zone="ch-system-util-linux ipcrm">
562             <primary sortas="b-ipcrm">ipcrm</primary>
563           </indexterm>
564         </listitem>
565       </varlistentry>
567       <varlistentry id="ipcs">
568         <term><command>ipcs</command></term>
569         <listitem>
570           <para>Provides IPC status information</para>
571           <indexterm zone="ch-system-util-linux ipcs">
572             <primary sortas="b-ipcs">ipcs</primary>
573           </indexterm>
574         </listitem>
575       </varlistentry>
577       <varlistentry id="isosize">
578         <term><command>isosize</command></term>
579         <listitem>
580           <para>Reports the size of an iso9660 file system</para>
581           <indexterm zone="ch-system-util-linux isosize">
582             <primary sortas="b-isosize">isosize</primary>
583           </indexterm>
584         </listitem>
585       </varlistentry>
587       <varlistentry id="kill">
588         <term><command>kill</command></term>
589         <listitem>
590           <para>Sends signals to processes</para>
591           <indexterm zone="ch-system-util-linux kill">
592             <primary sortas="b-kill">kill</primary>
593           </indexterm>
594         </listitem>
595       </varlistentry>
597       <varlistentry id="last">
598         <term><command>last</command></term>
599         <listitem>
600           <para>Shows which users last logged in (and out), searching back 
601           through the <filename>/var/log/wtmp</filename> file; it also shows 
602           system boots, shutdowns, and run-level changes</para>
603           <indexterm zone="ch-system-util-linux last">
604             <primary sortas="b-last">last</primary>
605           </indexterm>
606         </listitem>
607       </varlistentry>
609       <varlistentry id="lastb">
610         <term><command>lastb</command></term>
611         <listitem>
612           <para>Shows the failed login attempts, as logged in 
613           <filename>/var/log/btmp</filename></para>
614           <indexterm zone="ch-system-util-linux lastb">
615             <primary sortas="b-lastb">lastb</primary>
616           </indexterm>
617         </listitem>
618       </varlistentry>
620       <varlistentry id="ldattach">
621         <term><command>ldattach</command></term>
622         <listitem>
623           <para>Attaches a line discipline to a serial line</para>
624           <indexterm zone="ch-system-util-linux ldattach">
625             <primary sortas="b-ldattach">ldattach</primary>
626           </indexterm>
627         </listitem>
628       </varlistentry>
630       <varlistentry id="linux32">
631         <term><command>linux32</command></term>
632         <listitem>
633           <para>A symbolic link to setarch</para>
634           <indexterm zone="ch-system-util-linux linux32">
635             <primary sortas="b-linux32">linux32</primary>
636           </indexterm>
637         </listitem>
638       </varlistentry>
640       <varlistentry id="linux64">
641         <term><command>linux64</command></term>
642         <listitem>
643           <para>A symbolic link to setarch</para>
644           <indexterm zone="ch-system-util-linux linux64">
645             <primary sortas="b-linux64">linux64</primary>
646           </indexterm>
647         </listitem>
648       </varlistentry>
650       <varlistentry id="logger">
651         <term><command>logger</command></term>
652         <listitem>
653           <para>Enters the given message into the system log</para>
654           <indexterm zone="ch-system-util-linux logger">
655             <primary sortas="b-logger">logger</primary>
656           </indexterm>
657         </listitem>
658       </varlistentry>
660       <varlistentry id="look">
661         <term><command>look</command></term>
662         <listitem>
663           <para>Displays lines that begin with the given string</para>
664           <indexterm zone="ch-system-util-linux look">
665             <primary sortas="b-look">look</primary>
666           </indexterm>
667         </listitem>
668       </varlistentry>
670       <varlistentry id="losetup">
671         <term><command>losetup</command></term>
672         <listitem>
673           <para>Sets up and controls loop devices</para>
674           <indexterm zone="ch-system-util-linux losetup">
675             <primary sortas="b-losetup">losetup</primary>
676           </indexterm>
677         </listitem>
678       </varlistentry>
680       <varlistentry id="lsblk">
681         <term><command>lsblk</command></term>
682         <listitem>
683           <para>Lists information about all or selected block devices in
684            a tree-like format</para>
685           <indexterm zone="ch-system-util-linux lsblk">
686             <primary sortas="b-lsblk">lsblk</primary>
687           </indexterm>
688         </listitem>
689       </varlistentry>
691       <varlistentry id="lscpu">
692         <term><command>lscpu</command></term>
693         <listitem>
694           <para>Prints CPU architecture information</para>
695           <indexterm zone="ch-system-util-linux lscpu">
696             <primary sortas="b-lscpu">lscpu</primary>
697           </indexterm>
698         </listitem>
699       </varlistentry>
701       <varlistentry id="lsipc">
702         <term><command>lsipc</command></term>
703         <listitem>
704           <para>Prints information on IPC facilities currently employed
705           in the system</para>
706           <indexterm zone="ch-system-util-linux lsipc">
707             <primary sortas="b-lsipc">lsipc</primary>
708           </indexterm>
709         </listitem>
710       </varlistentry>
712       <varlistentry id="lslocks">
713         <term><command>lslocks</command></term>
714         <listitem>
715           <para>Lists local system locks</para>
716           <indexterm zone="ch-system-util-linux lslocks">
717             <primary sortas="b-lslocks">lslocks</primary>
718           </indexterm>
719         </listitem>
720       </varlistentry>
722       <varlistentry id="lslogins">
723         <term><command>lslogins</command></term>
724         <listitem>
725           <para>Lists information about users, groups and system accounts</para>
726           <indexterm zone="ch-system-util-linux lslogins">
727             <primary sortas="b-lslogins">lslogins</primary>
728           </indexterm>
729         </listitem>
730       </varlistentry>
732       <varlistentry id="lsmem">
733         <term><command>lsmem</command></term>
734         <listitem>
735           <para>Lists the ranges of available memory with their online
736           status</para>
737           <indexterm zone="ch-system-util-linux lsmem">
738             <primary sortas="b-lsmem">lsmem</primary>
739           </indexterm>
740         </listitem>
741       </varlistentry>
743       <varlistentry id="lsns">
744         <term><command>lsns</command></term>
745         <listitem>
746           <para>Lists namespaces</para>
747           <indexterm zone="ch-system-util-linux lsns">
748             <primary sortas="b-lsns">lsns</primary>
749           </indexterm>
750         </listitem>
751       </varlistentry>
753       <varlistentry id="mcookie">
754         <term><command>mcookie</command></term>
755         <listitem>
756           <para>Generates magic cookies (128-bit random hexadecimal numbers) for
757           <command>xauth</command></para>
758           <indexterm zone="ch-system-util-linux mcookie">
759             <primary sortas="b-mcookie">mcookie</primary>
760           </indexterm>
761         </listitem>
762       </varlistentry>
764       <varlistentry id="mesg">
765         <term><command>mesg</command></term>
766         <listitem>
767           <para>Controls whether other users can send messages to the current 
768           user's terminal</para>
769           <indexterm zone="ch-system-util-linux mesg">
770             <primary sortas="b-mesg">mesg</primary>
771           </indexterm>
772         </listitem>
773       </varlistentry>
775       <varlistentry id="mkfs">
776         <term><command>mkfs</command></term>
777         <listitem>
778           <para>Builds a file system on a device (usually a hard disk
779           partition)</para>
780           <indexterm zone="ch-system-util-linux mkfs">
781             <primary sortas="b-mkfs">mkfs</primary>
782           </indexterm>
783         </listitem>
784       </varlistentry>
786       <varlistentry id="mkfs.bfs">
787         <term><command>mkfs.bfs</command></term>
788         <listitem>
789           <para>Creates a Santa Cruz Operations (SCO) bfs file system</para>
790           <indexterm zone="ch-system-util-linux mkfs.bfs">
791             <primary sortas="b-mkfs.bfs">mkfs.bfs</primary>
792           </indexterm>
793         </listitem>
794       </varlistentry>
796       <varlistentry id="mkfs.cramfs">
797         <term><command>mkfs.cramfs</command></term>
798         <listitem>
799           <para>Creates a cramfs file system</para>
800           <indexterm zone="ch-system-util-linux mkfs.cramfs">
801             <primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary>
802           </indexterm>
803         </listitem>
804       </varlistentry>
806       <varlistentry id="mkfs.minix">
807         <term><command>mkfs.minix</command></term>
808         <listitem>
809           <para>Creates a Minix file system</para>
810           <indexterm zone="ch-system-util-linux mkfs.minix">
811             <primary sortas="b-mkfs.minix">mkfs.minix</primary>
812           </indexterm>
813         </listitem>
814       </varlistentry>
816       <varlistentry id="mkswap">
817         <term><command>mkswap</command></term>
818         <listitem>
819           <para>Initializes the given device or file to be used as a swap
820           area</para>
821           <indexterm zone="ch-system-util-linux mkswap">
822             <primary sortas="b-mkswap">mkswap</primary>
823           </indexterm>
824         </listitem>
825       </varlistentry>
827       <varlistentry id="more">
828         <term><command>more</command></term>
829         <listitem>
830           <para>A filter for paging through text one screen at a time</para>
831           <indexterm zone="ch-system-util-linux more">
832             <primary sortas="b-more">more</primary>
833           </indexterm>
834         </listitem>
835       </varlistentry>
837       <varlistentry id="mount">
838         <term><command>mount</command></term>
839         <listitem>
840           <para>Attaches the file system on the given device to a specified
841           directory in the file-system tree</para>
842           <indexterm zone="ch-system-util-linux mount">
843             <primary sortas="b-mount">mount</primary>
844           </indexterm>
845         </listitem>
846       </varlistentry>
848       <varlistentry id="mountpoint">
849         <term><command>mountpoint</command></term>
850         <listitem>
851           <para>Checks if the directory is a mountpoint</para>
852           <indexterm zone="ch-system-util-linux mountpoint">
853             <primary sortas="b-mountpoint">mountpoint</primary>
854           </indexterm>
855         </listitem>
856       </varlistentry>
858       <varlistentry id="namei">
859         <term><command>namei</command></term>
860         <listitem>
861           <para>Shows the symbolic links in the given pathnames</para>
862           <indexterm zone="ch-system-util-linux namei">
863             <primary sortas="b-namei">namei</primary>
864           </indexterm>
865         </listitem>
866       </varlistentry>
868       <varlistentry id="nsenter">
869         <term><command>nsenter</command></term>
870         <listitem>
871           <para>Runs a program with namespaces of other processes</para>
872           <indexterm zone="ch-system-util-linux nsenter">
873             <primary sortas="b-nsenter">nsenter</primary>
874           </indexterm>
875         </listitem>
876       </varlistentry>
878       <varlistentry id="partx">
879         <term><command>partx</command></term>
880         <listitem>
881           <para>Tells the kernel about the presence and numbering of on-disk
882           partitions</para>
883           <indexterm zone="ch-system-util-linux partx">
884             <primary sortas="b-partx">partx</primary>
885           </indexterm>
886         </listitem>
887       </varlistentry>
889       <varlistentry id="pivot_root">
890         <term><command>pivot_root</command></term>
891         <listitem>
892           <para>Makes the given file system the new root file system of the
893           current process</para>
894           <indexterm zone="ch-system-util-linux pivot_root">
895             <primary sortas="b-pivot_root">pivot_root</primary>
896           </indexterm>
897         </listitem>
898       </varlistentry>
900       <varlistentry id="prlimit">
901         <term><command>prlimit</command></term>
902         <listitem>
903           <para>Get and set a process' resource limits</para>
904           <indexterm zone="ch-system-util-linux prlimit">
905             <primary sortas="b-prlimit">prlimit</primary>
906           </indexterm>
907         </listitem>
908       </varlistentry>
910       <varlistentry id="raw">
911         <term><command>raw</command></term>
912         <listitem>
913           <para>Bind a Linux raw character device to a block device</para>
914           <indexterm zone="ch-system-util-linux raw">
915             <primary sortas="b-raw">raw</primary>
916           </indexterm>
917         </listitem>
918       </varlistentry>
920       <varlistentry id="readprofile">
921         <term><command>readprofile</command></term>
922         <listitem>
923           <para>Reads kernel profiling information</para>
924           <indexterm zone="ch-system-util-linux readprofile">
925             <primary sortas="b-readprofile">readprofile</primary>
926           </indexterm>
927         </listitem>
928       </varlistentry>
930       <varlistentry id="rename">
931         <term><command>rename</command></term>
932         <listitem>
933           <para>Renames the given files, replacing a given string with
934           another</para>
935           <indexterm zone="ch-system-util-linux rename">
936             <primary sortas="b-rename">rename</primary>
937           </indexterm>
938         </listitem>
939       </varlistentry>
941       <varlistentry id="renice">
942         <term><command>renice</command></term>
943         <listitem>
944           <para>Alters the priority of running processes</para>
945           <indexterm zone="ch-system-util-linux renice">
946             <primary sortas="b-renice">renice</primary>
947           </indexterm>
948         </listitem>
949       </varlistentry>
951       <varlistentry id="resizepart">
952         <term><command>resizepart</command></term>
953         <listitem>
954           <para>Asks the Linux kernel to resize a partition</para>
955           <indexterm zone="ch-system-util-linux resizepart">
956             <primary sortas="b-resizepart">resizepart</primary>
957           </indexterm>
958         </listitem>
959       </varlistentry>
961       <varlistentry id="rev">
962         <term><command>rev</command></term>
963         <listitem>
964           <para>Reverses the lines of a given file</para>
965           <indexterm zone="ch-system-util-linux rev">
966             <primary sortas="b-rev">rev</primary>
967           </indexterm>
968         </listitem>
969       </varlistentry>
971       <varlistentry id="rkfill">
972         <term><command>rkfill</command></term>
973         <listitem>
974           <para>Tool for enabling and disabling wireless devices</para>
975           <indexterm zone="ch-system-util-linux rkfill">
976             <primary sortas="b-rkfill">rkfill</primary>
977           </indexterm>
978         </listitem>
979       </varlistentry>
981       <varlistentry id="rtcwake">
982         <term><command>rtcwake</command></term>
983         <listitem>
984           <para>Used to enter a system sleep state until specified wakeup
985           time</para>
986           <indexterm zone="ch-system-util-linux rtcwake">
987             <primary sortas="b-rtcwake">rtcwake</primary>
988           </indexterm>
989         </listitem>
990       </varlistentry>
992       <varlistentry id="script">
993         <term><command>script</command></term>
994         <listitem>
995           <para>Makes a typescript of a terminal session</para>
996           <indexterm zone="ch-system-util-linux script">
997             <primary sortas="b-script">script</primary>
998           </indexterm>
999         </listitem>
1000       </varlistentry>
1002       <varlistentry id="scriptreplay">
1003         <term><command>scriptreplay</command></term>
1004         <listitem>
1005           <para>Plays back typescripts using timing information</para>
1006           <indexterm zone="ch-system-util-linux scriptreplay">
1007             <primary sortas="b-scriptreplay">scriptreplay</primary>
1008           </indexterm>
1009         </listitem>
1010       </varlistentry>
1012       <varlistentry id="setarch">
1013         <term><command>setarch</command></term>
1014         <listitem>
1015           <para>Changes reported architecture in a new program environment and
1016           sets personality flags</para>
1017           <indexterm zone="ch-system-util-linux setarch">
1018             <primary sortas="b-setarch">setarch</primary>
1019           </indexterm>
1020         </listitem>
1021       </varlistentry>
1023       <varlistentry id="setsid">
1024         <term><command>setsid</command></term>
1025         <listitem>
1026           <para>Runs the given program in a new session</para>
1027           <indexterm zone="ch-system-util-linux setsid">
1028             <primary sortas="b-setsid">setsid</primary>
1029           </indexterm>
1030         </listitem>
1031       </varlistentry>
1033       <varlistentry id="setterm">
1034         <term><command>setterm</command></term>
1035         <listitem>
1036           <para>Sets terminal attributes</para>
1037           <indexterm zone="ch-system-util-linux setterm">
1038             <primary sortas="b-setterm">setterm</primary>
1039           </indexterm>
1040         </listitem>
1041       </varlistentry>
1043       <varlistentry id="sfdisk">
1044         <term><command>sfdisk</command></term>
1045         <listitem>
1046           <para>A disk partition table manipulator</para>
1047           <indexterm zone="ch-system-util-linux sfdisk">
1048             <primary sortas="b-sfdisk">sfdisk</primary>
1049           </indexterm>
1050         </listitem>
1051       </varlistentry>
1053       <varlistentry id="sulogin">
1054         <term><command>sulogin</command></term>
1055         <listitem>
1056           <para>Allows <systemitem class="username">root</systemitem> to log in;
1057           it is normally invoked by <command>init</command> when the system goes
1058           into single user mode</para>
1059           <indexterm zone="ch-system-util-linux sulogin">
1060             <primary sortas="b-sulogin">sulogin</primary>
1061           </indexterm>
1062         </listitem>
1063       </varlistentry>
1065       <varlistentry id="swaplabel">
1066         <term><command>swaplabel</command></term>
1067         <listitem>
1068           <para>Allows to change swaparea UUID and label</para>
1069           <indexterm zone="ch-system-util-linux swaplabel">
1070             <primary sortas="b-swaplabel">swaplabel</primary>
1071           </indexterm>
1072         </listitem>
1073       </varlistentry>
1075       <varlistentry id="swapoff">
1076         <term><command>swapoff</command></term>
1077         <listitem>
1078           <para>Disables devices and files for paging and swapping</para>
1079           <indexterm zone="ch-system-util-linux swapoff">
1080             <primary sortas="b-swapoff">swapoff</primary>
1081           </indexterm>
1082         </listitem>
1083       </varlistentry>
1085       <varlistentry id="swapon">
1086         <term><command>swapon</command></term>
1087         <listitem>
1088           <para>Enables devices and files for paging and swapping and
1089           lists the devices and files currently in use</para>
1090           <indexterm zone="ch-system-util-linux swapon">
1091             <primary sortas="b-swapon">swapon</primary>
1092           </indexterm>
1093         </listitem>
1094       </varlistentry>
1096       <varlistentry id="switch_root">
1097         <term><command>switch_root</command></term>
1098         <listitem>
1099           <para>Switches to another filesystem as the root of the mount tree</para>
1100           <indexterm zone="ch-system-util-linux switch_root">
1101             <primary sortas="b-switch_root">switch_root</primary>
1102           </indexterm>
1103         </listitem>
1104       </varlistentry>
1106       <varlistentry id="tailf">
1107         <term><command>tailf</command></term>
1108         <listitem>
1109           <para>Tracks the growth of a log file; displays the last 10 lines
1110           of a log file, then continues displaying any new entries in the
1111           log file as they are created</para>
1112           <indexterm zone="ch-system-util-linux tailf">
1113             <primary sortas="b-tailf">tailf</primary>
1114           </indexterm>
1115         </listitem>
1116       </varlistentry>
1118       <varlistentry id="taskset">
1119         <term><command>taskset</command></term>
1120         <listitem>
1121           <para>Retrieves or sets a process' CPU affinity</para>
1122           <indexterm zone="ch-system-util-linux taskset">
1123             <primary sortas="b-taskset">taskset</primary>
1124           </indexterm>
1125         </listitem>
1126       </varlistentry>
1128       <varlistentry id="ul">
1129         <term><command>ul</command></term>
1130         <listitem>
1131           <para>A filter for translating underscores into escape sequences
1132           indicating underlining for the terminal in use</para>
1133           <indexterm zone="ch-system-util-linux ul">
1134             <primary sortas="b-ul">ul</primary>
1135           </indexterm>
1136         </listitem>
1137       </varlistentry>
1139       <varlistentry id="umount">
1140         <term><command>umount</command></term>
1141         <listitem>
1142           <para>Disconnects a file system from the system's file tree</para>
1143           <indexterm zone="ch-system-util-linux umount">
1144             <primary sortas="b-umount">umount</primary>
1145           </indexterm>
1146         </listitem>
1147       </varlistentry>
1149       <varlistentry id="uname26">
1150         <term><command>uname26</command></term>
1151         <listitem>
1152           <para>A symbolic link to setarch</para>
1153           <indexterm zone="ch-system-util-linux uname26">
1154             <primary sortas="b-uname26">uname26</primary>
1155           </indexterm>
1156         </listitem>
1157       </varlistentry>
1159       <varlistentry id="unshare">
1160         <term><command>unshare</command></term>
1161         <listitem>
1162           <para>Runs a program with some namespaces unshared from parent</para>
1163           <indexterm zone="ch-system-util-linux unshare">
1164             <primary sortas="b-unshare">unshare</primary>
1165           </indexterm>
1166         </listitem>
1167       </varlistentry>
1169       <varlistentry id="utmpdump">
1170         <term><command>utmpdump</command></term>
1171         <listitem>
1172           <para>Displays the content of the given login file in a more
1173           user-friendly format</para>
1174           <indexterm zone="ch-system-util-linux utmpdump">
1175             <primary sortas="b-utmpdump">utmpdump</primary>
1176           </indexterm>
1177         </listitem>
1178       </varlistentry>
1180       <varlistentry id="uuidd">
1181         <term><command>uuidd</command></term>
1182         <listitem>
1183           <para>A daemon used by the UUID library to generate time-based
1184           UUIDs in a secure and guaranteed-unique fashion</para>
1185           <indexterm zone="ch-system-util-linux uuidd">
1186             <primary sortas="b-uuidd">uuidd</primary>
1187           </indexterm>
1188         </listitem>
1189       </varlistentry>
1191       <varlistentry id="uuidgen">
1192         <term><command>uuidgen</command></term>
1193         <listitem>
1194           <para>Creates new UUIDs. Each new UUID can reasonably be considered
1195           unique among all UUIDs created, on the local system and on other
1196           systems, in the past and in the future</para>
1197           <indexterm zone="ch-system-util-linux uuidgen">
1198             <primary sortas="b-uuidgen">uuidgen</primary>
1199           </indexterm>
1200         </listitem>
1201       </varlistentry>
1203       <varlistentry id="uuidparse">
1204         <term><command>uuidparse</command></term>
1205         <listitem>
1206           <para>An utility to parse unique identifiers</para>
1207           <indexterm zone="ch-system-util-linux uuidparse">
1208             <primary sortas="b-uuidparse">uuidparse</primary>
1209           </indexterm>
1210         </listitem>
1211       </varlistentry>
1213       <varlistentry id="wall">
1214         <term><command>wall</command></term>
1215         <listitem>
1216           <para>Displays the contents of a file or, by default, its standard
1217           input, on the terminals of all currently logged in users</para>
1218           <indexterm zone="ch-system-util-linux wall">
1219             <primary sortas="b-wall">wall</primary>
1220           </indexterm>
1221         </listitem>
1222       </varlistentry>
1224       <varlistentry id="wdctl">
1225         <term><command>wdctl</command></term>
1226         <listitem>
1227           <para>Shows hardware watchdog status</para>
1228           <indexterm zone="ch-system-util-linux wdctl">
1229             <primary sortas="b-wdctl">wdctl</primary>
1230           </indexterm>
1231         </listitem>
1232       </varlistentry>
1234       <varlistentry id="whereis">
1235         <term><command>whereis</command></term>
1236         <listitem>
1237           <para>Reports the location of the binary, source, and man page
1238           for the given command</para>
1239           <indexterm zone="ch-system-util-linux whereis">
1240             <primary sortas="b-whereis">whereis</primary>
1241           </indexterm>
1242         </listitem>
1243       </varlistentry>
1245       <varlistentry id="wipefs">
1246         <term><command>wipefs</command></term>
1247         <listitem>
1248           <para>Wipes a filesystem signature from a device</para>
1249           <indexterm zone="ch-system-util-linux wipefs">
1250             <primary sortas="b-wipefs">wipefs</primary>
1251           </indexterm>
1252         </listitem>
1253       </varlistentry>
1255       <varlistentry id="x86_64">
1256         <term><command>x86_64</command></term>
1257         <listitem>
1258           <para>A symbolic link to setarch</para>
1259           <indexterm zone="ch-system-util-linux x86_64">
1260             <primary sortas="b-x86_64">x86_64</primary>
1261           </indexterm>
1262         </listitem>
1263       </varlistentry>
1265       <varlistentry id="zramctl">
1266         <term><command>zramctl</command></term>
1267         <listitem>
1268           <para>A program to set up and control zram (compressed ram disk) 
1269           devices</para>
1270           <indexterm zone="ch-system-util-linux zramctl">
1271             <primary sortas="b-zramctl">zramctl</primary>
1272           </indexterm>
1273         </listitem>
1274       </varlistentry>
1276       <varlistentry id="libblkid">
1277         <term><filename class="libraryfile">libblkid</filename></term>
1278         <listitem>
1279           <para>Contains routines for device identification and token
1280           extraction</para>
1281           <indexterm zone="ch-system-util-linux libblkid">
1282             <primary sortas="c-libblkid">libblkid</primary>
1283           </indexterm>
1284         </listitem>
1285       </varlistentry>
1287       <varlistentry id="libfdisk">
1288         <term><filename class="libraryfile">libfdisk</filename></term>
1289         <listitem>
1290           <para>Contains routines for manipulating partition tables</para>
1291           <indexterm zone="ch-system-util-linux libfdisk">
1292             <primary sortas="c-libfdisk">libfdisk</primary>
1293           </indexterm>
1294         </listitem>
1295       </varlistentry>
1297       <varlistentry id="libmount">
1298         <term><filename class="libraryfile">libmount</filename></term>
1299         <listitem>
1300           <para>Contains routines for block device mounting and
1301           unmounting</para>
1302           <indexterm zone="ch-system-util-linux libmount">
1303             <primary sortas="c-libmount">libmount</primary>
1304           </indexterm>
1305         </listitem>
1306       </varlistentry>
1308       <varlistentry id="libsmartcols">
1309         <term><filename class="libraryfile">libsmartcols</filename></term>
1310         <listitem>
1311           <para>Contains routines for aiding screen output in tabular form</para>
1312           <indexterm zone="ch-system-util-linux libsmartcols">
1313             <primary sortas="c-libsmartcols">libsmartcols</primary>
1314           </indexterm>
1315         </listitem>
1316       </varlistentry>
1318       <varlistentry id="libuuid">
1319         <term><filename class="libraryfile">libuuid</filename></term>
1320         <listitem>
1321           <para>Contains routines for generating unique identifiers for objects
1322           that may be accessible beyond the local system</para>
1323           <indexterm zone="ch-system-util-linux libuuid">
1324             <primary sortas="c-libuuid">libuuid</primary>
1325           </indexterm>
1326         </listitem>
1327       </varlistentry>
1329     </variablelist>
1331   </sect2>
1333 </sect1>