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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • 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>
Note: See TracChangeset for help on using the changeset viewer.