ClearCase::Config - ClearCase configuration settings
use ClearCase::Config; my $ct_path = clearcase_config 'CLEARTOOL'; my ($cc_home, $cc_adm) = clearcase_config('ATRIA_HOME', 'ATRIA_ADM'); my $clearbug_path = clearcase_progpath 'clearbug'; my $ct_version = clearcase_version 'cleartool';
clearcase_config, clearcase_progpath, clearcase_version, clearcase_patches
ClearCase::Config contains all the environment and platform-specific configuration settings
and attributes for the version of ClearCase running on the host system.
Configuration settings may be obtained by invoking the
clearcase_config function and passing it the name of one or more attributes.
The set of ClearCase attribute names currently supported are as follows:
Path to Atria home directory
Path to Atria administration directory
Path to ClearCase bin programs
Path to ClearCase etc programs
Path to ClearCase log file directory
Extended naming symbol, usually ``@@''
View root directory, usually ``/view''
The full pathname to the cleartool executable program
For the sake of convenience, the user may use the abbreviation
CLEARCASE_ appears above; and
CT_ may be used anywhere that
CLEARTOOL_ appears above. Any combination of uppercase and lowercase characters may be
used but they will always be mapped to uppercase when computing the
Queries ClearCase configuration attributes:
my $scalar = clearcase_config($attr_name); my @array = clearcase_config $attr1_name, $attr2_name; my %hash = clearcase_config;
clearcase_config takes zero or more configuration attribute names. If no attribute names are
given, then a hash is returned where the attribute names are keys in the
hash and the values are the corresponding attribute settings. If one or
more attribute names are given, then the value of each corresponding
attribute setting is returned (which will result in an array if more than
one name was given).
Obtains the program
path(s) to the named ClearCase
my $progpath = clearcase_progpath($progname); my @pathnames = clearcase_progpath $prog1_name, $prog2_name;
clearcase_progpath takes zero or more ClearCase program names. If no program names are given,
then a hash is returned where the program names are keys in the hash and
the values are the corresponding program paths. If one or more program
names are given, then the pathname of each corresponding program is
returned (which will result in an array if more than one name was given).
Version information for ClearCase applications:
my $ct_ver = clearcase_version 'cleartool'; my $cc_ver = clearcase_version 'ClearCase'; my ($cmk_ver, $mvfs_ver) = clearcase_version qw(clearmake MVFS);
clearcase_version takes the name of one or more ClearCase tools or products and returns the
version identifier corresponding to each one. Valid tool/product names are:
installed version of ClearCase
installed version of the Multi-Version File System
installed version of cleartool command
installed version of multitool command (undefined if MultiSite is not installed)
installed version of xcleartool command
installed version of clearmake command
installed version of the abe command
installed version of view_server
installed version of vobrpc_server
installed version of db_server
Patch-level information for ClearCase installations:
my $was_installed = clearcase_patches $patchname; my @installed_patches = clearcase_patches;
clearcase_patches takes the name of one or more ClearCase patch- names and returns a true
value if each of the named patches has been installed on the system. If no
arguments are given, then it returns a list of names of installed patches.
Brad Appleton <email@example.com>