[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


ioctl Operations (op) for DLC

Syntax


#define  DLC_ENABLE_SAP 1
#define  DLC_DISABLE_SAP 2
#define  DLC_START_LS 3
#define  DLC_HALT_LS 4
#define  DLC_TRACE 5
#define  DLC_CONTACT 6
#define  DLC_TEST 7
#define  DLC_ALTER 8
#define  DLC_QUERY_SAP 9
#define  DLC_QUERY_LS 10
#define  DLC_ENTER_LBUSY 11
#define  DLC_EXIT_LBUSY 12
#define  DLC_ENTER_SHOLD 13
#define  DLC_EXIT_SHOLD 14
#define  DLC_GET_EXCEP 15
#define  DLC_ADD_GRP 16
#define  DLC_ADD_FUNC_ADDR 17
#define  DLC_DEL_FUNC_ADDR 18
#define  DLC_DEL_GRP 19
#define  IOCINFO
/* see /usr/include/sys/ioctl.h */

Description

Note: If the operation's notification is returned asynchronously to the user by way of exception, application users should refer to "DLC_GET_EXCEP ioctl Operation for DLC" and kernel users should refer to "Exception Condition Routine for DLC" for more information.

The following ioctl command operations are supported for generic data link control (GDLC):

DLC_ADD_FUNC_ADDR Adds a group or multicast receive functional address to a port. This command allows additional functional address bits to be added to the current receive functional address mask, as supported by the individual device handlers. See device handler specifications to determine which address values are supported.

Note: Currently, token ring is the only local area network (LAN) protocol supporting functional addresses.
DLC_ADD_GRP Adds a group or multicast receive address to a port. This command allows additional address values to be filtered in receive as supported by the individual communication device handlers. See device handler specifications to determine which address values are supported.
DLC_ALTER Alters link station (LS) configuration.
DLC_CONTACT Contacts the remote LS. This ioctl operation does not complete processing before returning to the user. The DLC_CONTACT notification is returned asynchronously to the user by way of exception.
DLC_DEL_GRP Removes a group or multicast address that was previously added to a port with a  DLC_ENABLE_SAP or DLC_ADD_GRP ioctl operation.
DLC_DEL_FUNC_ADDR Removes a group or multicast receive functional address from a port. This command removes functional address bits from the current receive functional address mask, as supported by the individual device handlers. See device handler specifications to determine which address values are supported.

Note: Currently, token ring is the only local area network protocol supporting functional addresses.
DLC_DISABLE_SAP Disables a service access point (SAP). This ioctl operation does not fully complete the disable SAP processing before returning to the user. The DLC_DISABLE_SAP notification is returned asynchronously to the user later by way of exception.
DLC_ENABLE_SAP Enables an SAP. This ioctl operation does not fully complete the enable SAP processing before returning to the user. The DLC_ENABLE_SAP notification is returned asynchronously to the user later by way of exception.
DLC_ENTER_LBUSY Enters local busy mode on an LS.
DLC_ENTER_SHOLD Enters short hold mode on an LS.
DLC_EXIT_LBUSY Exits local busy mode on an LS.
DLC_EXIT_SHOLD Exits short hold mode on an LS.
DLC_GET_EXCEP Returns asynchronous exception notifications to the application user.

Note: This ioctl command operation is not used by the kernel user since all exception conditions are passed to the kernel user by their exception handler routine.
DLC_HALT_LS Halts an LS. This ioctl operation does not complete processing before returning to the user. Notification of the ioctl operation, DLC_HALT_LS, is returned asynchronously to the user by way of exception.
DLC_QUERY_LS Queries an LS.
DLC_QUERY_SAP Queries an SAP.
DLC_START_LS Starts an LS. This ioctl operation does not complete processing before returning to the user. Notification of the ioctl operation, DLC_START_LS, is returned asynchronously to the user by way of exception.
DLC_TEST Tests LS connectivity. This ioctl operation does not complete processing before returning to the user. Notification of the ioctl operation, DLC_TEST completion, is returned asynchronously to the user by way of exception.
DLC_TRACE Traces LS activity.
IOCINFO Returns a structure that describes the device. Refer to the description of the /usr/include/sys/devinfo.h file. The first byte is set to an ioctype of DD_DLC. The subtype and data are defined by the individual DLC devices.

Implementation Specifics

Each GDLC supports a subset of ioctl subroutine operations. These ioctl operations are selectable through the fp_ioctl kernel service or the ioctl subroutine. They may be called from the process environment only.

Related Information

Parameter Blocks by ioctl Operation for DLC .

Generic Data Link Control (GDLC) Environment Overview in AIX 5L Version 5.1 Communications Programming Concepts.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]