nic(D3)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.
Page 1
nic(D3)nic(D3)
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.
DIAGNOSTICSnic_vertex_info_get() returns NULL if there is no decoded NIC data
attached to the specified vertex.
Page 2