1 SCP(1) OpenBSD Reference Manual SCP(1) 2 3 NAME 4 scp - secure copy (remote file copy program) 5 6 SYNOPSIS 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 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 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 GlobalKnownHostsFile 81 GSSAPIAuthentication 82 GSSAPIDelegateCredentials 83 HashKnownHosts 84 Host 85 HostbasedAuthentication 86 HostKeyAlgorithms 87 HostKeyAlias 88 HostName 89 IdentityFile 90 IdentitiesOnly 91 IPQoS 92 KbdInteractiveDevices 93 KexAlgorithms 94 LogLevel 95 MACs 96 NoHostAuthenticationForLocalhost 97 NumberOfPasswordPrompts 98 PasswordAuthentication 99 PKCS11Provider 100 Port 101 PreferredAuthentications 102 Protocol 103 ProxyCommand 104 PubkeyAuthentication 105 RekeyLimit 106 RhostsRSAAuthentication 107 RSAAuthentication 108 SendEnv 109 ServerAliveInterval 110 ServerAliveCountMax 111 StrictHostKeyChecking 112 TCPKeepAlive 113 UsePrivilegedPort 114 User 115 UserKnownHostsFile 116 VerifyHostKeyDNS 117 118 -P port 119 Specifies the port to connect to on the remote host. Note that 120 this option is written with a capital `P', because -p is already 121 reserved for preserving the times and modes of the file in 122 rcp(1). 123 124 -p Preserves modification times, access times, and modes from the 125 original file. 126 127 -q Quiet mode: disables the progress meter as well as warning and 128 diagnostic messages from ssh(1). 129 130 -r Recursively copy entire directories. Note that scp follows 131 symbolic links encountered in the tree traversal. 132 133 -S program 134 Name of program to use for the encrypted connection. The program 135 must understand ssh(1) options. 136 137 -v Verbose mode. Causes scp and ssh(1) to print debugging messages 138 about their progress. This is helpful in debugging connection, 139 authentication, and configuration problems. 140 141 EXIT STATUS 142 The scp utility exits 0 on success, and >0 if an error occurs. 143 144 SEE ALSO 145 rcp(1), sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), 146 ssh_config(5), sshd(8) 147 148 HISTORY 149 scp is based on the rcp(1) program in BSD source code from the Regents of 150 the University of California. 151 152 AUTHORS 153 Timo Rinne <tri (a] iki.fi> 154 Tatu Ylonen <ylo (a] cs.hut.fi> 155 156 OpenBSD 5.0 December 9, 2010 OpenBSD 5.0 157
