~ubuntu-branches/ubuntu/edgy/openssh/edgy

« back to all changes in this revision

Viewing changes to scp.1

  • Committer: Bazaar Package Importer
  • Author(s): Noah Meyerhans
  • Date: 2006-10-31 17:53:38 UTC
  • Revision ID: james.westby@ubuntu.com-20061031175338-kh299ada2qc2kzlb
Tags: upstream-3.8.1p1
ImportĀ upstreamĀ versionĀ 3.8.1p1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\"  -*- nroff -*-
 
2
.\"
 
3
.\" scp.1
 
4
.\"
 
5
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
 
6
.\"
 
7
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
 
8
.\"                    All rights reserved
 
9
.\"
 
10
.\" Created: Sun May  7 00:14:37 1995 ylo
 
11
.\"
 
12
.\" $OpenBSD: scp.1,v 1.33 2004/03/05 10:53:58 markus Exp $
 
13
.\"
 
14
.Dd September 25, 1999
 
15
.Dt SCP 1
 
16
.Os
 
17
.Sh NAME
 
18
.Nm scp
 
19
.Nd secure copy (remote file copy program)
 
20
.Sh SYNOPSIS
 
21
.Nm scp
 
22
.Bk -words
 
23
.Op Fl 1246BCpqrv
 
24
.Op Fl c Ar cipher
 
25
.Op Fl F Ar ssh_config
 
26
.Op Fl i Ar identity_file
 
27
.Op Fl l Ar limit
 
28
.Op Fl o Ar ssh_option
 
29
.Op Fl P Ar port
 
30
.Op Fl S Ar program
 
31
.Sm off
 
32
.Oo
 
33
.Op Ar user No @
 
34
.Ar host1 No :
 
35
.Oc Ns Ar file1
 
36
.Sm on
 
37
.Op Ar ...
 
38
.Sm off
 
39
.Oo
 
40
.Op Ar user No @
 
41
.Ar host2 No :
 
42
.Oc Ar file2
 
43
.Sm on
 
44
.Ek
 
45
.Sh DESCRIPTION
 
46
.Nm
 
47
copies files between hosts on a network.
 
48
It uses
 
49
.Xr ssh 1
 
50
for data transfer, and uses the same authentication and provides the
 
51
same security as
 
52
.Xr ssh 1 .
 
53
Unlike
 
54
.Xr rcp 1 ,
 
55
.Nm
 
56
will ask for passwords or passphrases if they are needed for
 
57
authentication.
 
58
.Pp
 
59
Any file name may contain a host and user specification to indicate
 
60
that the file is to be copied to/from that host.
 
61
Copies between two remote hosts are permitted.
 
62
.Pp
 
63
The options are as follows:
 
64
.Bl -tag -width Ds
 
65
.It Fl 1
 
66
Forces
 
67
.Nm
 
68
to use protocol 1.
 
69
.It Fl 2
 
70
Forces
 
71
.Nm
 
72
to use protocol 2.
 
73
.It Fl 4
 
74
Forces
 
75
.Nm
 
76
to use IPv4 addresses only.
 
77
.It Fl 6
 
78
Forces
 
79
.Nm
 
80
to use IPv6 addresses only.
 
81
.It Fl B
 
82
Selects batch mode (prevents asking for passwords or passphrases).
 
83
.It Fl C
 
84
Compression enable.
 
85
Passes the
 
86
.Fl C
 
87
flag to
 
88
.Xr ssh 1
 
89
to enable compression.
 
90
.It Fl c Ar cipher
 
91
Selects the cipher to use for encrypting the data transfer.
 
92
This option is directly passed to
 
93
.Xr ssh 1 .
 
94
.It Fl F Ar ssh_config
 
95
Specifies an alternative
 
96
per-user configuration file for
 
97
.Nm ssh .
 
98
This option is directly passed to
 
99
.Xr ssh 1 .
 
100
.It Fl i Ar identity_file
 
101
Selects the file from which the identity (private key) for RSA
 
102
authentication is read.
 
103
This option is directly passed to
 
104
.Xr ssh 1 .
 
105
.It Fl l Ar limit
 
