temip_propagate(1) — Commands
NAME
temip_propagate − TeMIP file propagation tool
SYNOPSIS
temip_propagate [-c] [-h] -d ALL|hostname FileCategory ...
PARAMETERS
FileCategory
The FileCategory parameter defines the file(s) being copied. The possible values of this argument are dynamically determined from the contents of a distfile compatible with the rdist utility.
FLAGS
−cVerifies that the files are up-to-date on the remote director(s). This verification is done by comparison of the checksum and last update time of the files.
−d ALL|hostname
Specifies the remote director host to copy to. This flag can be specified many times for the same command or only once with the ALL keyword. Note that the hostname of the remote director must be specified.
−hDisplays the command usage. The command usage lists the available FileCategories and the known remote directors.
DESCRIPTION
The temip_propagate command copies one or more files from the local director to one, many or all the known remote directors. The files being copied are defined by the FileCategory parameter(s).
A distfile is an rdist distfile that contains a sequence of entries specifying the files to be copied and what operations to perform when updating. A temip_propagate distfile must contain the following variable definitions:
FileCategory = (file_list)
Defines a FileCategory and the corresponding files that belong to it. Note that only physical files must be specified, not softlinks, because rdist does not follow softlinks on the target machine.
REMOTE_DIRECTORS = ()
This variable must be present to allow temip_propagate to instruct rdist which remote director(s) to copy to.
${FILES} -> ${REMOTE_DIRECTORS} command_list
This variable must be present to allow temip_propagate to instruct rdist which files must be copied to the remote director(s). The command_list is an rdist command list. See rdist for more information.
Any product or software running above TeMIP can take advantage of the temip_propagate utility by defining its own distribution file according to some pre-defined rules.
The temip_propagate program can be used from any user account. Because the same account is used on the remote director host to perform the file copy, $HOME/.rhosts must be correctly configured on the destination director. See .rhosts for more information.
EXAMPLES
The following is an example of the TeMIP distfile:
# dictionary files:
dictionary_en_US=(/usr/mcc/en_US.ISO8859-1/mcc_fdictionary.dat
/usr/mcc/en_US.ISO8859-1/mcc_fdictionary.bpt)
# dispatch table file:
dispatch = (/usr/mcc/mcc_system/mcc_dispatch_table.dat)
# map backdrop files:
backdrops = (/usr/mcc/backdrops/mcc∗.mcc_backdrop)
# icon files:
icons = (/usr/mcc/icons/∗)
# ACLOC Access Control: profiles and AC view files
ac = (/var/mcc/acloc/user_profiles/∗)
# ACLOC Central Logging administration files:
loc =(/var/mcc/acloc/central_logging/admin/∗)
#
REMOTE_DIRECTORS = ()
#
${FILES} -> ${REMOTE_DIRECTORS}
install -h;
special ${dispatch} "temip_enroll -u" ;
With the above distfile, the available FileCategories are: dictionary_en_US, dispatch, backdrops, icons, ac and loc.
DIAGNOSTICS
No distfile on the system
No distfile is available in /usr/mcc/mcc_system.
Unknown file category
The specified FileCategory does not exist in the available distfiles.
File category FileCategory exists in more than one distfile: distfile ...
The specified FileCategory exists in many distfiles.
FILES
/usr/mcc/mcc_system/∗.distfile
They are the distribution files used by temip_propagate.