Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r686839b r9fedd70f  
    3333    <command>hwclock</command> program FHS-compliant, run the following:</para>
    3434
    35 <screen><userinput>sed -i -e 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
    36     $(grep -rl '/etc/adjtime' .)
     35<screen><userinput>sed -i 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
     36    hwclock/hwclock.c
    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-write</userinput></screen>
     46<screen os="b"><userinput>./configure --enable-arch \
     47    --enable-partx --enable-write --disable-wall</userinput></screen>
    4748
    4849    <variablelist os="c">
    … …  
    5051
    5152      <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>
    5269        <term><parameter>--enable-write</parameter></term>
    5370        <listitem>
    … …  
    5774      </varlistentry>
    5875
     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
    5984    </variablelist>
    6085
    … …  
    6388<screen os="e"><userinput>make</userinput></screen>
    6489
    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
    68 echo "dummy2:x:1001:dummy" &gt;&gt; /etc/group
    69 echo "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;
    74 su dummy -s /bin/bash -c "PATH=$PATH make -k check"</userinput></screen>
     90    <para os="f">This package does not come with a test suite.</para>
    7591
    7692    <para os="g">Install the package:</para>
    … …  
    95111
    96112      <seglistitem>
    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>
     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>
    112126      </seglistitem>
    113127    </segmentedlist>
    … …  
    139153      </varlistentry>
    140154
    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>
     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>
    147161          </indexterm>
    148162        </listitem>
    … …  
    191205      </varlistentry>
    192206
    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>
     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>
    199213          </indexterm>
    200214        </listitem>
    … …  
    305319      </varlistentry>
    306320
    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 
    327321      <varlistentry id="fdformat">
    328322        <term><command>fdformat</command></term>
    … …  
    356350      </varlistentry>
    357351
    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 
    368352      <varlistentry id="flock">
    369353        <term><command>flock</command></term>
    … …  
    405389          <indexterm zone="ch-system-util-linux fsck.minix">
    406390            <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>
    427391          </indexterm>
    428392        </listitem>
    … …  
    512476      </varlistentry>
    513477
    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 
    547478      <varlistentry id="ldattach">
    548479        <term><command>ldattach</command></term>
    … …  
    555486      </varlistentry>
    556487
     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
    557498      <varlistentry id="logger">
    558499        <term><command>logger</command></term>
    … …  
    585526      </varlistentry>
    586527
    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 
    597528      <varlistentry id="lscpu">
    598529        <term><command>lscpu</command></term>
    … …  
    601532          <indexterm zone="ch-system-util-linux lscpu">
    602533            <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>
    613534          </indexterm>
    614535        </listitem>
    … …  
    626547      </varlistentry>
    627548
    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 
    639549      <varlistentry id="mkfs">
    640550        <term><command>mkfs</command></term>
    … …  
    710620      </varlistentry>
    711621
    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 
    722622      <varlistentry id="namei">
    723623        <term><command>namei</command></term>
    … …  
    726626          <indexterm zone="ch-system-util-linux namei">
    727627            <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>
    750628          </indexterm>
    751629        </listitem>
    … …  
    784662      </varlistentry>
    785663
    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 
    806664      <varlistentry id="readprofile">
    807665        <term><command>readprofile</command></term>
    … …  
    835693      </varlistentry>
    836694
    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 
    847695      <varlistentry id="rev">
    848696        <term><command>rev</command></term>
    … …  
    922770          <indexterm zone="ch-system-util-linux sfdisk">
    923771            <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>
    946772          </indexterm>
    947773        </listitem>
    … …  
    1001827      </varlistentry>
    1002828
     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
    1003839      <varlistentry id="ul">
    1004840        <term><command>ul</command></term>
    … …  
    1018854          <indexterm zone="ch-system-util-linux umount">
    1019855            <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>
    1041856          </indexterm>
    1042857        </listitem>
    … …  
    1066881      </varlistentry>
    1067882
    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 
    1088883      <varlistentry id="whereis">
    1089884        <term><command>whereis</command></term>
    … …  
    1097892      </varlistentry>
    1098893
    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 
    1109894      <varlistentry id="write">
    1110895        <term><command>write</command></term>
    … …  
    1129914      </varlistentry>
    1130915
    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 
    1145916      <varlistentry id="libuuid">
    1146917        <term><filename class="libraryfile">libuuid</filename></term>
Note: See TracChangeset for help on using the changeset viewer.