fp_ioctl Kernel Service for Data Link Control (DLC) Devices

Purpose

Transfers special commands from the kernel to generic data link control (GDLC) using a file pointer.

Syntax

#include <sys/gdlextcb.h>
#include <fcntl.h>

int fp_ioctl (fp, cmd, arg, ext)

Parameters

Item	Description
fp	Specifies the file pointer of the target GDLC.
cmd	Specifies the operation to be performed by GDLC. For a listing of all possible operators, see "ioctl Operations (op) for DLC"AIX® Version 7.1 Technical Reference: Communications, Volume 1.
arg	Specifies the address of the parameter block. The argument for this parameter must be in the kernel space. For a listing of possible values, see "Parameter Blocks by ioctl Operation for DLC"AIX Version 7.1 Technical Reference: Communications, Volume 1.
ext	Specifies the extension parameter. This parameter is ignored by GDLC.

Description

Various GDLC functions can be initiated using the fp_ioctl kernel service, such as changing configuration parameters, contacting the remote, and testing a link. Most of these operations can be completed before returning to the user synchronously. Some operations take longer, so asynchronous results are returned much later using the exception function handler. GDLC calls the kernel user's exception handler to complete these results. Each GDLC supports the fp_ioctl kernel service by way of its dlcioctl entry point. The fp_ioctl kernel service may be called from the process environment only.

Note: The DLC_GET_EXCEP ioctl operation is not used since all exception conditions are passed to the kernel user through the exception handler.

Return Values

Item	Description
0	Indicates a successful completion.
ENXIO	Indicates an invalid file pointer.
EINVAL	Indicates an invalid value.
ENOMEM	Indicates insufficient resources to satisfy the ioctl subroutine.

These return values are defined in the /usr/include/sys/errno.h file.