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

x25smpx X.25 Device Handler Entry Point

Purpose

Provides the means to allocate and deallocate a channel into X.25 device handler.

Syntax

int x25xmpx (devno, chan, channame)
 dev_t devno;
 int *chan;
 char *channame;

Parameters

devno Specifies the major and minor device numbers.
chan Specifies the channel ID. If the channame parameter is a null character, the chan parameter identifies the channel to be deallocated. Otherwise, the x25smpx entry point returns the ID of the allocated channel to the chan parameter.
channame Points to the remaining path name describing the channel to allocate. The channame parameter accepts the following values:
null Deallocates the channel.
Pointer to a null string Allows a normal open sequence of the X.25 device on the channel ID generated by the x25smpx entry point.
Pointer to a "D" Allows the X.25 device to be opened in diagnostic mode on the channel ID generated by the x25smpx entry point.
Pointer to an "M" Allows the X.25 device to be opened in monitor mode on the channel ID generated by the x25smpx entry point.
Pointer to an "R" Allows the X.25 device to be opened in router mode on the channel ID generated by the x25smpx entry point.

Description

Note: This entry point is called by the kernel. It cannot be called directly by a user- or kernel-mode process.

The x25smpx entry point provides the means for allocating and deallocating a channel into the X.25 device handler. This entry point is called by the kernel in response to an open subroutine (before calling the x25sopen entry point) or in response to a close subroutine (after calling the x25sclose entry point).

Execution Environment

An x25smpx entry point can be called from the process environment only.

Return Values

A return code of -1 indicates an unsuccessful operation. The kernel sets the errno global variable to one of the following values:

EINVAL Indicates an invalid parameter was specified.
EPERM Indicates an open in the specified mode is denied.
EBUSY Indicates the device is already open in diagnostic, monitor, or router mode.

Implementation Specifics

The x25smpx 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 x25sclose entry point, x25sopen entry point.

The close subroutine, open subroutine.

X.25 Device Handler Modes in AIX Kernel Extensions and Device Support Programming Concepts.

[ Previous | Next | Contents | Search ]