lock_init(9r) [osf1 man page]

lock_init(9r)															     lock_init(9r)

NAME

       lock_init - General: Initializes a complex lock

SYNOPSIS

       #include <kern/lock.h>

       void lock_init(
	       lock_t lock_structptr,
	       boolean_t can_sleep );

ARGUMENTS

       Specifies  a  pointer  to the complex lock structure, lock. The lock structure is an opaque data structure; that is, its associated members
       are referenced and manipulated by the operating system and not by the user of the complex lock mechanism.  Specifies a Boolean  value  that
       indicates  whether  to  allow kernel threads to block (sleep) if the complex lock is asserted. You can pass to this argument only the value
       TRUE (allow kernel threads to block if the lock is asserted).

DESCRIPTION

       The lock_init routine initializes a complex lock.  You identify this lock by declaring a pointer to a complex lock structure and passing it
       as  the	first argument. The complex lock structure pointer must be initialized before you can assert read and write operations on the com-
       plex lock.

RETURN VALUES

       None

FILES

SEE ALSO

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

       Data Structures: lock(9s)

																     lock_init(9r)

lock_terminate(9r)														lock_terminate(9r)

NAME

       lock_terminate - General: Terminates, using a complex lock

SYNOPSIS

       #include <kern/lock.h>

       void lock_terminate(
	       lock_t lock_structptr );

ARGUMENTS

       Specifies  a  pointer  to the complex lock structure, lock. The lock structure is an opaque data structure; that is, its associated members
       are referenced and manipulated by the operating system and not by the user of the complex lock mechanism.

DESCRIPTION

       The lock_terminate routine determines that the driver is done using the complex lock forever. The complex lock must be free (that  is,  the
       driver does not hold the lock) before calling lock_terminate. The kernel module must not reference the specified complex lock after calling
       lock_terminate.

NOTES

       You must call lock_init (once only) prior to calling lock_terminate 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

       None

FILES

SEE ALSO

       Kernel routines: lock_done(9r), lock_init(9r), lock_try_read(9r), lock_try_write(9r), lock_write(9r)

       Data Structures: lock(9s)

																lock_terminate(9r)