Changeset f8ff412


Ignore:
Timestamp:
05/18/2005 05:58:54 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:
1e11f8e
Parents:
99ef1fc
Message:

Tagged vsftpd.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/major/vsftpd.xml

    r99ef1fc rf8ff412  
    1414
    1515<sect1 id="vsftpd" xreflabel="vsFTPD-&vsftpd-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="vsftpd.html"?>
    21 <title><application>vs<acronym>FTP</acronym>D</application>-&vsftpd-version;
    22 </title>
    23 
    24 <sect2>
    25 <title>Introduction to
    26 <application>vs<acronym>FTP</acronym>D</application></title>
    27 
    28 <para>The <application>vs<acronym>FTP</acronym>D</application> package
    29 contains a very secure and very small <acronym>FTP</acronym> daemon. This is
    30 useful for serving files over a network.</para>
    31 
    32 <sect3><title>Package information</title>
    33 <itemizedlist spacing='compact'>
    34 <listitem><para>Download (HTTP):
    35 <ulink url="&vsftpd-download-http;"/></para></listitem>
    36 <listitem><para>Download (FTP):
    37 <ulink url="&vsftpd-download-ftp;"/></para></listitem>
    38 <listitem><para>Download MD5 sum: &vsftpd-md5sum;</para></listitem>
    39 <listitem><para>Download size: &vsftpd-size;</para></listitem>
    40 <listitem><para>Estimated disk space required:
    41 &vsftpd-buildsize;</para></listitem>
    42 <listitem><para>Estimated build time:
    43 &vsftpd-time;</para></listitem></itemizedlist>
    44 </sect3>
    45 
    46 <sect3><title><application>vsFTPD</application> dependencies</title>
    47 <sect4><title>Optional</title>
    48 <para><xref linkend="Linux_PAM"/>,
    49 <xref linkend="openssl"/>, and
    50 <xref linkend="tcpwrappers"/></para>
    51 </sect4>
    52 </sect3>
    53 
    54 </sect2>
    55 
    56 <sect2>
    57 <title>Installation of <application>vsFTPD</application></title>
    58 
    59 <para>For security reasons, running
    60 <application>vs<acronym>FTP</acronym>D</application> as an unprivileged user
    61 and group is encouraged. Also, a user to map anonymous users to should be
    62 created.</para>
    63 
    64 <screen><userinput><command>install -d -m 0755 /var/ftp/empty &amp;&amp;
    65 install -d -m 0755 /home/ftp &amp;&amp;
     16  <?dbhtml filename="vsftpd.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>vsFTPD-&vsftpd-version;</title>
     24
     25  <indexterm zone="vsftpd">
     26    <primary sortas="a-vsFTPD">vsFTPD</primary>
     27  </indexterm>
     28
     29  <sect2>
     30    <title>Introduction to vsFTPD</title>
     31
     32    <para>The <application>vsFTPD</application> package contains a very
     33    secure and very small FTP daemon. This is useful for serving files
     34    over a network.</para>
     35
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&vsftpd-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&vsftpd-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &vsftpd-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &vsftpd-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &vsftpd-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &vsftpd-time;</para>
     55      </listitem>
     56    </itemizedlist>
     57
     58    <bridgehead renderas="sect3">vsFTPD Dependencies</bridgehead>
     59
     60    <bridgehead renderas="sect4">Optional</bridgehead>
     61    <para><xref linkend="Linux_PAM"/>,
     62    <xref linkend="openssl"/>, and
     63    <xref linkend="tcpwrappers"/></para>
     64
     65  </sect2>
     66
     67  <sect2 role="installation">
     68    <title>Installation of vsFTPD</title>
     69
     70    <para>For security reasons, running <application>vsFTPD</application>
     71    as an unprivileged user and group is encouraged. Also, a user to map
     72    anonymous users to should be created.</para>
     73
     74<screen role="root"><userinput>install -v -d -m 0755 /var/ftp/empty &amp;&amp;
     75install -v -d -m 0755 /home/ftp &amp;&amp;
    6676groupadd vsftpd &amp;&amp;
    6777useradd -d /dev/null -c "vsFTPD User" -g vsftpd -s /bin/false vsftpd &amp;&amp;
    6878groupadd ftp &amp;&amp;
    69 useradd -c anonymous_user -d /home/ftp -g ftp -s /bin/false ftp</command>
    70 </userinput></screen>
    71 
    72 <para>Install <application>vs<acronym>FTP</acronym>D</application> by running
    73 the following commands:</para>
    74 
    75 <screen><userinput><command>make &amp;&amp;
    76 install -m 755 vsftpd /usr/sbin/vsftpd &amp;&amp;
    77 install -m 644 vsftpd.8 /usr/share/man/man8 &amp;&amp;
    78 install -m 644 vsftpd.conf.5 /usr/share/man/man5 &amp;&amp;
    79 install -m 644 vsftpd.conf /etc</command></userinput></screen>
    80 
    81 </sect2>
    82 
    83 <sect2>
    84 <title>Command explanations</title>
    85 
    86 <para><parameter>install -d [...]</parameter>: This creates the directory that
    87 anonymous users will use (<filename class='directory'>/home/ftp</filename>)
    88 and the directory the daemon will chroot into
    89 (<filename class='directory'>/var/ftp/empty</filename>).</para>
    90 
    91 <note><para><filename class="directory">/home/ftp</filename> should not be
    92 owned by the user vsftpd, or the user ftp.</para></note>
    93 
    94 <para><parameter>echo "#define VSF_BUILD_TCPWRAPPERS" >>builddefs.h</parameter>:
    95 Use this prior to <command>make</command> to add support for
    96 <application>tcpwrappers</application>.</para>
    97 
    98 <para><parameter>echo "#define VSF_BUILD_SSL" >>builddefs.h</parameter>:
    99 Use this prior to <command>make</command> to add support for
    100 <acronym>SSL</acronym>.</para>
    101 
    102 <para><parameter>install -m [...]</parameter>:
    103 The <filename>Makefile</filename> hardwires
    104 <filename class='directory'>/usr/local</filename> (if it exists). These
    105 commands install the files in
    106 <filename class='directory'>/usr</filename>.</para>
    107 
    108 </sect2>
    109 
    110 <sect2>
    111 <title>Configuring <application>vs<acronym>FTP</acronym>D</application></title>
    112 
    113 <sect3><title>vsftpd init.d script</title>
    114 <para>Install the <filename>/etc/rc.d/init.d/vsftpd</filename>
    115 init script included in the
    116 <xref linkend="intro-important-bootscripts"/> package.</para>
    117 
    118 <screen><userinput><command>make install-vsftpd</command></userinput></screen>
    119 
    120 </sect3>
    121 
    122 <sect3><title>Config files</title>
    123 <para><filename>/etc/vsftpd.conf</filename></para>
    124 </sect3>
    125 
    126 <sect3><title>Configuration information</title>
    127 <para><application>vs<acronym>FTP</acronym>D</application> comes with a basic
    128 anonymous-only configuration file that was copied to
    129 <filename class='directory'>/etc</filename> above. This file should be modified
    130 because it is now recommended to run <command>vsftpd</command> in standalone
    131 mode as opposed to <command>inetd</command>/<command>xinetd</command> mode.
    132 Also, you should specify the privilege separation user created above. Finally,
    133 you should specify the <command>chroot</command> directory.
    134 <command>man vsftpd.conf</command> will give you all the details.</para>
    135 
    136 <screen><userinput><command>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"</command>
    137 background=YES
     79useradd -c anonymous_user -d /home/ftp -g ftp -s /bin/false ftp</userinput></screen>
     80
     81    <para>Install <application>vsFTPD</application> by running
     82    the following commands:</para>
     83
     84<screen><userinput>make &amp;&amp;
     85install -v -m 755 vsftpd /usr/sbin/vsftpd &amp;&amp;
     86install -v -m 644 vsftpd.8 /usr/share/man/man8 &amp;&amp;
     87install -v -m 644 vsftpd.conf.5 /usr/share/man/man5 &amp;&amp;
     88install -v -m 644 vsftpd.conf /etc</userinput></screen>
     89
     90  </sect2>
     91
     92  <sect2 role="commands">
     93    <title>Command Explanations</title>
     94
     95    <para><parameter>install -v -d [...]</parameter>: This creates the
     96    directory that anonymous users will use (<filename
     97    class='directory'>/home/ftp</filename>)
     98    and the directory the daemon will chroot into
     99    (<filename class='directory'>/var/ftp/empty</filename>).</para>
     100
     101    <note>
     102      <para><filename class="directory">/home/ftp</filename> should not be
     103      owned by the user <systemitem class="username">vsftpd</systemitem>,
     104      or the user <systemitem class="username">ftp</systemitem>.</para>
     105    </note>
     106
     107    <para><option>echo "#define VSF_BUILD_TCPWRAPPERS" >>builddefs.h</option>:
     108    Use this prior to <command>make</command> to add support for
     109    <application>tcpwrappers</application>.</para>
     110
     111    <para><option>echo "#define VSF_BUILD_SSL" >>builddefs.h</option>:
     112    Use this prior to <command>make</command> to add support for SSL.</para>
     113
     114    <para><option>install -m [...]</option>:
     115    The <filename>Makefile</filename> hardwires
     116    <filename class='directory'>/usr/local</filename> (if it exists). These
     117    commands install the files in
     118    <filename class='directory'>/usr</filename>.</para>
     119
     120  </sect2>
     121
     122  <sect2 role="configuration">
     123    <title>Configuring vsFTPD</title>
     124
     125    <sect3 id="vsftpd-config">
     126      <title>Config Files</title>
     127
     128      <para><filename>/etc/vsftpd.conf</filename></para>
     129
     130      <indexterm zone="vsftpd vsftpd-config">
     131        <primary sortas="e-etc-vsftpd.conf">/etc/vsftpd.conf</primary>
     132      </indexterm>
     133
     134    </sect3>
     135
     136    <sect3>
     137      <title>Configuration Information</title>
     138
     139      <para><application>vsFTPD</application> comes with a basic
     140      anonymous-only configuration file that was copied to
     141      <filename class='directory'>/etc</filename> above. This file should be
     142      modified because it is now recommended to run <command>vsftpd</command>
     143      in standalone mode as opposed to
     144      <command>inetd</command>/<command>xinetd</command> mode. Also, you
     145      should specify the privilege separation user created above. Finally,
     146      you should specify the <command>chroot</command> directory.
     147      <command>man vsftpd.conf</command> will give you all the details.</para>
     148
     149<screen role="root"><userinput>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"
     150<literal>background=YES
    138151listen=YES
    139152nopriv_user=vsftpd
    140 secure_chroot_dir=/var/ftp/empty
    141 <command>EOF</command></userinput></screen>
    142 </sect3>
    143 
    144 </sect2>
    145 
    146 <sect2>
    147 <title>Contents</title>
    148 
    149 <para>The <application>vs<acronym>FTP</acronym>D</application> package contains
    150 <command>vsftpd</command>.</para>
    151 
    152 </sect2>
    153 
    154 <sect2><title>Description</title>
    155 
    156 <sect3><title>vsftpd</title>
    157 <para><command>vsftpd</command> is the <acronym>FTP</acronym>
    158 daemon.</para></sect3>
    159 
    160 </sect2>
     153secure_chroot_dir=/var/ftp/empty</literal>
     154EOF</userinput></screen>
     155
     156    </sect3>
     157
     158    <sect3  id="vsftpd-init">
     159      <title>Boot Script</title>
     160
     161      <para>Install the <filename>/etc/rc.d/init.d/vsftpd</filename>
     162      init script included in the
     163      <xref linkend="intro-important-bootscripts"/> package.</para>
     164
     165<screen role="root"><userinput>make install-vsftpd</userinput></screen>
     166
     167    </sect3>
     168
     169  </sect2>
     170
     171  <sect2 role="content">
     172    <title>Contents</title>
     173
     174    <segmentedlist>
     175      <segtitle>Installed Program</segtitle>
     176      <segtitle>Installed Libraries</segtitle>
     177      <segtitle>Installed Directories</segtitle>
     178
     179      <seglistitem>
     180        <seg>vsftpd</seg>
     181        <seg>None</seg>
     182        <seg>Not determined at this time</seg>
     183      </seglistitem>
     184    </segmentedlist>
     185
     186    <variablelist>
     187      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     188      <?dbfo list-presentation="list"?>
     189      <?dbhtml list-presentation="table"?>
     190
     191      <varlistentry id="vsftpd-prog">
     192        <term><command>vsftpd</command></term>
     193        <listitem>
     194          <para>is the FTP daemon.</para>
     195          <indexterm zone="vsftpd vsftpd-prog">
     196            <primary sortas="b-vsftpd">vsftpd</primary>
     197          </indexterm>
     198        </listitem>
     199      </varlistentry>
     200
     201    </variablelist>
     202
     203  </sect2>
    161204
    162205</sect1>
    163 
Note: See TracChangeset for help on using the changeset viewer.