HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_PORT
Chapter 4882
QUERY_PORT
QUERY_PORT returns a list of information about a node's ports. If the
port is active, it returns "determined" data, i.e. the address of the lan
card, no matter what is configured.If the port is inactive, it returns
"defined" data, i.e. the mac address held in the configuration file.
This verb can be used to obtain either summary or detailed information,
about a specific port or about multiple ports, depending on the options
used.
VCB Structure
typedef struct query_port
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
unsigned char port_name[8]; /* port name */
unsigned char dlc_name[8]; /* DLC name filter */
} QUERY_PORT;
typedef struct port_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char port_name[8]; /* port name */
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
unsigned char port_state; /* port state */
unsigned char reserv1[1]; /* reserved */
unsigned char dlc_name[8]; /* name of DLC */
} PORT_SUMMARY;
typedef struct port_detail
{
AP_UINT16 overlay_size; /* size of returned entry */