Lower Interface Functions

ESROP relies on the connectionless or connection oriented services provided by Transport layer based on the SDU size. The following sections describe the Transport services assumed by ESROP.

Connectionless interface

UDP SAP Bind

UDP_SapDesc
UDP_sapBind (T_SapSelsapSel,
            int (*dataInd)(T_SapSel,
                  N_SapAddr,
                  T_SapSel,
                  N_SapAddr,
                  DU_View))

This function binds the ESROP to the lower layer by creating a UDP-SAP.

The sapSel argument specifies the local T-SAP Selector Address to be associated with this UDP-SAP.

The dataInd argument specifies the callback function that gets executed when the lower layer has data for the ESROP layer.

The UDP-SAP descriptor value is returned to the caller on successful completion. Otherwise a NULL value is returned.

UDP SAP Unbind

SuccFail
UDP_sapUnBind (T_SapSel *sapSel)

This function unbinds an ESROP from the lower layer. If there are any remaining requests associated with this SAP, the pending or in process requests are dropped and if there are any events queued up for this, they are dumped.

The sapSel argument specifies the UDP-SAP currently in use by the caller.

This function returns SUCCESS on successful completion and FAIL if unsuccessful.

Action Primitives

SuccFail
UDP_dataReq (UDP_SapDesc locSapDesc,
T_SapSel      *remTsapSel,
N_SapAddr     *remNsapAddr,
DU_View       udpSdu)

This function is called by the ESROP layer when it needs to send a TSDU.

The locSapDesc argument identifies the local UDP SAP in use. remTsapSel specifies the destination SAP address. remNsapAddr specifies the Network SAP address of the remote peer. udpSdu is a buffer containing the TSDU.

Event Primitives

Int 
(*dataInd) (T_SapSel *remTsapSel,
N_SapAddr *remNsapAddr,
T_SapSel *locTsapSel,
N_SapAddr *locNsapAddr,
DU_View udpSdu))

The UDP layer invokes this function to communicate received SDU's to the UDP user.

remTsapSel specifies the transport SAP address of the remote peer. remNsapAddr specifies the Network SAP address of the remote peer. udpSdu is a buffer containing the TSDU.

Note: locTsapSel and locNsapAddr are reserved for future use. Do not rely on their values.