nvlist_next_nvpair(9F)

NAME

     nvlist_next_nvpair, nvpair_name, nvpair_type -  return  data
     regarding name-value pairs

SYNOPSIS

     #include <sys/nvpair.h>

     nvpair_t   *nvlist_next_nvpair(nvlist_t    *nvl,    nvpair_t
     *nvpair);

     char *nvpair_name(nvpair_t *nvpair);

     data_type_t nvpair_type(nvpair_t *nvpair);

INTERFACE LEVEL

     Solaris DDI specific (Solaris DDI)

PARAMETERS

     nvl   The list of name-value pairs  (nvlist_t)  to  be  pro-
           cessed.

     nvpair
           Handle to a name-value pair.

DESCRIPTION

     The nvlist_next_nvpair() function returns a  handle  to  the
     next  name-value pair (nvpair) in the list following nvpair.
     If nvpair is NULL, the first pair is returned. If nvpair  is
     the last pair in the nvlist_t, NULL is returned.

     The nvpair_name() function returns a string  containing  the
     name of nvpair.

     The nvpair_type() function retrieves the value of the nvpair
     in  the form of enumerated type data_type_t. This is used to
     determine the appropriate nvpair_*() function  to  call  for
     retrieving the value.

RETURN VALUES

     For nvpair_name(), a string containing the name.

     For nvpair_type(), an enumerated data type data_type_t. Pos-
     sible values for data_type_t are as follows:

     DATA_TYPE_BOOLEAN
     DATA_TYPE_BYTE
     DATA_TYPE_INT16
     DATA_TYPE_UINT16
     DATA_TYPE_INT32
     DATA_TYPE_UINT32
     DATA_TYPE_INT64
     DATA_TYPE_UINT64
     DATA_TYPE_STRING
     DATA_TYPE_BYTE_ARRAY
     DATA_TYPE_INT16_ARRAY
     DATA_TYPE_UINT16_ARRAY
     DATA_TYPE_INT32_ARRAY
     DATA_TYPE_UINT32_ARRAY
     DATA_TYPE_INT64_ARRAY
     DATA_TYPE_UINT64_ARRAY
     DATA_TYPE_STRING_ARRAY

     For nvlist_next_pair():

     NULL  Reached end of list.

     otherwise:
           Handle to next nvpair in the list.

CONTEXT

     The functions described here can  be  called  from  user  or
     interrupt context.