Changeset b1532549


Ignore:
Timestamp:
03/19/2020 10:00:16 AM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
e68b588
Parents:
09f0998
Message:

Format sysutils

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22859 af4574ff-66df-0310-9fd7-8a98e5e911e0

Location:
general/sysutils
Files:
18 edited

Legend:

Unmodified
Added
Removed
  • general/sysutils/at.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to at</title>
    3131
    32     <para>The <application>at</application> package provide delayed job execution
    33     and batch processing. It is required for Linux Standards Base (LSB)
    34     conformance.</para>
     32    <para>
     33      The <application>at</application> package provide delayed job execution
     34      and batch processing. It is required for Linux Standards Base (LSB)
     35      conformance.
     36    </para>
    3537
    3638    &lfs91_checked;
     
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&at-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&at-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &at-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &at-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &at-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &at-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&at-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&at-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &at-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &at-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &at-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &at-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
     
    7892    <title>Installation of at</title>
    7993
    80     <para>Before building <application>at</application>, as the
    81     <systemitem class="username">root</systemitem> user you should create
    82     the group and user <systemitem class="username">atd</systemitem> which
    83     will run the <command>atd</command> daemon.  Also ensure the working
    84     directory for the daemon exists:</para>
     94    <para>
     95      Before building <application>at</application>, as the
     96      <systemitem class="username">root</systemitem> user you should create
     97      the group and user <systemitem class="username">atd</systemitem> which
     98      will run the <command>atd</command> daemon.  Also ensure the working
     99      directory for the daemon exists:
     100    </para>
    85101
    86102<screen role="root"><userinput>groupadd -g 17 atd                                                  &amp;&amp;
     
    101117<screen><userinput>autoreconf</userinput></screen>
    102118
    103     <para>Install <application>at</application> with the following
    104     commands:</para>
     119    <para>
     120      Install <application>at</application> with the following
     121      commands:
     122    </para>
    105123
    106124    <screen revision="sysv"><userinput>./configure --with-daemon_username=atd        \
     
    116134make -j1</userinput></screen>
    117135
    118     <para>This package does not come with a test suite.</para>
    119 
    120     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     136    <para>
     137      This package does not come with a test suite.
     138    </para>
     139
     140    <para>
     141      Now, as the <systemitem class="username">root</systemitem> user:
     142    </para>
    121143
    122144<screen role="root"><userinput>make install docdir=/usr/share/doc/at-&at-version; \
     
    131153      <title>Config Files</title>
    132154
    133       <para> <filename>/etc/at.allow</filename> and
    134       <filename>/etc/at.deny</filename> determines who can submit jobs via at
    135       or batch.</para>
     155      <para>
     156        <filename>/etc/at.allow</filename> and
     157        <filename>/etc/at.deny</filename> determines who can submit jobs via at
     158        or batch.
     159      </para>
    136160
    137161      <indexterm zone="at at-config">
     
    149173             <phrase revision="systemd">Systemd Unit</phrase></title>
    150174
    151       <para revision="sysv">Install the <filename>/etc/init.d/atd</filename>
    152       init script from the <xref linkend="bootscripts"/> package.</para>
     175      <para revision="sysv">
     176        Install the <filename>/etc/init.d/atd</filename>
     177        init script from the <xref linkend="bootscripts"/> package.
     178      </para>
    153179
    154180      <para revision="systemd">
     
    201227        <term><command>at</command></term>
    202228        <listitem>
    203           <para>queues, examines or deletes jobs for later execution.</para>
     229          <para>
     230            queues, examines or deletes jobs for later execution.
     231          </para>
    204232          <indexterm zone="at at-prog">
    205233            <primary sortas="b-at">at</primary>
     
    211239        <term><command>atd</command></term>
    212240        <listitem>
    213           <para>is the daemon that runs jobs queued for later execution.</para>
     241          <para>
     242            is the daemon that runs jobs queued for later execution.
     243          </para>
    214244          <indexterm zone="at atd">
    215245            <primary sortas="b-atd">atd</primary>
     
    221251        <term><command>atq</command></term>
    222252        <listitem>
    223           <para>lists the user's pending jobs, or all jobs, if superuser.</para>
     253          <para>
     254            lists the user's pending jobs, or all jobs, if superuser.
     255          </para>
    224256          <indexterm zone="at atq">
    225257            <primary sortas="b-atq">atq</primary>
     
    231263        <term><command>atrm</command></term>
    232264        <listitem>
    233           <para>deletes jobs, identified by their job number.</para>
     265          <para>
     266            deletes jobs, identified by their job number.
     267          </para>
    234268          <indexterm zone="at atrm">
    235269            <primary sortas="b-atrm">atrm</primary>
     
    241275        <term><command>atrun</command></term>
    242276        <listitem>
    243           <para>runs jobs queued for later execution.</para>
     277          <para>
     278            runs jobs queued for later execution.
     279          </para>
    244280          <indexterm zone="at atrun">
    245281            <primary sortas="b-atrun">atrun</primary>
     
    251287        <term><command>batch</command></term>
    252288        <listitem>
    253           <para>is a script that executes commands when system load levels permit.
     289          <para>
     290            is a script that executes commands when system load levels permit.
    254291          </para>
    255292          <indexterm zone="at batch">
  • general/sysutils/autofs.xml

    r09f0998 rb1532549  
    4242    <itemizedlist spacing="compact">
    4343      <listitem>
    44         <para>Download (HTTP): <ulink url="&autofs-download-http;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download (FTP): <ulink url="&autofs-download-ftp;"/></para>
    48       </listitem>
    49       <listitem>
    50         <para>Download MD5 sum: &autofs-md5sum;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Download size: &autofs-size;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated disk space required: &autofs-buildsize;</para>
    57       </listitem>
    58       <listitem>
    59         <para>Estimated build time: &autofs-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&autofs-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&autofs-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &autofs-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &autofs-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &autofs-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &autofs-time;
     71        </para>
    6072      </listitem>
    6173    </itemizedlist>
     
    106118    &lt;*/M&gt; CIFS support (advanced network filesystem, SMBFS successor) [CONFIG_CIFS]</literal></screen>
    107119
    108     <para>Recompile and install the new kernel, if necessary.</para>
     120    <para>
     121      Recompile and install the new kernel, if necessary.
     122    </para>
    109123
    110124  </sect2>
     
    114128    <title>Installation of Autofs</title>
    115129
    116     <para>Install <application>Autofs</application> by running the following
    117     commands:</para>
     130    <para>
     131      Install <application>Autofs</application> by running the following
     132      commands:
     133    </para>
    118134
    119135<screen revision="sysv"><userinput>./configure --prefix=/         \
     
    131147make</userinput></screen>
    132148
    133     <para>This package does not come with a test suite.</para>
    134 
    135     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     149    <para>
     150      This package does not come with a test suite.
     151    </para>
     152
     153    <para>
     154      Now, as the <systemitem class="username">root</systemitem> user:
     155    </para>
    136156
    137157<screen role="root"><userinput>make install</userinput></screen>
     
    183203      <title>Config Files</title>
    184204
    185       <para><filename>/etc/sysconfig/autofs.conf</filename>,
    186       <filename>/etc/auto.master</filename>,
    187       <filename>/etc/auto.misc</filename>, and
    188       <filename>/etc/auto.net</filename></para>
     205      <para>
     206        <filename>/etc/sysconfig/autofs.conf</filename>,
     207        <filename>/etc/auto.master</filename>,
     208        <filename>/etc/auto.misc</filename>, and
     209        <filename>/etc/auto.net</filename>
     210      </para>
    189211
    190212      <indexterm zone="autofs autofs-config" >
     
    209231      <title>Configuration Information</title>
    210232
    211       <para>The installation process creates <filename>auto.master</filename>,
    212       <filename>auto.misc</filename>,  <filename>auto.smb</filename>, and
    213       <filename>auto.net</filename>. Replace the
    214       <filename>auto.master</filename> file with the following commands
    215       as the <systemitem class="username">root</systemitem> user:</para>
     233      <para>
     234        The installation process creates <filename>auto.master</filename>,
     235        <filename>auto.misc</filename>,  <filename>auto.smb</filename>, and
     236        <filename>auto.net</filename>. Replace the
     237        <filename>auto.master</filename> file with the following commands
     238        as the <systemitem class="username">root</systemitem> user:
     239      </para>
    216240
    217241<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
     
    225249EOF</userinput></screen>
    226250
    227       <para>This file creates a new media directory, <filename>/media/auto</filename>
    228       that will overlay any existing directory of the same name.  In this example,
    229       the file, <filename>/etc/auto.misc</filename>, has a line:</para>
     251      <para>
     252        This file creates a new media directory,
     253        <filename>/media/auto</filename> that will overlay any existing
     254        directory of the same name.  In this example, the file,
     255        <filename>/etc/auto.misc</filename>, has a line:
     256      </para>
    230257
    231258<screen>cd   -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom</screen>
    232259
    233       <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
    234       that directory is accessed.  The <option>--ghost</option> option tells
    235       the automounter to create <quote>ghost</quote> versions (i.e. empty
    236       directories) of all the mount points listed in the configuration file
    237       regardless whether any of the file systems are actually mounted or not.
    238       This is very convenient and highly recommended, because it will show you
    239       the available auto-mountable file systems as existing directories, even
    240       when their file systems aren't currently mounted. Without the
    241       <option>--ghost</option> option, you'll have to remember the names of the
    242       directories. As soon as you try to access one of them, the directory will
    243       be created and the file system will be mounted. When the file system gets
    244       unmounted again, the directory is destroyed too, unless the
    245       <option>--ghost</option> option was given.</para>
     260      <para>
     261        that will mount a cdrom as <filename>/media/auto/cd</filename> if
     262        that directory is accessed.  The <option>--ghost</option> option tells
     263        the automounter to create <quote>ghost</quote> versions (i.e. empty
     264        directories) of all the mount points listed in the configuration file
     265        regardless whether any of the file systems are actually mounted or not.
     266        This is very convenient and highly recommended, because it will show
     267        you the available auto-mountable file systems as existing directories,
     268        even when their file systems aren't currently mounted. Without the
     269        <option>--ghost</option> option, you'll have to remember the names of
     270        the directories. As soon as you try to access one of them, the
     271        directory will be created and the file system will be mounted. When
     272        the file system gets unmounted again, the directory is destroyed too,
     273        unless the <option>--ghost</option> option was given.
     274      </para>
    246275
    247276      <note>
    248         <para>An alternative method would be to specify another automount
    249         location such as <filename
    250         class='directory'>/var/lib/auto/cdrom</filename> and create a
    251         symbolic link from <filename class='directory'>/media/cdrom</filename>
    252         to the automount location.</para>
     277        <para>
     278          An alternative method would be to specify another automount
     279          location such as <filename
     280          class='directory'>/var/lib/auto/cdrom</filename> and create a
     281          symbolic link from <filename
     282          class='directory'>/media/cdrom</filename> to the automount location.
     283        </para>
    253284      </note>
    254285
    255       <para>The <filename>auto.misc</filename> file must be configured to your
    256       working hardware. The loaded configuration file should load your cdrom
    257       if <filename>/dev/cdrom</filename> is active or it can be edited to
    258       match your device setup.  Examples for floppies are available in the file
    259       and easily activated. Documentation for this file is available using the
    260       <command>man 5 autofs</command> command.</para>
    261 
    262       <para>In the second line, if enabled, a user's home directory would be
    263       mounted via NFS upon login.  The <filename>/etc/home.auto</filename>
    264       would need to exist and have an entry similar to:</para>
     286      <para>
     287        The <filename>auto.misc</filename> file must be configured to your
     288        working hardware. The loaded configuration file should load your cdrom
     289        if <filename>/dev/cdrom</filename> is active or it can be edited to
     290        match your device setup.  Examples for floppies are available in the
     291        file and easily activated. Documentation for this file is available
     292        using the <command>man 5 autofs</command> command.
     293      </para>
     294
     295      <para>
     296        In the second line, if enabled, a user's home directory would be
     297        mounted via NFS upon login.  The <filename>/etc/home.auto</filename>
     298        would need to exist and have an entry similar to:
     299      </para>
    265300
    266301<screen>joe  example.org:/export/home/joe</screen>
    267302
    268       <para>where the directory <filename>/export/home/joe</filename> is
    269       exported via NFS from the system example.org.  NFS shares
    270       are covered on the next page.</para>
    271 
    272       <para>This package could also be used to mount SMB shares, however that
    273       feature is not configured in these instructions.  For additional
    274       configuration information, see the man pages for auto.master(5).  There
    275       are also web resources such as this <ulink
    276       url='http://wiki.gentoo.org/wiki/AutoFS'>AUTOFS
    277       HOWTO</ulink> available.</para>
     303      <para>
     304        where the directory <filename>/export/home/joe</filename> is
     305        exported via NFS from the system example.org.  NFS shares
     306        are covered on the next page.
     307      </para>
     308
     309      <para>
     310        This package could also be used to mount SMB shares, however that
     311        feature is not configured in these instructions.  For additional
     312        configuration information, see the man pages for auto.master(5). There
     313        are also web resources such as this <ulink
     314        url='http://wiki.gentoo.org/wiki/AutoFS'>AUTOFS
     315        HOWTO</ulink> available.
     316      </para>
    278317
    279318    </sect3>
     
    283322             <phrase revision="systemd">Systemd Unit</phrase></title>
    284323
    285       <para revision="sysv"><application>autofs</application> installs its own
    286       boot script, but it has no capability for logging or visual conformance
    287       with other BLFS scripts.</para>
    288 
    289       <para revision="sysv">Install the <filename>/etc/init.d/autofs</filename>
    290       mount script included with the <xref linkend="bootscripts"/>
    291       package.</para>
     324      <para revision="sysv">
     325        <application>autofs</application> installs its own
     326        boot script, but it has no capability for logging or visual conformance
     327        with other BLFS scripts.
     328      </para>
     329
     330      <para revision="sysv">
     331        Install the <filename>/etc/init.d/autofs</filename>
     332        mount script included with the <xref linkend="bootscripts"/>
     333        package.
     334      </para>
    292335
    293336      <para revision="systemd">
     
    305348<screen role="root" revision="systemd"><userinput>systemctl enable autofs</userinput></screen>
    306349
    307       <para revision="sysv">The time-out variable is set in
    308       <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
    309       a default of 60 seconds of inactivity before unmounting the device.  A
    310       much shorter time may be necessary to protect buffer writing to a floppy
    311       if users tend to remove the media prior to the timeout setting.</para>
     350      <para revision="sysv">
     351        The time-out variable is set in
     352        <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
     353        a default of 60 seconds of inactivity before unmounting the device.  A
     354        much shorter time may be necessary to protect buffer writing to a floppy
     355        if users tend to remove the media prior to the timeout setting.
     356      </para>
    312357
    313358      <note revision="systemd">
     
    353398        <term><command>automount</command></term>
    354399        <listitem>
    355           <para>is the daemon that performs the mounting when a request is
    356           made for the device.</para>
     400          <para>
     401            is the daemon that performs the mounting when a request is
     402            made for the device.
     403          </para>
    357404          <indexterm zone="autofs automount">
    358405            <primary sortas="b-automount">automount</primary>
  • general/sysutils/colord.xml

    r09f0998 rb1532549  
    123123        -g colord -s /bin/false colord</userinput></screen>
    124124
    125     <para>First, clean up about 100 warnings:</para>
     125    <para>
     126      First, clean up about 100 warnings:
     127    </para>
    126128
    127129<screen><userinput>mv po/fur.po po/ur.po &amp;&amp;
  • general/sysutils/cpio.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to cpio</title>
    3131
    32     <para>The <application>cpio</application> package contains
    33     tools for archiving.</para>
     32    <para>
     33      The <application>cpio</application> package contains
     34      tools for archiving.
     35    </para>
    3436
    3537    &lfs91_checked;
     
    3840    <itemizedlist spacing="compact">
    3941      <listitem>
    40         <para>Download (HTTP): <ulink url="&cpio-download-http;"/></para>
    41       </listitem>
    42       <listitem>
    43         <para>Download (FTP): <ulink url="&cpio-download-ftp;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download MD5 sum: &cpio-md5sum;</para>
    47       </listitem>
    48       <listitem>
    49         <para>Download size: &cpio-size;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Estimated disk space required: &cpio-buildsize;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated build time: &cpio-time;</para>
     42        <para>
     43          Download (HTTP): <ulink url="&cpio-download-http;"/>
     44        </para>
     45      </listitem>
     46      <listitem>
     47        <para>
     48          Download (FTP): <ulink url="&cpio-download-ftp;"/>
     49        </para>
     50      </listitem>
     51      <listitem>
     52        <para>
     53          Download MD5 sum: &cpio-md5sum;
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download size: &cpio-size;
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Estimated disk space required: &cpio-buildsize;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Estimated build time: &cpio-time;
     69        </para>
    5670      </listitem>
    5771    </itemizedlist>
     
    7286    <title>Installation of cpio</title>
    7387
    74     <para>Install <application>cpio</application> by running the following
    75     commands:</para>
     88    <para>
     89      Install <application>cpio</application> by running the following
     90      commands:
     91    </para>
    7692
    7793<screen><userinput>./configure --prefix=/usr \
     
    84100makeinfo --plaintext       -o doc/cpio.txt  doc/cpio.texi</userinput></screen>
    85101
    86     <para>If you have <xref linkend="texlive"/>
    87     installed and wish to create PDF or Postscript documentation, issue one or
    88     both of the following commands:</para>
     102    <para>
     103      If you have <xref linkend="texlive"/> installed and wish to create PDF
     104      or Postscript documentation, issue one or both of the following commands:
     105    </para>
    89106
    90107<screen remap="doc"><userinput>make -C doc pdf &amp;&amp;
    91108make -C doc ps</userinput></screen>
    92109
    93     <para>To test the results, issue: <command>make check</command>.</para>
    94 
    95     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     110    <para>
     111      To test the results, issue: <command>make check</command>.
     112    </para>
     113
     114    <para>
     115      Now, as the <systemitem class="username">root</systemitem> user:
     116    </para>
    96117
    97118<screen role="root"><userinput>make install &amp;&amp;
     
    102123                    /usr/share/doc/cpio-&cpio-version;</userinput></screen>
    103124
    104     <para>If you built PDF or Postscript documentation, install it
    105     by issuing the following commands as the
    106     <systemitem class="username">root</systemitem> user:</para>
     125    <para>
     126      If you built PDF or Postscript documentation, install it
     127      by issuing the following commands as the
     128      <systemitem class="username">root</systemitem> user:
     129    </para>
    107130
    108131<screen role="root"
     
    115138    <title>Command Explanations</title>
    116139
    117     <para><parameter>--bindir=/bin</parameter>: This parameter installs
    118     <command>cpio</command> to <filename class="directory">/bin</filename>
    119     instead of <filename class="directory">/usr/bin</filename> as recommended
    120     by the FHS guidelines.</para>
    121 
    122     <para><parameter>--enable-mt</parameter>: This parameter forces the
    123     building and installation of the <command>mt</command> program.</para>
    124 
    125     <para><parameter>--with-rmt=/usr/libexec/rmt</parameter>: This parameter
    126     inhibits building the <command>rmt</command> program as it is already
    127     installed by the <application>Tar</application> package in LFS.</para>
     140    <para>
     141      <parameter>--bindir=/bin</parameter>: This parameter installs
     142      <command>cpio</command> to <filename class="directory">/bin</filename>
     143      instead of <filename class="directory">/usr/bin</filename> as recommended
     144      by the FHS guidelines.
     145    </para>
     146
     147    <para>
     148      <parameter>--enable-mt</parameter>: This parameter forces the
     149      building and installation of the <command>mt</command> program.
     150    </para>
     151
     152    <para>
     153      <parameter>--with-rmt=/usr/libexec/rmt</parameter>: This parameter
     154      inhibits building the <command>rmt</command> program as it is already
     155      installed by the <application>Tar</application> package in LFS.
     156    </para>
    128157
    129158  </sect2>
     
    152181        <term><command>cpio</command></term>
    153182        <listitem>
    154           <para>copies files to and from archives.</para>
     183          <para>
     184            copies files to and from archives.
     185          </para>
    155186          <indexterm zone="cpio cpio-prog">
    156187            <primary sortas="b-cpio">cpio</primary>
     
    162193        <term><command>mt</command></term>
    163194        <listitem>
    164           <para>controls magnetic tape drive operations.</para>
     195          <para>
     196            controls magnetic tape drive operations.
     197          </para>
    165198          <indexterm zone="cpio mt">
    166199            <primary sortas="b-mt">mt</primary>
  • general/sysutils/fcron.xml

    r09f0998 rb1532549  
    3131    <title>Introduction to Fcron</title>
    3232
    33     <para>The <application>Fcron</application> package contains a periodical
    34     command scheduler which aims at replacing <application>Vixie
    35     Cron</application>.</para>
     33    <para>
     34      The <application>Fcron</application> package contains a periodical
     35      command scheduler which aims at replacing <application>Vixie
     36      Cron</application>.
     37    </para>
    3638
    3739    &lfs91_checked;
     
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&fcron-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&fcron-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &fcron-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &fcron-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &fcron-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &fcron-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&fcron-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&fcron-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &fcron-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &fcron-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &fcron-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &fcron-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
     
    7286
    7387    <bridgehead renderas="sect4">Optional</bridgehead>
    74     <para role="optional">An <xref linkend="server-mail"/>,
    75     <ulink url="../postlfs/editors.html">text editor</ulink> (default is
    76     <command>vi</command> from the <xref linkend="vim"/> package),
    77     <xref linkend="linux-pam"/>, and
    78     <xref linkend="docbook-utils"/>
     88    <para role="optional">
     89      An <xref linkend="server-mail"/>,
     90      <ulink url="../postlfs/editors.html">text editor</ulink> (default is
     91      <command>vi</command> from the <xref linkend="vim"/> package),
     92      <xref linkend="linux-pam"/>, and
     93      <xref linkend="docbook-utils"/>
    7994    </para>
    8095
     
    87102    <title>Installation of Fcron</title>
    88103
    89     <para id="fcron-syslog" revision="sysv"><application>Fcron</application>
    90     uses the cron facility of <command>syslog</command> to log all messages.
    91     Since LFS does not set up this facility in
    92     <filename>/etc/syslog.conf</filename>, it needs to be done prior to
    93     installing <application>Fcron</application>. This command will append the
    94     necessary line to the current <filename>/etc/syslog.conf</filename>
    95     (perform as the <systemitem class='username'>root</systemitem> user):</para>
     104    <para id="fcron-syslog" revision="sysv">
     105      <application>Fcron</application>
     106      uses the cron facility of <command>syslog</command> to log all messages.
     107      Since LFS does not set up this facility in
     108      <filename>/etc/syslog.conf</filename>, it needs to be done prior to
     109      installing <application>Fcron</application>. This command will append the
     110      necessary line to the current <filename>/etc/syslog.conf</filename>
     111      (perform as the <systemitem class='username'>root</systemitem> user):
     112    </para>
    96113
    97114    <indexterm zone="fcron fcron-syslog" revision="sysv">
     
    107124EOF</userinput></screen>
    108125
    109     <para revision="sysv">The configuration file has been modified, so reloading
    110     the <command>sysklogd</command> daemon will activate the changes (again as
    111     the <systemitem class='username'>root</systemitem> user).</para>
     126    <para revision="sysv">
     127      The configuration file has been modified, so reloading the
     128      <command>sysklogd</command> daemon will activate the changes (again as
     129      the <systemitem class='username'>root</systemitem> user).
     130    </para>
    112131
    113132<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/sysklogd reload</userinput></screen>
    114133
    115     <para>For security reasons, an unprivileged user and group for
    116     <application>Fcron</application> should be created (perform as the
    117     <systemitem class='username'>root</systemitem> user):</para>
     134    <para>
     135      For security reasons, an unprivileged user and group for
     136      <application>Fcron</application> should be created (perform as the
     137      <systemitem class='username'>root</systemitem> user):
     138    </para>
    118139
    119140<screen role="root"><userinput>groupadd -g 22 fcron &amp;&amp;
    120141useradd -d /dev/null -c "Fcron User" -g fcron -s /bin/false -u 22 fcron</userinput></screen>
    121142
    122     <para>Install <application>Fcron</application> by running the following
    123     commands:</para>
     143    <para>
     144      Install <application>Fcron</application> by running the following
     145      commands:
     146    </para>
    124147
    125148<screen revision="sysv"><userinput>./configure --prefix=/usr          \
     
    139162make</userinput></screen>
    140163
    141     <para>This package does not come with a test suite.</para>
    142 
    143     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     164    <para>
     165      This package does not come with a test suite.
     166    </para>
     167
     168    <para>
     169      Now, as the <systemitem class="username">root</systemitem> user:
     170    </para>
    144171
    145172<screen role="root"><userinput>make install</userinput></screen>
    146173
    147     <para>DESTDIR install must be done as <systemitem class="username">root</systemitem> user.</para>
     174    <para>
     175      DESTDIR install must be done as <systemitem
     176      class="username">root</systemitem> user.
     177    </para>
    148178
    149179  </sect2>
     
    152182    <title>Command Explanations</title>
    153183<!--
    154     <para><command>autoconf</command>: This command is required to rebuild
    155     <filename>configure</filename> using the fixed input file.</para>-->
    156 
    157     <para><parameter>--without-sendmail</parameter>: By default,
    158     <application>Fcron</application> will attempt to use the
    159     <command>sendmail</command> command from an <xref linkend="server-mail"/>
    160     package to email you the results of the <command>fcron</command> script.
    161     This switch is used to disable default email notification. Omit the switch
    162     to enable the default. Alternatively, you can use the
    163     <option>--with-sendmail=<replaceable>&lt;/path/to/MTA
    164     command&gt;</replaceable></option> to use a different mailer command.</para>
    165 
    166     <para><parameter>--with-boot-install=no</parameter>: This prevents
    167     installation of the bootscript included with the package.</para>
    168 
    169     <para revision="systemd"><parameter>--with-piddir=/run</parameter>:
    170     This fixes the systemd unit to use the proper directory for PID files so
    171     that systemctl does not hang and the unit starts correctly.</para>
    172 
    173     <para revision="sysv"><parameter>--with-systemdsystemunitdir=no</parameter>:
    174     This prevents building the <application>systemd</application> units, which
    175     are not needed for a <application>SYS V</application> system.</para>
    176 
    177     <para><option>--with-editor=<replaceable>&lt;/path/to/editor&gt;</replaceable></option>:
    178     This switch allows you to set the default text editor.</para>
    179 
    180     <para><option>--with-dsssl-dir=<replaceable>&lt;/path/to/dsssl-stylesheets&gt;</replaceable></option>:
    181     May be used if you have <xref linkend="docbook-utils"/> installed.
    182     Currently, the dsssl stylesheets are located at
    183     <filename class="directory">/usr/share/sgml/docbook/dsssl-stylesheets-1.79</filename>.</para>
     184    <para>
     185      <command>autoconf</command>: This command is required to rebuild
     186      <filename>configure</filename> using the fixed input file.
     187    </para>-->
     188
     189    <para>
     190      <parameter>--without-sendmail</parameter>: By default,
     191      <application>Fcron</application> will attempt to use the
     192      <command>sendmail</command> command from an <xref linkend="server-mail"/>
     193      package to email you the results of the <command>fcron</command> script.
     194      This switch is used to disable default email notification. Omit the
     195      switch to enable the default. Alternatively, you can use the
     196      <option>--with-sendmail=<replaceable>&lt;/path/to/MTA
     197      command&gt;</replaceable></option> to use a different mailer command.
     198    </para>
     199
     200    <para>
     201      <parameter>--with-boot-install=no</parameter>: This prevents
     202      installation of the bootscript included with the package.
     203    </para>
     204
     205    <para revision="systemd">
     206      <parameter>--with-piddir=/run</parameter>:
     207      This fixes the systemd unit to use the proper directory for PID files so
     208      that systemctl does not hang and the unit starts correctly.
     209    </para>
     210
     211    <para revision="sysv">
     212      <parameter>--with-systemdsystemunitdir=no</parameter>:
     213      This prevents building the <application>systemd</application> units,
     214      which are not needed for a <application>SYS V</application> system.
     215    </para>
     216
     217    <para>
     218      <option>--with-editor=<replaceable>&lt;/path/to/editor&gt;</replaceable></option>:
     219      This switch allows you to set the default text editor.
     220    </para>
     221
     222    <para>
     223      <option>--with-dsssl-dir=<replaceable>&lt;/path/to/dsssl-stylesheets&gt;</replaceable></option>:
     224      May be used if you have <xref linkend="docbook-utils"/> installed.
     225      Currently, the dsssl stylesheets are located at
     226    <filename class="directory">/usr/share/sgml/docbook/dsssl-stylesheets-1.79</filename>.
     227    </para>
    184228
    185229  </sect2>
     
    191235      <title>Config Files</title>
    192236
    193       <para><filename>/etc/fcron.conf</filename>,
    194       <filename>/etc/fcron.allow</filename>, and
    195       <filename>/etc/fcron.deny</filename></para>
     237      <para>
     238        <filename>/etc/fcron.conf</filename>,
     239        <filename>/etc/fcron.allow</filename>, and
     240        <filename>/etc/fcron.deny</filename>
     241      </para>
    196242
    197243      <indexterm zone="fcron fcron-config">
     
    212258      <title>Configuration Information</title>
    213259
    214       <para>There are no required changes in any of the config files.
    215       Configuration information can be found in the man page for
    216       <filename>fcron.conf</filename>.</para>
    217 
    218       <para><command>fcron</command> scripts are written using
    219       <command>fcrontab</command>. Refer to the <command>fcrontab</command> man
    220       page for proper parameters to address your situation.</para>
    221 
    222       <para id="fcron-pam">If <application>Linux-PAM</application>
    223       is installed, two PAM configuration files are installed in
    224       <filename class='directory'>/etc/pam.d</filename>. Alternatively if
    225       <filename class='directory'>/etc/pam.d</filename> is not used, the
    226       installation will append two configuration sections to the existing
    227       <filename>/etc/pam.conf</filename> file. You should ensure the files match
    228       your preferences. Modify them as required to suit your needs.</para>
     260      <para>
     261        There are no required changes in any of the config files.
     262        Configuration information can be found in the man page for
     263        <filename>fcron.conf</filename>.
     264      </para>
     265
     266      <para>
     267        <command>fcron</command> scripts are written using
     268        <command>fcrontab</command>. Refer to the <command>fcrontab</command>
     269        man page for proper parameters to address your situation.
     270      </para>
     271
     272      <para id="fcron-pam">
     273        If <application>Linux-PAM</application> is installed, two PAM
     274        configuration files are installed in <filename class='directory'>
     275        etc/pam.d</filename>. Alternatively if <filename class='directory'>
     276        etc/pam.d</filename> is not used, the installation will append two
     277        configuration sections to the existing <filename>/etc/pam.conf
     278        </filename> file. You should ensure the files match your preferences.
     279        Modify them as required to suit your needs.
     280      </para>
    229281
    230282      <indexterm zone="fcron fcron-pam">
     
    322374             <phrase revision="systemd">Systemd Unit</phrase></title>
    323375
    324       <para revision="sysv">Install the
    325       <filename>/etc/rc.d/init.d/fcron</filename> init script from the
    326       <xref linkend="bootscripts"/> package.</para>
    327 
    328       <para revision="systemd">Enable <application>fcron</application> to start
    329       at boot using the previously installed systemd unit.</para>
     376      <para revision="sysv">
     377        Install the
     378        <filename>/etc/rc.d/init.d/fcron</filename> init script from the
     379        <xref linkend="bootscripts"/> package.
     380      </para>
     381
     382      <para revision="systemd">
     383        Enable <application>fcron</application> to start
     384        at boot using the previously installed systemd unit.
     385      </para>
    330386
    331387      <indexterm zone="fcron fcron-init">
     
    337393<screen role="root" revision="systemd"><userinput>systemctl enable fcron</userinput></screen>
    338394
    339       <para>Finally, again as the <systemitem class="username">root</systemitem>
    340       user, start fcron and generate the
    341       <filename>/var/spool/fcron/systab</filename> file:</para>
     395      <para>
     396        Finally, again as the <systemitem class="username">root</systemitem>
     397        user, start fcron and generate the
     398        <filename>/var/spool/fcron/systab</filename> file:
     399      </para>
    342400
    343401<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/fcron start &amp;&amp;
     
    373431        <term><command>fcron</command></term>
    374432        <listitem>
    375           <para>is the scheduling daemon.</para>
     433          <para>
     434            is the scheduling daemon.
     435          </para>
    376436          <indexterm zone="fcron fcron-prog">
    377437            <primary sortas="b-fcron">fcron</primary>
     
    383443        <term><command>fcrondyn</command></term>
    384444        <listitem>
    385           <para>is a user tool intended to interact with a running
    386           <command>fcron</command> daemon.</para>
     445          <para>
     446            is a user tool intended to interact with a running
     447            <command>fcron</command> daemon.
     448          </para>
    387449          <indexterm zone="fcron fcrondyn">
    388450            <primary sortas="b-fcrondyn">fcrondyn</primary>
     
    394456        <term><command>fcronsighup</command></term>
    395457        <listitem>
    396           <para>instructs <command>fcron</command> to reread the
    397           <application>Fcron</application> tables.</para>
     458          <para>
     459            instructs <command>fcron</command> to reread the
     460            <application>Fcron</application> tables.
     461          </para>
    398462          <indexterm zone="fcron fcronsighup">
    399463            <primary sortas="b-fcronsighup">fcronsighup</primary>
     
    405469        <term><command>fcrontab</command></term>
    406470        <listitem>
    407           <para>is a program used to install, edit, list and remove the
    408           tables used by <command>fcron</command>.</para>
     471          <para>
     472            is a program used to install, edit, list and remove the
     473            tables used by <command>fcron</command>.
     474          </para>
    409475          <indexterm zone="fcron fcrontab">
    410476            <primary sortas="b-fcrontab">fcrontab</primary>
  • general/sysutils/gpm.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to GPM</title>
    3131
    32     <para>The <application>GPM</application> (General Purpose Mouse
    33     daemon) package contains a mouse server for the console and
    34     <command>xterm</command>. It not only provides cut and paste support
    35     generally, but its library component is used by various software such as
    36     <application>Links</application> to provide mouse support to the application.
    37     It is useful on desktops, especially if following (Beyond) Linux From Scratch
    38     instructions; it's often much easier (and less error prone) to cut and paste
    39     between two console windows than to type everything by hand!</para>
     32    <para>
     33      The <application>GPM</application> (General Purpose Mouse daemon)
     34      package contains a mouse server for the console and
     35      <command>xterm</command>. It not only provides cut and paste support
     36      generally, but its library component is used by various software such as
     37      <application>Links</application> to provide mouse support to the
     38      application.  It is useful on desktops, especially if following (Beyond)
     39      Linux From Scratch instructions; it's often much easier (and less error
     40      prone) to cut and paste between two console windows than to type
     41      everything by hand!
     42    </para>
    4043
    4144    &lfs91_checked;
     
    4447    <itemizedlist spacing="compact">
    4548      <listitem>
    46         <para>Download (HTTP): <ulink url="&gpm-download-http;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download (FTP): <ulink url="&gpm-download-ftp;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download MD5 sum: &gpm-md5sum;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Download size: &gpm-size;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated disk space required: &gpm-buildsize;</para>
    59       </listitem>
    60       <listitem>
    61         <para>Estimated build time: &gpm-time;</para>
     49        <para>
     50          Download (HTTP): <ulink url="&gpm-download-http;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download (FTP): <ulink url="&gpm-download-ftp;"/>
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download MD5 sum: &gpm-md5sum;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Download size: &gpm-size;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated disk space required: &gpm-buildsize;
     71        </para>
     72      </listitem>
     73      <listitem>
     74        <para>
     75          Estimated build time: &gpm-time;
     76        </para>
    6277      </listitem>
    6378    </itemizedlist>
     
    100115
    101116
    102     <para>Install <application>GPM</application> by running
    103     the following commands:</para>
     117    <para>
     118      Install <application>GPM</application> by running
     119      the following commands:
     120    </para>
    104121
    105122<screen><userinput>sed -i -e 's:&lt;gpm.h&gt;:"headers/gpm.h":' src/prog/{display-buttons,display-coords,get-versions}.c &amp;&amp;
     
    109126make</userinput></screen>
    110127
    111     <para>This package does not come with a test suite.</para>
    112 
    113     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     128    <para>
     129      This package does not come with a test suite.
     130    </para>
     131
     132    <para>
     133      Now, as the <systemitem class="username">root</systemitem> user:
     134    </para>
    114135
    115136<screen role="root"><userinput>make install                                          &amp;&amp;
     
    132153    <title>Command Explanations</title>
    133154
    134     <para><command>./autogen.sh</command>: This command creates the missing
    135     <command>configure</command> script.</para>
    136 
    137     <para><command>install-info ...</command>: This package installs an
    138     <filename class="extension">.info</filename> file, but does not update the
    139     system <filename>dir</filename> file. This command makes the update.</para>
    140 
    141     <para><command>ln -v -sfn libgpm.so.2.1.0 /usr/lib/libgpm.so</command>: This
    142     command is used to create (or update) the <filename class="extension">.so</filename>
    143     symlink to the library.</para>
     155    <para>
     156      <command>./autogen.sh</command>: This command creates the missing
     157      <command>configure</command> script.
     158    </para>
     159
     160    <para>
     161      <command>install-info ...</command>: This package installs a
     162      <filename class="extension">.info</filename> file, but does not update
     163      the system <filename>dir</filename> file. This command makes the update.
     164    </para>
     165
     166    <para>
     167      <command>ln -v -sfn libgpm.so.2.1.0 /usr/lib/libgpm.so</command>: This
     168      command is used to create (or update) the <filename
     169      class="extension">.so</filename> symlink to the library.
     170    </para>
    144171
    145172  </sect2>
     
    156183      </indexterm>
    157184
    158       <para revision="sysv">Install the
    159       <filename>/etc/rc.d/init.d/gpm</filename> init script included in the
    160       <xref linkend="bootscripts"/> package.</para>
     185      <para revision="sysv">
     186        Install the
     187        <filename>/etc/rc.d/init.d/gpm</filename> init script included in the
     188        <xref linkend="bootscripts"/> package.
     189      </para>
    161190
    162191      <para revision="systemd">
     
    174203      <title>Config Files</title>
    175204
    176       <para><filename>/etc/gpm-root.conf</filename> and
    177       <filename>~/.gpm-root</filename>: The default and individual user
    178       <command>gpm-root</command> configuration files.</para>
    179 
    180       <para revision="sysv"><filename>/etc/sysconfig/mouse</filename>:
    181       This file contains the name of your mouse device and the protocol
    182       it uses.  To create this file, run the following as the
    183       <systemitem class="username">root</systemitem> user:</para>
     205      <para>
     206        <filename>/etc/gpm-root.conf</filename> and
     207        <filename>~/.gpm-root</filename>: The default and individual user
     208        <command>gpm-root</command> configuration files.
     209      </para>
     210
     211      <para revision="sysv">
     212        <filename>/etc/sysconfig/mouse</filename>:
     213        This file contains the name of your mouse device and the protocol
     214        it uses.  To create this file, run the following as the
     215        <systemitem class="username">root</systemitem> user:
     216      </para>
    184217
    185218<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"
     
    210243      <title>Configuration Information</title>
    211244
    212       <para revision="sysv">Examples of values to set <envar>MDEVICE</envar>,
    213       <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para>
     245      <para revision="sysv">
     246        Examples of values to set <envar>MDEVICE</envar>,
     247        <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:
     248      </para>
    214249
    215250<screen revision="sysv"><literal>MDEVICE="/dev/input/mice"
     
    217252GPMOPTS=""</literal></screen>
    218253
    219       <para revision="sysv">A list of which protocol values are known can be
    220       found by running
    221       <command>gpm -m <replaceable>[device]</replaceable> -t -help</command>.
    222       The <envar>MDEVICE</envar> setting depends on which type of mouse you
    223       have.  For example, <filename>/dev/ttyS0</filename> for a serial mouse
    224       (on Windows this is COM1), <filename>/dev/input/mice</filename> is often
    225       used for USB mice and <filename>/dev/psaux</filename> for PS2 mice.
    226       <envar>GPMOPTS</envar> is the 'catch all' for any additional options that
    227       are needed for your hardware.</para>
     254      <para revision="sysv">
     255        A list of which protocol values are known can be found by running
     256        <command>gpm -m <replaceable>[device]</replaceable> -t -help</command>.
     257        The <envar>MDEVICE</envar> setting depends on which type of mouse you
     258        have.  For example, <filename>/dev/ttyS0</filename> for a serial mouse
     259        (on Windows this is COM1), <filename>/dev/input/mice</filename> is
     260        often used for USB mice and <filename>/dev/psaux</filename> for PS2
     261        mice. <envar>GPMOPTS</envar> is the 'catch all' for any additional
     262        options that are needed for your hardware.
     263      </para>
    228264
    229265      <para revision="systemd">
     
    270306        <term><command>disable-paste</command></term>
    271307        <listitem>
    272           <para>is a security mechanism used to disable the paste buffer.</para>
     308          <para>
     309            is a security mechanism used to disable the paste buffer.
     310          </para>
    273311          <indexterm zone="gpm disable-paste">
    274312            <primary sortas="b-disable-paste">disable-paste</primary>
     
    280318        <term><command>display-buttons</command></term>
    281319        <listitem>
    282           <para>is a simple program that reports the mouse buttons being
    283           pressed and released.</para>
     320          <para>
     321            is a simple program that reports the mouse buttons being
     322            pressed and released.
     323          </para>
    284324          <indexterm zone="gpm display-buttons">
    285325            <primary sortas="b-display-buttons">display-buttons</primary>
     
    291331        <term><command>display-coords</command></term>
    292332        <listitem>
    293           <para>is a simple program that reports the mouse coordinates.</para>
     333          <para>
     334            is a simple program that reports the mouse coordinates.
     335          </para>
    294336          <indexterm zone="gpm display-coords">
    295337            <primary sortas="b-display-coords">display-coords</primary>
     
    301343        <term><command>get-versions</command></term>
    302344        <listitem>
    303           <para>is used to report the <application>GPM</application> library
    304           and server versions.</para>
     345          <para>
     346            is used to report the <application>GPM</application> library
     347            and server versions.
     348          </para>
    305349          <indexterm zone="gpm get-versions">
    306350            <primary sortas="b-get-versions">get-versions</primary>
     
    312356        <term><command>gpm</command></term>
    313357        <listitem>
    314           <para>is a cut and paste utility and mouse server for virtual consoles.</para>
     358          <para>
     359            is a cut and paste utility and mouse server for virtual consoles.
     360          </para>
    315361          <indexterm zone="gpm gpm-prog">
    316362            <primary sortas="b-gpm">gpm</primary>
     
    322368        <term><command>gpm-root</command></term>
    323369        <listitem>
    324           <para>is a default handler for <command>gpm</command>. It is used to
    325           draw menus on the root window.</para>
     370          <para>
     371            is a default handler for <command>gpm</command>. It is used to
     372            draw menus on the root window.
     373          </para>
    326374          <indexterm zone="gpm gpm-root">
    327375            <primary sortas="b-gpm-root">gpm-root</primary>
     
    333381        <term><command>hltest</command></term>
    334382        <listitem>
    335           <para>is a simple sample application using the high-level library,
    336           meant to be read by programmers trying to use the high-level library.</para>
     383          <para>
     384            is a simple sample application using the high-level library, meant
     385            to be read by programmers trying to use the high-level library.
     386          </para>
    337387          <indexterm zone="gpm hltest">
    338388            <primary sortas="b-hltest">hltest</primary>
     
    344394        <term><command>mev</command></term>
    345395        <listitem>
    346           <para>is a program to report mouse events.</para>
     396          <para>
     397            is a program to report mouse events.
     398          </para>
    347399          <indexterm zone="gpm mev">
    348400            <primary sortas="b-mev">mev</primary>
     
    354406        <term><command>mouse-test</command></term>
    355407        <listitem>
    356           <para>is a tool for determining the mouse type and device it's
    357           attached to.</para>
     408          <para>
     409            is a tool for determining the mouse type and device it's
     410            attached to.
     411          </para>
    358412          <indexterm zone="gpm mouse-test">
    359413            <primary sortas="b-mouse-test">mouse-test</primary>
     
    365419        <term><filename class='libraryfile'>libgpm.{so.a}</filename></term>
    366420        <listitem>
    367           <para>contains the API functions to access the
    368           <application>GPM</application> daemon.</para>
     421          <para>
     422            contains the API functions to access the
     423            <application>GPM</application> daemon.
     424          </para>
    369425          <indexterm zone="gpm libgpm">
    370426            <primary sortas="c-libgpm">libgpm.{so,a}</primary>
  • general/sysutils/logrotate.xml

    r09f0998 rb1532549  
    3131
    3232    <para>
    33       The <application>logrotate</application> package allows automatic rotation,
    34       compression, removal, and mailing of log files.
     33      The <application>logrotate</application> package allows automatic
     34      rotation, compression, removal, and mailing of log files.
    3535    </para>
    3636
     
    119119
    120120  <sect2 role="configuration">
    121      <title>Configuring Logrotate</title>
    122 
    123      <para><application>Logrotate</application> needs a configuration file,
    124      which must be passed as an argument to the command when executed.  Create
    125      the file as the <systemitem class="username">root</systemitem> user:</para>
     121    <title>Configuring Logrotate</title>
     122
     123    <para>
     124      <application>Logrotate</application> needs a configuration file,
     125      which must be passed as an argument to the command when executed.  Create
     126      the file as the <systemitem class="username">root</systemitem> user:
     127    </para>
    126128
    127129<screen role="root"><userinput>cat &gt; /etc/logrotate.conf &lt;&lt; EOF
     
    170172chmod -v 0644 /etc/logrotate.conf</userinput></screen>
    171173
    172     <para>Now create the <filename class='directory'>/etc/logrotate.d</filename>
    173     directory as the  <systemitem class="username">root</systemitem> user:</para>
     174    <para>
     175      Now create the <filename class='directory'>/etc/logrotate.d</filename>
     176      directory as the  <systemitem class="username">root</systemitem> user:
     177    </para>
    174178
    175179<screen role="root"><userinput>mkdir -p /etc/logrotate.d</userinput></screen>
    176180
    177   <para>At this point additional log rotation commands can be entered, typically
    178   in the <filename class='directory'>/etc/logrotate.d</filename> directory.
    179   For example:</para>
     181    <para>
     182      At this point additional log rotation commands can be entered, typically
     183      in the <filename class='directory'>/etc/logrotate.d</filename> directory.
     184      For example:
     185    </para>
    180186
    181187<screen role="nodump"><userinput>cat &gt; /etc/logrotate.d/sys.log &lt;&lt; EOF
     
    193199chmod -v 0644 /etc/logrotate.d/sys.log</userinput></screen>
    194200
    195   <para>You can designate multiple files in one entry:</para>
     201    <para>
     202      You can designate multiple files in one entry:
     203    </para>
    196204
    197205<screen role="nodump"><userinput>cat &gt; /etc/logrotate.d/example.log &lt;&lt; EOF
     
    208216chmod -v 0644 /etc/logrotate.d/example.log</userinput></screen>
    209217
    210   <para>You can use in the same line the list of files: file1 file2 file3.
    211   See the logrotate man page or
    212   <ulink url='http://www.techrepublic.com/article/manage-linux-log-files-with-logrotate/'/>
    213   for more examples.</para>
    214 
    215   <para>The command <command>logrotate /etc/logrotate.conf</command> can be
    216   run manually, however, the command should be run daily.
    217   Other useful commands are <command>logrotate -d /etc/logrotate.conf</command>
    218   for debugging purposes and <command>logrotate -f /etc/logrotate.conf</command>
    219   forcing the logrotate commands to be run immediately. Combining the previous
    220   options <option>-df</option>, you can debug the effect of the force command.
    221   When debugging, the command is only simulated, not really run, thus, eventual
    222   non-existing errors appear, when some intermediate files are expected,
    223   because they are not actually created.</para>
     218    <para>
     219      You can use in the same line the list of files: file1 file2 file3.
     220      See the logrotate man page or <ulink
     221      url='http://www.techrepublic.com/article/manage-linux-log-files-with-logrotate/'/>
     222      for more examples.
     223    </para>
     224
     225    <para>
     226      The command <command>logrotate /etc/logrotate.conf</command> can be
     227      run manually, however, the command should be run daily.
     228      Other useful commands are <command>logrotate -d
     229      /etc/logrotate.conf</command> for debugging purposes and
     230      <command>logrotate -f /etc/logrotate.conf</command> forcing the
     231      logrotate commands to be run immediately. Combining the previous options
     232      <option>-df</option>, you can debug the effect of the force command.
     233      When debugging, the command is only simulated, not really run, thus,
     234      eventual non-existing errors appear, when some intermediate files are
     235      expected, because they are not actually created.
     236    </para>
    224237
    225238    <para>
  • general/sysutils/lsb-tools.xml

    r09f0998 rb1532549  
    3131    <title>Introduction to LSB-Tools</title>
    3232
    33     <para>The <application>LSB-Tools</application> package includes tools
    34     for Linux Standards Base (LSB) conformance.</para>
     33    <para>
     34      The <application>LSB-Tools</application> package includes tools
     35      for Linux Standards Base (LSB) conformance.
     36    </para>
    3537
    3638    &lfs91_checked;
     
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&lsb-tools-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&lsb-tools-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&lsb-tools-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&lsb-tools-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &lsb-tools-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &lsb-tools-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &lsb-tools-size;</para>
     58        <para>
     59          Download size: &lsb-tools-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &lsb-tools-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &lsb-tools-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &lsb-tools-time;</para>
     68        <para>
     69          Estimated build time: &lsb-tools-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
     
    6680    <title>Installation of LSB-Tools</title>
    6781
    68     <para>Install <application>lsb_release</application> by running the following
    69     commands:</para>
     82    <para>
     83      Install <application>lsb_release</application> by running the following
     84      commands:
     85    </para>
    7086
    7187<screen><userinput>python3 setup.py build</userinput></screen>
    7288
    73      <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     89    <para>
     90      Now, as the <systemitem class="username">root</systemitem> user:
     91    </para>
    7492
    7593<screen role="root"><userinput>python3 setup.py install --optimize=1</userinput></screen>
     
    124142        <term><command>lsb_release</command></term>
    125143        <listitem>
    126           <para>is a script to give LSB data.</para>
     144          <para>
     145            is a script to give LSB data.
     146          </para>
    127147          <indexterm zone="lsb-tools lsb_release">
    128148            <primary sortas="b-lsb-tools">lsb_release</primary>
     
    133153        <term><command>install_initd</command></term>
    134154        <listitem>
    135           <para>is a script to activate SysV startup scripts.</para>
     155          <para>
     156            is a script to activate SysV startup scripts.
     157          </para>
    136158          <indexterm zone="lsb-tools install_initd">
    137159            <primary sortas="b-lsb-tools">install_initd</primary>
     
    142164        <term><command>remove_initd</command></term>
    143165        <listitem>
    144           <para>is a script to deactivate SysV startup scripts.</para>
     166          <para>
     167            is a script to deactivate SysV startup scripts.
     168          </para>
    145169          <indexterm zone="lsb-tools remove_initd">
    146170            <primary sortas="b-lsb-tools">remove_initd</primary>
  • general/sysutils/mc.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to MC</title>
    3131
    32     <para><application>MC</application> (Midnight Commander) is a text-mode
    33     full-screen file manager and visual shell. It provides a clear,
    34     user-friendly, and somewhat protected interface to a Unix system while
    35     making many frequent file operations more efficient and preserving the
    36     full power of the command prompt.</para>
     32    <para>
     33      <application>MC</application> (Midnight Commander) is a text-mode
     34      full-screen file manager and visual shell. It provides a clear,
     35      user-friendly, and somewhat protected interface to a Unix system while
     36      making many frequent file operations more efficient and preserving the
     37      full power of the command prompt.
     38    </para>
    3739
    3840    &lfs91_checked;
    3941
    40     <!--<note><para>The download site uses a self-signed security certificate.
    41     You will need to accept it as valid to get the source code.</para></note>-->
     42    <!--<note>
     43      <para>
     44        The download site uses a self-signed security certificate.
     45        You will need to accept it as valid to get the source code.
     46      </para>
     47    </note>-->
    4248
    4349    <bridgehead renderas="sect3">Package Information</bridgehead>
    4450    <itemizedlist spacing="compact">
    4551      <listitem>
    46         <para>Download (HTTP): <ulink url="&mc-download-http;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download (FTP): <ulink url="&mc-download-ftp;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download MD5 sum: &mc-md5sum;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Download size: &mc-size;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated disk space required: &mc-buildsize;</para>
    59       </listitem>
    60       <listitem>
    61         <para>Estimated build time: &mc-time;</para>
     52        <para>
     53          Download (HTTP): <ulink url="&mc-download-http;"/>
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download (FTP): <ulink url="&mc-download-ftp;"/>
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Download MD5 sum: &mc-md5sum;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Download size: &mc-size;
     69        </para>
     70      </listitem>
     71      <listitem>
     72        <para>
     73          Estimated disk space required: &mc-buildsize;
     74        </para>
     75      </listitem>
     76      <listitem>
     77        <para>
     78          Estimated build time: &mc-time;
     79        </para>
    6280      </listitem>
    6381    </itemizedlist>
     
    94112    <title>Installation of MC</title>
    95113
    96     <para>Install <application>MC</application> by
    97     running the following commands:</para>
     114    <para>
     115      Install <application>MC</application> by
     116      running the following commands:
     117    </para>
    98118
    99119<screen><userinput>./configure --prefix=/usr \
     
    102122make</userinput></screen>
    103123
    104     <para>To test the results, issue: <command>make check</command>.
    105     One test concerning rpm files fails.</para>
    106 
    107     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     124    <para>
     125      To test the results, issue: <command>make check</command>.
     126      One test concerning rpm files fails.
     127    </para>
     128
     129    <para>
     130      Now, as the <systemitem class="username">root</systemitem> user:
     131    </para>
    108132
    109133<screen role="root"><userinput>make install &amp;&amp;
     
    115139    <title>Command Explanations</title>
    116140
    117     <para><parameter>--sysconfdir=/etc</parameter>: This switch places the
    118     global configureation directory in <filename
    119     class="directory">/etc</filename>.</para>
    120 
    121     <para><parameter>--enable-charset</parameter>: This switch adds support
    122     to <command>mcedit</command> for editing files in encodings different
    123     from the one implied by the current locale.</para>
     141    <para>
     142      <parameter>--sysconfdir=/etc</parameter>: This switch places the
     143      global configureation directory in <filename
     144      class="directory">/etc</filename>.
     145    </para>
     146
     147    <para>
     148      <parameter>--enable-charset</parameter>: This switch adds support
     149      to <command>mcedit</command> for editing files in encodings different
     150      from the one implied by the current locale.
     151    </para>
    124152<!-- currently broken
    125     <para><parameter>- -with-screen=ncurses</parameter>: This switch
    126     selects the screen library used by <application>MC</application>. It is only
    127     required if the optional <xref linkend="slang"/> package is not installed
    128     which is the default if found.</para>
     153    <para>
     154      <parameter>- -with-screen=ncurses</parameter>: This switch
     155      selects the screen library used by <application>MC</application>. It is
     156      only required if the optional <xref linkend="slang"/> package is not
     157      installed which is the default if found.
     158    </para>
    129159-->
    130160  </sect2>
     
    136166      <title>Config Files</title>
    137167
    138       <para><filename>~/.config/mc/*</filename></para>
     168      <para>
     169        <filename>~/.config/mc/*</filename>
     170      </para>
    139171
    140172      <indexterm zone="mc mc-config">
     
    147179      <title>Configuration Information</title>
    148180
    149       <para>The <filename class="directory">~/.config/mc</filename> directory and
    150       its contents are created when you start <command>mc</command> for the
    151       first time. Then you can edit the main <filename>~/.config/mc/ini</filename>
    152       configuration file manually or through the <application>MC</application>
    153       shell. Consult the mc(1) man page for details.</para>
    154 
    155       <note><para> On 8.x versions of <application>mc</application>,
    156       keybind names used in mc.keymap.* files are changed.  This is
    157       described in <filename>keybind-migration.txt</filename>.</para></note>
     181      <para>
     182        The <filename class="directory">~/.config/mc</filename> directory and
     183        its contents are created when you start <command>mc</command> for the
     184        first time. Then you can edit the main <filename>~/.config/mc/ini
     185        </filename> configuration file manually or through the <application>
     186        MC</application> shell. Consult the mc(1) man page for details.
     187      </para>
     188
     189      <note>
     190        <para>
     191          On 8.x versions of <application>mc</application>,
     192          keybind names used in mc.keymap.* files are changed.  This is
     193          described in <filename>keybind-migration.txt</filename>.
     194        </para>
     195      </note>
    158196
    159197    </sect3>
     
    184222        <term><command>cons.saver</command></term>
    185223        <listitem>
    186           <para>is used internally by <command>mc</command> for saving and
    187           restoring the text behind the panels on Linux text console.</para>
     224          <para>
     225            is used internally by <command>mc</command> for saving and
     226            restoring the text behind the panels on Linux text console.
     227          </para>
    188228          <indexterm zone="mc conssaver">
    189229            <primary sortas="b-conssaver">cons.saver</primary>
     
    195235        <term><command>mc</command></term>
    196236        <listitem>
    197           <para>is a visual shell.</para>
     237          <para>
     238            is a visual shell.
     239          </para>
    198240          <indexterm zone="mc mc-prog">
    199241            <primary sortas="b-mc">mc</primary>
     
    205247        <term><command>mcdiff</command></term>
    206248        <listitem>
    207           <para>is an internal visual diff tool.</para>
     249          <para>
     250            is an internal visual diff tool.
     251          </para>
    208252          <indexterm zone="mc mcdiff">
    209253            <primary sortas="b-mcdiff">mcdiff</primary>
     
    215259        <term><command>mcedit</command></term>
    216260        <listitem>
    217           <para>is an internal file editor.</para>
     261          <para>
     262            is an internal file editor.
     263          </para>
    218264          <indexterm zone="mc mcedit">
    219265            <primary sortas="b-mcedit">mcedit</primary>
     
    225271        <term><command>mcview</command></term>
    226272        <listitem>
    227           <para>is an internal file viewer.</para>
     273          <para>
     274            is an internal file viewer.
     275          </para>
    228276          <indexterm zone="mc mcview">
    229277            <primary sortas="b-mcview">mcview</primary>
  • general/sysutils/p7zip.xml

    r09f0998 rb1532549  
    111111     DEST_SHARE_DOC=/usr/share/doc/p7zip-&p7zip-version; install</userinput></screen>
    112112
    113     <note><para>If using DESTDIR techniques, use DEST_DIR instead.</para></note>
     113    <note>
     114      <para>
     115        If using DESTDIR techniques, use DEST_DIR instead.
     116      </para>
     117    </note>
    114118
    115119  </sect2>
  • general/sysutils/redland.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to Redland</title>
    3131
    32     <para><application>Redland</application> is a set of free software C libraries
    33     that provide support for the Resource Description Framework (RDF). </para>
     32    <para>
     33      <application>Redland</application> is a set of free software C libraries
     34      that provide support for the Resource Description Framework (RDF).
     35    </para>
    3436
    3537    &lfs91_checked;
     
    3840    <itemizedlist spacing="compact">
    3941      <listitem>
    40         <para>Download (HTTP): <ulink url="&redland-download-http;"/></para>
     42        <para>
     43          Download (HTTP): <ulink url="&redland-download-http;"/>
     44        </para>
    4145      </listitem>
    4246      <listitem>
    43         <para>Download (FTP): <ulink url="&redland-download-ftp;"/></para>
     47        <para>
     48          Download (FTP): <ulink url="&redland-download-ftp;"/>
     49        </para>
    4450      </listitem>
    4551      <listitem>
    46         <para>Download MD5 sum: &redland-md5sum;</para>
     52        <para>
     53          Download MD5 sum: &redland-md5sum;
     54        </para>
    4755      </listitem>
    4856      <listitem>
    49         <para>Download size: &redland-size;</para>
     57        <para>
     58          Download size: &redland-size;
     59        </para>
    5060      </listitem>
    5161      <listitem>
    52         <para>Estimated disk space required: &redland-buildsize;</para>
     62        <para>
     63          Estimated disk space required: &redland-buildsize;
     64        </para>
    5365      </listitem>
    5466      <listitem>
    55         <para>Estimated build time: &redland-time;</para>
     67        <para>
     68          Estimated build time: &redland-time;
     69        </para>
    5670      </listitem>
    5771    </itemizedlist>
     
    8397    <title>Installation of Redland</title>
    8498
    85     <para>Install <application>Redland</application> by running the following
    86     commands:</para>
     99    <para>
     100      Install <application>Redland</application> by running the following
     101      commands:
     102    </para>
    87103
    88104<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
    89105make</userinput></screen>
    90106
    91     <para>To test the results, issue <command>make check</command>.</para>
     107    <para>
     108      To test the results, issue <command>make check</command>.
     109    </para>
    92110
    93     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     111    <para>
     112      Now, as the <systemitem class="username">root</systemitem> user:
     113    </para>
    94114
    95115<screen role="root"><userinput>make install</userinput></screen>
     
    129149        <term><command>rdfproc</command></term>
    130150        <listitem>
    131           <para>is the Redland RDF processor utility.</para>
     151          <para>
     152            is the Redland RDF processor utility.
     153          </para>
    132154          <indexterm zone="redland rdfproc">
    133155            <primary sortas="b-rdfproc">rdfproc</primary>
     
    139161        <term><command>redland-config</command></term>
    140162        <listitem>
    141           <para>is a script to get information about the installed version
    142           of Redland.</para>
     163          <para>
     164            is a script to get information about the installed version
     165            of Redland.
     166          </para>
    143167          <indexterm zone="redland redland-config">
    144168            <primary sortas="b-redland-config">redland-config</primary>
     
    150174        <term><command>redland-db-upgrade</command></term>
    151175        <listitem>
    152           <para>upgrades older Redland databases to 0.9.12 format.</para>
     176          <para>
     177            upgrades older Redland databases to 0.9.12 format.
     178          </para>
    153179          <indexterm zone="redland redland-db-upgrade">
    154180            <primary sortas="b-redland-db-upgrade">redland-db-upgrade</primary>
  • general/sysutils/sysstat.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to Sysstat</title>
    3131
    32     <para>The <application>Sysstat</application> package contains utilities
    33     to monitor system performance and usage activity.
    34     <application>Sysstat</application> contains the <command>sar</command>
    35     utility, common to many commercial Unixes, and tools you can schedule via
    36     cron to collect and historize performance and activity data.</para>
     32    <para>
     33      The <application>Sysstat</application> package contains utilities
     34      to monitor system performance and usage activity.
     35      <application>Sysstat</application> contains the <command>sar</command>
     36      utility, common to many commercial Unixes, and tools you can schedule via
     37      cron to collect and historize performance and activity data.
     38    </para>
    3739
    3840    &lfs91_checked;
     
    4143    <itemizedlist spacing="compact">
    4244      <listitem>
    43         <para>Download (HTTP): <ulink url="&sysstat-download-http;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download (FTP): <ulink url="&sysstat-download-ftp;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download MD5 sum: &sysstat-md5sum;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Download size: &sysstat-size;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated disk space required: &sysstat-buildsize;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated build time: &sysstat-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&sysstat-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&sysstat-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &sysstat-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &sysstat-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &sysstat-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &sysstat-time;
     72        </para>
    5973      </listitem>
    6074    </itemizedlist>
     
    6276    <bridgehead renderas="sect3">Sysstat Dependencies</bridgehead>
    6377
    64     <para>There are no build-time requirements for this package; however,
    65     it is designed to be controlled by a cron daemon such as
    66     <xref linkend="fcron"/>.</para>
     78    <para role="recommended">
     79      There are no build-time requirements for this package; however,
     80      it is designed to be controlled by a cron daemon such as
     81      <xref linkend="fcron" role="runtime"/>.
     82    </para>
    6783
    6884    <para condition="html" role="usernotes">User Notes:
     
    7490    <title>Installation of Sysstat</title>
    7591
    76     <para>Install <application>Sysstat</application> by running the
    77     following commands:</para>
     92    <para>
     93      Install <application>Sysstat</application> by running the
     94      following commands:
     95    </para>
    7896
    7997<screen><userinput>sa_lib_dir=/usr/lib/sa    \
     
    84102make</userinput></screen>
    85103
    86     <para>This package does not come with a test suite.</para>
    87 
    88     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     104    <para>
     105      This package does not come with a test suite.
     106    </para>
     107
     108    <para>
     109      Now, as the <systemitem class="username">root</systemitem> user:
     110    </para>
    89111
    90112<screen role="root"><userinput>make install</userinput></screen>
     
    109131    <title>Command Explanations</title>
    110132
    111     <para><envar>sa_lib_dir</envar>: This environment variable specifies the
    112     location of the package-specific library directory.</para>
    113 
    114     <para><envar>sa_dir</envar>: This environment variable specifies the
    115     location of the directory containing the data files.</para>
    116 
    117     <para><envar>conf_dir</envar>: This environment variable specifies the
    118     location of the system configuration directory.</para>
    119 
    120     <para><parameter>--disable-file-attr</parameter>: Do not set attributes on
    121     files being installed. This parameter causes the installation to ignore the
    122     man group variable resulting in the man files having
    123     <systemitem class="username">root</systemitem>:
    124     <systemitem class="groupname">root</systemitem> ownership.</para>
    125 
    126     <note><para>Run <command>./configure --help</command> to see other influential
    127     environment variables you can pass to <command>configure</command>. You may
    128     want to use the <envar>history</envar> and <envar>compressafter</envar>
    129     variables to customize the amount of data files kept on the system.</para></note>
     133    <para>
     134      <envar>sa_lib_dir</envar>: This environment variable specifies the
     135      location of the package-specific library directory.
     136    </para>
     137
     138    <para>
     139      <envar>sa_dir</envar>: This environment variable specifies the
     140      location of the directory containing the data files.
     141    </para>
     142
     143    <para>
     144      <envar>conf_dir</envar>: This environment variable specifies the
     145      location of the system configuration directory.
     146    </para>
     147
     148    <para>
     149      <parameter>--disable-file-attr</parameter>: Do not set attributes on
     150      files being installed. This parameter causes the installation to ignore
     151      the man group variable resulting in the man files having
     152      <systemitem class="username">root</systemitem>:
     153      <systemitem class="groupname">root</systemitem> ownership.
     154    </para>
     155
     156    <note>
     157      <para>
     158        Run <command>./configure --help</command> to see other influential
     159        environment variables you can pass to <command>configure</command>.
     160        You may want to use the <envar>history</envar> and
     161        <envar>compressafter</envar> variables to customize the amount of data
     162        files kept on the system.
     163      </para>
     164    </note>
    130165
    131166  </sect2>
     
    154189     <title>Cron Information</title>
    155190
    156       <para>To begin gathering <application>Sysstat</application> history
    157       information, you must add to, or create a privileged user's crontab. The
    158       history data location is
    159       <filename class="directory">/var/log/sa</filename>. The user running
    160       <application>Sysstat</application> utilities via cron must have write
    161       access to this location.</para>
    162 
    163       <para>Below is an example of what to install in the crontab. Adjust the
    164       parameters to suit your needs. Use <command>man sa1</command> and
    165       <command>man sa2</command> for information about the commands.</para>
     191      <para>
     192        To begin gathering <application>Sysstat</application> history
     193        information, you must add to, or create a privileged user's crontab.
     194        The history data location is
     195        <filename class="directory">/var/log/sa</filename>. The user running
     196        <application>Sysstat</application> utilities via cron must have write
     197        access to this location.
     198      </para>
     199
     200      <para>
     201        Below is an example of what to install in the crontab. Adjust the
     202        parameters to suit your needs. Use <command>man sa1</command> and
     203        <command>man sa2</command> for information about the commands.
     204      </para>
    166205
    167206<screen><literal># 8am-7pm activity reports every 10 minutes during weekdays
     
    1772165 19 * * * /usr/lib/sa/sa2 -A &amp;</literal></screen>
    178217
    179     <para>Ensure you submit the revised crontab to the cron daemon.</para>
     218      <para>
     219        Ensure you submit the revised crontab to the cron daemon.
     220      </para>
    180221
    181222    </sect3>
     
    188229      </indexterm>
    189230
    190       <para revision="sysv">At system startup, a LINUX RESTART message must be
    191       inserted in the daily data file to reinitialize the kernel counters. This
    192       can be automated by installing the
    193       <filename>/etc/rc.d/init.d/sysstat</filename> init script included in the
    194       <xref linkend="bootscripts"/> package using the following command as the
    195       <systemitem class="username">root</systemitem> user:</para>
     231      <para revision="sysv">
     232        At system startup, a LINUX RESTART message must be
     233        inserted in the daily data file to reinitialize the kernel counters.
     234        This can be automated by installing the
     235        <filename>/etc/rc.d/init.d/sysstat</filename> init script included in
     236        the <xref linkend="bootscripts"/> package using the following command
     237        as the <systemitem class="username">root</systemitem> user:
     238      </para>
    196239
    197240<screen role="root" revision="sysv"><userinput>make install-sysstat</userinput></screen>
    198241
    199       <para revision="systemd">At system startup, a LINUX RESTART message must
    200       be inserted in the daily data file to reinitialize the kernel counters.
    201       This can be automated by enabling the previously installed systemd unit
    202       by running the following command as the
    203       <systemitem class="username">root</systemitem> user:</para>
     242      <para revision="systemd">
     243        At system startup, a LINUX RESTART message must
     244        be inserted in the daily data file to reinitialize the kernel counters.
     245        This can be automated by enabling the previously installed systemd unit
     246        by running the following command as the
     247        <systemitem class="username">root</systemitem> user:
     248      </para>
    204249
    205250<screen role="root" revision="systemd"><userinput>systemctl enable sysstat</userinput></screen>
     
    235280        <term><command>cifsiostat</command></term>
    236281        <listitem>
    237           <para>displays statistics about read and write operations on CIFS
    238           filesystems.</para>
     282          <para>
     283            displays statistics about read and write operations on CIFS
     284            filesystems.
     285          </para>
    239286          <indexterm zone="sysstat cifsiostat">
    240287            <primary sortas="b-cifsiostat">cifsiostat</primary>
     
    246293        <term><command>iostat</command></term>
    247294        <listitem>
    248           <para>reports CPU statistics and input/output
    249           statistics for devices and partitions.</para>
     295          <para>
     296            reports CPU statistics and input/output
     297            statistics for devices and partitions.
     298          </para>
    250299          <indexterm zone="sysstat iostat">
    251300            <primary sortas="b-iostat">iostat</primary>
     
    257306        <term><command>mpstat</command></term>
    258307        <listitem>
    259           <para>writes activities for each available processor.</para>
     308          <para>
     309            writes activities for each available processor.
     310          </para>
    260311          <indexterm zone="sysstat mpstat">
    261312            <primary sortas="b-mpstat">mpstat</primary>
     
    267318        <term><command>pidstat</command></term>
    268319        <listitem>
    269           <para>is used for monitoring individual tasks currently being managed
    270           by the Linux kernel.</para>
     320          <para>
     321            is used for monitoring individual tasks currently being managed
     322            by the Linux kernel.
     323          </para>
    271324          <indexterm zone="sysstat pidstat">
    272325            <primary sortas="b-pidstat">pidstat</primary>
     
    278331        <term><command>sadf</command></term>
    279332        <listitem>
    280           <para>is used for displaying the contents of data files created by
    281           the <command>sar</command> command. But unlike
    282           <command>sar</command>, <command>sadf</command> can write its data
    283           in many different formats.</para>
     333          <para>
     334            is used for displaying the contents of data files created by
     335            the <command>sar</command> command. But unlike
     336            <command>sar</command>, <command>sadf</command> can write its data
     337            in many different formats.
     338          </para>
    284339          <indexterm zone="sysstat sadf">
    285340            <primary sortas="b-sadf">sadf</primary>
     
    291346        <term><command>sar</command></term>
    292347        <listitem>
    293           <para>is used for displaying the contents of elected cumulative activity
    294           counters in the operating system.</para>
     348          <para>
     349            is used for displaying the contents of elected cumulative activity
     350            counters in the operating system.
     351          </para>
    295352          <indexterm zone="sysstat sar">
    296353            <primary sortas="b-sar">sar</primary>
     
    302359        <term><command>tapestat</command></term>
    303360        <listitem>
    304           <para>is used for monitoring the activity of tape drives connected to
    305           a system.</para>
     361          <para>
     362            is used for monitoring the activity of tape drives connected to
     363            a system.
     364          </para>
    306365          <indexterm zone="sysstat tapestat">
    307366            <primary sortas="b-tapestat">tapestat</primary>
  • general/sysutils/systemd.xml

    r09f0998 rb1532549  
    4848    <itemizedlist spacing="compact">
    4949      <listitem>
    50         <para>Download (HTTP): <ulink url="&systemd-download-http;"/></para>
    51       </listitem>
    52       <listitem>
    53         <para>Download (FTP): <ulink url="&systemd-download-ftp;"/></para>
    54       </listitem>
    55       <listitem>
    56         <para>Download MD5 sum: &systemd-md5sum;</para>
    57       </listitem>
    58       <listitem>
    59         <para>Download size: &systemd-size;</para>
    60       </listitem>
    61       <listitem>
    62         <para>Estimated disk space required: &systemd-buildsize;</para>
    63       </listitem>
    64       <listitem>
    65         <para>Estimated build time: &systemd-time;</para>
     50        <para>
     51          Download (HTTP): <ulink url="&systemd-download-http;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download (FTP): <ulink url="&systemd-download-ftp;"/>
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download MD5 sum: &systemd-md5sum;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Download size: &systemd-size;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated disk space required: &systemd-buildsize;
     72        </para>
     73      </listitem>
     74      <listitem>
     75        <para>
     76          Estimated build time: &systemd-time;
     77        </para>
    6678      </listitem>
    6779    </itemizedlist>
     
    130142    <title>Installation of systemd</title>
    131143    <!-- 243-244 is now supported, so let's comment this for now.
    132     <warning><para>This version of systemd is incompatible with all previous
    133     releases. The BLFS team does not recommend updating in place, and suggests
    134     that you do a rebuild instead.</para></warning>
     144    <warning>
     145      <para>
     146        This version of systemd is incompatible with all previous
     147        releases. The BLFS team does not recommend updating in place, and
     148        suggests that you do a rebuild instead.
     149      </para>
     150    </warning>
    135151    -->
    136152
    137     <para>Apply a patch to fix problems with libseccomp-2.4.2+ and Linux-5.4+:</para>
     153    <para>
     154      Apply a patch to fix problems with libseccomp-2.4.2+ and Linux-5.4+:
     155    </para>
    138156
    139157<screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-seccomp_and_cpuaffinity_fix-1.patch</userinput></screen>
     
    146164         "test-execute" test. -->
    147165
    148     <para>Remove an unneeded group,
    149     <systemitem class="groupname">render</systemitem>, from the default udev
    150     rules:</para>
     166    <para>
     167      Remove an unneeded group,
     168      <systemitem class="groupname">render</systemitem>, from the default udev
     169      rules:
     170    </para>
    151171
    152172<screen><userinput remap="pre">sed -i 's/GROUP="render", //' rules.d/50-udev-default.rules.in</userinput></screen>
     
    189209
    190210    <para>
    191        To test the results, issue: <command>ninja test</command>. <!--One test,
    192        <filename>udev-test</filename> (test 273) fails due to changes in
    193        the Linux 5.3+ kernel. It does not affect the package's
    194        functionality. NO LONGER APPLICABLE AS OF 244 -->
     211      To test the results, issue: <command>ninja test</command>. <!--One test,
     212      <filename>udev-test</filename> (test 273) fails due to changes in
     213      the Linux 5.3+ kernel. It does not affect the package's
     214      functionality. NO LONGER APPLICABLE AS OF 244 -->
    195215    </para>
    196216
     
    216236<screen role="root"><userinput>ninja install</userinput></screen>
    217237  <!-- No longer needed as of systemd-244.
    218   <para>
    219     Remove a configuration file that causes some problems with PID files:
    220   </para>
     238    <para>
     239      Remove a configuration file that causes some problems with PID files:
     240    </para>
    221241
    222242<screen role="root"><userinput>rm -fv /etc/sysctl.d/50-pid-max.conf</userinput></screen>
     
    274294systemctl start multi-user.target</userinput></screen>
    275295
    276     <warning><para>If upgrading from a previous version of systemd and an
    277     initrd is used for system boot, you should generate a new initrd before
    278     rebooting the system.</para></warning>
     296    <warning>
     297      <para>
     298        If upgrading from a previous version of systemd and an
     299        initrd is used for system boot, you should generate a new initrd before
     300        rebooting the system.
     301      </para>
     302    </warning>
    279303
    280304  </sect2>
  • general/sysutils/sysutils.xml

    r09f0998 rb1532549  
    1616  <title>System Utilities</title>
    1717
    18   <para>This chapter contains mainly hardware utilities. It also contains
    19   some applications used by other applications in the book for
    20   installation or configuration purposes.</para>
     18  <para>
     19    This chapter contains mainly hardware utilities. It also contains
     20    some applications used by other applications in the book for
     21    installation or configuration purposes.
     22  </para>
    2123
    22   <!--systemd only -->
    2324  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="accountsservice.xml"/>
    24 
    2525  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acpid.xml"/>
    2626  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="at.xml"/>
     
    3030  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="colord.xml"/>
    3131  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cpio.xml"/>
    32 
    33   <!-- systemd only -->
    3432  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cups-pk-helper.xml"/>
    35 
    3633  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dbus.xml"/>
    3734
     
    4845  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mc.xml"/>
    4946
    50   <!-- systemd only -->
    5147  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="modemmanager.xml"/>
    52 
    53 <!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="obex-data-server.xml"/>-->
    5448  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="p7zip.xml"/>
    5549  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pax.xml"/>
     
    6559  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="systemd.xml"/>
    6660
    67   <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="udisks.xml"/>-->
    6861  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="udisks2.xml"/>
    6962  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="unrar.xml"/>
  • general/sysutils/unrar.xml

    r09f0998 rb1532549  
    8383    <title>Installation of UnRar</title>
    8484
    85     <note><para>This package extracts the tarball to the unversioned
    86     directory <filename>unrar</filename> and not the expected directory
    87     <filename>unrar-&unrar-version;</filename>.</para></note>
     85    <note>
     86      <para>
     87        This package extracts the tarball to the unversioned
     88        directory <filename>unrar</filename> and not the expected directory
     89        <filename>unrar-&unrar-version;</filename>.
     90      </para>
     91    </note>
    8892
    8993
  • general/sysutils/unzip.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to UnZip</title>
    3131
    32     <para>The <application>UnZip</application> package contains
    33     <filename>ZIP</filename> extraction utilities. These are useful for
    34     extracting files from <filename>ZIP</filename> archives.
    35     <filename>ZIP</filename> archives are created with
    36     <application>PKZIP</application> or <application>Info-ZIP</application>
    37     utilities, primarily in a DOS environment.</para>
     32    <para>
     33      The <application>UnZip</application> package contains
     34      <filename>ZIP</filename> extraction utilities. These are useful for
     35      extracting files from <filename>ZIP</filename> archives.
     36      <filename>ZIP</filename> archives are created with
     37      <application>PKZIP</application> or <application>Info-ZIP</application>
     38      utilities, primarily in a DOS environment.
     39    </para>
    3840
    3941    &lfs91_checked;
    4042
    4143    <caution>
    42       <para>The previous version of the <application>UnZip</application>
    43       package had some locale related issues. Currently there are no BLFS
    44       editors capable of testing these locale issues. Therefore, the
    45       locale related information is left on this page, but has not been
    46       tested. <!--Note that the patch recommended for the locale issues will not
    47       apply to this version of <application>UnZip</application>. See the
    48       discussion below in <xref linkend="unzip-locale-issues"/>. --> A more
    49       general discussion of these problems can be found in the
    50       <xref linkend="locale-assumed-encoding"/> section of the
    51       <xref linkend="locale-issues"/> page.</para>
     44      <para>
     45        The previous version of the <application>UnZip</application>
     46        package had some locale related issues. Currently there are no BLFS
     47        editors capable of testing these locale issues. Therefore, the
     48        locale related information is left on this page, but has not been
     49        tested. A more general discussion of these problems can be found in
     50        the <xref linkend="locale-assumed-encoding"/> section of the <xref
     51        linkend="locale-issues"/> page.
     52      </para>
    5253    </caution>
    5354
     
    5556    <itemizedlist spacing="compact">
    5657      <listitem>
    57         <para>Download (HTTP): <ulink url="&unzip-download-http;"/></para>
    58       </listitem>
    59       <listitem>
    60         <para>Download (FTP): <ulink url="&unzip-download-ftp;"/></para>
    61       </listitem>
    62       <listitem>
    63         <para>Download MD5 sum: &unzip-md5sum;</para>
    64       </listitem>
    65       <listitem>
    66         <para>Download size: &unzip-size;</para>
    67       </listitem>
    68       <listitem>
    69         <para>Estimated disk space required: &unzip-buildsize;</para>
    70       </listitem>
    71       <listitem>
    72         <para>Estimated build time: &unzip-time;</para>
     58        <para>
     59          Download (HTTP): <ulink url="&unzip-download-http;"/>
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Download (FTP): <ulink url="&unzip-download-ftp;"/>
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Download MD5 sum: &unzip-md5sum;
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Download size: &unzip-size;
     75        </para>
     76      </listitem>
     77      <listitem>
     78        <para>
     79          Estimated disk space required: &unzip-buildsize;
     80        </para>
     81      </listitem>
     82      <listitem>
     83        <para>
     84          Estimated build time: &unzip-time;
     85        </para>
    7386      </listitem>
    7487    </itemizedlist>
     
    7790    <itemizedlist spacing='compact'>
    7891      <listitem>
    79         <para>Required patch: <ulink
    80         url="&patch-root;/unzip-&unzip-version;-consolidated_fixes-1.patch"/></para>
     92        <para>
     93          Required patch: <ulink
     94          url="&patch-root;/unzip-&unzip-version;-consolidated_fixes-1.patch"/>
     95        </para>
    8196      </listitem>
    8297    </itemizedlist>
     
    91106
    92107    <note>
    93       <para>Use of <application>UnZip</application> in the
    94       <application>JDK</application>, <application>Mozilla</application>,
    95       <application>DocBook</application> or any other BLFS package
    96       installation is not a problem, as BLFS instructions never use
    97       <application>UnZip</application> to extract a file with non-ASCII
    98       characters in the file's name.</para>
     108      <para>
     109        Use of <application>UnZip</application> in the
     110        <application>JDK</application>, <application>Mozilla</application>,
     111        <application>DocBook</application> or any other BLFS package
     112        installation is not a problem, as BLFS instructions never use
     113        <application>UnZip</application> to extract a file with non-ASCII
     114        characters in the file's name.
     115      </para>
    99116    </note>
    100117
    101     <para>These issues are thought to be fixed in the patch. But since none
    102     of the editors have data to test this, the following workarounds are
    103     retained in case they might still be needed.</para>
    104 
    105     <para>The <application>UnZip</application> package assumes that filenames
    106     stored in the ZIP archives created on non-Unix systems are encoded in
    107     CP850, and that they should be converted to ISO-8859-1 when writing files
    108     onto the filesystem. Such assumptions are not always valid. In fact,
    109     inside the ZIP archive, filenames are encoded in the DOS codepage that is
    110     in use in the relevant country, and the filenames on disk should be in
    111     the locale encoding. In MS Windows, the OemToChar() C function (from
    112     <filename>User32.DLL</filename>) does the correct conversion (which is
    113     indeed the conversion from CP850 to a superset of ISO-8859-1 if MS
    114     Windows is set up to use the US English language), but there is no
    115     equivalent in Linux.</para>
    116 
    117     <para>When using <command>unzip</command> to unpack a ZIP archive
    118     containing non-ASCII filenames, the filenames are damaged because
    119     <command>unzip</command> uses improper conversion when any of its
    120     encoding assumptions are incorrect. For example, in the ru_RU.KOI8-R
    121     locale, conversion of filenames from CP866 to KOI8-R is required, but
    122     conversion from CP850 to ISO-8859-1 is done, which produces filenames
    123     consisting of undecipherable characters instead of words (the closest
    124     equivalent understandable example for English-only users is rot13). There
    125     are several ways around this limitation:</para>
    126 
    127     <para>1) For unpacking ZIP archives with filenames containing non-ASCII
    128     characters, use <ulink url="http://www.winzip.com/">WinZip</ulink> while
    129     running the <ulink url="http://www.winehq.com/">Wine</ulink> Windows
    130     emulator.</para>
    131 
    132     <para>2) Use <command>bsdtar -xf</command> from
    133     <xref role="nodep" linkend="libarchive"/> to unpack the ZIP archive.
    134     Then fix the damage made to
    135     the filenames using the <command>convmv</command> tool
    136     (<ulink url="http://j3e.de/linux/convmv/"/>). The following is an example
    137     for the zh_CN.UTF-8 locale:</para>
     118    <para>
     119      These issues are thought to be fixed in the patch. But since none
     120      of the editors have data to test this, the following workarounds are
     121      retained in case they might still be needed.
     122    </para>
     123
     124    <para>
     125      The <application>UnZip</application> package assumes that filenames
     126      stored in the ZIP archives created on non-Unix systems are encoded in
     127      CP850, and that they should be converted to ISO-8859-1 when writing files
     128      onto the filesystem. Such assumptions are not always valid. In fact,
     129      inside the ZIP archive, filenames are encoded in the DOS codepage that is
     130      in use in the relevant country, and the filenames on disk should be in
     131      the locale encoding. In MS Windows, the OemToChar() C function (from
     132      <filename>User32.DLL</filename>) does the correct conversion (which is
     133      indeed the conversion from CP850 to a superset of ISO-8859-1 if MS
     134      Windows is set up to use the US English language), but there is no
     135      equivalent in Linux.
     136    </para>
     137
     138    <para>
     139      When using <command>unzip</command> to unpack a ZIP archive
     140      containing non-ASCII filenames, the filenames are damaged because
     141      <command>unzip</command> uses improper conversion when any of its
     142      encoding assumptions are incorrect. For example, in the ru_RU.KOI8-R
     143      locale, conversion of filenames from CP866 to KOI8-R is required, but
     144      conversion from CP850 to ISO-8859-1 is done, which produces filenames
     145      consisting of undecipherable characters instead of words (the closest
     146      equivalent understandable example for English-only users is rot13). There
     147      are several ways around this limitation:
     148    </para>
     149
     150    <para>
     151      1) For unpacking ZIP archives with filenames containing non-ASCII
     152      characters, use <ulink url="http://www.winzip.com/">WinZip</ulink> while
     153      running the <ulink url="http://www.winehq.com/">Wine</ulink> Windows
     154      emulator.
     155    </para>
     156
     157    <para>
     158      2) Use <command>bsdtar -xf</command> from
     159      <xref role="nodep" linkend="libarchive"/> to unpack the ZIP archive.
     160      Then fix the damage made to
     161      the filenames using the <command>convmv</command> tool
     162      (<ulink url="http://j3e.de/linux/convmv/"/>). The following is an example
     163      for the zh_CN.UTF-8 locale:
     164    </para>
    138165
    139166<screen><userinput>convmv -f cp936 -t utf-8 -r --nosmart --notest \
    140167    <replaceable>&lt;/path/to/unzipped/files&gt;</replaceable></userinput></screen>
    141168<!--
    142     <para>3) Apply the optional
    143     <filename>unzip-5.50-alt-iconv-v1.1.patch</filename> patch to
    144     <application>UnZip</application>. It will apply with some offsets.</para>
    145 
    146     <para>It allows to specify the assumed filename encoding in the ZIP
    147     archive using the <option>-O charset_name</option> option and the
    148     on-disk filename encoding using the <option>-I charset_name</option>
    149     option. Defaults: the on-disk filename encoding is the locale encoding,
    150     the encoding inside the ZIP archive is guessed according to the builtin
    151     table based on the locale encoding. For US English users, this still
    152     means that unzip converts from CP850 to ISO-8859-1 by default.</para>
    153 
    154     <para>Caveat: this method works only with 8-bit locale encodings, not
    155     with UTF-8. Attempting to use a patched <command>unzip</command> in UTF-8
    156     locales may result in a segmentation fault and is probably a security
    157     risk.</para>
     169    <para>
     170      3) Apply the optional
     171      <filename>unzip-5.50-alt-iconv-v1.1.patch</filename> patch to
     172      <application>UnZip</application>. It will apply with some offsets.
     173    </para>
     174
     175    <para>
     176      It allows to specify the assumed filename encoding in the ZIP
     177      archive using the <option>-O charset_name</option> option and the
     178      on-disk filename encoding using the <option>-I charset_name</option>
     179      option. Defaults: the on-disk filename encoding is the locale encoding,
     180      the encoding inside the ZIP archive is guessed according to the builtin
     181      table based on the locale encoding. For US English users, this still
     182      means that unzip converts from CP850 to ISO-8859-1 by default.
     183    </para>
     184
     185    <para>
     186      Caveat: this method works only with 8-bit locale encodings, not
     187      with UTF-8. Attempting to use a patched <command>unzip</command> in UTF-8
     188      locales may result in a segmentation fault and is probably a security
     189      risk.
     190    </para>
    158191-->
    159192  </sect2>
     
    174207<screen><userinput>make -f unix/Makefile generic</userinput></screen>
    175208
    176     <para>The test suite does not work for target <quote>generic</quote>.</para>
    177 
    178     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     209    <para>
     210      The test suite does not work for target <quote>generic</quote>.
     211    </para>
     212
     213    <para>
     214      Now, as the <systemitem class="username">root</systemitem> user:
     215    </para>
    179216
    180217<screen role="root"><userinput>make prefix=/usr MANDIR=/usr/share/man/man1 \
     
    186223    <title>Command Explanations</title>
    187224
    188     <para><command>make -f unix/Makefile generic</command>:
    189     This target begins by running a configure script (unlike the older targets
    190     such as linux and linux_noasm) which creates a flags file that is then used
    191     in the build. This ensures that the 32-bit x86 build receives the right
    192     flags to unzip files which which are larger than 2GB when extracted.</para>
     225    <para>
     226      <command>make -f unix/Makefile generic</command>:
     227      This target begins by running a configure script (unlike the older
     228      targets such as linux and linux_noasm) which creates a flags file that
     229      is then used in the build. This ensures that the 32-bit x86 build
     230      receives the right flags to unzip files which which are larger than 2GB
     231      when extracted.
     232    </para>
    193233
    194234  </sect2>
     
    217257        <term><command>funzip</command></term>
    218258        <listitem>
    219           <para>allows the output of <command>unzip</command> commands to be
    220           redirected.</para>
     259          <para>
     260            allows the output of <command>unzip</command> commands to be
     261            redirected.
     262          </para>
    221263          <indexterm zone="unzip funzip">
    222264            <primary sortas="b-funzip">funzip</primary>
     
    228270        <term><command>unzip</command></term>
    229271        <listitem>
    230           <para>lists, tests or extracts files from a <filename>ZIP</filename>
    231           archive.</para>
     272          <para>
     273            lists, tests or extracts files from a <filename>ZIP</filename>
     274            archive.
     275          </para>
    232276          <indexterm zone="unzip unzip-prog">
    233277            <primary sortas="b-unzip">unzip</primary>
     
    239283        <term><command>unzipfsx</command></term>
    240284        <listitem>
    241           <para>is a self-extracting stub that can be prepended to a
    242           <filename>ZIP</filename> archive.  Files in this format allow the
    243           recipient to decompress the archive without installing
    244           <application>UnZip</application>.</para>
     285          <para>
     286            is a self-extracting stub that can be prepended to a
     287            <filename>ZIP</filename> archive.  Files in this format allow the
     288            recipient to decompress the archive without installing
     289            <application>UnZip</application>.
     290          </para>
    245291          <indexterm zone="unzip unzipfsx">
    246292            <primary sortas="b-unzipfsx">unzipfsx</primary>
     
    252298        <term><command>zipgrep</command></term>
    253299        <listitem>
    254           <para>searches files in a <filename>ZIP</filename> archive for
    255           lines matching a pattern.</para>
     300          <para>
     301            searches files in a <filename>ZIP</filename> archive for
     302            lines matching a pattern.
     303          </para>
    256304          <indexterm zone="unzip zipgrep">
    257305            <primary sortas="b-zipgrep">zipgrep</primary>
     
    263311        <term><command>zipinfo</command></term>
    264312        <listitem>
    265           <para>produces technical information about the files in a
    266           <filename>ZIP</filename> archive, including file access permissions,
    267           encryption status, type of compression, etc.</para>
     313          <para>
     314            produces technical information about the files in a
     315            <filename>ZIP</filename> archive, including file access permissions,
     316            encryption status, type of compression, etc.
     317          </para>
    268318          <indexterm zone="unzip zipinfo">
    269319            <primary sortas="b-zipinfo">zipinfo</primary>
     
    275325        <term><filename class='libraryfile'>libunzip.so</filename></term>
    276326        <listitem>
    277           <para>contains the API functions required by the
    278           <application>UnZip</application> programs.</para>
     327          <para>
     328            contains the API functions required by the
     329            <application>UnZip</application> programs.
     330          </para>
    279331          <indexterm zone="unzip libunzip">
    280332            <primary sortas="c-libunzip">libunzip.so</primary>
  • general/sysutils/which.xml

    r09f0998 rb1532549  
    5252    <itemizedlist spacing="compact">
    5353      <listitem>
    54         <para>Download (HTTP): <ulink url="&which-download-http;"/></para>
     54        <para>
     55          Download (HTTP): <ulink url="&which-download-http;"/>
     56        </para>
    5557      </listitem>
    5658      <listitem>
    57         <para>Download (FTP): <ulink url="&which-download-ftp;"/></para>
     59        <para>
     60          Download (FTP): <ulink url="&which-download-ftp;"/>
     61        </para>
    5862      </listitem>
    5963      <listitem>
    60         <para>Download MD5 sum: &which-md5sum;</para>
     64        <para>
     65          Download MD5 sum: &which-md5sum;
     66        </para>
    6167      </listitem>
    6268      <listitem>
    63         <para>Download size: &which-size;</para>
     69        <para>
     70          Download size: &which-size;
     71        </para>
    6472      </listitem>
    6573      <listitem>
    66         <para>Estimated disk space required: &which-buildsize;</para>
     74        <para>
     75          Estimated disk space required: &which-buildsize;
     76        </para>
    6777      </listitem>
    6878      <listitem>
    69         <para>Estimated build time: &which-time;</para>
     79        <para>
     80          Estimated build time: &which-time;
     81        </para>
    7082      </listitem>
    7183    </itemizedlist>
     
    7991    <title>Installation of Which</title>
    8092
    81     <para>Install <application>which</application> by running the following
    82     commands:</para>
     93    <para>
     94      Install <application>which</application> by running the following
     95      commands:
     96    </para>
    8397
    8498<screen><userinput>./configure --prefix=/usr &amp;&amp;
    8599make</userinput></screen>
    86100
    87     <para>This package does not come with a test suite.</para>
     101    <para>
     102      This package does not come with a test suite.
     103    </para>
    88104
    89     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     105    <para>
     106      Now, as the <systemitem class="username">root</systemitem> user:
     107    </para>
    90108
    91109<screen role="root"><userinput>make install</userinput></screen>
     
    116134        <term><command>which</command></term>
    117135        <listitem>
    118           <para>shows the full path of (shell) commands installed in your
    119           <envar>PATH</envar>.</para>
     136          <para>
     137            shows the full path of (shell) commands installed in your
     138            <envar>PATH</envar>.
     139          </para>
    120140          <indexterm zone="which which-prog">
    121141            <primary sortas="b-which">which</primary>
     
    131151    <title>The 'which' Script</title>
    132152
    133     <para>The second option (for those who don't want to install the package)
    134     is to create a simple script (execute as the
    135     <systemitem class="username">root</systemitem> user):</para>
     153    <para>
     154      The second option (for those who don't want to install the package)
     155      is to create a simple script (execute as the
     156      <systemitem class="username">root</systemitem> user):
     157    </para>
    136158
    137159<screen role="root"><userinput>cat &gt; /usr/bin/which &lt;&lt; "EOF"
     
    142164chown -v root:root /usr/bin/which</userinput></screen>
    143165
    144     <para>This should work OK and is probably the easiest solution
    145     for most cases, but is not the most comprehensive implementation.</para>
     166    <para>
     167      This should work OK and is probably the easiest solution
     168      for most cases, but is not the most comprehensive implementation.
     169    </para>
    146170
    147171  </sect2>
  • general/sysutils/zip.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to Zip</title>
    3131
    32     <para>The <application>Zip</application> package contains
    33     <application>Zip</application> utilities. These
    34     are useful for compressing files into <filename>ZIP</filename>
    35     archives.</para>
     32    <para>
     33      The <application>Zip</application> package contains
     34      <application>Zip</application> utilities. These
     35      are useful for compressing files into <filename>ZIP</filename>
     36      archives.
     37    </para>
    3638
    3739    &lfs91_checked;
     
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&zip-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&zip-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&zip-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&zip-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &zip-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &zip-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &zip-size;</para>
     59        <para>
     60          Download size: &zip-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &zip-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &zip-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &zip-time;</para>
     69        <para>
     70          Estimated build time: &zip-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
     
    6781    <title>Installation of Zip</title>
    6882
    69     <para>Install <application>Zip</application> by running the following
    70     commands:</para>
     83    <para>
     84      Install <application>Zip</application> by running the following
     85      commands:
     86    </para>
    7187
    7288<screen><userinput>make -f unix/Makefile generic_gcc</userinput></screen>
    7389
    74     <para>This package does not come with a test suite.</para>
     90    <para>
     91      This package does not come with a test suite.
     92    </para>
    7593
    76     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     94    <para>
     95      Now, as the <systemitem class="username">root</systemitem> user:
     96    </para>
    7797
    7898<screen role="root"><userinput>make prefix=/usr MANDIR=/usr/share/man/man1 -f unix/Makefile install</userinput></screen>
     
    83103    <title>Command Explanations</title>
    84104
    85     <para><command>make prefix=/usr -f unix/Makefile install</command>: This
    86     command overrides the <varname>prefix</varname> variable that is set to
    87     <filename class='directory'>/usr/local</filename> in the
    88     <filename>unix/Makefile</filename>.
    89     Alternatives to <option>generic_gcc</option> can be seen with a
    90     <command>make -f unix/Makefile list</command> command.</para>
     105    <para>
     106      <command>make prefix=/usr -f unix/Makefile install</command>: This
     107      command overrides the <varname>prefix</varname> variable that is set to
     108      <filename class='directory'>/usr/local</filename> in the
     109      <filename>unix/Makefile</filename>.
     110      Alternatives to <option>generic_gcc</option> can be seen with a
     111      <command>make -f unix/Makefile list</command> command.
     112    </para>
    91113
    92114  </sect2>
     
    115137        <term><command>zip</command></term>
    116138        <listitem>
    117           <para>compresses files into a <filename>ZIP</filename> archive.</para>
     139          <para>
     140            compresses files into a <filename>ZIP</filename> archive.
     141          </para>
    118142          <indexterm zone="zip zip-prog">
    119143            <primary sortas="b-zip">zip</primary>
     
    125149        <term><command>zipcloak</command></term>
    126150        <listitem>
    127           <para>is a utility to encrypt and decrypt a <filename>ZIP</filename> archive.</para>
     151          <para>
     152            is a utility to encrypt and decrypt a <filename>ZIP</filename>
     153            archive.
     154          </para>
    128155          <indexterm zone="zip zipcloak">
    129156            <primary sortas="b-zipcloak">zipcloak</primary>
     
    135162        <term><command>zipnote</command></term>
    136163        <listitem>
    137           <para>reads or writes comments stored in a <filename>ZIP</filename>
    138           file.</para>
     164          <para>
     165            reads or writes comments stored in a <filename>ZIP</filename>
     166            file.
     167          </para>
    139168          <indexterm zone="zip zipnote">
    140169            <primary sortas="b-zipnote">zipnote</primary>
     
    146175        <term><command>zipsplit</command></term>
    147176        <listitem>
    148           <para>is a utility to split <filename>ZIP</filename> files into
    149           smaller files.</para>
     177          <para>
     178            is a utility to split <filename>ZIP</filename> files into
     179            smaller files.
     180          </para>
    150181          <indexterm zone="zip zipsplit">
    151182            <primary sortas="b-zipsplit">zipsplit</primary>
Note: See TracChangeset for help on using the changeset viewer.