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.18 2001/09/05 06:23:07 deraadt 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	.Op Fl pqrvC46
	23	.Op Fl S Ar program
	24	.Op Fl P Ar port
	25	.Op Fl c Ar cipher
	26	.Op Fl i Ar identity_file
	27	.Op Fl o Ar ssh_option
	28	.Sm off
	29	.Oo
	30	.Op Ar user@
	31	.Ar host1 No :
	32	.Oc Ns Ar file1
	33	.Sm on
	34	.Op Ar ...
	35	.Sm off
	36	.Oo
	37	.Op Ar user@
	38	.Ar host2 No :
	39	.Oc Ar file2
	40	.Sm on
	41	.Sh DESCRIPTION
	42	.Nm
	43	copies files between hosts on a network.
	44	It uses
	45	.Xr ssh 1
	46	for data transfer, and uses the same authentication and provides the
	47	same security as
	48	.Xr ssh 1 .
	49	Unlike
	50	.Xr rcp 1 ,
	51	.Nm
	52	will ask for passwords or passphrases if they are needed for
	53	authentication.
	54	.Pp
	55	Any file name may contain a host and user specification to indicate
	56	that the file is to be copied to/from that host.
	57	Copies between two remote hosts are permitted.
	58	.Pp
	59	The options are as follows:
	60	.Bl -tag -width Ds
	61	.It Fl c Ar cipher
	62	Selects the cipher to use for encrypting the data transfer.
	63	This option is directly passed to
	64	.Xr ssh 1 .
	65	.It Fl i Ar identity_file
	66	Selects the file from which the identity (private key) for RSA
	67	authentication is read.
	68	This option is directly passed to
	69	.Xr ssh 1 .
	70	.It Fl p
	71	Preserves modification times, access times, and modes from the
	72	original file.
	73	.It Fl r
	74	Recursively copy entire directories.
	75	.It Fl v
	76	Verbose mode.
	77	Causes
	78	.Nm
	79	and
	80	.Xr ssh 1
	81	to print debugging messages about their progress.
	82	This is helpful in
	83	debugging connection, authentication, and configuration problems.
	84	.It Fl B
	85	Selects batch mode (prevents asking for passwords or passphrases).
	86	.It Fl q
	87	Disables the progress meter.
	88	.It Fl C
	89	Compression enable.
	90	Passes the
	91	.Fl C
	92	flag to
	93	.Xr ssh 1
	94	to enable compression.
	95	.It Fl P Ar port
	96	Specifies the port to connect to on the remote host.
	97	Note that this option is written with a capital
	98	.Sq P ,
	99	because
	100	.Fl p
	101	is already reserved for preserving the times and modes of the file in
	102	.Xr rcp 1 .
	103	.It Fl S Ar program
	104	Name of
	105	.Ar program
	106	to use for the encrypted connection.
	107	The program must understand
	108	.Xr ssh 1
	109	options.
	110	.It Fl o Ar ssh_option
	111	Can be used to pass options to
	112	.Nm ssh
	113	in the format used in the
	114	.Xr ssh 1
	115	configuration file. This is useful for specifying options
	116	for which there is no separate
	117	.Nm scp
	118	command-line flag. For example, forcing the use of protocol
	119	version 1 is specified using
	120	.Ic scp -oProtocol=1 .
	121	.It Fl 4
	122	Forces
	123	.Nm
	124	to use IPv4 addresses only.
	125	.It Fl 6
	126	Forces
	127	.Nm
	128	to use IPv6 addresses only.
	129	.El
	130	.Sh AUTHORS
	131	Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>
	132	.Sh HISTORY
	133	.Nm
	134	is based on the
	135	.Xr rcp 1
	136	program in BSD source code from the Regents of the University of
	137	California.
	138	.Sh SEE ALSO
	139	.Xr rcp 1 ,
	140	.Xr sftp 1 ,
	141	.Xr ssh 1 ,
	142	.Xr ssh-add 1 ,
	143	.Xr ssh-agent 1 ,
	144	.Xr ssh-keygen 1 ,
	145	.Xr sshd 8