HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

r
rdist(1) rdist(1)
-b Binary comparison. Perform a binary comparison and update files if they differ rather than
comparing dates and sizes.
-M Check that mode, ownership, and group are the same in addition to any other form of com-
parison that is in effect. This option will cause files to be replaced but will only correct the
problem with a directory and print a warning message.
The distfile used by rdist
contains a sequence of entries that specify the files to be copied, the destina-
tion hosts, and what operations to perform to do the updating. Each entry has one of the following formats.
variable_name = name_list
[label:] source_list -> destination_list command_list
[label:] source_list :: time_stamp_file command_list
The first format is used for defining variables. The second format is used for distributing files to other
hosts. The third format is used for making lists of files on the local host that have been changed since some
given date. (See EXAMPLES.)
variable_name
Specify the name of a variable.
name_list List of names (such as list of hosts or lists of files) separated by tabs and/or spaces and enclosed
by parentheses.
source_list
Specify a list of files and/or directories on the local host to be used as the master copy for distri-
bution. Each file in the source_list is added to a list for changes, if the file is out of date on the
host that is being updated (second format), or if the file is newer than the time stamp file (third
format). source_list may contain a single name, or multiple names separated by tabs and/or
spaces and enclosed by parentheses.
destination_list
List of hosts to which these files are to be copied. destination_list may contain a single name, or
multiple names separated by tabs and/or spaces and enclosed by parentheses.
time_stamp_file
Specify a given date to generate a list of files on the local host that were modified since that date.
label: Labels are optional. They are used to identify a command for partial updates.
command_list
Specifies a list of commands to be performed.
The command list consists of zero or more commands of the following format.
install [ options ] opt_dest_name
;
notify
name_list;
except
name_list;
except_pat
pattern_list;
special
name_list string;
The install command is used to copy out-of-date files and/or directories. Each source file is
copied to each host in the destination list. Directories are recursively copied in the same way.
opt_dest_name is an optional parameter to rename files. If no install command appears in
the command list or the destination name is not specified, source_list is used. Directories in the
path name will be created if they do not exist on the remote host. To help prevent disasters, a
non-empty directory on a target will never be replaced with a regular file or a symbolic link.
However, under the -R option a non-empty directory will be removed if the corresponding
filename is completely absent on the master host. The options are -b,-h,-i, -v,-w,-y, -M,
and -R, and have the same semantics as options on the command line, except that they only
apply to the files in the specified source_list. The login name used on the destination host is the
same as on the local host, unless the destination name is of the form "login@host".
The notify command is used to mail the list of files updated (and any errors that may have
occurred) to the listed names, in name_list.Ifno@ appears in the name, the destination host is
appended to the name (e.g., name1@host, name2@host, ...).
The except command is used to update all of the files in the source list, except for the files
listed in name_list. This is usually used to copy everything in a directory except certain files.
Section 1−−816 Hewlett-Packard Company − 2 − HP-UX 11i Version 1: September 2005