KSTAT_NAMED_INIT(9F)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.
DESCRIPTIONkstat_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. This is the only supported method of
changing the value of long strings.
RETURN VALUES
None.
CONTEXTkstat_named_init() and kstat_named_setstr() can be called from user or
kernel context.
SEE ALSOkstat_create(9F), kstat_install(9F), kstat(9S), kstat_named(9S)
Writing Device Drivers
Feb 29, 2008 KSTAT_NAMED_INIT(9F)