.\" This file is part of the Green End SFTP Server.
.\" Copyright (C) 2007, 2011 Richard Kettlewell
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
.\" USA
.TH gesftpserver 8
.SH NAME
gesftpserver - Green End SFTP Server
.SH SYNOPSIS
.B /usr/lib/gesftpserver
.RI [OPTIONS]
.SH DESCRIPTION
.B gesftpserver
implements the SFTP protocol.  It is normally run as an SSH subsystem
but can be run in other contexts if necessary.
.SH "CONFIGURING OPENSSH"
By default, OpenSSH will use its native SFTP server in response to
requests for the SFTP subsystem.  To use gesftpserver instead, add a
suitable
.B Subsystem
command to
.I sshd_config
(and remove the existing one if present).  For example:
.PP
.nf
Subsystem  sftp /usr/lib/gesftpserver
.fi
.SH "IMPLEMENTATION DETAILS"
.B gesftpserver
supports up to version 6 of the SFTP protocol and the following
extensions:
.TP
.B newline
Reports the server's newline convention to the client.
.TP
.B space-available
Equivalent to
.BR df (1).
.TP
.B supported
v5 capability details
.TP
.B supported2
v6 capability details
.TP
.B text-seek
Used for resuming text file downloads.
.TP
.B vendor-id
Reports server name and version to client.
.B gesftpserver
reports a vendor of "Green End" and a server name of "Green End SFTP Server".
.TP
.B versions
Lists available versions.
.TP
.B version-select
Select version.
.TP
.B posix-rename@openssh.org
Provides POSIX rename semantics even in pre-v5 SFTP.
.SH "SEE ALSO"
.BR sshd_config (5)