hwgraph.lblinfo(D3X)

NAME
     hwgraph.lblinfo:  hwgraph_info_add_LBL, hwgraph_info_remove_LBL,
     hwgraph_info_replace_LBL, hwgraph_info_get_LBL, hwgraph_info_export_LBL,
     hwgraph_info_unexport_LBL - manage labelled info in the hwgraph

SYNOPSIS
     #include <sys/types.h>
     #include <sys/hwgraph.h>
     #include <sys/ddi.h>

     graph_error_t
     hwgraph_info_add_LBL(vertex_hdl_t vhdl,
                         char *info_name,
                         arbitrary_info_t info);

     graph_error_t
     hwgraph_info_remove_LBL(vertex_hdl_t vhdl,
                         char *info_name,
                         arbitrary_info_t *info_ptr);

     graph_error_t
     hwgraph_info_replace_LBL(vertex_hdl_t vhdl,
                         char *info_name,
                         arbitrary_info_t info,
                         arbitrary_info_t *info_ptr);

     graph_error_t
     hwgraph_info_get_LBL(vertex_hdl_t vhdl,
                         char *info_name,
                         arbitrary_info_t *info_ptr);

     graph_error_t
     hwgraph_info_export_LBL(vertex_hdl_t vhdl,
                         char *info_name,
                         int numbytes);

     graph_error_t
     hwgraph_info_unexport_LBL(vertex_hdl_t vhdl,
                         char *info_name);

   Arguments
     info        Arbitrary info value to associate with info_name in the
                 future.

     info_name   Address of the label string to be created or queried.

     info_ptr    pointer to a field to receive the info currently associated
                 with info_name, or NULL if the current value is not needed.

     numbytes    Length of information addressed by the pointer associated
                 with info_name, or 0 to indicate that the info info word
                 itself is the exported data.
     vhdl        Handle of an existing vertex.

DESCRIPTION
     These functions operate on a vertex in the hardware graph to add, remove,
     atomically replace, retrieve, export, and unexport labeled information.
     Typical device drivers do not need to use any of these operations.

     Exported labelled information on a vertex is visible to user-level
     processes as an extended file attribute (see attr_get(2)) on the /hw
     special file corresponding to that vertex.  By this means, the driver can
     export data to programs running as user-level processes.

DIAGNOSTICS
     All return GRAPH_SUCCESS when the operation completes successfully, or a
     failure code as defined in hwgraph.intro(D4X) when the operation does not
     complete  successfully.

SEE ALSO
     attr_get(2), hwgraph(4), hwgraph.intro(D4X).