Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • BOOK/final-system/common/util-linux.xml

    r9fedd70f r686839b  
    3333    <command>hwclock</command> program FHS-compliant, run the following:</para>
    3434
    35 <screen><userinput>sed -i 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
    36     hwclock/hwclock.c
     35<screen><userinput>sed -i -e 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
     36    $(grep -rl '/etc/adjtime' .)
    3737mkdir -pv /var/lib/hwclock</userinput></screen>
    3838
    … …  
    4444    <para os="a">Prepare Util-linux for compilation:</para>
    4545
    46 <screen os="b"><userinput>./configure --enable-arch \
    47     --enable-partx --enable-write --disable-wall</userinput></screen>
     46<screen os="b"><userinput>./configure --enable-write</userinput></screen>
    4847
    4948    <variablelist os="c">
    … …  
    5150
    5251      <varlistentry>
    53         <term><parameter>--enable-arch</parameter></term>
    54         <listitem>
    55           <para>This option allows the <command>arch</command> program to be
    56           installed.</para>
    57         </listitem>
    58       </varlistentry>
    59 
    60       <varlistentry>
    61         <term><parameter>--enable-partx</parameter></term>
    62         <listitem>
    63           <para>Enables building the <command>addpart</command>, <command>delpart</command>,
    64            <command>partx</command> programs.</para>
    65         </listitem>
    66       </varlistentry>
    67 
    68       <varlistentry>
    6952        <term><parameter>--enable-write</parameter></term>
    7053        <listitem>
    … …  
    7457      </varlistentry>
    7558
    76       <varlistentry>
    77         <term><parameter>--disable-wall</parameter></term>
    78         <listitem>
    79           <para>Disables building the <command>wall</command> program,
    80           as the Sysvinit package installs its own version.</para>
    81         </listitem>
    82       </varlistentry>
    83 
    8459    </variablelist>
    8560
    … …  
    8863<screen os="e"><userinput>make</userinput></screen>
    8964
    90     <para os="f">This package does not come with a test suite.</para>
     65    <para os="dummy1">Create two <systemitem class="groupname">dummy</systemitem> groups and a <systemitem class="username">dummy</systemitem> user to be used during Util-linux and Coreutils test suites:</para>
     66
     67<screen os="dummy2"><userinput remap="test">echo "dummy1:x:1000:" &gt;&gt; /etc/group
     68echo "dummy2:x:1001:dummy" &gt;&gt; /etc/group
     69echo "dummy:x:1000:1000::/root:/bin/bash" &gt;&gt; /etc/passwd</userinput></screen>
     70
     71    <para os="f">To test the results, issue:</para>
     72
     73<screen os="f2"><userinput remap="test">chown -Rv dummy . &amp;&amp;
     74su dummy -s /bin/bash -c "PATH=$PATH make -k check"</userinput></screen>
    9175
    9276    <para os="g">Install the package:</para>
    … …  
    11195
    11296      <seglistitem>
    113         <seg>addpart, agetty, arch, blkid, blockdev, cal, cfdisk, chkdupexe,
    114         chrt, col, colcrt, colrm, column, ctrlaltdel, cytune, ddate, delpart,
    115         dmesg, fdformat, fdisk, findfs, flock, fsck, fsck.cramfs, fsck.minix,
    116         getopt, hexdump, hwclock, ionice, ipcmk, ipcrm, ipcs, isosize,
    117         ldattach, line, logger, look, losetup, lscpu, mcookie, mkfs, mkfs.bfs,
    118         mkfs.cramfs, mkfs.minix, mkswap, more, mount, namei, partx, pg,
    119         pivot_root, readprofile, rename, renice, rev, rtcwake, script,
    120         scriptreplay, setarch, setsid, setterm, sfdisk, swapoff (link to
    121         swapon), swapon, switch_root, tailf, taskset, tunelp, ul, umount,
    122         uuidd, uuidgen, whereis, and write</seg>
    123         <seg>libblkid.[a,so] and libuuid.[a,so]</seg>
    124         <seg>/usr/include/blkid, /usr/include/uuid, /usr/share/getopt,
    125         /var/lib/hwclock</seg>
     97        <seg>addpart, agetty, blkdiscard, blkid, blockdev, cal, cfdisk, chcpu,
     98        chrt, col, colcrt, colrm, column, ctrlaltdel, cytune, delpart,
     99        dmesg, eject, fallocate, fdformat, fdisk, findfs, findmnt, flock,
     100        fsck, fsck.cramfs, fsck.minix, fsfreeze, fstrim, getopt, hexdump,
     101        hwclock, ionice, ipcmk, ipcrm, ipcs, isosize, kill, last, lastb (link
     102        to last), ldattach, logger, look, losetup, lsblk, lscpu, lslocks,
     103        mcookie, mesg, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap, more,
     104        mount, mountpoint,  namei, nologin, nsenter, partx, pg, pivot_root, prlimit,
     105        raw, readprofile, rename, renice, resizepart, rev, rtcwake, script,
     106        scriptreplay, setarch, setsid, setterm, sfdisk, sulogin, swaplabel,
     107        swapoff, swapon, switch_root, tailf, taskset, ul, umount, unshare,
     108        utmpdump, uuidd, uuidgen, wall, wdctl, whereis, wipefs, and write</seg>
     109        <seg>libblkid.[a,so], libmount.[a,so], and libuuid.[a,so]</seg>
     110        <seg>/usr/include/blkid, /usr/include/libmount, /usr/include/uuid,
     111        /usr/share/doc/util-linux/getopt, /var/lib/hwclock</seg>
    126112      </seglistitem>
    127113    </segmentedlist>
    … …  
    153139      </varlistentry>
    154140
    155       <varlistentry id="arch">
    156         <term><command>arch</command></term>
    157         <listitem>
    158           <para>Reports the machine's architecture</para>
    159           <indexterm zone="ch-system-util-linux arch">
    160             <primary sortas="b-arch">arch</primary>
     141      <varlistentry id="blkdiscard">
     142        <term><command>blkdiscard</command></term>
     143        <listitem>
     144          <para>Discards sectors on a device</para>
     145          <indexterm zone="ch-system-util-linux blkdiscard">
     146            <primary sortas="b-blkdiscard">blkdiscard</primary>
    161147          </indexterm>
    162148        </listitem>
    … …  
    205191      </varlistentry>
    206192
    207       <varlistentry id="chkdupexe">
    208         <term><command>chkdupexe</command></term>
    209         <listitem>
    210           <para>Finds duplicate executables</para>
    211           <indexterm zone="ch-system-util-linux chkdupexe">
    212             <primary sortas="b-chkdupexe">chkdupexe</primary>
     193      <varlistentry id="chcpu">
     194        <term><command>chcpu</command></term>
     195        <listitem>
     196          <para>Utility to configure CPUs</para>
     197          <indexterm zone="ch-system-util-linux chcpu">
     198            <primary sortas="b-chcpu">chcpu</primary>
    213199          </indexterm>
    214200        </listitem>
    … …  
    319305      </varlistentry>
    320306
     307      <varlistentry id="eject">
     308        <term><command>eject</command></term>
     309        <listitem>
     310          <para>Eject removable media</para>
     311          <indexterm zone="ch-system-util-linux eject">
     312            <primary sortas="b-dmesg">eject</primary>
     313          </indexterm>
     314        </listitem>
     315      </varlistentry>
     316
     317      <varlistentry id="fallocate">
     318        <term><command>fallocate</command></term>
     319        <listitem>
     320          <para>Preallocates space to a file</para>
     321          <indexterm zone="ch-system-util-linux fallocate">
     322            <primary sortas="b-fallocate">fallocate</primary>
     323          </indexterm>
     324        </listitem>
     325      </varlistentry>
     326
    321327      <varlistentry id="fdformat">
    322328        <term><command>fdformat</command></term>
    … …  
    350356      </varlistentry>
    351357
     358      <varlistentry id="findmnt">
     359        <term><command>findmnt</command></term>
     360        <listitem>
     361          <para>Lists mounted filesystems or searches for a filesystem</para>
     362          <indexterm zone="ch-system-util-linux findmnt">
     363            <primary sortas="b-findmnt">findmnt</primary>
     364          </indexterm>
     365        </listitem>
     366      </varlistentry>
     367
    352368      <varlistentry id="flock">
    353369        <term><command>flock</command></term>
    … …  
    389405          <indexterm zone="ch-system-util-linux fsck.minix">
    390406            <primary sortas="b-fsck.minix">fsck.minix</primary>
     407          </indexterm>
     408        </listitem>
     409      </varlistentry>
     410
     411      <varlistentry id="fsfreeze">
     412        <term><command>fsfreeze</command></term>
     413        <listitem>
     414          <para>Suspends and resumes access to a filesystem</para>
     415          <indexterm zone="ch-system-util-linux fsfreeze">
     416            <primary sortas="b-fsfreeze">fsfreeze</primary>
     417          </indexterm>
     418        </listitem>
     419      </varlistentry>
     420
     421      <varlistentry id="fstrim">
     422        <term><command>fstrim</command></term>
     423        <listitem>
     424          <para>Discards unused blocks on a mounted filesystem</para>
     425          <indexterm zone="ch-system-util-linux fstrim">
     426            <primary sortas="b-fstrim">fstrim</primary>
    391427          </indexterm>
    392428        </listitem>
    … …  
    476512      </varlistentry>
    477513
     514      <varlistentry id="kill">
     515        <term><command>kill</command></term>
     516        <listitem>
     517          <para>Send a signal to a process</para>
     518          <indexterm zone="ch-system-util-linux kill">
     519            <primary sortas="b-kill">kill</primary>
     520          </indexterm>
     521        </listitem>
     522      </varlistentry>
     523
     524      <varlistentry id="last">
     525        <term><command>last</command></term>
     526        <listitem>
     527          <para>Shows which users last logged in (and out), searching back
     528          through the <filename>/var/log/wtmp</filename> file; it also shows
     529          system boots, shutdowns, and run-level changes</para>
     530          <indexterm zone="ch-system-util-linux last">
     531            <primary sortas="b-last">last</primary>
     532          </indexterm>
     533        </listitem>
     534      </varlistentry>
     535
     536      <varlistentry id="lastb">
     537        <term><command>lastb</command></term>
     538        <listitem>
     539          <para>Shows the failed login attempts, as logged in
     540          <filename>/var/log/btmp</filename></para>
     541          <indexterm zone="ch-system-util-linux lastb">
     542            <primary sortas="b-lastb">lastb</primary>
     543          </indexterm>
     544        </listitem>
     545      </varlistentry>
     546
    478547      <varlistentry id="ldattach">
    479548        <term><command>ldattach</command></term>
    … …  
    486555      </varlistentry>
    487556
    488       <varlistentry id="line">
    489         <term><command>line</command></term>
    490         <listitem>
    491           <para>Copies a single line</para>
    492           <indexterm zone="ch-system-util-linux line">
    493             <primary sortas="b-line">line</primary>
    494           </indexterm>
    495         </listitem>
    496       </varlistentry>
    497 
    498557      <varlistentry id="logger">
    499558        <term><command>logger</command></term>
    … …  
    526585      </varlistentry>
    527586
     587      <varlistentry id="lsblk">
     588        <term><command>lsblk</command></term>
     589        <listitem>
     590          <para>Prints information about block devices</para>
     591          <indexterm zone="ch-system-util-linux lsblk">
     592            <primary sortas="b-lsblk">lsblk</primary>
     593          </indexterm>
     594        </listitem>
     595      </varlistentry>
     596
    528597      <varlistentry id="lscpu">
    529598        <term><command>lscpu</command></term>
    … …  
    532601          <indexterm zone="ch-system-util-linux lscpu">
    533602            <primary sortas="b-lscpu">lscpu</primary>
     603          </indexterm>
     604        </listitem>
     605      </varlistentry>
     606
     607      <varlistentry id="lslocks">
     608        <term><command>lslocks</command></term>
     609        <listitem>
     610          <para>Lists local system locks</para>
     611          <indexterm zone="ch-system-util-linux lslocks">
     612            <primary sortas="b-lslocks">lslocks</primary>
    534613          </indexterm>
    535614        </listitem>
    … …  
    547626      </varlistentry>
    548627
     628      <varlistentry id="mesg">
     629        <term><command>mesg</command></term>
     630        <listitem>
     631          <para>Controls whether other users can send messages to the current
     632          user's terminal</para>
     633          <indexterm zone="ch-system-util-linux mesg">
     634            <primary sortas="b-mesg">mesg</primary>
     635          </indexterm>
     636        </listitem>
     637      </varlistentry>
     638
    549639      <varlistentry id="mkfs">
    550640        <term><command>mkfs</command></term>
    … …  
    620710      </varlistentry>
    621711
     712      <varlistentry id="mountpoint">
     713        <term><command>mountpoint</command></term>
     714        <listitem>
     715          <para>Tells you whether or not a directory is a mount point.</para>
     716          <indexterm zone="ch-system-util-linux mountpoint">
     717            <primary sortas="b-mountpoint">mountpoint</primary>
     718          </indexterm>
     719        </listitem>
     720      </varlistentry>
     721
    622722      <varlistentry id="namei">
    623723        <term><command>namei</command></term>
    … …  
    626726          <indexterm zone="ch-system-util-linux namei">
    627727            <primary sortas="b-namei">namei</primary>
     728          </indexterm>
     729        </listitem>
     730      </varlistentry>
     731
     732      <varlistentry id="nologin">
     733        <term><command>nologin</command></term>
     734        <listitem>
     735          <para>Displays a message that an account is not available. Designed
     736          to be used as the default shell for accounts that have been
     737          disabled</para>
     738          <indexterm zone="ch-system-util-linux nologin">
     739            <primary sortas="b-nologin">nologin</primary>
     740          </indexterm>
     741        </listitem>
     742      </varlistentry>
     743
     744      <varlistentry id="nsenter">
     745        <term><command>nsenter</command></term>
     746        <listitem>
     747          <para>Runs a program with namespaces of other processes</para>
     748          <indexterm zone="ch-system-util-linux nsenter">
     749            <primary sortas="b-nsenter">nsenter</primary>
    628750          </indexterm>
    629751        </listitem>
    … …  
    662784      </varlistentry>
    663785
     786      <varlistentry id="prlimit">
     787        <term><command>prlimit</command></term>
     788        <listitem>
     789          <para>Gets and sets a process' resource limits</para>
     790          <indexterm zone="ch-system-util-linux prlimit">
     791            <primary sortas="b-prlimit">prlimit</primary>
     792          </indexterm>
     793        </listitem>
     794      </varlistentry>
     795
     796      <varlistentry id="raw">
     797        <term><command>raw</command></term>
     798        <listitem>
     799          <para>Binds a Linux raw character device to a block device</para>
     800          <indexterm zone="ch-system-util-linux raw">
     801            <primary sortas="b-raw">raw</primary>
     802          </indexterm>
     803        </listitem>
     804      </varlistentry>
     805
    664806      <varlistentry id="readprofile">
    665807        <term><command>readprofile</command></term>
    … …  
    693835      </varlistentry>
    694836
     837      <varlistentry id="resizepart">
     838        <term><command>resizepart</command></term>
     839        <listitem>
     840          <para>Asks the Linux kernel to resize a partition</para>
     841          <indexterm zone="ch-system-util-linux resizepart">
     842            <primary sortas="b-resizepart">resizepart</primary>
     843          </indexterm>
     844        </listitem>
     845      </varlistentry>
     846
    695847      <varlistentry id="rev">
    696848        <term><command>rev</command></term>
    … …  
    770922          <indexterm zone="ch-system-util-linux sfdisk">
    771923            <primary sortas="b-sfdisk">sfdisk</primary>
     924          </indexterm>
     925        </listitem>
     926      </varlistentry>
     927
     928      <varlistentry id="sulogin">
     929        <term><command>sulogin</command></term>
     930        <listitem>
     931          <para>Allows <emphasis>root</emphasis> to log in; it is normally
     932          invoked by <command>init</command> when the system goes into single
     933          user mode</para>
     934          <indexterm zone="ch-system-util-linux sulogin">
     935            <primary sortas="b-sulogin">sulogin</primary>
     936          </indexterm>
     937        </listitem>
     938      </varlistentry>
     939
     940      <varlistentry id="swaplabel">
     941        <term><command>swaplabel</command></term>
     942        <listitem>
     943          <para>Prints or changes the label or UUID of a swap area</para>
     944          <indexterm zone="ch-system-util-linux swaplabel">
     945            <primary sortas="b-swaplabel">swaplabel</primary>
    772946          </indexterm>
    773947        </listitem>
    … …  
    8271001      </varlistentry>
    8281002
    829       <varlistentry id="tunelp">
    830         <term><command>tunelp</command></term>
    831         <listitem>
    832           <para>Tunes the parameters of the line printer</para>
    833           <indexterm zone="ch-system-util-linux tunelp">
    834             <primary sortas="b-tunelp">tunelp</primary>
    835           </indexterm>
    836         </listitem>
    837       </varlistentry>
    838 
    8391003      <varlistentry id="ul">
    8401004        <term><command>ul</command></term>
    … …  
    8541018          <indexterm zone="ch-system-util-linux umount">
    8551019            <primary sortas="b-umount">umount</primary>
     1020          </indexterm>
     1021        </listitem>
     1022      </varlistentry>
     1023
     1024      <varlistentry id="unshare">
     1025        <term><command>unshare</command></term>
     1026        <listitem>
     1027          <para>Runs a program with some namespaces unshared from parent</para>
     1028          <indexterm zone="ch-system-util-linux unshare">
     1029            <primary sortas="b-unshare">unshare</primary>
     1030          </indexterm>
     1031        </listitem>
     1032      </varlistentry>
     1033
     1034      <varlistentry id="utmpdump">
     1035        <term><command>utmpdump</command></term>
     1036        <listitem>
     1037          <para>Displays the content of the given login file in a more
     1038          user-friendly format</para>
     1039          <indexterm zone="ch-system-util-linux utmpdump">
     1040            <primary sortas="b-utmpdump">utmpdump</primary>
    8561041          </indexterm>
    8571042        </listitem>
    … …  
    8811066      </varlistentry>
    8821067
     1068      <varlistentry id="wall">
     1069        <term><command>wall</command></term>
     1070        <listitem>
     1071          <para>Writes a message to all logged-in users</para>
     1072          <indexterm zone="ch-system-util-linux wall">
     1073            <primary sortas="b-wall">wall</primary>
     1074          </indexterm>
     1075        </listitem>
     1076      </varlistentry>
     1077
     1078      <varlistentry id="wdctl">
     1079        <term><command>wdctl</command></term>
     1080        <listitem>
     1081          <para>Show hardware watchdog status</para>
     1082          <indexterm zone="ch-system-util-linux wdctl">
     1083            <primary sortas="b-uuidgen">wdctl</primary>
     1084          </indexterm>
     1085        </listitem>
     1086      </varlistentry>
     1087
    8831088      <varlistentry id="whereis">
    8841089        <term><command>whereis</command></term>
    … …  
    8921097      </varlistentry>
    8931098
     1099      <varlistentry id="wipefs">
     1100        <term><command>wipefs</command></term>
     1101        <listitem>
     1102          <para>Wipes a filesystem signature from a device</para>
     1103          <indexterm zone="ch-system-util-linux wipefs">
     1104            <primary sortas="b-wipefs">wipefs</primary>
     1105          </indexterm>
     1106        </listitem>
     1107      </varlistentry>
     1108
    8941109      <varlistentry id="write">
    8951110        <term><command>write</command></term>
    … …  
    9141129      </varlistentry>
    9151130
     1131      <varlistentry id="libmount">
     1132        <term><filename class="libraryfile">libmount</filename></term>
     1133        <listitem>
     1134          <para>Contains routines for parsing the
     1135          <filename>/etc/fstab</filename>, <filename>/etc/mtab</filename>,
     1136          and <filename>/proc/self/mountinfo</filename> files, managing
     1137          <filename>/etc/mtab</filename>, and configuring various mount
     1138          options</para>
     1139          <indexterm zone="ch-system-util-linux libmount">
     1140            <primary sortas="c-libmount">libmount</primary>
     1141          </indexterm>
     1142        </listitem>
     1143      </varlistentry>
     1144
    9161145      <varlistentry id="libuuid">
    9171146        <term><filename class="libraryfile">libuuid</filename></term>
Note: See TracChangeset for help on using the changeset viewer.