[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Communications Technical Reference, 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 Version 4.3 Communications Programming Concepts.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]