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

X25_DIAG_MEM_READ (Read Memory) x25sioctl Operation

Purpose

Reads memory from the X.25 Interface Co-Processor/2 into a user buffer.

Description

Note: Only a process that has opened the device for diagnostics can call this process.

The X25_DIAG_MEM_READ x25sioctl operation reads memory from the X.25 Interface Co-Processor/2 into a user's buffer. For this operation, the arg parameter points to a x25_diag_mem structure. This structure provides the following:

The read operation can cover more than one page of card memory.

Execution Environment

The X25_DIAG_MEM_READ 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 The channel was not opened in diagnostic mode.
ENXIO The operation attempted to read a card that was not configured.

Implementation Specifics

The X25_DIAG_MEM_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.

Related Information

The X25_DIAG_IO_READ x25sioctl operation, X25_DIAG_IO_WRITE x25sioctl operation, X25_DIAG_MEM_WRITE x25sioctl operation, X25_DIAG_TASK x25sioctl operation.

The x25sioctl entry point.


[ Previous | Next | Contents | Search ]