6.4. Error Handling

This section describes the error handling functions of the CUDA runtime application programming interface.

Functions

__host____device__ ​const char* cudaGetErrorName ( cudaError_t error )
Returns the string representation of an error code enum name.
__host____device__ ​const char* cudaGetErrorString ( cudaError_t error )
Returns the description string for an error code.
__host____device__cudaError_t cudaGetLastError ( void )
Returns the last error from a runtime call.
__host____device__cudaError_t cudaPeekAtLastError ( void )
Returns the last error from a runtime call.

Functions

__host____device__ ​const char* cudaGetErrorName ( cudaError_t error )
Returns the string representation of an error code enum name.
Parameters
error
- Error code to convert to string
Returns

char* pointer to a NULL-terminated string

Description

Returns a string containing the name of an error code in the enum. If the error code is not recognized, "unrecognized error code" is returned.

See also:

cudaGetErrorString, cudaGetLastError, cudaPeekAtLastError, cudaError, cuGetErrorName

__host____device__ ​const char* cudaGetErrorString ( cudaError_t error )
Returns the description string for an error code.
Parameters
error
- Error code to convert to string
Returns

char* pointer to a NULL-terminated string

Description

Returns the description string for an error code. If the error code is not recognized, "unrecognized error code" is returned.

See also:

cudaGetErrorName, cudaGetLastError, cudaPeekAtLastError, cudaError, cuGetErrorString

__host____device__cudaError_t cudaGetLastError ( void )
Returns the last error from a runtime call.
Description

Returns the last error that has been produced by any of the runtime calls in the same instance of the CUDA Runtime library in the host thread and resets it to cudaSuccess.

Note: Multiple instances of the CUDA Runtime library can be present in an application when using a library that statically links the CUDA Runtime.

Note:

See also:

cudaPeekAtLastError, cudaGetErrorName, cudaGetErrorString, cudaError

__host____device__cudaError_t cudaPeekAtLastError ( void )
Returns the last error from a runtime call.
Description

Returns the last error that has been produced by any of the runtime calls in the same instance of the CUDA Runtime library in the host thread. This call does not reset the error to cudaSuccess like cudaGetLastError().

Note: Multiple instances of the CUDA Runtime library can be present in an application when using a library that statically links the CUDA Runtime.

Note:

See also:

cudaGetLastError, cudaGetErrorName, cudaGetErrorString, cudaError