jcuda.runtime
Class cudaError

java.lang.Object
  extended by jcuda.runtime.cudaError

public class cudaError
extends java.lang.Object

Error codes


Field Summary
static int cudaErrorAddressOfConstant
          This indicated that the user has taken the address of a constant variable, which was forbidden up until the CUDA 3.1 release.
static int cudaErrorApiFailureBase
          Any unhandled CUDA driver error is added to this value and returned via the runtime.
static int cudaErrorCudartUnloading
          This indicated an issue with calling API functions during the unload process of the CUDA runtime in prior releases.
static int cudaErrorDevicesUnavailable
          This indicates that all CUDA devices are busy or unavailable at the current time.
static int cudaErrorDuplicateSurfaceName
          This indicates that multiple surfaces (across separate CUDA source files in the application) share the same string name.
static int cudaErrorDuplicateTextureName
          This indicates that multiple textures (across separate CUDA source files in the application) share the same string name.
static int cudaErrorDuplicateVariableName
          This indicates that multiple global or constant variables (across separate CUDA source files in the application) share the same string name.
static int cudaErrorECCUncorrectable
          This indicates that an uncorrectable ECC error was detected during execution.
static int cudaErrorIncompatibleDriverContext
          This indicates that the current context is not compatible with this version of the CUDA Runtime.
static int cudaErrorInitializationError
          The API call failed because the CUDA driver and runtime could not be initialized.
static int cudaErrorInsufficientDriver
          This indicates that the installed NVIDIA CUDA driver is older than the CUDA runtime library.
static int cudaErrorInvalidChannelDescriptor
          This indicates that the channel descriptor passed to the API call is not valid.
static int cudaErrorInvalidConfiguration
          This indicates that a kernel launch is requesting resources that can never be satisfied by the current device.
static int cudaErrorInvalidDevice
          This indicates that the device ordinal supplied by the user does not correspond to a valid CUDA device.
static int cudaErrorInvalidDeviceFunction
          The requested device function does not exist or is not compiled for the proper device architecture.
static int cudaErrorInvalidDevicePointer
          This indicates that at least one device pointer passed to the API call is not a valid device pointer.
static int cudaErrorInvalidFilterSetting
          This indicates that a non-float texture was being accessed with linear filtering.
static int cudaErrorInvalidHostPointer
          This indicates that at least one host pointer passed to the API call is not a valid host pointer.
static int cudaErrorInvalidKernelImage
          This indicates that the device kernel image is invalid.
static int cudaErrorInvalidMemcpyDirection
          This indicates that the direction of the memcpy passed to the API call is not one of the types specified by ::cudaMemcpyKind.
static int cudaErrorInvalidNormSetting
          This indicates that an attempt was made to read a non-float texture as a normalized float.
static int cudaErrorInvalidPitchValue
          This indicates that one or more of the pitch-related parameters passed to the API call is not within the acceptable range for pitch.
static int cudaErrorInvalidResourceHandle
          This indicates that a resource handle passed to the API call was not valid.
static int cudaErrorInvalidSurface
          This indicates that the surface passed to the API call is not a valid surface.
static int cudaErrorInvalidSymbol
          This indicates that the symbol name/identifier passed to the API call is not a valid name or identifier.
static int cudaErrorInvalidTexture
          This indicates that the texture passed to the API call is not a valid texture.
static int cudaErrorInvalidTextureBinding
          This indicates that the texture binding is not valid.
static int cudaErrorInvalidValue
          This indicates that one or more of the parameters passed to the API call is not within an acceptable range of values.
static int cudaErrorLaunchFailure
          An exception occurred on the device while executing a kernel.
static int cudaErrorLaunchOutOfResources
          This indicates that a launch did not occur because it did not have appropriate resources.
static int cudaErrorLaunchTimeout
          This indicates that the device kernel took too long to execute.
static int cudaErrorMapBufferObjectFailed
          This indicates that the buffer object could not be mapped.
