version 1.2, 1996/06/26 05:37:40 |
version 1.3, 1998/09/27 16:57:49 |
|
|
.Ar name ... |
.Ar name ... |
.Oo login@ Oc Ns Ar host Ns Op :dest |
.Oo login@ Oc Ns Ar host Ns Op :dest |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm Rdist |
.Nm rdist |
is a program to maintain identical copies of files over multiple hosts. |
is a program to maintain identical copies of files over multiple hosts. |
It preserves the owner, group, mode, and mtime of files if possible and |
It preserves the owner, group, mode, and mtime of files if possible and |
can update programs that are executing. |
can update programs that are executing. |
.Nm Rdist |
.Nm rdist |
reads commands from |
reads commands from |
.Ar distfile |
.Ar distfile |
to direct the updating of files and/or directories. |
to direct the updating of files and/or directories. |
|
|
Options specific to the first SYNOPSIS form: |
Options specific to the first SYNOPSIS form: |
.Pp |
.Pp |
.Bl -tag -width indent |
.Bl -tag -width indent |
.It Fl |
|
If |
|
.Ar distfile |
|
is |
|
.Sq Fl , |
|
the standard input is used. |
|
.It Fl f Ar distfile |
.It Fl f Ar distfile |
Use the specified |
Use the specified |
.Ar distfile. |
.Ar distfile . |
|
If |
|
.Ar distfile |
|
is `-', the standard input is used. |
.El |
.El |
.Pp |
.Pp |
If either the |
If either the |
|
|
link itself. |
link itself. |
.It Fl i |
.It Fl i |
Ignore unresolved links. |
Ignore unresolved links. |
.Nm Rdist |
.Nm rdist |
will normally try to maintain the link structure of files being transferred |
will normally try to maintain the link structure of files being transferred |
and warn the user if all the links cannot be found. |
and warn the user if all the links cannot be found. |
.It Fl m Ar host |
.It Fl m Ar host |
|
|
A warning message is printed for files which are newer than the master copy. |
A warning message is printed for files which are newer than the master copy. |
.El |
.El |
.Pp |
.Pp |
.Ar Distfile |
.Ar distfile |
contains a sequence of entries that specify the files |
contains a sequence of entries that specify the files |
to be copied, the destination hosts, and what operations to perform |
to be copied, the destination hosts, and what operations to perform |
to do the updating. Each entry has one of the following formats. |
to do the updating. Each entry has one of the following formats: |
.Pp |
.Pp |
.Bd -literal -offset indent -compact |
.Bd -literal -offset indent -compact |
<variable name> `=' <name list> |
<variable name> `=' <name list> |
|
|
home directory as the root directory for the rest of the file name. |
home directory as the root directory for the rest of the file name. |
.Pp |
.Pp |
The command list consists of zero or more commands of the following |
The command list consists of zero or more commands of the following |
format. |
format: |
.Bd -ragged -offset indent -compact |
.Bd -ragged -offset indent -compact |
.Bl -column except_patx pattern\ listx |
.Bl -column except_patx pattern\ listx |
.It `install' <options> opt_dest_name `;' |
.It `install' <options> opt_dest_name `;' |
|
|
command is used to copy out of date files and/or directories. |
command is used to copy out of date files and/or directories. |
Each source file is copied to each host in the destination list. |
Each source file is copied to each host in the destination list. |
Directories are recursively copied in the same way. |
Directories are recursively copied in the same way. |
.Ar Opt_dest_name |
.Ar opt_dest_name |
is an optional parameter to rename files. |
is an optional parameter to rename files. |
If no |
If no |
.Ic install |
.Ic install |
|
|
options on the command line except they only apply to the files |
options on the command line except they only apply to the files |
in the source list. |
in the source list. |
The login name used on the destination host is the same as the local host |
The login name used on the destination host is the same as the local host |
unless the destination name is of the format ``login@host". |
unless the destination name is of the format ``login@host''. |
.Pp |
.Pp |
The |
The |
.Ic notify |
.Ic notify |
|
|
.Pp |
.Pp |
The |
The |
.Ic except |
.Ic except |
command is used to update all of the files in the source list |
command is used to update all of the files in the source list except |
.Ic except |
|
for the files listed in |
for the files listed in |
.Ar name list . |
.Ar name list . |
This is usually used to copy everything in a directory except certain files. |
This is usually used to copy everything in a directory except certain files. |
|
|
If the |
If the |
.Ar name list |
.Ar name list |
is omitted then the shell commands will be executed |
is omitted then the shell commands will be executed |
for every file updated or installed. The shell variable `FILE' is set |
for every file updated or installed. The shell variable FILE is set |
to the current filename before executing the commands in |
to the current filename before executing the commands in |
.Ar string . |
.Ar string . |
.Ar String |
.Ar string |
starts and ends with `"' and can cross multiple lines in |
starts and ends with `"' and can cross multiple lines in |
.Ar distfile . |
.Ar distfile . |
Multiple commands to the shell should be separated by `;'. |
Multiple commands to the shell should be separated by `;'. |
|
|
temporary file for update lists |
temporary file for update lists |
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr sh 1 , |
|
.Xr csh 1 , |
.Xr csh 1 , |
|
.Xr sh 1 , |
.Xr stat 2 |
.Xr stat 2 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
|
|
command appeared in |
command appeared in |
.Bx 4.3 . |
.Bx 4.3 . |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
A complaint about mismatch of rdist version numbers may really stem |
A complaint about mismatch of |
|
.Nm rdist |
|
version numbers may really stem |
from some problem with starting your shell, e.g., you are in too many groups. |
from some problem with starting your shell, e.g., you are in too many groups. |
.Sh BUGS |
.Sh BUGS |
Source files must reside on the local host where |
Source files must reside on the local host where |
|
|
Variable expansion only works for name lists; there should be a general macro |
Variable expansion only works for name lists; there should be a general macro |
facility. |
facility. |
.Pp |
.Pp |
.Nm Rdist |
.Nm rdist |
aborts on files which have a negative mtime (before Jan 1, 1970). |
aborts on files which have a negative mtime (before Jan 1, 1970). |
.Pp |
.Pp |
There should be a `force' option to allow replacement of non-empty directories |
There should be a `force' option to allow replacement of non-empty directories |