- changed (via bsd2man script) nroff source to style understood by the

GNO version of nroff.
This commit is contained in:
gdr-ftp 1998-01-25 20:56:00 +00:00
parent b1fefe20fb
commit 12ab1893b4
1 changed files with 76 additions and 79 deletions

View File

@ -30,131 +30,128 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)rcp.1 8.1 (Berkeley) 5/31/93
.\" $Id: rcp.1,v 1.1 1998/01/24 07:35:20 taubert Exp $
.\" $Id: rcp.1,v 1.2 1998/01/25 20:56:00 gdr-ftp Exp $
.\"
.Dd May 31, 1993
.Dt RCP 1
.Os BSD 4.3r
.Sh NAME
.Nm rcp
.Nd remote file copy
.Sh SYNOPSIS
.Nm rcp
.Op Fl Kpx
.Op Fl k Ar realm
.Ar file1 file2
.Nm rcp
.Op Fl Kprx
.Op Fl k Ar realm
.Ar file ...
.Ar directory
.Sh DESCRIPTION
.Nm Rcp
.TH RCP 1 "November 1997" GNO "Commands and Applications"
.SH NAME
.BR rcp
\- remote file copy
.SH SYNOPSIS
.BR rcp
.RB [ -Kpx ]
.RB [ -k
.IR realm ]
.I file1
.I file2
.br
.BR rcp
.RB [ -Kprx ]
.RB [ -k
.IR realm ]
.IR file ...
.I directory
.SH DESCRIPTION
.BR Rcp
copies files between machines. Each
.Ar file
.IR file
or
.Ar directory
.IR directory
argument is either a remote file name of the
form ``rname@rhost:path'', or a local file name (containing no `:' characters,
form ``ruser@rhost:path'', or a local file name (containing no `:' characters,
or a `/' before any `:'s).
.Pp
.Bl -tag -width flag
.It Fl K
.IP "\fB-K\fR"
The
.Fl K
.BR -K
option turns off all Kerberos authentication.
.It Fl k
.IP "\fB-k\fR"
The
.Fl k
.BR -k
option requests
.Nm rcp
.BR rcp
to obtain tickets
for the remote host in realm
.Ar realm
.IR realm
instead of the remote host's realm as determined by
.Xr krb_realmofhost 3 .
.It Fl p
.BR krb_realmofhost (3).
.IP "\fB-p\fR"
The
.Fl p
.BR -p
option causes
.Nm rcp
.BR rcp
to attempt to preserve (duplicate) in its copies the modification
times and modes of the source files, ignoring the
.Ar umask .
.BR umask .
By default, the mode and owner of
.Ar file2
.IR file2
are preserved if it already existed; otherwise the mode of the source file
modified by the
.Xr umask 2
.BR umask (2)
on the destination host is used.
.It Fl r
.IP "\fB-r\fR"
If any of the source files are directories,
.Nm rcp
.BR rcp
copies each subtree rooted at that name; in this case
the destination must be a directory.
.It Fl x
.IP "\fB-x\fR"
The
.Fl x
option turns on
.Tn DES
encryption for all data passed by
.Nm rcp .
This may impact response time and
.Tn CPU
utilization, but provides
.BR -x
option turns on DES encryption for all data passed by
.BR rcp .
This may impact response time and CPU utilization, but provides
increased security.
.El
.Pp
.LP
If
.Ar path
.IR path
is not a full path name, it is interpreted relative to
the login directory of the specified user
.Ar ruser
.IR ruser
on
.Ar rhost ,
.IR rhost ,
or your current user name if no other remote user name is specified.
A
.Ar path
.BR path
on a remote host may be quoted (using \e, ", or \(aa)
so that the metacharacters are interpreted remotely.
.Pp
.Nm Rcp
.LP
.BR Rcp
does not prompt for passwords; it performs remote execution
via
.Xr rsh 1 ,
.BR rsh (1),
and requires the same authorization.
.Pp
.Nm Rcp
.LP
.BR Rcp
handles third party copies, where neither source nor target files
are on the current machine.
.Sh SEE ALSO
.Xr cp 1 ,
.Xr ftp 1 ,
.Xr rsh 1 ,
.Xr rlogin 1
.Sh HISTORY
.SH ATTRIBUTIONS
This command was ported from FreeBSD source code
for distribution with GNO/ME 2.0.6.
.SH SEE ALSO
.BR cp (1),
.BR ftp (1),
.BR rsh (1),
.BR rlogin (1)
.SH HISTORY
The
.Nm rcp
.BR rcp
command appeared in
.Bx 4.2 .
BSD 4.2.
The version of
.Nm rcp
.BR rcp
described here
has been reimplemented with Kerberos in
.Bx 4.3 Reno .
.Sh BUGS
has been reimplemented with Kerberos in 4.3BSD (Reno).
.SH BUGS
Doesn't detect all cases where the target of a copy might
be a file in cases where only a directory should be legal.
.Pp
.LP
Is confused by any output generated by commands in a
.Pa \&.login ,
.Pa \&.profile ,
.BR \&.login ,
.BR \&.profile ,
.BR \&.cshrc ,
or
.Pa \&.cshrc
.BR \&gshrc
file on the remote host.
.Pp
.LP
The destination user and hostname may have to be specified as
``rhost.rname'' when the destination machine is running the
.Bx 4.2
version of
.Nm rcp .
BSD 4.2 version of
.BR rcp .