Changeset 1728f4e for content


Ignore:
Timestamp:
03/09/2005 07:08:08 AM (19 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 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:
74dfeae
Parents:
3d26c4b
Message:

Updated proftpd instructions and explanations.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • content/web/proftpd.xml

    r3d26c4b r1728f4e  
    1515<sect1 id="proftpd" xreflabel="ProFTPD-&proftpd-version;">
    1616<sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
     17  <othername>$LastChangedBy$</othername>
     18  <date>$Date$</date>
    1919</sect1info>
     20
    2021<?dbhtml filename="proftpd.html"?>
    21 <title><application>Pro<acronym>FTP</acronym>D</application>-&proftpd-version;
    22 </title>
    23 
    24 <sect2>
    25 <title>Introduction to
    26 <application>Pro<acronym>FTP</acronym>D</application></title>
     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>
    2730
    2831<para>The <application>Pro<acronym>FTP</acronym>D</application> package
    … …  
    3033is useful for serving large file archives over a network.</para>
    3134
    32 <sect3><title>Package information</title>
     35<sect3>
     36<title>Package information</title>
    3337<itemizedlist spacing='compact'>
    34 <listitem><para>Download (HTTP):
    35 <ulink url="&proftpd-download-http;"/></para></listitem>
    36 <listitem><para>Download (FTP):
    37 <ulink url="&proftpd-download-ftp;"/></para></listitem>
    38 <listitem><para>Download MD5 sum: &proftpd-md5sum;</para></listitem>
    39 <listitem><para>Download size: &proftpd-size;</para></listitem>
    40 <listitem><para>Estimated disk space required:
    41 &proftpd-buildsize;</para></listitem>
    42 <listitem><para>Estimated build time:
    43 &proftpd-time;</para></listitem></itemizedlist>
    44 </sect3>
    45 
    46 <sect3><title><application>Pro<acronym>FTP</acronym>D</application>
    47 dependencies</title>
    48 <sect4><title>Optional</title>
     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
    4953<para><xref linkend="Linux_PAM"/></para>
     54
    5055</sect4>
    5156</sect3>
    … …  
    5459
    5560<sect2>
    56 <title>Installation of
    57 <application>Pro<acronym>FTP</acronym>D</application></title>
    58 
    59 <para>For security reasons, running
    60 <application>Pro<acronym>FTP</acronym>D</application> as an unprivileged user
    61 and group using its own login shell is encouraged.</para>
     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
     65and group.  As the root user:</para>
    6266
    6367<screen><userinput><command>groupadd proftpd &amp;&amp;
    64 ln -s false /usr/lib/proftpd/proftpdshell &amp;&amp;
    65 echo /usr/lib/proftpd/proftpdshell &gt;&gt; /etc/shells &amp;&amp;
    6668useradd -c proftpd -d /home/ftp -g proftpd \
    67         -s /usr/lib/proftpd/proftpdshell proftpd</command>
    68 </userinput></screen>
    69 
    70 <para>Install <application>Pro<acronym>FTP</acronym>D</application> by running
     69        -s /usr/lib/proftpd/proftpdshell proftpd &amp;&amp;
     70install -d -m775 -o proftpd -g proftpd /usr/lib/proftpd &amp;&amp;
     71ln -s /bin/false /usr/lib/proftpd/proftpdshell &amp;&amp;
     72echo /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
    7175the following commands:</para>
    7276
    … …  
    7478    ./configure --prefix=/usr --sysconfdir=/etc \
    7579    --localstatedir=/var/run &amp;&amp;
    76 make &amp;&amp;
    77 make install </command></userinput></screen>
     80make</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>
    7885
    7986</sect2>
    … …  
    8188<sect2>
    8289<title>Command explanations</title>
     90
     91<para><command>install -d -m775 -o proftpd -g proftpd /usr/lib/proftpd</command>:
     92Create 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>:
     95Set 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>:
     98Fake a valid shell for compatability purposes.</para>
     99
     100<note><para>The above three commands can be ommitted if the following directive is
     101placed in the configuration file:
     102
     103<screen>RequireValidShell off</screen>
     104
     105By default, proftpd will require that users logging in have valid shells.
     106The RequireValidShell directive turns off this requirement.  This is only
     107recommended if you are setting up your <acronym>FTP</acronym> server exclusively
     108for anonymous downloads.
     109</para></note>
    83110
    84111<para><parameter>install_user=proftpd install_group=proftpd</parameter>:
    … …  
    99126<title>Configuring <application>Pro<acronym>FTP</acronym>D</application></title>
    100127
    101 <sect3><title>proftpd init.d script</title>
     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
    102136<para>Install the <filename>/etc/rc.d/init.d/proftpd</filename> init script
    103137included in the <xref linkend="intro-important-bootscripts"/> package.</para>
    … …  
    107141</sect3>
    108142
    109 <sect3><title>Config files</title>
     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
    110150<para><filename>/etc/proftpd.conf</filename></para>
    111151</sect3>
    … …  
    176216<title>Contents</title>
    177217
    178 <para>The <application>Pro<acronym>FTP</acronym>D</application> package contains
    179 <command>ftpcount</command>, <command>ftpshut</command>,
    180 <command>ftptop</command>, <command>ftpwho</command> and
    181 <command>proftpd</command>.</para>
    182 
    183 </sect2>
    184 
    185 <sect2><title>Description</title>
    186 
    187 <sect3><title>ftpcount</title>
    188 <para><command>ftpcount</command> shows the current number of
    189 connections.</para></sect3>
    190 
    191 <sect3><title>ftpshut</title>
    192 <para><command>ftpshut</command> shuts down all <command>proftpd</command>
    193 servers at a given time.</para></sect3>
    194 
    195 <sect3><title>ftptop</title>
    196 <para><command>ftptop</command> displays running status on
    197 connections.</para></sect3>
    198 
    199 <sect3><title>ftpwho</title>
    200 <para><command>ftpwho</command> shows current process information for
    201 each session.</para></sect3>
    202 
    203 <sect3><title>proftpd</title>
    204 <para><command>proftpd</command> is the <acronym>FTP</acronym>
    205 daemon.</para></sect3>
    206 
     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>
    207285</sect2>
    208286
Note: See TracChangeset for help on using the changeset viewer.