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.
     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 ALSO
     hinv(1), ioconfig(1), getinvent(3), hwgraph.dev(D3X),
     hwgraph.legacy(D3X), hwgraph.intro(D4X).