Standard C Library Functions                       atomicinc(3C)



NAME
     atomicinc, atomicinc8,  atomicincuchar,  atomicinc16,
     atomicincushort,      atomicinc32,      atomicincuint,
     atomicinculong,       atomicinc64,       atomicincptr,
     atomicinc8nv,    atomicincucharnv,   atomicinc16nv,
     atomicincushortnv, atomicinc32nv,  atomicincuintnv,
     atomicinculongnv,  atomicinc64nv,  atomicincptrnv -
     atomic inrement operations

SYNOPSIS
     #include 

     void atomicinc8(volatile uint8t *target);


     void atomicincuchar(volatile uchart *target);


     void atomicinc16(volatile uint16t *target);


     void atomicincushort(volatile ushortt *target);


     void atomicinc32(volatile uint32t *target);


     void atomicincuint(volatile uintt *target);


     void atomicinculong(volatile ulongt *target);


     void atomicinc64(volatile uint64t *target);


     void atomicincptr(volatile void *target);


     uint8t atomicinc8nv(volatile uint8t *target);


     uchart atomicincucharnv(volatile uchart *target);


     uint16t atomicinc16nv(volatile uint16t *target);


     ushortt atomicincushortnv(volatile ushortt *target);






SunOS 5.11          Last change: 13 May 2005                    1






Standard C Library Functions                       atomicinc(3C)



     uint32t atomicinc32nv(volatile uint32t *target);


     uintt atomicincuintnv(volatile uintt *target);


     ulongt atomicinculongnv(volatile ulongt *target);


     uint64t atomicinc64nv(volatile uint64t *target);


     void *atomicincptrnv(volatile void *target);


DESCRIPTION
     These functions enable the inrementing (by one) of the value
     stored in target to occur in an atomic manner.

RETURN VALUES
     The *nv() variants of these functions return the new  value
     of target.

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     atomicadd(3C),       atomicand(3C),       atomicbits(3C),
     atomiccas(3C),        atomicdec(3C),        atomicor(3C),
     atomicswap(3C),       membarops(3C),        attributes(5),
     atomicops(9F)

NOTES
     The *nv() variants are substantially more expensive on some
     platforms  than  the  versions that do not return values. Do
     not use them unless you need to know the  new  value  atomi-
     cally.



SunOS 5.11          Last change: 13 May 2005                    2