Standard C Library Functions                pthreadspinlock(3C)



NAME
     pthreadspinlock, pthreadspintrylock - lock a  spin  lock
     object

SYNOPSIS
     cc -mt [ flag... ] file... [ library... ]
     #include 

     int pthreadspinlock(pthreadspinlockt *lock);


     #include 

     int pthreadspintrylock(pthreadspinlockt *lock);


DESCRIPTION
     The pthreadspinlock() function locks the spin lock  refer-
     enced by lock. The calling thread acquires the lock if it is
     not held by another  thread.  Otherwise,  the  thread  spins
     (that is, does not return from the pthreadspinlock call())
     until the lock becomes available. The results are  undefined
     if the calling thread holds the lock at the time the call is
     made.


     The pthreadspintrylock()  function  locks  the  spin  lock
     referenced  by  lock if it is not held by any thread. Other-
     wise, the function fails.


     The results are undefined if either of  these  functions  is
     called with an uninitialized spin lock.

RETURN VALUES
     Upon successful completion, these functions returns 0.  Oth-
     erwise, an error number is returned to indicate the error.

ERORS
     The pthreadspintrylock() function will fail if:

     EBUSY    A thread currently holds the lock.



     These functions may fail if:

     EINVAL    The value specified by lock does not refer  to  an
               initialized spin lock object.






SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions                pthreadspinlock(3C)



     The pthreadspinlock() function may fail if:

     EDEADLK    The calling thread already holds the lock.


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



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


SEE ALSO
     pthreadspindestroy(3C),  pthreadspinunlock(3C),   attri-
     butes(5), standards(5)
































SunOS 5.11          Last change: 30 Jan 2004                    2