static int cudaErrorMemoryAllocation
          The API call failed because it was unable to allocate enough memory to perform the requested operation.
static int cudaErrorMemoryValueTooLarge
          This indicated that an emulated device pointer exceeded the 32-bit address range.
static int cudaErrorMissingConfiguration
          The device function being invoked (usually via ::cudaLaunch()) was not previously configured via the ::cudaConfigureCall() function.
static int cudaErrorMixedDeviceExecution
          Mixing of device and device emulation code was not allowed.
static int cudaErrorNoDevice
          This indicates that no CUDA-capable devices were detected by the installed CUDA driver.
static int cudaErrorNoKernelImageForDevice
          This indicates that there is no kernel image available that is suitable for the device.
static int cudaErrorNotReady
          This indicates that asynchronous operations issued previously have not completed yet.
static int cudaErrorNotYetImplemented
          This indicates that the API call is not yet implemented.
static int cudaErrorPriorLaunchFailure
          This indicated that a previous kernel launch failed.
static int cudaErrorSetOnActiveProcess
          This indicates that the user has called ::cudaSetDevice(), ::cudaSetValidDevices(), ::cudaSetDeviceFlags(), ::cudaD3D9SetDirect3DDevice(), ::cudaD3D10SetDirect3DDevice, ::cudaD3D11SetDirect3DDevice(), * or ::cudaVDPAUSetVDPAUDevice() after initializing the CUDA runtime by calling non-device management operations (allocating memory and launching kernels are examples of non-device management operations).
static int cudaErrorSharedObjectInitFailed
          This indicates that initialization of a shared object failed.
static int cudaErrorSharedObjectSymbolNotFound
          This indicates that a link to a shared object failed to resolve.
static int cudaErrorStartupFailure
          This indicates an internal startup failure in the CUDA runtime.
static int cudaErrorSynchronizationError
          This indicated that a synchronization operation had failed.
static int cudaErrorTextureFetchFailed
          This indicated that a texture fetch was not able to be performed.
static int cudaErrorTextureNotBound
          This indicated that a texture was not bound for access.
static int cudaErrorUnknown
          This indicates that an unknown internal error has occurred.
static int cudaErrorUnmapBufferObjectFailed
          This indicates that the buffer object could not be unmapped.
static int cudaErrorUnsupportedLimit
          This indicates that the ::cudaLimit passed to the API call is not supported by the active device.
static int cudaSuccess
          The API call returned with no errors.
static int jcudaInternalError
          An internal JCuda error occurred
 
Method Summary
static java.lang.String stringFor(int error)
          Returns the String identifying the given cudaError
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

cudaSuccess

public static final int cudaSuccess
The API call returned with no errors. In the case of query calls, this can also mean that the operation being queried is complete (see ::cudaEventQuery() and ::cudaStreamQuery()).

See Also:
Constant Field Values

cudaErrorMissingConfiguration

public static final int cudaErrorMissingConfiguration
The device function being invoked (usually via ::cudaLaunch()) was not previously configured via the ::cudaConfigureCall() function.

See Also:
Constant Field Values

cudaErrorMemoryAllocation

public static final int cudaErrorMemoryAllocation
The API call failed because it was unable to allocate enough memory to perform the requested operation.

See Also:
Constant Field Values

cudaErrorInitializationError

public static final int cudaErrorInitializationError
The API call failed because the CUDA driver and runtime could not be initialized.

See Also:
Constant Field Values

cudaErrorLaunchFailure

public static final int cudaErrorLaunchFailure
An exception occurred on the device while executing a kernel. Common causes include dereferencing an invalid device pointer and accessing out of bounds shared memory. The device cannot be used until ::cudaThreadExit() is called. All existing device memory allocations are invalid and must be reconstructed if the program is to continue using CUDA.

See Also:
Constant Field Values

cudaErrorPriorLaunchFailure

