diff --git a/docs/reference/deprecated_api_list.rst b/docs/reference/deprecated_api_list.rst index bc7e8d7c05..0e16ee5347 100644 --- a/docs/reference/deprecated_api_list.rst +++ b/docs/reference/deprecated_api_list.rst @@ -6,88 +6,173 @@ HIP deprecated runtime API functions ********************************************************************************************** -Several of our API functions have been flagged for deprecation. Using the following functions results in -errors and unexpected results, so we encourage you to update your code accordingly. +Several of our API functions have been flagged for deprecation. Using the +following functions results in errors and unexpected results, so we encourage +you to update your code accordingly. -Context management +Deprecated since ROCm 6.1.0 ============================================================ -CUDA supports cuCtx API, which is the driver API that defines "Context" and "Devices" as separate -entities. Context contains a single device, and a device can theoretically have multiple contexts. HIP -initially added limited support for these APIs in order to facilitate porting from existing driver codes. -These APIs are now marked as deprecated because there are better alternate interfaces (such as -``hipSetDevice`` or the stream API) to achieve these functions. - -* ``hipCtxCreate`` -* ``hipCtxDestroy`` -* ``hipCtxPopCurrent`` -* ``hipCtxPushCurrent`` -* ``hipCtxSetCurrent`` -* ``hipCtxGetCurrent`` -* ``hipCtxGetDevice`` -* ``hipCtxGetApiVersion`` -* ``hipCtxGetCacheConfig`` -* ``hipCtxSetCacheConfig`` -* ``hipCtxSetSharedMemConfig`` -* ``hipCtxGetSharedMemConfig`` -* ``hipCtxSynchronize`` -* ``hipCtxGetFlags`` -* ``hipCtxEnablePeerAccess`` -* ``hipCtxDisablePeerAccess`` -* ``hipDevicePrimaryCtxGetState`` -* ``hipDevicePrimaryCtxRelease`` -* ``hipDevicePrimaryCtxRetain`` -* ``hipDevicePrimaryCtxReset`` -* ``hipDevicePrimaryCtxSetFlags`` - -Memory management +Deprecated texture management functions. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipTexRefGetBorderColor` + * - :cpp:func:`hipTexRefGetArray` + +Deprecated since ROCm 5.7.0 +============================================================ + +Deprecated texture management functions. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipBindTextureToMipmappedArray` + +Deprecated since ROCm 5.3.0 +============================================================ + +Deprecated texture management functions. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipGetTextureReference` + * - :cpp:func:`hipTexRefSetAddressMode` + * - :cpp:func:`hipTexRefSetArray` + * - :cpp:func:`hipTexRefSetFilterMode` + * - :cpp:func:`hipTexRefSetBorderColor` + * - :cpp:func:`hipTexRefSetMipmapFilterMode` + * - :cpp:func:`hipTexRefSetMipmapLevelBias` + * - :cpp:func:`hipTexRefSetMipmapLevelClamp` + * - :cpp:func:`hipTexRefSetMipmappedArray` + +Deprecated since ROCm 4.3.0 +============================================================ + +Deprecated texture management functions. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipTexRefSetFlags` + * - :cpp:func:`hipTexRefSetFormat` + * - :cpp:func:`hipTexRefGetAddress` + * - :cpp:func:`hipTexRefGetAddressMode` + * - :cpp:func:`hipTexRefGetFilterMode` + * - :cpp:func:`hipTexRefGetFlags` + * - :cpp:func:`hipTexRefGetFormat` + * - :cpp:func:`hipTexRefGetMaxAnisotropy` + * - :cpp:func:`hipTexRefGetMipmapFilterMode` + * - :cpp:func:`hipTexRefGetMipmapLevelBias` + * - :cpp:func:`hipTexRefGetMipmapLevelClamp` + * - :cpp:func:`hipTexRefGetMipMappedArray` + * - :cpp:func:`hipTexRefSetAddress` + * - :cpp:func:`hipTexRefSetAddress2D` + * - :cpp:func:`hipTexRefSetMaxAnisotropy` + +Deprecated since ROCm 3.8.0 +============================================================ + +Deprecated memory management and texture management functions. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipBindTexture` + * - :cpp:func:`hipBindTexture2D` + * - :cpp:func:`hipBindTextureToArray` + * - :cpp:func:`hipGetTextureAlignmentOffset` + * - :cpp:func:`hipUnbindTexture` + * - :cpp:func:`hipMemcpyToArray` + * - :cpp:func:`hipMemcpyFromArray` + +Deprecated since ROCm 3.0.0 ============================================================ -* ``hipMallocHost`` (replaced with ``hipHostMalloc``) -* ``hipMemAllocHost`` (replaced with ``hipHostMalloc``) -* ``hipFreeHost`` (replaced with ``hipHostFree``) -* ``hipMemcpyToArray`` -* ``hipMemcpyFromArray`` +The ``hipProfilerStart`` and ``hipProfilerStop`` functions are deprecated. +Instead, you can use ``roctracer`` or ``rocTX`` for profiling which provide more +flexibility and detailed profiling capabilities. + +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left + + * - function + * - :cpp:func:`hipProfilerStart` + * - :cpp:func:`hipProfilerStop` -Profiler control +Deprecated since ROCm 1.9.0 ============================================================ -* ``hipProfilerStart`` (use roctracer/rocTX) -* ``hipProfilerStop`` (use roctracer/rocTX) +CUDA supports cuCtx API, which is the driver API that defines "Context" and +"Devices" as separate entities. Context contains a single device, and a device +can theoretically have multiple contexts. HIP initially added limited support +for context APIs in order to facilitate porting from existing driver codes. These +APIs are now marked as deprecated because there are better alternate interfaces +(such as ``hipSetDevice`` or the stream API) to achieve these functions. +.. list-table:: + :widths: 40 + :header-rows: 1 + :align: left -Texture management + * - function + * - :cpp:func:`hipCtxCreate` + * - :cpp:func:`hipCtxDestroy` + * - :cpp:func:`hipCtxPopCurrent` + * - :cpp:func:`hipCtxPushCurrent` + * - :cpp:func:`hipCtxSetCurrent` + * - :cpp:func:`hipCtxGetCurrent` + * - :cpp:func:`hipCtxGetDevice` + * - :cpp:func:`hipCtxGetApiVersion` + * - :cpp:func:`hipCtxGetCacheConfig` + * - :cpp:func:`hipCtxSetCacheConfig` + * - :cpp:func:`hipCtxSetSharedMemConfig` + * - :cpp:func:`hipCtxGetSharedMemConfig` + * - :cpp:func:`hipCtxSynchronize` + * - :cpp:func:`hipCtxGetFlags` + * - :cpp:func:`hipCtxEnablePeerAccess` + * - :cpp:func:`hipCtxDisablePeerAccess` + * - :cpp:func:`hipDevicePrimaryCtxGetState` + * - :cpp:func:`hipDevicePrimaryCtxRelease` + * - :cpp:func:`hipDevicePrimaryCtxRetain` + * - :cpp:func:`hipDevicePrimaryCtxReset` + * - :cpp:func:`hipDevicePrimaryCtxSetFlags` + +Deprecated since ROCm 1.6.0 ============================================================ -* ``hipGetTextureReference`` -* ``hipTexRefSetAddressMode`` -* ``hipTexRefSetArray`` -* ``hipTexRefSetFilterMode`` -* ``hipTexRefSetFlags`` -* ``hipTexRefSetFormat`` -* ``hipTexRefGetAddress`` -* ``hipTexRefGetAddressMode`` -* ``hipTexRefGetFilterMode`` -* ``hipTexRefGetFlags`` -* ``hipTexRefGetFormat`` -* ``hipTexRefGetMaxAnisotropy`` -* ``hipTexRefGetMipmapFilterMode`` -* ``hipTexRefGetMipmapLevelBias`` -* ``hipTexRefGetMipmapLevelClamp`` -* ``hipTexRefGetMipMappedArray`` -* ``hipTexRefSetAddress`` -* ``hipTexRefSetAddress2D`` -* ``hipTexRefSetMaxAnisotropy`` -* ``hipTexRefSetBorderColor`` -* ``hipTexRefSetMipmapFilterMode`` -* ``hipTexRefSetMipmapLevelBias`` -* ``hipTexRefSetMipmapLevelClamp`` -* ``hipTexRefSetMipmappedArray`` -* ``hipTexRefGetBorderColor`` -* ``hipTexRefGetArray`` -* ``hipBindTexture`` -* ``hipBindTexture2D`` -* ``hipBindTextureToArray`` -* ``hipGetTextureAlignmentOffset`` -* ``hipUnbindTexture`` -* ``hipBindTextureToMipmappedArray`` +Deprecated memory management functions. + +.. list-table:: + :widths: 40, 60 + :header-rows: 1 + :align: left + + * - function + - + * - :cpp:func:`hipMallocHost` + - replaced with :cpp:func:`hipHostMalloc` + * - :cpp:func:`hipMemAllocHost` + - replaced with :cpp:func:`hipHostMalloc` + * - :cpp:func:`hipFreeHost` + - replaced with :cpp:func:`hipHostFree`