version 1.25, 2007/02/26 16:39:23 |
version 1.26, 2007/02/26 21:39:13 |
|
|
to have |
to have |
.Ar value . |
.Ar value . |
This |
This |
option is used to define or override variable definitions in the |
option is used to define or override variable definitions in |
.Pa distfile . |
.Pa distfile . |
.Ar value |
.Ar value |
can be the empty string, one name, or a list of names surrounded by |
can be the empty string, one name, or a list of names surrounded by |
|
|
processes. |
processes. |
All clients are updated sequentially. |
All clients are updated sequentially. |
.It Fl f Ar distfile |
.It Fl f Ar distfile |
Set the name of the distfile to use to be |
Set the name of the distfile to |
.Ar distfile . |
.Ar distfile . |
If |
If |
.Ar distfile |
.Sq - |
is specified as |
(dash) is used then read from standard input (stdin). |
.Dq - |
|
(dash) then read from standard input (stdin). |
|
.It Fl L Ar remote_logopts |
.It Fl L Ar remote_logopts |
Set remote logging options. |
Set remote logging options. |
.Ar logopts |
|
is the same as for local logging except the values are passed to the remote |
|
server, |
|
.Xr rdistd 1 . |
|
See the section |
See the section |
.Sy MESSAGE LOGGING |
.Sx MESSAGE LOGGING |
for details on the syntax for |
for details on the syntax for |
.Ar logopts . |
.Ar remote_logopts . |
.It Fl l Ar local_logopts |
.It Fl l Ar local_logopts |
Set local logging options. |
Set local logging options. |
See the section |
See the section |
.Sy MESSAGE LOGGING |
.Sx MESSAGE LOGGING |
for details on the syntax for |
for details on the syntax for |
.Ar logopts . |
.Ar local_logopts . |
.It Fl M Ar maxproc |
.It Fl M Ar maxproc |
Set the maximum number of simultaneously running child |
Set the maximum number of simultaneously running child |
.Nm |
.Nm |
|
|
Limit which machines are to be updated. |
Limit which machines are to be updated. |
Multiple |
Multiple |
.Fl m |
.Fl m |
arguments can be given to limit updates to a subset of the hosts listed in the |
arguments can be given to limit updates to a subset of the hosts listed in |
.Pa distfile . |
.Pa distfile . |
.It Fl n |
.It Fl n |
Print the commands without executing them. |
Print the commands without executing them. |
This option is useful for debugging a |
This option is useful for debugging a distfile. |
.Pa distfile . |
|
.It Fl o Ar distopts |
.It Fl o Ar distopts |
Specify the dist options to enable. |
Specify the dist options to enable. |
.Ar distopts |
.Ar distopts |
|
|
are: |
are: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ic chknfs |
.It Ic chknfs |
Do not check or update files on target host that reside on NFS filesystems. |
Do not check or update files on the target host |
|
that reside on NFS filesystems. |
.It Ic chkreadonly |
.It Ic chkreadonly |
Enable check on target host to see if a file resides on a read-only filesystem. |
Enable a check on the target host |
|
to see if a file resides on a read-only filesystem. |
If a file does, then no checking or updating of the file is attempted. |
If a file does, then no checking or updating of the file is attempted. |
.It Ic chksym |
.It Ic chksym |
If the target on the remote host is a symbolic link, but is not on the |
If the target on the remote host is a symbolic link, but is not on the |
|
|
Instead, just update the ownership, group, and permissions as necessary. |
Instead, just update the ownership, group, and permissions as necessary. |
.It Ic verify |
.It Ic verify |
Verify that the files are up to date on all the hosts. |
Verify that the files are up to date on all the hosts. |
Any files that are out of date will be displayed but no files will be |
Any files that are out of date will be displayed |
changed nor will any mail be sent. |
but no files will be changed and no mail will be sent. |
.It Ic whole |
.It Ic whole |
Whole mode. |
Whole mode. |
The whole file name is appended to the destination directory name. |
The whole file name is appended to the destination directory name. |
|
|
This will preserve the directory structure of the files being |
This will preserve the directory structure of the files being |
copied instead of flattening the directory structure. |
copied instead of flattening the directory structure. |
For example, rdisting a list of files such as |
For example, rdisting a list of files such as |
.Pa /path/dir1/f1 |
.Pa /p/dir1/f1 |
and |
and |
.Pa /path/dir2/f2 |
.Pa /p/dir2/f2 |
to |
to |
.Pa /tmp/dir |
.Pa /tmp/dir |
would create files |
would create files |
.Pa /tmp/dir/path/dir1/f1 |
.Pa /tmp/dir/p/dir1/f1 |
and |
and |
.Pa /tmp/dir/path/dir2/f2 |
.Pa /tmp/dir/p/dir2/f2 |
instead of |
instead of |
.Pa /tmp/dir/dir1/f1 |
.Pa /tmp/dir/dir1/f1 |
and |
and |
|
|
.El |
.El |
.It Fl P Ar rsh-path |
.It Fl P Ar rsh-path |
Set the path to the remote shell command. |
Set the path to the remote shell command. |
The |
|
.Ar rsh-path |
.Ar rsh-path |
may be a colon separated list of possible pathnames. |
may be a colon separated list of possible pathnames. |
In this case, the first component of the path to exist is used. |
In this case, the first component of the path to exist is used. |
For example, |
For example, |
.Pa "/usr/bin/ssh:/usr/bin/rsh" , |
.Pa /usr/bin/ssh:/usr/bin/rsh |
|
or |
.Pa /usr/bin/ssh . |
.Pa /usr/bin/ssh . |
.It Fl p Ar rdistd-path |
.It Fl p Ar rdistd-path |
Set the path where the rdistd server is searched for on the target host. |
Set the path where the rdistd server is searched for on the target host. |
|
|
.Nm rdist , |
.Nm rdist , |
.Pa /usr/bin/oldrdist . |
.Pa /usr/bin/oldrdist . |
.It Fl t Ar timeout |
.It Fl t Ar timeout |
Set the timeout period (in seconds) for waiting for responses from the remote |
Set the timeout period, |
|
in seconds, |
|
for waiting for responses from the remote |
.Nm |
.Nm |
server. |
server. |
The default is 900 seconds. |
The default is 900 seconds. |