GUI Reference: Manage Warning Processors

• Navigating To
• Page Properties
• Contents and Usage
• Remove Installed Processors
• Install A New Processor

Important Note: the CodeSonar Web GUI makes extensive use of JavaScript. Make sure JavaScript is enabled in your web browser.

Navigating To

Page Properties

Contents and Usage

The following annotated screenshot shows the various parts of the Manage Warning Processors page.

Uninstall Processors

Follow these instructions to uninstall one or more warning processors on the hub. Note that uninstalled processors will no longer be active on the hub, but the processor executables (and any supporting source files) are not deleted: you can reinstall them later using the procedure for installing a new processor.
You will need WPROCESSOR_DELETE permission for each warning processor you wish to uninstall.

1. Click the Remove Warning Processors button under the table of current processors. The page will expand to provide more functionality, as shown below.

   

   Checkboxes

   The table now includes a column of checkboxes. Click in a checkbox to select the corresponding processor, click again to deselect.

   Check/Uncheck Buttons

   Check All Click to select all processors in the table (including those on other pages of a paged table). Uncheck All Click to unselect all processors in the table (including those on other pages of a paged table). Check These N Click to select all processors on the current page of the table. The number N corresponds to the number of processors on the current page. (Only present if table has multiple pages.) Uncheck These N Click to unselect all processors on the current page of the table. The number N corresponds to the number of processors on the current page. (Only present if table has multiple pages.)

2. Use the checkboxes to select the processor or processors that you want to uninstall.
3. Click the Remove Selected Warning Processors button to uninstall the processors you have selected.
4. The page will be updated to display the new set of installed processors, along with a confirmation message.

Install A New Processor

Follow these instructions to install a new warning processor on the hub.
You will need G_ADD_WPROCESSOR permission.

1. Perform any necessary customizations.
   • Each of the warning processors shipped with CodeSonar provides detailed customization instructions in its main.py file.
2. Make sure the warning processor executable is stored in hubdir/processors/, where hubdir is the hub directory. This is the only permitted location for warning processors.
   1. If necessary, move the warning processor executable there now.
   2. Make sure that permissions are set so that it can be executed.
3. Enter a label for the warning processor in the Label field. The label will be shown in the the table of current processors, and used to identify the processor (where applicable) in the Change Warning section of each Warning Report. Labels should be unique.
4. Enter the file name of the warning processor executable in the Processor Executable field.
5. If you want the processor to be applied automatically to incoming warnings, select the checkbox. If you want the processor to be available for interactive application only, leave the checkbox unselected.
6. Click Install.
7. The page will be updated to display the new set of installed processors, along with a confirmation message showing the warning's label, executable, and display script.