Next: , Previous: , Up: Top   [Contents][Index]

5 OpenACC Runtime Library Routines

The runtime routines described here are defined by section 3 of the OpenACC specifications in version 2.0. They have C linkage, and do not throw exceptions. Generally, they are available only for the host, with the exception of acc_on_device, which is available for both the host and the acceleration device.

• acc_get_num_devices:  Get number of devices for the given device type.
• acc_set_device_type:  Set type of device accelerator to use.
• acc_get_device_type:  Get type of device accelerator to be used.
• acc_set_device_num:  Set device number to use.
• acc_get_device_num:  Get device number to be used.
• acc_async_test:  Tests for completion of a specific asynchronous operation.
• acc_async_test_all:  Tests for completion of all asychronous operations.
• acc_wait:  Wait for completion of a specific asynchronous operation.
• acc_wait_all:  Waits for completion of all asyncrhonous operations.
• acc_wait_all_async:  Wait for completion of all asynchronous operations.
• acc_wait_async:  Wait for completion of asynchronous operations.
• acc_init:  Initialize runtime for a specific device type.
• acc_shutdown:  Shuts down the runtime for a specific device type.
• acc_on_device:  Whether executing on a particular device
• acc_malloc:  Allocate device memory.
• acc_free:  Free device memory.
• acc_copyin:  Allocate device memory and copy host memory to it.
• acc_present_or_copyin:  If the data is not present on the device, allocate device memory and copy from host memory.
• acc_create:  Allocate device memory and map it to host memory.
• acc_present_or_create:  If the data is not present on the device, allocate device memory and map it to host memory.
• acc_copyout:  Copy device memory to host memory.
• acc_delete:  Free device memory.
• acc_update_device:  Update device memory from mapped host memory.
• acc_update_self:  Update host memory from mapped device memory.
• acc_map_data:  Map previously allocated device memory to host memory.
• acc_unmap_data:  Unmap device memory from host memory.
• acc_deviceptr:  Get device pointer associated with specific host address.
• acc_hostptr:  Get host pointer associated with specific device address.
• acc_is_present:  Indiciate whether host variable / array is present on device.
• acc_memcpy_to_device:  Copy host memory to device memory.
• acc_memcpy_from_device:  Copy device memory to host memory. 
API routines for target platforms.
• acc_get_current_cuda_device:  Get CUDA device handle.
• acc_get_current_cuda_context:  Get CUDA context handle.
• acc_get_cuda_stream:  Get CUDA stream handle.
• acc_set_cuda_stream:  Set CUDA stream handle.

Next: , Previous: , Up: Top   [Contents][Index]