Manual Pages for UNIX Operating System command usage for man pthread_spin_trylock

Standard C Library Functions                pthread_spin_lock(3C)



NAME
     pthread_spin_lock, pthread_spin_trylock - lock a  spin  lock
     object

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

     int pthread_spin_lock(pthread_spinlock_t *lock);


     #include 

     int pthread_spin_trylock(pthread_spinlock_t *lock);


DESCRIPTION
     The pthread_spin_lock() 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 pthread_spin_lock 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 pthread_spin_trylock()  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.

ERRORS
     The pthread_spin_trylock() 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                pthread_spin_lock(3C)



     The pthread_spin_lock() function may fail if:

     EDEADLK    The calling thread already holds the lock.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     pthread_spin_destroy(3C),  pthread_spin_unlock(3C),   attri-
     butes(5), standards(5)






























SunOS 5.11          Last change: 30 Jan 2004                    2