source: server/major/proftpd.xml@ a1f2d184

10.0 10.1 11.0 11.1 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a1f2d184 was e89d59a, checked in by Pierre Labastie <pieere@…>, 8 years ago

Update to proftpd-1.3.5

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

  • Property mode set to 100644
File size: 12.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY proftpd-download-http " ">
8 <!ENTITY proftpd-download-ftp "ftp://ftp.proftpd.org/distrib/source/proftpd-&proftpd-version;.tar.gz">
9 <!ENTITY proftpd-md5sum "aff1bff40e675244d72c4667f203e5bb">
10 <!ENTITY proftpd-size "7.2 MB">
11 <!ENTITY proftpd-buildsize "34 MB">
12 <!ENTITY proftpd-time "0.3 SBU">
13]>
14
15<sect1 id="proftpd" xreflabel="ProFTPD-&proftpd-version;">
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 &lfs75_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&proftpd-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&proftpd-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &proftpd-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &proftpd-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &proftpd-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &proftpd-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">ProFTPD Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional</bridgehead>
63 <para role="optional">
64 <xref linkend="libcap-pam"/>,
65 <xref linkend="linux-pam"/>,
66 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
67 <xref linkend="openssl"/>,
68 <xref linkend="pcre"/>,
69 <xref linkend="postgresql"/> and to run tests:
70 <xref linkend="check"/> and
71 <ulink url='http://search.cpan.org/~clemburg/Test-Unit-0.14/'>Test::Unit-0.14</ulink>
72 </para>
73
74 <para condition="html" role="usernotes">User Notes:
75 <ulink url="&blfs-wiki;/proftpd"/></para>
76
77 </sect2>
78
79 <sect2 role="installation">
80 <title>Installation of ProFTPD</title>
81
82 <para>For security reasons, you should install
83 <application>ProFTPD</application> using an unprivileged user and group.
84 As the <systemitem class="username">root</systemitem> user:</para>
85
86<screen role="root"><userinput>groupadd -g 46 proftpd &amp;&amp;
87useradd -c proftpd -d /srv/ftp -g proftpd \
88 -s /usr/bin/proftpdshell -u 46 proftpd &amp;&amp;
89
90install -v -d -m775 -o proftpd -g proftpd /srv/ftp &amp;&amp;
91ln -v -s /bin/false /usr/bin/proftpdshell &amp;&amp;
92echo /usr/bin/proftpdshell &gt;&gt; /etc/shells</userinput></screen>
93
94 <para>Install <application>ProFTPD</application> as an unprivileged user by
95 running the following commands:</para>
96
97<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/run &amp;&amp;
98make</userinput></screen>
99
100 <para>The tests for this package require a very old (2001) version of the
101 Perl Module Test::Unit. Even when using that version of Test::Unit, there
102 are many failures (41/1397) although the program appears to run
103 well. The tests take a long time (45 minutes, not CPU dependent) and are
104 not recommended. To test the results anyway, add the switch: <parameter>
105 --enable-tests</parameter> to the <command>configure</command>, and
106 issue: <command>make check</command>. If the tests are run with root
107 privileges, more tests are run, but there are more failures.</para>
108
109 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
110
111<screen role="root"><userinput>make install</userinput></screen>
112
113 </sect2>
114
115 <sect2 role="commands">
116 <title>Command Explanations</title>
117
118 <para><command>install -v -d -m775 -o proftpd -g proftpd
119 /srv/ftp</command>: Create the home directory for
120 <application>ProFTPD</application>.</para>
121
122 <para><command>ln -v -s /bin/false /usr/bin/proftpdshell</command>:
123 Set the default shell as a link to an invalid shell.</para>
124
125 <para><command>echo /usr/bin/proftpdshell &gt;&gt;
126 /etc/shells</command>: Fake a valid shell for compatibility purposes.</para>
127
128 <note>
129 <para>The above two commands can be omitted if the following directive is
130 placed in the configuration file:</para>
131
132<screen><literal>RequireValidShell off</literal></screen>
133
134 <para>By default, proftpd will require that users logging in have valid
135 shells. The RequireValidShell directive turns off this requirement. This
136 is only recommended if you are setting up your FTP server exclusively
137 for anonymous downloads.</para>
138 </note>
139
140 <note>
141 <para>
142 Support for most of the dependency packages requires using options
143 passed to the <command>configure</command> script. View the output
144 from <command>./configure --help</command> for complete information
145 about enabling dependency packages.
146 </para>
147 </note>
148
149 </sect2>
150
151 <sect2 role="configuration">
152 <title>Configuring ProFTPD</title>
153
154 <sect3 id='proftpd-config'>
155 <title>Config Files</title>
156
157 <para><filename>/etc/proftpd.conf</filename></para>
158
159 <indexterm zone="proftpd proftpd-config">
160 <primary sortas="e-etc-proftpd">/etc/proftpd.conf</primary>
161 </indexterm>
162
163 </sect3>
164
165 <sect3>
166 <title>Configuration Information</title>
167
168 <para>This is a simple, download-only sample configuration. See the
169 <application>ProFTPD</application> documentation in
170 <filename class="directory">/usr/share/doc/proftpd</filename> and
171 consult the website at <ulink url="http://www.proftpd.org/"/> for
172 example configurations.</para>
173
174<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt; /etc/proftpd.conf &lt;&lt; "EOF"
175<literal># This is a basic ProFTPD configuration file
176# It establishes a single server and a single anonymous login.
177
178ServerName "ProFTPD Default Installation"
179ServerType standalone
180DefaultServer on
181
182# Port 21 is the standard FTP port.
183Port 21
184# Umask 022 is a good standard umask to prevent new dirs and files
185# from being group and world writable.
186Umask 022
187
188# To prevent DoS attacks, set the maximum number of child processes
189# to 30. If you need to allow more than 30 concurrent connections
190# at once, simply increase this value. Note that this ONLY works
191# in standalone mode, in inetd mode you should use an inetd server
192# that allows you to limit maximum number of processes per service
193<!--# (such as xinetd)-->
194MaxInstances 30
195
196# Set the user and group that the server normally runs at.
197User proftpd
198Group proftpd
199
200# To cause every FTP user to be "jailed" (chrooted) into their home
201# directory, uncomment this line.
202#DefaultRoot ~
203
204
205# Normally, files should be overwritable.
206&lt;Directory /*&gt;
207 AllowOverwrite on
208&lt;/Directory&gt;
209
210# A basic anonymous configuration, no upload directories.
211&lt;Anonymous ~proftpd&gt;
212 User proftpd
213 Group proftpd
214 # Clients should be able to login with "anonymous" as well as "proftpd"
215 UserAlias anonymous proftpd
216
217 # Limit the maximum number of anonymous logins
218 MaxClients 10
219
220 # 'welcome.msg' should be displayed at login, and '.message' displayed
221 # in each newly chdired directory.
222 DisplayLogin welcome.msg
223 DisplayChdir .message
224
225 # Limit WRITE everywhere in the anonymous chroot
226 &lt;Limit WRITE&gt;
227 DenyAll
228 &lt;/Limit&gt;
229&lt;/Anonymous&gt;</literal>
230EOF</userinput></screen>
231
232 </sect3>
233
234 <sect3 id="proftpd-init">
235 <title>Boot Script</title>
236
237 <para>Install the <filename>/etc/rc.d/init.d/proftpd</filename> init
238 script included in the <xref linkend="bootscripts"/>
239 package.</para>
240
241 <indexterm zone="proftpd proftpd-init">
242 <primary sortas="f-proftpd">proftpd</primary>
243 </indexterm>
244
245<screen role="root"><userinput>make install-proftpd</userinput></screen>
246
247 </sect3>
248
249 </sect2>
250
251 <sect2 role="content">
252 <title>Contents</title>
253
254 <segmentedlist>
255 <segtitle>Installed Programs</segtitle>
256 <segtitle>Installed Libraries</segtitle>
257 <segtitle>Installed Directory</segtitle>
258
259 <seglistitem>
260 <seg>ftpcount, ftpdctl, ftpasswd, ftpmail, ftpquota, ftpscrub,
261 ftptop, ftpshut, ftpcount, ftpwho, and proftpd</seg>
262 <seg>None</seg>
263 <seg>/usr/lib/proftpd</seg>
264 </seglistitem>
265 </segmentedlist>
266
267 <variablelist>
268 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
269 <?dbfo list-presentation="list"?>
270 <?dbhtml list-presentation="table"?>
271
272 <varlistentry id="proftpd-prog">
273 <term><command>proftpd</command></term>
274 <listitem>
275 <para>is the FTP daemon.</para>
276 <indexterm zone="proftpd proftpd-prog">
277 <primary sortas="b-proftpd">proftpd</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="ftpcount">
283 <term><command>ftpcount</command></term>
284 <listitem>
285 <para>shows the current number of connections.</para>
286 <indexterm zone="proftpd ftpcount">
287 <primary sortas="b-ftpcount">ftpcount</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="ftpdctl">
293 <term><command>ftpdctl</command></term>
294 <listitem>
295 <para>is used to control the proftpd daemon while it is running.</para>
296 <indexterm zone="proftpd ftpdctl">
297 <primary sortas="b-ftpdctl">ftpdctl</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
301
302 <varlistentry id="ftpasswd">
303 <term><command>ftpasswd</command></term>
304 <listitem>
305 <para>is a Perl script designed to create and manage
306 AuthUserFiles and AuthGroupFiles of the correct format for proftpd.</para>
307 <indexterm zone="proftpd ftpasswd">
308 <primary sortas="b-ftpasswd">ftpasswd</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="ftpmail">
314 <term><command>ftpmail</command></term>
315 <listitem>
316 <para>is a Perl script for sending email based on the proftpd TransferLog.
317 </para>
318 <indexterm zone="proftpd ftpmail">
319 <primary sortas="b-ftpmail">ftpmail</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="ftpquota">
325 <term><command>ftpquota</command></term>
326 <listitem>
327 <para>is a Perl script designed to create and manage limits and tally
328 files for the mod_quotatab + mod_quotatab_file module combination
329 for proftpd.</para>
330 <indexterm zone="proftpd ftpquota">
331 <primary sortas="b-ftpquota">ftpquota</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="ftpscrub">
337 <term><command>ftpscrub</command></term>
338 <listitem>
339 <para>provides a way to scrub the scoreboard file on demand.</para>
340 <indexterm zone="proftpd ftpscrub">
341 <primary sortas="b-ftpscrub">ftpscrub</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="ftpshut">
347 <term><command>ftpshut</command></term>
348 <listitem>
349 <para>shuts down all <application>proftpd</application> servers
350 at a given time.</para>
351 <indexterm zone="proftpd ftpshut">
352 <primary sortas="b-ftpshut">ftpshut</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="ftptop">
358 <term><command>ftptop</command></term>
359 <listitem>
360 <para>displays running status on connections.</para>
361 <indexterm zone="proftpd ftptop">
362 <primary sortas="b-ftptop">ftptop</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 <varlistentry id="ftpwho">
368 <term><command>ftpwho</command></term>
369 <listitem>
370 <para>shows current process information for each session.</para>
371 <indexterm zone="proftpd ftpwho">
372 <primary sortas="b-ftpwho">ftpwho</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 </variablelist>
378
379 </sect2>
380
381</sect1>
Note: See TracBrowser for help on using the repository browser.