public static final int cudaErrorPriorLaunchFailure
This indicated that a previous kernel launch failed. This was previously used for device emulation of kernel launches. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorLaunchTimeout

public static final int cudaErrorLaunchTimeout
This indicates that the device kernel took too long to execute. This can only occur if timeouts are enabled - see the device property \ref ::cudaDeviceProp::kernelExecTimeoutEnabled "kernelExecTimeoutEnabled" for more information. The device cannot be used until ::cudaThreadExit() is called. All existing device memory allocations are invalid and must be reconstructed if the program is to continue using CUDA.

See Also:
Constant Field Values

cudaErrorLaunchOutOfResources

public static final int cudaErrorLaunchOutOfResources
This indicates that a launch did not occur because it did not have appropriate resources. Although this error is similar to ::cudaErrorInvalidConfiguration, this error usually indicates that the user has attempted to pass too many arguments to the device kernel, or the kernel launch specifies too many threads for the kernel's register count.

See Also:
Constant Field Values

cudaErrorInvalidDeviceFunction

public static final int cudaErrorInvalidDeviceFunction
The requested device function does not exist or is not compiled for the proper device architecture.

See Also:
Constant Field Values

cudaErrorInvalidConfiguration

public static final int cudaErrorInvalidConfiguration
This indicates that a kernel launch is requesting resources that can never be satisfied by the current device. Requesting more shared memory per block than the device supports will trigger this error, as will requesting too many threads or blocks. See ::cudaDeviceProp for more device limitations.

See Also:
Constant Field Values

cudaErrorInvalidDevice

public static final int cudaErrorInvalidDevice
This indicates that the device ordinal supplied by the user does not correspond to a valid CUDA device.

See Also:
Constant Field Values

cudaErrorInvalidValue

public static final int cudaErrorInvalidValue
This indicates that one or more of the parameters passed to the API call is not within an acceptable range of values.

See Also:
Constant Field Values

cudaErrorInvalidPitchValue

public static final int cudaErrorInvalidPitchValue
This indicates that one or more of the pitch-related parameters passed to the API call is not within the acceptable range for pitch.

See Also:
Constant Field Values

cudaErrorInvalidSymbol

public static final int cudaErrorInvalidSymbol
This indicates that the symbol name/identifier passed to the API call is not a valid name or identifier.

See Also:
Constant Field Values

cudaErrorMapBufferObjectFailed

public static final int cudaErrorMapBufferObjectFailed
This indicates that the buffer object could not be mapped.

See Also:
Constant Field Values

cudaErrorUnmapBufferObjectFailed

public static final int cudaErrorUnmapBufferObjectFailed
This indicates that the buffer object could not be unmapped.

See Also:
Constant Field Values

cudaErrorInvalidHostPointer

public static final int cudaErrorInvalidHostPointer
This indicates that at least one host pointer passed to the API call is not a valid host pointer.

See Also:
Constant Field Values

cudaErrorInvalidDevicePointer

public static final int cudaErrorInvalidDevicePointer
This indicates that at least one device pointer passed to the API call is not a valid device pointer.

See Also:
Constant Field Values

cudaErrorInvalidTexture

public static final int cudaErrorInvalidTexture
This indicates that the texture passed to the API call is not a valid texture.

See Also:
Constant Field Values

cudaErrorInvalidTextureBinding

public static final int cudaErrorInvalidTextureBinding
This indicates that the texture binding is not valid. This occurs if you call ::cudaGetTextureAlignmentOffset() with an unbound texture.

See Also:
Constant Field Values

cudaErrorInvalidChannelDescriptor

public static final int cudaErrorInvalidChannelDescriptor
This indicates that the channel descriptor passed to the API call is not valid. This occurs if the format is not one of the formats specified by ::cudaChannelFormatKind, or if one of the dimensions is invalid.

See Also:
Constant Field Values

cudaErrorInvalidMemcpyDirection

