Note: Only user-mode processes can use counter operations.
The X25_COUNTER_READ x25sioctl operation reads the value of a counter. For this operation, the arg parameter points to the x25_counter_info structure. This structure contains the following fields:
| counter_id | Identifies a counter to read. |
| counter_value | Holds the current value of the counter on return of the X25_COUNTER_READ operation. |
The X25_COUNTER_READ 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:
| EFAULT | Indicates a specified address is not valid. |
| EINVAL | Indicates the counter ID does not exist. |
The X25_COUNTER_READ 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_COUNTER_GET x25sioctl X.25 Device Handler Operation, X25_COUNTER_REMOVE x25sioctl X.25 Device Handler Operation, X25_COUNTER_WAIT x25sioctl X.25 Device Handler Operation.
The x25sioctl device handler entry point.