[openssh.git] / sftp.1

.\" $OpenBSD: sftp.1,v 1.6 2001/02/10 00:45:52 djm Exp $
.\"
.\" Copyright (c) 2001 Damien Miller. All rights reserved.
.\"
.\" 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.
.\"
.Dd Febuary 4, 2001
.Dt SFTP 1
.Os
.Sh NAME
.Nm sftp
.Nd Secure file tranfer program
.Sh SYNOPSIS
.Nm sftp
.Op Fl vC
.Op Fl o Ar ssh_option
.Op Ar hostname | user@hostname
.Sh DESCRIPTION
.Nm
is an interactive file transfer program, similar to
.Xr ftp 1 ,
which performs all operations over an encrypted
.Xr ssh 1
transport.
It may also use many features of ssh, such as public key authentication and
compression.
.Nm
connects and logs into the specified
.Ar hostname ,
then enters an interactive command mode.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl v
Raise logging level. This option is also passed to ssh.
.It Fl C
Enables compression (via ssh's 
.Fl C
flag)
.It Fl o Ar ssh_option
Specify an option to be directly passed to
.Xr ssh 1 .
.El
.Sh INTERACTIVE COMMANDS
Once in interactive mode,
.Nm
understands a set of commands similar to those of 
.Xr ftp 1 .
Commands are case insensitive and pathnames may be enclosed in quotes if they
contain spaces.
.Bl -tag -width Ds
.It Ic cd Ar path
Change remote directory to 
.Ar path .
.It Ic lcd Ar path
Change local directory to 
.Ar path .
.It Ic chgrp Ar grp Ar path
Change group of file 
.Ar path
to
.Ar grp .
.Ar grp
must be a numeric GID.
.It Ic chmod Ar mode Ar path
Change permissions of file 
.Ar path
to
.Ar mode .
.It Ic chown Ar own Ar path
Change owner of file 
.Ar path
to
.Ar own .
.Ar own
must be a numeric UID.
.It Ic help
Display help text.
.It Ic get Ar remote-path Op Ar local-path
Retrieve the
.Ar remote-path
and store it on the local machine.
If the local
path name is not specified, it is given the same name it has on the 
remote machine.
.It Ic lls Op Ar ls-options Op Ar path
Display local directory listing of either 
.Ar path
or current directory if
.Ar path
is not specified.
.It Ic lmkdir Ar path
Create local directory specified by
.Ar path .
.It Ic lpwd
Print local working directory.
.It Ic ls Op Ar path
Display remote directory listing of either
.Ar path
or current directory if
.Ar path
is not specified.
.It Ic lumask Ar umask
Set local umask to 
.Ar umask .
.It Ic mkdir Ar path
Create remote directory specified by
.Ar path .
.It Ic put Ar local-path Op Ar remote-path
Upload
.Ar local-path
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.
.It Ic pwd
Display remote working directory.
.It Ic exit
Quit sftp.
.It Ic quit
Quit sftp.
.It Ic rename Ar oldpath Ar newpath
Rename remote file from
.Ar oldpath
to
.Ar newpath .
.It Ic rmdir Ar path
Remove remote directory specified by
.Ar path .
.It Ic rm Ar path
Delete remote file specified by
.Ar path .
.It Ic ! Ar command
Execute 
.Ar command
in local shell.
.It Ic !
Escape to local shell.
.It Ic ?
Synonym for help.
.El
.Sh AUTHORS
Damien Miller <djm@mindrot.org>
.Sh SEE ALSO
.Xr ssh 1 ,
.Xr ssh-add 1 ,
.Xr ssh-keygen 1 ,
.Xr sshd 8 ,
.Xr scp 1
Commit	Line	Data
a0e6fead	1	.\" $OpenBSD: sftp.1,v 1.6 2001/02/10 00:45:52 djm Exp $
61e96248	2	.\"
	3	.\" Copyright (c) 2001 Damien Miller. All rights reserved.
	4	.\"
	5	.\" Redistribution and use in source and binary forms, with or without
	6	.\" modification, are permitted provided that the following conditions
	7	.\" are met:
	8	.\" 1. Redistributions of source code must retain the above copyright
	9	.\" notice, this list of conditions and the following disclaimer.
	10	.\" 2. Redistributions in binary form must reproduce the above copyright
	11	.\" notice, this list of conditions and the following disclaimer in the
	12	.\" documentation and/or other materials provided with the distribution.
	13	.\"
	14	.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
	15	.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
	16	.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
	17	.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
	18	.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
	19	.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	20	.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	21	.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	22	.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
	23	.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	24	.\"
	25	.Dd Febuary 4, 2001
	26	.Dt SFTP 1
	27	.Os
	28	.Sh NAME
	29	.Nm sftp
	30	.Nd Secure file tranfer program
	31	.Sh SYNOPSIS
	32	.Nm sftp
