[ Previous |
Next |
Contents |
Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference
X25_DELETE_ROUTER_ID (Delete Router ID) x25sioctl X.25 Device Handler Operation
Purpose
Removes a routing name.
Description
Note: Only a process that has opened the router special file can call the X.25 X25_DELETE_ROUTER_ID operation.
The X25_DELETE_ROUTER_ID x25sioctl operation removes a routing name from the router table. For this operation, the arg parameter points to the x25_router_del structure. This structure contains the following fields:
| router_id
|
Specifies the unique ID for the entry. |
| override
|
Indicates how listening is handled. If set to 0, the routing entry is not deleted if any process is listening for it. If set to a non-zero value, outstanding listens are canceled. No notification is given to the listening applications if the outstanding listens are canceled. |
The X25_DELETE_ROUTER_ID 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 ioctl was issued on a channel that was not opened in Router mode. |
| EBUSY |
Indicates the router ID was being listened to and the override option was not set. |
| EFAULT |
Indicates a specified address was not valid. |
| EINVAL |
Indicates the router ID cannot be deleted because it does not exist. |
Implementation Specifics
The X25_DELETE_ROUTER_ID 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 x25sioctl entry point.
[ Previous |
Next |
Contents |
Search ]