GLAST / LAT > DAQ and FSW > FSW > Doxygen Index> QCFG / V1-1-1 > qcfg_compare / linux-gcc


Interface   Data Structures   File List   Data Fields   Globals  

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 two ways.

The first way 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 way 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.

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] [-m ignFile] [-c cfgPatt [-f filtSpec]] [-o outFile] dgmFile [cfgFile1... cfgFileN]

Options

-c cfgPatt The name pattern for the set of configuration files to be read. Cannot be specified if any cfgFile parameter is present.
-f filtSpec The comma-separated list of types to be used as a filter for the configuration file names.
-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.
-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.

Generated on Wed Aug 19 10:37:45 2009 by  doxygen 1.5.3