sol_mpx Serial Optical Link Device Handler Entry Point

Purpose

Note: This function is supported in AIX® 5.1 and earlier only.

Allocates and deallocates a channel for the Serial Optical Link (SOL) device handler.

Syntax

#include  <sys/device.h>
#include  <sys/comio.h>
#include  <sys/soluser.h>

int sol_mpx ( devno,  chanp,  channame)
dev_t devno;
int *chanp;
char *channame;

Parameters

Item Description
devno Specifies major and minor device numbers.
chanp Specifies the channel ID passed as a reference parameter. If the channame parameter is null, the chanp parameter specifies the ID of the channel to deallocate. Otherwise, this parameter is set to the ID of the allocated channel.
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 SOL device on the channel ID generated by the sol_mpx entry point.
Pointer to a "D"
Allows the SOL device to be opened in Diagnostic mode on the channel ID generated by the sol_mpx entry point. Diagnostic mode is only valid when opening a /dev/opn special file.
Pointer to an "F"
Allows a forced open of any of the /dev/opn special files even after the /dev/ops0 file has been opened.
Pointer to an "S"
Indicates that data serialization is required when the /dev/ops0 file is being opened. When the Network Systems Corp. DX Router is used for communication, in-order reception cannot be guaranteed.

Description

The sol_mpx entry point is not called directly by a user of the SOL device handler. The kernel calls the sol_mpx entry point in response to an open or close request.

If the /dev/ops0 special file is open, the /dev/opn special files cannot be opened unless a forced open is requested. If one or more of the /dev/opn special files are open, opening the /dev/ops0 special file will succeed, but the ports already opened will not be used. Only one open is allowed for each /dev/opn special file.

The sol_mpx entry point functions with a Serial Link Adapter and Serial Optical Channel Converter that have been correctly configured for use on a qualified network. Consult hardware specifications for more information on configuring hardware and network qualifications.

Note: When the Network Systems Corp. DX Router is used for communication, in-order reception cannot be guaranteed.

Execution Environment

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

Return Values

Item Description
EPERM Indicates the device is open in a mode that does not allow the Diagnostic-mode open request.
EACCES Indicates a nonprivileged user tried to open the device in Diagnostic mode.
EINVAL Indicates an invalid argument was detected.
EIO Indicates an error occurred.
ENOMEM Indicates memory requests for the open failed.
ENODEV Indicates an invalid minor number was specified.
EBUSY Indicates the maximum number of opens has been exceeded.