diff options
Diffstat (limited to 'usr/src/man/man1/rdist.1')
-rw-r--r-- | usr/src/man/man1/rdist.1 | 43 |
1 files changed, 5 insertions, 38 deletions
diff --git a/usr/src/man/man1/rdist.1 b/usr/src/man/man1/rdist.1 index db3adbd46f..82e897ffcf 100644 --- a/usr/src/man/man1/rdist.1 +++ b/usr/src/man/man1/rdist.1 @@ -1,11 +1,10 @@ '\" te .\" Copyright (c) 1985 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved -.TH RDIST 1 "Dec 23, 2008" +.TH RDIST 1 "September 12, 2020" .SH NAME rdist \- remote file distribution program .SH SYNOPSIS -.LP .nf \fBrdist\fR [\fB-b\fR] [\fB-D\fR] [\fB-h\fR] [\fB-i\fR] [\fB-n\fR] [\fB-q\fR] [\fB-R\fR] [\fB-a\fR] [\fB-K\fR] [\fB-x\fR] [\fB-PN\fR | \fB-PO\fR] [\fB-k\fR \fIrealm\fR] [\fB-v\fR] [\fB-w\fR] [\fB-y\fR] @@ -20,8 +19,6 @@ rdist \- remote file distribution program .fi .SH DESCRIPTION -.sp -.LP The \fBrdist\fR utility maintains copies of files on multiple hosts. It preserves the owner, group, mode, and modification time of the master copies, and can update programs that are executing. (\fBrdist\fR does not propagate @@ -62,8 +59,6 @@ supersets of the \fB-a\fR option. In order to use the non-secure version of \fB\&.rhosts\fR file in the home directory. See \fBhosts.equiv\fR(4) for more information. .SH OPTIONS -.sp -.LP The following options are supported: .sp .ne 2 @@ -218,7 +213,7 @@ a distfile. .sp .6 .RS 4n Explicitly requests new (\fB-PN\fR) or old (\fB-PO\fR) version of the Kerberos -"\fBrcmd\fR" protocol. The new protocol avoids many security problems prevalant +"\fBrcmd\fR" protocol. The new protocol avoids many security problems prevalent in the old one and is regarded much more secure, but is not interoperable with older (MIT/SEAM) servers. The new protocol is used by default, unless explicitly specified using these options or through \fBkrb5.conf\fR(4). If @@ -303,19 +298,13 @@ checked. No comparison of size is made. .SH USAGE .SS "White Space Characters" -.sp -.LP NEWLINE, TAB, and SPACE characters are all treated as white space; a mapping continues across input lines until the start of the next mapping: either a single \fIfilename\fR followed by a `\fB->\fR' or the opening parenthesis of a filename list. .SS "Comments" -.sp -.LP Comments begin with \fB#\fR and end with a NEWLINE. .SS "Distfiles" -.sp -.LP The distfile contains a sequence of entries that specify the files to be copied, the destination files to be copied, the destination hosts, and what operations to perform to do the updating. Each entry has one of the following @@ -346,8 +335,6 @@ a certain date (specified by the date/time of the \fItime_stamp\fR file). Typically, only \fBnotify\fR is used with the '\fB::\fR' format of the command line. .SS "Macros" -.sp -.LP \fBrdist\fR has a limited macro facility. Macros are only expanded in filename or hostname lists, and in the argument lists of certain primitives. Macros cannot be used to stand for primitives or their options, or the `\fB->\fR' or @@ -377,13 +364,11 @@ A macro reference is a string of the form: although (as with \fBmake\fR(1S)) the braces can be omitted if the macro name consists of just one character. .SS "Kerberos Access-Control file" -.sp -.LP For the kerberized \fBrdist\fR session, each user might have a private authorization list in a file \fB\&.k5login\fR in their home directory. Each line in this file should contain a Kerberos principal name of the form \fIprincipal\fR/\fIinstance\fR@\fIrealm\fR. If there is a \fB~/.k5login\fR -file, then access is granted to the account if and only if the originater user +file, then access is granted to the account if and only if the originating user is authenticated to one of the principals named in the \fB~/.k5login\fR file. Otherwise, the originating user is granted access to the account if and only if the authenticated principal name of the user can be mapped to the local account @@ -391,8 +376,6 @@ name using the \fIauthenticated-principal-name\fR \(-> \fIlocal-user-name\fR mapping rules. The \fB\&.k5login\fR file (for access control) comes into play only when Kerberos authentication is being done. .SS "Metacharacters" -.sp -.LP The shell meta-characters: \fB[\fR, \fB]\fR, \fB{\fR, \fB}\fR, \fB*\fR and \fB?\fR are recognized and expanded (on the local host only) just as they are with \fBcsh\fR(1). Metacharacters can be escaped by prepending a backslash. @@ -401,15 +384,11 @@ with \fBcsh\fR(1). Metacharacters can be escaped by prepending a backslash. The \fB~\fR character is also expanded in the same way as with \fBcsh\fR; however, it is expanded separately on the local and destination hosts. .SS "Filenames" -.sp -.LP File names that do not begin with `\fB\|/\|\fR\&' or `\fB\|~\|\fR\&' are taken to be relative to user's home directory on each destination host; they are \fInot\fR relative to the current working directory. Multiple file names must be enclosed within parentheses. .SS "Primitives" -.sp -.LP The following primitives can be used to specify actions \fBrdist\fR is to take when updating remote copies of each file. .sp @@ -430,7 +409,7 @@ corresponding filename is completely absent on the master host. .sp The options for \fBinstall\fR have the same semantics as their command line counterparts, but are limited in scope to a particular map. The login name used -on the destination host is the same as the local host unless the destination +on the destination host is the same as on the local host unless the destination name is of the format \fIlogin@host\fR. In that case, the update is performed under the username \fIlogin\fR. .RE @@ -494,12 +473,9 @@ is the user's home directory on the remote host. .RE .SS "IPv6" -.sp -.LP The \fBrdist\fR command is IPv6-enabled. See \fBip6\fR(7P). \fBIPv6\fR is not currently supported with Kerberos V5 authentication. .SH EXAMPLES -.LP \fBExample 1 \fRA Sample distfile .sp .LP @@ -529,7 +505,6 @@ ${FILES} :: /usr/local/lib/timestamp .sp .SH FILES -.sp .ne 2 .na \fB\fB~/.rhosts\fR\fR @@ -544,7 +519,7 @@ User's trusted hosts and users \fB\fB/etc/host.equiv\fR\fR .ad .RS 23n -system trusted hosts and users +System trusted hosts and users .RE .sp @@ -575,26 +550,18 @@ Kerberos configuration file .RE .SH SEE ALSO -.sp -.LP \fBcsh\fR(1), \fBed\fR(1), \fBmake\fR(1S), \fBsh\fR(1), \fBin.rshd\fR(1M), \fBstat\fR(2), \fBhosts.equiv\fR(4), \fBkrb5.conf\fR(4), \fBattributes\fR(5), \fBkrb5_auth_rules\fR(5), \fBip6\fR(7P) .SH DIAGNOSTICS -.sp -.LP A complaint about mismatch of \fBrdist\fR version numbers might really stem from some problem with starting your shell, for example, you are in too many groups. .SH WARNINGS -.sp -.LP The super-user does not have its accustomed access privileges on \fBNFS\fR mounted file systems. Using \fBrdist\fR to copy to such a file system might fail, or the copies might be owned by user "nobody". .SH BUGS -.sp -.LP Source files must reside or be mounted on the local host. .sp .LP |