Datagram Data Received Routine for DLC

AIX Version 4.3 Communications Technical Reference, Volume 1

Datagram Data Received Routine for DLC

Purpose

Receives a datagram packet each time it is coded by the kernel user and called by generic data link control (GDLC).

Syntax

#include <sys/gdlextcb.h>

int (*dlc_open_ext.rcvd_fa)(m, ext)
struct mbuf *m;
struct dlc_io_ext *ext;

Description

The DLC Datagram Data Received routine receives a datagram packet each time it is coded by the kernel user and called by GDLC.

Parameters

m	Points to a communications memory buffer (mbuf).
ext	Specifies the receive extension parameter. This is a pointer to the dlc_io_ext extended I/O structure for read operations.

Return Values

DLC_FUNC_OK	Indicates that the received datagram mbuf data has been accepted.
DLC_FUNC_RETRY	Indicates that the received datagram mbuf data cannot be accepted at this time. GDLC should retry this function later. The actual retry wait period depends on the DLC in use. Excessive retries may close the link station.

Implementation Specifics

Each GDLC supports a subset of the data-received routines. It is critical to performance that the Datagram Data Received routine be coded to minimize the amount of time spent prior to returning to the GDLC that called it.

Related Information

read Subroutine Extended Parameters for DLC.

Generic Data Link Control (GDLC) Environment Overview in AIX Communications Programming Concepts.