1SCP(1) OpenBSD Reference Manual SCP(1) 2 3NAME 4 scp - secure copy (remote file copy program) 5 6SYNOPSIS 7 scp [-12346BCpqrv] [-c cipher] [-F ssh_config] [-i identity_file] 8 [-l limit] [-o ssh_option] [-P port] [-S program] 9 [[user@]host1:]file1 ... [[user@]host2:]file2 10 11DESCRIPTION 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 File names may contain a user and host specification to indicate that the 18 file is to be copied to/from that host. Local file names can be made 19 explicit using absolute or relative pathnames to avoid scp treating file 20 names containing `:' as host specifiers. Copies between two remote hosts 21 are also permitted. 22 23 The options are as follows: 24 25 -1 Forces scp to use protocol 1. 26 27 -2 Forces scp to use protocol 2. 28 29 -3 Copies between two remote hosts are transferred through the local 30 host. Without this option the data is copied directly between 31 the two remote hosts. Note that this option disables the 32 progress meter. 33 34 -4 Forces scp to use IPv4 addresses only. 35 36 -6 Forces scp to use IPv6 addresses only. 37 38 -B Selects batch mode (prevents asking for passwords or 39 passphrases). 40 41 -C Compression enable. Passes the -C flag to ssh(1) to enable 42 compression. 43 44 -c cipher 45 Selects the cipher to use for encrypting the data transfer. This 46 option is directly passed to ssh(1). 47 48 -F ssh_config 49 Specifies an alternative per-user configuration file for ssh. 50 This option is directly passed to ssh(1). 51 52 -i identity_file 53 Selects the file from which the identity (private key) for public 54 key authentication is read. This option is directly passed to 55 ssh(1). 56 57 -l limit 58 Limits the used bandwidth, specified in Kbit/s. 59 60 -o ssh_option 61 Can be used to pass options to ssh in the format used in 62 ssh_config(5). This is useful for specifying options for which 63 there is no separate scp command-line flag. For full details of 64 the options listed below, and their possible values, see 65 ssh_config(5). 66 67 AddressFamily 68 BatchMode 69 BindAddress 70 ChallengeResponseAuthentication 71 CheckHostIP 72 Cipher 73 Ciphers 74 Compression 75 CompressionLevel 76 ConnectionAttempts 77 ConnectTimeout 78 ControlMaster 79 ControlPath 80 ControlPersist 81 GlobalKnownHostsFile 82 GSSAPIAuthentication 83 GSSAPIDelegateCredentials 84 HashKnownHosts 85 Host 86 HostbasedAuthentication 87 HostKeyAlgorithms 88 HostKeyAlias 89 HostName 90 IdentityFile 91 IdentitiesOnly 92 IPQoS 93 KbdInteractiveAuthentication 94 KbdInteractiveDevices 95 KexAlgorithms 96 LogLevel 97 MACs 98 NoHostAuthenticationForLocalhost 99 NumberOfPasswordPrompts 100 PasswordAuthentication 101 PKCS11Provider 102 Port 103 PreferredAuthentications 104 Protocol 105 ProxyCommand 106 PubkeyAuthentication 107 RekeyLimit 108 RhostsRSAAuthentication 109 RSAAuthentication 110 SendEnv 111 ServerAliveInterval 112 ServerAliveCountMax 113 StrictHostKeyChecking 114 TCPKeepAlive 115 UsePrivilegedPort 116 User 117 UserKnownHostsFile 118 VerifyHostKeyDNS 119 120 -P port 121 Specifies the port to connect to on the remote host. Note that 122 this option is written with a capital `P', because -p is already 123 reserved for preserving the times and modes of the file in 124 rcp(1). 125 126 -p Preserves modification times, access times, and modes from the 127 original file. 128 129 -q Quiet mode: disables the progress meter as well as warning and 130 diagnostic messages from ssh(1). 131 132 -r Recursively copy entire directories. Note that scp follows 133 symbolic links encountered in the tree traversal. 134 135 -S program 136 Name of program to use for the encrypted connection. The program 137 must understand ssh(1) options. 138 139 -v Verbose mode. Causes scp and ssh(1) to print debugging messages 140 about their progress. This is helpful in debugging connection, 141 authentication, and configuration problems. 142 143EXIT STATUS 144 The scp utility exits 0 on success, and >0 if an error occurs. 145 146SEE ALSO 147 rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), 148 ssh_config(5), sshd(8) 149 150HISTORY 151 scp is based on the rcp(1) program in BSD source code from the Regents of 152 the University of California. 153 154AUTHORS 155 Timo Rinne <tri@iki.fi> 156 Tatu Ylonen <ylo@cs.hut.fi> 157 158OpenBSD 5.4 July 16, 2013 OpenBSD 5.4 159