Changeset 1586494 for content


Ignore:
Timestamp:
12/22/2004 01:00:40 AM (19 years ago)
Author:
Randy McMurchy <randy@…>
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:
dc94017e
Parents:
ce4eef0
Message:

Spelling, grammar, tag and excessive whitespace corrections to various package instructions

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

Location:
content/web
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • content/web/proftpd.xml

    rce4eef0 r1586494  
    1818</sect1info>
    1919<?dbhtml filename="proftpd.html"?>
    20 <title>ProFTPD-&proftpd-version;</title>
    21 
    22 <sect2>
    23 <title>Introduction to ProFTPD</title>
    24 
    25 <para>The <application>ProFTPD</application> package contains a secure and
    26 highly configurable FTP daemon. This is useful for serving large file archives
    27 over a network.</para>
     20<title><application>Pro<acronym>FTP</acronym>D</application>-&proftpd-version;</title>
     21
     22<sect2>
     23<title>Introduction to
     24<application>Pro<acronym>FTP</acronym>D</application></title>
     25
     26<para>The <application>Pro<acronym>FTP</acronym>D</application> package
     27contains a secure and highly configurable <acronym>FTP</acronym> daemon. This
     28is useful for serving large file archives over a network.</para>
    2829
    2930<sect3><title>Package information</title>
    3031<itemizedlist spacing='compact'>
    31 <listitem><para>Download (HTTP):<ulink url="&proftpd-download-http;"/></para></listitem>
    32 <listitem><para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para></listitem>
     32<listitem><para>Download (HTTP):
     33<ulink url="&proftpd-download-http;"/></para></listitem>
     34<listitem><para>Download (FTP):
     35<ulink url="&proftpd-download-ftp;"/></para></listitem>
    3336<listitem><para>Download size: &proftpd-size;</para></listitem>
    34 <listitem><para>Estimated Disk space required: &proftpd-buildsize;</para></listitem>
    35 <listitem><para>Estimated build time: &proftpd-time;</para></listitem></itemizedlist>
    36 </sect3>
    37 
    38 <sect3><title><application>ProFTPD</application> dependencies</title>
     37<listitem><para>Estimated disk space required:
     38&proftpd-buildsize;</para></listitem>
     39<listitem><para>Estimated build time:
     40&proftpd-time;</para></listitem></itemizedlist>
     41</sect3>
     42
     43<sect3><title><application>Pro<acronym>FTP</acronym>D</application>
     44dependencies</title>
    3945<sect4><title>Optional</title>
    40 <para><xref linkend="Linux_PAM"/></para></sect4>
    41 </sect3>
    42 
    43 </sect2>
    44 
    45 <sect2>
    46 <title>Installation of <application>ProFTPD</application></title>
    47 
    48 <para>For security reasons, running <application>ProFTPD</application>
    49 as an unprivileged user and group using its own login shell is encouraged.</para>
     46<para><xref linkend="Linux_PAM"/></para>
     47</sect4>
     48</sect3>
     49
     50</sect2>
     51
     52<sect2>
     53<title>Installation of
     54<application>Pro<acronym>FTP</acronym>D</application></title>
     55
     56<para>For security reasons, running
     57<application>Pro<acronym>FTP</acronym>D</application> as an unprivileged user
     58and group using its own login shell is encouraged.</para>
    5059
    5160<screen><userinput><command>groupadd proftpd &amp;&amp;
    … …  
    5564</userinput></screen>
    5665
    57 <para>Install <application>ProFTPD</application> by running the following commands:</para>
     66<para>Install <application>Pro<acronym>FTP</acronym>D</application> by running
     67the following commands:</para>
    5868
    5969<screen><userinput><command>install_user=proftpd install_group=proftpd \
    … …  
    6979
    7080<para><parameter>install_user=proftpd install_group=proftpd</parameter>:
    71 Specify the user and group identity for ProFTPD.</para>
     81Specify the user and group identity for
     82<application>Pro<acronym>FTP</acronym>D</application>.</para>
    7283
    7384<para><parameter>--sysconfdir=/etc</parameter>:
    … …  
    8293
    8394<sect2>
    84 <title>Configuring <application>ProFTPD</application></title>
     95<title>Configuring <application>Pro<acronym>FTP</acronym>D</application></title>
    8596
    8697<sect3><title>proftpd init.d script</title>
    87 <para>Install the <filename>/etc/rc.d/init.d/proftpd</filename>
    88 init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
    89                                                                                                                
     98<para>Install the <filename>/etc/rc.d/init.d/proftpd</filename> init script
     99included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     100
    90101<screen><userinput><command>make install-proftpd</command></userinput></screen>
    91102
    … …  
    93104
    94105<sect3><title>Config files</title>
    95 
    96106<para><filename>/etc/proftpd.conf</filename></para>
    97 <para>This is a simple, download-only sample configuration. See the ProFTPD
    98 documentation in <filename class="directory">/usr/share/doc/proftpd</filename>
    99 and consult the website at <ulink url="http://www.proftpd.org/"/>
    100  for example configurations.</para>
     107</sect3>
     108
     109<sect3><title>Configuration information</title>
     110<para>This is a simple, download-only sample configuration. See the
     111<application>Pro<acronym>FTP</acronym>D</application> documentation in
     112<filename class="directory">/usr/share/doc/proftpd</filename> and consult the
     113website at <ulink url="http://www.proftpd.org/"/> for example
     114configurations.</para>
    101115
    102116<screen><userinput><command>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"</command>
    … …  
    126140Group                           proftpd
    127141
    128 # Normally, we want files to be overwritable.
     142# Normally, files should be overwritable.
    129143&lt;Directory /*&gt;
    130144  AllowOverwrite                on
    … …  
    135149  User                          proftpd
    136150  Group                         proftpd
    137   # We want clients to be able to login with "anonymous" as well as "proftpd"
     151  # Clients should be able to login with "anonymous" as well as "proftpd"
    138152  UserAlias                     anonymous proftpd
    139153
    … …  
    141155  MaxClients                    10
    142156
    143   # We want 'welcome.msg' displayed at login, and '.message' displayed
     157  # 'welcome.msg' should be displayed at login, and '.message' displayed
    144158  # in each newly chdired directory.
    145159  DisplayLogin                  welcome.msg
    … …  
    158172<title>Contents</title>
    159173
    160 <para>The <application>ProFTPD</application> package contains
     174<para>The <application>Pro<acronym>FTP</acronym>D</application> package contains
    161175<command>ftpcount</command>, <command>ftpshut</command>,
    162176<command>ftptop</command>, <command>ftpwho</command> and
    … …  
    168182
    169183<sect3><title>ftpcount</title>
    170 <para><command>ftpcount</command> shows the current number of connections.</para></sect3>
     184<para><command>ftpcount</command> shows the current number of
     185connections.</para></sect3>
    171186
    172187<sect3><title>ftpshut</title>
    173 <para><command>ftpshut</command> shuts down all proftpd servers at a
    174 given time.</para></sect3>
     188<para><command>ftpshut</command> shuts down all <command>proftpd</command>
     189servers at a given time.</para></sect3>
    175190
    176191<sect3><title>ftptop</title>
    177 <para><command>ftptop</command> displays running status on connections.</para></sect3>
     192<para><command>ftptop</command> displays running status on
     193connections.</para></sect3>
    178194
    179195<sect3><title>ftpwho</title>
    … …  
    182198
    183199<sect3><title>proftpd</title>
    184 <para><command>proftpd</command> is the daemon itself.</para></sect3>
     200<para><command>proftpd</command> is the <acronym>FTP</acronym>
     201daemon.</para></sect3>
    185202
    186203</sect2>

  • content/web/vsftpd.xml

    rce4eef0 r1586494  
    99  <!ENTITY vsftpd-size          "148 KB">
    1010  <!ENTITY vsftpd-buildsize     "492 KB">
    11   <!ENTITY vsftpd-time          "0.0 SBU">
     11  <!ENTITY vsftpd-time          "0.01 SBU">
    1212]>
    1313
    … …  
    1818</sect1info>
    1919<?dbhtml filename="vsftpd.html"?>
    20 <title>vsFTPD-&vsftpd-version;</title>
     20<title><application>vs<acronym>FTP</acronym>D</application>-&vsftpd-version;</title>
    2121
    2222<sect2>
    23 <title>Introduction to vsFTPD</title>
     23<title>Introduction to
     24<application>vs<acronym>FTP</acronym>D</application></title>
    2425
    25 <para>The <application>vsFTPD</application> package contains a very secure and
    26 very small FTP daemon. This is useful for serving files over a network.</para>
     26<para>The <application>vs<acronym>FTP</acronym>D</application> package
     27contains a very secure and very small <acronym>FTP</acronym> daemon. This is
     28useful for serving files over a network.</para>
    2729
    2830<sect3><title>Package information</title>
    2931<itemizedlist spacing='compact'>
    30 <listitem><para>Download (HTTP):<ulink url="&vsftpd-download-http;"/></para></listitem>
    31 <listitem><para>Download (FTP): <ulink url="&vsftpd-download-ftp;"/></para></listitem>
     32<listitem><para>Download (HTTP):
     33<ulink url="&vsftpd-download-http;"/></para></listitem>
     34<listitem><para>Download (FTP):
     35<ulink url="&vsftpd-download-ftp;"/></para></listitem>
    3236<listitem><para>Download size: &vsftpd-size;</para></listitem>
    33 <listitem><para>Estimated Disk space required: &vsftpd-buildsize;</para></listitem>
    34 <listitem><para>Estimated build time: &vsftpd-time;</para></listitem></itemizedlist>
     37<listitem><para>Estimated disk space required:
     38&vsftpd-buildsize;</para></listitem>
     39<listitem><para>Estimated build time:
     40&vsftpd-time;</para></listitem></itemizedlist>
    3541</sect3>
    3642
    … …  
    3945<para><xref linkend="Linux_PAM"/>,
    4046<xref linkend="openssl"/>, and
    41 <xref linkend="tcpwrappers"/></para></sect4>
     47<xref linkend="tcpwrappers"/></para>
     48</sect4>
    4249</sect3>
    4350
    … …  
    4754<title>Installation of <application>vsFTPD</application></title>
    4855
    49 <para>For security reasons, running <application>vsFTPD</application> as an
    50 unprivileged user and group is encouraged. Also, we need a user to map
    51 anonymous users to.</para>
     56<para>For security reasons, running
     57<application>vs<acronym>FTP</acronym>D</application> as an unprivileged user
     58and group is encouraged. Also, a user to map anonymous users to should be
     59created.</para>
    5260
    5361<screen><userinput><command>install -d -m 0755 /var/ftp/empty &amp;&amp;
    5462install -d -m 0755 /home/ftp &amp;&amp;
    5563groupadd vsftpd &amp;&amp;
    56 useradd -d /dev/null -g vsftpd -s /bin/false vsftpd &amp;&amp;
     64useradd -d /dev/null -c "vsFTPD User" -g vsftpd -s /bin/false vsftpd &amp;&amp;
    5765groupadd ftp &amp;&amp;
    5866useradd -c anonymous_user -d /home/ftp -g ftp -s /bin/false ftp</command>
    5967</userinput></screen>
    6068
    61 <para>Install <application>vsFTPD</application> by running the following commands:</para>
     69<para>Install <application>vs<acronym>FTP</acronym>D</application> by running
     70the following commands:</para>
    6271
    6372<screen><userinput><command>make &amp;&amp;
    … …  
    6574install -m 644 vsftpd.8 /usr/share/man/man8 &amp;&amp;
    6675install -m 644 vsftpd.conf.5 /usr/share/man/man5 &amp;&amp;
    67 install -m 644 vsftpd.conf /etc
    68 </command></userinput></screen>
     76install -m 644 vsftpd.conf /etc</command></userinput></screen>
    6977
    7078</sect2>
    … …  
    7482
    7583<para><parameter>install -d [...]</parameter>: This creates the directory that
    76 anonymous users will use (/home/ftp) and the directory the daemon will chroot
    77 into (/var/ftp/empty).</para>
     84anonymous users will use (<filename class='directory'>/home/ftp</filename>)
     85and the directory the daemon will chroot into
     86(<filename class='directory'>/var/ftp/empty</filename>).</para>
    7887
    7988<note><para><filename class="directory">/home/ftp</filename> should not be
    … …  
    8190
    8291<para><parameter>echo "#define VSF_BUILD_TCPWRAPPERS" >>builddefs.h</parameter>:
    83 Use this prior to make to add support for tcpwrappers.</para>
     92Use this prior to <command>make</command> to add support for
     93<application>tcpwrappers</application>.</para>
    8494
    8595<para><parameter>echo "#define VSF_BUILD_SSL" >>builddefs.h</parameter>:
    86 Use this prior to make to add support for SSL.</para>
     96Use this prior to <command>make</command> to add support for
     97<acronym>SSL</acronym>.</para>
    8798
    8899<para><parameter>install -m [...]</parameter>:
    89 The Makefile hardwires /usr/local (if it exists). We want the files in /usr.</para>
     100The <filename>Makefile</filename> hardwires
     101<filename class='directory'>/usr/local</filename> (if it exists). These
     102commands install the files in
     103<filename class='directory'>/usr</filename>.</para>
    90104
    91105</sect2>
    92106
    93107<sect2>
    94 <title>Configuring <application>vsFTPD</application></title>
     108<title>Configuring <application>vs<acronym>FTP</acronym>D</application></title>
    95109
    96110<sect3><title>vsftpd init.d script</title>
    97111<para>Install the <filename>/etc/rc.d/init.d/vsftpd</filename>
    98 init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
    99                                                                                                                
     112init script included in the
     113<xref linkend="intro-important-bootscripts"/> package.</para>
     114
    100115<screen><userinput><command>make install-vsftpd</command></userinput></screen>
    101116
    … …  
    103118
    104119<sect3><title>Config files</title>
     120<para><filename>/etc/vsftpd.conf</filename></para>
     121</sect3>
    105122
    106 <para><filename>/etc/vsftpd.conf</filename></para> <para>vsFTPD comes with a
    107 basic anonymous-only configuration file that was copied to /etc above. We will
    108 modify this file because it is now recommended to run vsFTPD in standalone mode
    109 as opposed to inetd/xinetd mode. Also, we need to specify the priviledge
    110 separation user we created above. Finally, we need to specify the chroot
    111 directory.  <command>man vsftpd.conf</command> will give you all the
    112 details.</para>
     123<sect3><title>Configuration information</title>
     124<para><application>vs<acronym>FTP</acronym>D</application> comes with a basic
     125anonymous-only configuration file that was copied to
     126<filename class='directory'>/etc</filename> above. This file should be modified
     127because it is now recommended to run <command>vsftpd</command> in standalone
     128mode as opposed to <command>inetd</command>/<command>xinetd</command> mode.
     129Also, you should specify the privilege separation user created above. Finally,
     130you should specify the <command>chroot</command> directory.
     131<command>man vsftpd.conf</command> will give you all the details.</para>
    113132
    114133<screen><userinput><command>cat &gt;&gt; /etc/vsftpd.conf &lt;&lt; "EOF"</command>
    … …  
    117136nopriv_user=vsftpd
    118137secure_chroot_dir=/var/ftp/empty
    119 <command>EOF</command></userinput></screen></sect3>
     138<command>EOF</command></userinput></screen>
     139</sect3>
    120140
    121141</sect2>
    … …  
    124144<title>Contents</title>
    125145
    126 <para>The <application>vsFTPD</application> package contains
     146<para>The <application>vs<acronym>FTP</acronym>D</application> package contains
    127147<command>vsftpd</command>.</para>
    128148
    … …  
    132152
    133153<sect3><title>vsftpd</title>
    134 <para><command>vsftpd</command> is the daemon itself.</para></sect3>
     154<para><command>vsftpd</command> is the <acronym>FTP</acronym>
     155daemon.</para></sect3>
    135156
    136157</sect2>
Note: See TracChangeset for help on using the changeset viewer.