• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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                   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
141EXIT STATUS
142     The scp utility exits 0 on success, and >0 if an error occurs.
143
144SEE ALSO
145     rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1),
146     ssh_config(5), sshd(8)
147
148HISTORY
149     scp is based on the rcp(1) program in BSD source code from the Regents of
150     the University of California.
151
152AUTHORS
153     Timo Rinne <tri@iki.fi>
154     Tatu Ylonen <ylo@cs.hut.fi>
155
156OpenBSD 5.0                    December 9, 2010                    OpenBSD 5.0
157