rename a net
Syntax
rename_net ‑to <arg> [‑quiet] [‑verbose] <net>...
Usage
Name | Description |
---|---|
-to
|
New name |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<net>
|
Net to rename |
Categories
Description
Rename a net in the current synthesized or implemented design.
The following are limitations with regard to renaming nets:
- You cannot rename nets that have DONT_TOUCH or MARK_DEBUG properties set to TRUE.
- You cannot rename individual bits of a bus net, but you can collectively rename the whole bus.
write_checkpoint
command, or may be exported to a netlist file such as Verilog, VHDL, or EDIF, using the appropriate write_*
command.
Changes to the names of cells, nets, pins, and ports, will also affect the design constraints defined in the in-memory design. Constraints are automatically modified to target the new object name, however these are not written back to the source XDC file. Saving the modified in-memory design using write_checkpoint
will save both the renamed objects and modified constraints.
This command returns nothing if successful, or an error if it fails.
Arguments
-to <arg>
- (Required) Specify the new name to assign to the specified net. Specified names can not contain Tcl special characters: '"\{};$#
-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.
<net>
- (Required) Name of a net to rename.
Examples
The following example renames the specified bus signal:
rename_net -to dataOut dout