write_waivers - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

Write out one or more DRC/METHODOLOGY/CDC message waivers in command form


write_waivers [‑type <arg>] [‑objects <args>] [‑return_string] [‑force]
    [‑quiet] [‑verbose] [<file>]


Name Description
[-type] Type of waiver(s) - ALL, DRC, METHODOLOGY, CDC, LINT to write
[-objects] List of DRC/METHODOLOGY/CDC waiver objects to be written
[-return_string] Return report results as a string object
[-force] Overwrite existing file
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
[<file>] Name of file to write waivers


Waiver, Object


To save waivers from one design session to the next, you must use write_waivers to create an XDC file of the waiver commands, and read_xdc to read those waivers back into the design when it is reopened.


-type <arg> - (Optional) Specifies the type of waivers to write to the file. Currently supports DRC, METHODOLOGY, and CDC.

-objects <args> - (Optional) Specifies a list of waiver objects to write. Waiver objects can be specified by the get_waivers command.

-return_string - (Optional) Directs the output to a Tcl string. The Tcl string can be captured by a variable definition and parsed or otherwise processed.

-force - (Optional) This argument forces writing of waivers to the file. If you receive a message that the waivers will not be written because the counts will be invalid, you can use this option to write the file.

-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.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

<file> - (Required) Specifies the file name to write.

Note: If the path is not specified as part of the file name, the file will be written into the current working directory, or the directory from which the tool was launched.


This example writes all waivers in the current design:

write_waivers C:/Data/design_waivers.xdc

The following example writes only DRC type waivers:

write_waivers -type DRC C:/Data/drc_waivers.xdc