Operation and Use, Volume 2

Subcommands of the pvt command

exit subcommand (of the pvt command)

exit

The exit subcommand ends the command line session.

export subcommand (of the pvt command)

export output_file_name

The export subcommand allows you to export profile data to a specified file. The suffix .txt will be appended to the specified file name.

The currently loaded profile data is written to the user-specified file in plain text format, so the data can be loaded easily into a spreadsheet tool, like Lotus 1-2-3. The data that is loaded into the tool can be grouped into the following types of records:

• Profile-session records associated with each process
• Individual function or thread records
• Function statistics records.

load subcommand (of the pvt command)

load one_or_more_file_names

The load subcommand loads a set of profile data files into the session. If a set of data already exists, then the existing data is discarded and the newly loaded data becomes the current data to be used in future actions.

report subcommand (of the pvt command)

report [list | output_file_name | "one_or_more_report_names" output_file_name |
"one_or_more_report_ids" output_file_name]

The report subcommand generates textual reports on the profile data. To show a list of available report types, enter:

report list

The result of the command will look something like:

• [0] call_count: function call count report
• [1] wclock: wall clock timer report
• [2] ru_cpu: CPU usage reports
• [3] ru_mem: memory usage report
• [4] ru_paging: paging activities reports
• [5] ru_cswitch: context switch activities reports
• [6] pmc_cycle: instructions per cycle hardware counter reports
• [7] pmc_fpu: floating point hardware counter reports
• [8] pmc_fxu: fixed-point hardware counter reports
• [9] pmc_branch: branch hardware counter reports
• [10] pmc_lsu: load and store hardware counter reports
• [11] pmc_cache: cache hardware counter reports
• [12] pmc_misc: miscellaneous hardware counter reports

To generate all the available reports to a file, enter:

report output_file_name 

To generate reports by report name, enter:

report "one_or_more_report_names" output_file_name 

For example:

report "wclock,ru_cpu" output

To generate reports by report id, enter:

report "one_or_more_report_ids" output_file_name 

For example:

report "1,2" output

The report names or report ids in double quotes must be separated by a comma with no blank space in between. No matter how many reports are selected in one report command, all the reports are outputted to a single file specified in the report command.

sum subcommand (of the pvt command)

sum summary_file_name

The sum subcommand creates a summary file of all the loaded data. The merged summary data is written to the file specified in the command.