version 1.20, 2001/06/23 05:57:08 |
version 1.21, 2001/06/23 17:48:18 |
|
|
.Nm sftp |
.Nm sftp |
.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] |
.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] |
.Nm sftp |
.Nm sftp |
.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] |
.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
is an interactive file transfer program, similar to |
is an interactive file transfer program, similar to |
|
|
.Ar host , |
.Ar host , |
then enters an interactive command mode. |
then enters an interactive command mode. |
.Pp |
.Pp |
The second usage format will retrieve files automatically if a non-interactive |
The second usage format will retrieve files automatically if a non-interactive |
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 |
|
|
Since it lacks user interaction it should be used in conjunction with |
Since it lacks user interaction it should be used in conjunction with |
non-interactive authentication. |
non-interactive authentication. |
.Nm |
.Nm |
will abort if any of the following |
will abort if any of the following |
commands fail: |
commands fail: |
.Ic get , put , rename , ln , rm , mkdir , chdir , lchdir |
.Ic get , put , rename , ln , rm , mkdir , chdir , lchdir |
and |
and |
.Ic lmkdir . |
.Ic lmkdir . |
.It Fl C |
.It Fl C |
Enables compression (via ssh's |
Enables compression (via ssh's |
.Fl C |
.Fl C |
flag) |
flag) |
.It Fl o Ar ssh_option |
.It Fl o Ar ssh_option |
|
|
.Sh INTERACTIVE COMMANDS |
.Sh INTERACTIVE COMMANDS |
Once in interactive mode, |
Once in interactive mode, |
.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 and pathnames may be enclosed in quotes if they |
contain spaces. |
contain spaces. |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ic cd Ar path |
.It Ic cd Ar path |
Change remote directory to |
Change remote directory to |
.Ar path . |
.Ar path . |
.It Ic lcd Ar path |
.It Ic lcd Ar path |
Change local directory to |
Change local directory to |
.Ar path . |
.Ar path . |
.It Ic chgrp Ar grp Ar path |
.It Ic chgrp Ar grp Ar path |
Change group of file |
Change group of file |
.Ar path |
.Ar path |
to |
to |
.Ar grp . |
.Ar grp . |
.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 |
Change permissions of file |
Change permissions of file |
.Ar path |
.Ar path |
to |
to |
.Ar mode . |
.Ar mode . |
.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 remote-path |
.Ar remote-path |
and store it on the local machine. |
and store it on the local machine. |
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. If the |
remote machine. 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 |
copied too. |
copied too. |
.It Ic help |
.It Ic help |
Display help text. |
Display help text. |
.It Ic lls Op Ar ls-options Op Ar path |
.It Ic lls Op Ar ls-options Op Ar path |
Display local directory listing of either |
Display local directory listing of either |
.Ar path |
.Ar path |
or current directory if |
or current directory if |
.Ar path |
.Ar path |
|
|
Create local directory specified by |
Create local directory specified by |
.Ar path . |
.Ar path . |
.It Ic ln Ar oldpath Ar newpath |
.It Ic ln Ar oldpath Ar newpath |
Create a symbolic link from |
Create a symbolic link from |
.Ar oldpath |
.Ar oldpath |
to |
to |
.Ar newpath . |
.Ar newpath . |
|
|
.Ar path |
.Ar path |
is not specified. |
is not specified. |
.It Ic lumask Ar umask |
.It Ic lumask Ar umask |
Set local umask to |
Set local umask to |
.Ar umask . |
.Ar umask . |
.It Ic mkdir Ar path |
.It Ic mkdir Ar path |
Create remote directory specified by |
Create remote directory specified by |
|
|
.Xc |
.Xc |
Upload |
Upload |
.Ar local-path |
.Ar local-path |
and store it on the remote machine. If the remote path name is not |
and store it on the remote machine. If the remote path name is not |
specified, it is given the same name it has on the local machine. If the |
specified, it is given the same name it has on the local machine. 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 |
copied too. |
copied too. |
|
|
Delete remote file specified by |
Delete remote file specified by |
.Ar path . |
.Ar path . |
.It Ic symlink Ar oldpath Ar newpath |
.It Ic symlink Ar oldpath Ar newpath |
Create a symbolic link from |
Create a symbolic link from |
.Ar oldpath |
.Ar oldpath |
to |
to |
.Ar newpath . |
.Ar newpath . |
.It Ic ! Ar command |
.It Ic ! Ar command |
Execute |
Execute |
.Ar command |
.Ar command |
in local shell. |
in local shell. |
.It Ic ! |
.It Ic ! |