NAME    [Toc]    [Back]

       lock_terminate - General: Terminates, using a complex lock

SYNOPSIS    [Toc]    [Back]

       #include <kern/lock.h>

       void lock_terminate(
               lock_t lock_structptr );

ARGUMENTS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 variables
       and in data structure members.

RETURN VALUES    [Toc]    [Back]

       None

FILES    [Toc]    [Back]

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)