.\"  -*- nroff -*-.\".\" 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.27 2003/03/28 10:11:43 jmc Exp $.\".Dd September 25, 1999.Dt SCP 1.Os.Sh NAME.Nm scp.Nd secure copy (remote file copy program).Sh SYNOPSIS.Nm scp.Bk -words.Op Fl pqrvBC1246.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 l Ar limit.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.Ek.Sh DESCRIPTION.Nmcopies files between hosts on a network.It uses.Xr ssh 1for data transfer, and uses the same authentication and provides thesame security as.Xr ssh 1 .Unlike.Xr rcp 1 ,.Nmwill ask for passwords or passphrases if they are needed forauthentication..PpAny file name may contain a host and user specification to indicatethat the file is to be copied to/from that host.Copies between two remote hosts are permitted..PpThe options are as follows:.Bl -tag -width Ds.It Fl c Ar cipherSelects the cipher to use for encrypting the data transfer.This option is directly passed to.Xr ssh 1 ..It Fl i Ar identity_fileSelects the file from which the identity (private key) for RSAauthentication is read.This option is directly passed to.Xr ssh 1 ..It Fl l Ar limitLimits the used bandwidth, specified in Kbit/s..It Fl pPreserves modification times, access times, and modes from theoriginal file..It Fl rRecursively copy entire directories..It Fl vVerbose mode.Causes.Nmand.Xr ssh 1to print debugging messages about their progress.This is helpful indebugging connection, authentication, and configuration problems..It Fl BSelects batch mode (prevents asking for passwords or passphrases)..It Fl qDisables the progress meter..It Fl CCompression enable.Passes the.Fl Cflag to.Xr ssh 1to enable compression..It Fl F Ar ssh_configSpecifies an alternativeper-user configuration file for.Nm ssh .This option is directly passed to.Xr ssh 1 ..It Fl P Ar portSpecifies the port to connect to on the remote host.Note that this option is written with a capital.Sq P ,because.Fl pis already reserved for preserving the times and modes of the file in.Xr rcp 1 ..It Fl S Ar programName of.Ar programto use for the encrypted connection.The program must understand.Xr ssh 1options..It Fl o Ar ssh_optionCan be used to pass options to.Nm sshin the format used in.Xr ssh_config 5 .This is useful for specifying optionsfor which there is no separate.Nm scpcommand-line flag..It Fl 1Forces.Nmto use protocol 1..It Fl 2Forces.Nmto use protocol 2..It Fl 4Forces.Nmto use IPv4 addresses only..It Fl 6Forces.Nmto use IPv6 addresses only..El.Sh DIAGNOSTICS.Nmexits with 0 on success or >0 if an error occurred..Sh AUTHORSTimo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>.Sh HISTORY.Nmis based on the.Xr rcp 1program in BSD source code from the Regents of the University ofCalifornia..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