[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

X25_LINK_STATUS (Link Status) x25sioctl Operation

Purpose

Returns the status of the link.

Description

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:
0 Link disconnected
1 Connecting link
2 Link connected
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.

Execution Environment

The X25_LINK_STATUS operation can be called from the process environment only.

Return Values

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:
CIO_BAD_MICROCODE
                          Indicates that the microcode download failed.
CIO_HARD_FAIL
                          Indicates that a hardware failure was detected.
ENOBUFS Indicates no available buffers.

Implementation Specifics

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.

Related Information

The X25_LINK_CONNECT x25sioctl operation, X25_LINK_DISCONNECT x25sioctl operation.

The x25sioctl entry point.


[ Previous | Next | Contents | Search ]