c3dd1fa899
Host ATM Research Platform (HARP), Network Computing Services, Inc. This software was developed with the support of the Defense Advanced Research Projects Agency (DARPA).
288 lines
10 KiB
C
288 lines
10 KiB
C
/*
|
|
*
|
|
* ===================================
|
|
* HARP | Host ATM Research Platform
|
|
* ===================================
|
|
*
|
|
*
|
|
* This Host ATM Research Platform ("HARP") file (the "Software") is
|
|
* made available by Network Computing Services, Inc. ("NetworkCS")
|
|
* "AS IS". NetworkCS does not provide maintenance, improvements or
|
|
* support of any kind.
|
|
*
|
|
* NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
|
|
* INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
|
|
* SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
|
|
* In no event shall NetworkCS be responsible for any damages, including
|
|
* but not limited to consequential damages, arising from or relating to
|
|
* any use of the Software or related support.
|
|
*
|
|
* Copyright 1994-1998 Network Computing Services, Inc.
|
|
*
|
|
* Copies of this Software may be made, however, the above copyright
|
|
* notice must be reproduced on all copies.
|
|
*
|
|
* @(#) $Id: atm_stack.h,v 1.5 1998/02/19 19:59:59 mks Exp $
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* Core ATM Services
|
|
* -----------------
|
|
*
|
|
* ATM Stack definitions
|
|
*
|
|
*/
|
|
|
|
#ifndef _NETATM_ATM_STACK_H
|
|
#define _NETATM_ATM_STACK_H
|
|
|
|
#ifdef ATM_KERNEL
|
|
/*
|
|
* Structure used to define a kernel-provided ATM stack service and its
|
|
* associated entry points. Each stack service provider must register
|
|
* themselves before they will be used. ATM stack service providers include
|
|
* kernel modules (both linked and loaded) and device drivers, which must list
|
|
* (via its atm_pif) any of its available hardware-supplied stack services
|
|
* (such as on-card AAL processing).
|
|
*/
|
|
struct stack_defn {
|
|
struct stack_defn *sd_next; /* Next in registry list */
|
|
Sap_t sd_sap; /* Stack instance SAP */
|
|
u_char sd_flag; /* Flags (see below) */
|
|
/* Exported functions */
|
|
int (*sd_inst) /* Stack instantiation */
|
|
__P((struct stack_defn **, Atm_connvc *));
|
|
void (*sd_lower) /* Lower (from above) command handler */
|
|
__P((int, void *, int, int));
|
|
void (*sd_upper) /* Upper (from below) command handler */
|
|
__P((int, void *, int, int));
|
|
/* Variables used during stack instantiation */
|
|
void *sd_toku; /* Stack service instance token */
|
|
};
|
|
|
|
/*
|
|
* Stack Service Flags
|
|
*/
|
|
#define SDF_TERM 0x01 /* Terminal (to lowest layer) service */
|
|
|
|
|
|
/*
|
|
* Stack Specification List
|
|
*
|
|
* The list names the stack services and their layering relationships in
|
|
* order to construct a stack to provide the protocol services defined
|
|
* by the list. The list is ordered starting from the stack service
|
|
* interfacing with the user "down" to the ATM cell service.
|
|
*/
|
|
#define STACK_CNT 8 /* Max services in a stack list */
|
|
struct stack_list {
|
|
Sap_t sl_sap[STACK_CNT]; /* Stack service SAP list */
|
|
};
|
|
|
|
|
|
/*
|
|
* Structure used during the construction and instantiation of a stack
|
|
* instance from a supplied stack list. It contains pointers to the stack
|
|
* service definitions which will be used to implement the stack. The first
|
|
* element in the array is reserved for the user's "stack service".
|
|
*/
|
|
struct stack_inst {
|
|
struct stack_defn *si_srvc[STACK_CNT+1]; /* Assigned services */
|
|
};
|
|
|
|
|
|
/*
|
|
* Macros to update buffer headroom values during stack instantiation.
|
|
*
|
|
* These values are advisory, i.e. every service must verify the amount
|
|
* of available space in input/output messages and allocate new buffers
|
|
* if needed.
|
|
*
|
|
* The 'maximum' and 'minimum' values used below may be chosen by a
|
|
* service to reflect the typical, expected message traffic pattern
|
|
* for a specific connection.
|
|
*
|
|
* The macro arguments are:
|
|
* cvp = pointer to connection vcc;
|
|
* hi = maximum amount of buffer headroom required by the current
|
|
* service during input message processing;
|
|
* si = minimum amount of buffer data stripped off the front
|
|
* of an input message by the current service;
|
|
* ho = maximum amount of buffer headroom required by the current
|
|
* service during output message processing;
|
|
* ao = maximum amount of buffer data added to the front
|
|
* of an output message by the current service;
|
|
*/
|
|
#define HEADIN(cvp, hi, si) \
|
|
{ \
|
|
short t = (cvp)->cvc_attr.headin - (si); \
|
|
t = (t >= (hi)) ? t : (hi); \
|
|
(cvp)->cvc_attr.headin = roundup(t, sizeof(long)); \
|
|
}
|
|
|
|
#define HEADOUT(cvp, ho, ao) \
|
|
{ \
|
|
short t = (cvp)->cvc_attr.headout + (ao); \
|
|
t = (t >= (ho)) ? t : (ho); \
|
|
(cvp)->cvc_attr.headout = roundup(t, sizeof(long)); \
|
|
}
|
|
|
|
|
|
/*
|
|
* Stack command codes - All stack command codes are specific to the
|
|
* defined stack SAP across which the command is used. Command values 0-15
|
|
* are reserved for any common codes, which all stack SAPs must support.
|
|
*/
|
|
#define STKCMD(s, d, v) (((s) << 16) | (d) | (v))
|
|
#define STKCMD_DOWN 0
|
|
#define STKCMD_UP 0x00008000
|
|
#define STKCMD_SAP_MASK 0xffff0000
|
|
#define STKCMD_VAL_MASK 0x00007fff
|
|
|
|
/* Common command values (0-15) */
|
|
#define CCV_INIT 1 /* DOWN */
|
|
#define CCV_TERM 2 /* DOWN */
|
|
|
|
/* SAP_ATM */
|
|
#define ATM_INIT STKCMD(SAP_ATM, STKCMD_DOWN, CCV_INIT)
|
|
#define ATM_TERM STKCMD(SAP_ATM, STKCMD_DOWN, CCV_TERM)
|
|
#define ATM_DATA_REQ STKCMD(SAP_ATM, STKCMD_DOWN, 16)
|
|
#define ATM_DATA_IND STKCMD(SAP_ATM, STKCMD_UP, 17)
|
|
|
|
/* SAP_SAR */
|
|
#define SAR_INIT STKCMD(SAP_SAR, STKCMD_DOWN, CCV_INIT)
|
|
#define SAR_TERM STKCMD(SAP_SAR, STKCMD_DOWN, CCV_TERM)
|
|
#define SAR_UNITDATA_INV STKCMD(SAP_SAR, STKCMD_DOWN, 16)
|
|
#define SAR_UNITDATA_SIG STKCMD(SAP_SAR, STKCMD_UP, 17)
|
|
#define SAR_UABORT_INV STKCMD(SAP_SAR, STKCMD_DOWN, 18)
|
|
#define SAR_UABORT_SIG STKCMD(SAP_SAR, STKCMD_UP, 19)
|
|
#define SAR_PABORT_SIG STKCMD(SAP_SAR, STKCMD_UP, 20)
|
|
|
|
/* SAP_CPCS */
|
|
#define CPCS_INIT STKCMD(SAP_CPCS, STKCMD_DOWN, CCV_INIT)
|
|
#define CPCS_TERM STKCMD(SAP_CPCS, STKCMD_DOWN, CCV_TERM)
|
|
#define CPCS_UNITDATA_INV STKCMD(SAP_CPCS, STKCMD_DOWN, 16)
|
|
#define CPCS_UNITDATA_SIG STKCMD(SAP_CPCS, STKCMD_UP, 17)
|
|
#define CPCS_UABORT_INV STKCMD(SAP_CPCS, STKCMD_DOWN, 18)
|
|
#define CPCS_UABORT_SIG STKCMD(SAP_CPCS, STKCMD_UP, 19)
|
|
#define CPCS_PABORT_SIG STKCMD(SAP_CPCS, STKCMD_UP, 20)
|
|
|
|
/* SAP_SSCOP */
|
|
#define SSCOP_INIT STKCMD(SAP_SSCOP, STKCMD_DOWN, CCV_INIT)
|
|
#define SSCOP_TERM STKCMD(SAP_SSCOP, STKCMD_DOWN, CCV_TERM)
|
|
#define SSCOP_ESTABLISH_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 16)
|
|
#define SSCOP_ESTABLISH_IND STKCMD(SAP_SSCOP, STKCMD_UP, 17)
|
|
#define SSCOP_ESTABLISH_RSP STKCMD(SAP_SSCOP, STKCMD_DOWN, 18)
|
|
#define SSCOP_ESTABLISH_CNF STKCMD(SAP_SSCOP, STKCMD_UP, 19)
|
|
#define SSCOP_RELEASE_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 20)
|
|
#define SSCOP_RELEASE_IND STKCMD(SAP_SSCOP, STKCMD_UP, 21)
|
|
#define SSCOP_RELEASE_CNF STKCMD(SAP_SSCOP, STKCMD_UP, 22)
|
|
#define SSCOP_DATA_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 23)
|
|
#define SSCOP_DATA_IND STKCMD(SAP_SSCOP, STKCMD_UP, 24)
|
|
#define SSCOP_RESYNC_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 25)
|
|
#define SSCOP_RESYNC_IND STKCMD(SAP_SSCOP, STKCMD_UP, 26)
|
|
#define SSCOP_RESYNC_RSP STKCMD(SAP_SSCOP, STKCMD_DOWN, 27)
|
|
#define SSCOP_RESYNC_CNF STKCMD(SAP_SSCOP, STKCMD_UP, 28)
|
|
#define SSCOP_RECOVER_IND STKCMD(SAP_SSCOP, STKCMD_UP, 29)
|
|
#define SSCOP_RECOVER_RSP STKCMD(SAP_SSCOP, STKCMD_DOWN, 30)
|
|
#define SSCOP_UNITDATA_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 31)
|
|
#define SSCOP_UNITDATA_IND STKCMD(SAP_SSCOP, STKCMD_UP, 32)
|
|
#define SSCOP_RETRIEVE_REQ STKCMD(SAP_SSCOP, STKCMD_DOWN, 33)
|
|
#define SSCOP_RETRIEVE_IND STKCMD(SAP_SSCOP, STKCMD_UP, 34)
|
|
#define SSCOP_RETRIEVECMP_IND STKCMD(SAP_SSCOP, STKCMD_UP, 35)
|
|
|
|
/* SAP_SSCF_UNI */
|
|
#define SSCF_UNI_INIT STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, CCV_INIT)
|
|
#define SSCF_UNI_TERM STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, CCV_TERM)
|
|
#define SSCF_UNI_ESTABLISH_REQ STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, 16)
|
|
#define SSCF_UNI_ESTABLISH_IND STKCMD(SAP_SSCF_UNI, STKCMD_UP, 17)
|
|
#define SSCF_UNI_ESTABLISH_CNF STKCMD(SAP_SSCF_UNI, STKCMD_UP, 18)
|
|
#define SSCF_UNI_RELEASE_REQ STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, 19)
|
|
#define SSCF_UNI_RELEASE_IND STKCMD(SAP_SSCF_UNI, STKCMD_UP, 20)
|
|
#define SSCF_UNI_RELEASE_CNF STKCMD(SAP_SSCF_UNI, STKCMD_UP, 21)
|
|
#define SSCF_UNI_DATA_REQ STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, 22)
|
|
#define SSCF_UNI_DATA_IND STKCMD(SAP_SSCF_UNI, STKCMD_UP, 23)
|
|
#define SSCF_UNI_UNITDATA_REQ STKCMD(SAP_SSCF_UNI, STKCMD_DOWN, 24)
|
|
#define SSCF_UNI_UNITDATA_IND STKCMD(SAP_SSCF_UNI, STKCMD_UP, 25)
|
|
|
|
|
|
/*
|
|
* The STACK_CALL macro must be used for all stack calls between adjacent
|
|
* entities. In order to avoid the problem with recursive stack calls
|
|
* modifying protocol state, this macro will only allow calls to proceed if
|
|
* they are not "against the flow" of any currently pending calls for a
|
|
* stack instance. If the requested call can't be processed now, it will
|
|
* be deferred and queued until a later, safe time (but before control is
|
|
* returned back to the kernel scheduler) when it will be dispatched.
|
|
*
|
|
* The STACK_CALL macro arguments are:
|
|
* cmd = command code;
|
|
* fn = Destination entity processing function
|
|
* tok = Destination layer's session token;
|
|
* cvp = Connection VCC address;
|
|
* a1 = command specific argument;
|
|
* a2 = command specific argument;
|
|
* ret = call result value (0 => success)
|
|
*
|
|
* The receiving entity command processing function prototype is:
|
|
*
|
|
* void (fn)(int cmd, int tok, int arg1, int arg2)
|
|
*
|
|
*/
|
|
#define STACK_CALL(cmd, fn, tok, cvp, a1, a2, ret) \
|
|
{ \
|
|
if ((cmd) & STKCMD_UP) { \
|
|
if ((cvp)->cvc_downcnt) { \
|
|
(ret) = atm_stack_enq((cmd), (fn), (tok), \
|
|
(cvp), (a1), (a2)); \
|
|
} else { \
|
|
(cvp)->cvc_upcnt++; \
|
|
(*fn)(cmd, tok, a1, a2); \
|
|
(cvp)->cvc_upcnt--; \
|
|
(ret) = 0; \
|
|
} \
|
|
} else { \
|
|
if ((cvp)->cvc_upcnt) { \
|
|
(ret) = atm_stack_enq((cmd), (fn), (tok), \
|
|
(cvp), (a1), (a2)); \
|
|
} else { \
|
|
(cvp)->cvc_downcnt++; \
|
|
(*fn)(cmd, tok, a1, a2); \
|
|
(cvp)->cvc_downcnt--; \
|
|
(ret) = 0; \
|
|
} \
|
|
} \
|
|
}
|
|
|
|
|
|
/*
|
|
* Stack queue entry - The stack queue will contain stack calls which have
|
|
* been deferred in order to avoid recursive calls to a single protocol
|
|
* control block. The queue entries are allocated from its own storage pool.
|
|
*/
|
|
struct stackq_entry {
|
|
struct stackq_entry *sq_next; /* Next entry in queue */
|
|
int sq_cmd; /* Stack command */
|
|
void (*sq_func) /* Destination function */
|
|
__P((int, void *, int, int));
|
|
void *sq_token; /* Destination token */
|
|
int sq_arg1; /* Command-specific argument */
|
|
int sq_arg2; /* Command-specific argument */
|
|
Atm_connvc *sq_connvc; /* Connection VCC */
|
|
};
|
|
|
|
|
|
/*
|
|
* Macro to avoid unnecessary function call when draining the stack queue.
|
|
*/
|
|
#define STACK_DRAIN() \
|
|
{ \
|
|
if (atm_stackq_head) \
|
|
atm_stack_drain(); \
|
|
}
|
|
#endif /* ATM_KERNEL */
|
|
|
|
#endif /* _NETATM_ATM_STACK_H */
|