PLIST
Feature Only in Professional and Enterprise Editions Profiling is supported only in Visual C++ Professional and Enterprise Editions. For more information, see .
PLIST converts results from a .PBT file into a formatted text file.
Syntax
PLIST [options] inputfile
PLIST reads the command line from left to right, so the rightmost options override contradictory options to the left. None of the options is case sensitive. You must prefix options with a forward slash (/) or a dash (–), and options must be separated by spaces.
PLIST results are sent to STDOUT by default. Use the greater-than (>) redirection character to send these results to a file or device.
PLIST must be run from the directory in which the profiled program was compiled.
| Parameter | Description |
| options | See Options below. |
| inputfile | The .PBT file to be converted by PLIST. |
Options
| Option | Description |
| /C count | Specifies the minimum hit count to appear in the listing. |
| /D directory | Specifies an additional directory for PLIST to search for source files. Use multiple /D command-line options to specify multiple directories. Use this option when PLIST cannot find a source file. |
| /F | Lists full paths in a tab-delimited file. |
| /FLAT | When using function attribution (see PREP /AT), displays function attribution with no indentation. |
| /H[ELP] | Provides a short summary of PLIST options. |
| /INDENT | When using function attribution (see PREP /AT), displays function attribution information in indented format. This is the default display for function attribution if neither /FLAT nor /TAB is selected. |
| /NOLOGO | Suppresses the PLIST copyright message when output is directed to the screen. |
| /PL length | Sets page length (in lines) of output. The length must be 0 or in the range 15 through 255. A length of 0 suppresses page breaks. The default length is 0. |
| /PW width | Sets page width (in characters) of output. The width must be in the range 1 through 511. The default width is 511. |
| /SC | Sorts output by counts, highest first. |
| /SL | Sorts output in the order that the lines appear in the file. This is the default setting. This option is available only for line profiling. |
| /SLS | Forces line count profile output to be printed in coverage format. |
| /SN | Sorts output in alphabetical order by function name. This option is available only for function profiling. |
| /SNS | Displays function timing or function counting information in function coverage format. Sorts output in alphabetical order by function name. |
| /ST | Sorts output by time, highest first. |
| /T | Tab-separated output. Creates a tab-delimited database from the .PBT file for export to other applications. All other options, including sort specifications, are ignored when using this option. |
| /TAB indent | When using function attribution (see PREP /AT), sets tab width for indentation of function information. |
| /? | Provides a summary of PLIST options. |
Environment Variable
| PLIST | Specifies default command-line options. |
If the PLIST environment variable is not specified, the default options for PLIST depend on the profile type, as shown in the following table.
| Profile type | Sort option | Hit count option |
| Function timing | /ST | /C 1 |
| Function counting | /SC | /C 1 |
| Function coverage | /SN | /C 0 |
| Line counting | /SL | /C 0 |
| Line coverage | /SLS | /C 0 |