hwgraph.lblinfo(D3X)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.
Page 1
hwgraph.lblinfo(D3X)hwgraph.lblinfo(D3X)
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 ALSOattr_get(2), hwgraph(4), hwgraph.intro(D4X).
Page 2