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