HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_PORT
Chapter 4886
Name of port being queried. This is an 8-byte ASCII
string, padded on the right with spaces if the name is
shorter than 8 bytes. This parameter is ignored if
list_options
is set to AP_FIRST_IN_LIST.
dlc_name
DLC name filter. To return information only on ports
associated with a specific DLC, specify the DLC name.
This is an 8-byte ASCII string, padded on the right
with spaces if the name is shorter than 8 bytes. To
return information about all ports without filtering on
the DLC name, set this parameter to 8 binary zeros.
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the supplied
buffer.
total_buf_size
Returned value indicating the size of buffer that would
have been required to return all the list information
requested. A value greater than
buf_size
indicates
that not all the available entries were returned.
num_entries
Number of entries returned in the data buffer.
total_num_entries
Total number of entries available. A value greater than
num_entries
indicates that not all the available
entries were returned.
Each entry in the data buffer consists of the following
parameters:
port_summary.overlay_size