scp -- secure copy (remote file copy program)

SYNOPSIS

scp [-pqrvBC1246] [-F ssh_config] [-S program] [-P port] [-c cipher] [-i identity_file] [-o option] [-l limit] [[user@]host1:]file1 [...] [[user@]host2:]file2

DESCRIPTION

scp copies files between hosts on a network. It uses secsh for data transfer, and uses the same authentication and provides the same security as secsh. Unlike rcp, scp will ask for passwords or passphrases if they are needed for authentication.

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.

-1

Forces scp to use protocol 1.

-2

Forces scp to use protocol 2.

-4

Forces scp to use IPv4 addresses only.

-6

Forces scp to use IPv6 addresses only.

-B

Selects batch mode (prevents asking for passwords or passphrases).

-c cypher

Selects the cipher to use for encrypting the data transfer. This option is directly passed to secsh.

-i identity_file

Selects the file from which the identity (private key) for RSA authentication is read. This option is directly passed to secsh.

-l limit

Limits the used bandwith to a specified limit, given in Kbit/s.

-p

Preserves modification times, access times, and modes from the original file.

-q

Disables the progress meter.

-r

Recursively copies entire directories.

-v

Verbose mode. Causes scp and secsh to print debugging messages about their progress. This is helpful in debugging connection, authentication, and configuration problems.

-B

Selects batch mode (prevents asking for passwords or passphrases).

-q

Disables the progress meter.

-C

Enables compression. Passes the -C flag to secsh to enable compression.

-F ssh_config

Specifies an alternative per-user configuration file for secsh. This option is directly passed to secsh.

-P port

Specifies the port to connect to on the remote host. Note that this option is written with a capital P, because -p is already reserved for preserving the times and modes of the file in rcp.

-S program

Specifies the name of the program to use for the encrypted connection. The program must understand secsh options.

-o option

Any valid -o option to secsh can be specified, and it is directly passed through when secsh is invoked. This is useful for specifying options for which there is no separate scp command-line flag. For example, forcing the use of protocol version 1 is specified using:

scp -oProtocol=1

-4

Forces scp to use IPv4 addresses only.

-6

Forces scp to use IPv6 addresses only.

AUTHORS

Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>

HISTORY

scpis based on the rcp program in BSD source code from the Regents of the University of California.

PORTABILITY

All UNIX systems. Windows 2000. Windows XP. Windows Server 2003. Windows Vista. Windows 7. Windows Server 2008.

NOTES

Secure copy only works when connecting to a machine that is running an OpenSSH derived secure shell service. The ssh.com version of the scp utility is instead based upon the sftp protocol. When using machines running the ssh.com version of the service, the sftp client is your only file transfer option.

The secure copy client does not handle wildcards. Multiple files must be copied individually.

AVAILABILITY

MKS Toolkit for System Administrators
MKS Toolkit for Developers
MKS Toolkit for Interoperability
MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

scp
secure copy (remote file copy program)

Command