get back reasonable header; don't need types.h

[unix-history] / usr / src / bin / rcp / rcp.1

diff --git a/usr/src/bin/rcp/rcp.1 b/usr/src/bin/rcp/rcp.1
index eb354f9..d871c42 100644 (file)
--- a/usr/src/bin/rcp/rcp.1
+++ b/usr/src/bin/rcp/rcp.1
@@ -1,20 +1,39 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)rcp.1       6.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 .\"
 .\"

-.TH RCP 1C ""
+.\"    @(#)rcp.1       6.7 (Berkeley) %G%
+.\"
+.TH RCP 1 ""

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

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

 .br
 .B rcp
 [
 .br
 .B rcp
 [

+.B \-p
+] [

 .B \-r
 .B \-r

+] [
+.B \-k realm

 ] file ... directory
 .SH DESCRIPTION
 .I Rcp
 ] file ... directory
 .SH DESCRIPTION
 .I Rcp


@@ -23,44 +42,73 @@ copies files between machines.  Each
 or
 .I directory
 argument is either a remote file name of the
 or
 .I directory
 argument is either a remote file name of the

-form ``rhost:path'', or a local file name (containing no `:' characters,
-or a `/' before any `:'s.)
+form ``rname@rhost:path'', or a local file name (containing no `:' characters,
+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

+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
+The
+.B \-k
+option requests
+.I rcp
+to obtain tickets
+for the remote host in realm
+.I realm
+instead of the remote host's realm as determined by
+.IR krb_realmofhost (3).
+.PP

 If
 .I path
 is not a full path name, it is interpreted relative to
 If
 .I path
 is not a full path name, it is interpreted relative to

-your login directory on 
-.IR rhost .
+the login directory of the specified user
+.I ruser
+on 
+.IR rhost ,
+or your current user name if no other remote user name is specified.

 A 
 .I path
 on a remote host may be quoted (using \e, ", or \(aa)
 so that the metacharacters are interpreted remotely.
 .PP
 .I Rcp
 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
-must exist on
-.I rhost
-and allow remote command execution via
-.IR rsh (1C).
+does not prompt for passwords; it performs remote execution
+via
+.IR rsh (1),
+and requires the same authorization.

 .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
-.I rname
-rather than the current user name on the remote host.

 .SH SEE ALSO
 .SH SEE ALSO

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

 .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.
 .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.

-.br
+.PP

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

+.PP
+The destination user and hostname may have to be specified as
+``rhost.rname'' when the destination machine is running the 4.2BSD
+version of \fIrcp\fP.
+