hwgraph.inv(D3X)

NAME
     hwgraph.inv: device_inventory_add, device_inventory_get_next,
     device_controller_num_get, device_controller_num_set - device inventory
     information

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

     void
     device_inventory_add(dev_t device,
                          int class,
                          int type,
                          major_t ctlr,
                          minor_t unit,
                          int state);

     inventory_t *
     device_inventory_get_next(dev_t device, invplace_t * place);

     void
     device_controller_num_set(dev_t device, int ctlr);

     int
     device_controller_num_get(dev_t device);

   Arguments
     class       Inventory class to assign, from sys/invent.h.

     ctlr        Controller sequence number to assign.

     device      Vertex handle of a device vertex.

     place       Address of a variable to hold the current position in a scan
                 of inventory records.

     state       Arbitrary device state to assign.

     type        Inventory device type to assign, from sys/invent.h.

     unit        Device unit number to assign.

DESCRIPTION
     These functions manage the hardware inventory information.  In previous
     releases of IRIX, the hardware inventory as reported by hinv(1) and
     getinvent(3) was maintained as a table in kernel memory.  Now the same
     information is distributed throughout the hwgraph.  After creating a
     device vertex as described in hwgraph.dev(D3X), the driver can attach
     inventory information to the new vertex using device_inventory_add().
     Normally only a single inventory record is attached to a vertex, but
     multiple records are supported.  To read the first or all inventory
     records call device_inventory_get_next().  Initially the variable
     addressed by place should contain NULL to indicate "first."  The first
     inventory record is returned (if any exist), and the position is noted.
     Subsequent calls return further records if they exist.

     To read out the controller number from the first or only inventory
     record, call device_controller_num_get().  This is the means of
     discovering the controller number assigned by the ioconfig(1) program.

DIAGNOSTICS
     device_inventory_get_next() returns NULL when no (further) inventory
     record exists.

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