Global enum and defines

Classes
struct	dim3

Macros
#define	hipStreamDefault   0x00
	Flags that can be used with hipStreamCreateWithFlags. More...
#define	hipStreamNonBlocking   0x01
	Stream does not implicitly synchronize with null stream.
#define	hipEventDefault   0x0
	Flags that can be used with hipEventCreateWithFlags: More...
#define	hipEventBlockingSync   0x1
	Waiting will yield CPU. Power-friendly and usage-friendly but may increase latency.
#define	hipEventDisableTiming   0x2
	Disable event's capability to record timing information. May improve performance.
#define	hipEventInterprocess   0x4
	Event can support IPC. More...
#define	hipHostMallocDefault   0x0
	Flags that can be used with hipHostMalloc.
#define	hipHostMallocPortable   0x1
#define	hipHostMallocMapped   0x2
#define	hipHostMallocWriteCombined   0x4
#define	hipHostRegisterDefault   0x0
	Flags that can be used with hipHostRegister. More...
#define	hipHostRegisterPortable   0x1
	Memory is considered registered by all contexts. HIP only supports one context so this is always assumed true.
#define	hipHostRegisterMapped   0x2
	Map the allocation into the address space for the current device. The device pointer can be obtained with hipHostGetDevicePointer.
#define	hipHostRegisterIoMemory   0x4
	Not supported.

Typedefs
typedef enum hipError_t	hipError_t
typedef enum hipDeviceAttribute_t	hipDeviceAttribute_t
typedef enum hipFuncCache	hipFuncCache
typedef enum hipSharedMemConfig	hipSharedMemConfig
typedef struct dim3	dim3

Enumerations
enum	hipError_t {   hipSuccess = 0, hipErrorMemoryAllocation, hipErrorMemoryFree, hipErrorUnknownSymbol,   hipErrorOutOfResources, hipErrorInvalidValue, hipErrorInvalidResourceHandle, hipErrorInvalidDevice,   hipErrorInvalidMemcpyDirection, hipErrorInvalidDevicePointer, hipErrorInitializationError, hipErrorNoDevice,   hipErrorNotReady, hipErrorUnknown, hipErrorRuntimeMemory, hipErrorRuntimeOther,   hipErrorTbd }
enum	hipDeviceAttribute_t {   hipDeviceAttributeMaxThreadsPerBlock, hipDeviceAttributeMaxBlockDimX, hipDeviceAttributeMaxBlockDimY, hipDeviceAttributeMaxBlockDimZ,   hipDeviceAttributeMaxGridDimX, hipDeviceAttributeMaxGridDimY, hipDeviceAttributeMaxGridDimZ, hipDeviceAttributeMaxSharedMemoryPerBlock,   hipDeviceAttributeTotalConstantMemory, hipDeviceAttributeWarpSize, hipDeviceAttributeMaxRegistersPerBlock, hipDeviceAttributeClockRate,   hipDeviceAttributeMemoryClockRate, hipDeviceAttributeMemoryBusWidth, hipDeviceAttributeMultiprocessorCount, hipDeviceAttributeComputeMode,   hipDeviceAttributeL2CacheSize, hipDeviceAttributeMaxThreadsPerMultiProcessor, hipDeviceAttributeComputeCapabilityMajor, hipDeviceAttributeComputeCapabilityMinor,   hipDeviceAttributeConcurrentKernels, hipDeviceAttributePciBusId, hipDeviceAttributePciDeviceId, hipDeviceAttributeMaxSharedMemoryPerMultiprocessor,   hipDeviceAttributeIsMultiGpuBoard }
enum	hipFuncCache { hipFuncCachePreferNone, hipFuncCachePreferShared, hipFuncCachePreferL1, hipFuncCachePreferEqual }
enum	hipSharedMemConfig { hipSharedMemBankSizeDefault, hipSharedMemBankSizeFourByte, hipSharedMemBankSizeEightByte }
enum	hipMemcpyKind {   hipMemcpyHostToHost = 0, hipMemcpyHostToDevice = 1, hipMemcpyDeviceToHost = 2, hipMemcpyDeviceToDevice =3,   hipMemcpyDefault = 4 }

Detailed Description

Macro Definition Documentation

#define hipEventDefault   0x0

Flags that can be used with hipEventCreateWithFlags:

Default flags

#define hipEventInterprocess   0x4

Event can support IPC.

Warning

- not supported in HIP.

#define hipHostRegisterDefault   0x0

Flags that can be used with hipHostRegister.

Memory is Mapped and Portable

#define hipStreamDefault   0x00

Flags that can be used with hipStreamCreateWithFlags.

Default stream creation flags. These are used with hipStreamCreate().

Typedef Documentation

typedef struct dim3 dim3

Struct for data in 3D

typedef enum hipFuncCache hipFuncCache

Warning

On AMD devices and recent Nvidia devices, these hints and controls are ignored.

typedef enum hipSharedMemConfig hipSharedMemConfig

Warning

On AMD devices and recent Nvidia devices, these hints and controls are ignored.

Enumeration Type Documentation

