Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

vfoGRCleanVersionCache

vfoGRCleanVersionCache(
t_libName
[ ?cellName t_cellName ]
[ ?viewName t_viewName ]
)
=> t / nil

Description

Updates the index.pcl and cache.pcl files by removing any unused entries of sub-masters from these files. This is an alternative to cleaning the cache if you have disabled the automatic FGR cache cleaning mechanism described in the Automatic Cache Cleaning section, or even if the Automatic Cache Cleaning mechanism is enabled by you and would like to clean the FGR caches on-demand.

You should ensure that you save any changes done in the layout cellview before you run this SKILL function.

Arguments

t_libName

Specifies the library name for which you want to run FGR cache cleaning.

?cellName t_cellName

If a cell name is specified, only cells with the given name are processed and all others are ignored. All views for the given cell name are processed, and cache.pcl and index.pcl files are updated in all views of the specified cell name. If no cell name is specified, all cells are processed, and cache.pcl and index.pcl are updated.

?viewName t_viewName

If a view name is specified, only the specified view name is processed for all cells specified in the t_cellName argument. If a view name is not specified, all views of each cell are processed, and index.pcl and cache.pcl files are updated.

Value Returned

t

The function completed successfully.

nil

The function did not complete successfully.

Example

If the index.pcl file contain unused entries of sub-masters, the vfoGRCleanVersionCache function cleans the unused entries, and the file size will be reduced.

fileLength("reflib/test1/layout2/cache.pcl")
>111196
fileLength("reflib/test1/layout2/index.pcl")
>3624
vfoGRCleanVersionCache("reflib" ?cellName "test1")
fileLength("reflib/test1/layout2/cache.pcl")
>35408
fileLength("reflib/test1/layout2/index.pcl")
>1218

Return to top
 ⠀
X