source: content/web/proftpd.xml@ 1586494

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1586494 was 1586494, checked in by Randy McMurchy <randy@…>, 17 years ago

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

  • Property mode set to 100644
File size: 6.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY proftpd-download-http "http://ftp.proftpd.org/distrib/source/proftpd-&proftpd-version;.tar.bz2">
8 <!ENTITY proftpd-download-ftp "ftp://ftp.proftpd.org/distrib/source/proftpd-&proftpd-version;.tar.bz2">
9 <!ENTITY proftpd-size "901 KB">
10 <!ENTITY proftpd-buildsize "7.3 MB">
11 <!ENTITY proftpd-time "0.27 SBU">
12]>
13
14<sect1 id="proftpd" xreflabel="ProFTPD-&proftpd-version;">
15<sect1info>
16<othername>$LastChangedBy$</othername>
17<date>$Date$</date>
18</sect1info>
19<?dbhtml filename="proftpd.html"?>
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>
29
30<sect3><title>Package information</title>
31<itemizedlist spacing='compact'>
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>
36<listitem><para>Download size: &proftpd-size;</para></listitem>
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>
45<sect4><title>Optional</title>
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>
59
60<screen><userinput><command>groupadd proftpd &amp;&amp;
61ln -s false /usr/lib/proftpd/proftpdshell &amp;&amp;
62echo /usr/lib/proftpd/proftpdshell &gt;&gt; /etc/shells &amp;&amp;
63useradd -c proftpd -d /home/ftp -g proftpd -s /usr/lib/proftpd/proftpdshell proftpd</command>
64</userinput></screen>
65
66<para>Install <application>Pro<acronym>FTP</acronym>D</application> by running
67the following commands:</para>
68
69<screen><userinput><command>install_user=proftpd install_group=proftpd \
70 ./configure --prefix=/usr --sysconfdir=/etc \
71 --localstatedir=/var/run &amp;&amp;
72make &amp;&amp;
73make install </command></userinput></screen>
74
75</sect2>
76
77<sect2>
78<title>Command explanations</title>
79
80<para><parameter>install_user=proftpd install_group=proftpd</parameter>:
81Specify the user and group identity for
82<application>Pro<acronym>FTP</acronym>D</application>.</para>
83
84<para><parameter>--sysconfdir=/etc</parameter>:
85This prevents the configuration files from going to
86<filename class="directory">/usr/etc</filename>.</para>
87
88<para><parameter>--localstatedir=/var/run</parameter>:
89This uses <filename class="directory">/var/run</filename> instead of
90<filename class="directory">/usr/var</filename> for lock files.</para>
91
92</sect2>
93
94<sect2>
95<title>Configuring <application>Pro<acronym>FTP</acronym>D</application></title>
96
97<sect3><title>proftpd init.d script</title>
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
101<screen><userinput><command>make install-proftpd</command></userinput></screen>
102
103</sect3>
104
105<sect3><title>Config files</title>
106<para><filename>/etc/proftpd.conf</filename></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>
115
116<screen><userinput><command>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"</command>
117# This is a basic ProFTPD configuration file
118# It establishes a single server and a single anonymous login.
119
120ServerName "ProFTPD Default Installation"
121ServerType standalone
122DefaultServer on
123
124# Port 21 is the standard FTP port.
125Port 21
126# Umask 022 is a good standard umask to prevent new dirs and files
127# from being group and world writable.
128Umask 022
129
130# To prevent DoS attacks, set the maximum number of child processes
131# to 30. If you need to allow more than 30 concurrent connections
132# at once, simply increase this value. Note that this ONLY works
133# in standalone mode, in inetd mode you should use an inetd server
134# that allows you to limit maximum number of processes per service
135# (such as xinetd)
136MaxInstances 30
137
138# Set the user and group that the server normally runs at.
139User proftpd
140Group proftpd
141
142# Normally, files should be overwritable.
143&lt;Directory /*&gt;
144 AllowOverwrite on
145&lt;/Directory&gt;
146
147# A basic anonymous configuration, no upload directories.
148&lt;Anonymous ~proftpd&gt;
149 User proftpd
150 Group proftpd
151 # Clients should be able to login with "anonymous" as well as "proftpd"
152 UserAlias anonymous proftpd
153
154 # Limit the maximum number of anonymous logins
155 MaxClients 10
156
157 # 'welcome.msg' should be displayed at login, and '.message' displayed
158 # in each newly chdired directory.
159 DisplayLogin welcome.msg
160 DisplayFirstChdir .message
161
162 # Limit WRITE everywhere in the anonymous chroot
163 &lt;Limit WRITE&gt;
164 DenyAll
165 &lt;/Limit&gt;
166&lt;/Anonymous&gt;
167<command>EOF</command></userinput></screen></sect3>
168
169</sect2>
170
171<sect2>
172<title>Contents</title>
173
174<para>The <application>Pro<acronym>FTP</acronym>D</application> package contains
175<command>ftpcount</command>, <command>ftpshut</command>,
176<command>ftptop</command>, <command>ftpwho</command> and
177<command>proftpd</command>.</para>
178
179</sect2>
180
181<sect2><title>Description</title>
182
183<sect3><title>ftpcount</title>
184<para><command>ftpcount</command> shows the current number of
185connections.</para></sect3>
186
187<sect3><title>ftpshut</title>
188<para><command>ftpshut</command> shuts down all <command>proftpd</command>
189servers at a given time.</para></sect3>
190
191<sect3><title>ftptop</title>
192<para><command>ftptop</command> displays running status on
193connections.</para></sect3>
194
195<sect3><title>ftpwho</title>
196<para><command>ftpwho</command> shows current process information for
197each session.</para></sect3>
198
199<sect3><title>proftpd</title>
200<para><command>proftpd</command> is the <acronym>FTP</acronym>
201daemon.</para></sect3>
202
203</sect2>
204
205</sect1>
206
Note: See TracBrowser for help on using the repository browser.