nic(D3)

NAME
     nic_vertex_info_set - decode NIC, label vertex
     nic_vertex_info_get - get decoded NIC data from vertex
     nic_vertex_info_match - check for NIC data match
     nic_vmc_add - establish callback based on NIC data match
     nic_vmc_del - deactivate NIC data match callback
     nic_access_mcr32 - common NIC access function

SYNOPSIS
     #include <sys/nic.h>

     char *
     nic_vertex_info_set(
               nic_access_t access,
               nic_data_t data,
               vertex_hdl_t vhdl)

     char *
     nic_vertex_info_get(
               vertex_hdl_t vhdl)

     int
     nic_vertex_info_match(
               vertex_hdl_t vhdl,
               char *string)

     nic_vmce_t
     nic_vmc_add(
               char *string,
               nic_vmc_func *func)

     void
     nic_vmc_del(
               nic_vmce_t entry)

     nic_access_f   nic_access_mcr32;

   Arguments
     access  is a NIC access function appropriate for the ASIC through which
             the NIC is going to be accessed.

     data    is an appropriate value to pass as the first parameter to the
             access function; it is commonly an address through which the NIC
             will be accessed.

     entry   is an appropriate value returned from a previous nic_vmc_add()
             function call.

     string  is data to be found as a substring of the decoded NIC data.  Most
             commonly, it will be a seven digit SGI board part number.
     vhdl    is an appropriate handle to a vertex corresponding to the device
             to which the NIC is attached.

DESCRIPTION
     The first time nic_vertex_info_set() is called, it extracts and decodes
     the data from a NIC using the specified access function and data value,
     then annotates the specified vertex with the decoded data.  The NIC
     callback list is checked, and any matching callbacks are triggered.
     Subsequent calls merely return the decoded data already on the vertex.

     nic_vertex_info_get() returns the decoded NIC data attached to the
     specified vertex, or NULL if no decode has been attempted.

     nic_vertex_info_match() retrieves the NIC data for the specified vertex,
     and checks to see if the specified string is a substring in the decoded
     NIC data, returning nonzero if there is a match.

     nic_vmc_add() is used to establish a NIC data based callback; after this
     call is made, each NIC data decode will also check for a match with the
     specified string, and if there is a match, the callback function will be
     triggered with the appropriate vertex passed to it.

     nic_vmc_del() is used to tear down a NIC data based callback.

     nic_access_mcr32() is a common NIC access function used by several ASICs
     in current systems.

DIAGNOSTICS
     nic_vertex_info_get() returns NULL if there is no decoded NIC data
     attached to the specified vertex.