SVR5

LKINFO_DECL(D5)

LKINFO_DECL -- define and initialize lock information structures

Synopsis

   #include <sys/ksynch.h>
   #include <sys/ddi.h>

   LKINFO_DECL(var, name, flags);

Arguments

var: The name of the lock information structure.
name: A character string providing a name that will be associated with the lock for the purpose of gathering statistics.
flags: Drivers should always use a flag value of zero.

Description

The LKINFO_DECL macro is used to define and initialize lkinfo structures.

Usage

Various lock allocation functions [LOCK_ALLOC(D3), RW_ALLOC(D3), and SLEEP_ALLOC(D3)] take as arguments a pointer to a lkinfo structure. The lkinfo structure describes attributes of the lock being allocated. The same lkinfo structure may be shared among multiple basic locks and read/write locks, but a lkinfo structure may not be shared between a basic lock and a sleep lock.

Driver writers should treat lkinfo structures as opaque objects and never access any fields of this structure.

LKINFO_DECL can be used wherever variable definitions are allowed. A scope modifier, such as static, can be placed before LKINFO_DECL.

Hardware applicability

All

Version applicability

ddi: 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

LOCK_ALLOC(D3), RW_ALLOC(D3), SLEEP_ALLOC(D3)