dcpistats - Print statistics comparing profile data
dcpistats [-v] [-i] [-event name] [-keep percentage] [-range percentage] [-p image-file-name] [-m map-file-name] -set [-factor n] [...]
- -v
- Verbose. Print out additional information.
- -i
- Calculate statistics per image. The default is per procedure.
- -event name
- Print statistics for the named event type. The default is cycles.
- -keep percentage
- List just enough top procedures to account for the top p percent of the total samples of the event type. The value p may be a floating point number in the range [0..100].
- -range percentage
- Do not print a procedure (or image) if its normalized range is less than p percent. The value p may be a floating point number in the range [0..100].
- -p image-file-name
- Use the specified image file as a candidate when associating profiles with named image files. This option can be repeated, allowing several image names to be specified on the command line.
- -m map-file-name
- Use specified map file generated by dcpiscan(1) for associating profiles with named images. This option can be repeated, allowing several map files to be specified; information from all of the supplied map files is merged. The -m option works like the -p option, except that instead of specifying one image at a time, a whole set of images can be entered into a map file via dcpiscan(1) and the entire set can be specified with one command line option. A default map for common Digital Unix 3.2 and 4.0 binaries is compiled into dcpid; specifying additional maps will allow dcpistats to find site-specific binaries.
- -set
- Denote the start of a set of sample files. All samples within a set are combined, and samples across different sets are compared.
- -factor n
- Scale the samples in the set by n. The sample counts in the set are multiplied by n.
By default, this command automatically finds all of the relevant profile files. The following options can be used to guide the search for the profile files.
- -db <directory name>
- Search for profile files in the specified profile database directory. The directory name should be the same name as the one specified when dcpid was started. I.e., the named directory should contain a set of epochs. If this option is not specified, the directory name is obtained from the DCPIDB environment variable. If neither this option, nor the DCPIDB environment variable are set, the name of the directory used by the last invocation of dcpid on this machine is used. If none of these methods succeed in finding the appropriate directory, and no explicit set of profile files is provided via the -profiles option, then the command fails.
- -epoch latest
- Search for profile files in the latest epoch. This is the default.
- -epoch latest-k
- Search for profile files in the "k+1"th oldest epoch. For example, search in the third last epoch if "-epoch latest-2" is specified.
- -epoch all
- Search for profile files in all epochs.
- -epoch <name>
- Search for profile files in the named epoch. The epoch name should be the name of a subdirectory corresponding to a single epoch within the profile database directory. Epoch subdirectory names usually take the form YYMMDDHHMM (year-month-day-hours-minutes). For example, an epoch started on December 4, 1996 at 23:34 is named 9612042334. If an epoch is given a symbolic name by creating a symbol link to the actual epoch directory, then the symbolic name can also be used as an argument to the -epoch option.
- -events all
- Search for profile files corresponding to all event types such as cycles, icache misses, branch mispredictions, etc. This is the default.
- -events type(+type)*
- Search for profiles files for the specified event types. For example, search for cycles, icache misses, and data cache misses when the option -events cycles+imiss+dmiss is specified.
- -events all(-type)*
- Search for profile files for all event types except for the specified types. For example, search for all event types except for branch mispredictions when the option -events all-branchmp is specified.
- -label <label>
- Search for profile files with the specified label (see dcpilabel). If no labels are specified on the command line, profile file labels are ignored entirely. If any labels are specified on the command line (this option can be repeated several times), only profile files that have one of the specified labels are used.
- -profiles <file names...> --
- Use just the profile files named by the specified file names. The list of profile file names can be terminated either via --, or by the end of the option list. The command prints an error message and fails if the -profiles option is used in conjunction with any of the earlier automatic profile finding options. (Use either the automatic profile lookup mechanism, or explicitly name the profile file with the -profile option, but not both.)
Dcpistats compares sets of raw sample counts and prints various statistics about them. It runs dcpiprof(1) for each set of samples (separated by the -set flag), parses the output and prints the normalized range, mean, min, max and standard deviation for each procedure (or image) across all sets of samples. Dcpistats is useful for comparing variations across multiple runs of the same program, or for comparing differences between slightly different versions of a program.The entries are sorted by the normalized range, i.e. the difference between the maximum and minimum sample counts over the total number, expressed as a percentage. This helps focus attention on the entries with the largest variations across the sample sets.
The image files can be the same or different across different sets of samples. Dcpistats bins the data according to procedure name (or image name). If the same procedure name shows up in multiple images, it will list the different images.
- dcpistats -i -set -epoch latest -set -epoch latest-1 -set -epoch latest-2
- Use dcpistats to compare the cycle counts across images for the sample files from the last three epochs.
- dcpistats -set -factor 1.5 -epoch latest -set -epoch latest-1
- Use dcpistats to compare two different sets of sample files. All sample counts in the first set are multiplied by 1.5.
- dcpistats -keep 95 -range 50 ...
- Stop printing statistics after accounting for 95% of the samples, and do not print entries if the normalized range is less than 50%.
dcpi(1), dcpiflow(1), dcpiprof(1), dcpilist(1), dcpidis(1), dcpiscan(1), dcpiepoch(1), dcpiflush(1), dcpicalc(1), dcpilabel(1), dcpi2ps(1), dcpicat(1), dcpiquit(1), dcpidiff(1), dcpitopstalls(1), dcpiwhatcg(1), dcpictl(1), dcpisource(1), dcpicc(1), dcpiversion(1), dcpiuninstall(1), dcpi2pix(1), dcpikdiff(1), dcpix(1), dcpisumxct(1), dcpid(1), dcpiformat(4), dcpiloader(5)
For more information, see the DIGITAL Continuous Profiling Infrastructure project home page (http://www.research.digital.com/SRC/dcpi/ from outside DIGITAL).
Jennifer AndersonThis page was generated automatically by mtex software.