scp.0

   1 SCP(1)                     OpenBSD Reference Manual                     SCP(1)
   2
   3 NAME
   4      scp - secure copy (remote file copy program)
   5
   6 SYNOPSIS
   7      scp [-12346BCpqrv] [-c cipher] [-F ssh_config] [-i identity_file]
   8          [-l limit] [-o ssh_option] [-P port] [-S program]
   9          [[user@]host1:]file1 ... [[user@]host2:]file2
  10
  11 DESCRIPTION
  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).  Unlike rcp(1), scp will ask for passwords or passphrases if
  15      they are needed for authentication.
  16
  17      File names may contain a user and host specification to indicate that the
  18      file is to be copied to/from that host.  Local file names can be made
  19      explicit using absolute or relative pathnames to avoid scp treating file
  20      names containing `:' as host specifiers.  Copies between two remote hosts
  21      are also permitted.
  22
  23      The options are as follows:
  24
  25      -1      Forces scp to use protocol 1.
  26
  27      -2      Forces scp to use protocol 2.
  28
  29      -3      Copies between two remote hosts are transferred through the local
  30              host.  Without this option the data is copied directly between
  31              the two remote hosts.  Note that this option disables the
  32              progress meter.
  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      -l limit
  58              Limits the used bandwidth, specified in Kbit/s.
  59
  60      -o ssh_option
  61              Can be used to pass options to ssh in the format used in
  62              ssh_config(5).  This is useful for specifying options for which
  63              there is no separate scp command-line flag.  For full details of
  64              the options listed below, and their possible values, see
  65              ssh_config(5).
  66
  67                    AddressFamily
  68                    BatchMode
  69                    BindAddress
  70                    ChallengeResponseAuthentication
  71                    CheckHostIP
  72                    Cipher
  73                    Ciphers
  74                    Compression
  75                    CompressionLevel
  76                    ConnectionAttempts
  77                    ConnectTimeout
  78                    ControlMaster
  79                    ControlPath
  80                    GlobalKnownHostsFile
  81                    GSSAPIAuthentication
  82                    GSSAPIDelegateCredentials
  83                    HashKnownHosts
  84                    Host
  85                    HostbasedAuthentication
  86                    HostKeyAlgorithms
  87                    HostKeyAlias
  88                    HostName
  89                    IdentityFile
  90                    IdentitiesOnly
  91                    IPQoS
  92                    KbdInteractiveDevices
  93                    KexAlgorithms
  94                    LogLevel
  95                    MACs
  96                    NoHostAuthenticationForLocalhost
  97                    NumberOfPasswordPrompts
  98                    PasswordAuthentication
  99                    PKCS11Provider
 100                    Port
 101                    PreferredAuthentications
 102                    Protocol
 103                    ProxyCommand
 104                    PubkeyAuthentication
 105                    RekeyLimit
 106                    RhostsRSAAuthentication
 107                    RSAAuthentication
 108                    SendEnv
 109                    ServerAliveInterval
 110                    ServerAliveCountMax
 111                    StrictHostKeyChecking
 112                    TCPKeepAlive
 113                    UsePrivilegedPort
 114                    User
 115                    UserKnownHostsFile
 116                    VerifyHostKeyDNS
 117
 118      -P port
 119              Specifies the port to connect to on the remote host.  Note that
 120              this option is written with a capital `P', because -p is already
 121              reserved for preserving the times and modes of the file in
 122              rcp(1).
 123
 124      -p      Preserves modification times, access times, and modes from the
 125              original file.
 126
 127      -q      Quiet mode: disables the progress meter as well as warning and
 128              diagnostic messages from ssh(1).
 129
 130      -r      Recursively copy entire directories.  Note that scp follows
 131              symbolic links encountered in the tree traversal.
 132
 133      -S program
 134              Name of program to use for the encrypted connection.  The program
 135              must understand ssh(1) options.
 136
 137      -v      Verbose mode.  Causes scp and ssh(1) to print debugging messages
 138              about their progress.  This is helpful in debugging connection,
 139              authentication, and configuration problems.
 140
 141 EXIT STATUS
 142      The scp utility exits 0 on success, and >0 if an error occurs.
 143
 144 SEE ALSO
 145      rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1),
 146      ssh_config(5), sshd(8)
 147
 148 HISTORY
 149      scp is based on the rcp(1) program in BSD source code from the Regents of
 150      the University of California.
 151
 152 AUTHORS
 153      Timo Rinne <tri@iki.fi>
 154      Tatu Ylonen <ylo@cs.hut.fi>
 155
 156 OpenBSD 4.9                    December 9, 2010                    OpenBSD 4.9