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. Named constants specific to the cluster FFT interface have prefix "CDFT
" in names. Table "Error Codes that Cluster FFT Functions Return"
lists error codes that the cluster FFT functions may 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 dimensions exceeds 2 32 -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. |