Product Documentation
Pegasus Interactive User Guide
Product Version 23.11, September 2023

9


Batch Commands

This chapter provides the syntax, descriptions, and examples for the batch utility that can be used in conjunction with the PegasusTM Interactive editing feature.

pegasusGenSnapshot

Allows you to generate snapshot files based on inputs of snapshot name, directory path, layermap and rule deck. In addition, it allows you to define rule selections via a control file. The syntax within the control file is understood by Pegasus and can be used directly for Pegasus sign-off technology enablement. By default, this utility generates a preset file that can be loaded into Pegasus Interactive Snapshot Creator.

Usage:

pegasusGenSnapshot [-h | -help | -v | -version ]

To generate a snapshot via the command line:

pegasusGenSnapshot -name snapshotName -dir dirFilePath [output_arguments] 
-layerMap FilePath [-objectMap FilePath] [-control FilePath] 
[ -comment string ] rulefile1 [rulefile2 ... rulefileN]

To convert existing GUI preset file to snapshot via the command line:

pegasusGenSnapshot -name snapshotName -dir dirFilePath [output_arguments] -preset FilePath

Arguments

-name snapshotName

Mandatory keyword specifies snapshot name.

-dir dirFilePath

Mandatory keyword specifies the snapshot directory path (relative or absolute).

-layerMap FilePath

Mandatory keyword to specify absolute layermap file path that Pegasus Interactive is referenced to. If PegasusInt_DefaultSNPLayerMap is set, this option is not required. However, explicit declaration has priority over this shell variable. Ignored if -preset argument is specified.

-objectMap FilePath

Optional keyword to specify absolute object mapping file path that Pegasus Interactive is referenced to. Ignored if -preset argument is specified.

-control FilePath

Optional keyword to specify the control file containing Pegasus readable syntax for rule selection (select_check or unselect_check) or switches (#define or #undefine). Wildcard (* | ?) is supported for select_check / unselect_check commands. Ignored if -preset argument is specified.

-preset FileName

Input preset file.

-comment string

Optional keyword to specify a description comment for the snapshot. You can specify either single word or several words. In second case, double quotes are needed, such as "description comment". For single word double quotes are optional.

rule_file1 [ … rule_fileN]

Mandatory keyword specifies absolute rule deck path. If PegasusInt_DefaultSNPRuleDeck is set, this option is not required. However, explicit declaration has priority over this shell variable. Ignored if -preset argument is specified.

Pegasus Interactive Snapshot Creator automatically detects layermap in the attached techlib and uses it during creating snapshot. In this case preset file, which is part of snapshot, has empty layerMap field.
LayerMapFile       ""

If you use preset file as input of pegasusGenSnapshot batch utility, you will notice that pegasusGenSnapshot fails with following error:

[ERROR] Pegasus UI: Run Data->Layer Map List [LayerMapFile]: Layer map is not defined and not found in technology library.

To avoid this error you have to specify path to layer map file:

LayerMapFile       "<path to layer map file>"

Output Arguments

-noGenPreset

Optional keyword specifies that preset file for Pegasus Interactive Snapshot Creator should not be generated. Ignored if
-preset argument is specified.

-log FilePath

Optional keyword prints run log to a designated file. If it is not specified, run log is stored in default.snpGen.log at the current working directory.

-h,--help

Prints help message and exits.

-v, -V, -version, --version

Prints Pegasus version and exits.


Return to top
 ⠀
X