public static final int cudaErrorInvalidMemcpyDirection
This indicates that the direction of the memcpy passed to the API call is not one of the types specified by ::cudaMemcpyKind.

See Also:
Constant Field Values

cudaErrorAddressOfConstant

public static final int cudaErrorAddressOfConstant
This indicated that the user has taken the address of a constant variable, which was forbidden up until the CUDA 3.1 release. \deprecated This error return is deprecated as of CUDA 3.1. Variables in constant memory may now have their address taken by the runtime via ::cudaGetSymbolAddress().

See Also:
Constant Field Values

cudaErrorTextureFetchFailed

public static final int cudaErrorTextureFetchFailed
This indicated that a texture fetch was not able to be performed. This was previously used for device emulation of texture operations. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorTextureNotBound

public static final int cudaErrorTextureNotBound
This indicated that a texture was not bound for access. This was previously used for device emulation of texture operations. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorSynchronizationError

public static final int cudaErrorSynchronizationError
This indicated that a synchronization operation had failed. This was previously used for some device emulation functions. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorInvalidFilterSetting

public static final int cudaErrorInvalidFilterSetting
This indicates that a non-float texture was being accessed with linear filtering. This is not supported by CUDA.

See Also:
Constant Field Values

cudaErrorInvalidNormSetting

public static final int cudaErrorInvalidNormSetting
This indicates that an attempt was made to read a non-float texture as a normalized float. This is not supported by CUDA.

See Also:
Constant Field Values

cudaErrorMixedDeviceExecution

public static final int cudaErrorMixedDeviceExecution
Mixing of device and device emulation code was not allowed. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorCudartUnloading

public static final int cudaErrorCudartUnloading
This indicated an issue with calling API functions during the unload process of the CUDA runtime in prior releases. \deprecated This error return is deprecated as of CUDA 3.2.

See Also:
Constant Field Values

cudaErrorUnknown

public static final int cudaErrorUnknown
This indicates that an unknown internal error has occurred.

See Also:
Constant Field Values

cudaErrorNotYetImplemented

public static final int cudaErrorNotYetImplemented
This indicates that the API call is not yet implemented. Production releases of CUDA will never return this error.

See Also:
Constant Field Values

cudaErrorMemoryValueTooLarge

public static final int cudaErrorMemoryValueTooLarge
This indicated that an emulated device pointer exceeded the 32-bit address range. \deprecated This error return is deprecated as of CUDA 3.1. Device emulation mode was removed with the CUDA 3.1 release.

See Also:
Constant Field Values

cudaErrorInvalidResourceHandle

public static final int cudaErrorInvalidResourceHandle
This indicates that a resource handle passed to the API call was not valid. Resource handles are opaque types like ::cudaStream_t and ::cudaEvent_t.

See Also:
Constant Field Values

cudaErrorNotReady

public static final int cudaErrorNotReady
This indicates that asynchronous operations issued previously have not completed yet. This result is not actually an error, but must be indicated differently than ::cudaSuccess (which indicates completion). Calls that may return this value include ::cudaEventQuery() and ::cudaStreamQuery().

See Also:
Constant Field Values

cudaErrorInsufficientDriver

public static final int cudaErrorInsufficientDriver
This indicates that the installed NVIDIA CUDA driver is older than the CUDA runtime library. This is not a supported configuration. Users should install an updated NVIDIA display driver to allow the application to run.

See Also:
Constant Field Values

cudaErrorSetOnActiveProcess

public static final int cudaErrorSetOnActiveProcess
This indicates that the user has called ::cudaSetDevice(), ::cudaSetValidDevices(), ::cudaSetDeviceFlags(), ::cudaD3D9SetDirect3DDevice(), ::cudaD3D10SetDirect3DDevice, ::cudaD3D11SetDirect3DDevice(), * or ::cudaVDPAUSetVDPAUDevice() after initializing the CUDA runtime by calling non-device management operations (allocating memory and launching kernels are examples of non-device management operations). This error can also be returned if using runtime/driver interoperability and there is an existing ::CUcontext active on the host thread.

