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.35 2004/05/04 18:36:07 jmc Exp $
	13	.\"
	14	.Dd September 25, 1999
	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	.Op 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	Any file name may contain a host and user specification to indicate
	60	that the file is to be copied to/from that host.
	61	Copies between two remote hosts are permitted.
	62	.Pp
	63	The options are as follows:
	64	.Bl -tag -width Ds
	65	.It Fl 1
	66	Forces
	67	.Nm
	68	to use protocol 1.
	69	.It Fl 2
	70	Forces
	71	.Nm
	72	to use protocol 2.
	73	.It Fl 4
	74	Forces
	75	.Nm
	76	to use IPv4 addresses only.
	77	.It Fl 6
	78	Forces
	79	.Nm
	80	to use IPv6 addresses only.
	81	.It Fl B
	82	Selects batch mode (prevents asking for passwords or passphrases).
	83	.It Fl C
	84	Compression enable.
	85	Passes the
	86	.Fl C
	87	flag to
	88	.Xr ssh 1
	89	to enable compression.
	90	.It Fl c Ar cipher
	91	Selects the cipher to use for encrypting the data transfer.
	92	This option is directly passed to
	93	.Xr ssh 1 .
	94	.It Fl F Ar ssh_config
	95	Specifies an alternative
	96	per-user configuration file for
	97	.Nm ssh .
	98	This option is directly passed to
	99	.Xr ssh 1 .
	100	.It Fl i Ar identity_file
	101	Selects the file from which the identity (private key) for RSA
	102	authentication is read.
	103	This option is directly passed to
	104	.Xr ssh 1 .
	105	.It Fl l Ar limit
	106	Limits the used bandwidth, specified in Kbit/s.
	107	.It Fl o Ar ssh_option
	108	Can be used to pass options to
	109	.Nm ssh
	110	in the format used in
	111	.Xr ssh_config 5 .
	112	This is useful for specifying options
	113	for which there is no separate
	114	.Nm scp
	115	command-line flag.
	116	For full details of the options listed below, and their possible values, see
	117	.Xr ssh_config 5 .
	118	.Pp
	119	.Bl -tag -width Ds -offset indent -compact
	120	.It AddressFamily
	121	.It BatchMode
	122	.It BindAddress
	123	.It ChallengeResponseAuthentication
	124	.It CheckHostIP
	125	.It Cipher
	126	.It Ciphers
	127	.It Compression
	128	.It CompressionLevel
	129	.It ConnectionAttempts
	130	.It ConnectTimeout
	131	.It GlobalKnownHostsFile
	132	.It GSSAPIAuthentication
	133	.It GSSAPIDelegateCredentials
	134	.It Host
	135	.It HostbasedAuthentication
	136	.It HostKeyAlgorithms
	137	.It HostKeyAlias
	138	.It HostName
	139	.It IdentityFile
	140	.It IdentitiesOnly
	141	.It LogLevel
	142	.It MACs
	143	.It NoHostAuthenticationForLocalhost
	144	.It NumberOfPasswordPrompts
	145	.It PasswordAuthentication
	146	.It Port
	147	.It PreferredAuthentications
	148	.It Protocol
	149	.It ProxyCommand
	150	.It PubkeyAuthentication
	151	.It RhostsRSAAuthentication
	152	.It RSAAuthentication
	153	.It SendEnv
	154	.It ServerAliveInterval
	155	.It ServerAliveCountMax
	156	.It SmartcardDevice
	157	.It StrictHostKeyChecking
	158	.It TCPKeepAlive
	159	.It UsePrivilegedPort
	160	.It User
	161	.It UserKnownHostsFile
	162	.It VerifyHostKeyDNS
	163	.El
	164	.It Fl P Ar port
	165	Specifies the port to connect to on the remote host.
	166	Note that this option is written with a capital
	167	.Sq P ,
	168	because
	169	.Fl p
	170	is already reserved for preserving the times and modes of the file in
	171	.Xr rcp 1 .
	172	.It Fl p
	173	Preserves modification times, access times, and modes from the
	174	original file.
	175	.It Fl q
	176	Disables the progress meter.
	177	.It Fl r
	178	Recursively copy entire directories.
	179	.It Fl S Ar program
	180	Name of
	181	.Ar program
	182	to use for the encrypted connection.
	183	The program must understand
	184	.Xr ssh 1
	185	options.
	186	.It Fl v
	187	Verbose mode.
	188	Causes
	189	.Nm
	190	and
	191	.Xr ssh 1
	192	to print debugging messages about their progress.
	193	This is helpful in
	194	debugging connection, authentication, and configuration problems.
	195	.El
	196	.Sh DIAGNOSTICS
	197	.Nm
	198	exits with 0 on success or >0 if an error occurred.
	199	.Sh SEE ALSO
	200	.Xr rcp 1 ,
	201	.Xr sftp 1 ,
	202	.Xr ssh 1 ,
	203	.Xr ssh-add 1 ,
	204	.Xr ssh-agent 1 ,
	205	.Xr ssh-keygen 1 ,
	206	.Xr ssh_config 5 ,
	207	.Xr sshd 8
	208	.Sh HISTORY
	209	.Nm
	210	is based on the
	211	.Xr rcp 1
	212	program in BSD source code from the Regents of the University of
	213	California.
	214	.Sh AUTHORS
	215	.An Timo Rinne Aq tri@iki.fi
	216	.An Tatu Ylonen Aq ylo@cs.hut.fi