hwgraph.legacy(D3X)

NAME
     hwgraph.legacy: gio_hwgraph_lookup, io4_hwgraph_lookup,
     vme_hwgraph_lookup - legacy device hardware support

SYNOPSIS
     #include <sys/types.h>
     #include <sys/hwgraph.h>
     #include <sys/ddi.h>
     #include <sys/invent.h>
     #include <sys/giobus.h>
     #include <sys/EVEREST/io4.h>
     #include <sys/vmereg.h>

     graph_error_t
     gio_hwgraph_lookup(caddr_t addr, vertex_hdl_t *ret);

     graph_error_t
     io4_hwgraph_lookup(uint slot, vertex_hdl_t *ret);

     graph_error_t
     vme_hwgraph_lookup(uint adapter, vertex_hdl_t *ret);

   Arguments
     addr        The memory address of the device (used to determine the GIO
                 slot).

     adapter     The VME adapter number of the VME bus to which the device is
                 attached.

     slot        An IO4 slot number.

     ret         A vertex representing the desired bus.

DESCRIPTION
     These functions provide rudimentary hardware graph support for legacy
     devices which use the GIO, HIO, or VME busses.  Devices using newer
     busses, such as PCI or XTALK should use the facilities that support the
     appropriate bus.

     The routines described herein are provided to allow older devices to
     appear in the hardware graph file system.

     gio_hwgraph_lookup
          This routine returns a vertex for the GIO bus slot the device is
          using.  addr represents a memory address for the device; this is
          normally the e_base address from the edt structure.

     io4_hwgraph_lookup
          This routine returns a vertex for the IO4 to which the device is
          attached.  slot represents an EBUS slot.
     vme_hwgraph_lookup
          This routine returns a vertex for the VME bus the device is using.
          adapter represents a VME adapter number for the device; this is
          normally the e_adap value from the edt structure.

DIAGNOSTICS
     These routines return GRAPH_SUCCESS if successful.  Otherwise, the
     following diagnostic can be returned:

     GRAPH_NOT_FOUND
          No node was found for the desired bus entry.

SEE ALSO
     hinv(1), ioconfig(1), getinvent(3), hwgraph.dev(D3X), hwgraph.intro(D4X).