157 lines
3.2 KiB
Groff
157 lines
3.2 KiB
Groff
.\" -*- nroff -*-
|
|
.\"
|
|
.\" scp.1
|
|
.\"
|
|
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
|
|
.\"
|
|
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
|
|
.\" All rights reserved
|
|
.\"
|
|
.\" Created: Sun May 7 00:14:37 1995 ylo
|
|
.\"
|
|
.\" $OpenBSD: scp.1,v 1.22 2002/06/20 20:00:05 stevesk Exp $
|
|
.\"
|
|
.Dd September 25, 1999
|
|
.Dt SCP 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm scp
|
|
.Nd secure copy (remote file copy program)
|
|
.Sh SYNOPSIS
|
|
.Nm scp
|
|
.Op Fl pqrvBC46
|
|
.Op Fl F Ar ssh_config
|
|
.Op Fl S Ar program
|
|
.Op Fl P Ar port
|
|
.Op Fl c Ar cipher
|
|
.Op Fl i Ar identity_file
|
|
.Op Fl o Ar ssh_option
|
|
.Sm off
|
|
.Oo
|
|
.Op Ar user@
|
|
.Ar host1 No :
|
|
.Oc Ns Ar file1
|
|
.Sm on
|
|
.Op Ar ...
|
|
.Sm off
|
|
.Oo
|
|
.Op Ar user@
|
|
.Ar host2 No :
|
|
.Oc Ar file2
|
|
.Sm on
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
copies files between hosts on a network.
|
|
It uses
|
|
.Xr ssh 1
|
|
for data transfer, and uses the same authentication and provides the
|
|
same security as
|
|
.Xr ssh 1 .
|
|
Unlike
|
|
.Xr rcp 1 ,
|
|
.Nm
|
|
will ask for passwords or passphrases if they are needed for
|
|
authentication.
|
|
.Pp
|
|
Any file name may contain a host and user specification to indicate
|
|
that the file is to be copied to/from that host.
|
|
Copies between two remote hosts are permitted.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl c Ar cipher
|
|
Selects the cipher to use for encrypting the data transfer.
|
|
This option is directly passed to
|
|
.Xr ssh 1 .
|
|
.It Fl i Ar identity_file
|
|
Selects the file from which the identity (private key) for RSA
|
|
authentication is read.
|
|
This option is directly passed to
|
|
.Xr ssh 1 .
|
|
.It Fl p
|
|
Preserves modification times, access times, and modes from the
|
|
original file.
|
|
.It Fl r
|
|
Recursively copy entire directories.
|
|
.It Fl v
|
|
Verbose mode.
|
|
Causes
|
|
.Nm
|
|
and
|
|
.Xr ssh 1
|
|
to print debugging messages about their progress.
|
|
This is helpful in
|
|
debugging connection, authentication, and configuration problems.
|
|
.It Fl B
|
|
Selects batch mode (prevents asking for passwords or passphrases).
|
|
.It Fl q
|
|
Disables the progress meter.
|
|
.It Fl C
|
|
Compression enable.
|
|
Passes the
|
|
.Fl C
|
|
flag to
|
|
.Xr ssh 1
|
|
to enable compression.
|
|
.It Fl F Ar ssh_config
|
|
Specifies an alternative
|
|
per-user configuration file for
|
|
.Nm ssh .
|
|
This option is directly passed to
|
|
.Xr ssh 1 .
|
|
.It Fl P Ar port
|
|
Specifies the port to connect to on the remote host.
|
|
Note that this option is written with a capital
|
|
.Sq P ,
|
|
because
|
|
.Fl p
|
|
is already reserved for preserving the times and modes of the file in
|
|
.Xr rcp 1 .
|
|
.It Fl S Ar program
|
|
Name of
|
|
.Ar program
|
|
to use for the encrypted connection.
|
|
The program must understand
|
|
.Xr ssh 1
|
|
options.
|
|
.It Fl o Ar ssh_option
|
|
Can be used to pass options to
|
|
.Nm ssh
|
|
in the format used in
|
|
.Xr ssh_config 5 .
|
|
This is useful for specifying options
|
|
for which there is no separate
|
|
.Nm scp
|
|
command-line flag. For example, forcing the use of protocol
|
|
version 1 is specified using
|
|
.Ic scp -oProtocol=1 .
|
|
.It Fl 4
|
|
Forces
|
|
.Nm
|
|
to use IPv4 addresses only.
|
|
.It Fl 6
|
|
Forces
|
|
.Nm
|
|
to use IPv6 addresses only.
|
|
.El
|
|
.Sh DIAGNOSTICS
|
|
.Nm
|
|
exits with 0 on success or >0 if an error occurred.
|
|
.Sh AUTHORS
|
|
Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>
|
|
.Sh HISTORY
|
|
.Nm
|
|
is based on the
|
|
.Xr rcp 1
|
|
program in BSD source code from the Regents of the University of
|
|
California.
|
|
.Sh SEE ALSO
|
|
.Xr rcp 1 ,
|
|
.Xr sftp 1 ,
|
|
.Xr ssh 1 ,
|
|
.Xr ssh-add 1 ,
|
|
.Xr ssh-agent 1 ,
|
|
.Xr ssh-keygen 1 ,
|
|
.Xr ssh_config 5
|
|
.Xr sshd 8
|