Code Profiling Utilities Manual

Converting Raw Data Files to DPI Files
HP Code Profiling Utilities Manual—542684-003
5-5
Verify Output
-prof_dir directory-or-subvolume
specifies the name of a directory or subvolume relative to which profmrg looks for
its input files and creates its output file. By default, profmrg uses the current
working directory (Windows, OSS) or the default subvolume (Guardian). Filenames
specified in the -prof_dpi and -a options are concatenated with the directory or
subvolume name specified in this option.
-prof_dpi filename
specifies the name of the DPI file that profmrg creates, overriding the default name
pgopti.dpi (Windows, OSS) or pgodpi (Guardian). There is no rule for the format of
the filename; for example, on OSS or Windows, it need not contain the string .dpi.
If the -prof_dir option is also present in the command, the filename is
concatenated with the name given in the -prof_dir option.
Verify Output
The desired output from profmrg is a DPI file. Verify that such a file has been
produced. Also, check the standard error file for status messages and the standard
output file if you requested a dump with the -dump option.
The Output DPI File
The profmrg utility creates an output DPI file whose name is pgopti.dpi (Windows,
OSS) or pgodpi (Guardian), unless you specify a different name with the -prof_dpi
option.
Usually, if profmrg finds an existing DPI file with the same name as the output file, it re-
creates the DPI file, on the assumption that doing so will result in the latest usage
information. However, in certain cases, profmrg decides that an existing DPI File would
have the same content if re-created; in such cases, profmrg leaves the existing file
alone. Specifically, this behavior arises if the existing DPI file is newer than the input
raw data files, and no other DPI files are specified as input. In other words, profmrg
assumes that the existing DPI file was created from the same set of input files and is
not just some other file that happened to be copied to the same location.
On the other hand, if you specify the -a option, profmrg does re-create the output DPI
file, even if the existing file was newer than all the raw data files and DPI files provided
as input. That is, profmrg does not assume that DPI files specified with -a are already
reflected in an existing DPI file in the input directory or subvolume.
profmrg Use of Standard Error and Output Files
The profmrg utility writes all its output to the standard error file (stderr), except that
output from the -dump option is written to standard output (stdout).
If profmrg does not recognize an option on the command line, it displays a message to
that effect and a brief syntax message. Similarly, if an option that requires a parameter