1 SFTP-SERVER(8) OpenBSD System Manager's Manual SFTP-SERVER(8)
4 sftp-server - SFTP server subsystem
7 sftp-server [-ehR] [-d start_directory] [-f log_facility] [-l log_level]
11 sftp-server is a program that speaks the server side of SFTP protocol to
12 stdout and expects client requests from stdin. sftp-server is not
13 intended to be called directly, but from sshd(8) using the Subsystem
16 Command-line flags to sftp-server should be specified in the Subsystem
17 declaration. See sshd_config(5) for more information.
22 specifies an alternate starting directory for users. The
23 pathname may contain the following tokens that are expanded at
24 runtime: %% is replaced by a literal '%', %h is replaced by the
25 home directory of the user being authenticated, and %u is
26 replaced by the username of that user. The default is to use the
27 user's home directory. This option is useful in conjunction with
28 the sshd_config(5) ChrootDirectory option.
30 -e Causes sftp-server to print logging information to stderr instead
31 of syslog for debugging.
34 Specifies the facility code that is used when logging messages
35 from sftp-server. The possible values are: DAEMON, USER, AUTH,
36 LOCAL0, LOCAL1, LOCAL2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7.
39 -h Displays sftp-server usage information.
42 Specifies which messages will be logged by sftp-server. The
43 possible values are: QUIET, FATAL, ERROR, INFO, VERBOSE, DEBUG,
44 DEBUG1, DEBUG2, and DEBUG3. INFO and VERBOSE log transactions
45 that sftp-server performs on behalf of the client. DEBUG and
46 DEBUG1 are equivalent. DEBUG2 and DEBUG3 each specify higher
47 levels of debugging output. The default is ERROR.
49 -R Places this instance of sftp-server into a read-only mode.
50 Attempts to open files for writing, as well as other operations
51 that change the state of the filesystem, will be denied.
54 Sets an explicit umask(2) to be applied to newly-created files
55 and directories, instead of the user's default mask.
57 For logging to work, sftp-server must be able to access /dev/log. Use of
58 sftp-server in a chroot configuration therefore requires that syslogd(8)
59 establish a logging socket inside the chroot directory.
62 sftp(1), ssh(1), sshd_config(5), sshd(8)
64 T. Ylonen and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh-
65 filexfer-02.txt, October 2001, work in progress material.
68 sftp-server first appeared in OpenBSD 2.8.
71 Markus Friedl <markus@openbsd.org>
73 OpenBSD 5.4 July 16, 2013 OpenBSD 5.4