2010-03-08 11:19:52 +00:00
|
|
|
.\" $OpenBSD: sftp-server.8,v 1.19 2010/01/09 03:36:00 jmc Exp $
|
2009-10-01 17:12:52 +00:00
|
|
|
.\" $FreeBSD$
|
2000-09-10 08:31:17 +00:00
|
|
|
.\"
|
2001-05-04 03:57:05 +00:00
|
|
|
.\" Copyright (c) 2000 Markus Friedl. All rights reserved.
|
2000-09-10 08:31:17 +00:00
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
.\"
|
2010-06-01 15:11:29 +00:00
|
|
|
.Dd January 9, 2010
|
2000-09-10 08:31:17 +00:00
|
|
|
.Dt SFTP-SERVER 8
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm sftp-server
|
|
|
|
.Nd SFTP server subsystem
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm sftp-server
|
2010-03-08 11:19:52 +00:00
|
|
|
.Op Fl ehR
|
2006-09-30 13:29:51 +00:00
|
|
|
.Op Fl f Ar log_facility
|
|
|
|
.Op Fl l Ar log_level
|
2010-03-08 11:19:52 +00:00
|
|
|
.Op Fl u Ar umask
|
2000-09-10 08:31:17 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
|
|
|
is a program that speaks the server side of SFTP protocol
|
|
|
|
to stdout and expects client requests from stdin.
|
|
|
|
.Nm
|
|
|
|
is not intended to be called directly, but from
|
2000-12-05 02:20:19 +00:00
|
|
|
.Xr sshd 8
|
2000-09-10 08:31:17 +00:00
|
|
|
using the
|
|
|
|
.Cm Subsystem
|
|
|
|
option.
|
2006-09-30 13:29:51 +00:00
|
|
|
.Pp
|
|
|
|
Command-line flags to
|
|
|
|
.Nm
|
|
|
|
should be specified in the
|
|
|
|
.Cm Subsystem
|
|
|
|
declaration.
|
2000-09-10 08:31:17 +00:00
|
|
|
See
|
2004-02-26 10:38:49 +00:00
|
|
|
.Xr sshd_config 5
|
2000-09-10 08:31:17 +00:00
|
|
|
for more information.
|
2006-09-30 13:29:51 +00:00
|
|
|
.Pp
|
|
|
|
Valid options are:
|
|
|
|
.Bl -tag -width Ds
|
2010-03-08 11:19:52 +00:00
|
|
|
.It Fl e
|
|
|
|
Causes
|
|
|
|
.Nm
|
|
|
|
to print logging information to stderr instead of syslog for debugging.
|
2006-09-30 13:29:51 +00:00
|
|
|
.It Fl f Ar log_facility
|
|
|
|
Specifies the facility code that is used when logging messages from
|
|
|
|
.Nm .
|
|
|
|
The possible values are: DAEMON, USER, AUTH, LOCAL0, LOCAL1, LOCAL2,
|
|
|
|
LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7.
|
|
|
|
The default is AUTH.
|
2010-03-08 11:19:52 +00:00
|
|
|
.It Fl h
|
|
|
|
Displays
|
|
|
|
.Nm
|
|
|
|
usage information.
|
2006-09-30 13:29:51 +00:00
|
|
|
.It Fl l Ar log_level
|
|
|
|
Specifies which messages will be logged by
|
|
|
|
.Nm .
|
|
|
|
The possible values are:
|
|
|
|
QUIET, FATAL, ERROR, INFO, VERBOSE, DEBUG, DEBUG1, DEBUG2, and DEBUG3.
|
|
|
|
INFO and VERBOSE log transactions that
|
|
|
|
.Nm
|
|
|
|
performs on behalf of the client.
|
|
|
|
DEBUG and DEBUG1 are equivalent.
|
|
|
|
DEBUG2 and DEBUG3 each specify higher levels of debugging output.
|
|
|
|
The default is ERROR.
|
2010-03-08 11:19:52 +00:00
|
|
|
.It Fl R
|
|
|
|
Places this instance of
|
|
|
|
.Nm
|
|
|
|
into a read-only mode.
|
|
|
|
Attempts to open files for writing, as well as other operations that change
|
|
|
|
the state of the filesystem, will be denied.
|
|
|
|
.It Fl u Ar umask
|
|
|
|
Sets an explicit
|
|
|
|
.Xr umask 2
|
|
|
|
to be applied to newly-created files and directories, instead of the
|
|
|
|
user's default mask.
|
2006-09-30 13:29:51 +00:00
|
|
|
.El
|
2008-07-23 09:33:08 +00:00
|
|
|
.Pp
|
|
|
|
For logging to work,
|
|
|
|
.Nm
|
|
|
|
must be able to access
|
|
|
|
.Pa /dev/log .
|
|
|
|
Use of
|
|
|
|
.Nm
|
2009-10-01 15:19:37 +00:00
|
|
|
in a chroot configuration therefore requires that
|
2008-07-23 09:33:08 +00:00
|
|
|
.Xr syslogd 8
|
|
|
|
establish a logging socket inside the chroot directory.
|
2000-09-10 08:31:17 +00:00
|
|
|
.Sh SEE ALSO
|
2001-05-04 03:57:05 +00:00
|
|
|
.Xr sftp 1 ,
|
2000-09-10 08:31:17 +00:00
|
|
|
.Xr ssh 1 ,
|
2004-02-26 10:38:49 +00:00
|
|
|
.Xr sshd_config 5 ,
|
2000-12-05 02:20:19 +00:00
|
|
|
.Xr sshd 8
|
2001-05-04 03:57:05 +00:00
|
|
|
.Rs
|
|
|
|
.%A T. Ylonen
|
|
|
|
.%A S. Lehtinen
|
|
|
|
.%T "SSH File Transfer Protocol"
|
|
|
|
.%N draft-ietf-secsh-filexfer-00.txt
|
|
|
|
.%D January 2001
|
|
|
|
.%O work in progress material
|
|
|
|
.Re
|
2000-12-05 02:20:19 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
.Nm
|
2006-09-30 13:29:51 +00:00
|
|
|
first appeared in
|
|
|
|
.Ox 2.8 .
|
|
|
|
.Sh AUTHORS
|
|
|
|
.An Markus Friedl Aq markus@openbsd.org
|