Annotation of src/usr.bin/ssh/scp.1, Revision 1.10
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.10 ! deraadt 12: .\" $Id: scp.1,v 1.9 2000/08/19 02:26:08 deraadt 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.5 markus 22: .Op Fl pqrvC46
1.10 ! deraadt 23: .Op Fl S Ar program
1.3 aaron 24: .Op Fl P Ar port
25: .Op Fl c Ar cipher
26: .Op Fl i Ar identity_file
27: .Sm off
28: .Oo
29: .Op Ar user@
30: .Ar host1 No :
31: .Oc Ns Ar file1
32: .Sm on
33: .Op Ar ...
34: .Sm off
35: .Oo
36: .Op Ar user@
37: .Ar host2 No :
38: .Oc Ar file2
39: .Sm on
1.7 aaron 40: .Sh DESCRIPTION
1.3 aaron 41: .Nm
1.6 aaron 42: copies files between hosts on a network.
43: It uses
1.3 aaron 44: .Xr ssh 1
1.1 deraadt 45: for data transfer, and uses the same authentication and provides the
46: same security as
1.3 aaron 47: .Xr ssh 1 .
1.1 deraadt 48: Unlike
1.3 aaron 49: .Xr rcp 1 ,
50: .Nm
1.1 deraadt 51: will ask for passwords or passphrases if they are needed for
52: authentication.
1.3 aaron 53: .Pp
1.1 deraadt 54: Any file name may contain a host and user specification to indicate
1.6 aaron 55: that the file is to be copied to/from that host.
56: Copies between two remote hosts are permitted.
1.3 aaron 57: .Pp
58: The options are as follows:
59: .Bl -tag -width Ds
60: .It Fl c Ar cipher
1.6 aaron 61: Selects the cipher to use for encrypting the data transfer.
62: This option is directly passed to
1.3 aaron 63: .Xr ssh 1 .
64: .It Fl i Ar identity_file
1.1 deraadt 65: Selects the file from which the identity (private key) for RSA
1.6 aaron 66: authentication is read.
67: This option is directly passed to
1.3 aaron 68: .Xr ssh 1 .
69: .It Fl p
1.1 deraadt 70: Preserves modification times, access times, and modes from the
71: original file.
1.3 aaron 72: .It Fl r
1.1 deraadt 73: Recursively copy entire directories.
1.3 aaron 74: .It Fl v
1.6 aaron 75: Verbose mode.
76: Causes
1.3 aaron 77: .Nm
1.7 aaron 78: and
1.3 aaron 79: .Xr ssh 1
1.6 aaron 80: to print debugging messages about their progress.
81: This is helpful in
1.1 deraadt 82: debugging connection, authentication, and configuration problems.
1.3 aaron 83: .It Fl B
1.1 deraadt 84: Selects batch mode (prevents asking for passwords or passphrases).
1.3 aaron 85: .It Fl q
1.2 aaron 86: Disables the progress meter.
1.3 aaron 87: .It Fl C
1.6 aaron 88: Compression enable.
89: Passes the
1.3 aaron 90: .Fl C
91: flag to
92: .Xr ssh 1
1.1 deraadt 93: to enable compression.
1.4 markus 94: .It Fl P Ar port
1.6 aaron 95: Specifies the port to connect to on the remote host.
96: Note that this option is written with a capital
1.3 aaron 97: .Sq P ,
98: because
99: .Fl p
100: is already reserved for preserving the times and modes of the file in
101: .Xr rcp 1 .
1.10 ! deraadt 102: .It Fl S Ar program
! 103: Name of
! 104: .Ar program
! 105: to use for the encrypted connection. The program must understand
1.9 deraadt 106: .Xr ssh 1
107: options.
1.5 markus 108: .It Fl 4
109: Forces
110: .Nm
111: to use IPv4 addresses only.
112: .It Fl 6
113: Forces
114: .Nm
115: to use IPv6 addresses only.
1.8 aaron 116: .El
1.3 aaron 117: .Sh AUTHORS
1.1 deraadt 118: Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>
1.3 aaron 119: .Sh HISTORY
120: .Nm
1.1 deraadt 121: is based on the
1.3 aaron 122: .Xr rcp 1
1.1 deraadt 123: program in BSD source code from the Regents of the University of
124: California.
1.3 aaron 125: .Sh SEE ALSO
126: .Xr rcp 1 ,
127: .Xr ssh 1 ,
128: .Xr ssh-add 1 ,
129: .Xr ssh-agent 1 ,
130: .Xr ssh-keygen 1 ,
131: .Xr sshd 8