HOME
| OPENMP API Specification: "Version 5.2 -- GIT rev 95b2e3a44"

5.4.8  use_device_ptr Clause

Name: use_device_ptr

Properties: data-environment attribute, data-sharing attribute

Arguments

Name

Type

Properties

list

list of variable list item type

default

Directives

target data

Semantics

If a list item that appears in a use_device_ptr clause is a pointer to an object that is mapped to the device data environment, references to the list item in the structured block that is associated with the construct on which the clause appears are converted into references to a device pointer that is local to the structured block and that refers to the device address of the corresponding object. If the list item does not point to a mapped object, it must contain a valid device address for the target device, and the list item references are instead converted to references to a local device pointer that refers to this device address.
If a list item that appears in a use_device_ptr clause is of type C_PTR and points to a data entity that is mapped to the device data environment, references to the list item in the structured block that is associated with the construct on which the clause appears are converted into references to a device pointer that is local to the structured block and that refers to the device address of the corresponding entity. If a list item of type C_PTR does not point to a mapped object, it must contain a valid device address for the target device, and the list item references are instead converted to references to a local device pointer that refers to this device address. If a list item in a use_device_ptr clause is not of type C_PTR, the behavior is as if the list item appeared in a use_device_addr clause. Support for such list items in a use_device_ptr clause is deprecated.

Restrictions

Restrictions to the use_device_ptr clause are as follows:

Cross References