|Skip Navigation Links|
|Exit Print View|
|Oracle Solaris Studio 12.3: Debugging a Program With dbx Oracle Solaris Studio 12.3 Information Library|
The collector command collects performance data for analysis by the Performance Analyzer. It is valid only in native mode.
Specify one or more of the collector commands
Specify the mode for archiving an experiment when it terminates (see collector archive Command).
Control the collection of samples when dbx stops the target process (see collector dbxsample Command).
Stop data collection and close the current experiment (see collector disable Command).
Enable the collector and open a new experiment (see collector enable Command).
Enable or disable collection of heap tracing data (see collector heaptrace Command)
Specify hardware counter profiling settings (see collector hw_profile Command).
Limit the amount of profiling data recorded (see collector limit Command).
Enables or disables collection of MPI tracing data (see collector mpitrace Command).
Stop collecting performance data but leave experiment open (see collector pause Command).
Specify settings for collecting callstack profiling data (see collector profile Command).
Start performance data collection after pause (see collector resume Command).
Specify sampling settings (see collector sample Command
Show current collector settings (see collector show Command).
Inquire status about current experiment (see collector status Command).
Experiment file control and settings (see collector store Command).
Specify settings for collecting thread synchronization wait tracing data (see collector synctrace Command).
Specify settings for collecting thread analyzer data (see collector tha Command.
Report the version of libcollector.so that would be used to collect data (see collector version Command).
options are the settings that can be specified with each command.
To start collecting data, type either collector enable.
To turn off data collection, type collector disable.
By default, normal archiving is used. For no archiving, specify off. To copy loadobjects into the experiment for portability, specify copy.
The collector dbxsample command specifies whether or not to record a sample when the process is stopped by dbx.
By default, a sample is collected when the process is stopped by dbx. To not collect a sample at this time, specify off.
The collector disable command causes the data collection to stop and the current experiment to be closed.
The collector enable command enables the collector and opens a new experiment.
The collector heaptrace command specifies options for collecting heap tracing (memory allocation) data.
By default, heap tracing data is not collected. To collect this data, specify on.
The collector hw_profile command specifies options for collecting hardware-counter overflow profiling data.
By default, hardware-counter overflow profile data is not collected. To collect this data, specify on.
Print out the list of available counters.
Specify hardware counter names and intervals.
name is the name of a hardware counter.
interval is the collection interval in milliseconds.
name2 is the name of a second hardware counter.
interval2 is the collection interval in milliseconds.
Hardware counters are system-specific, so the choice of counters available to you depends on the system you are using. Many systems do not support hardware-counter overflow profiling. On these machines, the feature is disabled.
collector limit value | unlimited | none
value, in megabytes, limits the amount of profiling data recorded, and must be a positive number.When the limit is reached, no more profiling data is recorded but the experiment remains open and sample points continue to be recorded. By default, there is no limit on the amount of data recorded.
If you have set a limit, specify unlimited or none to remove the limit.
The collector mpitrace command specifies options for collecting MPI tracing data.
By default, MPI tracing data is not collected. To collect this data, specify on.
The collector pause command causes the data collection to stop but leaves the current experiment open. Sample points are not recorded while the Collector is paused. A sample is generated prior to a pause, and another sample is generated immediately following a resum. Data collection can be resumed with the collector resume command (see collector resume Command).
The collector profile command specifies options for collecting profile data.
Specify profile data collection mode.
Specify profile timer period, fixed or floating point, with an optional trailing m for milliseconds or u for microseconds.
The collector resume command causes the data collection to resume after a pause created by the collector pause command (see collector pause Command).
The collector sample command specifies the sampling mode and the sampling interval.
Specify sampling mode.
Specify sampling interval in seconds.
Record a sample with an optional name.
seconds is the length of the sampling interval.
name is the name of the sample.
The collector show command shows the settings of one or more categories of options.
Show all settings.
Show all settings.
Show archive setting.
Show call stack profiling settings.
Show thread synchronization wait tracing settings.
Show hardware counter data settings.
Show heap tracing data settings.
Show experiment size limits.
Show MPI trace data settings.
Show sample settings.
Show store settings.
Show thread analyzer data settings.
The collector status command inquires about the status of the current experiment.
The collector store command specifies the directory and file name where an experiment is stored.
Specify directory where experiment is stored.
Specify experiment file name.
Specify experiment group name.
pathname is the pathname of the directory where an experiment is to be stored.
filename is the name of the experiment file
string is the name of an experiment group.
The collector synctrace command specifies options for collecting synchronization wait tracing data.
By default, thread synchronization wait tracing data is not collected. To collect this data, specify on.
Specify threshold in microseconds. The default value is 1000.
Threshold value will be calculated automatically.
microseconds is the threshold below which synchronization wait events are discarded.
By default, thread analyzer data is not collected. To collect this data, specify on.
The collector version command reports the version of libcollector.so that would be used to collect data.