Excluding Thread Data Sharing Events from Detection

It can be useful to prevent the debugger from detecting particular thread data sharing events and displaying them in the Thread Data Sharing Events window, such as when the event displayed is a false positive result. You can filter the thread data sharing analysis for different access types and exclude them from further detection.

To exclude data sharing events from further detection:

In the Thread Data Sharing Events window, right-click the event you want to exclude from further data sharing detection. The pop-up menu of the Thread Data Sharing Events window appears.

Select Suppress Reporting of Future Accesses and choose one of the following access types:

Option	Description
From this Access	Excludes thread data sharing detection for the access that generated the selected event.
From this Function	Excludes all thread data sharing detections for the function that generated the selected event.
From this Source File	Excludes all thread data sharing detections for the source file that generated the selected event.
From this Source Line	Excludes all thread data sharing detections for the source line that generated the selected event.
To this Data Object	Excludes all thread data sharing detections for the data object that generated the selected event.

Alternatively, enter one of the following commands:

Command	Description
`idb sharing filter add file filename`	Ignores data sharing events in the named file.
`idb sharing filter add function function_name`	Ignores data sharing events in the named function.
`idb sharing filter add range start_address, end_address`	Ignores data sharing events in the address range you specify.
`idb sharing filter add variable variable [, size]`	Ignores data sharing events on the specified variable.

The Intel® Debugger will ignore any further access from the selected type and not detect data sharing events for it.

Note

You cannot exclude events already displayed in the Thread Data Sharing Events window. To remove an analysis, right-click it in the Thread Data Sharing Events window and select Delete from the pop-up menu. To clear all history data from the runtime library, select Reset Current Detection from the pop-up menu.

Example: Excluding Thread Data Sharing Events (C++)

A code line

i += x;

involves three memory accesses:

a read access on i
a read access on x
a write access on i

Three thread data sharing events are detected for this line.

Right-click one of the detected events and choose From this Source Line.
Rerun the application.

The specified filter excludes all three events from detection because they are generated by the same source line.

Click the Thread Data Sharing Filters button to open the Thread Data Sharing Filters window.
In the Thread Data Sharing Filters window, right-click the filter you just specified and choose Disable.
Rerun the application.
Right-click one of the detected events and choose From this Access.
Rerun the application.

The specified filter excludes only the selected event, because it was generated by one particular access.

Excluding Thread Data Sharing Events from Detection

Note

Example: Excluding Thread Data Sharing Events (C++)

See Also