summaryrefslogtreecommitdiff
path: root/usr.bin/ssh/scp.1
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-10-03 18:15:40 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-10-03 18:15:40 +0000
commitc4f70c567663f7330b6c17dc94ec5ea345fb31ae (patch)
tree2b50e1878f4b086e0efe7b34efbceaec97078dab /usr.bin/ssh/scp.1
parent89b6d254a6b404d80493a2ae9e687743a65f0d35 (diff)
New mdoc'ified scp(1) man page.
Diffstat (limited to 'usr.bin/ssh/scp.1')
-rw-r--r--usr.bin/ssh/scp.1160
1 files changed, 70 insertions, 90 deletions
diff --git a/usr.bin/ssh/scp.1 b/usr.bin/ssh/scp.1
index e3b847b2584..aefeea249a9 100644
--- a/usr.bin/ssh/scp.1
+++ b/usr.bin/ssh/scp.1
@@ -9,122 +9,102 @@
.\"
.\" Created: Sun May 7 00:14:37 1995 ylo
.\"
-.\" $Id: scp.1,v 1.2 1999/09/30 21:25:03 aaron Exp $
+.\" $Id: scp.1,v 1.3 1999/10/03 18:15:39 aaron Exp $
.\"
-.TH SCP 1 "November 8, 1995" SSH SSH
-
-.SH NAME
-scp \- secure copy (remote file copy program)
-
-.SH SYNOPSIS
-.LP
-.B scp
-[\c
-.B \-pqrvC\c
-]
-[\c
-.BI \-P "\ port\c
-]
-[\c
-.BI \-c "\ cipher\c
-]
-[\c
-.BI \-i "\ identity\c
-]
-.if n .ti +5
-[[\c
-.B user@\c
-]\c
-.B host1:\c
-]\c
-.B filename1\c
-\&.\|.\|.
-[[\c
-.B user@\c
-]\c
-.B host2:\c
-]\c
-.B filename2
-
-.SH DESCRIPTION
-.LP
-.B Scp
+.Dd September 25, 1999
+.Dt SCP 1
+.Os
+.Sh NAME
+.Nm scp
+.Nd secure copy (remote file copy program)
+.Sh SYNOPSIS
+.Nm scp
+.Op Fl pqrvC
+.Op Fl P Ar port
+.Op Fl c Ar cipher
+.Op Fl i Ar identity_file
+.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
+.Sh DESCRIPTION
+.Nm
copies files between hosts on a network. It uses
-.B ssh
+.Xr ssh 1
for data transfer, and uses the same authentication and provides the
same security as
-.B ssh.
+.Xr ssh 1 .
Unlike
-.BR rcp ",
-.B ssh
+.Xr rcp 1 ,
+.Nm
will ask for passwords or passphrases if they are needed for
authentication.
-.LP
+.Pp
Any file name may contain a host and user specification to indicate
that the file is to be copied to/from that host. Copies between two
remote hosts are permitted.
-
-.SH OPTIONS
-
-.TP 0.6i
-.BI \-c "\ cipher
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl c Ar cipher
Selects the cipher to use for encrypting the data transfer. This
option is directly passed to
-.B ssh.
-.TP
-.BI \-i "\ identity_file
+.Xr ssh 1 .
+.It Fl i Ar identity_file
Selects the file from which the identity (private key) for RSA
authentication is read. This option is directly passed to
-.B ssh.
-.TP
-.B \-p
+.Xr ssh 1 .
+.It Fl p
Preserves modification times, access times, and modes from the
original file.
-.TP
-.B \-r
+.It Fl r
Recursively copy entire directories.
-.TP
-.B \-v
+.It Fl v
Verbose mode. Causes
-.B scp
+.Nm
and
-.B ssh
+.Xr ssh 1
to print debugging messages about their progress. This is helpful in
debugging connection, authentication, and configuration problems.
-.TP
-.B \-B
+.It Fl B
Selects batch mode (prevents asking for passwords or passphrases).
-.TP
-.B \-q
+.It Fl q
Disables the progress meter.
-.TP
-.B \-C
-Compression enable. Passes the -C flag to
-.B ssh
+.It Fl C
+Compression enable. Passes the
+.Fl C
+flag to
+.Xr ssh 1
to enable compression.
-.TP
-.BI \-P "\ port
+.It Fl p Ar port
Specifies the port to connect to on the remote host. Note that this
-option is written with a capital P, because \-p is already reserved for
-preserving the times and modes of the file in rcp.
-
-.SH AUTHORS
-.LP
+option is written with a capital
+.Sq P ,
+because
+.Fl p
+is already reserved for preserving the times and modes of the file in
+.Xr rcp 1 .
+.Sh AUTHORS
Timo Rinne <tri@iki.fi> and Tatu Ylonen <ylo@cs.hut.fi>
-
-.SH DERIVATION
-.LP
-.B Scp
+.Sh HISTORY
+.Nm
is based on the
-.B rcp
+.Xr rcp 1
program in BSD source code from the Regents of the University of
California.
-
-.SH SEE ALSO
-.LP
-.BR ssh (1),
-.BR sshd (8),
-.BR ssh-keygen (1),
-.BR ssh-agent (1),
-.BR ssh-add (1),
-.BR rcp (1)
+.Sh SEE ALSO
+.Xr rcp 1 ,
+.Xr ssh 1 ,
+.Xr ssh-add 1 ,
+.Xr ssh-agent 1 ,
+.Xr ssh-keygen 1 ,
+.Xr sshd 8