BSD 4_3 release

[unix-history] / usr / man / man1 / rcp.1c

diff --git a/usr/man/man1/rcp.1c b/usr/man/man1/rcp.1c
index 9ff99b5..5832ccb 100644 (file)
--- a/usr/man/man1/rcp.1c
+++ b/usr/man/man1/rcp.1c
@@ -1,45 +1,89 @@
-.TH RCP 1C "17 March 1982"
-.UC 4
+.\" Copyright (c) 1983 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)rcp.1c      6.4 (Berkeley) 5/12/86
+.\"
+.TH RCP 1C "May 12, 1986"
+.UC 5

 .SH NAME
 rcp \- remote file copy
 .SH SYNOPSIS
 .B rcp
 .SH NAME
 rcp \- remote file copy
 .SH SYNOPSIS
 .B rcp

-file1 file2
+[
+.B \-p
+] file1 file2

 .br
 .B rcp
 .br
 .B rcp

-[ \-r ]
-file ... directory
+[
+.B \-p
+] [
+.B \-r
+] file ... directory

 .SH DESCRIPTION
 .I Rcp
 copies files between machines.  Each
 .SH DESCRIPTION
 .I Rcp
 copies files between machines.  Each

-\fIfile\fP or \fIdirectory\fP argument is either a remote file name of the
+.I file
+or
+.I directory
+argument is either a remote file name of the

 form ``rhost:path'', or a local file name (containing no `:' characters,
 form ``rhost:path'', or a local file name (containing no `:' characters,

-or a `/' before any `:'s.)
+or a `/' before any `:'s).

 .PP
 If the
 .B \-r
 .PP
 If the
 .B \-r

+option

 is specified and any of the source files are directories,
 .I rcp
 copies each subtree rooted at that name; in this case
 the destination must be a directory.
 .PP
 is specified and any of the source files are directories,
 .I rcp
 copies each subtree rooted at that name; in this case
 the destination must be a directory.
 .PP

-If \fIpath\fP is not a full path name, it is interpreted relative to
-your login directory on \fIrhost\fP.
-A \fIpath\fP on a remote host may be quoted (using \e, ", or \(aa)
+By default, the mode and owner of
+.I file2
+are preserved if it already existed; otherwise the mode of the source file
+modified by the
+.IR umask (2)
+on the destination host is used.
+The
+.B \-p
+option causes
+.I rcp
+to attempt to preserve (duplicate) in its copies the modification
+times and modes of the source files, ignoring the
+.IR umask .
+.PP
+If
+.I path
+is not a full path name, it is interpreted relative to
+your login directory on 
+.IR rhost .
+A 
+.I path
+on a remote host may be quoted (using \e, ", or \(aa)

 so that the metacharacters are interpreted remotely.
 .PP
 .I Rcp
 does not prompt for passwords; your current local user name
 so that the metacharacters are interpreted remotely.
 .PP
 .I Rcp
 does not prompt for passwords; your current local user name

-must exist on \fIrhost\fP and allow remote command execution via
-.IR rsh (1c).
+must exist on
+.I rhost
+and allow remote command execution via
+.IR rsh (1C).

 .PP
 .I Rcp
 handles third party copies, where neither source nor target files
 are on the current machine.
 .PP
 .I Rcp
 handles third party copies, where neither source nor target files
 are on the current machine.

-Hostnames may also take the form ``rhost.rname'' to use
-\fIrname\fP rather than the current user name on the remote host.
+Hostnames may also take the form ``rname@rhost'' to use
+.I rname
+rather than the current user name on the remote host.
+The destination hostname may also take the form ``rhost.rname'' to
+support destination machines that are running 4.2BSD
+versions of
+.I rcp.

 .SH SEE ALSO
 .SH SEE ALSO

-ftp(1c), rsh(1c), rlogin(1c)
+cp(1), ftp(1C), rsh(1C), rlogin(1C)

 .SH BUGS
 .SH BUGS

-Doesn't detect in all cases the fact that a target of a copy might
+Doesn't detect all cases where the target of a copy might

 be a file in cases where only a directory should be legal.
 be a file in cases where only a directory should be legal.

+.br
+Is confused by any output generated by commands in a
+\&.login, \&.profile, or \&.cshrc file on the remote host.