Annotation of src/usr.bin/ssh/scp.1, Revision 1.3
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.3 ! aaron 12: .\" $Id: scp.1,v 1.2 1999/09/30 21:25:03 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.3 ! aaron 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