Changeset 4472e923 for server


Ignore:
Timestamp:
03/07/2020 09:40:50 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:
99c61a4
Parents:
21a08bf
Message:

Finish formatting the "server" chapter

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

Location:
server
Files:
12 edited

Legend:

Unmodified
Added
Removed

  • server/databases/lmdb.xml

    r21a08bf r4472e923  
    8282    <title>Installation of lmdb</title>
    8383
    84     <note><para>This package extracts to lmdb-LMDB_&lmdb-version;.</para></note>
     84    <note>
     85      <para>
     86        This package extracts to lmdb-LMDB_&lmdb-version;.
     87      </para>
     88    </note>
    8589
    8690    <para>

  • server/databases/mariadb.xml

    r21a08bf r4472e923  
    7373    </itemizedlist>
    7474
    75     <note><para>The installed size of MariaDB is 473 MB, but this can be
    76     reduced by about 200 MB, if desired, by removing the /usr/share/mysql/test
    77     directory after installation.</para></note>
     75    <note>
     76      <para>
     77        The installed size of MariaDB is 473 MB, but this can be
     78        reduced by about 200 MB, if desired, by removing the <filename
     79        class="directory">/usr/share/mysql/test</filename>
     80        directory after installation.
     81      </para>
     82    </note>
    7883
    7984    <bridgehead renderas="sect3">MariaDB Dependencies</bridgehead>

  • server/databases/postgresql.xml

    r21a08bf r4472e923  
    3131    <title>Introduction to PostgreSQL</title>
    3232
    33     <para><application>PostgreSQL</application> is an advanced
    34     object-relational database management system (ORDBMS), derived
    35     from the Berkeley Postgres database management system.</para>
     33    <para>
     34      <application>PostgreSQL</application> is an advanced
     35      object-relational database management system (ORDBMS), derived
     36      from the Berkeley Postgres database management system.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&postgresql-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&postgresql-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&postgresql-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&postgresql-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &postgresql-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &postgresql-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &postgresql-size;</para>
     59        <para>
     60          Download size: &postgresql-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &postgresql-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &postgresql-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &postgresql-time;</para>
     69        <para>
     70          Estimated build time: &postgresql-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    101115        -u 41 postgres</userinput></screen>
    102116
    103     <note><para>There are several configuration items that add additional
    104     functionality with optional packages to
    105     <application>PostgreSQL</application>.  Use <userinput>./configure
    106     --help</userinput> to see a list.</para></note>
    107 
    108     <para>Install <application>PostgreSQL</application> with the
    109     following commands: </para>
     117    <note>
     118      <para>
     119        There are several configuration items that add additional
     120        functionality with optional packages to
     121        <application>PostgreSQL</application>.  Use <command>./configure
     122        --help</command> to see a list.
     123      </para>
     124    </note>
     125
     126    <para>
     127      Install <application>PostgreSQL</application> with the
     128      following commands:
     129    </para>
    110130
    111131<screen><userinput>sed -i '/DEFAULT_PGSOCKET_DIR/s@/tmp@/run/postgresql@' src/include/pg_config_manual.h &amp;&amp;
    … …  
    116136make</userinput></screen>
    117137
    118     <para>There are a number of programs in the
    119     <filename class="directory">contrib/</filename> directory. If you are going
    120     to run this installation as a server and wish to build some of them, enter
    121     <command>make -C contrib</command> or
    122     <command>make -C contrib/<replaceable>&lt;SUBDIR-NAME&gt;</replaceable></command> for each subdirectory.
    123     </para>
    124 
    125     <para>Tests must be run as an unprivileged user because they need to start a
    126     temporary server and this is prevented as the root user. For the same reason,
    127     you need to stop all PostgreSQL servers if any are running. If a previous
    128     version of PostgreSQL is installed, it may be necessary to use
    129     <command>--disable-rpath</command> with <command>configure</command> to
    130     avoid failures, but <emphasis>installing the binaries created using this
    131     switch is not recommended</emphasis>. To test the results, issue:
    132     <command>make check</command>.</para>
    133 
    134     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     138    <para>
     139      There are a number of programs in the
     140      <filename class="directory">contrib/</filename> directory. If you are
     141      going to run this installation as a server and wish to build some of
     142      them, enter <command>make -C contrib</command> or <command>make -C
     143      contrib/<replaceable>&lt;SUBDIR-NAME&gt;</replaceable></command> for
     144      each subdirectory.
     145    </para>
     146
     147    <para>
     148      Tests must be run as an unprivileged user because they need to start a
     149      temporary server and this is prevented as the root user. For the same
     150      reason, you need to stop all PostgreSQL servers if any are running. If a
     151      previous version of PostgreSQL is installed, it may be necessary to use
     152      <command>--disable-rpath</command> with <command>configure</command> to
     153      avoid failures, but <emphasis>installing the binaries created using this
     154      switch is not recommended</emphasis>. To test the results, issue:
     155      <command>make check</command>.
     156    </para>
     157
     158    <para>
     159      Now, as the <systemitem class="username">root</systemitem> user:
     160    </para>
    135161
    136162<screen role="root"><userinput>make install      &amp;&amp;
    137163make install-docs</userinput></screen>
    138164
    139     <para>If you made any of the <filename class="directory">contrib/</filename>
    140     programs, as the <systemitem class="username">root</systemitem> user:</para>
     165    <para>
     166      If you made any of the <filename class="directory">contrib/</filename>
     167      programs, as the <systemitem class="username">root</systemitem> user:
     168    </para>
    141169
    142170<screen role="nodump"><userinput>make -C contrib/<replaceable>&lt;SUBDIR-NAME&gt;</replaceable> install</userinput></screen>
    143171
    144     <para><emphasis>If you only intend to use
    145     <application>PostgreSQL</application> as a client to connect to a server on
    146     another machine, your installation is complete and you should not run the
    147     remaining commands.</emphasis></para>
    148 
    149     <!-- 'Upgrading' seems to only ever exist in the docs for *previous* version -->
    150  <!-- Obsolete: only if upgrading for versions prior to 9   <note>
    151       <para>If you are upgrading an existing system and are going to install
    152       the new files over the old ones, then you should back up your data, shut
    153       down the old server and follow the instructions in <ulink
    154       url="http://www.postgresql.org/docs/9.0/static/install-upgrading.html">the
    155       official <application>PostgreSQL</application> documentation</ulink>.</para>
    156     </note>-->
    157 
    158     <para>Initialize a database cluster with the following commands issued by the
    159     <systemitem class="username">root</systemitem> user:</para>
     172    <tip>
     173      <para>
     174        If you only intend to use <application>PostgreSQL</application> as a
     175        client to connect to a server on another machine, your installation is
     176        complete and you should not run the remaining commands.
     177      </para>
     178    </tip>
     179
     180    <para>
     181      Initialize a database cluster with the following commands issued by the
     182      <systemitem class="username">root</systemitem> user:
     183    </para>
    160184
    161185<screen role="root"><userinput>install -v -dm700 /srv/pgsql/data &amp;&amp;
    … …  
    163187chown -Rv postgres:postgres /srv/pgsql /run/postgresql</userinput></screen>
    164188
    165     <para>Now, initialize the database as the <systemitem
    166     class="username">root</systemitem> user:</para>
     189    <para>
     190      Now, initialize the database as the <systemitem
     191      class="username">root</systemitem> user:
     192    </para>
    167193
    168194<screen role="root"><userinput>su - postgres -c '/usr/bin/initdb -D /srv/pgsql/data'</userinput></screen>
    … …  
    181207    </para>
    182208
    183     <para><parameter>--docdir=/usr/share/doc/postgresql-&postgresql-version;</parameter>:
    184     This switch puts the documentation in a versioned directory.</para>
    185 
    186     <para><parameter>--enable-thread-safety</parameter>: This switch makes the
    187     client libraries thread-safe by allowing concurrent threads in
    188     <filename class="libraryfile">libpq</filename> and ECPG programs to safely
    189     control their private connection handles.</para>
    190 
    191     <para><option>--with-openssl</option>: builds the package  with support for
    192     <application>OpenSSL</application> encrypted connections.</para>
    193 
    194     <para><option>--with-perl</option>: builds the PL/Perl server-side language.
    195     </para>
    196 
    197     <para><option>--with-python</option>: builds the PL/Python server-side
    198     language. Add PYTHON=/usr/bin/python2 for Python2 support, otherwise
    199     Python3 is used by default.</para>
    200 
    201     <para><option>--with-tcl</option>: builds the PL/Tcl server-side language.</para>
     209    <para>
     210      <parameter>--enable-thread-safety</parameter>: This switch makes the
     211      client libraries thread-safe by allowing concurrent threads in
     212      <filename class="libraryfile">libpq</filename> and ECPG programs to
     213      safely control their private connection handles.
     214    </para>
     215
     216    <para>
     217      <option>--with-openssl</option>: builds the package  with support for
     218      <application>OpenSSL</application> encrypted connections.
     219    </para>
     220
     221    <para>
     222      <option>--with-perl</option>: builds the PL/Perl server-side language.
     223    </para>
     224
     225    <para>
     226      <option>--with-python</option>: builds the PL/Python server-side
     227      language. Add PYTHON=/usr/bin/python2 for Python2 support, otherwise
     228      Python3 is used by default.
     229    </para>
     230
     231    <para>
     232      <option>--with-tcl</option>: builds the PL/Tcl server-side language.
     233    </para>
    202234
    203235  </sect2>
    … …  
    209241      <title>Config Files</title>
    210242
    211       <para><filename>$PGDATA/pg_ident.con</filename>,
    212       <filename>$PGDATA/pg_hba.conf</filename> and
    213       <filename>$PGDATA/postgresql.conf</filename></para>
     243      <para>
     244        <filename>$PGDATA/pg_ident.con</filename>,
     245        <filename>$PGDATA/pg_hba.conf</filename>, and
     246        <filename>$PGDATA/postgresql.conf</filename>
     247      </para>
    214248
    215249      <indexterm zone="postgresql postgresql-config">
    … …  
    225259      </indexterm>
    226260
    227       <para>The <envar>PGDATA</envar> environment variable is used to
    228       distinguish database clusters from one another by setting it to
    229       the value of the directory which contains the cluster desired.
    230       The three configuration files exist in every <filename
    231       class="directory">PGDATA/</filename> directory. Details on the
    232       format of the files and the options that can be set in each can
    233       be found in <ulink
    234       url="file:///usr/share/doc/postgresql-&postgresql-version;/html/index.html"/>.</para>
     261      <para>
     262        The <envar>PGDATA</envar> environment variable is used to
     263        distinguish database clusters from one another by setting it to
     264        the value of the directory which contains the cluster desired.
     265        The three configuration files exist in every <filename
     266        class="directory">PGDATA/</filename> directory. Details on the
     267        format of the files and the options that can be set in each can
     268        be found in <filename>
     269        /usr/share/doc/postgresql-&postgresql-version;/html/index.html</filename>.
     270      </para>
    235271
    236272    </sect3>
    … …  
    240276             <phrase revision="systemd">Systemd Unit</phrase></title>
    241277
    242       <para>Install the
    243       <phrase revision="sysv"><filename>/etc/rc.d/init.d/postgresql</filename>
    244       init script</phrase>
    245       <phrase revision="systemd"><filename>postgresql.service</filename>
    246       unit</phrase> included in the
    247       <xref linkend="bootscripts" revision="sysv"/>
    248       <xref linkend="systemd-units" revision="systemd"/> package.</para>
     278      <para>
     279        Install the
     280        <phrase revision="sysv"><filename>/etc/rc.d/init.d/postgresql</filename>
     281        init script</phrase>
     282        <phrase revision="systemd"><filename>postgresql.service</filename>
     283        unit</phrase> included in the
     284        <xref linkend="bootscripts" revision="sysv"/>
     285        <xref linkend="systemd-units" revision="systemd"/> package:
     286      </para>
    249287
    250288      <indexterm zone="postgresql postgresql-init">
    … …  
    293331
    294332      <para>
    295         When you are done with testing, you can shut down the server, by issuing
    296         as <systemitem class="username">root</systemitem>:
     333        When you are done with testing, you can shut down the server, by
     334        issuing as <systemitem class="username">root</systemitem>:
    297335      </para>
    298336
    … …  
    346384        <term><command>clusterdb</command></term>
    347385        <listitem>
    348           <para>is a utility for reclustering tables in a
    349           <application>PostgreSQL</application> database.</para>
     386          <para>
     387            is a utility for reclustering tables in a
     388            <application>PostgreSQL</application> database.
     389          </para>
    350390          <indexterm zone="postgresql clusterdb">
    351391            <primary sortas="b-clusterdb">clusterdb</primary>
    … …  
    357397        <term><command>createdb</command></term>
    358398        <listitem>
    359           <para> creates a new <application>PostgreSQL</application>
    360           database.</para>
     399          <para>
     400            creates a new <application>PostgreSQL</application>
     401            database.
     402          </para>
    361403          <indexterm zone="postgresql createdb">
    362404            <primary sortas="b-createdb">createdb</primary>
    … …  
    365407      </varlistentry>
    366408 
    367 <!--  <varlistentry id="createlang">
    368         <term><command>createlang</command></term>
    369         <listitem>
    370           <para>defines a new <application>PostgreSQL</application> procedural
    371           language.</para>
    372           <indexterm zone="postgresql createlang">
    373             <primary sortas="b-createlang">createlang</primary>
    374           </indexterm>
    375         </listitem>
    376       </varlistentry>-->
    377 
    378409      <varlistentry id="createuser">
    379410        <term><command>createuser</command></term>
    380411        <listitem>
    381           <para>defines a new <application>PostgreSQL</application>
    382           user account.</para>
     412          <para>
     413            defines a new <application>PostgreSQL</application>
     414            user account.
     415          </para>
    383416          <indexterm zone="postgresql createuser">
    384417            <primary sortas="b-createuser">createuser</primary>
    … …  
    390423        <term><command>dropdb</command></term>
    391424        <listitem>
    392           <para>removes a <application>PostgreSQL</application> database.</para>
     425          <para>
     426            removes a <application>PostgreSQL</application> database.
     427          </para>
    393428          <indexterm zone="postgresql dropdb">
    394429            <primary sortas="b-dropdb">dropdb</primary>
    … …  
    397432      </varlistentry>
    398433
    399 <!--  <varlistentry id="droplang">
    400         <term><command>droplang</command></term>
    401         <listitem>
    402           <para>removes a <application>PostgreSQL</application> procedural
    403           language.</para>
    404           <indexterm zone="postgresql droplang">
    405             <primary sortas="b-droplang">droplang</primary>
    406           </indexterm>
    407         </listitem>
    408       </varlistentry> -->
    409 
    410434      <varlistentry id="dropuser">
    411435        <term><command>dropuser</command></term>
    412436        <listitem>
    413           <para>removes a <application>PostgreSQL</application>
    414           user account.</para>
     437          <para>
     438            removes a <application>PostgreSQL</application> user account.
     439          </para>
    415440          <indexterm zone="postgresql dropuser">
    416441            <primary sortas="b-dropuser">dropuser</primary>
    … …  
    422447        <term><command>ecpg</command></term>
    423448        <listitem>
    424           <para>is the embedded SQL preprocessor.</para>
     449          <para>
     450            is the embedded SQL preprocessor.
     451          </para>
    425452          <indexterm zone="postgresql ecpg">
    426453            <primary sortas="b-ecpg">ecpg</primary>
    … …  
    432459        <term><command>initdb</command></term>
    433460        <listitem>
    434           <para>creates a new database cluster.</para>
     461          <para>
     462            creates a new database cluster.
     463          </para>
    435464          <indexterm zone="postgresql initdb">
    436465            <primary sortas="b-initdb">initdb</primary>
    … …  
    442471        <term><command>oid2name</command></term>
    443472        <listitem>
    444           <para>resolves OIDs (Object IDs) and file nodes in a PostgreSQL data
    445           directory.</para>
     473          <para>
     474            resolves OIDs (Object IDs) and file nodes in a PostgreSQL data
     475            directory.
     476          </para>
    446477          <indexterm zone="postgresql oid2name">
    447478            <primary sortas="b-oid2name">oid2name</primary>
    … …  
    453484        <term><command>pg_archivecleanup</command></term>
    454485        <listitem>
    455           <para>cleans up PostgreSQL WAL (write-ahead log) archive files.</para>
     486          <para>
     487            cleans up PostgreSQL WAL (write-ahead log) archive files.
     488          </para>
    456489          <indexterm zone="postgresql pg_archivecleanup">
    457490            <primary sortas="b-pg_archivecleanup">pg_archivecleanup</primary>
    … …  
    463496        <term><command>pg_basebackup</command></term>
    464497        <listitem>
    465           <para>takes base backups of a running
    466           <application>PostgreSQL</application> cluster.</para>
     498          <para>
     499            takes base backups of a running
     500            <application>PostgreSQL</application> cluster.
     501          </para>
    467502          <indexterm zone="postgresql pg_basebackup">
    468503            <primary sortas="b-pg_basebackup">pg_basebackup</primary>
    … …  
    474509        <term><command>pg_config</command></term>
    475510        <listitem>
    476           <para>retrieves <application>PostgreSQL</application> version
    477           information.</para>
     511          <para>
     512            retrieves <application>PostgreSQL</application> version
     513            information.
     514          </para>
    478515          <indexterm zone="postgresql pg_config">
    479516            <primary sortas="b-pg_config">pg_config</primary>
    … …  
    485522        <term><command>pg_controldata</command></term>
    486523        <listitem>
    487           <para>returns information initialized during
    488           <command>initdb</command>, such as the catalog version and server
    489           locale.</para>
     524          <para>
     525            returns information initialized during <command>initdb</command>,
     526            such as the catalog version and server locale.
     527          </para>
    490528          <indexterm zone="postgresql pg_controldata">
    491529            <primary sortas="b-pg_controldata">pg_controldata</primary>
    … …  
    497535        <term><command>pg_ctl</command></term>
    498536        <listitem>
    499           <para>controls stopping and starting the database server.</para>
     537          <para>
     538            controls stopping and starting the database server.
     539          </para>
    500540          <indexterm zone="postgresql pg_ctl">
    501541            <primary sortas="b-pg_ctl">pg_ctl</primary>
    … …  
    507547        <term><command>pg_dump</command></term>
    508548        <listitem>
    509           <para>dumps database data and metadata into scripts which are used
    510           to recreate the database.</para>
     549          <para>
     550            dumps database data and metadata into scripts which are used
     551            to recreate the database.
     552          </para>
    511553          <indexterm zone="postgresql pg_dump">
    512554            <primary sortas="b-pg_dump">pg_dump</primary>
    … …  
    518560        <term><command>pg_dumpall</command></term>
    519561        <listitem>
    520           <para>recursively calls <command>pg_dump</command> for each
    521           database in a cluster.</para>
     562          <para>
     563            recursively calls <command>pg_dump</command> for each
     564            database in a cluster.
     565          </para>
    522566          <indexterm zone="postgresql pg_dumpall">
    523567            <primary sortas="b-pg_dumpall">pg_dumpall</primary>
    … …  
    529573        <term><command>pg_isready</command></term>
    530574        <listitem>
    531           <para>check the connection status of a PostgreSQL server.</para>
     575          <para>
     576            checks the connection status of a PostgreSQL server.
     577          </para>
    532578          <indexterm zone="postgresql pg_isready">
    533579            <primary sortas="b-pg_isready">pg_isready</primary>
    … …  
    551597        <term><command>pg_recvlogical</command></term>
    552598        <listitem>
    553           <para>controls PostgreSQL logical decoding streams.</para>
     599          <para>
     600            controls PostgreSQL logical decoding streams.
     601          </para>
    554602          <indexterm zone="postgresql pg_recvlogical">
    555603            <primary sortas="b-pg_recvlogical">pg_recvlogical</primary>
    … …  
    561609        <term><command>pg_resetwal</command></term>
    562610        <listitem>
    563           <para>resets the write-ahead log and other control information
    564           of a PostgreSQL database cluseter.</para>
     611          <para>
     612            resets the write-ahead log and other control information
     613            of a PostgreSQL database cluster.
     614          </para>
    565615          <indexterm zone="postgresql pg_resetwal">
    566616            <primary sortas="b-pg_resetwal">pg_resetwal</primary>
    … …  
    572622        <term><command>pg_restore</command></term>
    573623        <listitem>
    574           <para>creates databases from dump files created by
    575           <command>pg_dump</command>.</para>
     624          <para>
     625            creates databases from dump files created by
     626            <command>pg_dump</command>.
     627          </para>
    576628          <indexterm zone="postgresql pg_restore">
    577629            <primary sortas="b-pg_restore">pg_restore</primary>
    … …  
    583635        <term><command>pg_rewind</command></term>
    584636        <listitem>
    585           <para>synchronizes a PostgreSQL data directory with another data
    586           directory that was forked from the first one.</para>
     637          <para>
     638            synchronizes a PostgreSQL data directory with another data
     639            directory that was forked from the first one.
     640          </para>
    587641          <indexterm zone="postgresql pg_rewind">
    588642            <primary sortas="b-pg_rewind">pg_rewind</primary>
    … …  
    594648        <term><command>pg_standby</command></term>
    595649        <listitem>
    596           <para>supports the creation of a PostgreSQL warm standby
    597           server.</para>
     650          <para>
     651            supports the creation of a PostgreSQL warm standby server.
     652          </para>
    598653          <indexterm zone="postgresql pg_standby">
    599654            <primary sortas="b-pg_standby">pg_standby</primary>
    … …  
    605660        <term><command>pg_test_fsync</command></term>
    606661        <listitem>
    607           <para>determine fastest wal_sync method for PostgreSQL.</para>
     662          <para>
     663            determines fastest wal_sync method for PostgreSQL.
     664          </para>
    608665          <indexterm zone="postgresql pg_test_fsync">
    609666            <primary sortas="b-pg_test_fsync">pg_test_fsync</primary>
    … …  
    615672        <term><command>pg_test_timing</command></term>
    616673        <listitem>
    617           <para>measure timing overhead.</para>
     674          <para>
     675            measures timing overhead.
     676          </para>
    618677          <indexterm zone="postgresql pg_test_timing">
    619678            <primary sortas="b-pg_test_timing">pg_test_timing</primary>
    … …  
    625684        <term><command>pg_upgrade</command></term>
    626685        <listitem>
    627           <para>upgrade a PostgreSQL server instance.</para>
     686          <para>
     687            upgrades a PostgreSQL server instance.
     688          </para>
    628689          <indexterm zone="postgresql pg_upgrade">
    629690            <primary sortas="b-pg_upgrade">pg_upgrade</primary>
    … …  
    635696        <term><command>pg_waldump</command></term>
    636697        <listitem>
    637           <para>display a human-readable rendering of the write-ahead log of a
    638           PostgreSQL database cluster.</para>
     698          <para>
     699            displays a human-readable rendering of the write-ahead log of a
     700            PostgreSQL database cluster.
     701          </para>
    639702          <indexterm zone="postgresql pg_waldump">
    640703            <primary sortas="b-pg_waldump">pg_waldump</primary>
    … …  
    646709        <term><command>pgbench</command></term>
    647710        <listitem>
    648           <para>run a benchmark test on PostgreSQL.</para>
     711          <para>
     712            runs a benchmark test on PostgreSQL.
     713          </para>
    649714          <indexterm zone="postgresql pgbench">
    650715            <primary sortas="b-pgbench">pgbench</primary>
    … …  
    656721        <term><command>pltcl_delmod</command></term>
    657722        <listitem>
    658           <para>is a support script used to delete a module from a
    659           PL/<application>Tcl</application> table. The command
    660           requires the <ulink
    661           url="http://flightaware.github.io/Pgtcl/">Pgtcl</ulink>
    662           package to be installed also.</para>
     723          <para>
     724            is a support script used to delete a module from a
     725            PL/<application>Tcl</application> table. The command
     726            requires the <ulink
     727            url="http://flightaware.github.io/Pgtcl/">Pgtcl</ulink>
     728            package to be installed also.
     729          </para>
    663730          <indexterm zone="postgresql pltcl_delmod">
    664731            <primary sortas="b-pltcl_delmod">pltcl_delmod</primary>
    … …  
    670737        <term><command>pltcl_listmod</command></term>
    671738        <listitem>
    672           <para>is a support script used to list the modules in a
    673           PL/<application>Tcl</application> table. The command
    674           requires the <ulink
    675           url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
    676           package to be installed also.</para>
     739          <para>
     740            is a support script used to list the modules in a
     741            PL/<application>Tcl</application> table. The command
     742            requires the <ulink
     743            url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
     744            package to be installed also.
     745          </para>
    677746          <indexterm zone="postgresql pltcl_listmod">
    678747            <primary sortas="b-pltcl_listmod">pltcl_listmod</primary>
    … …  
    684753        <term><command>pltcl_loadmod</command></term>
    685754        <listitem>
    686           <para>is a support script used to load a module into a
    687           PL/<application>Tcl</application> table. The command
    688           requires the <ulink
    689           url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
    690           package to be installed also.</para>
     755          <para>
     756            is a support script used to load a module into a
     757            PL/<application>Tcl</application> table. The command
     758            requires the <ulink
     759            url="http://gborg.postgresql.org/project/pgtcl/">Pgtcl</ulink>
     760            package to be installed also.
     761          </para>
    691762          <indexterm zone="postgresql pltcl_loadmod">
    692763            <primary sortas="b-pltcl_loadmod">pltcl_loadmod</primary>
    … …  
    698769        <term><command>postgres</command></term>
    699770        <listitem>
    700           <para>is the PostgreSQL database server.</para>
     771          <para>
     772            is the PostgreSQL database server.
     773          </para>
    701774          <indexterm zone="postgresql postgres">
    702775            <primary sortas="b-postgres">postgres</primary>
    … …  
    708781        <term><command>postmaster</command></term>
    709782        <listitem>
    710           <para>(deprecated, a symlink to <command>postgres</command>) is a
    711           multi-user database daemon.</para>
     783          <para>
     784            (deprecated, a symlink to <command>postgres</command>) is a
     785            multi-user database daemon.
     786          </para>
    712787          <indexterm zone="postgresql postmaster">
    713788            <primary sortas="b-postmaster">postmaster</primary>
    … …  
    719794        <term><command>psql</command></term>
    720795        <listitem>
    721           <para>is a console based database shell.</para>
     796          <para>
     797            is a console based database shell.
     798          </para>
    722799          <indexterm zone="postgresql psql">
    723800            <primary sortas="b-psql">psql</primary>
    … …  
    729806        <term><command>reindexdb</command></term>
    730807        <listitem>
    731           <para>is a utility for rebuilding indexes in a database.</para>
     808          <para>
     809            is a utility for rebuilding indexes in a database.
     810          </para>
    732811          <indexterm zone="postgresql reindexdb">
    733812            <primary sortas="b-reindexdb">reindexdb</primary>
    … …  
    739818        <term><command>vacuumdb</command></term>
    740819        <listitem>
    741           <para>compacts databases and generates statistics for the query
    742           analyzer.</para>
     820          <para>
     821            compacts databases and generates statistics for the query analyzer.
     822          </para>
    743823          <indexterm zone="postgresql vacuumdb">
    744824            <primary sortas="b-vacuumdb">vacuumdb</primary>
    … …  
    750830        <term><command>vacuumlo</command></term>
    751831        <listitem>
    752           <para>remove orphaned large objects from a PostgreSQL database.</para>
     832          <para>
     833            removes orphaned large objects from a PostgreSQL database.
     834          </para>
    753835          <indexterm zone="postgresql vacuumlo">
    754836            <primary sortas="b-vacuumlo">vacuumlo</primary>
    … …  
    760842        <term><filename class='libraryfile'>libecpg.{so,a}</filename></term>
    761843        <listitem>
    762           <para>contains functions to support embedded SQL in C programs.</para>
     844          <para>
     845            contains functions to support embedded SQL in C programs.
     846          </para>
    763847          <indexterm zone="postgresql libecpg">
    764848            <primary sortas="c-libecpg">libecpg.{so,a}</primary>
    … …  
    770854        <term><filename class='libraryfile'>libecpg_compat.{so,a}</filename></term>
    771855        <listitem>
    772           <para>is the ecpg compatibility library.</para>
     856          <para>
     857            is the ecpg compatibility library.
     858          </para>
    773859          <indexterm zone="postgresql libecpg_compat">
    774860            <primary sortas="c-libecpg_compat">libecpg_compat.{so,a}</primary>
    … …  
    780866        <term><filename class='libraryfile'>libgport.a</filename></term>
    781867        <listitem>
    782           <para>is the port-specific subsystem of the Postgres backend.</para>
     868          <para>
     869            is the port-specific subsystem of the Postgres backend.
     870          </para>
    783871          <indexterm zone="postgresql libgport">
    784872            <primary sortas="c-libgport">libgport.a</primary>
    … …  
    790878        <term><filename class='libraryfile'>libpgtypes.{so,a}</filename></term>
    791879        <listitem>
    792           <para>contains functions for dealing with Postgres data types.</para>
     880          <para>
     881            contains functions for dealing with Postgres data types.
     882          </para>
    793883          <indexterm zone="postgresql libpgtypes">
    794884            <primary sortas="c-libpgtypes">libpgtypes.{so,a}</primary>
    … …  
    800890        <term><filename class='libraryfile'>libpq.{so,a}</filename></term>
    801891        <listitem>
    802           <para>is the C programmer's API to Postgres.</para>
     892          <para>
     893            is the C programmer's API to Postgres.
     894          </para>
    803895          <indexterm zone="postgresql libpq">
    804896            <primary sortas="c-libpq">libpq.{so,a}</primary>

  • server/mail/exim.xml

    r21a08bf r4472e923  
    415415        unit</phrase>
    416416        included in the <xref linkend="bootscripts" revision="sysv"/>
    417         <xref linkend="systemd-units" revision="systemd"/> package.
     417        <xref linkend="systemd-units" revision="systemd"/> package:
    418418      </para>
    419419

  • server/mail/postfix.xml

    r21a08bf r4472e923  
    438438        unit</phrase> included in the
    439439        <xref linkend="bootscripts" revision="sysv"/>
    440         <xref linkend="systemd-units" revision="systemd"/> package.
     440        <xref linkend="systemd-units" revision="systemd"/> package:
    441441      </para>
    442442

  • server/mail/sendmail.xml

    r21a08bf r4472e923  
    337337        unit</phrase> included in the
    338338        <xref linkend="bootscripts" revision="sysv"/>
    339         <xref linkend="systemd-units" revision="systemd"/> package.
     339        <xref linkend="systemd-units" revision="systemd"/> package:
    340340      </para>
    341341

  • server/major/apache.xml

    r21a08bf r4472e923  
    163163    </para>
    164164
    165     <note><para>This package does not install properly using DESTDIR
    166     techniques as an unpriviledged user.</para></note>
     165    <note>
     166      <para>
     167        This package does not install properly using <envar>DESTDIR</envar>
     168        techniques as an unpriviledged user.
     169      </para>
     170    </note>
    167171
    168172<screen role="root"><userinput>make install  &amp;&amp;
    … …  
    283287        unit</phrase> included in the
    284288        <xref linkend="bootscripts" revision="sysv"/>
    285         <xref linkend="systemd-units" revision="systemd"/> package.
     289        <xref linkend="systemd-units" revision="systemd"/> package:
    286290      </para>
    287291

  • server/major/bind.xml

    r21a08bf r4472e923  
    3030    <title>Introduction to BIND</title>
    3131
    32     <para>The <application>BIND</application> package provides a DNS server
    33     and client utilities. If you are only interested in the utilities, refer
    34     to the <xref linkend="bind-utils"/>.</para>
     32    <para>
     33      The <application>BIND</application> package provides a DNS server
     34      and client utilities. If you are only interested in the utilities, refer
     35      to the <xref linkend="bind-utils"/>.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&bind-download-http;"/></para>
     43        <para>
     44          Download (HTTP): <ulink url="&bind-download-http;"/>
     45        </para>
    4246      </listitem>
    4347      <listitem>
    44         <para>Download (FTP): <ulink url="&bind-download-ftp;"/></para>
     48        <para>
     49          Download (FTP): <ulink url="&bind-download-ftp;"/>
     50        </para>
    4551      </listitem>
    4652      <listitem>
    47         <para>Download MD5 sum: &bind-md5sum;</para>
     53        <para>
     54          Download MD5 sum: &bind-md5sum;
     55        </para>
    4856      </listitem>
    4957      <listitem>
    50         <para>Download size: &bind-size;</para>
     58        <para>
     59          Download size: &bind-size;
     60        </para>
    5161      </listitem>
    5262      <listitem>
    53         <para>Estimated disk space required: &bind-buildsize;</para>
     63        <para>
     64          Estimated disk space required: &bind-buildsize;
     65        </para>
    5466      </listitem>
    5567      <listitem>
    56         <para>Estimated build time: &bind-time;</para>
     68        <para>
     69          Estimated build time: &bind-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    6175    <itemizedlist spacing='compact'>
    6276      <listitem>
    63         <para>Optional patch (if net-tools is not installed):
    64         <ulink
    65         url="&patch-root;/bind-&bind-version;-use_iproute2-1.patch"/></para>
     77        <para>
     78          Optional patch (if net-tools is not installed): <ulink
     79          url="&patch-root;/bind-&bind-version;-use_iproute2-1.patch"/>
     80        </para>
    6681      </listitem>
    6782    </itemizedlist>
    … …  
    116131    <title>Installation of BIND</title>
    117132<!--
    118     <para>If you have chosen not to install net-tools, apply the iproute2
    119     patch with the following command:</para>
     133    <para>
     134      If you have chosen not to install net-tools, apply the iproute2
     135      patch with the following command:
     136    </para>
    120137
    121138<screen><userinput>patch -Np1 -i ../bind-&bind-version;-use_iproute2-1.patch</userinput></screen>
    122139-->
    123140
    124     <para>To ensure <application>BIND</application> will build dnssec-keymgr,
    125     install a python module as the <systemitem
    126     class="username">root</systemitem> user:</para>
     141    <para>
     142      To ensure <application>BIND</application> will build dnssec-keymgr,
     143      install a python module as the <systemitem
     144      class="username">root</systemitem> user:
     145    </para>
    127146
    128147<screen role="root"><userinput>pip3 install ply</userinput></screen>
    129148
    130     <para>Install <application>BIND</application> by running the
    131     following commands:</para>
     149    <para>
     150      Install <application>BIND</application> by running the
     151      following commands:
     152    </para>
    132153
    133154<screen><userinput>./configure --prefix=/usr           \
    … …  
    139160make</userinput></screen>
    140161
    141     <para>Issue the following commands to run the complete suite of tests.
    142     First, as the <systemitem class="username">root</systemitem> user, set up
    143     some test interfaces:</para>
    144 
    145     <note><para>If IPv6 is not enabled in the kernel, there will be several
    146     error messages: "RTNETLINK answers: Operation not permitted".  These
    147     messages do not affect the tests.</para></note>
     162    <para>
     163      Issue the following commands to run the complete suite of tests.
     164      First, as the <systemitem class="username">root</systemitem> user, set up
     165      some test interfaces:
     166    </para>
     167
     168    <note>
     169      <para>
     170        If IPv6 is not enabled in the kernel, there will be several
     171        error messages: "RTNETLINK answers: Operation not permitted".  These
     172        messages do not affect the tests.
     173      </para>
     174    </note>
    148175
    149176<screen role="root"
    150177        remap="test"><userinput>bin/tests/system/ifconfig.sh up</userinput></screen>
    151178
    152     <para>The test suite may indicate some skipped tests depending on
    153     what configuration options are used. Some tests are marked <quote>UNTESTED
    154     </quote> if <xref linkend="perl-net-dns"/> is not installed.
    155     To run the tests, as an unprivileged user, execute:</para>
     179    <para>
     180      The test suite may indicate some skipped tests depending on
     181      what configuration options are used. Some tests are marked
     182      <quote>UNTESTED</quote> if <xref linkend="perl-net-dns"/> is not
     183      installed. To run the tests, as an unprivileged user, execute:
     184    </para>
    156185
    157186<screen remap="test"><userinput>make -k check</userinput></screen>
    158187
    159     <para>Again as <systemitem class="username">root</systemitem>, clean up the
    160     test interfaces:</para>
     188    <para>
     189      Again as <systemitem class="username">root</systemitem>, clean up the
     190      test interfaces:
     191    </para>
    161192
    162193<screen role="root"
    163194        remap="test"><userinput>bin/tests/system/ifconfig.sh down</userinput></screen>
    164195
    165     <para>Finally, install the package as the <systemitem
    166     class="username">root</systemitem> user:</para>
     196    <para>
     197      Finally, install the package as the <systemitem
     198      class="username">root</systemitem> user:
     199    </para>
    167200
    168201<screen role="root"><userinput>make install &amp;&amp;
    … …  
    181214    <title>Command Explanations</title>
    182215
    183     <para><parameter>--sysconfdir=/etc</parameter>: This parameter forces
    184     <application>BIND</application> to look for configuration
    185     files in <filename class='directory'>/etc</filename> instead of
    186     <filename class='directory'>/usr/etc</filename>.</para>
     216    <para>
     217      <parameter>--sysconfdir=/etc</parameter>: This parameter forces
     218      <application>BIND</application> to look for configuration
     219      files in <filename class='directory'>/etc</filename> instead of
     220      <filename class='directory'>/usr/etc</filename>.
     221    </para>
    187222
    188223    <!-- No longer available as of 9.14.2
    189     <para><parameter>- -enable-threads</parameter>: This parameter enables
    190     multi-threading capability.</para>
     224    <para>
     225      <parameter>- -enable-threads</parameter>: This parameter enables
     226      multi-threading capability.
     227    </para>
    191228    -->
    192229
    193     <para><parameter>--with-libtool</parameter>: This parameter forces the
    194     building of dynamic libraries and links the installed binaries to these
    195     libraries.</para>
     230    <para>
     231      <parameter>--with-libtool</parameter>: This parameter forces the
     232      building of dynamic libraries and links the installed binaries to these
     233      libraries.
     234    </para>
    196235   
    197     <para><option>--with-libidn2</option>: This parameter enables
    198     the IDNA2008 (Internationalized Domain Names in Applications)
    199     support.</para>
     236    <para>
     237      <option>--with-libidn2</option>: This parameter enables
     238      the IDNA2008 (Internationalized Domain Names in Applications)
     239      support.
     240    </para>
    200241
    201242<!-- no longer available
    202     <para><parameter>- -with-randomdev=/dev/urandom</parameter>: This parameter
    203     specifes a non-blocking random device for use with digital signatures.</para>
     243    <para>
     244      <parameter>- -with-randomdev=/dev/urandom</parameter>: This parameter
     245      specifes a non-blocking random device for use with digital signatures.
     246    </para>
    204247-->
    205     <para><option>--enable-fetchlimit</option>: Use this option if you want
    206     to be able to limit the rate of recursive client queries. This may be
    207     useful on servers which receive a large number of queries.</para>
    208 
    209     <para><option>--disable-linux-caps</option>: BIND can also be built without
    210     capability support by using this option, at the cost of some loss of
    211     security.</para>
    212 
    213     <para><option>--with-dlz-{mysql,bdb,filesystem,ldap,odbc,stub}</option>: Use
    214     one (or more) of those options to add Dynamically Loadable Zones support.
    215     For more information refer to
    216     <ulink url="http://bind-dlz.sourceforge.net/">bind-dlz.sourceforge.net</ulink>.
     248    <para>
     249      <option>--enable-fetchlimit</option>: Use this option if you want
     250      to be able to limit the rate of recursive client queries. This may be
     251      useful on servers which receive a large number of queries.
     252    </para>
     253
     254    <para>
     255      <option>--disable-linux-caps</option>: BIND can also be built without
     256      capability support by using this option, at the cost of some loss of
     257      security.
     258    </para>
     259
     260    <para>
     261      <option>--with-dlz-{mysql,bdb,filesystem,ldap,odbc,stub}</option>: Use
     262      one (or more) of those options to add Dynamically Loadable Zones support.
     263      For more information refer to <ulink
     264      url="http://bind-dlz.sourceforge.net/">bind-dlz.sourceforge.net</ulink>.
    217265    </para>
    218266   
    … …  
    220268      href="../../xincludes/static-libraries.xml"/>
    221269
    222     <para><command>cd doc; install ...</command>: These commands install
    223     additional package documentation. Omit any or all of these commands if
    224     desired.</para>
     270    <para>
     271      <command>cd doc; install ...</command>: These commands install
     272      additional package documentation. Omit any or all of these commands if
     273      desired.
     274    </para>
    225275  </sect2>
    226276
    … …  
    231281      <title>Config files</title>
    232282
    233       <para><filename>named.conf</filename>,
    234       <filename>root.hints</filename>,
    235       <filename>127.0.0</filename>,
    236       <filename>rndc.conf</filename> and
    237       <filename>resolv.conf</filename></para>
     283      <para>
     284        <filename>named.conf</filename>,
     285        <filename>root.hints</filename>,
     286        <filename>127.0.0</filename>,
     287        <filename>rndc.conf</filename>, and
     288        <filename>resolv.conf</filename>
     289      </para>
    238290
    239291      <indexterm zone="bind bind-config">
    … …  
    263315      <title>Configuration Information</title>
    264316
    265       <para><application>BIND</application> will be configured to run in a
    266       <command>chroot</command> jail as an unprivileged user (<systemitem
    267       class="username">named</systemitem>). This configuration is more secure
    268       in that a DNS compromise can only affect a few files in the <systemitem
    269       class="username">named</systemitem> user's <envar>HOME</envar>
    270       directory.</para>
    271 
    272       <para>Create the unprivileged user and group <systemitem
    273       class="username">named</systemitem>:</para>
     317      <para>
     318        <application>BIND</application> will be configured to run in a
     319        <command>chroot</command> jail as an unprivileged user (<systemitem
     320        class="username">named</systemitem>). This configuration is more secure
     321        in that a DNS compromise can only affect a few files in the <systemitem
     322        class="username">named</systemitem> user's <envar>HOME</envar>
     323        directory.
     324      </para>
     325
     326      <para>
     327        Create the unprivileged user and group <systemitem
     328        class="username">named</systemitem>:
     329      </para>
    274330
    275331<screen role="root"><userinput>groupadd -g 20 named &amp;&amp;
    … …  
    277333install -d -m770 -o named -g named /srv/named</userinput></screen>
    278334
    279       <para>Set up some files, directories and devices needed by
    280       <application>BIND</application>:</para>
     335      <para>
     336        Set up some files, directories and devices needed by
     337        <application>BIND</application>:
     338      </para>
    281339
    282340<screen role="root"><userinput>mkdir -p /srv/named &amp;&amp;
    … …  
    288346cp /etc/localtime etc</userinput></screen>
    289347
    290       <para>The <filename>rndc.conf</filename> file contains information for
    291       controlling <command>named</command> operations with the
    292       <command>rndc</command> utility. Generate a key for use in the <filename>named.conf</filename> and <filename>rdnc.conf</filename> with the
    293       <command>rndc-confgen</command> command:</para>
    294 
    295    <screen role="root"><userinput>rndc-confgen -a -b 512 -t /srv/named</userinput></screen>
    296 
    297       <para>Complete the <filename>named.conf</filename> file from which
    298       <command>named</command> will read the location of zone files, root
    299       name servers and secure DNS keys:</para>
     348      <para>
     349        The <filename>rndc.conf</filename> file contains information for
     350        controlling <command>named</command> operations with the
     351        <command>rndc</command> utility. Generate a key for use in the
     352        <filename>named.conf</filename> and <filename>rdnc.conf</filename>
     353        with the <command>rndc-confgen</command> command:
     354      </para>
     355
     356<screen role="root"><userinput>rndc-confgen -a -b 512 -t /srv/named</userinput></screen>
     357
     358      <para>
     359        Complete the <filename>named.conf</filename> file from which
     360        <command>named</command> will read the location of zone files, root
     361        name servers and secure DNS keys:
     362      </para>
    300363
    301364<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt;&gt; /srv/named/etc/named.conf &lt;&lt; "EOF"
    … …  
    353416EOF</userinput></screen>
    354417
    355       <para>Create a zone file with the following contents:</para>
     418      <para>
     419        Create a zone file with the following contents:
     420      </para>
    356421
    357422<screen role="root"><userinput>cat &gt; /srv/named/etc/named/pz/127.0.0 &lt;&lt; "EOF"
    … …  
    367432EOF</userinput></screen>
    368433
    369       <para>Create the <filename>root.hints</filename> file with the following
    370       commands:</para>
     434      <para>
     435        Create the <filename>root.hints</filename> file with the following
     436        commands:
     437      </para>
    371438
    372439      <note>
    373         <para>Caution must be used to ensure there are no leading spaces in
    374         this file.</para>
     440        <para>
     441          Caution must be used to ensure there are no leading spaces in
     442          this file.
     443        </para>
    375444      </note>
    376445
    … …  
    417486EOF</userinput></screen>
    418487
    419       <para>The <filename>root.hints</filename> file is a list of root name
    420       servers. This file must be updated periodically with the
    421       <command>dig</command> utility. A current copy of root.hints can be
    422       obtained from <ulink url="ftp://rs.internic.net/domain/named.root" />.
    423       For details, consult the "BIND 9 Administrator Reference Manual", included
    424       in every source archive of BIND 9 distributed by ISC, in HTML and PDF
    425       formats, also available at
    426       <ulink url="ftp://ftp.isc.org/isc/bind9/cur/&bind-minor-version;/doc/arm/Bv9ARM.html">
    427       BIND 9 Administrator Reference Manual</ulink>.</para>
    428 
    429       <para>Create or modify <filename>resolv.conf</filename> to use the new
    430       name server with the following commands:</para>
     488      <para>
     489        The <filename>root.hints</filename> file is a list of root name
     490        servers. This file must be updated periodically with the
     491        <command>dig</command> utility. A current copy of root.hints can be
     492        obtained from <ulink url="ftp://rs.internic.net/domain/named.root" />.
     493        For details, consult the "BIND 9 Administrator Reference Manual",
     494        included in every source archive of BIND 9 distributed by ISC, in HTML
     495        and PDF formats, also available at <ulink
     496        url="ftp://ftp.isc.org/isc/bind9/cur/&bind-minor-version;/doc/arm/Bv9ARM.html">
     497        BIND 9 Administrator Reference Manual</ulink>.
     498      </para>
     499
     500      <para>
     501        Create or modify <filename>resolv.conf</filename> to use the new
     502        name server with the following commands:
     503      </para>
    431504
    432505      <note>
    433         <para>Replace <replaceable>&lt;yourdomain.com&gt;</replaceable> with
    434         your own valid domain name.</para>
     506        <para>
     507          Replace <replaceable>&lt;yourdomain.com&gt;</replaceable> with
     508          your own valid domain name.
     509        </para>
    435510      </note>
    436511
    … …  
    441516EOF</userinput></screen>
    442517
    443       <para>Set permissions on the <command>chroot</command> jail with the
    444       following command:</para>
     518      <para>
     519        Set permissions on the <command>chroot</command> jail with the
     520        following command:
     521      </para>
    445522
    446523<screen role="root"><userinput>chown -R named:named /srv/named</userinput></screen>
    … …  
    452529             <phrase revision="systemd">Systemd Unit</phrase></title>
    453530
    454       <para>To start the DNS server at boot, install the
    455       <phrase revision="sysv"><filename>/etc/rc.d/init.d/bind</filename> init
    456       script</phrase>
    457       <phrase revision="systemd"><filename>named.service</filename>
    458       unit</phrase> included in the
    459       <xref linkend="bootscripts" revision="sysv"/>
    460       <xref linkend="systemd-units" revision="systemd"/> package.</para>
     531      <para>
     532        To start the DNS server at boot, install the
     533        <phrase revision="sysv"><filename>/etc/rc.d/init.d/bind</filename> init
     534        script</phrase>
     535        <phrase revision="systemd"><filename>named.service</filename>
     536        unit</phrase> included in the
     537        <xref linkend="bootscripts" revision="sysv"/>
     538        <xref linkend="systemd-units" revision="systemd"/> package:
     539      </para>
    461540
    462541      <indexterm zone="bind bind-init">
    … …  
    467546<screen role="root" revision="systemd"><userinput>make install-named</userinput></screen>
    468547
    469       <para>Now start <application>BIND</application> with
    470       the following command:</para>
     548      <para>
     549        Now start <application>BIND</application> with the following command:
     550      </para>
    471551
    472552<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/bind start</userinput></screen>
    … …  
    478558      <title>Testing BIND</title>
    479559
    480       <para>Test out the new <application>BIND</application> 9 installation.
    481       First query the local host address with <command>dig</command>:</para>
     560      <para>
     561        Test out the new <application>BIND</application> 9 installation.
     562        First query the local host address with <command>dig</command>:
     563      </para>
    482564
    483565<screen><userinput>dig -x 127.0.0.1</userinput></screen>
    484566
    485       <para>Now try an external name lookup, taking note of the speed
    486       difference in repeated lookups due to the caching. Run the
    487       <command>dig</command> command twice on the same address:</para>
     567      <para>
     568        Now try an external name lookup, taking note of the speed
     569        difference in repeated lookups due to the caching. Run the
     570        <command>dig</command> command twice on the same address:
     571      </para>
    488572
    489573<screen><userinput>dig www.&lfs-domainname; &amp;&amp;
    490574dig www.&lfs-domainname;</userinput></screen>
    491575
    492       <para>You can see almost instantaneous results with the named caching
    493       lookups. Consult the <application>BIND</application> Administrator
    494       Reference Manual located at <filename>doc/arm/Bv9ARM.html</filename>
    495       in the package source tree, for further configuration options.</para>
     576      <para>
     577        You can see almost instantaneous results with the named caching
     578        lookups. Consult the <application>BIND</application> Administrator
     579        Reference Manual located at <filename>doc/arm/Bv9ARM.html</filename>
     580        in the package source tree, for further configuration options.
     581      </para>
    496582
    497583    </sect3>
    … …  
    583669        <term><command>dig</command></term>
    584670        <listitem>
    585           <para>interrogates DNS servers.</para>
     671          <para>
     672            interrogates DNS servers.
     673          </para>
    586674          <indexterm zone="bind dig">
    587675            <primary sortas="b-dig">dig</primary>
    … …  
    657745        <term><command>dnssec-keygen</command></term>
    658746        <listitem>
    659           <para>is a key generator for secure DNS.</para>
     747          <para>
     748            is a key generator for secure DNS.
     749          </para>
    660750          <indexterm zone="bind dnssec-keygen">
    661751            <primary sortas="b-dnssec-keygen">dnssec-keygen</primary>
    … …  
    691781        <term><command>dnssec-signzone</command></term>
    692782        <listitem>
    693           <para>generates signed versions of zone files.</para>
     783          <para>
     784            generates signed versions of zone files.
     785          </para>
    694786          <indexterm zone="bind dnssec-signzone">
    695787            <primary sortas="b-dnssec-signzone">dnssec-signzone</primary>
    … …  
    727819        <term><command>host</command></term>
    728820        <listitem>
    729           <para>is a utility for DNS lookups.</para>
     821          <para>
     822            is a utility for DNS lookups.
     823          </para>
    730824          <indexterm zone="bind host">
    731825            <primary sortas="b-host">host</primary>
    … …  
    761855        <term><command>lwresd</command></term>
    762856        <listitem>
    763           <para>is a caching-only name server for local process use.</para>
     857          <para>
     858            is a caching-only name server for local process use.
     859          </para>
    764860          <indexterm zone="bind lwresd">
    765861            <primary sortas="b-lwresd">lwresd</primary>
    … …  
    771867        <term><command>named</command></term>
    772868        <listitem>
    773           <para>is the name server daemon.</para>
     869          <para>
     870            is the name server daemon.
     871          </para>
    774872          <indexterm zone="bind named">
    775873            <primary sortas="b-named">named</primary>
    … …  
    781879        <term><command>named-checkconf</command></term>
    782880        <listitem>
    783           <para>checks the syntax of <filename>named.conf</filename>
    784           files.</para>
     881          <para>
     882            checks the syntax of <filename>named.conf</filename>
     883            files.
     884          </para>
    785885          <indexterm zone="bind named-checkconf">
    786886            <primary sortas="b-named-checkconf">named-checkconf</primary>
    … …  
    792892        <term><command>named-checkzone</command></term>
    793893        <listitem>
    794           <para>checks zone file validity.</para>
     894          <para>
     895            checks zone file validity.
     896          </para>
    795897          <indexterm zone="bind named-checkzone">
    796898            <primary sortas="b-named-checkzone">named-checkzone</primary>
    … …  
    852954        <term><command>nslookup</command></term>
    853955        <listitem>
    854           <para>is a program used to query Internet domain nameservers.</para>
     956          <para>
     957            is a program used to query Internet domain nameservers.
     958          </para>
    855959          <indexterm zone="bind nslookup">
    856960            <primary sortas="b-nslookup">nslookup</primary>
    … …  
    862966        <term><command>nsupdate</command></term>
    863967        <listitem>
    864           <para>is used to submit DNS update requests.</para>
     968          <para>
     969            is used to submit DNS update requests.
     970          </para>
    865971          <indexterm zone="bind nsupdate">
    866972            <primary sortas="b-nsupdate">nsupdate</primary>
    … …  
    872978        <term><command>rndc</command></term>
    873979        <listitem>
    874           <para>controls the operation of <application>BIND</application>.</para>
     980          <para>
     981            controls the operation of <application>BIND</application>.
     982          </para>
    875983          <indexterm zone="bind rndc">
    876984            <primary sortas="b-rndc">rndc</primary>
    … …  
    882990        <term><command>rndc-confgen</command></term>
    883991        <listitem>
    884           <para>generates <filename>rndc.conf</filename> files.</para>
     992          <para>
     993            generates <filename>rndc.conf</filename> files.
     994          </para>
    885995          <indexterm zone="bind rndc-confgen">
    886996            <primary sortas="b-rndc-confgen">rndc-confgen</primary>

  • server/major/major.xml

    r21a08bf r4472e923  
    1616  <title>Major Servers</title>
    1717
    18   <para>Major servers are the programs that provide content or services
    19   to users or other programs.</para>
     18  <para>
     19    Major servers are the programs that provide content or services
     20    to users or other programs.
     21  </para>
    2022
    2123  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="apache.xml"/>

  • server/major/proftpd.xml

    r21a08bf r4472e923  
    3030    <title>Introduction to ProFTPD</title>
    3131
    32     <para>The <application>ProFTPD</application> package contains a secure
    33     and highly configurable FTP daemon. This is useful for serving large
    34     file archives over a network.</para>
     32    <para>
     33      The <application>ProFTPD</application> package contains a secure
     34      and highly configurable FTP daemon. This is useful for serving large
     35      file archives over a network.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&proftpd-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &proftpd-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &proftpd-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &proftpd-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &proftpd-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&proftpd-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&proftpd-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &proftpd-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &proftpd-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &proftpd-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &proftpd-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    89103    <title>Installation of ProFTPD</title>
    90104
    91     <para>For security reasons, you should install
    92     <application>ProFTPD</application> using an unprivileged user and group.
    93     As the <systemitem class="username">root</systemitem> user:</para>
     105    <para>
     106      For security reasons, you should install
     107      <application>ProFTPD</application> using an unprivileged user and group.
     108      As the <systemitem class="username">root</systemitem> user:
     109    </para>
    94110
    95111<screen role="root"><userinput>groupadd -g 46 proftpd                             &amp;&amp;
    … …  
    108124<screen><userinput remap="pre">patch -Np1 -i ../proftpd-&proftpd-version;-consolidated_fixes-1.patch</userinput></screen>
    109125-->
    110     <para>Install <application>ProFTPD</application> as an unprivileged user by
    111     running the following commands:</para>
     126    <para>
     127      Install <application>ProFTPD</application> as an unprivileged user by
     128      running the following commands:
     129    </para>
    112130
    113131<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/run &amp;&amp;
    114132make</userinput></screen>
    115133
    116     <para>This packages does not come with a usable test suite.</para>
    117 
    118     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     134    <para>
     135      This packages does not come with a usable test suite.
     136    </para>
     137
     138    <para>
     139      Now, as the <systemitem class="username">root</systemitem> user:
     140    </para>
    119141
    120142<screen role="root"><userinput>make install                                   &amp;&amp;
    … …  
    127149    <title>Command Explanations</title>
    128150
    129     <para><command>install -v -d -m775 -o proftpd -g proftpd
    130     /srv/ftp</command>: Create the home directory for
    131     <application>ProFTPD</application>.</para>
    132 
    133     <para><command>ln -v -s /bin/false /usr/bin/proftpdshell</command>:
    134     Set the default shell as a link to an invalid shell.</para>
    135 
    136     <para><command>echo /usr/bin/proftpdshell &gt;&gt;
    137     /etc/shells</command>: Fake a valid shell for compatibility purposes.</para>
     151    <para>
     152      <command>install -v -d -m775 -o proftpd -g proftpd /srv/ftp</command>:
     153      Create the home directory for <application>ProFTPD</application>.
     154    </para>
     155
     156    <para>
     157      <command>ln -v -s /bin/false /usr/bin/proftpdshell</command>:
     158      Set the default shell as a link to an invalid shell.
     159    </para>
     160
     161    <para>
     162      <command>echo /usr/bin/proftpdshell &gt;&gt; /etc/shells</command>:
     163      Fake a valid shell for compatibility purposes.
     164    </para>
    138165
    139166    <note>
    140       <para>The above two commands can be omitted if the following directive is
    141       placed in the configuration file:</para>
     167      <para>
     168        The above two commands can be omitted if the following directive is
     169        placed in the configuration file:
     170      </para>
    142171
    143172<screen><literal>RequireValidShell off</literal></screen>
    144173
    145       <para>By default, proftpd will require that users logging in have valid
    146       shells. The RequireValidShell directive turns off this requirement. This
    147       is only recommended if you are setting up your FTP server exclusively
    148       for anonymous downloads.</para>
     174      <para>
     175        By default, proftpd will require that users logging in have valid
     176        shells. The RequireValidShell directive turns off this requirement.
     177        This is only recommended if you are setting up your FTP server
     178        exclusively for anonymous downloads.
     179      </para>
    149180    </note>
    150181
    … …  
    166197      <title>Config Files</title>
    167198
    168       <para><filename>/etc/proftpd.conf</filename></para>
     199      <para>
     200        <filename>/etc/proftpd.conf</filename>
     201      </para>
    169202
    170203      <indexterm zone="proftpd proftpd-config">
    … …  
    177210      <title>Configuration Information</title>
    178211
    179       <para>This is a simple, download-only sample configuration. See the
    180       <application>ProFTPD</application> documentation in
    181       <filename class="directory">/usr/share/doc/proftpd</filename> and
    182       consult the website at <ulink url="http://www.proftpd.org/"/> for
    183       example configurations.</para>
     212      <para>
     213        This is a simple, download-only sample configuration. See the
     214        <application>ProFTPD</application> documentation in
     215        <filename class="directory">/usr/share/doc/proftpd</filename> and
     216        consult the website at <ulink url="http://www.proftpd.org/"/> for
     217        example configurations.
     218      </para>
    184219
    185220<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"
    … …  
    247282             <phrase revision="systemd">Systemd Unit</phrase></title>
    248283
    249       <para>Install the
    250       <phrase revision="sysv"><filename>/etc/rc.d/init.d/proftpd</filename>
    251       init script</phrase>
    252       <phrase revision="systemd"><filename>proftpd.service</filename>
    253       unit</phrase> included in the
    254       <xref linkend="bootscripts" revision="sysv"/>
    255       <xref linkend="systemd-units" revision="systemd"/>
    256       package.</para>
     284      <para>
     285        Install the
     286        <phrase revision="sysv"><filename>/etc/rc.d/init.d/proftpd</filename>
     287        init script</phrase>
     288        <phrase revision="systemd"><filename>proftpd.service</filename>
     289        unit</phrase> included in the
     290        <xref linkend="bootscripts" revision="sysv"/>
     291        <xref linkend="systemd-units" revision="systemd"/>
     292        package:
     293      </para>
    257294
    258295      <indexterm zone="proftpd proftpd-init">
    … …  
    296333        <term><command>proftpd</command></term>
    297334        <listitem>
    298           <para>is the FTP daemon.</para>
     335          <para>
     336            is the FTP daemon.
     337          </para>
    299338          <indexterm zone="proftpd proftpd-prog">
    300339            <primary sortas="b-proftpd">proftpd</primary>
    … …  
    306345        <term><command>ftpcount</command></term>
    307346        <listitem>
    308           <para>shows the current number of connections.</para>
     347          <para>
     348            shows the current number of connections.
     349          </para>
    309350          <indexterm zone="proftpd ftpcount">
    310351            <primary sortas="b-ftpcount">ftpcount</primary>
    … …  
    316357        <term><command>ftpdctl</command></term>
    317358        <listitem>
    318           <para>is used to control the  proftpd daemon while it is running.</para>
     359          <para>
     360            is used to control the  proftpd daemon while it is running.
     361          </para>
    319362          <indexterm zone="proftpd ftpdctl">
    320363            <primary sortas="b-ftpdctl">ftpdctl</primary>
    … …  
    326369        <term><command>ftpasswd</command></term>
    327370        <listitem>
    328           <para>is a Perl script designed to create and manage
    329           AuthUserFiles and AuthGroupFiles of the correct format for proftpd.</para>
     371          <para>
     372            is a Perl script designed to create and manage
     373            AuthUserFiles and AuthGroupFiles of the correct format for proftpd.
     374          </para>
    330375          <indexterm zone="proftpd ftpasswd">
    331376            <primary sortas="b-ftpasswd">ftpasswd</primary>
    … …  
    337382        <term><command>ftpmail</command></term>
    338383        <listitem>
    339           <para>is a Perl script for sending email based on the proftpd TransferLog.
     384          <para>
     385            is a Perl script for sending email based on the proftpd TransferLog.
    340386          </para>
    341387          <indexterm zone="proftpd ftpmail">
    … …  
    348394        <term><command>ftpquota</command></term>
    349395        <listitem>
    350           <para>is a Perl script designed to create and manage limits and tally
    351           files for the mod_quotatab + mod_quotatab_file module combination
    352           for proftpd.</para>
     396          <para>
     397            is a Perl script designed to create and manage limits and tally
     398            files for the mod_quotatab + mod_quotatab_file module combination
     399            for proftpd.
     400          </para>
    353401          <indexterm zone="proftpd ftpquota">
    354402            <primary sortas="b-ftpquota">ftpquota</primary>
    … …  
    360408        <term><command>ftpscrub</command></term>
    361409        <listitem>
    362           <para>provides a way to scrub the scoreboard file on demand.</para>
     410          <para>
     411            provides a way to scrub the scoreboard file on demand.
     412          </para>
    363413          <indexterm zone="proftpd ftpscrub">
    364414            <primary sortas="b-ftpscrub">ftpscrub</primary>
    … …  
    370420        <term><command>ftpshut</command></term>
    371421        <listitem>
    372           <para>shuts down all <application>proftpd</application> servers
    373           at a given time.</para>
     422          <para>
     423            shuts down all <application>proftpd</application> servers
     424            at a given time.
     425          </para>
    374426          <indexterm zone="proftpd ftpshut">
    375427            <primary sortas="b-ftpshut">ftpshut</primary>
    … …  
    381433        <term><command>ftptop</command></term>
    382434        <listitem>
    383           <para>displays running status on connections.</para>
     435          <para>
     436            displays running status on connections.
     437          </para>
    384438          <indexterm zone="proftpd ftptop">
    385439            <primary sortas="b-ftptop">ftptop</primary>
    … …  
    391445        <term><command>ftpwho</command></term>
    392446        <listitem>
    393           <para>shows current process information for each session.</para>
     447          <para>
     448            shows current process information for each session.
     449          </para>
    394450          <indexterm zone="proftpd ftpwho">
    395451            <primary sortas="b-ftpwho">ftpwho</primary>
    … …  
    401457        <term><command>prxs</command></term>
    402458        <listitem>
    403           <para>is a Perl script designed to compile and install third-party
    404           modules, from source code, as DSO modules for the installed
    405           proftpd.</para>
     459          <para>
     460            is a Perl script designed to compile and install third-party
     461            modules, from source code, as DSO modules for the installed
     462            proftpd.
     463          </para>
    406464          <indexterm zone="proftpd prxs">
    407465            <primary sortas="b-prxs">prxs</primary>

  • server/major/vsftpd.xml

    r21a08bf r4472e923  
    3131    <title>Introduction to vsftpd</title>
    3232
    33     <para>The <application>vsftpd</application> package contains a very
    34     secure and very small FTP daemon. This is useful for serving files
    35     over a network.</para>
     33    <para>
     34      The <application>vsftpd</application> package contains a very
     35      secure and very small FTP daemon. This is useful for serving files
     36      over a network.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&vsftpd-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&vsftpd-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &vsftpd-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &vsftpd-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &vsftpd-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &vsftpd-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&vsftpd-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&vsftpd-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &vsftpd-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &vsftpd-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &vsftpd-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &vsftpd-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    8094    <title>Installation of vsftpd</title>
    8195
    82     <para>For security reasons, running <application>vsftpd</application>
    83     as an unprivileged user and group is encouraged. Also, a user should be
    84     created to map anonymous users. As the <systemitem
    85     class="username">root</systemitem> user, create the needed directories,
    86     users, and groups with the following commands:</para>
     96    <para>
     97      For security reasons, running <application>vsftpd</application>
     98      as an unprivileged user and group is encouraged. Also, a user should be
     99      created to map anonymous users. As the <systemitem
     100      class="username">root</systemitem> user, create the needed directories,
     101      users, and groups with the following commands:
     102    </para>
    87103
    88104<screen role="root"><userinput>install -v -d -m 0755 &vsftpd-empty; &amp;&amp;
    … …  
    93109useradd -c "vsftpd User"  -d /dev/null -g vsftpd -s /bin/false -u 47 vsftpd &amp;&amp;
    94110useradd -c anonymous_user -d /home/ftp -g ftp    -s /bin/false -u 45 ftp</userinput></screen>
    95 <!--
    96     <para>If you did not install the optional <application>libcap2</application> package,
    97     run the following to avoid a build error:</para>
    98 
    99 <screen><userinput>sed -i -e 's|#define VSF_SYSDEP_HAVE_LIBCAP|//&amp;|' sysdeputil.c</userinput></screen>-->
    100 
    101     <para>Build <application>vsftpd</application> as an unprivileged user
    102     using the following command:</para>
     111
     112    <para>
     113      Build <application>vsftpd</application> as an unprivileged user
     114      using the following command:
     115    </para>
    103116
    104117<screen><userinput>make</userinput></screen>
    105118
    106     <para>This package does not come with a test suite.</para>
    107 
    108     <para>Once again, become the <systemitem class="username">root</systemitem>
    109     user and install <application>vsftpd</application> with the following
    110     commands:</para>
     119    <para>
     120      This package does not come with a test suite.
     121    </para>
     122
     123    <para>
     124      Once again, become the <systemitem class="username">root</systemitem>
     125      user and install <application>vsftpd</application> with the following
     126      commands:
     127    </para>
    111128
    112129<screen role="root"><userinput>install -v -m 755 vsftpd        /usr/sbin/vsftpd    &amp;&amp;
    … …  
    120137    <title>Command Explanations</title>
    121138
    122     <para><command>install -v -d ...</command>: This creates the
    123     directory that anonymous users will use (<filename
    124     class='directory'>/home/ftp</filename>)
    125     and the directory the daemon will chroot into
    126     (<filename class='directory'>&vsftpd-empty;</filename>).</para>
     139    <para>
     140      <command>install -v -d ...</command>: This creates the
     141      directory that anonymous users will use (<filename
     142      class='directory'>/home/ftp</filename>)
     143      and the directory the daemon will chroot into
     144      (<filename class='directory'>&vsftpd-empty;</filename>).
     145    </para>
    127146
    128147    <note>
    129       <para><filename class="directory">/home/ftp</filename> should not be
    130       owned by the user <systemitem class="username">vsftpd</systemitem>,
    131       or the user <systemitem class="username">ftp</systemitem>.</para>
     148      <para>
     149        <filename class="directory">/home/ftp</filename> should not be
     150        owned by the user <systemitem class="username">vsftpd</systemitem>,
     151        or the user <systemitem class="username">ftp</systemitem>.
     152      </para>
    132153    </note>
    133154
    134     <para><command>echo "#define VSF_BUILD_TCPWRAPPERS" >>builddefs.h</command>:
    135     Use this prior to <command>make</command> to add support for
    136     <application>tcpwrappers</application>.</para>
    137 
    138     <para><command>echo "#define VSF_BUILD_SSL" >>builddefs.h</command>:
    139     Use this prior to <command>make</command> to add support for SSL.</para>
    140 
    141     <para><command>install -v -m ...</command>:
    142     The <filename>Makefile</filename> uses non-standard installation paths.
    143     These commands install the files in
    144     <filename class='directory'>/usr</filename> and
    145     <filename class='directory'>/etc</filename>.</para>
     155    <para>
     156      <command>echo "#define VSF_BUILD_TCPWRAPPERS" >>builddefs.h</command>:
     157      Use this prior to <command>make</command> to add support for
     158      <application>tcpwrappers</application>.
     159    </para>
     160
     161    <para>
     162      <command>echo "#define VSF_BUILD_SSL" >>builddefs.h</command>:
     163      Use this prior to <command>make</command> to add support for SSL.
     164    </para>
     165
     166    <para>
     167      <command>install -v -m ...</command>:
     168      The <filename>Makefile</filename> uses non-standard installation paths.
     169      These commands install the files in
     170      <filename class='directory'>/usr</filename> and
     171      <filename class='directory'>/etc</filename>.
     172    </para>
    146173
    147174  </sect2>
    … …  
    153180      <title>Config Files</title>
    154181
    155       <para><filename>/etc/vsftpd.conf</filename></para>
     182      <para>
     183        <filename>/etc/vsftpd.conf</filename>
     184      </para>
    156185
    157186      <indexterm zone="vsftpd vsftpd-config">
    … …  
    164193      <title>Configuration Information</title>
    165194
    166       <para><application>vsftpd</application> comes with a basic
    167       anonymous-only configuration file that was copied to
    168       <filename class='directory'>/etc</filename> above. While still as
    169       <systemitem class="username">root</systemitem>, this file should be
    170       modified because it is now recommended to run <command>vsftpd</command>
    171       in standalone mode. <!-- as opposed to
    172       <command>inetd</command>/<command>xinetd</command> mode. -->Also, you
    173       should specify the privilege separation user created above. Finally,
    174       you should specify the <command>chroot</command> directory.
    175       <command>man vsftpd.conf</command> will give you all the details.</para>
     195      <para>
     196        <application>vsftpd</application> comes with a basic
     197        anonymous-only configuration file that was copied to
     198        <filename class='directory'>/etc</filename> above. While still as
     199        <systemitem class="username">root</systemitem>, this file should be
     200        modified because it is now recommended to run <command>vsftpd</command>
     201        in standalone mode. Also, you
     202        should specify the privilege separation user created above. Finally,
     203        you should specify the <command>chroot</command> directory.
     204        <command>man vsftpd.conf</command> will give you all the details.
     205      </para>
    176206
    177207<screen role="root"><userinput>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"
    … …  
    183213
    184214      <!-- recheck this issue when vsftpd is updated -->
    185       <para>The vsftpd daemon uses seccomp to improve security by default.
    186       But it's known to cause vsftpd unable to handle ftp
    187       <literal>LIST</literal> command with recent kernel versions.  Append
    188       a line to <filename>/etc/vsftpd.conf</filename> (as the
    189       <systemitem class="username">root</systemitem> user) to disable
    190       seccomp and workaround this issue:</para>
     215      <para>
     216        The vsftpd daemon uses seccomp to improve security by default.
     217        But it's known to cause vsftpd unable to handle ftp
     218        <literal>LIST</literal> command with recent kernel versions.  Append
     219        a line to <filename>/etc/vsftpd.conf</filename> (as the
     220        <systemitem class="username">root</systemitem> user) to disable
     221        seccomp and workaround this issue:
     222      </para>
    191223
    192224<screen role="root"><userinput>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"
    … …  
    194226EOF</userinput></screen>
    195227
    196       <para>To enable local logins, append the following to the
    197       <filename>/etc/vsftpd.conf</filename> file (as the
    198       <systemitem class="username">root</systemitem> user):</para>
     228      <para>
     229        To enable local logins, append the following to the
     230        <filename>/etc/vsftpd.conf</filename> file (as the
     231        <systemitem class="username">root</systemitem> user):
     232      </para>
    199233
    200234<screen role="root"><userinput>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"
    … …  
    202236EOF</userinput></screen>
    203237
    204       <para>In addition, if using <application>Linux-PAM</application> and
    205       <application>vsftpd</application> with local user logins, you will need
    206       a <application>Linux-PAM</application> configuration file. As the
    207       <systemitem class="username">root</systemitem> user, create the
    208       <filename>/etc/pam.d/vsftpd</filename> file, and add the needed
    209       configuration changes for <application>Linux-PAM</application> session
    210       support using the following commands:</para>
     238      <para>
     239        In addition, if using <application>Linux-PAM</application> and
     240        <application>vsftpd</application> with local user logins, you will need
     241        a <application>Linux-PAM</application> configuration file. As the
     242        <systemitem class="username">root</systemitem> user, create the
     243        <filename>/etc/pam.d/vsftpd</filename> file, and add the needed
     244        configuration changes for <application>Linux-PAM</application> session
     245        support using the following commands:
     246      </para>
    211247
    212248<screen role="root"><userinput>cat &gt; /etc/pam.d/vsftpd &lt;&lt; "EOF" &amp;&amp;
    … …  
    232268             <phrase revision="systemd">Systemd Unit</phrase></title>
    233269
    234       <para>Install the
    235       <phrase revision="sysv"><filename>/etc/rc.d/init.d/vsftpd</filename> init
    236       script</phrase>
    237       <phrase revision="systemd"><filename>vsftpd.service</filename>
    238       unit</phrase> included in the
    239       <xref linkend="bootscripts" revision="sysv"/>
    240       <xref linkend="systemd-units" revision="systemd"/> package.</para>
     270      <para>
     271        Install the
     272        <phrase revision="sysv"><filename>/etc/rc.d/init.d/vsftpd</filename>
     273        init script</phrase>
     274        <phrase revision="systemd"><filename>vsftpd.service</filename>
     275        unit</phrase> included in the
     276        <xref linkend="bootscripts" revision="sysv"/>
     277        <xref linkend="systemd-units" revision="systemd"/> package:
     278      </para>
    241279
    242280<screen role="root"><userinput>make install-vsftpd</userinput></screen>
    … …  
    269307        <term><command>vsftpd</command></term>
    270308        <listitem>
    271           <para>is the FTP daemon.</para>
     309          <para>
     310            is the FTP daemon.
     311          </para>
    272312          <indexterm zone="vsftpd vsftpd-prog">
    273313            <primary sortas="b-vsftpd">vsftpd</primary>

  • server/other/unbound.xml

    r21a08bf r4472e923  
    243243        unit</phrase> included
    244244        in the <xref linkend="bootscripts" revision="sysv"/>
    245         <xref linkend="systemd-units" revision="systemd"/> package.
     245        <xref linkend="systemd-units" revision="systemd"/> package:
    246246      </para>
    247247
Note: See TracChangeset for help on using the changeset viewer.