Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../.././../../../usr/man/man9f/kstat_named_init.9f
Real path: /usr/share/man/man9f/kstat_named_init.9f
Zurück

'\" te
.\" Copyright (c) 2006, 2016, Oracle and/or its affiliates. All rights reserved.
.TH kstat_named_init 9F "19 Aug 2016" "Oracle Solaris 11.4" "Kernel Functions"
.SH NAME
kstat_named_init, kstat_named_setstr \- initialize a named kstat
.SH SYNOPSIS

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

\fBvoid\fR \fBkstat_named_init\fR(\fBkstat_named_t *\fR\fIknp\fR, \fBconst char *\fR\fIname\fR,
     \fBuchar_t\fR \fIdata_type\fR);
.fi

.LP
.nf
\fBvoid\fR \fBkstat_named_setstr\fR(\fBkstat_named_t *\fR\fIknp\fR, \fBconst char *\fR\fIstr\fR);
.fi
.SH INTERFACE LEVEL
.sp
.LP
Solaris DDI specific (Solaris DDI)
.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fIknp\fR\fR
.ad
.RS 13n
.rt
Pointer to a \fBkstat_named\fR(9S) structure.
.RE

.sp
.ne 2
.mk
.na
\fB\fIname\fR\fR
.ad
.RS 13n
.rt
The name of the statistic.
.RE

.sp
.ne 2
.mk
.na
\fB\fIdata_type\fR\fR
.ad
.RS 13n
.rt
The type of value. This indicates which field of the \fBkstat_named\fR(9S) structure should be used. Valid values are:
.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_CHAR\fR\fR
.ad
.RS 24n
.rt
The "\fBchar\fR" field.
.RE

.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_LONG\fR\fR
.ad
.RS 24n
.rt
The "\fBlong\fR" field.
.RE

.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_ULONG\fR\fR
.ad
.RS 24n
.rt
The "\fBunsigned long\fR" field.
.RE

.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_LONGLONG\fR\fR
.ad
.RS 24n
.rt
Obsolete. Use \fBKSTAT_DATA_INT64\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_ULONGLONG\fR\fR
.ad
.RS 24n
.rt
Obsolete. Use \fBKSTAT_DATA_UINT64\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fBKSTAT_DATA_STRING\fR\fR
.ad
.RS 24n
.rt
Arbitrary length "\fBlong string\fR" field.
.RE

.RE

.sp
.ne 2
.mk
.na
\fB\fIstr\fR\fR
.ad
.RS 13n
.rt
Pointer to a \fBNULL\fR-terminated string.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBkstat_named_init()\fR function associates a name and a type with a \fBkstat_named\fR(9S) structure.
.sp
.LP
The \fBkstat_named_setstr()\fR function associates \fIstr\fR with the named kstat \fBknp\fR. It is an error for \fBknp\fR to be of type other than \fBKSTAT_DATA_STRING\fR. The string argument must remain valid even after the function that is calling \fBkstat_named_setstr()\fR is returned. This is the only supported method of changing the value of long strings.
.SH RETURN VALUES
.sp
.LP
None.
.SH CONTEXT
.sp
.LP
The \fBkstat_named_init()\fR and \fBkstat_named_setstr()\fR functions can be called from user or kernel context.
.SH SEE ALSO
.sp
.LP
\fBkstat_create\fR(9F), \fBkstat_install\fR(9F), \fBkstat\fR(9S), \fBkstat_named\fR(9S), \fBkstat2_create\fR(9F), \fBkstat2_install\fR(9F), \fBkstat2_nv_init\fR(9F), \fBkstat2_named\fR(9S), \fBkstat_named_setstr\fR(9F)
.sp
.LP
\fIWriting Device Drivers in Oracle Solaris 11.4\fR  
.SH NOTES
.sp
.LP
The \fBkstat_named_init()\fR and \fBkstat_named_setstr()\fR functions are deprecated. These functions may be removed in a future release of Oracle Solaris. Use the \fBkstat2_create()\fR, \fBkstat2_nv_init()\fR and \fBkstat2_nv_setstr()\fR functions instead. For more information, see the \fBkstat2_create\fR(9F), \fBkstat2_nv_init\fR(9F), and \fBkstat2_nv_setstr\fR(9F) man pages.