KSTAT_NAMED_INIT(9F) Kernel Functions for Drivers KSTAT_NAMED_INIT(9F)


NAME


kstat_named_init, kstat_named_setstr - initialize a named kstat

SYNOPSIS


#include <sys/types.h>
#include <sys/kstat.h>


void kstat_named_init(kstat_named_t *knp, const char *name,
uchar_t data_type);


void kstat_named_setstr(kstat_named_t *knp, const char *str);


INTERFACE LEVEL


Solaris DDI specific (Solaris DDI)

PARAMETERS


knp
Pointer to a kstat_named(9S) structure.


name
The name of the statistic.


data_type
The type of value. This indicates which field of the
kstat_named(9S) structure should be used. Valid values are:

KSTAT_DATA_CHAR
The "char" field.


KSTAT_DATA_LONG
The "long" field.


KSTAT_DATA_ULONG
The "unsigned long" field.


KSTAT_DATA_LONGLONG
Obsolete. Use KSTAT_DATA_INT64.


KSTAT_DATA_ULONGLONG
Obsolete. Use KSTAT_DATA_UINT64.


KSTAT_DATA_STRING
Arbitrary length "long string"
field.


str
Pointer to a NULL-terminated string.


DESCRIPTION


kstat_named_init() associates a name and a type with a kstat_named(9S)
structure.


kstat_named_setstr() associates str with the named kstat knp. It is an
error for knp to be of type other than KSTAT_DATA_STRING. The string
argument must remain valid even after the function that is calling
kstat_named_setstr() is returned. If KSTAT_DATA_STRING is used in a
persistent kstat the string argument must remain valid even after the
module that created the kstat is unloaded. This is the only supported
method of changing the value of long strings.

RETURN VALUES


None.

CONTEXT


kstat_named_init() and kstat_named_setstr() can be called from user or
kernel context.

SEE ALSO


kstat_create(9F), kstat_install(9F), kstat(9S), kstat_named(9S)


Writing Device Drivers


February 29, 2008 KSTAT_NAMED_INIT(9F)