1 2 ProFTPD 1.2 README.FreeBSD 3 ========================== 4 5Packages 6-------- 7 8A precompiled FreeBSD package for x86, Alpha, AMD64, and UltraSPARC systems 9can be installed from sources, including CD-ROM, the FreeBSD FTP server and 10its mirrors. To install from the main FreeBSD FTP server: 11 12 # pkg_add -r proftpd 13 14Or, if you want MySQL support: 15 16 # pkg_add -r proftpd-mysql 17 18As the port is updated to a newer version, the corresponding package will be 19updated. 20 21 22Bugs 23---- 24 25FreeBSD releases 2.0 through 3.3-RELEASE have a libc bug with setpassent(). 26If you know that you have a fixed libc you can use the configure command line 27option '--enable-force-setpassent' to use it with one of these fixed releases, 28otherwise ProFTPD will use its internal persistent password support. If you 29would like more information, this bug is described in FreeBSD PR #14201. 30 31 32Compiling From Source 33--------------------- 34 35The FreeBSD ports collection[1,2] enables the downloading, configuring, 36building and installation of ProFTPD in one easy step. 37 38First, you must have the ports collection installed on the system*. The 39ProFTPD port is in ftp/proftpd, so if your ports collection is installed in 40/usr/ports, you should change to that directory: 41 42 $ cd /usr/ports/ftp/proftpd 43 44and run "make" to fetch the ProFTPD source distribution, extract it, apply the 45necessary patches for FreeBSD, configure and build the program. This should be 46done as a normal system user, not root, to minimise the chance of incidents. 47 48 $ make 49 50You can watch the progress as the port builds. Once it has finished, you can 51install the software on the system and register it in the FreeBSD package 52database by running "make install" as root: 53 54 # make install 55 56You can watch the progress as the port installs. Pay attention to any messages 57at the end of the install. Once it has finished, you can set up the system to 58start the ProFTPD server at boot by copying the file proftpd.sh.sample to 59proftpd.sh in directory /usr/local/etc/rc.d/. 60 61If you have installed "portupgrade" (sysutils/portupgrade), you can do this 62all on one line with e.g.: 63 64 $ portupgrade --new --recursive --sudo --verbose ftp/proftpd 65 66After creating your server configuration in /usr/local/etc/proftpd.conf (see 67proftpd.conf.default) for an example) you can start the server with 68 69 # /usr/local/etc/rc.d/proftpd.sh start 70 71Note that the proftpd binary is kept in the library executable directory, 72/usr/local/libexec/ which is not (and should not be) in your PATH, so if you 73want run a configuration test or add debugging flags from the command line, 74use the full path, e.g.: 75 76 # /usr/local/libexec/proftpd --configtest 77 78To get log messages from the FTP server, make sure you have configured syslog 79to save messages with facility "ftp", e.g. in syslog.conf put: 80 81 ftp.info /var/log/ftplog 82 83and signal syslogd to re-read its configuration: 84 85 # kill -HUP `cat /var/run/syslog.pid` 86 87A second port has been created for the ProFTPD "Candidate" releases with the 88provisional name ftp/proftpd-devel, however at the time of writing it has not 89been added to the ports collection. 90 91* After choosing to install it during the initial FreeBSD install or by 92installing it from the FTP site[3], you should keep it up-to-date using 93cvsup[4]. 94 95[1] http://www.freebsd.org/ports/ 96[2] http://www.freebsd.org/doc/handbook/ports-using.html 97[3] ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/ports.tar.gz 98[4] http://www.freebsd.org/doc/handbook/cvsup.html 99