Commands That Control the Data Space List

Data space commands are applicable only to hardware counter experiments where aggressive backtracking was specified, and for objects in files that were compiled with the -xhwcprof option, which is available on SPARC platforms. See the Sun Studio 12: Fortran User’s Guide, Sun Studio 12: C User’s Guide, or the Sun Studio 12: C++ User’s Guide for further information.

data_objects

Write the list of data objects with their metrics.

data_single name [N]

Write the summary metrics panel for the named data object. The optional parameter N is needed for those cases where the object name is ambiguous. When the directive is on the command-line, N is required; if it is not needed, it is ignored.

data_layout

Write the annotated data object layouts for all program data objects with data-derived metric data, sorted by the current data sort metric values for the structures as a whole. Each aggregate data object is shown with the total metrics attributed to it, followed by all of its elements in offset order, each with their own metrics and an indicator of its size and location relative to 32-byte blocks.

data_metrics metric_spec

Set the data-derived metrics. The metric_spec is defined in Metric Lists.

By default, the data-derived metrics are set to match the function list metrics whenever they are changed. The data-derived metrics corresponding to any visible exclusive metric or inclusive metric that has a data-derived flavor, are set with visibility corresponding to the logical or of the visibility setting for those two.

Static metric settings are copied to the data-derived metrics. If the metric name is not in the list, the metric name is appended to the list.

If metric_spec is omitted, the current data-derived metrics setting is displayed.

A list of all the available metric-name values for the experiments loaded can be obtained with the data_metric_list command.

If the metric_spec has any errors, it is ignored, and the data-derived metrics are left unchanged.

data_sort

Set the sort metric for data objects. The prefix d is needed for dynamic metrics, but may be omitted for static metrics. The data_sort metric must be either a data-derived metric or a static metric.

If multiple metrics are specified, sort by the first visible one that matches. Whenever metrics are set, either explicitly or by default, set the data-derived sort metric based on the function metrics:

• If sorting is by a dynamic metric, either inclusive or exclusive, that has a corresponding data-derived flavor, sort by the corresponding data-derived metric.

• If sorting is by an inclusive or exclusive metric that does not have a data-derived flavor, sort by the first visible data-derived metric.

• If sorting is by a static metric, sort by it.