[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Kernel and Subsystems, Volume 2
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
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
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. |
Related Information
Serial Optical Link Device Handler
Entry Points.
The sol_open entry point.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]