HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_LS
Chapter 4 735
Combine this value using a logical OR operation with
one of the following values:
AP_FIRST_IN_LIST
Start at the first entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the
ls_name parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately
following the entry specified by the
ls_name parameter.
For more information about how the list is ordered and
how the application can obtain specific entries from it,
see “List Options For QUERY_* Verbs”.
ls_name Link station name. This is an 8-byte ASCII string,
padded on the right with spaces if the name is shorter
than 8 characters. This value is ignored if
list_options is set to AP_FIRST_IN_LIST.
port_name Port name filter. To return information only on LSs
associated with a specific port, specify the name of the
port. This is an 8-byte ASCII string), padded on the
right with spaces if the name is shorter than 8
characters. To return information about all LSs
without filtering on the port 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.