enum hipDeviceAttribute_t

Enumerator
hipDeviceAttributeMaxThreadsPerBlock	Maximum number of threads per block.
hipDeviceAttributeMaxBlockDimX	Maximum x-dimension of a block.
hipDeviceAttributeMaxBlockDimY	Maximum y-dimension of a block.
hipDeviceAttributeMaxBlockDimZ	Maximum z-dimension of a block.
hipDeviceAttributeMaxGridDimX	Maximum x-dimension of a grid.
hipDeviceAttributeMaxGridDimY	Maximum y-dimension of a grid.
hipDeviceAttributeMaxGridDimZ	Maximum z-dimension of a grid.
hipDeviceAttributeMaxSharedMemoryPerBlock	Maximum shared memory available per block in bytes.
hipDeviceAttributeTotalConstantMemory	Constant memory size in bytes.
hipDeviceAttributeWarpSize	Warp size in threads.
hipDeviceAttributeMaxRegistersPerBlock	Maximum number of 32-bit registers available to a thread block. This number is shared by all thread blocks simultaneously resident on a multiprocessor.
hipDeviceAttributeClockRate	Peak clock frequency in kilohertz.
hipDeviceAttributeMemoryClockRate	Peak memory clock frequency in kilohertz.
hipDeviceAttributeMemoryBusWidth	Global memory bus width in bits.
hipDeviceAttributeMultiprocessorCount	Number of multiprocessors on the device.
hipDeviceAttributeComputeMode	Compute mode that device is currently in.
hipDeviceAttributeL2CacheSize	Size of L2 cache in bytes. 0 if the device doesn't have L2 cache.
hipDeviceAttributeMaxThreadsPerMultiProcessor	Maximum resident threads per multiprocessor.
hipDeviceAttributeComputeCapabilityMajor	Major compute capability version number.
hipDeviceAttributeComputeCapabilityMinor	Minor compute capability version number.
hipDeviceAttributeConcurrentKernels	Device can possibly execute multiple kernels concurrently.
hipDeviceAttributePciBusId	PCI Bus ID.
hipDeviceAttributePciDeviceId	PCI Device ID.
hipDeviceAttributeMaxSharedMemoryPerMultiprocessor	Maximum Shared Memory Per Multiprocessor.
hipDeviceAttributeIsMultiGpuBoard	Multiple GPU devices.

enum hipError_t

Enumerator
hipSuccess	Successful completion.
hipErrorMemoryAllocation	Memory allocation error.
hipErrorMemoryFree	Memory free error.
hipErrorUnknownSymbol	Unknown symbol.
hipErrorOutOfResources	Out of resources error.
hipErrorInvalidValue	One or more of the parameters passed to the API call is NULL or not in an acceptable range.
hipErrorInvalidResourceHandle	Resource handle (hipEvent_t or hipStream_t) invalid.
hipErrorInvalidDevice	DeviceID must be in range 0...#compute-devices.
hipErrorInvalidMemcpyDirection	Invalid memory copy direction.
hipErrorInvalidDevicePointer	Invalid Device Pointer.
hipErrorInitializationError	TODO comment from hipErrorInitializationError.
hipErrorNoDevice	Call to hipGetDeviceCount returned 0 devices.
hipErrorNotReady	Indicates that asynchronous operations enqueued earlier are not ready. This is not actually an error, but is used to distinguish from hipSuccess (which indicates completion). APIs that return this error include hipEventQuery and hipStreamQuery.
hipErrorUnknown	Unknown error.
hipErrorRuntimeMemory	HSA runtime memory call returned error. Typically not seen in production systems.
hipErrorRuntimeOther	HSA runtime call other than memory returned error. Typically not seen in production systems.
hipErrorTbd	Marker that more error codes are needed.

enum hipFuncCache

Warning

On AMD devices and recent Nvidia devices, these hints and controls are ignored.

Enumerator
hipFuncCachePreferNone	no preference for shared memory or L1 (default)
hipFuncCachePreferShared	prefer larger shared memory and smaller L1 cache
hipFuncCachePreferL1	prefer larger L1 cache and smaller shared memory
hipFuncCachePreferEqual	prefer equal size L1 cache and shared memory

enum hipMemcpyKind

Memory copy types

Enumerator
hipMemcpyHostToHost	Host-to-Host Copy.
hipMemcpyHostToDevice	Host-to-Device Copy.
hipMemcpyDeviceToHost	Device-to-Host Copy.
hipMemcpyDeviceToDevice	Device-to-Device Copy.
hipMemcpyDefault	Runtime will automatically determine copy-kind based on virtual addresses.

enum hipSharedMemConfig

Warning

On AMD devices and recent Nvidia devices, these hints and controls are ignored.

Enumerator
hipSharedMemBankSizeDefault	The compiler selects a device-specific value for the banking.
hipSharedMemBankSizeFourByte	Shared mem is banked at 4-bytes intervals and performs best when adjacent threads access data 4 bytes apart.
hipSharedMemBankSizeEightByte	Shared mem is banked at 8-byte intervals and performs best when adjacent threads access data 4 bytes apart.