Disconnects the link to the data circuit-terminating equipment (DCE).
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. |
The X25_LINK_DISCONNECT 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:
| 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:
| ||||||||
| ENOBUFS | Indicates no available buffers. | ||||||||
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.
The X25_LINK_CONNECT x25sioctl operation, X25_LINK_STATUS x25sioctl operation.
The x25sioctl entry point.