SVR5

ATOMIC_INT_SUB(D3)

ATOMIC_INT_SUB -- subtract from an ATOMIC_INT value

Synopsis

   #include <sys/types.h>
   #include <sys/ksynch.h>
   #include <sys/ddi.h>
   
   void ATOMIC_INT_SUB(atomic_int_t *counter, int value);

Description

ATOMIC_INT_SUB( ) subtracts value from the integer value stored within the ATOMIC_INT(D4) object pointed to by counter. The result of the subtraction is stored back into the object referenced by counter.

Arguments

counter: Points to an ATOMIC_INT object to be modified by the subtraction.
value: The value to subtract from the contents of counter.

Return values

None.

Usage

The ATOMIC_INT(D4) object pointed to by counter must have been previously allocated by ATOMIC_INT_ALLOC(D3) and initialized by ATOMIC_INT_INIT(D3).

Warnings

The atomicity properties of ATOMIC_INT objects are strictly limited to a single object. See ``Atomic locks'' in HDK Technical Reference.

Context and synchronization

Non-blockable, interrupt, user, or blockable 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_ALLOC(D3), ATOMIC_INT_DEALLOC(D3), ATOMIC_INT_DECR(D3), ATOMIC_INT_INCR(D3), ATOMIC_INT_INIT(D3), ATOMIC_INT_READ(D3), ATOMIC_INT_WRITE(D3) ``Atomic locks'' in HDK Technical Reference

``Atomic locks'' in HDK Technical Reference.