use_device_addr Clause

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

5.4.10 use_device_addr Clause


Name: use_device_addr	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 has corresponding storage in the device data environment, references to the list item in the structured block that is associated with the construct on which the use_device_addr clause appears are converted into references to the corresponding list item. If the list item is not a mapped list item, it is assumed to be accessible on the target device. Inside the structured block, the list item has a device address and its storage may not be accessible from the host device. The list items that appear in a use_device_addr clause may include array sections.

If a list item in a use_device_addr clause is an array section that has a base pointer, the eﬀect of the clause is to convert the base pointer to a pointer that is local to the structured block and that contains the device address. This conversion may be elided if the list item was not already mapped.

Restrictions

Restrictions to the use_device_addr clause are as follows:

Each list item must have a corresponding list item in the device data environment or be accessible on the target device.
Each list item must not be a structure element.

∙ If a list item is an array section, the base expression must be a base language identiﬁer.

∙ If a list item is an array section, the designator of the base expression must be a name without any selectors.

Cross References

target data directive, see Section 13.5

[next] [prev] [prev-tail] [front] [up]