4.3. 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 host thread and resets it to cudaSuccess.

Note:

Note that this function may also return error codes from previous, asynchronous launches.

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 host thread. Note that this call does not reset the error to cudaSuccess like cudaGetLastError().

Note:

Note that this function may also return error codes from previous, asynchronous launches.

See also:

cudaGetLastError, cudaGetErrorName, cudaGetErrorString, cudaError