The DLC_QUERY_SAP ioctl operation is selectable through the fp_ioctl kernel service or the ioctl subroutine. It can be called from the process environment only.
The following parameter block queries statistics of a particular service access point (SAP):
#define DLC_MAX_DIAG 16 /* the max string of chars in the */
/* diag name */struct dlc_qsap_arg
{
__ulong32_t gdlc_sap_corr; /* GDLC SAP correlator */
__ulong32_t user_sap_corr; /* user SAP correlator (returned) */
__ulong32_t sap_state; /* state of the SAP,returned by kernel*
uchar_t dev[DLC_MAX_DIAG]; /* the returned device handler's */
/* device name */
__ulong32_t devdd_len; /* device driver dependent data */
/* byte length */
};
The fields of this ioctl operation are:
| Field | Description |
|---|---|
| gdlc_sap_corr | Contains the generic data link control (GDLC) SAP correlator to be queried. |
| user_sap_corr | Contains the user SAP correlator returned for routing purposes. |
| sap_state | Contains the current SAP state:
|
| dev | Contains the /dev directory name of the communications I/O device handler being used by this SAP. |
| devdd_len | Contains the byte length of the expected device driver statistics that will be appended to the dlc_qsap_arg structure. |
The device driver- dependent data contains the device statistics of the attached network device handler. This is generally the query device statistics (reliability/availability/serviceability log area) returned from an ioctl operation issued to the device handler by the Data Link Control (DLC). See the individual GDLC device manager specifications, discussed in the Generic Data Link Control (GDLC) Environment Overview, for information on the particular fields returned.
The optional data area must directly follow or append to the end of the dlc_qsap_arg structure.