SVR5

ATOMIC_INT_ALLOC(D3)

ATOMIC_INT_ALLOC -- allocate an ATOMIC_INT structure

Synopsis

   #include <sys/types.h>
   #include <sys/kmem.h>
   #include <sys/ksynch.h>
   #include <sys/ddi.h>
   
   atomic_int_t *ATOMIC_INT_ALLOC(int flag);

Description

ATOMIC_INT_ALLOC allocates an atomic_int_t object. If flag is set to KM_SLEEP, the caller blocks if necessary until the required memory is available. If flag is set to KM_NOSLEEP, the caller does not block, but ATOMIC_INT_ALLOC returns NULL if the memory is not immediately available.

Arguments

flag: Specifies whether the caller is willing to sleep waiting for memory.

Return values

Upon successful completion, ATOMIC_INT_ALLOC( ) returns a pointer to the newly allocated ATOMIC_INT object. If KM_NOSLEEP is specified and sufficient memory is not immediately available, ATOMIC_INT_ALLOC( ) returns a NULL pointer.

Usage

The ATOMIC_INT(D4) object returned must be initialized by ATOMIC_INT_INIT(D3) before it is used.

Context and synchronization

If flag is set to KM_NOSLEEP, non-blockable, initialization, or interrupt context.

If flag is set to KM_SLEEP, user context.

Hardware applicability

All

Version applicability

ddi: 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

ATOMIC_INT(D4), ATOMIC_INT_ADD(D3), ATOMIC_INT_DEALLOC(D3), ATOMIC_INT_DECR(D3), ATOMIC_INT_INCR(D3), ATOMIC_INT_INIT(D3), ATOMIC_INT_READ(D3), ATOMIC_INT_SUB(D3), ATOMIC_INT_WRITE(D3)

``Atomic locks'' in HDK Technical Reference