Ignore:
Timestamp:
Dec 18, 2013, 1:04:00 AM (12 years ago)
Author:
Chris Staub <chris@…>
Children:
f975b3a
Parents:
1c9985f (diff), 8abef998 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.
Message:

Updated simp branch to match main book

Location:
BOOK/final-system/common
Files:
2 added
2 deleted
43 edited
4 moved

Legend:

Unmodified
Added
Removed
  • BOOK/final-system/common/autoconf.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">To test the results, issue:
    37     <userinput>make check VERBOSE=yes</userinput>. 17 tests are skipped that use
    38     Automake and different GCC languages. For full test coverage, Autoconf can
    39     be re-tested after Automake has been installed.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check VERBOSE=yes</userinput></screen>
     39   
     40    <para os="e3">17 tests are skipped that use Automake and different GCC languages.
     41    For full test coverage, Autoconf can be re-tested after Automake has been
     42    installed.</para>
    4043
    4144    <para os="f">Install the package:</para>
  • BOOK/final-system/common/automake.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">To test the results, issue:
    37     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3839
    3940    <para os="f">Install the package:</para>
  • BOOK/final-system/common/binutils.xml

    r1c9985f r026bb5d  
    4040    needs to be resolved before running the test suites for Binutils and GCC.</para>
    4141
     42<!-- Branch update patch area
     43    <para os="p1">The following patch contains a number of updates to the
     44    &binutils-version; branch by the Binutils developers:</para>
     45
     46    <screen os="p2"><userinput>patch -Np1 -i ../&binutils-branch_update-patch;</userinput></screen>
     47-->
     48
    4249    <para os="g">The Binutils documentation recommends building Binutils outside of the
    4350    source directory in a dedicated build directory:</para>
     
    5057<screen os="ca"><userinput>CC="gcc -isystem /usr/include" \
    5158LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
    52   ../binutils-&binutils-version;/configure --prefix=/usr \
     59  ../binutils-&binutils-dir;/configure --prefix=/usr \
    5360    --enable-shared</userinput></screen>
    5461
     
    9198    <para os="p">Test the results:</para>
    9299
    93 <screen os="q"><userinput>make check</userinput></screen>
     100<screen os="q"><userinput remap="test">make check</userinput></screen>
    94101
    95102    <para os="r">Install the package:</para>
     
    100107    file that is needed by some packages:</para>
    101108
    102 <screen os="u"><userinput>cp -v ../binutils-&binutils-version;/include/libiberty.h /usr/include</userinput></screen>
     109<screen os="u"><userinput>cp -v ../binutils-&binutils-dir;/include/libiberty.h /usr/include</userinput></screen>
    103110
    104111  </sect2>
     
    113120
    114121      <seglistitem>
    115         <seg>addr2line, ar, as, c++filt, gprof, ld, nm, objcopy, objdump,
     122        <seg>addr2line, ar, as, c++filt, elfedit, gprof, ld, ld.bfd, nm, objcopy,
     123        objdump,
    116124        ranlib, readelf, size, strings, and strip</seg>
    117125        <seg>libiberty.a, libbfd.[a,so], and libopcodes.[a,so]</seg>
     
    170178      </varlistentry>
    171179
     180      <varlistentry id="elfedit">
     181        <term><command>elfedit</command></term>
     182        <listitem>
     183          <para>Updates the ELF header of ELF files</para>
     184          <indexterm zone="ch-system-binutils elfedit">
     185            <primary sortas="b-elfedit">elfedit</primary>
     186          </indexterm>
     187        </listitem>
     188      </varlistentry>
     189
    172190      <varlistentry id="gprof">
    173191        <term><command>gprof</command></term>
     
    188206          <indexterm zone="ch-system-binutils ld">
    189207            <primary sortas="b-ld">ld</primary>
     208          </indexterm>
     209        </listitem>
     210      </varlistentry>
     211
     212      <varlistentry id="ld.bfd">
     213        <term><command>ld.bfd</command></term>
     214        <listitem>
     215          <para>Hard link to <command>ld</command></para>
     216          <indexterm zone="ch-system-binutils ld.bfd">
     217            <primary sortas="b-ld.bfd">ld.bfd</primary>
    190218          </indexterm>
    191219        </listitem>
  • BOOK/final-system/common/bison.xml

    r1c9985f r026bb5d  
    2525    <title>Installation of Bison</title>
    2626
     27    <para os="t3">The <command>configure </command>script does not determine
     28    the correct value for the following. Set the value manually:</para>
     29
     30<screen os="t4"><userinput>echo "ac_cv_prog_lex_is_flex=yes" &gt; config.cache</userinput></screen>
     31
    2732    <para os="a">Prepare Bison for compilation:</para>
    2833
    29 <screen os="b"><userinput>./configure --prefix=/usr</userinput></screen>
    30 
    31     <para os="b1">The configure system causes Bison to be built without support
    32     for internationalization of error messages if a <command>bison</command>
    33     program is not already in $PATH.  The following addition will correct
    34     this:</para>
    35 
    36 <screen os="b2"><userinput>echo '#define YYENABLE_NLS 1' &gt;&gt; config.h</userinput></screen> 
     34<screen os="b"><userinput>./configure --prefix=/usr --cache-file=config.cache</userinput></screen>
    3735
    3836    <para os="c">Compile the package:</para>
     
    4038<screen os="d"><userinput>make</userinput></screen>
    4139
    42     <para os="e">To test the results, issue:
    43     <userinput>make check</userinput>.</para>
     40    <para os="e">To test the results, issue:</para>
     41
     42<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4443
    4544    <para os="f">Install the package:</para>
  • BOOK/final-system/common/cloog.xml

    r1c9985f r026bb5d  
    66]>
    77
    8 <sect1 id="ch-system-cloog-ppl" role="wrap">
    9   <?dbhtml filename="cloog-ppl.html"?>
     8<sect1 id="ch-system-cloog" role="wrap">
     9  <?dbhtml filename="cloog.html"?>
    1010
    11   <title>CLooG-PPL-&cloog-ppl-version;</title>
     11  <title>CLooG-&cloog-version;</title>
    1212
    13   <indexterm zone="ch-system-cloog-ppl">
    14     <primary sortas="a-CLooG-PPL">CLooG-PPL</primary>
     13  <indexterm zone="ch-system-cloog">
     14    <primary sortas="a-CLooG">CLooG</primary>
    1515  </indexterm>
    1616
     
    1818    <title/>
    1919
    20     <para>CLooG-PPL is a library to generate code for scanning Z-polyhedra.
     20    <para>CLooG is a library to generate code for scanning Z-polyhedra.
    2121    In other words, it finds code that reaches each integral point of one or
    2222    more parameterized polyhedra.  GCC links with this library in order to
     
    2626
    2727  <sect2 role="installation">
    28     <title>Installation of CLooG-PPL</title>
     28    <title>Installation of CLooG</title>
    2929
    30     <para os="a">Prepare CLooG-PPL for compilation:</para>
     30    <para os="a">Prepare CLooG for compilation:</para>
    3131
    3232<screen os="b"><userinput>CC="gcc -isystem /usr/include" \
    3333LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
    34   ./configure --prefix=/usr --enable-shared --with-gmp \
    35     --with-ppl</userinput></screen>
     34  ./configure --prefix=/usr --enable-shared --with-isl=system</userinput></screen>
    3635
    3736    <para os="c">Compile the package:</para>
     
    4039
    4140    <important os="e">
    42       <para>The test suite for CLooG-PPL is considered
     41      <para>The test suite for CLooG is considered
    4342      critical. Do not skip it under any circumstance.</para>
    4443    </important>
     
    4645    <para os="f">Test the results:</para>
    4746
    48 <screen os="g"><userinput>make check</userinput></screen>
     47<screen os="g"><userinput remap="test">make check</userinput></screen>
    4948
    5049    <para os="h">Install the package:</para>
     
    5453  </sect2>
    5554
    56   <sect2 id="contents-cloog-ppl" role="content">
    57     <title>Contents of CLooG-PPL</title>
     55  <sect2 id="contents-cloog" role="content">
     56    <title>Contents of CLooG</title>
    5857
    5958    <segmentedlist>
    60       <segtitle>Installed programs</segtitle>
     59      <segtitle>Installed program</segtitle>
    6160      <segtitle>Installed libraries</segtitle>
    62       <segtitle>Installed directory</segtitle>
     61      <segtitle>Installed directories</segtitle>
    6362
    6463      <seglistitem>
    6564        <seg>cloog</seg>
    66         <seg>libcloog.[a,so]</seg>
     65        <seg>libcloog-isl.[a,so]</seg>
    6766        <seg>/usr/include/cloog</seg>
    6867      </seglistitem>
     
    7877        <listitem>
    7978          <para>Loop generator for scanning Z-polyhedra</para>
    80           <indexterm zone="ch-system-cloog-ppl cloog">
     79          <indexterm zone="ch-system-cloog cloog">
    8180            <primary sortas="b-cloog">cloog</primary>
    8281          </indexterm>
     
    8483      </varlistentry>
    8584
    86       <varlistentry id="libcloog">
    87         <term><filename class="libraryfile">libcloog</filename></term>
     85      <varlistentry id="libcloog-isl">
     86        <term><filename class="libraryfile">libcloog-isl</filename></term>
    8887        <listitem>
    89           <para>The Chunky Loop Generator.</para>
    90           <indexterm zone="ch-system-cloog-ppl libcloog">
    91             <primary sortas="c-libcloog-ppl">libcloog</primary>
     88          <para>Isl backend for CLooG.</para>
     89          <indexterm zone="ch-system-cloog libcloog-isl">
     90            <primary sortas="c-libcloog-isl">libcloog-isl</primary>
    9291          </indexterm>
    9392        </listitem>
  • BOOK/final-system/common/coreutils.xml

    r1c9985f r026bb5d  
    3535    <para os="c">Now prepare Coreutils for compilation:</para>
    3636
    37 <screen os="d"><userinput>./configure --prefix=/usr \
     37<screen os="d"><userinput>FORCE_UNSAFE_CONFIGURE=1 \
     38  ./configure --prefix=/usr \
    3839    --enable-no-install-program=kill,uptime \
    3940    --enable-install-program=hostname</userinput></screen>
     41   
     42    <variablelist os="d1">
     43      <title>The meaning of the configure options:</title>
     44     
     45        <varlistentry os="d2">
     46          <term><parameter>FORCE_UNSAFE_CONFIGURE=1</parameter></term>
     47          <listitem>
     48            <para>Forces Coreutils to compile when using the root user.</para>
     49          </listitem>
     50        </varlistentry>
     51
     52      </variablelist>
    4053
    4154    <para os="e">Compile the package:</para>
     
    4558    <para os="g">The test suite of Coreutils makes several assumptions about the
    4659    presence of system users and groups that are not valid within the minimal
    47     environment that exists at the moment. Therefore, additional items need
    48     to be set up before running the tests. Skip down to <quote>Install the
    49     package</quote> if not running the test suite.</para>
    50 
    51     <para os="h">Create two <systemitem class="groupname">dummy</systemitem> groups
    52     and a <systemitem class="username">dummy</systemitem> user:</para>
    53 
    54 <screen os="i"><userinput>echo "dummy1:x:1000:" &gt;&gt; /etc/group
    55 echo "dummy2:x:1001:dummy" &gt;&gt; /etc/group
    56 echo "dummy:x:1000:1000::/root:/bin/bash" &gt;&gt; /etc/passwd</userinput></screen>
    57 
    58     <para os="j">Now the test suite is ready to be run. First, run
     60    environment that exists at the moment. Therefore, we will reuse the dummy
     61    groups and user created during Util-linux. Skip down to <quote>Install the
     62    package</quote> if not running the test suite and you did not create the
     63    dummy groups and users during Util-linux.</para>
     64
     65   <para os="h">Now the test suite is ready to be run. First, run
    5966    the tests that are meant to be run as user
    6067    <systemitem class="username">root</systemitem>:</para>
    6168
    62 <screen os="k"><userinput>make NON_ROOT_USERNAME=dummy check-root</userinput></screen>
    63 
    64     <para os="l">The testsuite will now be run as the
     69<screen os="i"><userinput remap="test">make NON_ROOT_USERNAME=dummy</userinput></screen>
     70
     71    <para os="j">The testsuite will now be run as the
    6572    <systemitem class="username">dummy</systemitem> user. Fix the permissions
    6673    for a few files to allow this:</para>
    6774
    68 <screen os="m"><userinput>chown -Rv dummy config.log {gnulib-tests,lib,src}/.deps</userinput></screen>
    69 
    70     <para os="n">Then run the remainder of the tests as the
     75<screen os="k"><userinput remap="test">chown -Rv dummy .</userinput></screen>
     76
     77    <para os="l">Then run the remainder of the tests as the
    7178    <systemitem class="username">dummy</systemitem> user:</para>
    7279
    73 <screen os="o"><userinput>src/su dummy -c "make RUN_EXPENSIVE_TESTS=yes check"</userinput></screen>
    74 
    75     <para os="p">When testing is complete, remove the
     80<screen os="m"><userinput remap="test">su dummy -s /bin/bash \
     81    -c "PATH=$PATH make RUN_EXPENSIVE_TESTS=yes -k check || true"</userinput></screen>
     82
     83    <para os="n">When testing is complete, remove the
    7684    <systemitem class="username">dummy</systemitem> user and groups:</para>
    7785
    78 <screen os="q"><userinput>sed -i '/dummy/d' /etc/passwd /etc/group</userinput></screen>
    79 
    80     <para os="r">Install the package:</para>
    81 
    82 <screen os="s"><userinput>make install</userinput></screen>
    83 
    84     <para os="t">Move programs to the locations specified by the FHS:</para>
    85 
    86 <screen os="u"><userinput>mv -v /usr/bin/{cat,chgrp,chmod,chown,cp,date} /bin
     86<screen os="o"><userinput remap="test">sed -i '/dummy/d' /etc/passwd /etc/group</userinput></screen>
     87
     88    <para os="p">Install the package:</para>
     89
     90<screen os="q"><userinput>make install</userinput></screen>
     91
     92    <para os="r">Move programs to the locations specified by the FHS:</para>
     93
     94<screen os="s"><userinput>mv -v /usr/bin/{cat,chgrp,chmod,chown,cp,date} /bin
    8795mv -v /usr/bin/{dd,df,echo,false,hostname,ln,ls,mkdir,mknod} /bin
    8896mv -v /usr/bin/{mv,pwd,rm,rmdir,stty,true,uname} /bin
    8997mv -v /usr/bin/chroot /usr/sbin</userinput></screen>
    9098
    91     <para os="v">Other Coreutils programs are used by some of the scripts
     99    <para os="t">Other Coreutils programs are used by some of the scripts
    92100    in the CLFS-Bootscripts package. As <filename
    93101    class="directory">/usr</filename> may not be available during the early
    94102    stages of booting, those binaries need to be on the root partition:</para>
    95103
    96 <screen os="w"><userinput>mv -v /usr/bin/{[,basename,head,install,nice} /bin
     104<screen os="u"><userinput>mv -v /usr/bin/{[,basename,head,install,nice} /bin
    97105mv -v /usr/bin/{readlink,sleep,sync,test,touch} /bin
    98106ln -svf ../../bin/install /usr/bin</userinput></screen>
     
    113121        echo, env, expand, expr, factor, false, fmt, fold, groups, head,
    114122        hostid, hostname, id, install, join, link, ln, logname, ls, md5sum,
    115         mkdir, mkfifo, mknod, mktemp, mv, nice, nl, nohup, od, paste, pathchk,
    116         pinky, pr, printenv, printf, ptx, pwd, readlink, rm, rmdir, runcon, seq,
    117         sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, shred, shuf,
    118         sleep, sort, split, stat, stdbuf, stty, sum, sync, tac, tail, tee, test,
    119         timeout, touch, tr, true, truncate, tsort, tty, uname, unexpand, uniq,
    120         unlink, users, vdir, wc, who, whoami, and yes</seg>
     123        mkdir, mkfifo, mknod, mktemp, mv, nice, nl, nohup, nproc, numfmt, od, paste,
     124        pathchk, pinky, pr, printenv, printf, ptx, pwd, readlink, realpath, rm,
     125        rmdir, runcon, seq, sha1sum, sha224sum, sha256sum, sha384sum,
     126        sha512sum, shred, shuf, sleep, sort, split, stat, stdbuf, stty, sum,
     127        sync, tac, tail, tee, test, timeout, touch, tr, true, truncate, tsort,
     128        tty, uname, unexpand, uniq, unlink, users, vdir, wc, who, whoami, and yes</seg>
    121129        <seg>libstdbuf.so</seg>
    122130        <seg>/usr/lib/coreutils</seg>
     
    636644      </varlistentry>
    637645
     646      <varlistentry id="nproc">
     647        <term><command>nproc</command></term>
     648        <listitem>
     649          <para>Prints the number of processing units available to the current
     650          process</para>
     651          <indexterm zone="ch-system-coreutils nproc">
     652            <primary sortas="b-nproc">nproc</primary>
     653          </indexterm>
     654        </listitem>
     655      </varlistentry>
     656
     657      <varlistentry id="numfmt">
     658        <term><command>numfmt</command></term>
     659        <listitem>
     660          <para>Converts numbers to or from human-readable strings</para>
     661          <indexterm zone="ch-system-coreutils numfmt">
     662            <primary sortas="b-numfmt">numfmt</primary>
     663          </indexterm>
     664        </listitem>
     665      </varlistentry>
     666
    638667      <varlistentry id="od">
    639668        <term><command>od</command></term>
     
    736765          <indexterm zone="ch-system-coreutils readlink">
    737766            <primary sortas="b-readlink">readlink</primary>
     767          </indexterm>
     768        </listitem>
     769      </varlistentry>
     770
     771      <varlistentry id="realpath">
     772        <term><command>realpath</command></term>
     773        <listitem>
     774          <para>Prints the resolved path</para>
     775          <indexterm zone="ch-system-coreutils realpath">
     776            <primary sortas="b-realpath">realpath</primary>
    738777          </indexterm>
    739778        </listitem>
  • BOOK/final-system/common/diffutils.xml

    r1c9985f r026bb5d  
    3939<screen os="d"><userinput>make</userinput></screen>
    4040
    41     <para os="e">This package does not come with a test suite.</para>
     41    <para os="e">To test the results, issue:</para>
     42
     43<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4244
    4345    <para os="f">Install the package:</para>
  • BOOK/final-system/common/e2fsprogs.xml

    r1c9985f r026bb5d  
    7373<screen os="g"><userinput>make</userinput></screen>
    7474
    75     <para os="h">To test the results, issue:
    76     <userinput>make check</userinput>.</para>
     75    <para os="h">To test the results, issue:</para>
     76
     77<screen os="h2"><userinput remap="test">make check</userinput></screen>
    7778
    7879    <para os="i">Install the binaries, documentation and shared libraries:</para>
     
    9697      <seglistitem>
    9798        <seg>badblocks, chattr, compile_et, debugfs, dumpe2fs, e2freefrag,
    98         e2fsck, e2image, e2initrd_helper, e2label, e2undo, filefrag, fsck.ext2,
    99         fsck.ext3, fsck.ext4, fsck.ext4dev, logsave, lsattr, mk_cmds, mke2fs,
    100         mkfs.ext2, mkfs.ext3, mkfs.ext4, mkfs.ext4dev, mklost+found, resize2fs,
    101         and tune2fs</seg>
    102         <seg>libcom_err.[a,so], libe2p.[a,so], libext2fs.[a,so], and
    103         libss.[a,so]</seg>
     99        e2fsck, e2image, e2initrd_helper, e2label, e2undo, e4defrag, filefrag,
     100        fsck.ext2, fsck.ext3, fsck.ext4, fsck.ext4dev, logsave, lsattr,
     101        mk_cmds, mke2fs, mkfs.ext2, mkfs.ext3, mkfs.ext4, mkfs.ext4dev,
     102        mklost+found, resize2fs, and tune2fs</seg>
     103        <seg>libcom_err.[a,so], libe2p.[a,so], libext2fs.[a,so],
     104        libss.[a,so], and libquota.a</seg>
    104105        <seg>/usr/include/e2p, /usr/include/et, /usr/include/ext2fs,
    105         /usr/include/ss, /usr/share/et, /usr/share/ss</seg>
     106        /usr/include/quota, /usr/include/ss, /usr/share/et, /usr/share/ss</seg>
    106107      </seglistitem>
    107108    </segmentedlist>
     
    126127        <term><command>chattr</command></term>
    127128        <listitem>
    128           <para>Changes the attributes of files on an <systemitem
    129           class="filesystem">ext2</systemitem> file system; it also
    130           changes <systemitem class="filesystem">ext3</systemitem>
    131           file systems, the journaling version of <systemitem
    132           class="filesystem">ext2</systemitem> file systems</para>
     129          <para>Changes the attributes on a Linux file system</para>
    133130          <indexterm zone="ch-system-e2fsprogs chattr">
    134131            <primary sortas="b-chattr">chattr</primary>
     
    186183        <listitem>
    187184          <para>Is used to check, and optionally repair <systemitem
    188           class="filesystem">ext2</systemitem> file systems and <systemitem
    189           class="filesystem">ext3</systemitem> file systems</para>
     185          class="filesystem">ext2</systemitem>, <systemitem
     186          class="filesystem">ext3</systemitem> and <systemitem
     187          class="filesystem">ext4</systemitem>file systems</para>
    190188          <indexterm zone="ch-system-e2fsprogs e2fsck">
    191189            <primary sortas="b-e2fsck">e2fsck</primary>
     
    238236      </varlistentry>
    239237
     238      <varlistentry id="e4defrag">
     239        <term><command>e4defrag</command></term>
     240        <listitem>
     241          <para>Online defragmenter for ext4 filesystems</para>
     242          <indexterm zone="ch-system-e2fsprogs e4defrag">
     243            <primary sortas="b-e4defrag">e4defrag</primary>
     244          </indexterm>
     245        </listitem>
     246      </varlistentry>
     247
    240248      <varlistentry id="filefrag">
    241249        <term><command>filefrag</command></term>
     
    328336        <term><command>mke2fs</command></term>
    329337        <listitem>
    330           <para>Creates an <systemitem class="filesystem">ext2</systemitem>
    331           or <systemitem class="filesystem">ext3</systemitem> file system on
    332           the given device</para>
     338          <para>Creates an <systemitem class="filesystem">ext2</systemitem>,
     339          <systemitem class="filesystem">ext3</systemitem> or <systemitem
     340          class="filesystem">ext4</systemitem> file system on the given device</para>
    333341          <indexterm zone="ch-system-e2fsprogs mke2fs">
    334342            <primary sortas="b-mke2fs">mke2fs</primary>
     
    448456      </varlistentry>
    449457
     458      <varlistentry id="libquota">
     459        <term><filename class="libraryfile">libquota</filename></term>
     460        <listitem>
     461          <para>Provides an interface for creating and updating quota files
     462          and ext4 superblock fields</para>
     463          <indexterm zone="ch-system-e2fsprogs libquota">
     464            <primary sortas="c-libquota">libquota</primary>
     465          </indexterm>
     466        </listitem>
     467      </varlistentry>
     468
    450469      <varlistentry id="libss">
    451470        <term><filename class="libraryfile">libss</filename></term>
  • BOOK/final-system/common/eglibc.xml

    r1c9985f r026bb5d  
    5858unset LINKER</userinput></screen>
    5959
    60     <para os="p1">The following patch fixes an issue where EGLIBC will
    61     improperly handle a condition where an elf binary has missing
    62     dependencies:</para>
    63 
    64 <screen os="p2"><userinput>patch -Np1 -i ../&eglibc-dl_dep_fix-patch;</userinput></screen>
    65 
    6660    <para os="b">The EGLIBC build system is self-contained and will install
    6761    perfectly, even though the compiler specs file and linker are still
     
    7165    of achieving a clean build.</para>
    7266
    73     <para os="e">The EGLIBC documentation recommends building EGLIBC outside of the
    74     source directory in a dedicated build directory:</para>
     67    <para os="s1">Allow EGLIBC to detect Make-4.x:</para>
     68
     69<screen os="s2"><userinput>sed -r -i 's/(3..89..)/\1 | 4.*/' configure</userinput></screen>
     70
     71    <para os="e">The EGLIBC documentation recommends building EGLIBC outside of     the source directory in a dedicated build directory:</para>
    7572
    7673<screen os="f"><userinput>mkdir -v ../eglibc-build
     
    8077
    8178<screen os="h"><userinput>../eglibc-&eglibc-version;/configure --prefix=/usr \
    82     --disable-profile --enable-add-ons --enable-kernel=2.6.0 \
    83     --libexecdir=/usr/lib/eglibc</userinput></screen>
     79    --disable-profile --enable-kernel=2.6.32 --libexecdir=/usr/lib/eglibc \
     80    --enable-obsolete-rpc</userinput></screen>
    8481
    8582    <variablelist os="i">
     
    8986        <term><parameter>--libexecdir=/usr/lib/eglibc</parameter></term>
    9087        <listitem>
    91           <para>This changes the location of the <command>pt_chown</command>
    92           program from its default of <filename
     88          <para>This changes the location of the <command>getconf</command>
     89          utility from its default of <filename
    9390          class="directory">/usr/libexec</filename> to <filename
    9491          class="directory">/usr/lib/eglibc</filename>.</para>
     
    111108<!-- items n,o,p no longer the master, use x86_64 which has no failures -->
    112109
    113 <screen os="n"><userinput>cp -v ../eglibc-&eglibc-version;/iconvdata/gconv-modules iconvdata
     110<screen os="n"><userinput remap="test">cp -v ../eglibc-&eglibc-version;/iconvdata/gconv-modules iconvdata
    114111make -k check 2&gt;&amp;1 | tee eglibc-check-log; grep Error eglibc-check-log</userinput></screen>
    115112
     
    246243EOF</userinput></screen>
    247244
     245    <para>Install timezone data:</para>
     246<screen><userinput>tar -xf ../tzdata&tzdata-version;.tar.gz
     247
     248ZONEINFO=/usr/share/zoneinfo
     249mkdir -pv $ZONEINFO/{posix,right}
     250
     251for tz in etcetera southamerica northamerica europe africa antarctica  \
     252          asia australasia backward pacificnew solar87 solar88 solar89 \
     253          systemv; do
     254    zic -L /dev/null   -d $ZONEINFO       -y "sh yearistype.sh" ${tz}
     255    zic -L /dev/null   -d $ZONEINFO/posix -y "sh yearistype.sh" ${tz}
     256    zic -L leapseconds -d $ZONEINFO/right -y "sh yearistype.sh" ${tz}
     257done
     258
     259cp -v zone.tab iso3166.tab $ZONEINFO
     260zic -d $ZONEINFO -p America/New_York
     261unset ZONEINFO</userinput></screen>
     262
     263    <variablelist>
     264      <title>The meaning of the zic commands:</title>
     265
     266      <varlistentry>
     267        <term><parameter>zic -L /dev/null ...</parameter></term>
     268        <listitem>
     269          <para>This creates posix timezones, without any leap seconds.  It is
     270          conventional to put these in both
     271          <filename class="directory">zoneinfo</filename> and
     272          <filename class="directory">zoneinfo/posix</filename>. It is
     273          necessary to put the POSIX timezones in
     274          <filename class="directory">zoneinfo</filename>, otherwise various
     275          test-suites will report errors. On an embedded system, where space is
     276          tight and you do not intend to ever update the timezones, you could save
     277          1.9MB by not using the <filename class="directory">posix</filename>
     278          directory, but some applications or test-suites might give less good
     279          results</para>
     280        </listitem>
     281      </varlistentry>
     282      <varlistentry>
     283        <term><parameter>zic -L leapseconds ...</parameter></term>
     284        <listitem>
     285          <para>This creates right timezones, including leap seconds. On an
     286          embedded system, where space is tight and you do not intend to
     287          ever update the timezones, or care about the correct time, you could
     288          save 1.9MB by omitting the <filename class="directory">right</filename>
     289          directory.</para>
     290        </listitem>
     291      </varlistentry>
     292      <varlistentry>
     293        <term><parameter>zic ... -p ...</parameter></term>
     294        <listitem>
     295          <para>This creates the <filename>posixrules</filename> file. We use
     296          New York because POSIX requires the daylight savings time rules
     297          to be in accordance with US rules.</para>
     298        </listitem>
     299      </varlistentry>
     300    </variablelist>
     301
    248302    <para>To determine the local time zone, run the following script:</para>
    249303
     
    323377      <seglistitem>
    324378        <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig,
    325         ldd, lddlibc4, locale, localedef, mtrace, nscd,
    326         pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace,
    327         zdump, and zic</seg>
     379        ldd, lddlibc4, locale, localedef, makedb, mtrace, nscd,
     380        pcprofiledump, pldd, rpcgen, sln, sprof, tzselect, xtrace,zdump,
     381        and zic</seg>
    328382        <seg>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so],
    329383        libbsd-compat.a, libc.[a,so], libc_nonshared.a, libcidn.[a,so],
     
    465519      </varlistentry>
    466520
     521      <varlistentry id="makedb">
     522        <term><command>makedb</command></term>
     523        <listitem>
     524          <para>Creates a simple database from textual input</para>
     525          <indexterm zone="ch-system-eglibc makedb">
     526            <primary sortas="b-makedb">makedb</primary>
     527          </indexterm>
     528        </listitem>
     529      </varlistentry>
     530
    467531      <varlistentry id="mtrace">
    468532        <term><command>mtrace</command></term>
     
    497561      </varlistentry>
    498562
    499       <varlistentry id="pt_chown">
    500         <term><command>pt_chown</command></term>
    501         <listitem>
    502           <para>A helper program for <command>grantpt</command> to set the owner,
    503           group and access permissions of a slave pseudo terminal</para>
    504           <indexterm zone="ch-system-eglibc pt_chown">
    505             <primary sortas="b-pt_chown">pt_chown</primary>
     563      <varlistentry id="pldd">
     564        <term><command>pldd</command></term>
     565        <listitem>
     566          <para>Lists dynamic shared objects used by running processes</para>
     567          <indexterm zone="ch-system-eglibc pldd">
     568            <primary sortas="b-pldd">pldd</primary>
    506569          </indexterm>
    507570        </listitem>
     
    519582      </varlistentry>
    520583
    521       <varlistentry id="rpcinfo">
    522         <term><command>rpcinfo</command></term>
    523         <listitem>
    524           <para>Makes an RPC call to an RPC server</para>
    525           <indexterm zone="ch-system-eglibc rpcinfo">
    526             <primary sortas="b-rpcinfo">rpcinfo</primary>
    527           </indexterm>
    528         </listitem>
    529       </varlistentry>
    530 
    531584      <varlistentry id="sln">
    532585        <term><command>sln</command></term>
     
    535588          <indexterm zone="ch-system-eglibc sln">
    536589            <primary sortas="b-sln">sln</primary>
     590          </indexterm>
     591        </listitem>
     592      </varlistentry>
     593
     594      <varlistentry id="sotruss">
     595        <term><command>sotruss</command></term>
     596        <listitem>
     597          <para>Traces shared library procedure calls of a specified command</para>
     598          <indexterm zone="ch-system-eglibc sotruss">
     599            <primary sortas="b-sotruss">sotruss</primary>
    537600          </indexterm>
    538601        </listitem>
  • BOOK/final-system/common/eudev.xml

    r1c9985f r026bb5d  
    66]>
    77
    8 <sect1 id="ch-system-udev" role="wrap">
    9   <?dbhtml filename="udev.html"?>
    10 
    11   <title>Udev-&udev-version;</title>
    12 
    13   <indexterm zone="ch-system-udev">
    14     <primary sortas="a-Udev">Udev</primary>
     8<sect1 id="ch-system-eudev" role="wrap">
     9  <?dbhtml filename="eudev.html"?>
     10
     11  <title>Eudev-&eudev-version;</title>
     12
     13  <indexterm zone="ch-system-eudev">
     14    <primary sortas="a-Eudev">Eudev</primary>
    1515  </indexterm>
    1616
     
    1818    <title/>
    1919
    20     <para>The Udev package contains programs for dynamic creation of device
     20    <para>The Eudev package contains programs for dynamic creation of device
    2121    nodes.</para>
    2222
     
    2424
    2525  <sect2 role="installation">
    26     <title>Installation of Udev</title>
    27 
    28     <para os="a">Prepare Udev for compilation:</para>
    29 
    30 <screen os="b"><userinput>./configure --prefix=/usr \
    31   --exec-prefix="" --sysconfdir=/etc \
    32   --libexecdir=/lib/udev --libdir=/usr/lib \
    33   --disable-extras --disable-introspection</userinput></screen>
     26    <title>Installation of Eudev</title>
     27
     28    <para os="a">Prepare Eudev for compilation:</para>
     29
     30<screen os="b"><userinput>./configure --prefix=/usr --sysconfdir=/etc \
     31    --with-rootprefix="" --libexecdir=/lib --enable-split-usr \
     32    --libdir=/usr/lib --with-rootlibdir=/lib --sbindir=/sbin --bindir=/sbin \
     33    --enable-rule_generator --disable-introspection --disable-keymap \
     34    --disable-gudev --disable-gtk-doc-html --with-firmware-path=/lib/firmware \
     35    --enable-libkmod</userinput></screen>
    3436
    3537    <para os="c">Compile the package:</para>
    3638
    3739<screen os="d"><userinput>make</userinput></screen>
     40
     41    <para os="e">To test the results, issue:</para>
     42
     43<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3844
    3945    <para os="g">Install the package:</para>
     
    4652<screen os="j"><userinput>install -dv /lib/firmware</userinput></screen>
    4753
     54    <para os="r1">Create a dummy rule so that Eudev will name ethernet devices properly for the system.</para>
     55
     56<screen os="r2"><userinput>echo "# dummy, so that network is once again on eth*" \
     57> /etc/udev/rules.d/80-net-name-slot.rules</userinput></screen>
     58
    4859  </sect2>
    4960
    50   <sect2 id="contents-udev" role="content">
    51     <title>Contents of Udev</title>
     61  <sect2 id="contents-eudev" role="content">
     62    <title>Contents of Eudev</title>
    5263
    5364    <segmentedlist>
     
    7384        <term><command>udevadm</command></term>
    7485        <listitem>
    75         <para>Controls the runtime behavior of Udev, requests kernel
     86        <para>Controls the runtime behavior of Eudev, requests kernel
    7687        events, manages the event queue, and provides simple debugging.</para>
    77           <indexterm zone="ch-system-udev udevadm">
     88          <indexterm zone="ch-system-eudev udevadm">
    7889            <primary sortas="b-udevadm">udevadm</primary>
    7990          </indexterm>
     
    8798          <command>udev</command>,
    8899          thus avoiding various race conditions</para>
    89           <indexterm zone="ch-system-udev udevd">
     100          <indexterm zone="ch-system-eudev udevd">
    90101            <primary sortas="b-udevd">udevd</primary>
    91102          </indexterm>
     
    97108        <term><command>ata_id</command></term>
    98109        <listitem>
    99           <para>Provides Udev with a unique string and additional
     110          <para>Provides Eudev with a unique string and additional
    100111          information (uuid, label) for an ATA drive</para>
    101           <indexterm zone="ch-system-udev ata_id">
     112          <indexterm zone="ch-system-eudev ata_id">
    102113            <primary sortas="b-ata_id">ata_id</primary>
    103114          </indexterm>
     
    109120        <listitem>
    110121          <para>Prints the capabilities of a CDROM or DVDROM drive.</para>
    111           <indexterm zone="ch-system-udev cdrom_id">
     122          <indexterm zone="ch-system-eudev cdrom_id">
    112123            <primary sortas="b-cdrom_id">cdrom_id</primary>
    113124          </indexterm>
     
    118129        <term><command>collect</command></term>
    119130        <listitem>
    120           <para>DESCRIPTION REQUIRED</para>
    121           <indexterm zone="ch-system-udev collect">
     131          <para>Given an ID for the current uevent and a list of IDs
     132(for all target uevents), registers the current ID and indicates whether
     133all target IDs have been registered.</para>
     134          <indexterm zone="ch-system-eudev collect">
    122135            <primary sortas="b-collect">collect</primary>
    123136          </indexterm>
     
    129142        <listitem>
    130143          <para>Creates all possible floppy devices based on the CMOS type</para>
    131           <indexterm zone="ch-system-udev create_floppy_devices">
     144          <indexterm zone="ch-system-eudev create_floppy_devices">
    132145            <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
    133146          </indexterm>
     
    139152        <listitem>
    140153          <para>Identifies x86 disk drives from Enhanced Disk Drive calls</para>
    141           <indexterm zone="ch-system-udev edd_id">
     154          <indexterm zone="ch-system-eudev edd_id">
    142155            <primary sortas="b-edd_id">edd_id</primary>
    143156          </indexterm>
     
    149162        <listitem>
    150163          <para>Script to load firmware for a device</para>
    151           <indexterm zone="ch-system-udev firmware.sh">
     164          <indexterm zone="ch-system-eudev firmware.sh">
    152165            <primary sortas="b-firmware.sh">firmware.sh</primary>
    153166          </indexterm>
     
    158171        <term><command>fstab_import</command></term>
    159172        <listitem>
    160           <para>DESCRIPTION REQUIRED</para>
    161           <indexterm zone="ch-system-udev fstab_import">
     173          <para>Finds an entry in <filename>/etc/fstab</filename> that matches
     174the current device, and provides its information to Udev.</para>
     175          <indexterm zone="ch-system-eudev fstab_import">
    162176            <primary sortas="b-fstab_import">fstab_import</primary>
    163177          </indexterm>
     
    170184          <para>Provides the shortest possible unique hardware path to a
    171185          device</para>
    172           <indexterm zone="ch-system-udev path_id">
     186          <indexterm zone="ch-system-eudev path_id">
    173187            <primary sortas="b-path_id">path_id</primary>
    174188          </indexterm>
     
    180194        <listitem>
    181195          <para>Retrieves or generates a unique SCSI identifier.</para>
    182           <indexterm zone="ch-system-udev scsi_id">
     196          <indexterm zone="ch-system-eudev scsi_id">
    183197            <primary sortas="b-scsi_id">scsi_id</primary>
    184198          </indexterm>
     
    190204        <listitem>
    191205          <para>Identifies a USB block device.</para>
    192           <indexterm zone="ch-system-udev usb_id">
     206          <indexterm zone="ch-system-eudev usb_id">
    193207            <primary sortas="b-usb_id">usb_id</primary>
    194208          </indexterm>
     
    199213        <term><command>v4l_id</command></term>
    200214        <listitem>
    201           <para>DESCRIPTION REQUIRED</para>
    202           <indexterm zone="ch-system-udev v4l_id">
     215          <para>Determines V4L capabilities for a given device.</para>
     216          <indexterm zone="ch-system-eudev v4l_id">
    203217            <primary sortas="b-v4l_id">v4l_id</primary>
    204218          </indexterm>
     
    209223        <term><command>write_cd_rules</command></term>
    210224        <listitem>
    211           <para>DESCRIPTION REQUIRED</para>
    212           <indexterm zone="ch-system-udev write_cd_rules">
     225          <para>A script which generates Eudev rules to provide stable names
     226for network interfaces.</para>
     227          <indexterm zone="ch-system-eudev write_cd_rules">
    213228            <primary sortas="b-write_cd_rules">write_cd_rules</primary>
    214229          </indexterm>
     
    219234        <term><command>write_net_rules</command></term>
    220235        <listitem>
    221           <para>DESCRIPTION REQUIRED</para>
    222           <indexterm zone="ch-system-udev write_net_rules">
     236          <para>A script which generates Eudev rules to provide stable names
     237for network interfaces.</para>
     238          <indexterm zone="ch-system-eudev write_net_rules">
    223239            <primary sortas="b-write_net_rules">write_net_rules</primary>
    224240          </indexterm>
     
    230246        <term><filename class="libraryfile">libudev</filename></term>
    231247        <listitem>
    232           <para>DESCRIPTION REQUIRED</para>
    233           <indexterm zone="ch-system-udev libudev">
     248          <para>A library interface to eudev device information.</para>
     249          <indexterm zone="ch-system-eudev libudev">
    234250            <primary sortas="c-libudev">libudev</primary>
    235251          </indexterm>
     
    237253      </varlistentry>
    238254
    239       <varlistentry id="etc-udev">
     255      <varlistentry id="etc-eudev">
    240256        <term><filename class="directory">/etc/udev</filename></term>
    241257        <listitem>
    242258          <para>Contains <command>udev</command> configuration files,
    243259          device permissions, and rules for device naming</para>
    244           <indexterm zone="ch-system-udev etc-udev">
     260          <indexterm zone="ch-system-eudev etc-eudev">
    245261            <primary sortas="e-/etc/udev">/etc/udev</primary>
    246262          </indexterm>
     
    248264      </varlistentry>
    249265
    250       <varlistentry id="lib-udev">
     266      <varlistentry id="lib-eudev">
    251267        <term><filename class="directory">/lib/udev</filename></term>
    252268        <listitem>
    253269          <para>Contains <command>udev</command> helper programs
    254270          and static devices which get copied to /dev when booted.</para>
    255           <indexterm zone="ch-system-udev lib-udev">
     271          <indexterm zone="ch-system-eudev lib-eudev">
    256272            <primary sortas="e-/lib/udev">/lib/udev</primary>
    257273          </indexterm>
  • BOOK/final-system/common/file.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">This package does not come with a test suite.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3739
    3840    <para os="f">Install the package:</para>
  • BOOK/final-system/common/findutils.xml

    r1c9985f r026bb5d  
    5151<screen os="e"><userinput>make</userinput></screen>
    5252
    53     <para os="f">To test the results, issue:
    54     <userinput>make check</userinput>.</para>
     53    <para os="f">To test the results, issue:</para>
     54
     55<screen os="f2"><userinput remap="test">make check</userinput></screen>
    5556
    5657    <para os="g">Install the package:</para>
  • BOOK/final-system/common/flex.xml

    r1c9985f r026bb5d  
    2626    <title>Installation of Flex</title>
    2727
    28     <para os="p1">The following patch contains fixes to Generate proper
    29     GCC 4.4.x code:</para>
    30 
    31 <screen os="p2"><userinput>patch -Np1 -i ../&flex-gcc44-patch;</userinput></screen>
    32 
    3328    <para os="a">Prepare Flex for compilation:</para>
    3429
     
    3934<screen os="d"><userinput>make</userinput></screen>
    4035
    41     <para os="e">To test the results, issue:
    42     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4339
    4440    <para os="f">Install the package:</para>
     
    10197      </varlistentry>
    10298
     99      <varlistentry id="flexpp">
     100        <term><command>flex++</command></term>
     101        <listitem>
     102          <para>Link to <command>flex</command> which makes it generate C++
     103          scanner classes</para>
     104          <indexterm zone="ch-system-flex flexpp">
     105            <primary sortas="b-flex++">flex++</primary>
     106          </indexterm>
     107        </listitem>
     108      </varlistentry>
     109
    103110      <varlistentry id="lex">
    104111        <term><command>lex</command></term>
  • BOOK/final-system/common/gawk.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">To test the results, issue:
    37     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3839
    3940    <para os="f">Install the package:</para>
  • BOOK/final-system/common/gcc.xml

    r1c9985f r026bb5d  
    2626    <title>Installation of GCC</title>
    2727
    28 
    2928    <para os="p1">The following patch contains a number of updates to the
    3029    &gcc-version; branch by the GCC developers:</para>
    3130
    3231    <screen os="p2"><userinput>patch -Np1 -i ../&gcc-branch_update-patch;</userinput></screen>
     32
     33    <para os="fix1">Apply a <command>sed</command> subsitution that will
     34    suppress the execution of the <command>fixincludes</command> script:</para>
     35
     36<screen os="fix2"><userinput>cp -v gcc/Makefile.in{,.orig}
     37sed 's@\./fixinc\.sh@-c true@' gcc/Makefile.in.orig > gcc/Makefile.in</userinput></screen>
    3338
    3439    <para os="d">Apply a <command>sed</command> substitution that will suppress the
     
    5459    --enable-__cxa_atexit --enable-c99 --enable-long-long \
    5560    --enable-clocale=gnu --enable-languages=c,c++ \
    56     --disable-multilib --disable-libstdcxx-pch</userinput></screen>
     61    --disable-multilib --disable-libstdcxx-pch \
     62    --enable-cloog-backend=isl --disable-isl-version-check --with-system-zlib \
     63    --enable-checking=release --enable-libstdcxx-time \
     64    --disable-install-libiberty</userinput></screen>
    5765
    5866    <para os="j">Compile the package:</para>
     
    6573    </important>
    6674
     75   <para os="s1">Increase the stack size prior to running the tests:</para>
     76
     77<screen os="s2"><userinput remap="test">ulimit -s 32768</userinput></screen>
     78
    6779    <para os="m">Test the results, but do not stop at errors:</para>
    6880
    69 <screen os="n"><userinput>make -k check</userinput></screen>
     81<screen os="n"><userinput remap="test">make -k check</userinput></screen>
    7082
    7183    <para os="o">The <parameter>-k</parameter> flag is used to make the test suite
     
    7486    failures. To receive a summary of the test suite results, run:</para>
    7587
    76 <screen os="p"><userinput>../gcc-&gcc-version;/contrib/test_summary</userinput></screen>
     88<screen os="p"><userinput remap="test">../gcc-&gcc-version;/contrib/test_summary</userinput></screen>
    7789
    7890    <para os="q">For only the summaries, pipe the output through
     
    97109
    98110<screen os="x"><userinput>ln -sv gcc /usr/bin/cc</userinput></screen>
     111
     112    <para os="y">Finally, move a misplaced file:</para>
     113
     114<screen os="z"><userinput>mv -v /usr/lib/*gdb.py /usr/share/gdb/auto-load/usr/lib</userinput></screen>
    99115
    100116  </sect2>
     
    109125
    110126      <seglistitem>
    111         <seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
    112         <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.[a,so],
    113         libmudflap.[a,so], libmudflapth.[a,so], libssp.[a,so],
    114         libssp_nonshared.a, libstdc++.[a,so], and libsupc++.a</seg>
    115         <seg>/usr/include/c++, /usr/lib/gcc</seg>
     127        <seg>c++, cc (link to gcc), cpp, g++, gcc, and gcov</seg>
     128        <seg>libasan.[a,so], libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a,
     129        libgomp.[a,so], libmudflap.[a,so], libmudflapth.[a,so], libssp.[a,so],
     130        libssp_nonshared.a, libstdc++.[a,so], libsupc++.a, and libtsan.[a,so]</seg>
     131        <seg>/usr/include/c++, /usr/lib/gcc, /usr/share/gcc-&gcc-version;</seg>
    116132      </seglistitem>
    117133    </segmentedlist>
     
    173189      </varlistentry>
    174190
    175       <varlistentry id="gccbug">
    176         <term><command>gccbug</command></term>
    177         <listitem>
    178           <para>A shell script used to help create useful bug reports</para>
    179           <indexterm zone="ch-system-gcc gccbug">
    180             <primary sortas="b-gccbug">gccbug</primary>
    181           </indexterm>
    182         </listitem>
    183       </varlistentry>
    184 
    185191      <varlistentry id="gcov">
    186192        <term><command>gcov</command></term>
     
    194200      </varlistentry>
    195201
     202      <varlistentry id="libasan">
     203        <term><filename class="libraryfile">libasan</filename></term>
     204        <listitem>
     205          <para>The Address Sanitizer runtime library</para>
     206          <indexterm zone="ch-system-gcc libasan">
     207            <primary sortas="c-libasan">libasan</primary>
     208          </indexterm>
     209        </listitem>
     210      </varlistentry>
     211
    196212      <varlistentry id="libgcc">
    197213        <term><filename class="libraryfile">libgcc</filename></term>
     
    269285      </varlistentry>
    270286
     287      <varlistentry id="libtsan">
     288        <term><filename class="libraryfile">libtsan</filename></term>
     289        <listitem>
     290          <para>The Thread Sanitizer runtime library</para>
     291          <indexterm zone="ch-system-gcc libtsan">
     292            <primary sortas="c-libtsan">libtsan</primary>
     293          </indexterm>
     294        </listitem>
     295      </varlistentry>
     296
    271297    </variablelist>
    272298
  • BOOK/final-system/common/gettext.xml

    r1c9985f r026bb5d  
    3636<screen os="d"><userinput>make</userinput></screen>
    3737
    38     <para os="e">To test the results, issue: <userinput>make check</userinput>.</para>
     38    <para os="e">To test the results, issue:</para>
     39
     40<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3941
    4042    <para os="f">Install the package:</para>
  • BOOK/final-system/common/gmp.xml

    r1c9985f r026bb5d  
    3535
    3636    <note os="n1">
    37       <para>If you are compiling this package on a different CPU then you plan to
    38       run the CLFS system on. You must replace GMP's <filename>config.guess</filename>
    39       and <filename>config.sub</filename> wrappers with the originals. This will
    40       prevent GMP from optimizing for the wrong CPU. You can make this change with
    41       the following command:</para>
     37      <para>If you are compiling this package on a different CPU than you plan
     38      to run the CLFS system on, you must replace GMP's
     39      <filename>config.guess</filename> and <filename>config.sub</filename>
     40      wrappers with the originals. This will prevent GMP from optimizing for
     41      the wrong CPU. You can make this change with the following command:</para>
    4242
    43 <screen><userinput>mv -v config{fsf,}.guess
    44 mv -v config{fsf,}.sub</userinput></screen>
     43<screen>mv -v config{fsf,}.guess
     44mv -v config{fsf,}.sub</screen>
    4545
    4646    </note>
     
    4848    <para os="a">Prepare GMP for compilation:</para>
    4949
    50 <screen os="b"><userinput>CPPFLAGS=-fexceptions CC="gcc -isystem /usr/include" \
     50<screen os="b"><userinput>CC="gcc -isystem /usr/include" \
    5151CXX="g++ -isystem /usr/include" \
    5252LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
    53   ./configure --prefix=/usr --enable-cxx --enable-mpbsd</userinput></screen>
     53  ./configure --prefix=/usr --enable-cxx</userinput></screen>
    5454
    5555    <para os="c">Compile the package:</para>
     
    6464    <para os="f">Test the results:</para>
    6565
    66 <screen os="g"><userinput>make check</userinput></screen>
     66<screen os="g"><userinput remap="test">make check</userinput></screen>
    6767
    6868    <para os="h">Install the package:</para>
  • BOOK/final-system/common/grep.xml

    r1c9985f r026bb5d  
    2828    <para os="a">Prepare Grep for compilation:</para>
    2929
    30 <screen os="b"><userinput>./configure --prefix=/usr --bindir=/bin --without-included-regex</userinput></screen>
     30<screen os="b"><userinput>./configure --prefix=/usr --bindir=/bin</userinput></screen>
    3131
    3232    <para os="c">Compile the package:</para>
     
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">To test the results, issue:
    37     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3839
    3940    <para os="f">Install the package:</para>
  • BOOK/final-system/common/groff.xml

    r1c9985f r026bb5d  
    6969        roff2pdf, roff2ps, roff2text, roff2x, soelim, tbl, tfmtodit, troff,
    7070        and zsoelim (link to soelim)</seg>
    71         <seg>/usr/lib/groff, /usr/share/doc/groff, /usr/share/groff</seg>
     71        <seg>/usr/lib/groff, /usr/share/doc/groff-&groff-version;, /usr/share/groff</seg>
    7272      </seglistitem>
    7373    </segmentedlist>
  • BOOK/final-system/common/gzip.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">To test the results, issue: <command>make check</command>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3739
    3840    <para os="f">Install the package:</para>
  • BOOK/final-system/common/iana-etc.xml

    r1c9985f r026bb5d  
    2525  <sect2 role="installation">
    2626    <title>Installation of Iana-Etc</title>
     27
     28    <note os="p1">
     29      <para>This package has the option of downloading updated data when internet access is available. If /etc/resolv.conf has a nameserver entry and internet access is available at this step, then apply the IANA get patch and get the updated data:
     30<screen><command>patch -Np1 -i ../&iana-etc-get_fix-patch;</command>
     31<command>make get</command></screen>
     32Do not apply the following patch.</para>
     33    </note>
     34
     35    <para os="p2">The following patch updates the services and protocol files:</para>
     36
     37<screen os="p3"><userinput>patch -Np1 -i ../&iana-etc-numbers_update-patch;</userinput></screen>
    2738
    2839    <para os="a">The following command converts the raw data provided by IANA into
  • BOOK/final-system/common/iproute2.xml

    r1c9985f r026bb5d  
    2929    program, which is dependent on Berkeley DB.  Because <command>arpd</command>
    3030    is not a very common requirement on a base Linux system, remove the
    31     dependency on Berkeley DB by applying the <command>sed</command> command
     31    dependency on Berkeley DB by using the commands
    3232    below. If the <command>arpd</command> binary is needed, instructions for
    3333    compiling Berkeley DB can be found in CBLFS at <ulink
    3434    url="&cblfs-root;index.php/Berkeley_DB"/>.</para>
    3535
    36 <screen os="s2"><userinput>sed -i '/^TARGETS/s@arpd@@g' misc/Makefile</userinput></screen>
     36<screen os="s2"><userinput>sed -i '/^TARGETS/s@arpd@@g' misc/Makefile
     37sed -i '/ARPD/d' Makefile
     38rm -v man/man8/arpd.8</userinput></screen>
     39
     40    <para os="f1">Remove unused libnl headers:</para>
     41   
     42    <screen os="f2"><userinput>sed -i '/netlink\//d' ip/ipl2tp.c</userinput></screen>
    3743
    3844    <para os="a">Compile the package:</para>
     
    8389
    8490      <seglistitem>
    85         <seg>ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat, nstat,
    86         routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
     91        <seg>bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat,
     92        nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
    8793        and tc</seg>
    8894        <seg>/etc/iproute2, /lib/tc, /usr/lib/tc, /usr/share/doc/iproute2</seg>
     
    94100      <?dbfo list-presentation="list"?>
    95101      <?dbhtml list-presentation="table"?>
     102
     103      <varlistentry id="bridge">
     104        <term><command>bridge</command></term>
     105        <listitem>
     106          <para>Configures network bridges</para>
     107          <indexterm zone="ch-system-iproute2 bridge">
     108            <primary sortas="b-bridge">bridge</primary>
     109          </indexterm>
     110        </listitem>
     111      </varlistentry>
    96112
    97113      <varlistentry id="ctstat">
  • BOOK/final-system/common/iputils.xml

    r1c9985f r026bb5d  
    3030<screen os="p2"><userinput>patch -Np1 -i ../&iputils-fixes-patch;</userinput></screen>
    3131
    32     <para os="p3">The following patch contains pregenerated documentation for
    33     IPutils:</para>
    34 
    35 <screen os="p4"><userinput>patch -Np1 -i ../&iputils-doc-patch;</userinput></screen>
    36 
    3732    <para os="a">Compile the package:</para>
    3833
    39 <screen os="b"><userinput>make IPV4_TARGETS="tracepath ping rdisc clockdiff" \
     34<screen os="b"><userinput>make USE_CAP=no \
     35    IPV4_TARGETS="tracepath ping clockdiff rdisc" \
    4036    IPV6_TARGETS="tracepath6 traceroute6"</userinput></screen>
    4137
  • BOOK/final-system/common/kbd.xml

    r1c9985f r026bb5d  
    2626    <title>Installation of Kbd</title>
    2727
    28     <para os="p1">Apply the following patch to fix a typo in es.po:</para>
    29 
    30     <screen os="p2"><userinput>patch -Np1 -i ../&kbd-espo-patch;</userinput></screen>
    31 
    3228    <para os="a">Prepare Kbd for compilation:</para>
    3329
    34 <screen os="b"><userinput>./configure --prefix=/usr</userinput></screen>
     30<screen os="b"><userinput>PKG_CONFIG_PATH="/tools/lib/pkgconfig" \
     31    ./configure --prefix=/usr --disable-vlock --enable-optional-progs</userinput></screen>
    3532
    3633    <para os="c">Compile the package:</para>
     
    4946    stages of booting, those binaries need to be on the root partition:</para>
    5047
    51 <screen os="i"><userinput>mv -v /usr/bin/{kbd_mode,dumpkeys,loadkeys,openvt,setfont, setvtrgb} /bin</userinput></screen>
     48<screen os="i"><userinput>mv -v /usr/bin/{kbd_mode,dumpkeys,loadkeys,openvt,setfont,setvtrgb} /bin</userinput></screen>
    5249
    5350  </sect2>
  • BOOK/final-system/common/kmod.xml

    r1c9985f r026bb5d  
    66]>
    77
    8 <sect1 id="ch-system-module-init-tools" role="wrap">
    9   <?dbhtml filename="module-init-tools.html"?>
     8<sect1 id="ch-system-kmod" role="wrap">
     9  <?dbhtml filename="kmod.html"?>
    1010
    11   <title>Module-Init-Tools-&module-init-tools-version;</title>
     11  <title>Kmod-&kmod-version;</title>
    1212
    13   <indexterm zone="ch-system-module-init-tools">
    14     <primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary>
     13  <indexterm zone="ch-system-kmod">
     14    <primary sortas="a-Kmod">Kmod</primary>
    1515  </indexterm>
    1616
     
    1818    <title/>
    1919
    20     <para>The Module-Init-Tools package contains programs for handling kernel
    21     modules in Linux kernels greater than or equal to version 2.5.47.</para>
     20    <para>The Kmod package contains programs for loading, inserting
     21      and removing kernel modules for Linux. Kmod replaces the
     22      Module-Init-tools package.</para>
    2223
    2324  </sect2>
    2425
    2526  <sect2 role="installation">
    26     <title>Installation of Module-Init-Tools</title>
     27    <title>Installation of Kmod</title>
    2728
    28     <para os="c">Issue the following commands to perform the tests</para>
     29    <para os="a">Prepare Kmod for compilation:</para>
    2930
    30 <screen os="d"><userinput>sed -i "s/\(make\)\( all\)/\1 DOCBOOKTOMAN=true\2/" tests/runtests &amp;&amp;
    31 ./tests/runtests</userinput></screen>
     31<screen os="b"><userinput>./configure --prefix=/usr \
     32    --bindir=/bin --sysconfdir=/etc \
     33    --with-rootlibdir=/lib --disable-manpages \
     34    --with-zlib --with-xz</userinput></screen>
    3235
    33     <para os="e">Prepare Module-Init-Tools for compilation:</para>
    34 
    35 <screen os="f"><userinput>./configure --prefix=/usr \
    36     --bindir=/bin --sbindir=/sbin \
    37     --enable-zlib-dynamic</userinput></screen>
    38 
    39     <variablelist os="g">
     36    <variablelist os="c">
    4037      <title>The meaning of the configure option:</title>
    4138
    4239      <varlistentry>
    43         <term><parameter>--enable-zlib-dynamic</parameter></term>
     40        <term><parameter>--with-rootlibdir=/lib</parameter></term>
    4441        <listitem>
    45           <para>This allows the Module-Init-Tools package to handle compressed
    46           kernel modules.</para>
     42          <para>Install location for shared libraries.</para>
     43        </listitem>
     44      </varlistentry>
     45
     46      <varlistentry>
     47        <term><parameter>--with-zlib --with-xz</parameter></term>
     48        <listitem>
     49          <para>This allows the Kmod package to handle zlib and XZ
     50            compressed kernel modules.</para>
    4751        </listitem>
    4852      </varlistentry>
     
    5054    </variablelist>
    5155
    52     <para os="h">Compile the package:</para>
     56    <para os="d">Compile the package:</para>
    5357
    54 <screen os="i"><userinput>make DOCBOOKTOMAN=true</userinput></screen>
     58<screen os="e"><userinput>make</userinput></screen>
    5559
    56     <para os="j">Install the package:</para>
     60    <para os="f">To test the results, issue:</para>
    5761
    58 <screen os="k"><userinput>make install</userinput></screen>
     62<screen os="f2"><userinput remap="test">make check</userinput></screen>
    5963
     64    <para os="g">Install the package:</para>
     65
     66<screen os="h"><userinput>make install
     67make -C man install</userinput></screen>
     68
     69    <para os="i">Create symbolic links for programs that expect Module-Init-Tools.</para>
     70
     71<screen os="j"><userinput>ln -sfv kmod /bin/lsmod
     72ln -sfv ../bin/kmod /sbin/depmod
     73ln -sfv ../bin/kmod /sbin/insmod
     74ln -sfv ../bin/kmod /sbin/modprobe
     75ln -sfv ../bin/kmod /sbin/modinfo
     76ln -sfv ../bin/kmod /sbin/rmmod</userinput></screen>
     77 
    6078  </sect2>
    6179
    62   <sect2 id="contents-module-init-tools" role="content">
    63     <title>Contents of Module-Init-Tools</title>
     80  <sect2 id="contents-kmod" role="content">
     81    <title>Contents of Kmod</title>
    6482
    6583    <segmentedlist>
     
    6785
    6886      <seglistitem>
    69         <seg>depmod, insmod, insmod.static, lsmod, modinfo, modprobe, and
     87        <seg>depmod, insmod, kmod, lsmod, modinfo, modprobe, and
    7088        rmmod</seg>
    7189      </seglistitem>
     
    84102          <command>modprobe</command> to automatically load the required
    85103          modules</para>
    86           <indexterm zone="ch-system-module-init-tools depmod">
     104          <indexterm zone="ch-system-kmod depmod">
    87105            <primary sortas="b-depmod">depmod</primary>
    88106          </indexterm>
     
    94112        <listitem>
    95113          <para>Installs a loadable module in the running kernel</para>
    96           <indexterm zone="ch-system-module-init-tools insmod">
     114          <indexterm zone="ch-system-kmod insmod">
    97115            <primary sortas="b-insmod">insmod</primary>
    98116          </indexterm>
     
    100118      </varlistentry>
    101119
    102       <varlistentry id="insmod.static">
    103         <term><command>insmod.static</command></term>
     120      <varlistentry id="kmod">
     121        <term><command>kmod</command></term>
    104122        <listitem>
    105           <para>A statically compiled version of <command>insmod</command></para>
    106           <indexterm zone="ch-system-module-init-tools insmod.static">
    107             <primary sortas="b-insmod.static">insmod.static</primary>
     123          <para>Loads and unloads kernel modules</para>
     124          <indexterm zone="ch-system-kmod kmod">
     125            <primary sortas="b-kmod">kmod</primary>
    108126          </indexterm>
    109127        </listitem>
     
    114132        <listitem>
    115133          <para>Lists currently loaded modules</para>
    116           <indexterm zone="ch-system-module-init-tools lsmod">
     134          <indexterm zone="ch-system-kmod lsmod">
    117135            <primary sortas="b-lsmod">lsmod</primary>
    118136          </indexterm>
     
    125143          <para>Examines an object file associated with a kernel module and
    126144          displays any information that it can glean</para>
    127           <indexterm zone="ch-system-module-init-tools modinfo">
     145          <indexterm zone="ch-system-kmod modinfo">
    128146            <primary sortas="b-modinfo">modinfo</primary>
    129147          </indexterm>
     
    136154          <para>Uses a dependency file, created by <command>depmod</command>,
    137155          to automatically load relevant modules</para>
    138           <indexterm zone="ch-system-module-init-tools modprobe">
     156          <indexterm zone="ch-system-kmod modprobe">
    139157            <primary sortas="b-modprobe">modprobe</primary>
    140158          </indexterm>
     
    146164        <listitem>
    147165          <para>Unloads modules from the running kernel</para>
    148           <indexterm zone="ch-system-module-init-tools rmmod">
     166          <indexterm zone="ch-system-kmod rmmod">
    149167            <primary sortas="b-rmmod">rmmod</primary>
    150168          </indexterm>
  • BOOK/final-system/common/libee.xml

    r1c9985f r026bb5d  
    3131    <para os="c">Compile the package:</para>
    3232
     33<note os="n1">
     34    <para>Libee will fail to compile if using multiple jobs with make. Append "<command>-j 1</command>" to the following make command:</para>
     35</note>
     36
    3337<screen os="d"><userinput>make</userinput></screen>
    3438
     
    4549
    4650    <segmentedlist>
    47       <segtitle>Installed Programs</segtitle>
     51      <segtitle>Installed Program</segtitle>
    4852      <segtitle>Installed libraries</segtitle>
     53      <segtitle>Installed directory</segtitle>
    4954
    5055      <seglistitem>
    51         <seg>convert</seg>
     56        <seg>libee-convert</seg>
    5257        <seg>libee.[a,so]</seg>
     58        <seg>/usr/include/libee</seg>
    5359      </seglistitem>
    5460    </segmentedlist>
     
    5965      <?dbhtml list-presentation="table"?>
    6066
    61       <varlistentry id="convert">
    62         <term><command>convert</command></term>
     67      <varlistentry id="libee-convert">
     68        <term><command>libee-convert</command></term>
    6369        <listitem>
    6470          <para>todo</para>
    65           <indexterm zone="ch-system-libee convert">
    66             <primary sortas="b-convert">convert</primary>
     71          <indexterm zone="ch-system-libee libee-convert">
     72            <primary sortas="b-libee-convert">libee-convert</primary>
    6773          </indexterm>
    6874        </listitem>
  • BOOK/final-system/common/libtool.xml

    r1c9985f r026bb5d  
    3535<screen os="d"><userinput>make</userinput></screen>
    3636
    37     <para os="e">To test the results, issue:
    38     <userinput>make check</userinput>.</para>
     37    <para os="e">To test the results, issue:</para>
     38
     39<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3940
    4041    <para os="f">Install the package:</para>
  • BOOK/final-system/common/linux-headers.xml

    r1c9985f r026bb5d  
    3232<screen os="c"><userinput>make mrproper
    3333make headers_check
    34 make INSTALL_HDR_PATH=dest headers_install
    35 cp -rv dest/include/* /usr/include
     34make INSTALL_HDR_PATH=/usr headers_install
    3635find /usr/include -name .install -or -name ..install.cmd | xargs rm -fv</userinput></screen>
    3736
     
    5554
    5655      <varlistentry os="d3">
    57         <term><parameter>make INSTALL_HDR_PATH=dest headers_install</parameter></term>
     56        <term><parameter>make INSTALL_HDR_PATH=/usr headers_install</parameter></term>
    5857        <listitem>
    59           <para>Normally the headers_install target removes the entire
    60           destination directory (default
    61           <filename class="directory">/usr/include</filename>) before
    62           installing the headers. To prevent this, we tell the kernel to
    63           install the headers to a directory inside the source dir.</para>
     58          <para>This will install the kernel headers into
     59          <filename class="directory">/usr/include</filename>.</para>
     60        </listitem>
     61      </varlistentry>
     62
     63      <varlistentry os="d4">
     64        <term><parameter>find /usr/include -name .install -or -name ..install.cmd | xargs rm -fv</parameter></term>
     65        <listitem>
     66          <para>Removes a number of unneeded debugging files that were installed.</para>
    6467        </listitem>
    6568      </varlistentry>
     
    7780
    7881      <seglistitem>
    79         <seg>/usr/include/{asm,asm-generic,drm,linux,mtd,rdma,sound,video}/*.h</seg>
     82        <seg>/usr/include/{asm,asm-generic,drm,linux,mtd,rdma,scsi,sound,video,xen}/*.h</seg>
    8083        <seg>/usr/include/asm, /usr/include/asm-generic, /usr/include/drm,
    8184        /usr/include/linux, /usr/include/mtd, /usr/include/rdma,
    82         /usr/include/scsi, /usr/include/sound, /usr/include/video, /usr/include/xen</seg>
     85        /usr/include/scsi, /usr/include/sound, /usr/include/uapi,
     86        /usr/include/video, /usr/include/xen</seg>
    8387      </seglistitem>
    8488    </segmentedlist>
  • BOOK/final-system/common/make.xml

    r1c9985f r026bb5d  
    3333<screen os="d"><userinput>make</userinput></screen>
    3434
    35     <para os="e">To test the results, issue:
    36     <userinput>make check</userinput>.</para>
     35    <para os="e">To test the results, issue:</para>
     36
     37<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3738
    3839    <para os="f">Install the package:</para>
  • BOOK/final-system/common/mpc.xml

    r1c9985f r026bb5d  
    3030<screen os="b"><userinput>CC="gcc -isystem /usr/include" \
    3131LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
    32   EGREP="grep -E" ./configure --prefix=/usr</userinput></screen>
     32  ./configure --prefix=/usr</userinput></screen>
    3333
    3434    <para os="c">Compile the package:</para>
     
    4343    <para os="f">Test the results:</para>
    4444
    45 <screen os="g"><userinput>make check</userinput></screen>
     45<screen os="g"><userinput remap="test">make check</userinput></screen>
    4646
    4747    <para os="h">Install the package:</para>
  • BOOK/final-system/common/mpfr.xml

    r1c9985f r026bb5d  
    2626    <title>Installation of MPFR</title>
    2727
     28    <para os="p1">Apply a patch with upstream fixes:</para>
     29
     30<screen os="p2"><userinput>patch -Np1 -i ../&mpfr-fixes-patch;</userinput></screen>
     31
    2832    <para os="a">Prepare MPFR for compilation:</para>
    2933
     
    4448    <para os="f">Test the results:</para>
    4549
    46 <screen os="g"><userinput>make check</userinput></screen>
     50<screen os="g"><userinput remap="test">make check</userinput></screen>
    4751
    4852    <para os="h">Install the package:</para>
  • BOOK/final-system/common/ncurses.xml

    r1c9985f r026bb5d  
    3535<screen os="b"><userinput>./configure --prefix=/usr --libdir=/lib \
    3636    --with-shared --without-debug --enable-widec \
    37     --with-manpage-format=normal</userinput></screen>
     37    --with-manpage-format=normal \
     38    --with-default-terminfo-dir=/usr/share/terminfo</userinput></screen>
    3839
    3940    <para os="c">Compile the package:</para>
     
    4142<screen os="d"><userinput>make</userinput></screen>
    4243
    43     <para os="e">This package does not come with a test suite.</para>
     44    <para os="e">This package has a test suite, and can be ran after the
     45    package is installed. The tests are in the
     46    <filename class="directory">test/</filename> directory. See the
     47    <filename>README</filename> file in that directory for details.</para>
    4448
    4549    <para os="f">Install the package:</para>
  • BOOK/final-system/common/patch.xml

    r1c9985f r026bb5d  
    3535<screen os="d"><userinput>make</userinput></screen>
    3636
    37     <para os="e">This package does not come with a test suite.</para>
     37    <para os="e">To test the results, issue:</para>
     38
     39<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3840
    3941    <para os="f">Install the package:</para>
     
    7779
    7880</sect1>
     81
  • BOOK/final-system/common/perl.xml

    r1c9985f r026bb5d  
    3939      loopback device as well as set a hostname for some of the tests:</para>
    4040
    41       <screen><userinput>ip link set lo up
     41  <screen os="a01"><userinput remap="test">ip link set lo up
    4242hostname clfs</userinput></screen>
    4343    </note>
    4444
    45     <para os="a01">Before starting to configure, create a basic
     45    <para os="a02">Before starting to configure, create a basic
    4646    <filename>/etc/hosts</filename> file which will be referenced by one
    4747    of Perl's configuration files as well as used by the testsuite:</para>
    4848
    49 <screen os="a02"><userinput>echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
     49<screen os="a03"><userinput remap="test">echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
    5050
    5151    <para os="a">To have full control over the way Perl is set up, you can
     
    101101<screen os="e"><userinput>make</userinput></screen>
    102102
    103     <para os="h">To test the results, issue:
    104     <userinput>make test</userinput>.</para>
     103    <para os="h">To test the results, issue:</para>
     104
     105<screen os="h2"><userinput remap="test">make test</userinput></screen>
    105106
    106107    <para os="j">Install the package:</para>
     
    120121      <seglistitem>
    121122        <seg>a2p, c2ph, config_data, corelist, cpan, cpan2dist, cpanp,
    122         cpanp-run-perl, dprofpp, enc2xs, find2perl, h2ph, h2xs, instmodsh,
     123        cpanp-run-perl, enc2xs, find2perl, h2ph, h2xs, instmodsh, json_pp,
    123124        libnetcfg, perl, perl&perl-version; (link to perl), perlbug,
    124125        perldoc, perlivp, perlthanks (link to perlbug), piconv, pl2pm, pod2html,
    125126        pod2latex, pod2man, pod2text, pod2usage, podchecker, podselect, prove,
    126         psed (link to s2p), pstruct (link to c2ph), ptar, ptardiff, s2p, shasum,
    127         splain, and xsubpp</seg>
     127        psed (link to s2p), pstruct (link to c2ph), ptar, ptardiff, ptargrep,
     128        s2p, shasum, splain, xsubpp, and zipdetails</seg>
    128129        <seg>Several hundred which cannot all be listed here</seg>
    129130        <seg>/usr/lib/perl5</seg>
     
    213214          <indexterm zone="ch-system-perl cpanp-run-perl">
    214215            <primary sortas="b-cpanp-run-perl">cpanp-run-perl</primary>
    215           </indexterm>
    216         </listitem>
    217       </varlistentry>
    218 
    219       <varlistentry id="dprofpp">
    220         <term><command>dprofpp</command></term>
    221         <listitem>
    222           <para>Displays Perl profile data</para>
    223           <indexterm zone="ch-system-perl dprofpp">
    224             <primary sortas="b-dprofpp">dprofpp</primary>
    225216          </indexterm>
    226217        </listitem>
     
    282273      </varlistentry>
    283274
     275      <varlistentry id="json_pp">
     276        <term><command>json_pp</command></term>
     277        <listitem>
     278          <para>Converts data between certain input and output formats</para>
     279          <indexterm zone="ch-system-perl json_pp">
     280            <primary sortas="b-json_pp">json_pp</primary>
     281          </indexterm>
     282        </listitem>
     283      </varlistentry>
     284
    284285      <varlistentry id="libnetcfg">
    285286        <term><command>libnetcfg</command></term>
     
    505506      </varlistentry>
    506507
     508      <varlistentry id="ptargrep">
     509        <term><command>ptargrep</command></term>
     510        <listitem>
     511          <para>A Perl program that applies pattern matching to the contents
     512          of files in a tar archive</para>
     513          <indexterm zone="ch-system-perl ptargrep">
     514            <primary sortas="b-ptargrep">ptargrep</primary>
     515          </indexterm>
     516        </listitem>
     517      </varlistentry>
     518
    507519      <varlistentry id="s2p">
    508520        <term><command>s2p</command></term>
     
    545557      </varlistentry>
    546558
     559      <varlistentry id="zipdetails">
     560        <term><command>zipdetails</command></term>
     561        <listitem>
     562          <para>Displays details about the internal structure of a Zip file</para>
     563          <indexterm zone="ch-system-perl zipdetails">
     564            <primary sortas="b-zipdetails">zipdetails</primary>
     565          </indexterm>
     566        </listitem>
     567      </varlistentry>
     568
    547569    </variablelist>
    548570
  • BOOK/final-system/common/pkg-config-lite.xml

    r1c9985f r026bb5d  
    66]>
    77
    8 <sect1 id="ch-system-pkg-config" role="wrap">
    9   <?dbhtml filename="pkg-config.html"?>
     8<sect1 id="ch-system-pkg-config-lite" role="wrap">
     9  <?dbhtml filename="pkg-config-lite.html"?>
    1010
    11   <title>Pkg-config-&pkg-config-version;</title>
     11  <title>Pkg-config-lite-&pkg-config-lite-version;</title>
    1212
    13   <indexterm zone="ch-system-pkg-config">
    14     <primary sortas="a-Pkg-config">Pkg-config</primary>
     13  <indexterm zone="ch-system-pkg-config-lite">
     14    <primary sortas="a-Pkg-config-lite">Pkg-config-lite</primary>
    1515  </indexterm>
    1616
     
    1818    <title/>
    1919
    20     <para>Pkg-config is a tool to help you insert the correct compiler options
     20    <para>Pkg-config-lite is a tool to help you insert the correct compiler options
    2121    on the command line when compiling applications and libraries.</para>
    2222
     
    2424
    2525  <sect2 role="installation">
    26     <title>Installation of Pkg-config</title>
     26    <title>Installation of Pkg-config-lite</title>
    2727
    28     <para os="a">Prepare Pkg-config for compilation:</para>
     28    <para os="a">Prepare Pkg-config-lite for compilation:</para>
    2929
    30 <screen os="b"><userinput>GLIB_CFLAGS="-I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include" \
    31     GLIB_LIBS="-lglib-2.0" \
    32     ./configure --prefix=/usr</userinput></screen>
    33 
    34     <variablelist os="bb">
    35       <title>The meaning of the new configure option:</title>
    36 
    37       <varlistentry>
    38         <term><parameter>GLIB_CFLAGS="-I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include"</parameter></term>
    39         <term><parameter>GLIB_LIBS="-lglib-2.0"</parameter></term>
    40         <listitem>
    41           <para>Pkg-config no longer comes with Glib and because Pkg-config
    42         has not been installed itself it needs to be told where Glib is.</para>
    43         </listitem>
    44       </varlistentry>
    45     </variablelist>
     30<screen os="b"><userinput>./configure --prefix=/usr</userinput></screen>
    4631
    4732    <para os="c">Compile the package:</para>
     
    4934<screen os="d"><userinput>make</userinput></screen>
    5035
    51     <para os="e">To test the results, issue:
    52     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    5339
    5440    <para os="f">Install the package:</para>
     
    5844  </sect2>
    5945
    60   <sect2 id="contents-pkg-config" role="content">
    61     <title>Contents of Pkg-config</title>
     46  <sect2 id="contents-pkg-config-lite" role="content">
     47    <title>Contents of Pkg-config-lite</title>
    6248
    6349    <segmentedlist>
     
    7662      <?dbhtml list-presentation="table"?>
    7763
    78       <varlistentry id="pkg-config">
     64      <varlistentry id="pkg-config-lite">
    7965        <term><command>pkg-config</command></term>
    8066        <listitem>
     
    8268          information about installed libraries in the system. It is typically
    8369          used to compile and link against one or more libraries.</para>
    84           <indexterm zone="ch-system-pkg-config pkg-config">
    85             <primary sortas="b-pkg-config">pkg-config</primary>
     70          <indexterm zone="ch-system-pkg-config-lite pkg-config-lite">
     71            <primary sortas="b-pkg-config-lite">pkg-config</primary>
    8672          </indexterm>
    8773        </listitem>
  • BOOK/final-system/common/procps.xml

    r1c9985f r026bb5d  
    4848    <para os="d">Install the package:</para>
    4949
    50 <screen os="e"><userinput>make install</userinput></screen>
     50<screen os="e"><userinput>make SKIP='/bin/kill /usr/share/man/man1/kill.1' install</userinput></screen>
    5151
    5252  </sect2>
     
    6060
    6161      <seglistitem>
    62         <seg>free, kill, pgrep, pkill, pmap, ps, pwdx, skill, slabtop, snice, sysctl,
     62        <seg>free, pgrep, pkill, pmap, ps, pwdx, skill, slabtop, snice, sysctl,
    6363        tload, top, uptime, vmstat, w, and watch</seg>
    6464        <seg>libproc.so</seg>
     
    7878          <indexterm zone="ch-system-procps free">
    7979            <primary sortas="b-free">free</primary>
    80           </indexterm>
    81         </listitem>
    82       </varlistentry>
    83 
    84       <varlistentry id="kill">
    85         <term><command>kill</command></term>
    86         <listitem>
    87           <para>Sends signals to processes</para>
    88           <indexterm zone="ch-system-procps kill">
    89             <primary sortas="b-kill">kill</primary>
    9080          </indexterm>
    9181        </listitem>
  • BOOK/final-system/common/psmisc.xml

    r1c9985f r026bb5d  
    7979
    8080      <seglistitem>
    81         <seg>fuser, killall, peekfd, pstree, and pstree.x11 (link to pstree)</seg>
     81        <seg>fuser, killall, peekfd, prtstat, pstree, and pstree.x11
     82        (link to pstree)</seg>
    8283      </seglistitem>
    8384    </segmentedlist>
     
    120121      </varlistentry>
    121122
     123      <varlistentry id="prtstat">
     124        <term><command>prtstat</command></term>
     125        <listitem>
     126          <para>Prints information about a process</para>
     127          <indexterm zone="ch-system-psmisc prtstat">
     128            <primary sortas="b-prtstat">prtstat</primary>
     129          </indexterm>
     130        </listitem>
     131      </varlistentry>
     132
    122133      <varlistentry id="pstree">
    123134        <term><command>pstree</command></term>
  • BOOK/final-system/common/rsyslog.xml

    r1c9985f r026bb5d  
    3434<screen os="d"><userinput>make</userinput></screen>
    3535
    36     <para os="e">This package does not come with a test suite.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    3739
    3840    <para os="f">Install the package:</para>
  • BOOK/final-system/common/sed.xml

    r1c9985f r026bb5d  
    3737<screen os="f"><userinput>make html</userinput></screen>
    3838
    39     <para os="g">To test the results, issue:
    40     <userinput>make check</userinput>.</para>
     39    <para os="g">To test the results, issue:</para>
     40
     41<screen os="g2"><userinput remap="test">make check</userinput></screen>
    4142
    4243    <para os="h">Install the package:</para>
  • BOOK/final-system/common/shadow.xml

    r1c9985f r026bb5d  
    3434    </note>
    3535
    36     <para os="f1">Fix an issue with the Russian man pages:</para>
    37 
    38     <screen os="f2"><userinput>sed -i 's/man_MANS = $(man_nopam) /man_MANS = /' man/ru/Makefile.in</userinput></screen>
    39 
    40     <para os="b">Prepare Shadow for compilation:</para>
    41 
    42 <screen os="c"><userinput>./configure --sysconfdir=/etc</userinput></screen>
    43 
    44 <para os="d">The meaning of the configure options:</para>
    45 
    46   <variablelist os="e">
     36
     37    <para os="b">Disable the installation of the <command>groups</command> and
     38    <command>nologin</command> programs and their man pages, as better versions
     39    of these programs are provided by Coreutils and Util-linux:</para>
     40
     41<screen os="c"><userinput>sed -i src/Makefile.in \
     42  -e 's/groups$(EXEEXT) //' -e 's/= nologin$(EXEEXT)/= /'
     43find man -name Makefile.in -exec sed -i \
     44  -e 's/man1\/groups\.1 //' -e 's/man8\/nologin\.8 //' '{}' \;</userinput></screen>
     45
     46    <para os="d">Prepare Shadow for compilation:</para>
     47
     48<screen os="e"><userinput>./configure --sysconfdir=/etc</userinput></screen>
     49
     50<para os="f">The meaning of the configure options:</para>
     51
     52  <variablelist os="g">
    4753    <varlistentry>
    4854      <term><parameter>--sysconfdir=/etc</parameter></term>
     
    5157      <filename class="directory">/usr/etc</filename>.</para></listitem>
    5258    </varlistentry>
     59   
    5360  </variablelist>
    5461
    55     <para os="f">Disable the installation of the <command>groups</command>
    56     program and its man pages, as Coreutils provides a better version:</para>
    57 
    58 <screen os="g"><userinput>sed -i 's/groups$(EXEEXT) //' src/Makefile
    59 find man -name Makefile -exec sed -i '/groups.1.xml/d' '{}' \;
    60 find man -name Makefile -exec sed -i 's/groups.1 //' '{}' \;</userinput></screen>
    6162
    6263    <para os="h">Compile the package:</para>
     
    7273    <para os="m" id="shadow-login_defs">Instead of using the default
    7374    <emphasis>crypt</emphasis> method, use the more secure
    74     <emphasis>MD5</emphasis> method of password encryption, which also allows
     75    <emphasis>SHA512</emphasis> method of password encryption, which also allows
    7576    passwords longer than 8 characters. It is also necessary to change the
    7677    obsolete <filename class="directory">/var/spool/mail</filename> location
     
    8586
    8687<screen os="s"><userinput>sed -i /etc/login.defs \
    87     -e 's@#\(ENCRYPT_METHOD \).*@\1MD5@' \
     88    -e 's@#\(ENCRYPT_METHOD \).*@\1SHA512@' \
    8889    -e 's@/var/spool/mail@/var/mail@'</userinput></screen>
    8990
     
    155156        <seg>chage, chfn, chpasswd, chgpasswd, chsh, expiry, faillog, gpasswd,
    156157        groupadd, groupdel, groupmems, groupmod, grpck, grpconv, grpunconv,
    157         lastlog, login, logoutd, newgrp, newusers, nologin, passwd, pwck,
     158        lastlog, login, logoutd, newgrp, newusers, passwd, pwck,
    158159        pwconv, pwunconv, sg (link to newgrp), su, useradd, userdel, usermod,
    159160        vigr (link to vipw), and vipw</seg>
     
    380381      </varlistentry>
    381382
    382       <varlistentry id="nologin">
    383         <term><command>nologin</command></term>
    384         <listitem>
    385           <para>Displays a message that an account is not available. Designed
    386           to be used as the default shell for accounts that have been
    387           disabled</para>
    388           <indexterm zone="ch-system-shadow nologin">
    389             <primary sortas="b-nologin">nologin</primary>
    390           </indexterm>
    391         </listitem>
    392       </varlistentry>
    393 
    394383      <varlistentry id="passwd">
    395384        <term><command>passwd</command></term>
  • BOOK/final-system/common/sysvinit.xml

    r1c9985f r026bb5d  
    2525    <title>Installation of Sysvinit</title>
    2626
    27     <para os="c">Compile the package:</para>
     27<para os ="a">Apply a sed which disables last, mesg, mountpoint, sulogin,
     28utmpdump, and wall from being built and installed as they are provided by
     29Util-linux:</para>
     30
     31<screen os="b"><userinput>sed -i -e 's/\ sulogin[^ ]*//' \
     32    -e '/utmpdump/d' -e '/mountpoint/d' -e '/mesg/d' src/Makefile</userinput></screen>
     33
     34<para os ="c">Compile the package:</para>
    2835
    2936<screen os="d"><userinput>make -C src clobber
     
    7683
    7784<screen><userinput>cat &gt;&gt; /etc/inittab &lt;&lt; "EOF"
    78 <literal>1:2345:respawn:/sbin/agetty -I '\033(K' tty1 9600
    79 2:2345:respawn:/sbin/agetty -I '\033(K' tty2 9600
    80 3:2345:respawn:/sbin/agetty -I '\033(K' tty3 9600
    81 4:2345:respawn:/sbin/agetty -I '\033(K' tty4 9600
    82 5:2345:respawn:/sbin/agetty -I '\033(K' tty5 9600
    83 6:2345:respawn:/sbin/agetty -I '\033(K' tty6 9600
     85<literal>1:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty1 9600
     862:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty2 9600
     873:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty3 9600
     884:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty4 9600
     895:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty5 9600
     906:2345:respawn:/sbin/agetty --noclear -I '\033(K' tty6 9600
    8491</literal>
    8592EOF</userinput></screen>
     
    8996
    9097<screen><userinput>cat &gt;&gt; /etc/inittab &lt;&lt; "EOF"
    91 <literal>c0:12345:respawn:/sbin/agetty 115200 ttyS0 vt100
     98<literal>c0:12345:respawn:/sbin/agetty --noclear 115200 ttyS0 vt100
    9299</literal>
    93100EOF</userinput></screen>
     
    118125
    119126      <seglistitem>
    120         <seg>bootlogd, halt, init, killall5, last, lastb (link to last), mesg,
    121         mountpoint, pidof (link to killall5), poweroff (link to halt),
    122         reboot (link to halt), runlevel, shutdown, sulogin,
    123         telinit (link to init), utmpdump, and wall</seg>
     127        <seg>bootlogd, fstab-decode, halt, init, killall5, pidof (link to
     128        killall5), poweroff (link to halt), reboot (link to halt), runlevel,
     129        shutdown, and telinit (link to init)</seg>
    124130      </seglistitem>
    125131    </segmentedlist>
     
    136142          <indexterm zone="ch-system-sysvinit bootlogd">
    137143            <primary sortas="b-bootlogd">bootlogd</primary>
     144          </indexterm>
     145        </listitem>
     146      </varlistentry>
     147
     148      <varlistentry id="fstab-decode">
     149        <term><command>fstab-decode</command></term>
     150        <listitem>
     151          <para>Runs a command with fstab-encoded arguments</para>
     152          <indexterm zone="ch-system-sysvinit fstab-decode">
     153            <primary sortas="b-fstab-decode">fstab-decode</primary>
    138154          </indexterm>
    139155        </listitem>
     
    178194      </varlistentry>
    179195
    180       <varlistentry id="last">
    181         <term><command>last</command></term>
    182         <listitem>
    183           <para>Shows which users last logged in (and out), searching back
    184           through the <filename>/var/log/wtmp</filename> file; it also shows
    185           system boots, shutdowns, and run-level changes</para>
    186           <indexterm zone="ch-system-sysvinit last">
    187             <primary sortas="b-last">last</primary>
    188           </indexterm>
    189         </listitem>
    190       </varlistentry>
    191 
    192       <varlistentry id="lastb">
    193         <term><command>lastb</command></term>
    194         <listitem>
    195           <para>Shows the failed login attempts, as logged in
    196           <filename>/var/log/btmp</filename></para>
    197           <indexterm zone="ch-system-sysvinit lastb">
    198             <primary sortas="b-lastb">lastb</primary>
    199           </indexterm>
    200         </listitem>
    201       </varlistentry>
    202 
    203       <varlistentry id="mesg">
    204         <term><command>mesg</command></term>
    205         <listitem>
    206           <para>Controls whether other users can send messages to the current
    207           user's terminal</para>
    208           <indexterm zone="ch-system-sysvinit mesg">
    209             <primary sortas="b-mesg">mesg</primary>
    210           </indexterm>
    211         </listitem>
    212       </varlistentry>
    213 
    214       <varlistentry id="mountpoint">
    215         <term><command>mountpoint</command></term>
    216         <listitem>
    217           <para>Tells you whether or not a directory is a mount point.</para>
    218           <indexterm zone="ch-system-sysvinit mountpoint">
    219             <primary sortas="b-mountpoint">mountpoint</primary>
    220           </indexterm>
    221         </listitem>
    222       </varlistentry>
    223 
    224196      <varlistentry id="pidof">
    225197        <term><command>pidof</command></term>
     
    276248      </varlistentry>
    277249
    278       <varlistentry id="sulogin">
    279         <term><command>sulogin</command></term>
    280         <listitem>
    281           <para>Allows <emphasis>root</emphasis> to log in; it is normally
    282           invoked by <command>init</command> when the system goes into single
    283           user mode</para>
    284           <indexterm zone="ch-system-sysvinit sulogin">
    285             <primary sortas="b-sulogin">sulogin</primary>
    286           </indexterm>
    287         </listitem>
    288       </varlistentry>
    289 
    290250      <varlistentry id="telinit">
    291251        <term><command>telinit</command></term>
     
    298258      </varlistentry>
    299259
    300       <varlistentry id="utmpdump">
    301         <term><command>utmpdump</command></term>
    302         <listitem>
    303           <para>Displays the content of the given login file in a more
    304           user-friendly format</para>
    305           <indexterm zone="ch-system-sysvinit utmpdump">
    306             <primary sortas="b-utmpdump">utmpdump</primary>
    307           </indexterm>
    308         </listitem>
    309       </varlistentry>
    310 
    311       <varlistentry id="wall">
    312         <term><command>wall</command></term>
    313         <listitem>
    314           <para>Writes a message to all logged-in users</para>
    315           <indexterm zone="ch-system-sysvinit wall">
    316             <primary sortas="b-wall">wall</primary>
    317           </indexterm>
    318         </listitem>
    319       </varlistentry>
    320 
    321260    </variablelist>
    322261
  • BOOK/final-system/common/tar.xml

    r1c9985f r026bb5d  
    3939<screen os="d"><userinput>make</userinput></screen>
    4040
    41     <para os="e">To test the results, issue:
    42     <userinput>make check</userinput>.</para>
     41    <para os="e">To test the results, issue:</para>
     42
     43<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4344
    4445    <para os="f">Install the package:</para>
    4546
    4647<screen os="g"><userinput>make install</userinput></screen>
     48
     49    <para os="h">Generate the man page and place it in the proper location:</para>
     50
     51<screen os="i"><userinput>perl tarman > /usr/share/man/man1/tar.1</userinput></screen>
    4752
    4853  </sect2>
  • BOOK/final-system/common/texinfo.xml

    r1c9985f r026bb5d  
    2626    <title>Installation of Texinfo</title>
    2727
    28     <para os="p1">The following patch will add support for new compressors like XZ Utils:</para>
    29 
    30 <screen os="p2"><userinput>patch -Np1 -i ../&texinfo-new_compressors-patch;</userinput></screen>
    31 
    3228    <para os="a">Prepare Texinfo for compilation:</para>
    3329
     
    3834<screen os="d"><userinput>make</userinput></screen>
    3935
    40     <para os="e">To test the results, issue:
    41     <userinput>make check</userinput>.</para>
     36    <para os="e">To test the results, issue:</para>
     37
     38<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4239
    4340    <para os="f">Install the package:</para>
     
    7067
    7168      <seglistitem>
    72         <seg>info, infokey, install-info, makeinfo, pdftexi2dvi, texi2dvi,
    73         texi2pdf, and texindex</seg>
     69        <seg>info, infokey, install-info, makeinfo (link to texi2any),
     70        pdftexi2dvi, texi2dvi, texi2pdf, and texindex</seg>
    7471        <seg>/usr/share/texinfo</seg>
    7572      </seglistitem>
  • BOOK/final-system/common/util-linux.xml

    r1c9985f r026bb5d  
    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>
  • BOOK/final-system/common/vim.xml

    r1c9985f r026bb5d  
    7171<screen os="h"><userinput>make</userinput></screen>
    7272
    73     <para os="i">To test the results, issue: <userinput>make test</userinput>.
    74     However, this test suite outputs a lot of binary data to the
     73    <para os="i">To test the results, issue:</para>
     74
     75<screen os="i2"><userinput remap="test">make test</userinput></screen>
     76
     77    <para os="i3">However, this test suite outputs a lot of binary data to the
    7578    screen, which can cause issues with the settings of the current terminal.
    7679    This can be resolved by redirecting the output to a log file.</para>
  • BOOK/final-system/common/xz.xml

    r1c9985f r026bb5d  
    3636<screen os="d"><userinput>make</userinput></screen>
    3737
    38     <para os="e">To test the results, issue:
    39     <userinput>make check</userinput>.</para>
    40 
     38    <para os="e">To test the results, issue:</para>
     39
     40<screen os="e2"><userinput remap="test">make check</userinput></screen>
    4141
    4242    <para os="f">Install the programs:</para>
     
    4848
    4949<screen os="i"><userinput>mv -v /usr/bin/{xz,lzma,lzcat,unlzma,unxz,xzcat} /bin</userinput></screen>
     50
     51    <para os="j">Finally, move the shared library to a more appropriate
     52    location, and recreate the symlink pointing to it:</para>
     53
     54<screen os="k"><userinput>mv -v /usr/lib/liblzma.so.* /lib
     55ln -svf ../../lib/liblzma.so.&xz-version; /usr/lib/liblzma.so</userinput></screen>
    5056
    5157  </sect2>
     
    6066
    6167      <seglistitem>
    62         <seg>lzcat (link to xz), lzcmp (link to lzdiff), lzdiff, lzegrep (link to lzgrep),
    63         lzfgrep (link to lzgrep), lzgrep, lzless (link to lzmore), lzma (link to xz),
    64         lzmadec, lzmore, unlzma (link to xz), unxz (link to xz), xz, xzcat
    65         (link to xz), and xzdec</seg>
     68        <seg>lzcat (link to xz), lzcmp (link to xzdiff), lzdiff (link to
     69        xzdiff), lzegrep (link to xzgrep), lzfgrep (link to xzgrep), lzgrep
     70        (link to xzgrep), lzless (link to xzless), lzma (link to xz), lzmadec,
     71        lzmainfo, lzmore (link to xzmore), unlzma (link to xz), unxz (link to
     72        xz), xz, xzcat (link to xz), xzcmp (link to xzdiff), xzdec, xzdiff,
     73        xzegrep (link to xzgrep), xzfgrep (link to xzgrep), xzgrep, xzless,
     74        and xzmore</seg>
    6675        <seg>liblzma.[a,so]</seg>
    6776        <seg>/usr/include/lzma, /usr/share/doc/xz</seg>
     
    164173      </varlistentry>
    165174
     175      <varlistentry id="lzmainfo">
     176        <term><command>lzmainfo</command></term>
     177        <listitem>
     178          <para>Displays information stored in an .lzma file header</para>
     179          <indexterm zone="ch-system-xz lzmainfo">
     180            <primary sortas="b-lzmainfo">lzmainfo</primary>
     181          </indexterm>
     182        </listitem>
     183      </varlistentry>
     184
    166185      <varlistentry id="lzmore">
    167186        <term><command>lzmore</command></term>
     
    214233      </varlistentry>
    215234
     235      <varlistentry id="xzcmp">
     236        <term><command>xzcmp</command></term>
     237        <listitem>
     238          <para>Compares xz compressed files</para>
     239          <indexterm zone="ch-system-xz xzcmp">
     240            <primary sortas="b-xzcmp">xzcmp</primary>
     241          </indexterm>
     242        </listitem>
     243      </varlistentry>
     244
    216245      <varlistentry id="xzdec">
    217246        <term><command>xzdec</command></term>
     
    224253      </varlistentry>
    225254
     255      <varlistentry id="xzdiff">
     256        <term><command>xzdiff</command></term>
     257        <listitem>
     258          <para>Compares xz compressed files</para>
     259          <indexterm zone="ch-system-xz xzdiff">
     260            <primary sortas="b-xzdiff">xzdiff</primary>
     261          </indexterm>
     262        </listitem>
     263      </varlistentry>
     264
     265      <varlistentry id="xzegrep">
     266        <term><command>xzegrep</command></term>
     267        <listitem>
     268          <para>Runs <command>egrep</command> on xz compressed files</para>
     269          <indexterm zone="ch-system-xz xzegrep">
     270            <primary sortas="b-xzegrep">xzegrep</primary>
     271          </indexterm>
     272        </listitem>
     273      </varlistentry>
     274
     275      <varlistentry id="xzfgrep">
     276        <term><command>xzfgrep</command></term>
     277        <listitem>
     278          <para>Runs <command>fgrep</command> on xz compressed files</para>
     279          <indexterm zone="ch-system-xz xzfgrep">
     280            <primary sortas="b-xzfgrep">xzfgrep</primary>
     281          </indexterm>
     282        </listitem>
     283      </varlistentry>
     284
     285      <varlistentry id="xzgrep">
     286        <term><command>xzgrep</command></term>
     287        <listitem>
     288          <para>Runs <command>grep</command> on xz compressed files</para>
     289          <indexterm zone="ch-system-xz xzgrep">
     290            <primary sortas="b-xzgrep">xzgrep</primary>
     291          </indexterm>
     292        </listitem>
     293      </varlistentry>
     294
     295      <varlistentry id="xzless">
     296        <term><command>xzless</command></term>
     297        <listitem>
     298          <para>Runs <command>less</command> on xz files</para>
     299          <indexterm zone="ch-system-xz xzless">
     300            <primary sortas="b-xzless">xzless</primary>
     301          </indexterm>
     302        </listitem>
     303      </varlistentry>
     304
     305      <varlistentry id="xzmore">
     306        <term><command>xzmore</command></term>
     307        <listitem>
     308          <para>Runs <command>more</command> on xz files</para>
     309          <indexterm zone="ch-system-xz xzmore">
     310            <primary sortas="b-xzmore">xzmore</primary>
     311          </indexterm>
     312        </listitem>
     313      </varlistentry>
     314
    226315      <varlistentry id="liblzma">
    227316        <term><filename class="libraryfile">liblzma</filename></term>
  • BOOK/final-system/common/zlib.xml

    r1c9985f r026bb5d  
    3737<screen os="d"><userinput>make</userinput></screen>
    3838
    39     <para os="e">To test the results, issue:
    40     <userinput>make check</userinput>.</para>
     39    <para os="e">To test the results, issue:</para>
     40
     41<screen os="e2" ><userinput remap="test">make check</userinput></screen>
    4142
    4243    <para os="f">Install the package:</para>
Note: See TracChangeset for help on using the changeset viewer.