version 1.57, 2004/06/21 22:41:31 |
version 1.57.2.1, 2005/03/10 16:28:28 |
|
|
authentication method is used; otherwise it will do so after |
authentication method is used; otherwise it will do so after |
successful interactive authentication. |
successful interactive authentication. |
.Pp |
.Pp |
The third usage format allows the sftp client to start in a remote directory. |
The third usage format allows |
|
.Nm |
|
to start in a remote directory. |
.Pp |
.Pp |
The final usage format allows for automated sessions using the |
The final usage format allows for automated sessions using the |
.Fl b |
.Fl b |
|
|
.It GlobalKnownHostsFile |
.It GlobalKnownHostsFile |
.It GSSAPIAuthentication |
.It GSSAPIAuthentication |
.It GSSAPIDelegateCredentials |
.It GSSAPIDelegateCredentials |
|
.It HashKnownHosts |
.It Host |
.It Host |
.It HostbasedAuthentication |
.It HostbasedAuthentication |
.It HostKeyAlgorithms |
.It HostKeyAlgorithms |
|
|
.It HostName |
.It HostName |
.It IdentityFile |
.It IdentityFile |
.It IdentitiesOnly |
.It IdentitiesOnly |
|
.It KbdInteractiveDevices |
.It LogLevel |
.It LogLevel |
.It MACs |
.It MACs |
.It NoHostAuthenticationForLocalhost |
.It NoHostAuthenticationForLocalhost |
|
|
.It Fl P Ar sftp_server_path |
.It Fl P Ar sftp_server_path |
Connect directly to a local sftp server |
Connect directly to a local sftp server |
(rather than via |
(rather than via |
.Xr ssh 1 ) |
.Xr ssh 1 ) . |
This option may be useful in debugging the client and server. |
This option may be useful in debugging the client and server. |
.It Fl R Ar num_requests |
.It Fl R Ar num_requests |
Specify how many requests may be outstanding at any one time. |
Specify how many requests may be outstanding at any one time. |
|
|
.Nm |
.Nm |
understands a set of commands similar to those of |
understands a set of commands similar to those of |
.Xr ftp 1 . |
.Xr ftp 1 . |
Commands are case insensitive and pathnames may be enclosed in quotes if they |
Commands are case insensitive. |
contain spaces. |
Pathnames that contain spaces must be enclosed in quotes. |
.Bl -tag -width "lmdir path" |
Any special characters contained within pathnames that are recognized by |
|
.Xr glob 3 |
|
must be escaped with backslashes |
|
.Pq Sq \e . |
|
.Bl -tag -width Ds |
.It Ic bye |
.It Ic bye |
Quit |
Quit |
.Nm sftp . |
.Nm sftp . |
|
|
.Ar path |
.Ar path |
to |
to |
.Ar grp . |
.Ar grp . |
|
.Ar path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
.Ar grp |
.Ar grp |
must be a numeric GID. |
must be a numeric GID. |
.It Ic chmod Ar mode Ar path |
.It Ic chmod Ar mode Ar path |
|
|
.Ar path |
.Ar path |
to |
to |
.Ar mode . |
.Ar mode . |
|
.Ar path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
.It Ic chown Ar own Ar path |
.It Ic chown Ar own Ar path |
Change owner of file |
Change owner of file |
.Ar path |
.Ar path |
to |
to |
.Ar own . |
.Ar own . |
|
.Ar path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
.Ar own |
.Ar own |
must be a numeric UID. |
must be a numeric UID. |
.It Ic exit |
.It Ic exit |
Quit |
Quit |
.Nm sftp . |
.Nm sftp . |
.It Xo Ic get |
.It Xo Ic get |
.Op Ar flags |
.Op Fl P |
.Ar remote-path |
.Ar remote-path |
.Op Ar local-path |
.Op Ar local-path |
.Xc |
.Xc |
|
|
If the local |
If the local |
path name is not specified, it is given the same name it has on the |
path name is not specified, it is given the same name it has on the |
remote machine. |
remote machine. |
|
.Ar remote-path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
|
If it does and |
|
.Ar local-path |
|
is specified, then |
|
.Ar local-path |
|
must specify a directory. |
If the |
If the |
.Fl P |
.Fl P |
flag is specified, then the file's full permission and access time are |
flag is specified, then full file permissions and access times are |
copied too. |
copied too. |
.It Ic help |
.It Ic help |
Display help text. |
Display help text. |
|
|
or current directory if |
or current directory if |
.Ar path |
.Ar path |
is not specified. |
is not specified. |
|
.Ar ls-options |
|
may contain any flags supported by the local system's |
|
.Xr ls 1 |
|
command. |
|
.Ar path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
.It Ic lmkdir Ar path |
.It Ic lmkdir Ar path |
Create local directory specified by |
Create local directory specified by |
.Ar path . |
.Ar path . |
|
|
.It Ic lpwd |
.It Ic lpwd |
Print local working directory. |
Print local working directory. |
.It Xo Ic ls |
.It Xo Ic ls |
.Op Ar flags |
.Op Fl 1aflnrSt |
.Op Ar path |
.Op Ar path |
.Xc |
.Xc |
Display remote directory listing of either |
Display a remote directory listing of either |
.Ar path |
.Ar path |
or current directory if |
or the current directory if |
.Ar path |
.Ar path |
is not specified. |
is not specified. |
If the |
.Ar path |
.Fl l |
may contain |
flag is specified, then display additional details including permissions |
.Xr glob 3 |
and ownership information. |
characters and may match multiple files. |
The |
|
.Fl n |
|
flag will produce a long listing with user and group information presented |
|
numerically. |
|
.Pp |
.Pp |
By default, |
The following flags are recognized and alter the behaviour of |
.Ic ls |
.Ic ls |
listings are sorted in lexicographical order. |
accordingly: |
This may be changed by specifying the |
.Bl -tag -width Ds |
.Fl S |
.It Fl 1 |
(sort by file size), |
Produce single columnar output. |
.Fl t |
.It Fl a |
(sort by last modification time), or |
List files beginning with a dot |
.Fl f |
.Pq Sq \&. . |
(don't sort at all) flags. |
.It Fl f |
Additionally, the sort order may be reversed using the |
Do not sort the listing. |
.Fl r |
The default sort order is lexicographical. |
flag. |
.It Fl l |
|
Display additional details including permissions |
|
and ownership information. |
|
.It Fl n |
|
Produce a long listing with user and group information presented |
|
numerically. |
|
.It Fl r |
|
Reverse the sort order of the listing. |
|
.It Fl S |
|
Sort the listing by file size. |
|
.It Fl t |
|
Sort the listing by last modification time. |
|
.El |
.It Ic lumask Ar umask |
.It Ic lumask Ar umask |
Set local umask to |
Set local umask to |
.Ar umask . |
.Ar umask . |
|
|
.It Ic progress |
.It Ic progress |
Toggle display of progress meter. |
Toggle display of progress meter. |
.It Xo Ic put |
.It Xo Ic put |
.Op Ar flags |
.Op Fl P |
.Ar local-path |
.Ar local-path |
.Op Ar remote-path |
.Op Ar remote-path |
.Xc |
.Xc |
|
|
and store it on the remote machine. |
and store it on the remote machine. |
If the remote path name is not specified, it is given the same name it has |
If the remote path name is not specified, it is given the same name it has |
on the local machine. |
on the local machine. |
|
.Ar local-path |
|
may contain |
|
.Xr glob 3 |
|
characters and may match multiple files. |
|
If it does and |
|
.Ar remote-path |
|
is specified, then |
|
.Ar remote-path |
|
must specify a directory. |
If the |
If the |
.Fl P |
.Fl P |
flag is specified, then the file's full permission and access time are |
flag is specified, then the file's full permission and access time are |
|
|
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr ftp 1 , |
.Xr ftp 1 , |
|
.Xr ls 1 , |
.Xr scp 1 , |
.Xr scp 1 , |
.Xr ssh 1 , |
.Xr ssh 1 , |
.Xr ssh-add 1 , |
.Xr ssh-add 1 , |
.Xr ssh-keygen 1 , |
.Xr ssh-keygen 1 , |
|
.Xr glob 3 , |
.Xr ssh_config 5 , |
.Xr ssh_config 5 , |
.Xr sftp-server 8 , |
.Xr sftp-server 8 , |
.Xr sshd 8 |
.Xr sshd 8 |