1SCP(1)                     OpenBSD Reference Manual                     SCP(1)
2
3NAME
4     scp - secure copy (remote file copy program)
5
6SYNOPSIS
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
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).  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
143EXIT STATUS
144     The scp utility exits 0 on success, and >0 if an error occurs.
145
146SEE ALSO
147     rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1),
148     ssh_config(5), sshd(8)
149
150HISTORY
151     scp is based on the rcp(1) program in BSD source code from the Regents of
152     the University of California.
153
154AUTHORS
155     Timo Rinne <tri@iki.fi>
156     Tatu Ylonen <ylo@cs.hut.fi>
157
158OpenBSD 5.4                      July 16, 2013                     OpenBSD 5.4
159