hwgraph.net(D3X)hwgraph.net(D3X)NAME
hwgraph.net: if_hwgraph_add, if_hwgraph_alias_add,
if_hwgraph_alias_remove - network device information
SYNOPSIS
#include <sys/types.h>
#include <sys/hwgraph.h>
#include <sys/ddi.h>
#include <sys/invent.h>
#include <net/if.h>
graph_error_t
if_hwgraph_add(vertex_hdl_t parent,
char *path,
char *prefix,
char *alias,
vertex_hdl_t *ret);
graph_error_t
if_hwgraph_alias_add(vertex_hdl_t target, char *alias);
graph_error_t
if_hwgraph_alias_remove(char *path);
Arguments
alias The alias to be inserted in /hw/net.
parent The attachment point of the device.
path A character string representing a path in the hardware graph.
prefix The string from the PREFIX field of the master file.
ret A vertex representing the device itself.
target A character string representing the target of a link in the
hardware graph.
DESCRIPTION
These functions provide ancillary hardware graph support for networking
devices.
if_hwgraph_add
This routine provides rudimentary support for legacy networking
devices. It creates an entry for the device in the hardware graph,
attached to parent. An entry under /hw/net is created for alias.
The device must be designated as a character device in its master
file.
if_hwgraph_alias_add
This routine can be used by a device driver to create an alias for
itself in /hw/net. The target argument should be the device itself.
Page 1
hwgraph.net(D3X)hwgraph.net(D3X)
if_hwgraph_alias_remove
This routine can be used to remove an alias in the event that the
device is unloaded.
DIAGNOSTICS
These routines return GRAPH_SUCCESS if successful. Otherwise, the
following diagnostics can be returned:
GRAPH_CANNOT_ALLOC
Initialization of the underlying networking hardware graph failed.
GRAPH_DUP
The specified path already exists.
GRAPH_NOT_FOUND
An attempt was made to remove an alias when it did not exist.
NOTES
Devices with full support for the hardware graph should not normally need
to use if_hwgraph_add.
The aliases in /hw/net are currently a convenience for system
administrators. In future versions of IRIX, they may be required by
system utilities. Developers are encouraged to support them in their
drivers.
SEE ALSOhinv(1), ioconfig(1), getinvent(3), hwgraph.dev(D3X),
hwgraph.legacy(D3X), hwgraph.intro(D4X).
Page 2
