andersk Git - openssh.git/blame_incremental

... / ...

Commit	Line	Data
	1	.\" -- nroff --
	2	.\"
	3	.\" scp.1
	4	.\"
	5	.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
	6	.\"
	7	.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
	8	.\" All rights reserved
	9	.\"
	10	.\" Created: Sun May 7 00:14:37 1995 ylo
	11	.\"
	12	.\" $OpenBSD: scp.1,v 1.49 2010/01/09 23:04:13 dtucker Exp $
	13	.\"
	14	.Dd $Mdocdate$
	15	.Dt SCP 1
	16	.Os
	17	.Sh NAME
	18	.Nm scp
	19	.Nd secure copy (remote file copy program)
	20	.Sh SYNOPSIS
	21	.Nm scp
	22	.Bk -words
	23	.Op Fl 1246BCpqrv
	24	.Op Fl c Ar cipher
	25	.Op Fl F Ar ssh_config
	26	.Op Fl i Ar identity_file
	27	.Op Fl l Ar limit
	28	.Op Fl o Ar ssh_option
	29	.Op Fl P Ar port
	30	.Op Fl S Ar program
	31	.Sm off
	32	.Oo
	33	.Op Ar user No @
	34	.Ar host1 No :
	35	.Oc Ns Ar file1
	36	.Sm on
	37	.Ar ...
	38	.Sm off
	39	.Oo
	40	.Op Ar user No @
	41	.Ar host2 No :
	42	.Oc Ar file2
	43	.Sm on
	44	.Ek
	45	.Sh DESCRIPTION
	46	.Nm
	47	copies files between hosts on a network.
	48	It uses
	49	.Xr ssh 1
	50	for data transfer, and uses the same authentication and provides the
	51	same security as
	52	.Xr ssh 1 .
	53	Unlike
	54	.Xr rcp 1 ,
	55	.Nm
	56	will ask for passwords or passphrases if they are needed for
	57	authentication.
	58	.Pp
	59	File names may contain a user and host specification to indicate
	60	that the file is to be copied to/from that host.
	61	Local file names can be made explicit using absolute or relative pathnames
	62	to avoid
	63	.Nm
	64	treating file names containing
	65	.Sq :\&
	66	as host specifiers.
	67	Copies between two remote hosts are also permitted.
	68	.Pp
	69	The options are as follows:
	70	.Bl -tag -width Ds
	71	.It Fl 1
	72	Forces
	73	.Nm
	74	to use protocol 1.
	75	.It Fl 2
	76	Forces
	77	.Nm
	78	to use protocol 2.
	79	.It Fl 4
	80	Forces
	81	.Nm
	82	to use IPv4 addresses only.
	83	.It Fl 6
	84	Forces
	85	.Nm
	86	to use IPv6 addresses only.
	87	.It Fl B
	88	Selects batch mode (prevents asking for passwords or passphrases).
	89	.It Fl C
	90	Compression enable.
	91	Passes the
	92	.Fl C
	93	flag to
	94	.Xr ssh 1
	95	to enable compression.
	96	.It Fl c Ar cipher
	97	Selects the cipher to use for encrypting the data transfer.
	98	This option is directly passed to
	99	.Xr ssh 1 .
	100	.It Fl F Ar ssh_config
	101	Specifies an alternative
	102	per-user configuration file for
	103	.Nm ssh .
	104	This option is directly passed to
	105	.Xr ssh 1 .
	106	.It Fl i Ar identity_file
	107	Selects the file from which the identity (private key) for public key
	108	authentication is read.
	109	This option is directly passed to
	110	.Xr ssh 1 .
	111	.It Fl l Ar limit
	112	Limits the used bandwidth, specified in Kbit/s.
	113	.It Fl o Ar ssh_option
	114	Can be used to pass options to
	115	.Nm ssh
	116	in the format used in
	117	.Xr ssh_config 5 .
	118	This is useful for specifying options
	119	for which there is no separate
	120	.Nm scp
	121	command-line flag.
	122	For full details of the options listed below, and their possible values, see
	123	.Xr ssh_config 5 .
	124	.Pp
	125	.Bl -tag -width Ds -offset indent -compact
	126	.It AddressFamily
	127	.It BatchMode
	128	.It BindAddress
	129	.It ChallengeResponseAuthentication
	130	.It CheckHostIP
	131	.It Cipher
	132	.It Ciphers
	133	.It Compression
	134	.It CompressionLevel
	135	.It ConnectionAttempts
	136	.It ConnectTimeout
	137	.It ControlMaster
	138	.It ControlPath
	139	.It GlobalKnownHostsFile
	140	.It GSSAPIAuthentication
	141	.It GSSAPIDelegateCredentials
	142	.It HashKnownHosts
	143	.It Host
	144	.It HostbasedAuthentication
	145	.It HostKeyAlgorithms
	146	.It HostKeyAlias
	147	.It HostName
	148	.It IdentityFile
	149	.It IdentitiesOnly
	150	.It KbdInteractiveDevices
	151	.It LogLevel
	152	.It MACs
	153	.It NoHostAuthenticationForLocalhost
	154	.It NumberOfPasswordPrompts
	155	.It PasswordAuthentication
	156	.It Port
	157	.It PreferredAuthentications
	158	.It Protocol
	159	.It ProxyCommand
	160	.It PubkeyAuthentication
	161	.It RekeyLimit
	162	.It RhostsRSAAuthentication
	163	.It RSAAuthentication
	164	.It SendEnv
	165	.It ServerAliveInterval
	166	.It ServerAliveCountMax
	167	.It SmartcardDevice
	168	.It StrictHostKeyChecking
	169	.It TCPKeepAlive
	170	.It UsePrivilegedPort
	171	.It User
	172	.It UserKnownHostsFile
	173	.It VerifyHostKeyDNS
	174	.El
	175	.It Fl P Ar port
	176	Specifies the port to connect to on the remote host.
	177	Note that this option is written with a capital
	178	.Sq P ,
	179	because
	180	.Fl p
	181	is already reserved for preserving the times and modes of the file in
	182	.Xr rcp 1 .
	183	.It Fl p
	184	Preserves modification times, access times, and modes from the
	185	original file.
	186	.It Fl q
	187	Quiet mode: disables the progress meter as well as warning and diagnostic
	188	messages from
	189	.Xr ssh 1 .
	190	.It Fl r
	191	Recursively copy entire directories.
	192	Note that
	193	.Nm
	194	follows symbolic links encountered in the tree traversal.
	195	.It Fl S Ar program
	196	Name of
	197	.Ar program
	198	to use for the encrypted connection.
	199	The program must understand
	200	.Xr ssh 1
	201	options.
	202	.It Fl v
	203	Verbose mode.
	204	Causes
	205	.Nm
	206	and
	207	.Xr ssh 1
	208	to print debugging messages about their progress.
	209	This is helpful in
	210	debugging connection, authentication, and configuration problems.
	211	.El
	212	.Pp
	213	.Ex -std scp
	214	.Sh SEE ALSO
	215	.Xr rcp 1 ,
	216	.Xr sftp 1 ,
	217	.Xr ssh 1 ,
	218	.Xr ssh-add 1 ,
	219	.Xr ssh-agent 1 ,
	220	.Xr ssh-keygen 1 ,
	221	.Xr ssh_config 5 ,
	222	.Xr sshd 8
	223	.Sh HISTORY
	224	.Nm
	225	is based on the
	226	.Xr rcp 1
	227	program in BSD source code from the Regents of the University of
	228	California.
	229	.Sh AUTHORS
	230	.An Timo Rinne Aq tri@iki.fi
	231	.An Tatu Ylonen Aq ylo@cs.hut.fi