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.30 2003/10/13 08:22:25 markus 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 ConnectionTimeout
	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 KeepAlive
	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 SmartcardDevice
	154	.It StrictHostKeyChecking
	155	.It UsePrivilegedPort
	156	.It User
	157	.It UserKnownHostsFile
	158	.It VerifyHostKeyDNS
	159	.El
	160	.It Fl P Ar port
	161	Specifies the port to connect to on the remote host.
	162	Note that this option is written with a capital
	163	.Sq P ,
	164	because
	165	.Fl p
	166	is already reserved for preserving the times and modes of the file in
	167	.Xr rcp 1 .
	168	.It Fl p
	169	Preserves modification times, access times, and modes from the
	170	original file.
	171	.It Fl q
	172	Disables the progress meter.
	173	.It Fl r
	174	Recursively copy entire directories.
	175	.It Fl S Ar program
	176	Name of
	177	.Ar program
	178	to use for the encrypted connection.
	179	The program must understand
	180	.Xr ssh 1
	181	options.
	182	.It Fl v
	183	Verbose mode.
	184	Causes
	185	.Nm
	186	and
	187	.Xr ssh 1
	188	to print debugging messages about their progress.
	189	This is helpful in
	190	debugging connection, authentication, and configuration problems.
	191	.El
	192	.Sh DIAGNOSTICS
	193	.Nm
	194	exits with 0 on success or >0 if an error occurred.
	195	.Sh SEE ALSO
	196	.Xr rcp 1 ,
	197	.Xr sftp 1 ,
	198	.Xr ssh 1 ,
	199	.Xr ssh-add 1 ,
	200	.Xr ssh-agent 1 ,
	201	.Xr ssh-keygen 1 ,
	202	.Xr ssh_config 5 ,
	203	.Xr sshd 8
	204	.Sh HISTORY
	205	.Nm
	206	is based on the
	207	.Xr rcp 1
	208	program in BSD source code from the Regents of the University of
	209	California.
	210	.Sh AUTHORS
	211	.An Timo Rinne Aq tri@iki.fi
	212	.An Tatu Ylonen Aq ylo@cs.hut.fi