Annotation of src/usr.bin/ssh/scp.1, Revision 1.29
1.1 deraadt 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: .\"
1.29 ! jmc 12: .\" $OpenBSD: scp.1,v 1.28 2003/06/10 09:12:11 jmc Exp $
1.1 deraadt 13: .\"
1.3 aaron 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
1.27 jmc 22: .Bk -words
1.29 ! jmc 23: .Op Fl 1246BCpqrv
! 24: .Op Fl c Ar cipher
1.19 stevesk 25: .Op Fl F Ar ssh_config
1.3 aaron 26: .Op Fl i Ar identity_file
1.25 markus 27: .Op Fl l Ar limit
1.17 stevesk 28: .Op Fl o Ar ssh_option
1.29 ! jmc 29: .Op Fl P Ar port
! 30: .Op Fl S Ar program
1.3 aaron 31: .Sm off
32: .Oo
1.29 ! jmc 33: .Op Ar user No @
1.3 aaron 34: .Ar host1 No :
35: .Oc Ns Ar file1
36: .Sm on
37: .Op Ar ...
38: .Sm off
39: .Oo
1.29 ! jmc 40: .Op Ar user No @
1.3 aaron 41: .Ar host2 No :
42: .Oc Ar file2
43: .Sm on
1.27 jmc 44: .Ek
1.7 aaron 45: .Sh DESCRIPTION
1.3 aaron 46: .Nm
1.6 aaron 47: copies files between hosts on a network.
48: It uses
1.3 aaron 49: .Xr ssh 1
1.1 deraadt 50: for data transfer, and uses the same authentication and provides the
51: same security as
1.3 aaron 52: .Xr ssh 1 .
1.1 deraadt 53: Unlike
1.3 aaron 54: .Xr rcp 1 ,
55: .Nm
1.1 deraadt 56: will ask for passwords or passphrases if they are needed for
57: authentication.
1.3 aaron 58: .Pp
1.1 deraadt 59: Any file name may contain a host and user specification to indicate
1.6 aaron 60: that the file is to be copied to/from that host.
61: Copies between two remote hosts are permitted.
1.3 aaron 62: .Pp
63: The options are as follows:
64: .Bl -tag -width Ds
1.29 ! jmc 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
1.3 aaron 79: .Nm
1.29 ! jmc 80: to use IPv6 addresses only.
1.3 aaron 81: .It Fl B
1.1 deraadt 82: Selects batch mode (prevents asking for passwords or passphrases).
1.3 aaron 83: .It Fl C
1.6 aaron 84: Compression enable.
85: Passes the
1.3 aaron 86: .Fl C
87: flag to
88: .Xr ssh 1
1.1 deraadt 89: to enable compression.
1.29 ! jmc 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 .
1.19 stevesk 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 .
1.29 ! jmc 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 ClearAllForwardings
! 128: .It Compression
! 129: .It CompressionLevel
! 130: .It ConnectionAttempts
! 131: .It ConnectionTimeout
! 132: .It DynamicForward
! 133: .It EscapeChar
! 134: .It ForwardAgent
! 135: .It ForwardX11
! 136: .It GatewayPorts
! 137: .It GlobalKnownHostsFile
! 138: .It GSSAPIAuthentication
! 139: .It GSSAPIDelegateCredentials
! 140: .It Host
! 141: .It HostbasedAuthentication
! 142: .It HostKeyAlgorithms
! 143: .It HostKeyAlias
! 144: .It HostName
! 145: .It IdentityFile
! 146: .It KeepAlive
! 147: .It LocalForward
! 148: .It LogLevel
! 149: .It MACs
! 150: .It NoHostAuthenticationForLocalhost
! 151: .It NumberOfPasswordPrompts
! 152: .It PasswordAuthentication
! 153: .It Port
! 154: .It PreferredAuthentications
! 155: .It Protocol
! 156: .It ProxyCommand
! 157: .It PubkeyAuthentication
! 158: .It RemoteForward
! 159: .It RhostsRSAAuthentication
! 160: .It RSAAuthentication
! 161: .It SmartcardDevice
! 162: .It StrictHostKeyChecking
! 163: .It UsePrivilegedPort
! 164: .It User
! 165: .It UserKnownHostsFile
! 166: .It VerifyHostKeyDNS
! 167: .It XAuthLocation
! 168: .El
1.4 markus 169: .It Fl P Ar port
1.6 aaron 170: Specifies the port to connect to on the remote host.
171: Note that this option is written with a capital
1.3 aaron 172: .Sq P ,
173: because
174: .Fl p
175: is already reserved for preserving the times and modes of the file in
176: .Xr rcp 1 .
1.29 ! jmc 177: .It Fl p
! 178: Preserves modification times, access times, and modes from the
! 179: original file.
! 180: .It Fl q
! 181: Disables the progress meter.
! 182: .It Fl r
! 183: Recursively copy entire directories.
1.10 deraadt 184: .It Fl S Ar program
185: Name of
186: .Ar program
1.12 aaron 187: to use for the encrypted connection.
188: The program must understand
1.9 deraadt 189: .Xr ssh 1
190: options.
1.29 ! jmc 191: .It Fl v
! 192: Verbose mode.
! 193: Causes
1.24 markus 194: .Nm
1.29 ! jmc 195: and
! 196: .Xr ssh 1
! 197: to print debugging messages about their progress.
! 198: This is helpful in
! 199: debugging connection, authentication, and configuration problems.
1.8 aaron 200: .El
1.21 markus 201: .Sh DIAGNOSTICS
202: .Nm
203: exits with 0 on success or >0 if an error occurred.
1.3 aaron 204: .Sh SEE ALSO
205: .Xr rcp 1 ,
1.14 djm 206: .Xr sftp 1 ,
1.3 aaron 207: .Xr ssh 1 ,
208: .Xr ssh-add 1 ,
209: .Xr ssh-agent 1 ,
210: .Xr ssh-keygen 1 ,
1.23 stevesk 211: .Xr ssh_config 5 ,
1.3 aaron 212: .Xr sshd 8
1.28 jmc 213: .Sh HISTORY
214: .Nm
215: is based on the
216: .Xr rcp 1
217: program in BSD source code from the Regents of the University of
218: California.
219: .Sh AUTHORS
220: .An Timo Rinne Aq tri@iki.fi
221: .An Tatu Ylonen Aq ylo@cs.hut.fi