#ident	"@(#)di_hp_next.3devinfo.txt 1.2     09/08/09 SMI"

Device Information Library Functions         di_hp_next(3DEVINFO)



NAME
     di_hp_next - libdevinfo hotplug node traversal functions

SYNOPSIS
     cc [ flag... ] file... -ldevinfo [ library... ]
     #include <libdevinfo.h>

     di_hp_t di_hp_next(di_node_t node, di_hp_t hp);


PARAMETERS
     hp       Handle to the current hotplug node or DI_HP_NIL.

     node     Device node with which the hotplug node is
              associated.


DESCRIPTION
     The di_hp_next() function returns a handle to the next
     hotplug node for the device node. If hp is DI_HP_NIL,
     a handle to the first hotplug node is returned.

RETURN VALUES
     Upon successful completion, a handle to the next hotplug node
     is  returned.  Otherwise, DI_HP_NIL is returned and errno is
     set to indicate the error.

ERRORS
     The di_hp_next() function will fail if:

     EINVAL     Invalid argument.

     ENOTSUP    Hotplug node information is not available in
                snapshot.

     ENXIO      End of hotplug node list.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Consolidation Private       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     libdevinfo(3LIB), attributes(5)


     Writing Device Drivers