summaryrefslogtreecommitdiff
path: root/sftp.0
diff options
context:
space:
mode:
Diffstat (limited to 'sftp.0')
-rw-r--r--sftp.051
1 files changed, 34 insertions, 17 deletions
diff --git a/sftp.0 b/sftp.0
index ed98400d3..2342c2320 100644
--- a/sftp.0
+++ b/sftp.0
@@ -5,9 +5,10 @@ NAME
5 5
6SYNOPSIS 6SYNOPSIS
7 sftp [-46aCfpqrv] [-B buffer_size] [-b batchfile] [-c cipher] 7 sftp [-46aCfpqrv] [-B buffer_size] [-b batchfile] [-c cipher]
8 [-D sftp_server_path] [-F ssh_config] [-i identity_file] [-l limit] 8 [-D sftp_server_path] [-F ssh_config] [-i identity_file]
9 [-o ssh_option] [-P port] [-R num_requests] [-S program] 9 [-J destination] [-l limit] [-o ssh_option] [-P port]
10 [-s subsystem | sftp_server] destination 10 [-R num_requests] [-S program] [-s subsystem | sftp_server]
11 destination
11 12
12DESCRIPTION 13DESCRIPTION
13 sftp is a file transfer program, similar to ftp(1), which performs all 14 sftp is a file transfer program, similar to ftp(1), which performs all
@@ -52,13 +53,18 @@ DESCRIPTION
52 instead of stdin. Since it lacks user interaction it should be 53 instead of stdin. Since it lacks user interaction it should be
53 used in conjunction with non-interactive authentication to 54 used in conjunction with non-interactive authentication to
54 obviate the need to enter a password at connection time (see 55 obviate the need to enter a password at connection time (see
55 sshd(8) and ssh-keygen(1) for details). A batchfile of M-bM-^@M-^X-M-bM-^@M-^Y may 56 sshd(8) and ssh-keygen(1) for details).
56 be used to indicate standard input. sftp will abort if any of 57
57 the following commands fail: get, put, reget, reput, rename, ln, 58 A batchfile of M-bM-^@M-^X-M-bM-^@M-^Y may be used to indicate standard input. sftp
58 rm, mkdir, chdir, ls, lchdir, chmod, chown, chgrp, lpwd, df, 59 will abort if any of the following commands fail: get, put,
59 symlink, and lmkdir. Termination on error can be suppressed on a 60 reget, reput, rename, ln, rm, mkdir, chdir, ls, lchdir, chmod,
60 command by command basis by prefixing the command with a M-bM-^@M-^X-M-bM-^@M-^Y 61 chown, chgrp, lpwd, df, symlink, and lmkdir.
61 character (for example, -rm /tmp/blah*). 62
63 Termination on error can be suppressed on a command by command
64 basis by prefixing the command with a M-bM-^@M-^X-M-bM-^@M-^Y character (for example,
65 -rm /tmp/blah*). Echo of the command may be suppressed by
66 prefixing the command with a M-bM-^@M-^X@M-bM-^@M-^Y character. These two prefixes
67 may be combined in any order, for example -@ls /bsd.
62 68
63 -C Enables compression (via ssh's -C flag). 69 -C Enables compression (via ssh's -C flag).
64 70
@@ -83,6 +89,14 @@ DESCRIPTION
83 key authentication is read. This option is directly passed to 89 key authentication is read. This option is directly passed to
84 ssh(1). 90 ssh(1).
85 91
92 -J destination
93 Connect to the target host by first making an sftp connection to
94 the jump host described by destination and then establishing a
95 TCP forwarding to the ultimate destination from there. Multiple
96 jump hops may be specified separated by comma characters. This
97 is a shortcut to specify a ProxyJump configuration directive.
98 This option is directly passed to ssh(1).
99
86 -l limit 100 -l limit
87 Limits the used bandwidth, specified in Kbit/s. 101 Limits the used bandwidth, specified in Kbit/s.
88 102
@@ -197,17 +211,20 @@ INTERACTIVE COMMANDS
197 Change remote directory to path. If path is not specified, then 211 Change remote directory to path. If path is not specified, then
198 change directory to the one the session started in. 212 change directory to the one the session started in.
199 213
200 chgrp grp path 214 chgrp [-h] grp path
201 Change group of file path to grp. path may contain glob(7) 215 Change group of file path to grp. If the -h flag is specified,
216 then symlinks will not be followed. path may contain glob(7)
202 characters and may match multiple files. grp must be a numeric 217 characters and may match multiple files. grp must be a numeric
203 GID. 218 GID.
204 219
205 chmod mode path 220 chmod [-h] mode path
206 Change permissions of file path to mode. path may contain 221 Change permissions of file path to mode. If the -h flag is
222 specified, then symlinks will not be followed. path may contain
207 glob(7) characters and may match multiple files. 223 glob(7) characters and may match multiple files.
208 224
209 chown own path 225 chown [-h] own path
210 Change owner of file path to own. path may contain glob(7) 226 Change owner of file path to own. If the -h flag is specified,
227 then symlinks will not be followed. path may contain glob(7)
211 characters and may match multiple files. own must be a numeric 228 characters and may match multiple files. own must be a numeric
212 UID. 229 UID.
213 230
@@ -376,4 +393,4 @@ SEE ALSO
376 T. Ylonen and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh- 393 T. Ylonen and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh-
377 filexfer-00.txt, January 2001, work in progress material. 394 filexfer-00.txt, January 2001, work in progress material.
378 395
379OpenBSD 6.4 September 20, 2018 OpenBSD 6.4 396OpenBSD 6.5 January 22, 2019 OpenBSD 6.5