FreeBSD Manual Pages
OFTPD(8) Linux System Administration OFTPD(8) NAME oftpd - anonymous, read-only FTP server SYNOPSIS oftpd [-p|--port port ] [-i|--interface ip-address ] [-m|--max-clients num ] [-l|--local local-logging ] [-N|--nodetach] user-name root-directory DESCRIPTION oftpd 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 directory 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". Typi- cally 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 DIAGNOSTICS 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 inter- faces. -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 test- ing. DIAGNOSTICS Syntax errors will result in a help message being displayed, and a non-zero exit code returned. Otherwise the server will exit without output, and re- turn zero. After the server has started, you should check the appropriate log produced by sysklogd(8) for the FTP daemon to insure that startup completed cor- rectly. Certain errors occur only after the server has disconnected 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 simultaneous users), the e-mail address reported as password, and file transfers. All client commands are logged as sent at the DEBUG level. To fully monitor client activity you may configure sysklogd(8) to record these. NOTES oftpd 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 connections, 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 ALSO ftp(1) Linux 2001-04-03 OFTPD(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DIAGNOSTICS | NOTES | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oftpd&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>