rename a cell ref
Syntax
rename_ref [‑ref <arg>] [‑to <arg>] [‑prefix_all <arg>] [‑quiet] [‑verbose]Usage
| Name | Description |
|---|---|
[-ref]
|
Cell ref to rename |
[-to]
|
New name |
[-prefix_all]
|
Rename all eligible hierarchical cell refs in the current design. Construct the new name using the given prefix plus the original name |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
Categories
Description
Rename the reference name of a single non-primitive cell, or apply a reference prefix to all non-primitive cells in the current synthesized or implemented design.
This command provides a mechanism to change the non-primitive reference names in the current design so that they do not collide with the reference names in another design. This lets two modules or designs be synthesized or simulated together, while avoiding any name collisions between the two designs.
This command returns nothing when renaming the reference a single cell, and returns the number of cells renamed when used with -prefix_all. If the command fails, an error is returned.
Arguments
-ref <arg> - (Optional) Specify the current reference name of a non-primitive cell.
-to <arg> - (Optional) Change the reference name to the specified value.
-prefix_all <arg> - (Optional) Apply the specified prefix to the reference names of all non-primitive cells in the current design, except the top module.
-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config command.Examples
rename_ref -ref usbf_top -to MOD1_usbf_toprename_ref -prefix_all MOD1_