| 1 | SCP(1) System General Commands Manual SCP(1) |
|---|
| 2 | |
|---|
| 3 | NAME |
|---|
| 4 | scp - secure copy (remote file copy program) |
|---|
| 5 | |
|---|
| 6 | SYNOPSIS |
|---|
| 7 | scp [-pqrvBC46] [-F ssh_config] [-S program] [-P port] [-c cipher] |
|---|
| 8 | [-i identity_file] [-o ssh_option] [[user@]host1:]file1 [...] |
|---|
| 9 | [[user@]host2:]file2 |
|---|
| 10 | |
|---|
| 11 | DESCRIPTION |
|---|
| 12 | scp copies files between hosts on a network. It uses ssh(1) for data |
|---|
| 13 | transfer, and uses the same authentication and provides the same security |
|---|
| 14 | as ssh(1). Unlike rcp(1), scp will ask for passwords or passphrases if |
|---|
| 15 | they are needed for authentication. |
|---|
| 16 | |
|---|
| 17 | Any file name may contain a host and user specification to indicate that |
|---|
| 18 | the file is to be copied to/from that host. Copies between two remote |
|---|
| 19 | hosts are permitted. |
|---|
| 20 | |
|---|
| 21 | The options are as follows: |
|---|
| 22 | |
|---|
| 23 | -c cipher |
|---|
| 24 | Selects the cipher to use for encrypting the data transfer. This |
|---|
| 25 | option is directly passed to ssh(1). |
|---|
| 26 | |
|---|
| 27 | -i identity_file |
|---|
| 28 | Selects the file from which the identity (private key) for RSA |
|---|
| 29 | authentication is read. This option is directly passed to |
|---|
| 30 | ssh(1). |
|---|
| 31 | |
|---|
| 32 | -p Preserves modification times, access times, and modes from the |
|---|
| 33 | original file. |
|---|
| 34 | |
|---|
| 35 | -r Recursively copy entire directories. |
|---|
| 36 | |
|---|
| 37 | -v Verbose mode. Causes scp and ssh(1) to print debugging messages |
|---|
| 38 | about their progress. This is helpful in debugging connection, |
|---|
| 39 | authentication, and configuration problems. |
|---|
| 40 | |
|---|
| 41 | -B Selects batch mode (prevents asking for passwords or |
|---|
| 42 | passphrases). |
|---|
| 43 | |
|---|
| 44 | -q Disables the progress meter. |
|---|
| 45 | |
|---|
| 46 | -C Compression enable. Passes the -C flag to ssh(1) to enable comM-- |
|---|
| 47 | pression. |
|---|
| 48 | |
|---|
| 49 | -F ssh_config |
|---|
| 50 | Specifies an alternative per-user configuration file for ssh. |
|---|
| 51 | This option is directly passed to ssh(1). |
|---|
| 52 | |
|---|
| 53 | -P port |
|---|
| 54 | Specifies the port to connect to on the remote host. Note that |
|---|
| 55 | this option is written with a capital `P', because -p is already |
|---|
| 56 | reserved for preserving the times and modes of the file in |
|---|
| 57 | rcp(1). |
|---|
| 58 | |
|---|
| 59 | -S program |
|---|
| 60 | Name of program to use for the encrypted connection. The program |
|---|
| 61 | must understand ssh(1) options. |
|---|
| 62 | |
|---|
| 63 | -o ssh_option |
|---|
| 64 | Can be used to pass options to ssh in the format used in |
|---|
| 65 | ssh_config(5). This is useful for specifying options for which |
|---|
| 66 | there is no separate scp command-line flag. For example, forcing |
|---|
| 67 | the use of protocol version 1 is specified using scp |
|---|
| 68 | -oProtocol=1. |
|---|
| 69 | |
|---|
| 70 | -4 Forces scp to use IPv4 addresses only. |
|---|
| 71 | |
|---|
| 72 | -6 Forces scp to use IPv6 addresses only. |
|---|
| 73 | |
|---|
| 74 | DIAGNOSTICS |
|---|
| 75 | scp exits with 0 on success or >0 if an error occurred. |
|---|
| 76 | |
|---|
| 77 | AUTHORS |
|---|
| 78 | Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi> |
|---|
| 79 | |
|---|
| 80 | HISTORY |
|---|
| 81 | scp is based on the rcp(1) program in BSD source code from the Regents of |
|---|
| 82 | the University of California. |
|---|
| 83 | |
|---|
| 84 | SEE ALSO |
|---|
| 85 | rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), |
|---|
| 86 | ssh_config(5), sshd(8) |
|---|
| 87 | |
|---|
| 88 | BSD September 25, 1999 BSD |
|---|
