src/usr.bin/ssh/sftp.1 - diff

Return to sftp.1 CVS log

Up to [local] / src / usr.bin / ssh

Diff for /src/usr.bin/ssh/sftp.1 between version 1.45 and 1.45.2.2

version 1.45, 2003/09/02 18:50:06

version 1.45.2.2, 2004/08/19 22:37:32

Line 31

.Sh SYNOPSIS

.Nm sftp

.Bk -words

.Op Fl vC1

.Op Fl 1Cv

.Op Fl b Ar batchfile

.Op Fl o Ar ssh_option

.Op Fl s Ar subsystem | sftp_server

.Op Fl B Ar buffer_size

.Op Fl b Ar batchfile

.Op Fl F Ar ssh_config

.Op Fl P Ar sftp_server path

.Op Fl o Ar ssh_option

.Op Fl P Ar sftp_server_path

.Op Fl R Ar num_requests

.Op Fl S Ar program

.Op Fl s Ar subsystem | sftp_server

.Ar host

.Ek

.Nm sftp

Line 84

for details).

The options are as follows:

.Bl -tag -width Ds

.It Fl 1

Specify the use of protocol version 1.

.It Fl B Ar buffer_size

Specify the size of the buffer that

.Nm

uses when transferring files.

Larger buffers require fewer round trips at the cost of higher

memory consumption.

The default is 32768 bytes.

.It Fl b Ar batchfile

Batch mode reads a series of commands from an input

.Ar batchfile

Line 91

Line 100

.Em stdin .

Since it lacks user interaction it should be used in conjunction with

non-interactive authentication.

.Ar batchfile

.Sq \-

may be used to indicate standard input.

.Nm

will abort if any of the following

commands fail:

Line 101

Line 115

.Ic lmkdir .

Termination on error can be suppressed on a command by command basis by

prefixing the command with a

.Sq Ic \-

.Sq \-

character (for example,

.Ic -rm /tmp/blah* ) .

.It Fl C

Enables compression (via ssh's

.Fl C

flag).

.It Fl F Ar ssh_config

Specifies an alternative

per-user configuration file for

.Xr ssh 1 .

This option is directly passed to

.Xr ssh 1 .

.It Fl o Ar ssh_option

Can be used to pass options to

.Nm ssh

Line 115

Line 139

command-line flag.

For example, to specify an alternate port use:

.Ic sftp -oPort=24 .

.It Fl s Ar subsystem | sftp_server

For full details of the options listed below, and their possible values, see

Specifies the SSH2 subsystem or the path for an sftp server

.Xr ssh_config 5 .

on the remote host.

.Pp

A path is useful for using

.Bl -tag -width Ds -offset indent -compact

.Nm

.It AddressFamily

over protocol version 1, or when the remote

.It BatchMode

.Xr sshd 8

.It BindAddress

does not have an sftp subsystem configured.

.It ChallengeResponseAuthentication

.It Fl v

.It CheckHostIP

Raise logging level.

.It Cipher

This option is also passed to ssh.

.It Ciphers

.It Fl B Ar buffer_size

.It Compression

Specify the size of the buffer that

.It CompressionLevel

.Nm

.It ConnectionAttempts

uses when transferring files.

.It ConnectTimeout

Larger buffers require fewer round trips at the cost of higher

.It ControlMaster

memory consumption.

.It ControlPath

The default is 32768 bytes.

.It GlobalKnownHostsFile

.It Fl C

.It GSSAPIAuthentication

Enables compression (via ssh's

.It GSSAPIDelegateCredentials

.Fl C

.It Host

flag).

.It HostbasedAuthentication

.It Fl F Ar ssh_config

.It HostKeyAlgorithms

Specifies an alternative

.It HostKeyAlias

per-user configuration file for

.It HostName

.Xr ssh 1 .

.It IdentityFile

This option is directly passed to

.It IdentitiesOnly

.Xr ssh 1 .

.It LogLevel

.It Fl P Ar sftp_server path

.It MACs

.It NoHostAuthenticationForLocalhost

.It NumberOfPasswordPrompts

.It PasswordAuthentication

.It Port

.It PreferredAuthentications

.It Protocol

.It ProxyCommand

.It PubkeyAuthentication

.It RhostsRSAAuthentication

.It RSAAuthentication

.It SendEnv

.It ServerAliveInterval

.It ServerAliveCountMax

.It SmartcardDevice

.It StrictHostKeyChecking

.It TCPKeepAlive

.It UsePrivilegedPort

.It User

.It UserKnownHostsFile

.It VerifyHostKeyDNS

.El

.It Fl P Ar sftp_server_path

Connect directly to a local sftp server

(rather than via

.Xr ssh 1 )

Line 160

Line 206

The program must understand

.Xr ssh 1

options.

.It Fl 1

.It Fl s Ar subsystem | sftp_server

Specify the use of protocol version 1.

Specifies the SSH2 subsystem or the path for an sftp server

on the remote host.

A path is useful for using

.Nm

over protocol version 1, or when the remote

.Xr sshd 8

does not have an sftp subsystem configured.

.It Fl v

Raise logging level.

This option is also passed to ssh.

.El

.Sh INTERACTIVE COMMANDS

Once in interactive mode,

Line 170

Line 225

.Xr ftp 1 .

Commands are case insensitive and pathnames may be enclosed in quotes if they

contain spaces.

.Bl -tag -width Ds

.Bl -tag -width "lmdir path"

.It Ic bye

Quit

.Nm sftp .

.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

Line 219

Line 271

copied too.

.It Ic help

Display help text.

.It Ic lcd Ar path

Change local directory to

.Ar path .

.It Ic lls Op Ar ls-options Op Ar path

Display local directory listing of either

.Ar path

Line 248

Line 303

.Fl l

flag is specified, then display additional details including permissions

and ownership information.

The

.Fl n

flag will produce a long listing with user and group information presented

numerically.

.Pp

By default,

.Ic ls

listings are sorted in lexicographical order.

This may be changed by specifying the

.Fl S

(sort by file size),

.Fl t

(sort by last modification time), or

.Fl f

(don't sort at all) flags.

Additionally, the sort order may be reversed using the

.Fl r

flag.

.It Ic lumask Ar umask

Set local umask to

.Ar umask .

Line 280

Line 353

.Ar oldpath

.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 rmdir Ar path

Remove remote directory specified by

.Ar path .

.It Ic symlink Ar oldpath Ar newpath

Create a symbolic link from

.Ar oldpath

Line 305

Line 378

Synonym for help.

.El

.Sh SEE ALSO

.Xr ftp 1 ,

.Xr scp 1 ,

.Xr ssh 1 ,

.Xr ssh-add 1 ,