See Also:
Constant Field Values

cudaErrorInvalidSurface

public static final int cudaErrorInvalidSurface
This indicates that the surface passed to the API call is not a valid surface.

See Also:
Constant Field Values

cudaErrorNoDevice

public static final int cudaErrorNoDevice
This indicates that no CUDA-capable devices were detected by the installed CUDA driver.

See Also:
Constant Field Values

cudaErrorECCUncorrectable

public static final int cudaErrorECCUncorrectable
This indicates that an uncorrectable ECC error was detected during execution.

See Also:
Constant Field Values

cudaErrorSharedObjectSymbolNotFound

public static final int cudaErrorSharedObjectSymbolNotFound
This indicates that a link to a shared object failed to resolve.

See Also:
Constant Field Values

cudaErrorSharedObjectInitFailed

public static final int cudaErrorSharedObjectInitFailed
This indicates that initialization of a shared object failed.

See Also:
Constant Field Values

cudaErrorUnsupportedLimit

public static final int cudaErrorUnsupportedLimit
This indicates that the ::cudaLimit passed to the API call is not supported by the active device.

See Also:
Constant Field Values

cudaErrorDuplicateVariableName

public static final int cudaErrorDuplicateVariableName
This indicates that multiple global or constant variables (across separate CUDA source files in the application) share the same string name.

See Also:
Constant Field Values

cudaErrorDuplicateTextureName

public static final int cudaErrorDuplicateTextureName
This indicates that multiple textures (across separate CUDA source files in the application) share the same string name.

See Also:
Constant Field Values

cudaErrorDuplicateSurfaceName

public static final int cudaErrorDuplicateSurfaceName
This indicates that multiple surfaces (across separate CUDA source files in the application) share the same string name.

See Also:
Constant Field Values

cudaErrorDevicesUnavailable

public static final int cudaErrorDevicesUnavailable
This indicates that all CUDA devices are busy or unavailable at the current time. Devices are often busy/unavailable due to use of ::cudaComputeModeExclusive or ::cudaComputeModeProhibited. They can also be unavailable due to memory constraints on a device that already has active CUDA work being performed.

See Also:
Constant Field Values

cudaErrorInvalidKernelImage

public static final int cudaErrorInvalidKernelImage
This indicates that the device kernel image is invalid.

See Also:
Constant Field Values

cudaErrorNoKernelImageForDevice

public static final int cudaErrorNoKernelImageForDevice
This indicates that there is no kernel image available that is suitable for the device. This can occur when a user specifies code generation options for a particular CUDA source file that do not include the corresponding device configuration.

See Also:
Constant Field Values

cudaErrorIncompatibleDriverContext

public static final int cudaErrorIncompatibleDriverContext
This indicates that the current context is not compatible with this version of the CUDA Runtime. This can only occur if you are using CUDA Runtime/Driver interoperability and have created an existing Driver context using an older API. Please see \ref CUDART_DRIVER "Interactions with the CUDA Driver API" for more information.

See Also:
Constant Field Values

cudaErrorStartupFailure

public static final int cudaErrorStartupFailure
This indicates an internal startup failure in the CUDA runtime.

See Also:
Constant Field Values

cudaErrorApiFailureBase

public static final int cudaErrorApiFailureBase
Any unhandled CUDA driver error is added to this value and returned via the runtime. Production releases of CUDA should not return such errors.

See Also:
Constant Field Values

jcudaInternalError

public static final int jcudaInternalError
An internal JCuda error occurred

See Also:
Constant Field Values
Method Detail

stringFor

public static java.lang.String stringFor(int error)
Returns the String identifying the given cudaError

Parameters:
error - The cudaError
Returns:
The String identifying the given cudaError