lock_try_write(9r) [osf1 man page]

lock_try_write(9r)														lock_try_write(9r)

NAME

       lock_try_write - General: Tries to assert a complex lock with write access

SYNOPSIS

       #include <kern/lock.h>

       boolean_t lock_try_write(
	       lock_t lock_structptr );

ARGUMENTS

       Specifies  a  pointer to the complex lock structure, lock. This is the lock structure associated with the resource on which you want to try
       to assert write access. The lock structure is an opaque data structure; that is, its associated members are referenced and  manipulated	by
       the Tru64 UNIX operating system and not by the user of the complex lock mechanism.

DESCRIPTION

       The  lock_try_write routine tries to assert a complex lock (without blocking) with write access for the resource associated with the speci-
       fied lock structure pointer. To release a complex lock with write access successfully asserted by lock_try_write, call the  lock_done  rou-
       tine.

NOTES

       You must call lock_init (once only) prior to calling lock_try_write to initialize the lock structure pointer for the resource.  A resource,
       from the kernel module's standpoint, is data that more than one kernel thread can manipulate. You can store the resource  in  global  vari-
       ables and in data structure members.

RETURN VALUES

       The  lock_try_write routine returns one of the following values: The attempt to acquire the write complex lock was successful.  The attempt
       to acquire the write complex lock was unsuccessful.

FILES

SEE ALSO

       Routines: lock_done(9r), lock_terminate(9r), lock_try_read(9r), lock_write(9r)

       Data Structures: lock(9s)

																lock_try_write(9r)