Description

The qcfg_report program is used to display the merged contents of one or more binary LAT configuration files. If the same registers are specified in more than one file, earlier read values are overwritten by later ones.

The set of input 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 (-p option) and an optional filter (-f option) 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.

Synopsis

qcfg_report

[-v] [-x] [-o outFile] [-b cfgBase] { [-l cfgList] | [-p cfgPatt [-f filtSpec]] | [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.
-p 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 file names.
-b cfgBase	The name of a base directory to be prepended to each configuration file name.
-o outFile	The name of the output file to receive the generated report. The default is to use stdout.
-x	Causes XML source to be generated instead of a report.
-v	Verbose option. Causes the number of input files being read to be displayed.

Parameters

cfgFileJ

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