lock_try_write(9r)lock_try_write(9r)NAMElock_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 variables
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.
FILESSEE ALSO
Routines: lock_done(9r), lock_terminate(9r), lock_try_read(9r),
lock_write(9r)
Data Structures: lock(9s)lock_try_write(9r)