Description

The qcfg_compare program is used to compare a LAT configuration datagram with the merged contents of one or more binary LAT configuration files. The differences are presented as a formatted map in which component instances with differences have their map bit set.

The set of binary configuration files may be specified in one of three ways.

The first is to supply the names as parameters to the command, and it is an error if any of these files does not exist.

The second is to supply the list of names, one per line in a text file, using the -l option. Each file specified in this way must exist.

The third is to supply a file name pattern and an optional filter restricting which files are to be considered for inclusion. Without a filter all known file types are candidates, otherwise only those types appearing in the filter list are used. In either case if the pattern contains a "%" character, the list of potential file names is formed by substituting each type in turn for the "%". If there is no "%" character in the pattern, it behaves as if "%.lcb" were appended to it. The candidate list is then trimmed to include only those files that actually exist. The list of valid types can be found in the description of qcfg_parse.

A file base directory, to be prepended to each configuration file name in the resultant set, may be provided via the -b option.

The comparison may be masked by specifying an optional ignore file. In this case, component instances present in the ignore file are ignored when displaying the result of the comparison. But if such instances are displayed (either because all components are being displayed, or because nearby instances have unmasked differences) a match is displayed as "." (instead of "0") and a difference as ":" (instead of "1").

Synopsis

qcfg_compare

[-v] [-i index] [-o outFile] [-m ignFile] [-b cfgBase] { [-l cfgList] | [-c cfgPatt [-f filtSpec]] } dgmFile [cfgFile1... cfgFileN]

Options

-l cfgList	The name of a file containing the names of the configuration files to be read, one per line. Cannot be specified if cfgPatt or any cfgFile parameter is present.
-c cfgPatt	The name pattern for the set of configuration files to be read. Cannot be specified if cfgList or any cfgFile parameter is present.
-f filtSpec	The comma-separated list of types to be used as a filter for the configuration file names.
-b cfgBase	The name of a base directory to be prepended to each configuration file name.
-m ignFile	The name of the ignore map file to be used.
-o outFile	The name of the output file to receive the generated report. The default is to use stdout.
-i index	Causes the index datagram in the datagram file to be used. The default is 1.
-v	Verbose option. Causes the number of configuration files being read to be displayed. If specified twice, also causes complete types with any differences to be displayed, not just the row segments containing differences. If specified three times, causes the complete difference map to be displayed.

Parameters

dgmFile	The name of the datagram file to read.
cfgFileJ	The name of the Jth configuration file to read. Cannot be specified if either cfgList or cfgPatt is present.