Ignore:
Timestamp:
05/18/2005 04:48:09 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
b2323d4
Parents:
84f1407
Message:

Tagged proftpd.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/major/proftpd.xml

    r84f1407 rce49e897  
    1414
    1515<sect1 id="proftpd" xreflabel="ProFTPD-&proftpd-version;">
    16 <sect1info>
    17   <othername>$LastChangedBy$</othername>
    18   <date>$Date$</date>
    19 </sect1info>
    20 
    21 <?dbhtml filename="proftpd.html"?>
    22 <title><application>Pro<acronym>FTP</acronym>D</application>-&proftpd-version;</title>
    23 
    24 <indexterm zone="proftpd">
    25   <primary sortas="a-proftpd">Proftpd</primary>
    26 </indexterm>
    27 
    28 <sect2>
    29 <title>Introduction to <application>Pro<acronym>FTP</acronym>D</application></title>
    30 
    31 <para>The <application>Pro<acronym>FTP</acronym>D</application> package
    32 contains a secure and highly configurable <acronym>FTP</acronym> daemon. This
    33 is useful for serving large file archives over a network.</para>
    34 
    35 <sect3>
    36 <title>Package information</title>
    37 <itemizedlist spacing='compact'>
    38   <listitem><para>Download (HTTP): <ulink url="&proftpd-download-http;"/></para></listitem>
    39   <listitem><para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para></listitem>
    40   <listitem><para>Download MD5 sum: &proftpd-md5sum;</para></listitem>
    41   <listitem><para>Download size: &proftpd-size;</para></listitem>
    42   <listitem><para>Estimated disk space required: &proftpd-buildsize;</para></listitem>
    43   <listitem><para>Estimated build time: &proftpd-time;</para></listitem>
    44 </itemizedlist>
    45 </sect3>
    46 
    47 <sect3>
    48 <title><application>Pro<acronym>FTP</acronym>D</application> dependencies</title>
    49 
    50 <sect4>
    51 <title>Optional</title>
    52 
    53 <para><xref linkend="Linux_PAM"/></para>
    54 
    55 </sect4>
    56 </sect3>
    57 
    58 </sect2>
    59 
    60 <sect2>
    61 <title>Installation of <application>Pro<acronym>FTP</acronym>D</application></title>
    62 
    63 <para>For security reasons, you should install
    64 <application>Pro<acronym>FTP</acronym>D</application> using an unprivileged user
    65 and group.  As the root user:</para>
    66 
    67 <screen><userinput><command>groupadd proftpd &amp;&amp;
     16  <?dbhtml filename="proftpd.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>ProFTPD-&proftpd-version;</title>
     24
     25  <indexterm zone="proftpd">
     26    <primary sortas="a-proftpd">Proftpd</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to ProFTPD</title>
     31
     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>
     35
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&proftpd-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &proftpd-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &proftpd-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &proftpd-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &proftpd-time;</para>
     55      </listitem>
     56    </itemizedlist>
     57
     58    <bridgehead renderas="sect3">ProFTPD Dependencies</bridgehead>
     59
     60    <bridgehead renderas="sect4">Optional</bridgehead>
     61    <para><xref linkend="Linux_PAM"/></para>
     62
     63  </sect2>
     64
     65  <sect2 role="installation">
     66    <title>Installation of ProFTPD</title>
     67
     68    <para>For security reasons, you should install
     69    <application>ProFTPD</application> using an unprivileged user and group.
     70    As the <systemitem class="username">root</systemitem> user:</para>
     71
     72<screen role="root"><userinput>groupadd proftpd &amp;&amp;
    6873useradd -c proftpd -d /home/ftp -g proftpd \
    6974        -s /usr/lib/proftpd/proftpdshell proftpd &amp;&amp;
    70 install -d -m775 -o proftpd -g proftpd /usr/lib/proftpd &amp;&amp;
    71 ln -s /bin/false /usr/lib/proftpd/proftpdshell &amp;&amp;
    72 echo /usr/lib/proftpd/proftpdshell &gt;&gt; /etc/shells</command></userinput></screen>
    73 
    74 <para>Install <application>Pro<acronym>FTP</acronym>D</application> as a regular user by running
    75 the following commands:</para>
    76 
    77 <screen><userinput><command>install_user=proftpd install_group=proftpd \
     75install -v -d -m775 -o proftpd -g proftpd /usr/lib/proftpd &amp;&amp;
     76ln -v -s /bin/false /usr/lib/proftpd/proftpdshell &amp;&amp;
     77echo /usr/lib/proftpd/proftpdshell &gt;&gt; /etc/shells</userinput></screen>
     78
     79    <para>Install <application>ProFTPD</application> as a regular user by
     80    running the following commands:</para>
     81
     82<screen><userinput>install_user=proftpd install_group=proftpd \
    7883    ./configure --prefix=/usr --sysconfdir=/etc \
    7984    --localstatedir=/var/run &amp;&amp;
    80 make</command></userinput></screen>
    81 
    82 <para>Now, again as the root user:</para>
    83  
    84 <screen><userinput role='root'><command>make install</command></userinput></screen>
    85 
    86 </sect2>
    87 
    88 <sect2>
    89 <title>Command explanations</title>
    90 
    91 <para><command>install -d -m775 -o proftpd -g proftpd /usr/lib/proftpd</command>:
    92 Create the home directory for <application>Pro<acronym>FTP</acronym>D</application>.</para>
    93 
    94 <para><command>ln -s /bin/false /usr/lib/proftpd/proftpdshell</command>:
    95 Set the default shell as a link to a invalid shell.</para>
    96 
    97 <para><command>echo /usr/lib/proftpd/proftpdshell &gt;&gt; /etc/shells</command>:
    98 Fake a valid shell for compatability purposes.</para>
    99 
    100 <note><para>The above three commands can be ommitted if the following directive is
    101 placed in the configuration file:
    102 
    103 <screen>RequireValidShell off</screen>
    104 
    105 By default, proftpd will require that users logging in have valid shells.
    106 The RequireValidShell directive turns off this requirement.  This is only
    107 recommended if you are setting up your <acronym>FTP</acronym> server exclusively
    108 for anonymous downloads.
    109 </para></note>
    110 
    111 <para><parameter>install_user=proftpd install_group=proftpd</parameter>:
    112 Specify the user and group identity for
    113 <application>Pro<acronym>FTP</acronym>D</application>.</para>
    114 
    115 <para><parameter>--sysconfdir=/etc</parameter>:
    116 This prevents the configuration files from going to
    117 <filename class="directory">/usr/etc</filename>.</para>
    118 
    119 <para><parameter>--localstatedir=/var/run</parameter>:
    120 This uses <filename class="directory">/var/run</filename> instead of
    121 <filename class="directory">/usr/var</filename> for lock files.</para>
    122 
    123 </sect2>
    124 
    125 <sect2>
    126 <title>Configuring <application>Pro<acronym>FTP</acronym>D</application></title>
    127 
    128 <sect3 id='proftpd-init'>
    129 <title>proftpd init.d script</title>
    130 
    131 <indexterm zone="proftpd proftpd-init">
    132   <primary sortas="f-proftpd">proftpd</primary>
    133 </indexterm>
    134 
    135 
    136 <para>Install the <filename>/etc/rc.d/init.d/proftpd</filename> init script
    137 included in the <xref linkend="intro-important-bootscripts"/> package.</para>
    138 
    139 <screen><userinput><command>make install-proftpd</command></userinput></screen>
    140 
    141 </sect3>
    142 
    143 <sect3 id='proftpd-config'>
    144 <title>Config files</title>
    145 
    146 <indexterm zone="proftpd proftpd-config">
    147    <primary sortas="e-etc-proftpd">/etc/proftpd.conf</primary>
    148 </indexterm>
    149 
    150 <para><filename>/etc/proftpd.conf</filename></para>
    151 </sect3>
    152 
    153 <sect3><title>Configuration information</title>
    154 <para>This is a simple, download-only sample configuration. See the
    155 <application>Pro<acronym>FTP</acronym>D</application> documentation in
    156 <filename class="directory">/usr/share/doc/proftpd</filename> and consult the
    157 website at <ulink url="http://www.proftpd.org/"/> for example
    158 configurations.</para>
    159 
    160 <screen><userinput><command>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"</command>
    161 # This is a basic ProFTPD configuration file
     85make</userinput></screen>
     86
     87    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     88
     89<screen role="root"><userinput>make install</userinput></screen>
     90
     91  </sect2>
     92
     93  <sect2 role="commands">
     94    <title>Command Explanations</title>
     95
     96    <para><command>install -v -d -m775 -o proftpd -g proftpd
     97    /usr/lib/proftpd</command>: Create the home directory for
     98    <application>ProFTPD</application>.</para>
     99
     100    <para><command>ln -v -s /bin/false /usr/lib/proftpd/proftpdshell</command>:
     101    Set the default shell as a link to a invalid shell.</para>
     102
     103    <para><command>echo /usr/lib/proftpd/proftpdshell &gt;&gt;
     104    /etc/shells</command>: Fake a valid shell for compatability purposes.</para>
     105
     106    <note>
     107      <para>The above three commands can be ommitted if the following directive is
     108      placed in the configuration file:</para>
     109
     110<screen><literal>RequireValidShell off</literal></screen>
     111
     112      <para>By default, proftpd will require that users logging in have valid
     113      shells. The RequireValidShell directive turns off this requirement. This
     114      is only recommended if you are setting up your FTP server exclusively
     115      for anonymous downloads.</para>
     116    </note>
     117
     118    <para><parameter>install_user=proftpd install_group=proftpd</parameter>:
     119    Specify the user and group identity for
     120    <application>ProFTPD</application>.</para>
     121
     122    <para><parameter>--sysconfdir=/etc</parameter>: This prevents the
     123    configuration files from going to
     124    <filename class="directory">/usr/etc</filename>.</para>
     125
     126    <para><parameter>--localstatedir=/var/run</parameter>:
     127    This uses <filename class="directory">/var/run</filename> instead of
     128    <filename class="directory">/usr/var</filename> for lock files.</para>
     129
     130  </sect2>
     131
     132  <sect2 role="configuration">
     133    <title>Configuring ProFTPD</title>
     134
     135    <sect3 id='proftpd-config'>
     136      <title>Config Files</title>
     137
     138      <para><filename>/etc/proftpd.conf</filename></para>
     139
     140      <indexterm zone="proftpd proftpd-config">
     141        <primary sortas="e-etc-proftpd">/etc/proftpd.conf</primary>
     142      </indexterm>
     143
     144    </sect3>
     145
     146    <sect3>
     147      <title>Configuration Information</title>
     148
     149      <para>This is a simple, download-only sample configuration. See the
     150      <application>ProFTPD</application> documentation in
     151      <filename class="directory">/usr/share/doc/proftpd</filename> and
     152      consult the website at <ulink url="http://www.proftpd.org/"/> for
     153      example configurations.</para>
     154
     155<screen role="root"><userinput>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"
     156<literal># This is a basic ProFTPD configuration file
    162157# It establishes a single server and a single anonymous login.
    163158
    … …  
    208203    DenyAll
    209204  &lt;/Limit&gt;
    210 &lt;/Anonymous&gt;
    211 <command>EOF</command></userinput></screen></sect3>
    212 
    213 </sect2>
    214 
    215 <sect2>
    216 <title>Contents</title>
    217 
    218 <segmentedlist>
    219   <segtitle>Installed Programs</segtitle>
    220   <segtitle>Installed Libraries</segtitle>
    221   <segtitle>Installed Directory</segtitle>
    222  
    223   <seglistitem>
    224     <seg>ftpcount, ftpdctl, ftptop, ftpwho, ftpshut, proftpd</seg>
    225     <seg>None</seg>
    226     <seg>/var/run/proftpd</seg>
    227   </seglistitem>
    228 </segmentedlist>
    229  
    230 <variablelist>
    231   <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    232   <?dbfo list-presentation="list"?>
    233 
    234 <varlistentry id="proftpd-prog">
    235   <term><command>proftpd</command></term>
    236   <listitem>
    237     <para>is the <acronym>FTP</acronym> daemon.</para>
    238     <indexterm zone="proftpd proftpd-prog">
    239       <primary sortas="b-proftpd">proftpd</primary>
    240     </indexterm>
    241   </listitem>
    242 </varlistentry>
    243 
    244 <varlistentry id="ftpcount">
    245   <term><command>ftpcount</command></term>
    246   <listitem>
    247     <para>shows the current number of connections.</para>
    248     <indexterm zone="proftpd ftpcount">
    249       <primary sortas="b-ftpcount">ftpcount</primary>
    250     </indexterm>
    251   </listitem>
    252 </varlistentry>
    253 
    254 <varlistentry id="ftpshut">
    255   <term><command>ftpshut</command></term>
    256   <listitem>
    257     <para>shuts down all <application>proftpd</application> servers at a given time.</para>
    258     <indexterm zone="proftpd ftpshut">
    259       <primary sortas="b-ftpshut">ftpshut</primary>
    260     </indexterm>
    261   </listitem>
    262 </varlistentry>
    263 
    264 <varlistentry id="ftptop">
    265   <term><command>ftptop</command></term>
    266   <listitem>
    267     <para>displays running status on connections.</para>
    268     <indexterm zone="proftpd ftptop">
    269       <primary sortas="b-ftptop">ftptop</primary>
    270     </indexterm>
    271   </listitem>
    272 </varlistentry>
    273 
    274 <varlistentry id="ftpwho">
    275   <term><command>ftpwho</command></term>
    276   <listitem>
    277     <para>shows current process information for each session.</para>
    278     <indexterm zone="proftpd ftpwho">
    279       <primary sortas="b-ftpwho">ftpwho</primary>
    280     </indexterm>
    281   </listitem>
    282 </varlistentry>
    283 
    284 </variablelist>
    285 </sect2>
     205&lt;/Anonymous&gt;</literal>
     206EOF</userinput></screen>
     207
     208    </sect3>
     209
     210    <sect3  id="proftpd-init">
     211      <title>Boot Script</title>
     212
     213      <para>Install the <filename>/etc/rc.d/init.d/proftpd</filename> init
     214      script included in the <xref linkend="intro-important-bootscripts"/>
     215      package.</para>
     216
     217      <indexterm zone="proftpd proftpd-init">
     218        <primary sortas="f-proftpd">proftpd</primary>
     219      </indexterm>
     220
     221<screen role="root"><userinput>make install-proftpd</userinput></screen>
     222
     223    </sect3>
     224
     225  </sect2>
     226
     227  <sect2 role="content">
     228    <title>Contents</title>
     229
     230    <segmentedlist>
     231      <segtitle>Installed Programs</segtitle>
     232      <segtitle>Installed Libraries</segtitle>
     233      <segtitle>Installed Directory</segtitle>
     234
     235      <seglistitem>
     236        <seg>ftpcount, ftpdctl, ftptop, ftpwho, ftpshut, proftpd</seg>
     237        <seg>None</seg>
     238        <seg>/var/run/proftpd</seg>
     239      </seglistitem>
     240    </segmentedlist>
     241
     242    <variablelist>
     243      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     244      <?dbfo list-presentation="list"?>
     245      <?dbhtml list-presentation="table"?>
     246
     247      <varlistentry id="proftpd-prog">
     248        <term><command>proftpd</command></term>
     249        <listitem>
     250          <para>is the FTP daemon.</para>
     251          <indexterm zone="proftpd proftpd-prog">
     252            <primary sortas="b-proftpd">proftpd</primary>
     253          </indexterm>
     254        </listitem>
     255      </varlistentry>
     256
     257      <varlistentry id="ftpcount">
     258        <term><command>ftpcount</command></term>
     259        <listitem>
     260          <para>shows the current number of connections.</para>
     261          <indexterm zone="proftpd ftpcount">
     262            <primary sortas="b-ftpcount">ftpcount</primary>
     263          </indexterm>
     264        </listitem>
     265      </varlistentry>
     266
     267      <varlistentry id="ftpshut">
     268        <term><command>ftpshut</command></term>
     269        <listitem>
     270          <para>shuts down all <application>proftpd</application> servers
     271          at a given time.</para>
     272          <indexterm zone="proftpd ftpshut">
     273            <primary sortas="b-ftpshut">ftpshut</primary>
     274          </indexterm>
     275        </listitem>
     276      </varlistentry>
     277
     278      <varlistentry id="ftptop">
     279        <term><command>ftptop</command></term>
     280        <listitem>
     281          <para>displays running status on connections.</para>
     282          <indexterm zone="proftpd ftptop">
     283            <primary sortas="b-ftptop">ftptop</primary>
     284          </indexterm>
     285        </listitem>
     286      </varlistentry>
     287
     288      <varlistentry id="ftpwho">
     289        <term><command>ftpwho</command></term>
     290        <listitem>
     291          <para>shows current process information for each session.</para>
     292          <indexterm zone="proftpd ftpwho">
     293            <primary sortas="b-ftpwho">ftpwho</primary>
     294          </indexterm>
     295        </listitem>
     296      </varlistentry>
     297
     298    </variablelist>
     299
     300  </sect2>
    286301
    287302</sect1>
    288 
Note: See TracChangeset for help on using the changeset viewer.