Annotation of src/usr.bin/ssh/scp.1, Revision 1.56
1.1 deraadt 1: .\"
2: .\" scp.1
3: .\"
4: .\" Author: Tatu Ylonen <ylo@cs.hut.fi>
5: .\"
6: .\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
7: .\" All rights reserved
8: .\"
9: .\" Created: Sun May 7 00:14:37 1995 ylo
10: .\"
1.56 ! jmc 11: .\" $OpenBSD: scp.1,v 1.55 2010/12/08 22:46:03 markus Exp $
1.1 deraadt 12: .\"
1.56 ! jmc 13: .Dd $Mdocdate: December 8 2010 $
1.3 aaron 14: .Dt SCP 1
15: .Os
16: .Sh NAME
17: .Nm scp
18: .Nd secure copy (remote file copy program)
19: .Sh SYNOPSIS
20: .Nm scp
1.27 jmc 21: .Bk -words
1.55 markus 22: .Op Fl 12346BCpqrv
1.29 jmc 23: .Op Fl c Ar cipher
1.19 stevesk 24: .Op Fl F Ar ssh_config
1.3 aaron 25: .Op Fl i Ar identity_file
1.25 markus 26: .Op Fl l Ar limit
1.17 stevesk 27: .Op Fl o Ar ssh_option
1.29 jmc 28: .Op Fl P Ar port
29: .Op Fl S Ar program
1.3 aaron 30: .Sm off
31: .Oo
1.29 jmc 32: .Op Ar user No @
1.3 aaron 33: .Ar host1 No :
34: .Oc Ns Ar file1
35: .Sm on
1.42 sobrado 36: .Ar ...
1.3 aaron 37: .Sm off
38: .Oo
1.29 jmc 39: .Op Ar user No @
1.3 aaron 40: .Ar host2 No :
41: .Oc Ar file2
42: .Sm on
1.27 jmc 43: .Ek
1.7 aaron 44: .Sh DESCRIPTION
1.3 aaron 45: .Nm
1.6 aaron 46: copies files between hosts on a network.
47: It uses
1.3 aaron 48: .Xr ssh 1
1.1 deraadt 49: for data transfer, and uses the same authentication and provides the
50: same security as
1.3 aaron 51: .Xr ssh 1 .
1.1 deraadt 52: Unlike
1.3 aaron 53: .Xr rcp 1 ,
54: .Nm
1.1 deraadt 55: will ask for passwords or passphrases if they are needed for
56: authentication.
1.3 aaron 57: .Pp
1.44 jmc 58: File names may contain a user and host specification to indicate
1.6 aaron 59: that the file is to be copied to/from that host.
1.44 jmc 60: Local file names can be made explicit using absolute or relative pathnames
61: to avoid
62: .Nm
63: treating file names containing
64: .Sq :\&
65: as host specifiers.
66: Copies between two remote hosts are also permitted.
1.3 aaron 67: .Pp
68: The options are as follows:
69: .Bl -tag -width Ds
1.29 jmc 70: .It Fl 1
71: Forces
72: .Nm
73: to use protocol 1.
74: .It Fl 2
75: Forces
76: .Nm
77: to use protocol 2.
1.55 markus 78: .It Fl 3
79: Copies between two remote hosts are transferred through the local host.
80: Without this option the data is copied directly between the two remote
81: hosts.
1.56 ! jmc 82: Note that this option disables the progress meter.
1.29 jmc 83: .It Fl 4
84: Forces
85: .Nm
86: to use IPv4 addresses only.
87: .It Fl 6
88: Forces
1.3 aaron 89: .Nm
1.29 jmc 90: to use IPv6 addresses only.
1.3 aaron 91: .It Fl B
1.1 deraadt 92: Selects batch mode (prevents asking for passwords or passphrases).
1.3 aaron 93: .It Fl C
1.6 aaron 94: Compression enable.
95: Passes the
1.3 aaron 96: .Fl C
97: flag to
98: .Xr ssh 1
1.1 deraadt 99: to enable compression.
1.29 jmc 100: .It Fl c Ar cipher
101: Selects the cipher to use for encrypting the data transfer.
102: This option is directly passed to
103: .Xr ssh 1 .
1.19 stevesk 104: .It Fl F Ar ssh_config
105: Specifies an alternative
106: per-user configuration file for
107: .Nm ssh .
108: This option is directly passed to
109: .Xr ssh 1 .
1.29 jmc 110: .It Fl i Ar identity_file
1.46 djm 111: Selects the file from which the identity (private key) for public key
1.29 jmc 112: authentication is read.
113: This option is directly passed to
114: .Xr ssh 1 .
115: .It Fl l Ar limit
116: Limits the used bandwidth, specified in Kbit/s.
117: .It Fl o Ar ssh_option
118: Can be used to pass options to
119: .Nm ssh
120: in the format used in
121: .Xr ssh_config 5 .
122: This is useful for specifying options
123: for which there is no separate
124: .Nm scp
125: command-line flag.
126: For full details of the options listed below, and their possible values, see
127: .Xr ssh_config 5 .
128: .Pp
129: .Bl -tag -width Ds -offset indent -compact
130: .It AddressFamily
131: .It BatchMode
132: .It BindAddress
133: .It ChallengeResponseAuthentication
134: .It CheckHostIP
135: .It Cipher
136: .It Ciphers
137: .It Compression
138: .It CompressionLevel
139: .It ConnectionAttempts
1.34 dtucker 140: .It ConnectTimeout
1.36 djm 141: .It ControlMaster
142: .It ControlPath
1.29 jmc 143: .It GlobalKnownHostsFile
144: .It GSSAPIAuthentication
145: .It GSSAPIDelegateCredentials
1.38 jmc 146: .It HashKnownHosts
1.29 jmc 147: .It Host
148: .It HostbasedAuthentication
149: .It HostKeyAlgorithms
150: .It HostKeyAlias
151: .It HostName
152: .It IdentityFile
1.33 markus 153: .It IdentitiesOnly
1.54 jmc 154: .It IPQoS
1.37 djm 155: .It KbdInteractiveDevices
1.52 jmc 156: .It KexAlgorithms
1.29 jmc 157: .It LogLevel
158: .It MACs
159: .It NoHostAuthenticationForLocalhost
160: .It NumberOfPasswordPrompts
161: .It PasswordAuthentication
1.50 markus 162: .It PKCS11Provider
1.29 jmc 163: .It Port
164: .It PreferredAuthentications
165: .It Protocol
166: .It ProxyCommand
167: .It PubkeyAuthentication
1.39 dtucker 168: .It RekeyLimit
1.29 jmc 169: .It RhostsRSAAuthentication
170: .It RSAAuthentication
1.35 jmc 171: .It SendEnv
1.32 markus 172: .It ServerAliveInterval
173: .It ServerAliveCountMax
1.29 jmc 174: .It StrictHostKeyChecking
1.31 markus 175: .It TCPKeepAlive
1.29 jmc 176: .It UsePrivilegedPort
177: .It User
178: .It UserKnownHostsFile
179: .It VerifyHostKeyDNS
180: .El
1.4 markus 181: .It Fl P Ar port
1.6 aaron 182: Specifies the port to connect to on the remote host.
183: Note that this option is written with a capital
1.3 aaron 184: .Sq P ,
185: because
186: .Fl p
187: is already reserved for preserving the times and modes of the file in
188: .Xr rcp 1 .
1.29 jmc 189: .It Fl p
190: Preserves modification times, access times, and modes from the
191: original file.
192: .It Fl q
1.43 djm 193: Quiet mode: disables the progress meter as well as warning and diagnostic
194: messages from
195: .Xr ssh 1 .
1.29 jmc 196: .It Fl r
197: Recursively copy entire directories.
1.45 dtucker 198: Note that
199: .Nm
200: follows symbolic links encountered in the tree traversal.
1.10 deraadt 201: .It Fl S Ar program
202: Name of
203: .Ar program
1.12 aaron 204: to use for the encrypted connection.
205: The program must understand
1.9 deraadt 206: .Xr ssh 1
207: options.
1.29 jmc 208: .It Fl v
209: Verbose mode.
210: Causes
1.24 markus 211: .Nm
1.29 jmc 212: and
213: .Xr ssh 1
214: to print debugging messages about their progress.
215: This is helpful in
216: debugging connection, authentication, and configuration problems.
1.8 aaron 217: .El
1.51 jmc 218: .Sh EXIT STATUS
1.40 jmc 219: .Ex -std scp
1.3 aaron 220: .Sh SEE ALSO
221: .Xr rcp 1 ,
1.14 djm 222: .Xr sftp 1 ,
1.3 aaron 223: .Xr ssh 1 ,
224: .Xr ssh-add 1 ,
225: .Xr ssh-agent 1 ,
226: .Xr ssh-keygen 1 ,
1.23 stevesk 227: .Xr ssh_config 5 ,
1.3 aaron 228: .Xr sshd 8
1.28 jmc 229: .Sh HISTORY
230: .Nm
231: is based on the
232: .Xr rcp 1
233: program in BSD source code from the Regents of the University of
234: California.
235: .Sh AUTHORS
236: .An Timo Rinne Aq tri@iki.fi
237: .An Tatu Ylonen Aq ylo@cs.hut.fi