HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_PORT
Possible values are:
AP_INVALID_PLU_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the plu_alias or fqplu_name parameter was not valid.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK
,
which are common to all NOF verbs.
3.148.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.149 QUERY_PORT
QUERY_PORT returns a list of information about a node’s ports. This information is structured as “determined
data” (data gathered dynamically during execution) and “defined data” (the data supplied by the application on
DEFINE_PORT).
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.
3.149.1 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 */
608