Standard C Library Functions                      atomicbits(3C)



NAME
     atomicbits, atomicsetlongexcl, atomicclearlongexcl  -
     atomic set and clear bit operations

SYNOPSIS
     #include 

     int atomicsetlongexcl(volatile ulongt *target, uintt bit);


     int atomicclearlongexcl(volatile ulongt *target, uintt bit);


DESCRIPTION
     The  atomicsetlongexcl()   and   atomicclearlongexcl()
     functions  perform  an  exclusive  atomic  bit  set or clear
     operation on target. The value of bit specifies  the  number
     of  the  bit to be modified within target. Bits are numbered
     from zero to one less than the maximum number of bits  in  a
     long.  If  the value of bit falls outside of this range, the
     result of the operation is undefined.

RETURN VALUES
     The  atomicsetlongexcl()   and   atomicclearlongexcl()
     functions  return  0 if bit was successfully set or cleared.
     They return -1 if bit was already set or cleared.

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),        atomiccas(3C),
     atomicdec(3C),        atomicinc(3C),        atomicor(3C),
     atomicswap(3C),       membarops(3C),        attributes(5),
     atomicops(9F)





SunOS 5.11          Last change: 13 May 2005                    1