Skip to content

Latest commit

 

History

History
120 lines (68 loc) · 3.41 KB

Features.md

File metadata and controls

120 lines (68 loc) · 3.41 KB
Raw

Support status

This is a (non-exhaustive) list of HIP features currently (un)supported by chipStar.

For a more detailed matrix of supported functions and features, see the files Host_API_support_matrix.md and Device_API_support_matrix.md.

For an even more detailed per-function support status, see the files Host_API_functions.md and Device_API_functions.md.

CUDA features not present in HIP are unsupported unless explicitly stated otherwise.

Host side

Unsupported / unimplemented APIs

  • hipGraph API

  • hipIpc API (hipIpcGetMemHandle etc)

  • hipModuleOccupancy API

  • texture reference API (hipTexRef, (DEPRECATED in CUDA)

  • surface reference API (DEPRECATED in CUDA)

  • surface object API (hipCreateSurfaceObject, hipDestroySurfaceObject)

  • peer access (hipMemcpyPeer, hipMemcpyPeerAsync, hipDeviceCanAccessPeer, hipDeviceEnablePeerAccess, hipDeviceDisablePeerAccess, etc)

  • hipMemRangeGetAttribute

  • some config APIs (hipDeviceSetCacheConfig, hipDeviceGetCacheConfig hipDeviceSetSharedMemConfig, hipDeviceGetSharedMemConfig, hipSetDeviceFlags, hipGetDeviceFlags, hipFuncSetCacheConfig)

  • primary context API (hipDevicePrimaryCtxRelease, hipDevicePrimaryCtxRetain, hipDevicePrimaryCtxSetFlags)

  • few memory APIs (hipMemPrefetchAsync, hipMemAdvise)

  • Cooperative Groups API

  • Device-side malloc/free

partially supported

  • Texture Objects of 1D/2D type are supported; 3D, LOD, Grad, Cubemap, Gather and Mipmapped textures are not supported

  • hiprtc: Referring global device variables, constants and texture references in the name expressions are not supported.

  • hipFuncGetAttributes - not all attributes are supported, depends on backend

  • hipDeviceGetLimit - only some limits are supported

Device side

Unsupported / unavailable

  • __activemask(), threadfence_system()

  • clock(), clock64()

  • Cooperative Groups Functions

  • Warp Matrix Functions

  • Independent Thread Scheduling

  • Profiler Counter Function

  • Address Space Predicate Functions

  • Address Space Conversion Functions

  • Device-Side Dynamic Global Memory Allocation

  • In-Line Assembly

  • __brkpt()

  • surface functions

Partially supported

  • math library: almost all single/double/half/half2 math functions are available, some math intrinsics functions are available

  • functions that specify rounding (e.g. __fdiv_rd), except conversion functions (as rounding cannot be selected in OpenCL)

  • device intrinsics are mapped to OpenCL's default functions to reduce rounding error differences

  • Warp functions (__all, __any, __ballot): only the non-sync versions are supported

  • Shuffle functions (_shfl{up,down,xor}): only the non-sync versions are supported

  • texture functions: only with certain image types

  • atomic functions: supported but atomics on float/double is emulated using CAS loop

Known issues

  • hiprtc: Valid name expressions with a function pointer cast (e.g. '(void(*)(float *))akernel') fails with misleading messages. For example: "error: address of overloaded function 'akernel' does not match required type ...". This issue prevents disambiguation of overloaded kernels.

  • hiprtc: quoted strings are not preserved due to the way the hipcc handles arguments currently. E.g. -DGREETING="Hello, World!" is treated as two argument ('-DGREETING=Hello,' and 'World!').