Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 1 | .\" |
| 2 | .\" scp.1 |
| 3 | .\" |
| 4 | .\" Author: Tatu Ylonen <ylo@cs.hut.fi> |
| 5 | .\" |
| 6 | .\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland |
| 7 | .\" All rights reserved |
| 8 | .\" |
| 9 | .\" Created: Sun May 7 00:14:37 1995 ylo |
| 10 | .\" |
Greg Hartman | ccacbc9 | 2016-02-03 09:59:44 -0800 | [diff] [blame] | 11 | .\" $OpenBSD: scp.1,v 1.67 2015/07/10 06:21:53 markus Exp $ |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 12 | .\" |
Greg Hartman | ccacbc9 | 2016-02-03 09:59:44 -0800 | [diff] [blame] | 13 | .Dd $Mdocdate: July 10 2015 $ |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 14 | .Dt SCP 1 |
| 15 | .Os |
| 16 | .Sh NAME |
| 17 | .Nm scp |
| 18 | .Nd secure copy (remote file copy program) |
| 19 | .Sh SYNOPSIS |
| 20 | .Nm scp |
| 21 | .Bk -words |
| 22 | .Op Fl 12346BCpqrv |
| 23 | .Op Fl c Ar cipher |
| 24 | .Op Fl F Ar ssh_config |
| 25 | .Op Fl i Ar identity_file |
| 26 | .Op Fl l Ar limit |
| 27 | .Op Fl o Ar ssh_option |
| 28 | .Op Fl P Ar port |
| 29 | .Op Fl S Ar program |
| 30 | .Sm off |
| 31 | .Oo |
| 32 | .Op Ar user No @ |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 33 | .Ar host1 : |
| 34 | .Oc Ar file1 |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 35 | .Sm on |
| 36 | .Ar ... |
| 37 | .Sm off |
| 38 | .Oo |
| 39 | .Op Ar user No @ |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 40 | .Ar host2 : |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 41 | .Oc Ar file2 |
| 42 | .Sm on |
| 43 | .Ek |
| 44 | .Sh DESCRIPTION |
| 45 | .Nm |
| 46 | copies files between hosts on a network. |
| 47 | It uses |
| 48 | .Xr ssh 1 |
| 49 | for data transfer, and uses the same authentication and provides the |
| 50 | same security as |
| 51 | .Xr ssh 1 . |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 52 | .Nm |
| 53 | will ask for passwords or passphrases if they are needed for |
| 54 | authentication. |
| 55 | .Pp |
| 56 | File names may contain a user and host specification to indicate |
| 57 | that the file is to be copied to/from that host. |
| 58 | Local file names can be made explicit using absolute or relative pathnames |
| 59 | to avoid |
| 60 | .Nm |
| 61 | treating file names containing |
| 62 | .Sq :\& |
| 63 | as host specifiers. |
| 64 | Copies between two remote hosts are also permitted. |
| 65 | .Pp |
| 66 | The options are as follows: |
| 67 | .Bl -tag -width Ds |
| 68 | .It Fl 1 |
| 69 | Forces |
| 70 | .Nm |
| 71 | to use protocol 1. |
| 72 | .It Fl 2 |
| 73 | Forces |
| 74 | .Nm |
| 75 | to use protocol 2. |
| 76 | .It Fl 3 |
| 77 | Copies between two remote hosts are transferred through the local host. |
| 78 | Without this option the data is copied directly between the two remote |
| 79 | hosts. |
| 80 | Note that this option disables the progress meter. |
| 81 | .It Fl 4 |
| 82 | Forces |
| 83 | .Nm |
| 84 | to use IPv4 addresses only. |
| 85 | .It Fl 6 |
| 86 | Forces |
| 87 | .Nm |
| 88 | to use IPv6 addresses only. |
| 89 | .It Fl B |
| 90 | Selects batch mode (prevents asking for passwords or passphrases). |
| 91 | .It Fl C |
| 92 | Compression enable. |
| 93 | Passes the |
| 94 | .Fl C |
| 95 | flag to |
| 96 | .Xr ssh 1 |
| 97 | to enable compression. |
| 98 | .It Fl c Ar cipher |
| 99 | Selects the cipher to use for encrypting the data transfer. |
| 100 | This option is directly passed to |
| 101 | .Xr ssh 1 . |
| 102 | .It Fl F Ar ssh_config |
| 103 | Specifies an alternative |
| 104 | per-user configuration file for |
| 105 | .Nm ssh . |
| 106 | This option is directly passed to |
| 107 | .Xr ssh 1 . |
| 108 | .It Fl i Ar identity_file |
| 109 | Selects the file from which the identity (private key) for public key |
| 110 | authentication is read. |
| 111 | This option is directly passed to |
| 112 | .Xr ssh 1 . |
| 113 | .It Fl l Ar limit |
| 114 | Limits the used bandwidth, specified in Kbit/s. |
| 115 | .It Fl o Ar ssh_option |
| 116 | Can be used to pass options to |
| 117 | .Nm ssh |
| 118 | in the format used in |
| 119 | .Xr ssh_config 5 . |
| 120 | This is useful for specifying options |
| 121 | for which there is no separate |
| 122 | .Nm scp |
| 123 | command-line flag. |
| 124 | For full details of the options listed below, and their possible values, see |
| 125 | .Xr ssh_config 5 . |
| 126 | .Pp |
| 127 | .Bl -tag -width Ds -offset indent -compact |
| 128 | .It AddressFamily |
| 129 | .It BatchMode |
| 130 | .It BindAddress |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 131 | .It CanonicalDomains |
| 132 | .It CanonicalizeFallbackLocal |
| 133 | .It CanonicalizeHostname |
| 134 | .It CanonicalizeMaxDots |
| 135 | .It CanonicalizePermittedCNAMEs |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 136 | .It ChallengeResponseAuthentication |
| 137 | .It CheckHostIP |
| 138 | .It Cipher |
| 139 | .It Ciphers |
| 140 | .It Compression |
| 141 | .It CompressionLevel |
| 142 | .It ConnectionAttempts |
| 143 | .It ConnectTimeout |
| 144 | .It ControlMaster |
| 145 | .It ControlPath |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 146 | .It ControlPersist |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 147 | .It GlobalKnownHostsFile |
| 148 | .It GSSAPIAuthentication |
| 149 | .It GSSAPIDelegateCredentials |
| 150 | .It HashKnownHosts |
| 151 | .It Host |
| 152 | .It HostbasedAuthentication |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 153 | .It HostbasedKeyTypes |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 154 | .It HostKeyAlgorithms |
| 155 | .It HostKeyAlias |
| 156 | .It HostName |
| 157 | .It IdentityFile |
| 158 | .It IdentitiesOnly |
| 159 | .It IPQoS |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 160 | .It KbdInteractiveAuthentication |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 161 | .It KbdInteractiveDevices |
| 162 | .It KexAlgorithms |
| 163 | .It LogLevel |
| 164 | .It MACs |
| 165 | .It NoHostAuthenticationForLocalhost |
| 166 | .It NumberOfPasswordPrompts |
| 167 | .It PasswordAuthentication |
| 168 | .It PKCS11Provider |
| 169 | .It Port |
| 170 | .It PreferredAuthentications |
| 171 | .It Protocol |
| 172 | .It ProxyCommand |
Greg Hartman | ccacbc9 | 2016-02-03 09:59:44 -0800 | [diff] [blame] | 173 | .It PubkeyAcceptedKeyTypes |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 174 | .It PubkeyAuthentication |
| 175 | .It RekeyLimit |
| 176 | .It RhostsRSAAuthentication |
| 177 | .It RSAAuthentication |
| 178 | .It SendEnv |
| 179 | .It ServerAliveInterval |
| 180 | .It ServerAliveCountMax |
| 181 | .It StrictHostKeyChecking |
| 182 | .It TCPKeepAlive |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 183 | .It UpdateHostKeys |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 184 | .It UsePrivilegedPort |
| 185 | .It User |
| 186 | .It UserKnownHostsFile |
| 187 | .It VerifyHostKeyDNS |
| 188 | .El |
| 189 | .It Fl P Ar port |
| 190 | Specifies the port to connect to on the remote host. |
| 191 | Note that this option is written with a capital |
| 192 | .Sq P , |
| 193 | because |
| 194 | .Fl p |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 195 | is already reserved for preserving the times and modes of the file. |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 196 | .It Fl p |
| 197 | Preserves modification times, access times, and modes from the |
| 198 | original file. |
| 199 | .It Fl q |
| 200 | Quiet mode: disables the progress meter as well as warning and diagnostic |
| 201 | messages from |
| 202 | .Xr ssh 1 . |
| 203 | .It Fl r |
| 204 | Recursively copy entire directories. |
| 205 | Note that |
| 206 | .Nm |
| 207 | follows symbolic links encountered in the tree traversal. |
| 208 | .It Fl S Ar program |
| 209 | Name of |
| 210 | .Ar program |
| 211 | to use for the encrypted connection. |
| 212 | The program must understand |
| 213 | .Xr ssh 1 |
| 214 | options. |
| 215 | .It Fl v |
| 216 | Verbose mode. |
| 217 | Causes |
| 218 | .Nm |
| 219 | and |
| 220 | .Xr ssh 1 |
| 221 | to print debugging messages about their progress. |
| 222 | This is helpful in |
| 223 | debugging connection, authentication, and configuration problems. |
| 224 | .El |
| 225 | .Sh EXIT STATUS |
| 226 | .Ex -std scp |
| 227 | .Sh SEE ALSO |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 228 | .Xr sftp 1 , |
| 229 | .Xr ssh 1 , |
| 230 | .Xr ssh-add 1 , |
| 231 | .Xr ssh-agent 1 , |
| 232 | .Xr ssh-keygen 1 , |
| 233 | .Xr ssh_config 5 , |
| 234 | .Xr sshd 8 |
| 235 | .Sh HISTORY |
| 236 | .Nm |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 237 | is based on the rcp program in |
| 238 | .Bx |
| 239 | source code from the Regents of the University of California. |
Greg Hartman | bd77cf7 | 2015-02-25 13:21:06 -0800 | [diff] [blame] | 240 | .Sh AUTHORS |
Adam Langley | d059297 | 2015-03-30 14:49:51 -0700 | [diff] [blame] | 241 | .An Timo Rinne Aq Mt tri@iki.fi |
| 242 | .An Tatu Ylonen Aq Mt ylo@cs.hut.fi |