0426a3b4	33	.Op Fl vC
61e96248	34	.Op Fl o Ar ssh_option
	35	.Op Ar hostname \| user@hostname
	36	.Sh DESCRIPTION
	37	.Nm
	38	is an interactive file transfer program, similar to
	39	.Xr ftp 1 ,
	40	which performs all operations over an encrypted
	41	.Xr ssh 1
	42	transport.
	43	It may also use many features of ssh, such as public key authentication and
	44	compression.
	45	.Nm
	46	connects and logs into the specified
0426a3b4	47	.Ar hostname ,
61e96248	48	then enters an interactive command mode.
	49	.Pp
	50	The options are as follows:
	51	.Bl -tag -width Ds
0426a3b4	52	.It Fl v
0426a3b4	53	Raise logging level. This option is also passed to ssh.
61e96248	54	.It Fl C
	55	Enables compression (via ssh's
	56	.Fl C
	57	flag)
61e96248	58	.It Fl o Ar ssh_option
	59	Specify an option to be directly passed to
	60	.Xr ssh 1 .
	61	.El
	62	.Sh INTERACTIVE COMMANDS
0426a3b4	63	Once in interactive mode,
0426a3b4	64	.Nm
61e96248	65	understands a set of commands similar to those of
61e96248	66	.Xr ftp 1 .
a0e6fead	67	Commands are case insensitive and pathnames may be enclosed in quotes if they
a0e6fead	68	contain spaces.
61e96248	69	.Bl -tag -width Ds
0426a3b4	70	.It Ic cd Ar path
61e96248	71	Change remote directory to
0426a3b4	72	.Ar path .
0426a3b4	73	.It Ic lcd Ar path
61e96248	74	Change local directory to
0426a3b4	75	.Ar path .
0426a3b4	76	.It Ic chgrp Ar grp Ar path
61e96248	77	Change group of file
0426a3b4	78	.Ar path
0426a3b4	79	to
61e96248	80	.Ar grp .
61e96248	81	.Ar grp
0426a3b4	82	must be a numeric GID.
0426a3b4	83	.It Ic chmod Ar mode Ar path
61e96248	84	Change permissions of file
0426a3b4	85	.Ar path
	86	to
	87	.Ar mode .
	88	.It Ic chown Ar own Ar path
61e96248	89	Change owner of file
0426a3b4	90	.Ar path
0426a3b4	91	to
61e96248	92	.Ar own .
	93	.Ar own
	94	must be a numeric UID.
0426a3b4	95	.It Ic help
	96	Display help text.
	97	.It Ic get Ar remote-path Op Ar local-path
61e96248	98	Retrieve the
0426a3b4	99	.Ar remote-path
61e96248	100	and store it on the local machine.
61e96248	101	If the local
0426a3b4	102	path name is not specified, it is given the same name it has on the
61e96248	103	remote machine.
0426a3b4	104	.It Ic lls Op Ar ls-options Op Ar path
61e96248	105	Display local directory listing of either
	106	.Ar path
	107	or current directory if
	108	.Ar path
0426a3b4	109	is not specified.
0426a3b4	110	.It Ic lmkdir Ar path
61e96248	111	Create local directory specified by
0426a3b4	112	.Ar path .
	113	.It Ic lpwd
	114	Print local working directory.
	115	.It Ic ls Op Ar path
61e96248	116	Display remote directory listing of either
61e96248	117	.Ar path
0426a3b4	118	or current directory if
	119	.Ar path
	120	is not specified.
	121	.It Ic lumask Ar umask
61e96248	122	Set local umask to
0426a3b4	123	.Ar umask .
0426a3b4	124	.It Ic mkdir Ar path
61e96248	125	Create remote directory specified by
0426a3b4	126	.Ar path .
0426a3b4	127	.It Ic put Ar local-path Op Ar remote-path
61e96248	128	Upload
0426a3b4	129	.Ar local-path
0426a3b4	130	and store it on the remote machine. If the remote path name is not specified,
61e96248	131	it is given the same name it has on the local machine.
0426a3b4	132	.It Ic pwd
	133	Display remote working directory.
	134	.It Ic exit
	135	Quit sftp.
	136	.It Ic quit
	137	Quit sftp.
	138	.It Ic rename Ar oldpath Ar newpath
61e96248	139	Rename remote file from
	140	.Ar oldpath
	141	to
0426a3b4	142	.Ar newpath .
0426a3b4	143	.It Ic rmdir Ar path
61e96248	144	Remove remote directory specified by
0426a3b4	145	.Ar path .
0426a3b4	146	.It Ic rm Ar path
61e96248	147	Delete remote file specified by
0426a3b4	148	.Ar path .
61e96248	149	.It Ic ! Ar command
	150	Execute
	151	.Ar command
0426a3b4	152	in local shell.
61e96248	153	.It Ic !
0426a3b4	154	Escape to local shell.
	155	.It Ic ?
	156	Synonym for help.
	157	.El
61e96248	158	.Sh AUTHORS
	159	Damien Miller <djm@mindrot.org>
	160	.Sh SEE ALSO
	161	.Xr ssh 1 ,
	162	.Xr ssh-add 1 ,
	163	.Xr ssh-keygen 1 ,
0426a3b4	164	.Xr sshd 8 ,
	165	.Xr scp 1
	166