DragonFly On-Line Manual Pages

Search: Section:  

CK_COHORT_TRYLOCK(3)  DragonFly Library Functions Manual  CK_COHORT_TRYLOCK(3)


NAME

     CK_COHORT_TRYLOCK - try to acquire cohort lock


LIBRARY

     Concurrency Kit (libck, -lck)


SYNOPSIS

     #include <ck_cohort.h>

     CK_COHORT_TRYLOCK(COHORT_NAME cohort_name, COHORT *cohort,
         void *global_trylock_context, void *local_trylock_context,
         void *lock_unlock_context);


DESCRIPTION

     This call attempts to acquire both the local and global (if necessary)
     locks from cohort.  It can only be used with cohort types that were
     defined using the CK_COHORT_TRYLOCK_PROTOTYPE(3) macro.  The call will
     not block and will return a bool that will evaluate to true iff the
     cohort was successfully acquired.  global_trylock_context will be passed
     as the second argument to the function that was provided as the
     global_trylock_method argument to CK_COHORT_TRYLOCK_PROTOTYPE if that
     method is called, and local_trylock_context will be passed to the
     function specified by local_trylock_method.  If the global lock
     acquisition fails, then the cohort will immediately release its local
     lock as well, and local_unlock_context will be passed to the function
     specified by local_unlock_method when this call is made.


SEE ALSO

     ck_cohort(3), CK_COHORT_PROTOTYPE(3), CK_COHORT_TRYLOCK_PROTOTYPE(3),
     CK_COHORT_INSTANCE(3), CK_COHORT_INITIALIZER(3), CK_COHORT_INIT(3),
     CK_COHORT_LOCK(3), CK_COHORT_UNLOCK(3), CK_COHORT_LOCKED(3),

     Additional information available at http://concurrencykit.org/

                                March 9, 2013.

Search: Section: