summaryrefslogtreecommitdiff
path: root/scp.0
diff options
context:
space:
mode:
Diffstat (limited to 'scp.0')
-rw-r--r--scp.0183
1 files changed, 183 insertions, 0 deletions
diff --git a/scp.0 b/scp.0
new file mode 100644
index 000000000..03e6c65e7
--- /dev/null
+++ b/scp.0
@@ -0,0 +1,183 @@
1SCP(1) General Commands Manual SCP(1)
2
3NAME
4 scp M-bM-^@M-^S OpenSSH secure file copy
5
6SYNOPSIS
7 scp [-346BCpqrTv] [-c cipher] [-F ssh_config] [-i identity_file]
8 [-J destination] [-l limit] [-o ssh_option] [-P port] [-S program]
9 source ... target
10
11DESCRIPTION
12 scp copies files between hosts on a network. It uses ssh(1) for data
13 transfer, and uses the same authentication and provides the same security
14 as ssh(1). scp will ask for passwords or passphrases if they are needed
15 for authentication.
16
17 The source and target may be specified as a local pathname, a remote host
18 with optional path in the form [user@]host:[path], or a URI in the form
19 scp://[user@]host[:port][/path]. Local file names can be made explicit
20 using absolute or relative pathnames to avoid scp treating file names
21 containing M-bM-^@M-^X:M-bM-^@M-^Y as host specifiers.
22
23 When copying between two remote hosts, if the URI format is used, a port
24 may only be specified on the target if the -3 option is used.
25
26 The options are as follows:
27
28 -3 Copies between two remote hosts are transferred through the local
29 host. Without this option the data is copied directly between
30 the two remote hosts. Note that this option disables the
31 progress meter and selects batch mode for the second host, since
32 scp cannot ask for passwords or passphrases for both hosts.
33
34 -4 Forces scp to use IPv4 addresses only.
35
36 -6 Forces scp to use IPv6 addresses only.
37
38 -B Selects batch mode (prevents asking for passwords or
39 passphrases).
40
41 -C Compression enable. Passes the -C flag to ssh(1) to enable
42 compression.
43
44 -c cipher
45 Selects the cipher to use for encrypting the data transfer. This
46 option is directly passed to ssh(1).
47
48 -F ssh_config
49 Specifies an alternative per-user configuration file for ssh.
50 This option is directly passed to ssh(1).
51
52 -i identity_file
53 Selects the file from which the identity (private key) for public
54 key authentication is read. This option is directly passed to
55 ssh(1).
56
57 -J destination
58 Connect to the target host by first making an scp connection to
59 the jump host described by destination and then establishing a
60 TCP forwarding to the ultimate destination from there. Multiple
61 jump hops may be specified separated by comma characters. This
62 is a shortcut to specify a ProxyJump configuration directive.
63 This option is directly passed to ssh(1).
64
65 -l limit
66 Limits the used bandwidth, specified in Kbit/s.
67
68 -o ssh_option
69 Can be used to pass options to ssh in the format used in
70 ssh_config(5). This is useful for specifying options for which
71 there is no separate scp command-line flag. For full details of
72 the options listed below, and their possible values, see
73 ssh_config(5).
74
75 AddressFamily
76 BatchMode
77 BindAddress
78 BindInterface
79 CanonicalDomains
80 CanonicalizeFallbackLocal
81 CanonicalizeHostname
82 CanonicalizeMaxDots
83 CanonicalizePermittedCNAMEs
84 CASignatureAlgorithms
85 CertificateFile
86 ChallengeResponseAuthentication
87 CheckHostIP
88 Ciphers
89 Compression
90 ConnectionAttempts
91 ConnectTimeout
92 ControlMaster
93 ControlPath
94 ControlPersist
95 GlobalKnownHostsFile
96 GSSAPIAuthentication
97 GSSAPIDelegateCredentials
98 HashKnownHosts
99 Host
100 HostbasedAuthentication
101 HostbasedKeyTypes
102 HostKeyAlgorithms
103 HostKeyAlias
104 Hostname
105 IdentitiesOnly
106 IdentityAgent
107 IdentityFile
108 IPQoS
109 KbdInteractiveAuthentication
110 KbdInteractiveDevices
111 KexAlgorithms
112 LogLevel
113 MACs
114 NoHostAuthenticationForLocalhost
115 NumberOfPasswordPrompts
116 PasswordAuthentication
117 PKCS11Provider
118 Port
119 PreferredAuthentications
120 ProxyCommand
121 ProxyJump
122 PubkeyAcceptedKeyTypes
123 PubkeyAuthentication
124 RekeyLimit
125 SendEnv
126 ServerAliveInterval
127 ServerAliveCountMax
128 SetEnv
129 StrictHostKeyChecking
130 TCPKeepAlive
131 UpdateHostKeys
132 User
133 UserKnownHostsFile
134 VerifyHostKeyDNS
135
136 -P port
137 Specifies the port to connect to on the remote host. Note that
138 this option is written with a capital M-bM-^@M-^XPM-bM-^@M-^Y, because -p is already
139 reserved for preserving the times and modes of the file.
140
141 -p Preserves modification times, access times, and modes from the
142 original file.
143
144 -q Quiet mode: disables the progress meter as well as warning and
145 diagnostic messages from ssh(1).
146
147 -r Recursively copy entire directories. Note that scp follows
148 symbolic links encountered in the tree traversal.
149
150 -S program
151 Name of program to use for the encrypted connection. The program
152 must understand ssh(1) options.
153
154 -T Disable strict filename checking. By default when copying files
155 from a remote host to a local directory scp checks that the
156 received filenames match those requested on the command-line to
157 prevent the remote end from sending unexpected or unwanted files.
158 Because of differences in how various operating systems and
159 shells interpret filename wildcards, these checks may cause
160 wanted files to be rejected. This option disables these checks
161 at the expense of fully trusting that the server will not send
162 unexpected filenames.
163
164 -v Verbose mode. Causes scp and ssh(1) to print debugging messages
165 about their progress. This is helpful in debugging connection,
166 authentication, and configuration problems.
167
168EXIT STATUS
169 The scp utility exitsM-BM- 0 on success, andM-BM- >0 if an error occurs.
170
171SEE ALSO
172 sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), ssh_config(5),
173 sshd(8)
174
175HISTORY
176 scp is based on the rcp program in BSD source code from the Regents of
177 the University of California.
178
179AUTHORS
180 Timo Rinne <tri@iki.fi>
181 Tatu Ylonen <ylo@cs.hut.fi>
182
183OpenBSD 6.7 April 30, 2020 OpenBSD 6.7
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-02 12:20:16 +0000