Kernel Functions for Drivers                 kstatnamedinit(9F)



NAME
     kstatnamedinit, kstatnamedsetstr -  initialize  a  named
     kstat

SYNOPSIS
     #include 
     #include 



     void kstatnamedinit(kstatnamedt *knp, const char *name,
          uchart datatype);


     void kstatnamedsetstr(kstatnamedt *knp, const char *str);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

PARAMETERS
     knp          Pointer to a kstatnamed(9S) structure.


     name         The name of the statistic.


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

                  KSTATDATACHAR         The "char" field.


                  KSTATDATALONG         The "long" field.


                  KSTATDATAULONG        The   "unsigned   long"
                                          field.


                  KSTATDATALONGLONG     Obsolete.           Use
                                          KSTATDATAINT64.


                  KSTATDATAULONGLONG    Obsolete.           Use
                                          KSTATDATAUINT64.


                  KSTATDATASTRING       Arbitrary length  "long
                                          string" field.




SunOS 5.11          Last change: 29 Feb 2008                    1






Kernel Functions for Drivers                 kstatnamedinit(9F)



     str          Pointer to a NUL-terminated string.


DESCRIPTION
     kstatnamedinit() associates a  name  and  a  type  with  a
     kstatnamed(9S) structure.


     kstatnamedsetstr() associates str  with  the  named  kstat
     knp.  It  is  an  error  for  knp  to  be of type other than
     KSTATDATASTRING. The string  argument  must  remain  valid
     even after the function that is calling kstatnamedsetstr()
     is returned. This is the only supported method  of  changing
     the value of long strings.

RETURN VALUES
     None.

CONTEXT
     kstatnamedinit() and kstatnamedsetstr()  can  be  called
     from user or kernel context.

SEE ALSO
     kstatcreate(9F),       kstatinstall(9F),        kstat(9S),
     kstatnamed(9S)


     Writing Device Drivers



























SunOS 5.11          Last change: 29 Feb 2008                    2