Ignore:
Timestamp:
Jan 4, 2014, 12:03:38 AM (11 years ago)
Author:
Chris Staub <chris@…>
Branches:
clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit
Children:
f90d077
Parents:
ec008670 (diff), e57ce38 (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:

Merge branch 'master' into systemd

Conflicts:

BOOK/appendices/dependencies/common.xml
BOOK/boot/common/devices.xml
BOOK/boot/common/pwdgroup.xml
BOOK/boot/ppc64-64/powerpc-utils.xml
BOOK/boot/ppc64/util-linux-32.xml
BOOK/bootscripts/common/bootscripts.xml
BOOK/final-system/alpha-chapter.xml
BOOK/final-system/common/coreutils.xml
BOOK/final-system/common/eudev.xml
BOOK/final-system/common/kbd.xml
BOOK/final-system/mips-chapter.xml
BOOK/final-system/mips64-64-chapter.xml
BOOK/final-system/mips64-chapter.xml
BOOK/final-system/multilib/udev-64bit.xml
BOOK/final-system/multilib/util-linux.xml
BOOK/final-system/ppc-chapter.xml
BOOK/final-system/ppc64-chapter.xml
BOOK/final-system/sparc-chapter.xml
BOOK/final-system/sparc64-64-chapter.xml
BOOK/final-system/sparc64-chapter.xml
BOOK/final-system/x86-chapter.xml
BOOK/final-system/x86_64-64-chapter.xml
BOOK/final-system/x86_64-chapter.xml
BOOK/introduction/common/changelog.xml
BOOK/materials/common/packages.xml
BOOK/packages.ent

Location:
BOOK/final-system/common
Files:
2 added
3 deleted
45 edited
3 moved

Legend:

Unmodified
Added
Removed

  • BOOK/final-system/common/autoconf.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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/bash.xml

    rec008670 r229ed25  
    5353<screen os="e"><userinput>make</userinput></screen>
    5454
    55     <para os="f">To test the results, issue:
    56     <userinput>make tests</userinput>.</para>
     55    <para os="f">To test the results, issue:</para>
     56
     57<screen os="f2"><userinput remap="test">make tests</userinput></screen>
    5758
    5859    <para os="g">Install the package:</para>

  • BOOK/final-system/common/binutils.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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>
     35
     36    <para os="s1">Apply a <command>sed</command> which prevents the attempted installation of an invalid file:</para>
     37
     38<screen os="s2"><userinput>sed -i '/cmake/d' Makefile</userinput></screen>
    3639
    3740    <para os="c">Compile the package:</para>
    … …  
    4043
    4144    <important os="e">
    42       <para>The test suite for CLooG-PPL is considered
     45      <para>The test suite for CLooG is considered
    4346      critical. Do not skip it under any circumstance.</para>
    4447    </important>
    … …  
    4649    <para os="f">Test the results:</para>
    4750
    48 <screen os="g"><userinput>make check</userinput></screen>
     51<screen os="g"><userinput remap="test">make check</userinput></screen>
    4952
    5053    <para os="h">Install the package:</para>
    … …  
    5457  </sect2>
    5558
    56   <sect2 id="contents-cloog-ppl" role="content">
    57     <title>Contents of CLooG-PPL</title>
     59  <sect2 id="contents-cloog" role="content">
     60    <title>Contents of CLooG</title>
    5861
    5962    <segmentedlist>
    60       <segtitle>Installed programs</segtitle>
     63      <segtitle>Installed program</segtitle>
    6164      <segtitle>Installed libraries</segtitle>
    62       <segtitle>Installed directory</segtitle>
     65      <segtitle>Installed directories</segtitle>
    6366
    6467      <seglistitem>
    6568        <seg>cloog</seg>
    66         <seg>libcloog.[a,so]</seg>
     69        <seg>libcloog-isl.[a,so]</seg>
    6770        <seg>/usr/include/cloog</seg>
    6871      </seglistitem>
    … …  
    7881        <listitem>
    7982          <para>Loop generator for scanning Z-polyhedra</para>
    80           <indexterm zone="ch-system-cloog-ppl cloog">
     83          <indexterm zone="ch-system-cloog cloog">
    8184            <primary sortas="b-cloog">cloog</primary>
    8285          </indexterm>
    … …  
    8487      </varlistentry>
    8588
    86       <varlistentry id="libcloog">
    87         <term><filename class="libraryfile">libcloog</filename></term>
     89      <varlistentry id="libcloog-isl">
     90        <term><filename class="libraryfile">libcloog-isl</filename></term>
    8891        <listitem>
    89           <para>The Chunky Loop Generator.</para>
    90           <indexterm zone="ch-system-cloog-ppl libcloog">
    91             <primary sortas="c-libcloog-ppl">libcloog</primary>
     92          <para>Isl backend for CLooG.</para>
     93          <indexterm zone="ch-system-cloog libcloog-isl">
     94            <primary sortas="c-libcloog-isl">libcloog-isl</primary>
    9295          </indexterm>
    9396        </listitem>

  • BOOK/final-system/common/coreutils.xml

    rec008670 r229ed25  
    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
    … …  
    104112        echo, env, expand, expr, factor, false, fmt, fold, groups, head,
    105113        hostid, hostname, id, install, join, link, ln, logname, ls, md5sum,
    106         mkdir, mkfifo, mknod, mktemp, mv, nice, nl, nohup, od, paste, pathchk,
    107         pinky, pr, printenv, printf, ptx, pwd, readlink, rm, rmdir, runcon, seq,
    108         sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, shred, shuf,
    109         sleep, sort, split, stat, stdbuf, stty, sum, sync, tac, tail, tee, test,
    110         timeout, touch, tr, true, truncate, tsort, tty, uname, unexpand, uniq,
    111         unlink, users, vdir, wc, who, whoami, and yes</seg>
     114        mkdir, mkfifo, mknod, mktemp, mv, nice, nl, nohup, nproc, numfmt, od, paste,
     115        pathchk, pinky, pr, printenv, printf, ptx, pwd, readlink, realpath, rm,
     116        rmdir, runcon, seq, sha1sum, sha224sum, sha256sum, sha384sum,
     117        sha512sum, shred, shuf, sleep, sort, split, stat, stdbuf, stty, sum,
     118        sync, tac, tail, tee, test, timeout, touch, tr, true, truncate, tsort,
     119        tty, uname, unexpand, uniq, unlink, users, vdir, wc, who, whoami, and yes</seg>
    112120        <seg>libstdbuf.so</seg>
    113121        <seg>/usr/lib/coreutils</seg>
    … …  
    627635      </varlistentry>
    628636
     637      <varlistentry id="nproc">
     638        <term><command>nproc</command></term>
     639        <listitem>
     640          <para>Prints the number of processing units available to the current
     641          process</para>
     642          <indexterm zone="ch-system-coreutils nproc">
     643            <primary sortas="b-nproc">nproc</primary>
     644          </indexterm>
     645        </listitem>
     646      </varlistentry>
     647
     648      <varlistentry id="numfmt">
     649        <term><command>numfmt</command></term>
     650        <listitem>
     651          <para>Converts numbers to or from human-readable strings</para>
     652          <indexterm zone="ch-system-coreutils numfmt">
     653            <primary sortas="b-numfmt">numfmt</primary>
     654          </indexterm>
     655        </listitem>
     656      </varlistentry>
     657
    629658      <varlistentry id="od">
    630659        <term><command>od</command></term>
    … …  
    727756          <indexterm zone="ch-system-coreutils readlink">
    728757            <primary sortas="b-readlink">readlink</primary>
     758          </indexterm>
     759        </listitem>
     760      </varlistentry>
     761
     762      <varlistentry id="realpath">
     763        <term><command>realpath</command></term>
     764        <listitem>
     765          <para>Prints the resolved path</para>
     766          <indexterm zone="ch-system-coreutils realpath">
     767            <primary sortas="b-realpath">realpath</primary>
    729768          </indexterm>
    730769        </listitem>

  • BOOK/final-system/common/diffutils.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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
    … …  
    150147<screen os="r"><userinput>touch /etc/ld.so.conf</userinput></screen>
    151148
    152     <para os="s">Install the package:</para>
    153 
    154 <screen os="t"><userinput>make install</userinput></screen>
     149    <para os="s">Install the package, and remove unneeded files from
     150    <filename class="directory">/usr/include/rpcsvc</filename>:</para>
     151
     152<screen os="t"><userinput>make install &amp;&amp;
     153rm -v /usr/include/rpcsvc/*.x</userinput></screen>
    155154
    156155  </sect2>
    … …  
    246245EOF</userinput></screen>
    247246
     247    <para>Install timezone data:</para>
     248<screen><userinput>tar -xf ../tzdata&tzdata-version;.tar.gz
     249
     250ZONEINFO=/usr/share/zoneinfo
     251mkdir -pv $ZONEINFO/{posix,right}
     252
     253for tz in etcetera southamerica northamerica europe africa antarctica  \
     254          asia australasia backward pacificnew \
     255          systemv; do
     256    zic -L /dev/null   -d $ZONEINFO       -y "sh yearistype.sh" ${tz}
     257    zic -L /dev/null   -d $ZONEINFO/posix -y "sh yearistype.sh" ${tz}
     258    zic -L leapseconds -d $ZONEINFO/right -y "sh yearistype.sh" ${tz}
     259done
     260
     261cp -v zone.tab iso3166.tab $ZONEINFO
     262zic -d $ZONEINFO -p America/New_York
     263unset ZONEINFO</userinput></screen>
     264
     265    <variablelist>
     266      <title>The meaning of the zic commands:</title>
     267
     268      <varlistentry>
     269        <term><parameter>zic -L /dev/null ...</parameter></term>
     270        <listitem>
     271          <para>This creates posix timezones, without any leap seconds.  It is
     272          conventional to put these in both
     273          <filename class="directory">zoneinfo</filename> and
     274          <filename class="directory">zoneinfo/posix</filename>. It is
     275          necessary to put the POSIX timezones in
     276          <filename class="directory">zoneinfo</filename>, otherwise various
     277          test-suites will report errors. On an embedded system, where space is
     278          tight and you do not intend to ever update the timezones, you could save
     279          1.9MB by not using the <filename class="directory">posix</filename>
     280          directory, but some applications or test-suites might give less good
     281          results</para>
     282        </listitem>
     283      </varlistentry>
     284      <varlistentry>
     285        <term><parameter>zic -L leapseconds ...</parameter></term>
     286        <listitem>
     287          <para>This creates right timezones, including leap seconds. On an
     288          embedded system, where space is tight and you do not intend to
     289          ever update the timezones, or care about the correct time, you could
     290          save 1.9MB by omitting the <filename class="directory">right</filename>
     291          directory.</para>
     292        </listitem>
     293      </varlistentry>
     294      <varlistentry>
     295        <term><parameter>zic ... -p ...</parameter></term>
     296        <listitem>
     297          <para>This creates the <filename>posixrules</filename> file. We use
     298          New York because POSIX requires the daylight savings time rules
     299          to be in accordance with US rules.</para>
     300        </listitem>
     301      </varlistentry>
     302    </variablelist>
     303
    248304    <para>To determine the local time zone, run the following script:</para>
    249305
    … …  
    323379      <seglistitem>
    324380        <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>
     381        ldd, lddlibc4, locale, localedef, makedb, mtrace, nscd,
     382        pcprofiledump, pldd, rpcgen, sln, sprof, tzselect, xtrace,zdump,
     383        and zic</seg>
    328384        <seg>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so],
    329385        libbsd-compat.a, libc.[a,so], libc_nonshared.a, libcidn.[a,so],
    … …  
    465521      </varlistentry>
    466522
     523      <varlistentry id="makedb">
     524        <term><command>makedb</command></term>
     525        <listitem>
     526          <para>Creates a simple database from textual input</para>
     527          <indexterm zone="ch-system-eglibc makedb">
     528            <primary sortas="b-makedb">makedb</primary>
     529          </indexterm>
     530        </listitem>
     531      </varlistentry>
     532
    467533      <varlistentry id="mtrace">
    468534        <term><command>mtrace</command></term>
    … …  
    497563      </varlistentry>
    498564
    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>
     565      <varlistentry id="pldd">
     566        <term><command>pldd</command></term>
     567        <listitem>
     568          <para>Lists dynamic shared objects used by running processes</para>
     569          <indexterm zone="ch-system-eglibc pldd">
     570            <primary sortas="b-pldd">pldd</primary>
    506571          </indexterm>
    507572        </listitem>
    … …  
    519584      </varlistentry>
    520585
    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 
    531586      <varlistentry id="sln">
    532587        <term><command>sln</command></term>
    … …  
    535590          <indexterm zone="ch-system-eglibc sln">
    536591            <primary sortas="b-sln">sln</primary>
     592          </indexterm>
     593        </listitem>
     594      </varlistentry>
     595
     596      <varlistentry id="sotruss">
     597        <term><command>sotruss</command></term>
     598        <listitem>
     599          <para>Traces shared library procedure calls of a specified command</para>
     600          <indexterm zone="ch-system-eglibc sotruss">
     601            <primary sortas="b-sotruss">sotruss</primary>
    537602          </indexterm>
    538603        </listitem>

  • BOOK/final-system/common/file.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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>

  • BOOK/final-system/common/kmod.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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/m4.xml

    rec008670 r229ed25  
    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/make.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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>
    … …  
    10589
    10690      <seglistitem>
    107         <seg>addpart, agetty, arch, blkid, blockdev, cal, cfdisk, chkdupexe,
    108         chrt, col, colcrt, colrm, column, ctrlaltdel, cytune, ddate, delpart,
    109         dmesg, fdformat, fdisk, findfs, flock, fsck, fsck.cramfs, fsck.minix,
    110         getopt, hexdump, hwclock, ionice, ipcmk, ipcrm, ipcs, isosize,
    111         ldattach, line, logger, look, losetup, lscpu, mcookie, mkfs, mkfs.bfs,
    112         mkfs.cramfs, mkfs.minix, mkswap, more, mount, namei, partx, pg,
    113         pivot_root, readprofile, rename, renice, rev, rtcwake, script,
    114         scriptreplay, setarch, setsid, setterm, sfdisk, swapoff (link to
    115         swapon), swapon, switch_root, tailf, taskset, tunelp, ul, umount,
    116         uuidd, uuidgen, whereis, and write</seg>
    117         <seg>libblkid.[a,so] and libuuid.[a,so]</seg>
    118         <seg>/usr/include/blkid, /usr/include/uuid, /usr/share/getopt,
    119         /var/lib/hwclock</seg>
     91        <seg>addpart, agetty, blkdiscard, blkid, blockdev, cal, cfdisk, chcpu,
     92        chrt, col, colcrt, colrm, column, ctrlaltdel, cytune, delpart,
     93        dmesg, eject, fallocate, fdformat, fdisk, findfs, findmnt, flock,
     94        fsck, fsck.cramfs, fsck.minix, fsfreeze, fstrim, getopt, hexdump,
     95        hwclock, ionice, ipcmk, ipcrm, ipcs, isosize, kill, last, lastb (link
     96        to last), ldattach, logger, look, losetup, lsblk, lscpu, lslocks,
     97        mcookie, mesg, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap, more,
     98        mount, mountpoint,  namei, nologin, nsenter, partx, pg, pivot_root, prlimit,
     99        raw, readprofile, rename, renice, resizepart, rev, rtcwake, script,
     100        scriptreplay, setarch, setsid, setterm, sfdisk, sulogin, swaplabel,
     101        swapoff, swapon, switch_root, tailf, taskset, ul, umount, unshare,
     102        utmpdump, uuidd, uuidgen, wall, wdctl, whereis, wipefs, and write</seg>
     103        <seg>libblkid.[a,so], libmount.[a,so], and libuuid.[a,so]</seg>
     104        <seg>/usr/include/blkid, /usr/include/libmount, /usr/include/uuid,
     105        /usr/share/doc/util-linux/getopt, /var/lib/hwclock</seg>
    120106      </seglistitem>
    121107    </segmentedlist>
    … …  
    147133      </varlistentry>
    148134
    149       <varlistentry id="arch">
    150         <term><command>arch</command></term>
    151         <listitem>
    152           <para>Reports the machine's architecture</para>
    153           <indexterm zone="ch-system-util-linux arch">
    154             <primary sortas="b-arch">arch</primary>
     135      <varlistentry id="blkdiscard">
     136        <term><command>blkdiscard</command></term>
     137        <listitem>
     138          <para>Discards sectors on a device</para>
     139          <indexterm zone="ch-system-util-linux blkdiscard">
     140            <primary sortas="b-blkdiscard">blkdiscard</primary>
    155141          </indexterm>
    156142        </listitem>
    … …  
    199185      </varlistentry>
    200186
    201       <varlistentry id="chkdupexe">
    202         <term><command>chkdupexe</command></term>
    203         <listitem>
    204           <para>Finds duplicate executables</para>
    205           <indexterm zone="ch-system-util-linux chkdupexe">
    206             <primary sortas="b-chkdupexe">chkdupexe</primary>
     187      <varlistentry id="chcpu">
     188        <term><command>chcpu</command></term>
     189        <listitem>
     190          <para>Utility to configure CPUs</para>
     191          <indexterm zone="ch-system-util-linux chcpu">
     192            <primary sortas="b-chcpu">chcpu</primary>
    207193          </indexterm>
    208194        </listitem>
    … …  
    313299      </varlistentry>
    314300
     301      <varlistentry id="eject">
     302        <term><command>eject</command></term>
     303        <listitem>
     304          <para>Eject removable media</para>
     305          <indexterm zone="ch-system-util-linux eject">
     306            <primary sortas="b-dmesg">eject</primary>
     307          </indexterm>
     308        </listitem>
     309      </varlistentry>
     310
     311      <varlistentry id="fallocate">
     312        <term><command>fallocate</command></term>
     313        <listitem>
     314          <para>Preallocates space to a file</para>
     315          <indexterm zone="ch-system-util-linux fallocate">
     316            <primary sortas="b-fallocate">fallocate</primary>
     317          </indexterm>
     318        </listitem>
     319      </varlistentry>
     320
    315321      <varlistentry id="fdformat">
    316322        <term><command>fdformat</command></term>
    … …  
    344350      </varlistentry>
    345351
     352      <varlistentry id="findmnt">
     353        <term><command>findmnt</command></term>
     354        <listitem>
     355          <para>Lists mounted filesystems or searches for a filesystem</para>
     356          <indexterm zone="ch-system-util-linux findmnt">
     357            <primary sortas="b-findmnt">findmnt</primary>
     358          </indexterm>
     359        </listitem>
     360      </varlistentry>
     361
    346362      <varlistentry id="flock">
    347363        <term><command>flock</command></term>
    … …  
    383399          <indexterm zone="ch-system-util-linux fsck.minix">
    384400            <primary sortas="b-fsck.minix">fsck.minix</primary>
     401          </indexterm>
     402        </listitem>
     403      </varlistentry>
     404
     405      <varlistentry id="fsfreeze">
     406        <term><command>fsfreeze</command></term>
     407        <listitem>
     408          <para>Suspends and resumes access to a filesystem</para>
     409          <indexterm zone="ch-system-util-linux fsfreeze">
     410            <primary sortas="b-fsfreeze">fsfreeze</primary>
     411          </indexterm>
     412        </listitem>
     413      </varlistentry>
     414
     415      <varlistentry id="fstrim">
     416        <term><command>fstrim</command></term>
     417        <listitem>
     418          <para>Discards unused blocks on a mounted filesystem</para>
     419          <indexterm zone="ch-system-util-linux fstrim">
     420            <primary sortas="b-fstrim">fstrim</primary>
    385421          </indexterm>
    386422        </listitem>
    … …  
    470506      </varlistentry>
    471507
     508      <varlistentry id="kill">
     509        <term><command>kill</command></term>
     510        <listitem>
     511          <para>Send a signal to a process</para>
     512          <indexterm zone="ch-system-util-linux kill">
     513            <primary sortas="b-kill">kill</primary>
     514          </indexterm>
     515        </listitem>
     516      </varlistentry>
     517
     518      <varlistentry id="last">
     519        <term><command>last</command></term>
     520        <listitem>
     521          <para>Shows which users last logged in (and out), searching back
     522          through the <filename>/var/log/wtmp</filename> file; it also shows
     523          system boots, shutdowns, and run-level changes</para>
     524          <indexterm zone="ch-system-util-linux last">
     525            <primary sortas="b-last">last</primary>
     526          </indexterm>
     527        </listitem>
     528      </varlistentry>
     529
     530      <varlistentry id="lastb">
     531        <term><command>lastb</command></term>
     532        <listitem>
     533          <para>Shows the failed login attempts, as logged in
     534          <filename>/var/log/btmp</filename></para>
     535          <indexterm zone="ch-system-util-linux lastb">
     536            <primary sortas="b-lastb">lastb</primary>
     537          </indexterm>
     538        </listitem>
     539      </varlistentry>
     540
    472541      <varlistentry id="ldattach">
    473542        <term><command>ldattach</command></term>
    … …  
    480549      </varlistentry>
    481550
    482       <varlistentry id="line">
    483         <term><command>line</command></term>
    484         <listitem>
    485           <para>Copies a single line</para>
    486           <indexterm zone="ch-system-util-linux line">
    487             <primary sortas="b-line">line</primary>
    488           </indexterm>
    489         </listitem>
    490       </varlistentry>
    491 
    492551      <varlistentry id="logger">
    493552        <term><command>logger</command></term>
    … …  
    520579      </varlistentry>
    521580
     581      <varlistentry id="lsblk">
     582        <term><command>lsblk</command></term>
     583        <listitem>
     584          <para>Prints information about block devices</para>
     585          <indexterm zone="ch-system-util-linux lsblk">
     586            <primary sortas="b-lsblk">lsblk</primary>
     587          </indexterm>
     588        </listitem>
     589      </varlistentry>
     590
    522591      <varlistentry id="lscpu">
    523592        <term><command>lscpu</command></term>
    … …  
    526595          <indexterm zone="ch-system-util-linux lscpu">
    527596            <primary sortas="b-lscpu">lscpu</primary>
     597          </indexterm>
     598        </listitem>
     599      </varlistentry>
     600
     601      <varlistentry id="lslocks">
     602        <term><command>lslocks</command></term>
     603        <listitem>
     604          <para>Lists local system locks</para>
     605          <indexterm zone="ch-system-util-linux lslocks">
     606            <primary sortas="b-lslocks">lslocks</primary>
    528607          </indexterm>
    529608        </listitem>
    … …  
    541620      </varlistentry>
    542621
     622      <varlistentry id="mesg">
     623        <term><command>mesg</command></term>
     624        <listitem>
     625          <para>Controls whether other users can send messages to the current
     626          user's terminal</para>
     627          <indexterm zone="ch-system-util-linux mesg">
     628            <primary sortas="b-mesg">mesg</primary>
     629          </indexterm>
     630        </listitem>
     631      </varlistentry>
     632
    543633      <varlistentry id="mkfs">
    544634        <term><command>mkfs</command></term>
    … …  
    614704      </varlistentry>
    615705
     706      <varlistentry id="mountpoint">
     707        <term><command>mountpoint</command></term>
     708        <listitem>
     709          <para>Tells you whether or not a directory is a mount point.</para>
     710          <indexterm zone="ch-system-util-linux mountpoint">
     711            <primary sortas="b-mountpoint">mountpoint</primary>
     712          </indexterm>
     713        </listitem>
     714      </varlistentry>
     715
    616716      <varlistentry id="namei">
    617717        <term><command>namei</command></term>
    … …  
    620720          <indexterm zone="ch-system-util-linux namei">
    621721            <primary sortas="b-namei">namei</primary>
     722          </indexterm>
     723        </listitem>
     724      </varlistentry>
     725
     726      <varlistentry id="nologin">
     727        <term><command>nologin</command></term>
     728        <listitem>
     729          <para>Displays a message that an account is not available. Designed
     730          to be used as the default shell for accounts that have been
     731          disabled</para>
     732          <indexterm zone="ch-system-util-linux nologin">
     733            <primary sortas="b-nologin">nologin</primary>
     734          </indexterm>
     735        </listitem>
     736      </varlistentry>
     737
     738      <varlistentry id="nsenter">
     739        <term><command>nsenter</command></term>
     740        <listitem>
     741          <para>Runs a program with namespaces of other processes</para>
     742          <indexterm zone="ch-system-util-linux nsenter">
     743            <primary sortas="b-nsenter">nsenter</primary>
    622744          </indexterm>
    623745        </listitem>
    … …  
    656778      </varlistentry>
    657779
     780      <varlistentry id="prlimit">
     781        <term><command>prlimit</command></term>
     782        <listitem>
     783          <para>Gets and sets a process' resource limits</para>
     784          <indexterm zone="ch-system-util-linux prlimit">
     785            <primary sortas="b-prlimit">prlimit</primary>
     786          </indexterm>
     787        </listitem>
     788      </varlistentry>
     789
     790      <varlistentry id="raw">
     791        <term><command>raw</command></term>
     792        <listitem>
     793          <para>Binds a Linux raw character device to a block device</para>
     794          <indexterm zone="ch-system-util-linux raw">
     795            <primary sortas="b-raw">raw</primary>
     796          </indexterm>
     797        </listitem>
     798      </varlistentry>
     799
    658800      <varlistentry id="readprofile">
    659801        <term><command>readprofile</command></term>
    … …  
    687829      </varlistentry>
    688830
     831      <varlistentry id="resizepart">
     832        <term><command>resizepart</command></term>
     833        <listitem>
     834          <para>Asks the Linux kernel to resize a partition</para>
     835          <indexterm zone="ch-system-util-linux resizepart">
     836            <primary sortas="b-resizepart">resizepart</primary>
     837          </indexterm>
     838        </listitem>
     839      </varlistentry>
     840
    689841      <varlistentry id="rev">
    690842        <term><command>rev</command></term>
    … …  
    764916          <indexterm zone="ch-system-util-linux sfdisk">
    765917            <primary sortas="b-sfdisk">sfdisk</primary>
     918          </indexterm>
     919        </listitem>
     920      </varlistentry>
     921
     922      <varlistentry id="sulogin">
     923        <term><command>sulogin</command></term>
     924        <listitem>
     925          <para>Allows <emphasis>root</emphasis> to log in; it is normally
     926          invoked by <command>init</command> when the system goes into single
     927          user mode</para>
     928          <indexterm zone="ch-system-util-linux sulogin">
     929            <primary sortas="b-sulogin">sulogin</primary>
     930          </indexterm>
     931        </listitem>
     932      </varlistentry>
     933
     934      <varlistentry id="swaplabel">
     935        <term><command>swaplabel</command></term>
     936        <listitem>
     937          <para>Prints or changes the label or UUID of a swap area</para>
     938          <indexterm zone="ch-system-util-linux swaplabel">
     939            <primary sortas="b-swaplabel">swaplabel</primary>
    766940          </indexterm>
    767941        </listitem>
    … …  
    821995      </varlistentry>
    822996
    823       <varlistentry id="tunelp">
    824         <term><command>tunelp</command></term>
    825         <listitem>
    826           <para>Tunes the parameters of the line printer</para>
    827           <indexterm zone="ch-system-util-linux tunelp">
    828             <primary sortas="b-tunelp">tunelp</primary>
    829           </indexterm>
    830         </listitem>
    831       </varlistentry>
    832 
    833997      <varlistentry id="ul">
    834998        <term><command>ul</command></term>
    … …  
    8481012          <indexterm zone="ch-system-util-linux umount">
    8491013            <primary sortas="b-umount">umount</primary>
     1014          </indexterm>
     1015        </listitem>
     1016      </varlistentry>
     1017
     1018      <varlistentry id="unshare">
     1019        <term><command>unshare</command></term>
     1020        <listitem>
     1021          <para>Runs a program with some namespaces unshared from parent</para>
     1022          <indexterm zone="ch-system-util-linux unshare">
     1023            <primary sortas="b-unshare">unshare</primary>
     1024          </indexterm>
     1025        </listitem>
     1026      </varlistentry>
     1027
     1028      <varlistentry id="utmpdump">
     1029        <term><command>utmpdump</command></term>
     1030        <listitem>
     1031          <para>Displays the content of the given login file in a more
     1032          user-friendly format</para>
     1033          <indexterm zone="ch-system-util-linux utmpdump">
     1034            <primary sortas="b-utmpdump">utmpdump</primary>
    8501035          </indexterm>
    8511036        </listitem>
    … …  
    8751060      </varlistentry>
    8761061
     1062      <varlistentry id="wall">
     1063        <term><command>wall</command></term>
     1064        <listitem>
     1065          <para>Writes a message to all logged-in users</para>
     1066          <indexterm zone="ch-system-util-linux wall">
     1067            <primary sortas="b-wall">wall</primary>
     1068          </indexterm>
     1069        </listitem>
     1070      </varlistentry>
     1071
     1072      <varlistentry id="wdctl">
     1073        <term><command>wdctl</command></term>
     1074        <listitem>
     1075          <para>Show hardware watchdog status</para>
     1076          <indexterm zone="ch-system-util-linux wdctl">
     1077            <primary sortas="b-uuidgen">wdctl</primary>
     1078          </indexterm>
     1079        </listitem>
     1080      </varlistentry>
     1081
    8771082      <varlistentry id="whereis">
    8781083        <term><command>whereis</command></term>
    … …  
    8861091      </varlistentry>
    8871092
     1093      <varlistentry id="wipefs">
     1094        <term><command>wipefs</command></term>
     1095        <listitem>
     1096          <para>Wipes a filesystem signature from a device</para>
     1097          <indexterm zone="ch-system-util-linux wipefs">
     1098            <primary sortas="b-wipefs">wipefs</primary>
     1099          </indexterm>
     1100        </listitem>
     1101      </varlistentry>
     1102
    8881103      <varlistentry id="write">
    8891104        <term><command>write</command></term>
    … …  
    9081123      </varlistentry>
    9091124
     1125      <varlistentry id="libmount">
     1126        <term><filename class="libraryfile">libmount</filename></term>
     1127        <listitem>
     1128          <para>Contains routines for parsing the
     1129          <filename>/etc/fstab</filename>, <filename>/etc/mtab</filename>,
     1130          and <filename>/proc/self/mountinfo</filename> files, managing
     1131          <filename>/etc/mtab</filename>, and configuring various mount
     1132          options</para>
     1133          <indexterm zone="ch-system-util-linux libmount">
     1134            <primary sortas="c-libmount">libmount</primary>
     1135          </indexterm>
     1136        </listitem>
     1137      </varlistentry>
     1138
    9101139      <varlistentry id="libuuid">
    9111140        <term><filename class="libraryfile">libuuid</filename></term>

  • BOOK/final-system/common/vim.xml

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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

    rec008670 r229ed25  
    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.