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

x25sioctl X.25 Device Handler Entry Point

Purpose

Provides various functions for controlling the X.25 device.

Syntax

int x25sioctl (devno, cmd, arg, devflag, chan, ext)
dev_t devno;
int cmd, arg;
ulong devflag;
int chan, ext;

Parameters

devno Specifies major and minor device numbers.
cmd Specifies which of the available x25sioctl operations is to be performed.
arg Identifies the address of the x25sioctl parameter block. The meaning of this parameter depends on the value of the cmd parameter.
devflag Indicates how the device was opened and whether the caller is a user- or kernel-mode process. This parameter accepts the following flags:
DAPPEND Specifies open for appending. The X.25 handler ignores this flag.
DKERNEL Indicates a kernel-mode process called the entry point. This flag is clear if a user-mode process called the entry point.
DNDELAY Specifies the X.25 device handler performs nonblocking reads and writes. If this flag is not set, the X.25 device handler performs blocking reads and writes.
DREAD Specifies open for reading. This is the default for the X.25 handler regardless of whether this flag is set.
DWRITE Specifies open for writing. This is the default for the X.25 handler regardless of whether this flag is set.
chan Identifies the channel number assigned by the x25smpx entry point.
ext Specifies the extended system call parameter. The meaning of this parameter depends on the value of the cmd parameter.

Description

The x25sioctl X.25 device handler entry point provides various functions for controlling the X.25 device. The following are valid operations for the X.25 device:

CIO_DNLD
                          Downloads tasks to the kernel.
CIO_GET_STAT
                          Returns the next status block.
CIO_HALT
                          Halts a session.
CIO_QUERY
                          Returns the current RAS counter values.
CIO_START
                          Starts a session and registers a network ID.
IOCINFO
                          Returns a structure that describes the device.

In addition to the above standard operations, the x25sioctl operation supports the following X.25 specific commands:

X25_ADD_ROUTER_ID
                          Adds a router ID.
X25_COUNTER_GET
                          Gets a counter for asynchronous notification.
X25_COUNTER_READ
                          Reads the value of a counter.
X25_COUNTER_REMOVE
                          Removes a counter from the system.
X25_COUNTER_WAIT
                          Waits for the contents of counters to change.
X25_DELETE_ROUTER_ID
                          Deletes a router ID.
X25_DIAG_IO_READ
                          Reads from an I/O register on the adapter.
X25_DIAG_IO_WRITE
                          Writes to an I/O register on the adapter.
X25_DIAG_MEM_READ
                          Reads memory from the adapter into a user's buffer.
X25_DIAG_MEM_WRITE
                          Writes to memory on the adapter from a user's buffer.
X25_DIAG_TASK
                          Downloads the diagnostics task onto the card.
X25_LINK_CONNECT
                          Connects a link.
X25_LINK_DISCONNECT
                          Disconnects a link.
X25_LINK_STATUS
                          Queries the status of a link.
X25_LOCAL_BUSY
                          Enables or disables receiving data packets on a port.
X25_QUERY_SESSION
                          Queries a session.
X25_QUERY_ROUTER_ID
                          Queries router ID.
X25_REJECT
                          Rejects a call.

Execution Environment

The x25sioctl entry point can be called from the process environment only.

Implementation Specifics

The x25sioctl entry point 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 x25smpx entry point.

[ Previous | Next | Contents | Search ]