Comparing Configurations from the Command-Line

You can also use the command-line interface to traverse and compare two configurations.

The command used to specify the comparison details is as follows:

hedConfigCompare [-outdir <dir>] [-s <numspaces>] [-min] [-subcfg]

[-difftool <toolcmd>] [-cdslib <path>] [-mlstoplimit <limit>] <configSpec1> <configSpec2>

where,

-outdir <dir>—Specifies a directory in which the traversal output files are saved. The default directory is ./configTraversals.
-s <numspace>—Specifies the number of spaces for indentation. The default value is 2 and the value ranges from 1 to 8.
-min—Specifies the minimal traversal, which means traversing through hierarchy by avoiding revisits of the instances that have already been visited.
-subcfg—Specifies whether the traversal results for subconfigurations are included in the output file.
-difftool <toolcmd>—Specifies a tool to be used to display the compare traversal results. if this option is not specified, tkdiff is used to display the results.
-cdslib <path>—Specifies the path from where cdslib file is to be loaded. If this file is not found, the command does not run.
-mlstoplimit <limit> — Specifies the maskLayoutStopLimit value in MB, databases of maskLayout views exceeding the specified limit cannot be opened during the config comparison.
<configSpec1> and <configSpec2>—These commands are described as follows:

{lib.cell:config [-output <outputPath>]} | {<inputPath>}

- lib.cell:config—Specifies an elaborated and traversed configuration view.
- -output <outputPath>—Specifies an output file in which the traversal results are saved. If the output file is not specified, the traversal results are saved in a file in the default output directory.
- inputPath—If you do not want to perform the traversal for the configuration to be compared, you can directly provide the path to the output file.

hedConfigCompare lib1.cell1:config1 lib2.cell2:config2
This command traverses both the configurations and save the traversal results in the following output files:
./configTraversals/lib1.cell1.config1
./configTraversals/lib2.cell2.config2
The command then compares these files.
hedConfigCompare -outdir ./localFiles lib1.cell1:config1 ./localFiles/config2.trav
This command traverses only the first configuration and saves the results in default file in the specified output directory,./localFiles. The command then compares ./localFiles/lib1.cell1.config1 and ./localFiles/config2.trav.
hedConfigCompare lib1.cell1:config1 -output ./localFiles/config1.trav ./localFiles/config2.trav
This command traverses only the first configuration, lib1.cell1:config1, and saves the traversal results in the specified output file, ./localFiles/config1.trav in the default output directory (configTraversals). This command then compares ./localFiles/config1.trav and ./localFiles/config2.trav.
hedConfigCompare lib1.cell1:config1 -output ./localFiles/config1.trav lib2.cell2:config2 -output ./localFiles/config2.trav
This command traverses both the configurations and saves the results to the following files in the default output directory:
./localFiles/config1.trav
./localFiles/config2.trav
The command then compares these output files.