2.2.3 Examine the Data-Race Detection Experiment

You can examine a data-race-detection experiment with the Thread Analyzer, the Performance Analyzer, or the er_print utility. Both the Thread Analyzer and the Performance Analyzer present a GUI interface; the former presents a simplified set of default tabs, but is otherwise identical to the Performance Analyzer.

The Thread Analyzer GUI has a menu bar, a tool bar, and a split pane that contains tabs for the various displays. On the left-hand pane, the following three tabs are shown by default:

• The Races tab shows a list of data-races detected in the program. This tab is selected by default.

• The Dual Source tab shows the two source locations corresponding to the two accesses of a selected data-race. The source line where a data-race access occurred is highlighted.

• The Experiments tab shows the load objects in the experiment, and lists error and warning messages.

On the right-hand pane of the Thread Analyzer display, the following two tabs are shown:

• The Summary tab shows summary information about a data-race access selected from the Races tab.

• The Race Details tab shows detailed information about a data-race trace selected from the Races tab.

The er_print utility, on the other hand, presents a command-line interface. The following subcommands are useful for examining races with the er_print utility:

• -races: This reports any data races revealed in the experiment.

• -rdetail race_id: This displays detailed information about the data-race with the specified race_id. If the specified race_id is "all", then detailed information about all data-races will be displayed.

• -header: This displays descriptive information about the experiment, and reports any errors or warnings.

Refer to the collect.1, tha.1, analyzer.1, and er_print.1 man pages for more information.