[BACK]Return to scp.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / ssh

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