3.6.6 omp_get_device_from_uid – Obtain the device number to a unique id

Description:

This function returns the device number associated with the passed unique-identifier (UID) string. If no device with this UID is available, the value omp_invalid_device is returned. The effect of running this routine in a target region is unspecified.

GCC treats the UID string case sensitive; for the initial device, GCC currently only accepts the value OMP_INITIAL_DEVICE and returns for it the value of omp_initial_device.

C/C++:
Prototype:int omp_get_device_from_uid(const char *uid);
Fortran:
Interface:integer function omp_get_device_from_uid(uid)
character(len=*), intent(in) :: uid
See also:

omp_get_uid_from_device – Obtain the unique id of a device, Offload-Target Specifics

Reference:

OpenMP specification v6.0, Section 24.7