OFTPD(8) Linux System Administration OFTPD(8)NAMEoftpd - anonymous, read-only FTP server
SYNOPSISoftpd [-p|--port port ] [-i|--interface ip-address ] [-m|--max-clients
num ] [-l|--local local-logging ] [-N|--nodetach] user-name root-direc‐
tory
DESCRIPTIONoftpd is an anonymous-only FTP server.
Although it must be started by the root user, after initialization it
runs as the user specified by user-name parameter. This should be a
user with minimal permissions, preferably from an account set up for
this purpose only.
The server uses chroot(2) to change the root directory of the server to
the root-directory directory. When a user connects, this is the direc‐
tory that they will start in, and is the top of their directory tree.
When FTP clients connect, they may log in as "ftp" or "anonymous".
Typically they will then send their e-mail address as password (most
web browsers send a browser identifier rather than the user's e-mail
address). Standard Unix file permissions are enforced for downloading,
meaning clients may download any file user-name has permission to read.
No uploads are permitted. All client activity is logged (see DIAGNOS‐
TICS below).
OPTIONS
-p|--port port
Use the specified port to listen for client connections. If not
specified, the default FTP port (number 21) is used.
-i|--interface ip-address
Use the interface connected to the IP address ip-address to
accept connections. If not specified, the server listens on all
interfaces.
-m|--max-clients num
Accept at most num simultaneous clients. If not specified, 250
will be the limit.
-l|--local local-logging
Normally oftpd logs messages to syslog as the FTP daemon. With
this option, the specified local-logging level will be used
instead. Valid numbers are 0-8.
-N|--nodetach
Do not run in the background; for running from init(8) or for
testing.
DIAGNOSTICS
Syntax errors will result in a help message being displayed, and a non-
zero exit code returned. Otherwise the server will exit without out‐
put, and return zero.
After the server has started, you should check the appropriate log pro‐
duced by sysklogd(8) for the FTP daemon to insure that startup com‐
pleted correctly. Certain errors occur only after the server has dis‐
connected from the TTY, so can only be recorded via the log mechanism.
If the server must terminate for any reason, it will also be logged, as
will other non-fatal internal errors. They are logged with attention
to how serious the condition is believed to be, as documented in the
syslog(3) library call.
Client activity will also be logged through this mechanism. This
includes connect and disconnect (or rejection due to too many simulta‐
neous users), the e-mail address reported as password, and file trans‐
fers. All client commands are logged as sent at the DEBUG level. To
fully monitor client activity you may configure sysklogd(8) to record
these.
NOTESoftpd does not use inetd(8) to run. It is a stand-alone server. There
is no need to configure the /etc/inetd.conf file to run it. In fact,
there should be no entry for FTP there at all.
You can use the kill(1) command to stop oftpd. When the server
receives SIGHUP or SIGINT, it will stop listening for new FTP connec‐
tions, and a new FTP server may be started. Any existing connections
to the old server will continue to function normally until the client
disconnects or times out. After all clients connections have closed,
the server will exit.
To shutdown the server and close all client connections immediately,
use SIGKILL.
AUTHOR
Shane Kerr <shane@time-travellers.org>
SEE ALSOftp(1)Linux 2001-04-03 OFTPD(8)