Deprecations by version

Deprecations by version#

Announced in hipBLAS 0.49#

Replace inplace hipblasXtrmm with out of place hipblasXtrmm#

The hipblasXtrmm API, along with batched versions, will be changing in hipBLAS 1.0 release to allow in-place and out-of-place behavior. This change will introduce an output matrix ‘C’, matching the rocblas_xtrmm_outofplace API and the cublasXtrmm API.

Announced in hipBLAS 0.53#

Remove packed_int8x4 datatype#

The packed_int8x4 datatype will be removed in hipBLAS 1.0. There are two int8 datatypes:

  • int8_t

  • packed_int8x4

int8_t is the C99 unsigned 8 bit integer. packed_int8x4 has 4 consecutive int8_t numbers in the k dimension packed into 32 bits. packed_int8x4 is only used in hipblasGemmEx. int8_t will continue to be available in hipblasGemmEx.

Announced in hipBLAS 1.0#

Replace Legacy BLAS in-place trmm functions with trmm functions that support both in-place and out-of-place functionality#

Use of the deprecated Legacy BLAS in-place trmm functions will give deprecation warnings telling you to compile with -DHIPBLAS_V1 and use the new in-place and out-of-place trmm functions.

Note that there are no deprecation warnings for the hipBLAS Fortran API.

The Legacy BLAS in-place trmm calculates B <- alpha * op(A) * B. Matrix B is replaced in-place by triangular matrix A multiplied by matrix B. The prototype in the include file rocblas-functions.h is:

hipblasStatus_t hipblasStrmm(hipblasHandle_t    handle,
                             hipblasSideMode_t  side,
                             hipblasFillMode_t  uplo,
                             hipblasOperation_t transA,
                             hipblasDiagType_t  diag,
                             int                m,
                             int                n,
                             const float*       alpha,
                             const float*       AP,
                             int                lda,
                             float*             BP,
                             int                ldb);

hipBLAS 1.0 deprecates the legacy BLAS trmm functionality and replaces it with C <- alpha * op(A) * B. The prototype is:

hipblasStatus_t hipblasStrmmOutofplace(hipblasHandle_t    handle,
                                       hipblasSideMode_t  side,
                                       hipblasFillMode_t  uplo,
                                       hipblasOperation_t transA,
                                       hipblasDiagType_t  diag,
                                       int                m,
                                       int                n,
                                       const float*       alpha,
                                       const float*       AP,
                                       int                lda,
                                       const float*       BP,
                                       int                ldb,
                                       float*             CP,
                                       int                ldc);

The new API provides the legacy BLAS in-place functionality if you set pointer C equal to pointer B and ldc equal to ldb.

There are similar deprecations for the _batched and _strided_batched versions of trmm.

Removed in hipBLAS 1.0#

HIPBLAS_INT8_DATATYPE_PACK_INT8x4 hipblasGemmEx support removed#

Packed int8x4 was removed as support for arbitrary dimensioned int8_t data is a superset of this functionality:

  • enum hipblasInt8Datatype_t was removed

  • function hipblasSetInt8Datatype was removed

  • function hipblasGetInt8Datatype was removed

Contents