crypto/openssh/scp.1

   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 .\"
  11 .\" $OpenBSD: scp.1,v 1.68 2015/09/25 18:19:54 jmc Exp $
  12 .\"
  13 .Dd $Mdocdate: September 25 2015 $
  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 @
  33 .Ar host1 :
  34 .Oc Ar file1
  35 .Sm on
  36 .Ar ...
  37 .Sm off
  38 .Oo
  39 .Op Ar user No @
  40 .Ar host2 :
  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 .
  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
 131 .It CanonicalDomains
 132 .It CanonicalizeFallbackLocal
 133 .It CanonicalizeHostname
 134 .It CanonicalizeMaxDots
 135 .It CanonicalizePermittedCNAMEs
 136 .It CertificateFile
 137 .It ChallengeResponseAuthentication
 138 .It CheckHostIP
 139 .It Cipher
 140 .It Ciphers
 141 .It Compression
 142 .It CompressionLevel
 143 .It ConnectionAttempts
 144 .It ConnectTimeout
 145 .It ControlMaster
 146 .It ControlPath
 147 .It ControlPersist
 148 .It GlobalKnownHostsFile
 149 .It GSSAPIAuthentication
 150 .It GSSAPIDelegateCredentials
 151 .It HashKnownHosts
 152 .It Host
 153 .It HostbasedAuthentication
 154 .It HostbasedKeyTypes
 155 .It HostKeyAlgorithms
 156 .It HostKeyAlias
 157 .It HostName
 158 .It IdentityFile
 159 .It IdentitiesOnly
 160 .It IPQoS
 161 .It KbdInteractiveAuthentication
 162 .It KbdInteractiveDevices
 163 .It KexAlgorithms
 164 .It LogLevel
 165 .It MACs
 166 .It NoHostAuthenticationForLocalhost
 167 .It NumberOfPasswordPrompts
 168 .It PasswordAuthentication
 169 .It PKCS11Provider
 170 .It Port
 171 .It PreferredAuthentications
 172 .It Protocol
 173 .It ProxyCommand
 174 .It PubkeyAcceptedKeyTypes
 175 .It PubkeyAuthentication
 176 .It RekeyLimit
 177 .It RhostsRSAAuthentication
 178 .It RSAAuthentication
 179 .It SendEnv
 180 .It ServerAliveInterval
 181 .It ServerAliveCountMax
 182 .It StrictHostKeyChecking
 183 .It TCPKeepAlive
 184 .It UpdateHostKeys
 185 .It UsePrivilegedPort
 186 .It User
 187 .It UserKnownHostsFile
 188 .It VerifyHostKeyDNS
 189 .El
 190 .It Fl P Ar port
 191 Specifies the port to connect to on the remote host.
 192 Note that this option is written with a capital
 193 .Sq P ,
 194 because
 195 .Fl p
 196 is already reserved for preserving the times and modes of the file.
 197 .It Fl p
 198 Preserves modification times, access times, and modes from the
 199 original file.
 200 .It Fl q
 201 Quiet mode: disables the progress meter as well as warning and diagnostic
 202 messages from
 203 .Xr ssh 1 .
 204 .It Fl r
 205 Recursively copy entire directories.
 206 Note that
 207 .Nm
 208 follows symbolic links encountered in the tree traversal.
 209 .It Fl S Ar program
 210 Name of
 211 .Ar program
 212 to use for the encrypted connection.
 213 The program must understand
 214 .Xr ssh 1
 215 options.
 216 .It Fl v
 217 Verbose mode.
 218 Causes
 219 .Nm
 220 and
 221 .Xr ssh 1
 222 to print debugging messages about their progress.
 223 This is helpful in
 224 debugging connection, authentication, and configuration problems.
 225 .El
 226 .Sh EXIT STATUS
 227 .Ex -std scp
 228 .Sh SEE ALSO
 229 .Xr sftp 1 ,
 230 .Xr ssh 1 ,
 231 .Xr ssh-add 1 ,
 232 .Xr ssh-agent 1 ,
 233 .Xr ssh-keygen 1 ,
 234 .Xr ssh_config 5 ,
 235 .Xr sshd 8
 236 .Sh HISTORY
 237 .Nm
 238 is based on the rcp program in
 239 .Bx
 240 source code from the Regents of the University of California.
 241 .Sh AUTHORS
 242 .An Timo Rinne Aq Mt tri@iki.fi
 243 .An Tatu Ylonen Aq Mt ylo@cs.hut.fi