A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-5440AE58-A7D4-4FDF-9997-19319244B3CC
Visible to Intel only — GUID: GUID-5440AE58-A7D4-4FDF-9997-19319244B3CC
Unified Shared Memory Allocations
Unified Shared Memory (USM) allows a program to use C/C++ pointers for memory access. There are three ways to allocate memory in SYCL:
malloc_device:
Allocation can only be accessed by the specified device but not by other devices in the context nor by host.
The data stays on the device all the time and thus is the fastest choice for kernel execution.
Explicit copy is needed to transfer data to the host or other devices in the context.
malloc_host:
Allocation can be accessed by the host and any other device in the context.
The data stays on the host all the time and is accessed via PCI from the devices.
No explicit copy is needed for synchronizing of the data with the host or devices.
malloc_shared:
Allocation can be accessed by the host and the specified device only.
The data can migrate (operated by the Level-Zero driver) between the host and the device for faster access.
No explicit copy is necessary for synchronizing between the host and the device, but it is needed for other devices in the context.
The three kinds of memory allocations and their characteristics are summarized in the table below.
Memory allocation types |
Description |
Host accessible |
Device accessible |
Location |
|---|---|---|---|---|
host |
allocated in host memory |
yes |
yes, remotely through PCIe or fabric link |
host |
device |
allocated in device memory |
no |
yes |
device |
shared |
allocated shared between host and device |
yes |
yes |
dynamically migrate between host and device |
In a multi-stack, multi-C-slice GPU environment, it is important to note that device and shared USM allocations are associated with the root device. Hence, they are accessible by all the stacks and C-slices on the same device. A program should use root device for malloc_device and malloc_shared allocations to avoid confusion.
OpenMP USM Allocation API
To align with SYCL USM model, we added three new OpenMP APIs as Intel extensions for users to perform memory allocations based on application, memory size and performance requirements. Their semantics and performance characteristics are detailed in the following subsections.
Host Memory Allocation
This host allocation is easier to use than device allocations since we do not have to manually copy data between the host and the device. Host allocations are allocations in host memory that are accessible on both the host and the device. These allocations, while accessible on the device, cannot migrate to the device’s attached memory. Instead, offloading regions that read from or write to this memory do it remotely through either PCIe bus or fabric link. This tradeoff between convenience and performance is something that we must take into consideration. Despite the higher access costs that host allocations can incur, there are still valid reasons to use them. Examples include rarely accessed data or large data sets that cannot fit inside device attached memory. The API to perform host memory allocation is:
extern void *omp_target_alloc_host(size_t size, int device_num)
Device Memory Allocation
This kind of allocation is what users need in order to have a pointer into a device’s attached memory, such as (G)DDR, or HBM on the device. Device allocations can be read from or written to by offloading regions running on a device, but they cannot be directly accessed from code executing on the host. Trying to access a device allocation on the host can result in either incorrect data or a program crashing. The API to perform device memory allocation is:
extern void *omp_target_alloc_device(size_t size, int device_num)
Shared Memory Allocation
Like host allocations, shared allocations are accessible on both the host and the device. The difference between them is that shared allocations are free to migrate between host memory and device attached memory, automatically, without our intervention. If an allocation has migrated to the device, any offloading region executing on that device accessing it will do so with greater performance than remotely accessing it from the host. However, shared allocations do not give us all the benefits without any drawbacks such as page migration cost and ping-pong effects:
extern void *omp_target_alloc_shared(size_t size, int device_num)
USM Support for omp_target_alloc API
The OpenMP API for target memory allocation is implemented based on “#pragma omp requires unified shared memory” and the environment LIBOMPTARGET_USM_HOST_MEM to support three kinds of memory allocation. The implement logic is described as below.
if (exists(“#pragma omp requires unified_shared_memory”)) {
if (LIBOMPTARGET_USM_HOST_MEM == 1)
return "host memory";
else
return "shared memory";
} else {
return "device memory";
}