prof-src-root, Qprof-src-root

Lets you use relative directory paths when looking up profile data and specifies a directory as the base.

IDE Equivalent

None

Architectures

IA-32, Intel® 64 architectures

Syntax

Linux and Mac OS X:

-prof-src-root=dir

Windows:

/Qprof-src-root:dir

Arguments

dir

Is the base for the relative paths.

Default

OFF	The setting of relevant options determines the path used when looking up profile data records.

Description

This option lets you use relative directory paths when looking up profile data in .dpi files. It lets you specify a directory as the base. The paths are relative to a base directory specified during the -prof-gen (Linux and Mac OS X) or /Qprof-gen (Windows) compilation phase.

This option is available during the following phases of compilation:

Linux and Mac OS X: -prof-gen and -prof-use phases
Windows: /Qprof-gen and /Qprof-use phases

When this option is specified during the -prof-gen or /Qprof-gen phase, it stores information into the .dyn or .dpi file. Then, when .dyn files are merged together or the .dpi file is loaded, only the directory information below the root directory is used for forming the lookup key.

When this option is specified during the -prof-use or /Qprof-use phase, it specifies a root directory that replaces the root directory specified at the -prof-gen or /Qprof-gen phase for forming the lookup keys.

To be effective, this option or option -prof-src-root-cwd (Linux and Mac OS X) or /Qprof-src-root-cwd (Windows) must be specified during the -prof-gen or /Qprof-gen phase. In addition, if one of these options is not specified, absolute paths are used in the .dpi file.

Alternate Options

None

Consider the initial /Qprof-gen or -prof-gen compilation of the source file c:\user1\feature_foo\myproject\common\glob.c shown below:

Windows* OS: icl /Qprof-gen /Qprof-src-root=c:\user1\feature_foo\myproject -c common\glob.c

Linux* and Mac OS* X: icc -prof-gen -prof-src-root=c:\user1\feature_foo\myproject -c common\glob.c

For the /Qprof-use or -prof-use phase, the file glob.c could be moved into the directory c:\user2\feature_bar\myproject\common\glob.c and profile information would be found from the .dpi when using the following:

Windows* OS: icl /Qprof-use /Qprof-src-root=c:\user2\feature_bar\myproject -c common\glob.c

Linux* and Mac OS* X: icc -prof-use -prof-src-root=c:\user2\feature_bar\myproject -c common\glob.c

If you do not use option /Qprof-src-root or -prof-src-root during the /Qprof-gen or -prof-gen phase, by default, the /Qprof-use or -prof-use compilation can only find the profile data if the file is compiled in the c:\user1\feature_foo\my_project\common directory.