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

X25_COUNTER_REMOVE (Remove Counter) x25sioctl X.25 Device Handler Operation

Purpose

Removes a counter from the system.

Description

Note: Only user-mode processes can use counter operations.

The X25_COUNTER_REMOVE x25sioctl operation removes the specified counter from the system. For this operation, the arg parameter indicates what ID is to be removed. An error code is returned if there is outstanding data to be read associated with this counter.

Execution Environment

The X25_COUNTER_REMOVE 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 application did not get the counter. The counter is not deleted.
EBUSY Indicates one of the following errors occurred:
  • Some packets are still waiting to be read.
  • The counter is being waited on by another process.
EINVAL Indicates the counter ID specified does not exist.

Implementation Specifics

The X25_COUNTER_REMOVE 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_COUNTER_GET x25sioctl X.25 Device Handler Operation, X25_COUNTER_READ x25sioctl X.25 Device Handler Operation, X25_COUNTER_WAIT x25sioctl X.25 Device Handler Operation.

The x25sioctl device handler entry point.


[ Previous | Next | Contents | Search ]