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.23 2002/06/22 16:41:57 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.
p 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.
p The options are as follows: l -tag -width Ds t Fl c Ar cipher Selects the cipher to use for encrypting the data transfer. This option is directly passed to .Xr ssh 1 . t 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 . t Fl p Preserves modification times, access times, and modes from the original file. t Fl r Recursively copy entire directories. t 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. t Fl B Selects batch mode (prevents asking for passwords or passphrases). t Fl q Disables the progress meter. t Fl C Compression enable. Passes the .Fl C flag to .Xr ssh 1 to enable compression. t Fl F Ar ssh_config Specifies an alternative per-user configuration file for .Nm ssh . This option is directly passed to .Xr ssh 1 . t 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 . t Fl S Ar program Name of .Ar program to use for the encrypted connection. The program must understand .Xr ssh 1 options. t 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 c scp -oProtocol=1 . t Fl 4 Forces .Nm to use IPv4 addresses only. t 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