v++ command executes various Xilinx tools during kernel compilation and linking. These tools
generate many messages that provide build status to you. These messages might or might not be
relevant to you depending on your focus and design phase. The Message Rule file (.mrf) can be used to better manage these messages. It provides
commands to promote important messages to the terminal or suppress unimportant ones. This
helps you better understand the kernel build result and explore methods to optimize the
The Message Rule file is a text file consisting of comments and supported commands. Only one command is allowed on each line.
Any line with “
#” as the first non-white space
character is a comment.
v++ recursively scans the
entire working directory and promotes all error messages to the
v++ output. The
suppress commands below provide more control on the
promote: This command indicates that matching messages should be promoted to the
suppress: This command indicates that matching messages should be suppressed or filtered from the
v++output. Note that errors cannot be suppressed.
Enter only one command per line.
The Message Rule file can have multiple
suppress commands. Each command can have
one and only one of the options below. The options are case-sensitive.
-id [<message_id>]: All messages matching the specified message ID are promoted or suppressed. The message ID is in format of nnn-mmm. As an example, the following is a warning message from HLS. The message ID in this case is 204-68.
WARNING: [V++ 204-68] Unable to enforce a carried dependence constraint (II = 1, distance = 1, offset = 1) between bus request on port 'gmem' (/matrix_multiply_cl_kernel/mmult1.cl:57) and bus request on port 'gmem'-severity [severity_level]
For example, to suppress messages with message ID 204-68, specify the following:
suppress -id 204-68.
-severity [<severity_level>]: The following are valid values for the severity level. All messages matching the specified severity level will be promoted or suppressed.
For example, to promote messages with severity of 'critical-warning', specify the following:
promote -severity critical_warning.
Precedence of Message Rules
suppress rules take precedence over
promote rules. If the same message ID or severity level is
passed to both
suppress commands in the Message Rule file, the matching messages are suppressed and
Example of Message Rule File
The following is an example of a valid Message Rule file:
# promote all warning, critical warning promote -severity warning promote -severity critical_warning # suppress the critical warning message with id 19-2342 suppress -id 19-2342