chapter06/util-linux.xml

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