1.\" Copyright (c) 2001 Daniel Jacobowitz <dan@debian.org>
2.Dd March 8, 2001
3.Dt VSFTPD 8
4.Sh NAME
5.Nm vsftpd
6.Nd Very Secure FTP Daemon
7.Sh SYNOPSIS
8.Nm vsftpd
9.Op Ar configuration file and / or options
10.Sh DESCRIPTION
11.Nm vsftpd
12is the Very Secure File Transfer Protocol Daemon. The server can be launched
13via a
14.Dq super-server
15such as
16.Xr inetd 8
17or
18.Xr xinetd 8 .
19Alternatively, vsftpd can be launched in standalone mode, in which case vsftpd
20itself will listen on the network. This latter mode is easier to use, and
21recommended. It is activated by setting
22.Pa listen=YES
23in
24.Pa /etc/vsftpd/vsftpd.conf .
25Direct execution of the
26.Nm vsftpd
27binary will then launch the FTP service ready for immediate client connections.
28.Sh OPTIONS
29An optional
30configuration file or files
31may be given on the command line. These files must be owned as root if running
32as root. Any command line option not starting with a "-" character is treated
33as a config file that will be loaded. Note that config files are loaded in the
34strict order that they are encountered on the command line.
35If no config files are specified, the default configuration file of
36.Pa /etc/vsftpd/vsftpd.conf
37will be loaded, after all other command line options are processed.
38.Pp
39Supported options are:
40.Bl -tag -width Ds
41.It Fl v
42Print the version information and exit, even if other options are encountered.
43.It Fl ooption=value
44Set a single option, value pair as per the format in the config file. Multiple
45-o options are supported, and they are applied in strict order relative to
46their appearance on the command line, including intermingling with loading of
47config files.
48.El
49.Sh EXAMPLES
50vsftpd -olisten=NO /etc/vsftpd/vsftpd.conf -oftpd_banner=blah
51.Pp
52That example overrides vsftpd's built-in default for the "listen" option to be
53NO, but then loads /etc/vsftpd/vsftpd.conf which may override that setting.
54Finally, the "ftpd_banner" setting is set to "blah", which overrides any default
55vsftpd setting and any identical setting that was in the config file.
56.Sh FILES
57.Pa /etc/vsftpd/vsftpd.conf
58.Sh SEE ALSO
59.Xr vsftpd.conf 5
60.end
61