Annotation of src/usr.bin/ssh/scp.1, Revision 1.69
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.69 ! markus 11: .\" $OpenBSD: scp.1,v 1.68 2015/09/25 18:19:54 jmc Exp $
1.1 deraadt 12: .\"
1.69 ! markus 13: .Dd $Mdocdate: September 25 2015 $
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.63 schwarze 33: .Ar host1 :
1.58 jmc 34: .Oc Ar file1
1.3 aaron 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.63 schwarze 40: .Ar host2 :
1.3 aaron 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 .
52: .Nm
1.1 deraadt 53: will ask for passwords or passphrases if they are needed for
54: authentication.
1.3 aaron 55: .Pp
1.44 jmc 56: File names may contain a user and host specification to indicate
1.6 aaron 57: that the file is to be copied to/from that host.
1.44 jmc 58: Local file names can be made explicit using absolute or relative pathnames
59: to avoid
60: .Nm
61: treating file names containing
62: .Sq :\&
63: as host specifiers.
64: Copies between two remote hosts are also permitted.
1.3 aaron 65: .Pp
66: The options are as follows:
67: .Bl -tag -width Ds
1.29 jmc 68: .It Fl 1
69: Forces
70: .Nm
71: to use protocol 1.
72: .It Fl 2
73: Forces
74: .Nm
75: to use protocol 2.
1.55 markus 76: .It Fl 3
77: Copies between two remote hosts are transferred through the local host.
78: Without this option the data is copied directly between the two remote
79: hosts.
1.56 jmc 80: Note that this option disables the progress meter.
1.29 jmc 81: .It Fl 4
82: Forces
83: .Nm
84: to use IPv4 addresses only.
85: .It Fl 6
86: Forces
1.3 aaron 87: .Nm
1.29 jmc 88: to use IPv6 addresses only.
1.3 aaron 89: .It Fl B
1.1 deraadt 90: Selects batch mode (prevents asking for passwords or passphrases).
1.3 aaron 91: .It Fl C
1.6 aaron 92: Compression enable.
93: Passes the
1.3 aaron 94: .Fl C
95: flag to
96: .Xr ssh 1
1.1 deraadt 97: to enable compression.
1.29 jmc 98: .It Fl c Ar cipher
99: Selects the cipher to use for encrypting the data transfer.
100: This option is directly passed to
101: .Xr ssh 1 .
1.19 stevesk 102: .It Fl F Ar ssh_config
103: Specifies an alternative
104: per-user configuration file for
105: .Nm ssh .
106: This option is directly passed to
107: .Xr ssh 1 .
1.29 jmc 108: .It Fl i Ar identity_file
1.46 djm 109: Selects the file from which the identity (private key) for public key
1.29 jmc 110: authentication is read.
111: This option is directly passed to
112: .Xr ssh 1 .
113: .It Fl l Ar limit
114: Limits the used bandwidth, specified in Kbit/s.
115: .It Fl o Ar ssh_option
116: Can be used to pass options to
117: .Nm ssh
118: in the format used in
119: .Xr ssh_config 5 .
120: This is useful for specifying options
121: for which there is no separate
122: .Nm scp
123: command-line flag.
124: For full details of the options listed below, and their possible values, see
125: .Xr ssh_config 5 .
126: .Pp
127: .Bl -tag -width Ds -offset indent -compact
128: .It AddressFamily
129: .It BatchMode
130: .It BindAddress
1.61 djm 131: .It CanonicalDomains
132: .It CanonicalizeFallbackLocal
133: .It CanonicalizeHostname
134: .It CanonicalizeMaxDots
135: .It CanonicalizePermittedCNAMEs
1.68 jmc 136: .It CertificateFile
1.29 jmc 137: .It ChallengeResponseAuthentication
138: .It CheckHostIP
139: .It Cipher
140: .It Ciphers
141: .It Compression
142: .It CompressionLevel
143: .It ConnectionAttempts
1.34 dtucker 144: .It ConnectTimeout
1.36 djm 145: .It ControlMaster
146: .It ControlPath
1.57 djm 147: .It ControlPersist
1.29 jmc 148: .It GlobalKnownHostsFile
149: .It GSSAPIAuthentication
150: .It GSSAPIDelegateCredentials
1.38 jmc 151: .It HashKnownHosts
1.29 jmc 152: .It Host
153: .It HostbasedAuthentication
1.66 djm 154: .It HostbasedKeyTypes
1.29 jmc 155: .It HostKeyAlgorithms
156: .It HostKeyAlias
157: .It HostName
1.69 ! markus 158: .It IdentityAgent
1.29 jmc 159: .It IdentityFile
1.33 markus 160: .It IdentitiesOnly
1.54 jmc 161: .It IPQoS
1.57 djm 162: .It KbdInteractiveAuthentication
1.37 djm 163: .It KbdInteractiveDevices
1.52 jmc 164: .It KexAlgorithms
1.29 jmc 165: .It LogLevel
166: .It MACs
167: .It NoHostAuthenticationForLocalhost
168: .It NumberOfPasswordPrompts
169: .It PasswordAuthentication
1.50 markus 170: .It PKCS11Provider
1.29 jmc 171: .It Port
172: .It PreferredAuthentications
173: .It Protocol
174: .It ProxyCommand
1.67 markus 175: .It PubkeyAcceptedKeyTypes
1.29 jmc 176: .It PubkeyAuthentication
1.39 dtucker 177: .It RekeyLimit
1.29 jmc 178: .It RhostsRSAAuthentication
179: .It RSAAuthentication
1.35 jmc 180: .It SendEnv
1.32 markus 181: .It ServerAliveInterval
182: .It ServerAliveCountMax
1.29 jmc 183: .It StrictHostKeyChecking
1.31 markus 184: .It TCPKeepAlive
1.65 jmc 185: .It UpdateHostKeys
1.29 jmc 186: .It UsePrivilegedPort
187: .It User
188: .It UserKnownHostsFile
189: .It VerifyHostKeyDNS
190: .El
1.4 markus 191: .It Fl P Ar port
1.6 aaron 192: Specifies the port to connect to on the remote host.
193: Note that this option is written with a capital
1.3 aaron 194: .Sq P ,
195: because
196: .Fl p
1.62 tedu 197: is already reserved for preserving the times and modes of the file.
1.29 jmc 198: .It Fl p
199: Preserves modification times, access times, and modes from the
200: original file.
201: .It Fl q
1.43 djm 202: Quiet mode: disables the progress meter as well as warning and diagnostic
203: messages from
204: .Xr ssh 1 .
1.29 jmc 205: .It Fl r
206: Recursively copy entire directories.
1.45 dtucker 207: Note that
208: .Nm
209: follows symbolic links encountered in the tree traversal.
1.10 deraadt 210: .It Fl S Ar program
211: Name of
212: .Ar program
1.12 aaron 213: to use for the encrypted connection.
214: The program must understand
1.9 deraadt 215: .Xr ssh 1
216: options.
1.29 jmc 217: .It Fl v
218: Verbose mode.
219: Causes
1.24 markus 220: .Nm
1.29 jmc 221: and
222: .Xr ssh 1
223: to print debugging messages about their progress.
224: This is helpful in
225: debugging connection, authentication, and configuration problems.
1.8 aaron 226: .El
1.51 jmc 227: .Sh EXIT STATUS
1.40 jmc 228: .Ex -std scp
1.3 aaron 229: .Sh SEE ALSO
1.14 djm 230: .Xr sftp 1 ,
1.3 aaron 231: .Xr ssh 1 ,
232: .Xr ssh-add 1 ,
233: .Xr ssh-agent 1 ,
234: .Xr ssh-keygen 1 ,
1.23 stevesk 235: .Xr ssh_config 5 ,
1.3 aaron 236: .Xr sshd 8
1.28 jmc 237: .Sh HISTORY
238: .Nm
1.62 tedu 239: is based on the rcp program in
1.60 jmc 240: .Bx
241: source code from the Regents of the University of California.
1.28 jmc 242: .Sh AUTHORS
1.59 schwarze 243: .An Timo Rinne Aq Mt tri@iki.fi
244: .An Tatu Ylonen Aq Mt ylo@cs.hut.fi
![[BACK]](/icons/back.gif){kind=icon}
Return to scp.1 CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / src / usr.bin / ssh