106
Limits the used bandwidth, specified in Kbit/s.
 
107
.It Fl o Ar ssh_option
 
108
Can be used to pass options to
 
109
.Nm ssh
 
110
in the format used in
 
111
.Xr ssh_config 5 .
 
112
This is useful for specifying options
 
113
for which there is no separate
 
114
.Nm scp
 
115
command-line flag.
 
116
For full details of the options listed below, and their possible values, see
 
117
.Xr ssh_config 5 .
 
118
.Pp
 
119
.Bl -tag -width Ds -offset indent -compact
 
120
.It AddressFamily
 
121
.It BatchMode
 
122
.It BindAddress
 
123
.It ChallengeResponseAuthentication
 
124
.It CheckHostIP
 
125
.It Cipher
 
126
.It Ciphers
 
127
.It Compression
 
128
.It CompressionLevel
 
129
.It ConnectionAttempts
 
130
.It ConnectionTimeout
 
131
.It GlobalKnownHostsFile
 
132
.It GSSAPIAuthentication
 
133
.It GSSAPIDelegateCredentials
 
134
.It Host
 
135
.It HostbasedAuthentication
 
136
.It HostKeyAlgorithms
 
137
.It HostKeyAlias
 
138
.It HostName
 
139
.It IdentityFile
 
140
.It IdentitiesOnly
 
141
.It LogLevel
 
142
.It MACs
 
143
.It NoHostAuthenticationForLocalhost
 
144
.It NumberOfPasswordPrompts
 
145
.It PasswordAuthentication
 
146
.It Port
 
147
.It PreferredAuthentications
 
148
.It Protocol
 
149
.It ProxyCommand
 
150
.It PubkeyAuthentication
 
151
.It RhostsRSAAuthentication
 
152
.It RSAAuthentication
 
153
.It ServerAliveInterval
 
154
.It ServerAliveCountMax
 
155
.It SmartcardDevice
 
156
.It StrictHostKeyChecking
 
157
.It TCPKeepAlive
 
158
.It UsePrivilegedPort
 
159
.It User
 
160
.It UserKnownHostsFile
 
161
.It VerifyHostKeyDNS
 
162
.El
 
163
.It Fl P Ar port
 
164
Specifies the port to connect to on the remote host.
 
165
Note that this option is written with a capital
 
166
.Sq P ,
 
167
because
 
168
.Fl p
 
169
is already reserved for preserving the times and modes of the file in
 
170
.Xr rcp 1 .
 
171
.It Fl p
 
172
Preserves modification times, access times, and modes from the
 
173
original file.
 
174
.It Fl q
 
175
Disables the progress meter.
 
176
.It Fl r
 
177
Recursively copy entire directories.
 
178
.It Fl S Ar program
 
179
Name of
 
180
.Ar program
 
181
to use for the encrypted connection.
 
182
The program must understand
 
183
.Xr ssh 1
 
184
options.
 
185
.It Fl v
 
186
Verbose mode.
 
187
Causes
 
188
.Nm
 
189
and
 
190
.Xr ssh 1
 
191
to print debugging messages about their progress.
 
192
This is helpful in
 
193
debugging connection, authentication, and configuration problems.
 
194
.El
 
195
.Sh DIAGNOSTICS
 
196
.Nm
 
197
exits with 0 on success or >0 if an error occurred.
 
198
.Sh SEE ALSO
 
199
.Xr rcp 1 ,
 
200
.Xr sftp 1 ,
 
201
.Xr ssh 1 ,
 
202
.Xr ssh-add 1 ,
 
203
.Xr ssh-agent 1 ,
 
204
.Xr ssh-keygen 1 ,
 
205
.Xr ssh_config 5 ,
 
206
.Xr sshd 8
 
207
.Sh HISTORY
 
208
.Nm
 
209
is based on the
 
210
.Xr rcp 1
 
211
program in BSD source code from the Regents of the University of
 
212
California.
 
213
.Sh AUTHORS
 
214
.An Timo Rinne Aq tri@iki.fi
 
215
.An Tatu Ylonen Aq ylo@cs.hut.fi