Removes a routing name.
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:
|Specifies the unique ID for the entry.
|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.
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:
|Indicates the ioctl was issued on a channel that was not opened in Router mode.
|Indicates the router ID was being listened to and the override option was not set.
|Indicates a specified address was not valid.
|Indicates the router ID cannot be deleted because it does not exist.
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.
The x25sioctl entry point.