crypto/openssh/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                    ControlPersist
  81                    GlobalKnownHostsFile
  82                    GSSAPIAuthentication
  83                    GSSAPIDelegateCredentials
  84                    HashKnownHosts
  85                    Host
  86                    HostbasedAuthentication
  87                    HostKeyAlgorithms
  88                    HostKeyAlias
  89                    HostName
  90                    IdentityFile
  91                    IdentitiesOnly
  92                    IPQoS
  93                    KbdInteractiveAuthentication
  94                    KbdInteractiveDevices
  95                    KexAlgorithms
  96                    LogLevel
  97                    MACs
  98                    NoHostAuthenticationForLocalhost
  99                    NumberOfPasswordPrompts
 100                    PasswordAuthentication
 101                    PKCS11Provider
 102                    Port
 103                    PreferredAuthentications
 104                    Protocol
 105                    ProxyCommand
 106                    PubkeyAuthentication
 107                    RekeyLimit
 108                    RhostsRSAAuthentication
 109                    RSAAuthentication
 110                    SendEnv
 111                    ServerAliveInterval
 112                    ServerAliveCountMax
 113                    StrictHostKeyChecking
 114                    TCPKeepAlive
 115                    UsePrivilegedPort
 116                    User
 117                    UserKnownHostsFile
 118                    VerifyHostKeyDNS
 119
 120      -P port
 121              Specifies the port to connect to on the remote host.  Note that
 122              this option is written with a capital `P', because -p is already
 123              reserved for preserving the times and modes of the file in
 124              rcp(1).
 125
 126      -p      Preserves modification times, access times, and modes from the
 127              original file.
 128
 129      -q      Quiet mode: disables the progress meter as well as warning and
 130              diagnostic messages from ssh(1).
 131
 132      -r      Recursively copy entire directories.  Note that scp follows
 133              symbolic links encountered in the tree traversal.
 134
 135      -S program
 136              Name of program to use for the encrypted connection.  The program
 137              must understand ssh(1) options.
 138
 139      -v      Verbose mode.  Causes scp and ssh(1) to print debugging messages
 140              about their progress.  This is helpful in debugging connection,
 141              authentication, and configuration problems.
 142
 143 EXIT STATUS
 144      The scp utility exits 0 on success, and >0 if an error occurs.
 145
 146 SEE ALSO
 147      rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1),
 148      ssh_config(5), sshd(8)
 149
 150 HISTORY
 151      scp is based on the rcp(1) program in BSD source code from the Regents of
 152      the University of California.
 153
 154 AUTHORS
 155      Timo Rinne <tri@iki.fi>
 156      Tatu Ylonen <ylo@cs.hut.fi>
 157
 158 OpenBSD 5.4                      July 16, 2013                     OpenBSD 5.4