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.52.2.1 and 1.52.2.2

version 1.52.2.1, 2004/08/19 04:13:27

version 1.52.2.2, 2005/03/10 17:15:04

Line 71

authentication method is used; otherwise it will do so after

successful interactive authentication.

.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

The final usage format allows for automated sessions using the

.Fl b

Line 159

Line 161

.It GlobalKnownHostsFile

.It GSSAPIAuthentication

.It GSSAPIDelegateCredentials

.It HashKnownHosts

.It Host

.It HostbasedAuthentication

.It HostKeyAlgorithms

Line 166

Line 169

.It HostName

.It IdentityFile

.It IdentitiesOnly

.It KbdInteractiveDevices

.It LogLevel

.It MACs

.It NoHostAuthenticationForLocalhost

Line 192

Line 196

.It Fl P Ar sftp_server_path

Connect directly to a local sftp server

(rather than via

.Xr ssh 1 )

.Xr ssh 1 ) .

This option may be useful in debugging the client and server.

.It Fl R Ar num_requests

Specify how many requests may be outstanding at any one time.

Line 223

Line 227

.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

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

Quit

.Nm sftp .

Line 237

Line 245

.Ar path

.Ar grp .

.Ar path

may contain

.Xr glob 3

characters and may match multiple files.

.Ar grp

must be a numeric GID.

.It Ic chmod Ar mode Ar path

Line 244

Line 256

.Ar path

.Ar mode .

.Ar path

may contain

.Xr glob 3

characters and may match multiple files.

.It Ic chown Ar own Ar path

Change owner of file

.Ar path

.Ar own .

.Ar path

may contain

.Xr glob 3

characters and may match multiple files.

.Ar own

must be a numeric UID.

.It Ic exit

Quit

.Nm sftp .

.It Xo Ic get

.Op Ar flags

.Op Fl P

.Ar remote-path

.Op Ar local-path

.Xc

Line 265

Line 285

If the local

path name is not specified, it is given the same name it has on the

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

.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.

.It Ic help

Display help text.

Line 280

Line 309

or current directory if

.Ar path

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

Create local directory specified by

.Ar path .

Line 291

Line 328

.It Ic lpwd

Print local working directory.

.It Xo Ic ls

.Op Ar flags

.Op Fl 1aflnrSt

.Op Ar path

.Xc

Display remote directory listing of either

Display a remote directory listing of either

.Ar path

or current directory if

or the current directory if

.Ar path

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

By default,

The following flags are recognized and alter the behaviour of

.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

Set local umask to

.Ar umask .

Line 330

Line 375

.It Ic progress

Toggle display of progress meter.

.It Xo Ic put

.Op Ar flags

.Op Fl P

.Ar local-path

.Op Ar remote-path

.Xc

Line 339

Line 384

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.

.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

.Fl P

flag is specified, then the file's full permission and access time are

Line 379

Line 433

.El

.Sh SEE ALSO

.Xr ftp 1 ,

.Xr ls 1 ,

.Xr scp 1 ,

.Xr ssh 1 ,

.Xr ssh-add 1 ,

.Xr ssh-keygen 1 ,

.Xr glob 3 ,

.Xr ssh_config 5 ,

.Xr sftp-server 8 ,

.Xr sshd 8