6.20  OMP_TOOL_VERBOSE_INIT

The OMP_TOOL_VERBOSE_INIT environment variable sets the tool-verbose-init-var ICV, which controls whether an OpenMP implementation will verbosely log the registration of a tool.

The value of this environment variable must be one of the following:

disabled | stdout | stderr | <filename>

If OMP_TOOL_VERBOSE_INIT is set to any value other than case insensitive disabled, stdout or stderr, the value is interpreted as a filename and the OpenMP runtime will try to log to a file with prefix filename. If the value is interpreted as a filename, whether it is case sensitive is implementation defined. If opening the logfile fails, the output will be redirected to stderr. If OMP_TOOL_VERBOSE_INIT is not defined, the default value for tool-verbose-init-var is disabled. Support for logging to stdout or stderr is implementation defined. Unless tool-verbose-init-var is disabled, the OpenMP runtime will log the steps of the tool activation process defined in Section 4.2.2 to a file with a name that is constructed using the provided filename prefix. The format and detail of the log is implementation defined. At a minimum, the log will contain the following:

• either that tool-var is disabled, or
• an indication that a tool was available in the address space at program launch, or
• the path name of each tool in OMP_TOOL_LIBRARIES that is considered for dynamic loading, whether dynamic loading was successful, and whether the ompt_start_tool function is found in the loaded library.

In addition, if an ompt_start_tool function is called the log will indicate whether or not the tool will use the OMPT interface.

Example:  

 
% setenv OMP_TOOL_VERBOSE_INIT disabled 
% setenv OMP_TOOL_VERBOSE_INIT STDERR 
% setenv OMP_TOOL_VERBOSE_INIT ompt_load.log
  

Cross References

• tool-verbose-init-var ICV, see Section 2.4.
• OMPT Interface, see Chapter 4.