HOME
| OPENMP API Specification: Version 5.1 November 2020

4.6.3  Lookup Entry Points: ompt_function_lookup_t

Summary The ompt_function_lookup_t type is the type signature of the lookup runtime entry points that provide pointers to runtime entry points that are part of the OMPT interface.

Format

SVG-Viewer needed.

 

 
typedef void (*ompt_interface_fn_t) (void); 
 
typedef ompt_interface_fn_t (*ompt_function_lookup_t) ( 
  const char *interface_function_name 
);  

SVG-Viewer needed.

Description An OpenMP implementation provides a pointer to a lookup routine that provides pointers to OMPT runtime entry points. When the implementation invokes a tool initializer to configure the OMPT callback interface, it provides a lookup function that provides pointers to runtime entry points that implement routines that are part of the OMPT callback interface. Alternatively, when it invokes a tool initializer to configure the OMPT tracing interface for a device, it provides a lookup function that provides pointers to runtime entry points that implement tracing control routines appropriate for that device.

If the provided function name is unknown to the OpenMP implementation, the function returns NULL. In a compliant implementation, the lookup function provided by the tool initializer for the OMPT callback interface returns a valid function pointer for any OMPT runtime entry point name listed in Table 4.1.

A compliant implementation of a lookup function passed to a tool’s ompt_device_initialize callback must provide non-NULL function pointers for all strings in Table 4.4, except for ompt_set_trace_ompt and ompt_get_record_ompt, as described in Section 4.2.5.

Description of Arguments The interface_function_name argument is a C string that represents the name of a runtime entry point.

Cross References