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

X25_LINK_DISCONNECT (Disconnect Link) x25sioctl Operation

Purpose

Disconnects the link to the data circuit-terminating equipment (DCE).

Description

Note: This command is restricted to user programs that have root authority.

The X25_LINK_DISCONNECT x25sioctl operation disconnects the X.25 link from the network. If the link is already disconnected, no action is taken. If there are virtual calls in progress on the link, disconnection takes place only if the override parameter is nonzero.

The X25_LINK_DISCONNECT operation returns synchronously. The X25_LINK_STATUS operation is used to determine if the disconnect operation is complete.

For the X25_LINK_DISCONNECT operation, the arg parameter points to the x25_disconnect_data structure. This structure contains the following fields.

status Holds values supplied by the ioctl operation if there is an EIO error.
override Specifies how disconnection occurs. If this parameter is 0, the disconnection takes place only if there are no virtual calls in progress. Otherwise, the disconnection is forced. This disconnects the link layer only, not the physical layer.

Execution Environment

The X25_LINK_DISCONNECT 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:

EACCES Indicates the calling application does not have root authority.
EBUSY Indicates there are active circuits on the link.
EIO Unable to disconnect due to an I/O error. The status field in the x25_disconnect_data structure contains one of the following common exception codes:
CIO_HARD_FAIL
                          Indicates that a hardware failure was detected.
CIO_TIMEOUT
                          Indicates that a time out occurred.
ENOBUFS Indicates no available buffers.

Implementation Specifics

The X25_LINK_DISCONNECT 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_STATUS x25sioctl operation.

The x25sioctl entry point.


[ Previous | Next | Contents | Search ]