Returns the status of the link.
The X25_LINK_STATUS x25sioctl operation returns the status of a link. This operation returns the last known status of the link to the calling program.
For the X25_LINK_STATUS operation, the arg parameter points to a buffer. On return of this operation, the buffer is filled with a x25_link_status structure. This structure contains the following five fields:
|status||Supplied by an X.25 device handler with a return value when the return code is EIO.|
|packet|| Identifies the status of the packet layer. This field has the following possible values:
|frame||Specifies the status of the frame layer. This field has the same values as the packet field.|
|physical||Specifies the status of the physical layer. This field has the same values as the packet field.|
|no_of_vcs_in_use||Identifies the number of virtual circuits currently in use on the link.|
The X25_LINK_STATUS operation can be called from the process environment only.
A return code of -1 indicates an unsuccessful operation. If -1 is returned, the kernel sets the errno global variable to one of the following values:
|EFAULT||Indicates a specified address is not valid.|
|EIO|| Indicates an error occurred. The status
field of the x25_link_status structure contains one of the following exception codes:
|ENOBUFS||Indicates no available buffers.|
The X25_LINK_STATUS operation functions with an X.25 Interface Co-Processor/2 that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.
The X25_LINK_CONNECT x25sioctl operation, X25_LINK_DISCONNECT x25sioctl operation.
The x25sioctl entry point.