Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Error Codes

All the cluster FFT functions return an integer value denoting the status of the operation. These values are identified by named constants. Each function returns DFTI_NO_ERROR if no errors were encountered during execution. Otherwise, a function generates an error code. In addition to FFT error codes, the cluster FFT interface has its own ones. The named constants specific to the cluster FFT interface have the CDFT prefix in their names. Table "Error Codes that Cluster FFT Functions Return" lists error codes that the cluster FFT functions may return.

Error Codes that Cluster FFT Functions Return

Named Constants

Comments

DFTI_NO_ERROR

No error.

DFTI_MEMORY_ERROR

Usually associated with memory allocation.

DFTI_INVALID_CONFIGURATION

Invalid settings of one or more configuration parameters.

DFTI_INCONSISTENT_CONFIGURATION

Inconsistent configuration or input parameters.

DFTI_NUMBER_OF_THREADS_ERROR

Number of OMP threads in the computation function is not equal to the number of OMP threads in the initialization stage (commit function).

DFTI_MULTITHREADED_ERROR

Usually associated with a value that OMP routines return in case of errors.

DFTI_BAD_DESCRIPTOR

Descriptor is unusable for computation.

DFTI_UNIMPLEMENTED

Unimplemented legitimate settings; implementation dependent.

DFTI_MKL_INTERNAL_ERROR

Internal library error.

DFTI_1D_LENGTH_EXCEEDS_INT32

Length of one of the dimensions exceeds 232 -1 (4 bytes).

CDFT_SPREAD_ERROR

Data cannot be distributed (For more information, see Distributing Data among Processes.)

CDFT_MPI_ERROR

MPI error. Occurs when calling MPI.