Summarizing Waivers - 2025.2 English - UG906

Use the report_waivers command with the following instructions to generate a summary report of all waivers and the violations they waive. This report is available only from the Tcl Console.

1. Run report_cdc, report_drc, and report_methodology before running report_waivers. The report_waivers command only reports statistics that those three commands extract.
2. Rerun report_cdc, report_drc, and report_methodology any time you modify waivers (add or delete). This ensures the statistics are accurate.
3. Run report_waivers from the Tcl Console. This command generates a summary of all defined waivers and the violations they affect waive. You cannot run report_waivers from the GUI.
   • If the statistics are not updated, report_waivers issues one or more warnings depending on which set of waiver information is outdated:

     WARNING: [Vivado_Tcl 4-972] Waiver counts for 'CDC' will be invalid because 
     report_cdc has not been run since waivers were changed; please run the report_cdc 
     command.
     WARNING: [Vivado_Tcl 4-972] Waiver counts for 'DRC' will be invalid because 
     report_drc has not been run since waivers were changed; please run the report_drc 
     command.
     WARNING: [Vivado_Tcl 4-972] Waiver counts for 'METHODOLOGY' will be invalid because 
     report_methodology has not been run since waivers were changed; please run the 
     report_methodology command.

The report from report_waivers includes a summary table and a detailed table for each of the CDC, DRC, and Methodology waivers. The table columns are as follows:

Total Vios

Total number of violations before the waivers apply. This is the number of violations reported without waivers. For multi-bit rules, the total is based on the number of endpoints.

Remaining Vios

Number of violations after the waivers apply. If no violations are waived, this number matches Total Vios. For multi-bit rules, this count is also based on the number of endpoints.

Waived Vios

Number of violations that are waived. If no violations are waived, this number is 0. For multi-bit rules, this count is based on the number of endpoints.

Used Waivers

Number of waivers that waive at least one violation. A single waiver can apply to multiple violations if it uses patterns or wildcards.

Set Waivers

Total number of waivers applied to the design. Ideally, this number matches Used Waivers. If the numbers differ, some waivers do not match any violations.

By default, the detailed tables include only rules that have waivers defined. However, the first summary table includes all violations in the design, whether waived or not.