From 76edf0c18d30794a4d0dc2aede158b8732382deb Mon Sep 17 00:00:00 2001 From: Jeff Weston Date: Wed, 11 Sep 2019 12:11:22 -0400 Subject: [PATCH] v1.5r5 --- VERSION.TXT | 17 +- doc/NormDeveloperGuide.html | 191 +-- doc/NormDeveloperGuide.pdf | Bin 459998 -> 460960 bytes doc/NormDeveloperGuide.xml | 75 +- examples/normClient.cpp | 296 +++++ examples/normMsgr.cpp | 119 +- examples/normServer.cpp | 463 ++++++++ examples/normSocket.cpp | 1037 +++++++++++++++++ examples/normSocket.h | 120 ++ include/normApi.h | 84 +- include/normMessage.h | 4 +- include/normNode.h | 20 +- include/normSession.h | 57 +- include/normVersion.h | 2 +- makefiles/Makefile.common | 3 +- makefiles/Makefile.freebsd | 5 +- makefiles/Makefile.macosx | 2 +- makefiles/win32/Norm-2008.sln | 63 + makefiles/win32/Norm.sln | 34 +- makefiles/win32/Norm.suo | Bin 62464 -> 63488 bytes makefiles/win32/NormDll.vcxproj | 125 ++ makefiles/win32/NormLib.vcxproj | 121 ++ makefiles/win32/README.TXT | 15 + makefiles/win32/norm/norm.vcxproj | 155 +++ makefiles/win32/normTest.vcxproj | 149 +++ makefiles/win32/npc.vcxproj | 141 +++ src/common/normApi.cpp | 453 +++++-- src/common/normApp.cpp | 12 +- src/common/normEncoderRS16.cpp | 14 +- src/common/normEncoderRS8.cpp | 22 +- src/common/normNode.cpp | 131 ++- src/common/normObject.cpp | 22 +- src/common/normSession.cpp | 423 +++++-- src/common/pcap2norm.cpp | 3 +- src/java/jni/normEventJni.cpp | 3 +- src/java/jni/normSessionJni.cpp | 20 + src/java/jni/normSessionJni.h | 12 +- src/java/src/mil/navy/nrl/norm/NormEvent.java | 5 +- .../src/mil/navy/nrl/norm/NormObject.java | 2 +- .../src/mil/navy/nrl/norm/NormSession.java | 8 +- .../navy/nrl/norm/enums/NormEventType.java | 2 + .../navy/nrl/norm/enums/NormSyncPolicy.java | 6 +- .../navy/nrl/norm/io/INormEventListener.java | 5 +- .../mil/navy/nrl/norm/io/NormInputStream.java | 21 +- .../navy/nrl/norm/io/NormOutputStream.java | 5 +- .../nrl/norm/io/StreamBreakException.java | 5 +- src/pynorm/constants.py | 26 +- src/pynorm/core.py | 9 +- src/pynorm/event.py | 4 + src/pynorm/session.py | 5 +- src/sim/opnet/12.0/norm_protolib.pr.cpp | 2 - waf | Bin 90909 -> 97478 bytes 52 files changed, 3973 insertions(+), 545 deletions(-) create mode 100644 examples/normClient.cpp create mode 100644 examples/normServer.cpp create mode 100644 examples/normSocket.cpp create mode 100644 examples/normSocket.h create mode 100644 makefiles/win32/Norm-2008.sln create mode 100755 makefiles/win32/NormDll.vcxproj create mode 100755 makefiles/win32/NormLib.vcxproj create mode 100755 makefiles/win32/README.TXT create mode 100755 makefiles/win32/norm/norm.vcxproj create mode 100755 makefiles/win32/normTest.vcxproj create mode 100755 makefiles/win32/npc.vcxproj diff --git a/VERSION.TXT b/VERSION.TXT index 783a16d..091958b 100644 --- a/VERSION.TXT +++ b/VERSION.TXT @@ -1,5 +1,20 @@ NORM Version History +Version 1.5r5 +============= + - Added NORM_REMOTE_SENDER_RESET event to notify app when the sender + has been reset due to instance id, etc change + - Fixed possibly critical issue in Protolib ProtoDispatcher where + threaded dispatcher use (as the NORM API uses) could possibly result + in timers not being serviced properly. Most likely the issue could + only occur under certain, heavier NORM API usage patterns. Nonetheless, + this is an important fix. (Thanks to Michael Savisko of Arris). + - Fixed FreeBSD build (Thanks to Hans Duedal) + - Changed from 'b' (build) numbering schema to 'r' (release) to reduce + confusion with respect to "beta" versus "stable" releases. + - Note there are some "in-progress" API extensions in this release that + are not yet described in the developer's guide documentation. + Version 1.5b4 ============= - Corrected change in behavior of non-blocking version of @@ -24,7 +39,7 @@ Version 1.5b2 notification check acking status). Acknowledged, graceful shutdown streams, are automatically closed. - Fixed issue with compilation for NormObjectSize constructor, MSB(), and LSB() - methods on 32-bit systems. Thanks to Bill Skiba. + methods on 32-bit systems. (Thanks to Bill Skiba). Version 1.5b1 ============= diff --git a/doc/NormDeveloperGuide.html b/doc/NormDeveloperGuide.html index 06058b7..dbe0d43 100644 --- a/doc/NormDeveloperGuide.html +++ b/doc/NormDeveloperGuide.html @@ -1,6 +1,6 @@ - NORM Developer's Guide (version 1.4b4)

NORM Developer's Guide (version 1.4b4)

Abstract

This document describes an application programming interface (API) for the Nack-Oriented Reliable Multicast (NORM) protocol implementation developed by the Protocol Engineering and Advance Networking (PROTEAN) Research Group of the United States Naval Research Laboratory (NRL). The NORM protocol provides general purpose reliable data transport for applications wishing to use Internet Protocol (IP) Multicast services for group data delivery. NORM can also support unicast (point-to-point) data communication and may be used for such when deemed appropriate. The current NORM protocol specification is given in the Internet Engineering Task Force (IETF) RFC 3940. This document is currently a reference guide to the NORM API of the NRL reference implementation. More tutorial material may be include in a future version of this document or a separate developer's tutorial may be created at a later date.

1. Background
2. Overview
2.1. API Initialization
2.2. Session Creation and Control
2.3. Data Transport
2.3.1. Data Transmission
2.3.2. Data Reception
2.4. API Event Notification
3. Build Notes
3.1. Unix Platforms
3.2. Win32/WiNCE Platforms
4. API Reference
4.1. API Variable Types and Constants
4.1.1. NormInstanceHandle
4.1.2. NormSessionHandle
4.1.3. NormSessionId
4.1.4. NormNodeHandle
4.1.5. NormNodeId
4.1.6. NormObjectHandle
4.1.7. NormObjectType
4.1.8. NormSize
4.1.9. NormObjectTransportId
4.1.10. NormEventType
4.1.11. NormEvent
4.1.12. NormDescriptor
4.1.13. NormFlushMode
4.1.14. NormProbingMode
4.1.15. NormSyncPolicy
4.1.16. NormNackingMode
4.1.17. NormRepairBoundary
4.1.18. NormAckingStatus
4.2. API Initialization and Operation
4.2.1. NormCreateInstance()
4.2.2. NormDestroyInstance()
4.2.3. NormStopInstance()
4.2.4. NormRestartInstance()
4.2.5. NormSetCacheDirectory()
4.2.6. NormGetNextEvent()
4.2.7. NormGetDescriptor()
4.3. Session Creation and Control Functions
4.3.1. NormCreateSession()
4.3.2. NormDestroySession()
4.3.3. NormSetUserData()
4.3.4. NormGetUserData()
4.3.5. NormGetLocalNodeId()
4.3.6. NormSetTxPort()
4.3.7. NormSetTxOnly()
4.3.8. NormSetRxPortReuse()
4.3.9. NormSetMulticastInterface()
4.3.10. NormSetTTL()
4.3.11. NormSetTOS()
4.3.12. NormSetLoopback()
4.3.13. NormSetFragmentation()
4.4. NORM Sender Functions
4.4.1. NormStartSender()
4.4.2. NormStopSender()
4.4.3. NormSetTxRate()
4.4.4. NormGetTxRate()
4.4.5. NormSetTxSocketBuffer()
4.4.6. NormSetFlowControl()
4.4.7. NormSetCongestionControl()
4.4.8. NormSetTxRateBounds()
4.4.9. NormSetTxCacheBounds()
4.4.10. NormSetAutoParity()
4.4.11. NormGetGrttEstimate()
4.4.12. NormSetGrttEstimate()
4.4.13. NormSetGrttMax()
4.4.14. NormSetGrttProbingMode()
4.4.15. NormSetGrttProbingInterval()
4.4.16. NormSetBackoffFactor()
4.4.17. NormSetGroupSize()
4.4.18. NormSetTxRobustFactor()
4.4.19. NormFileEnqueue()
4.4.20. NormDataEnqueue()
4.4.21. NormRequeueObject()
4.4.22. NormStreamOpen()
4.4.23. NormStreamClose()
4.4.24. NormStreamWrite()
4.4.25. NormStreamFlush()
4.4.26. NormStreamSetAutoFlush()
4.4.27. NormStreamSetPushEnable()
4.4.28. NormStreamHasVacancy()
4.4.29. NormStreamMarkEom()
4.4.30. NormSetWatermark()
4.4.31. NormCancelWatermark()
4.4.32. NormAddAckingNode()
4.4.33. NormRemoveAckingNode()
4.4.34. NormGetNextAckingNode()
4.4.35. NormGetAckingStatus()
4.4.36. NormSendCommand()
4.4.37. NormCancelCommand()
4.5. NORM Receiver Functions
4.5.1. NormStartReceiver()
4.5.2. NormStopReceiver()
4.5.3. NormSetRxCacheLimit()
4.5.4. NormSetRxSocketBuffer()
4.5.5. NormSetSilentReceiver()
4.5.6. NormSetDefaultUnicastNack()
4.5.7. NormNodeSetUnicastNack()
4.5.8. NormSetDefaultSyncPolicy()
4.5.9. NormSetDefaultNackingMode()
4.5.10. NormNodeSetNackingMode()
4.5.11. NormObjectSetNackingMode()
4.5.12. NormSetDefaultRepairBoundary()
4.5.13. NormNodeSetRepairBoundary()
4.5.14. NormSetDefaultRxRobustFactor()
4.5.15. NormNodeSetRxRobustFactor()
4.5.16. NormStreamRead()
4.5.17. NormStreamSeekMsgStart()
4.5.18. NormStreamGetReadOffset()
4.6. NORM Object Functions
4.6.1. NormObjectGetType()
4.6.2. NormObjectHasInfo()
4.6.3. NormObjectGetInfoLength()
4.6.4. NormObjectGetInfo()
4.6.5. NormObjectGetSize()
4.6.6. NormObjectGetBytesPending()
4.6.7. NormObjectCancel()
4.6.8. NormObjectRetain()
4.6.9. NormObjectRelease()
4.6.10. NormFileGetName()
4.6.11. NormFileRename()
4.6.12. NormDataAccessData()
4.6.13. NormDataDetachData()
4.6.14. NormObjectGetSender()
4.7. NORM Node Functions
4.7.1. NormNodeGetId()
4.7.2. NormNodeGetAddress()
4.7.3. NormNodeGetGrtt()
4.7.4. NormNodeGetCommand()
4.7.5. NormNodeFreeBuffers()
4.7.6. NormNodeDelete()
4.7.7. NormNodeRetain()
4.7.8. NormNodeRelease()
4.8. NORM Debugging Functions
4.8.1. NormSetDebugLevel()
4.8.2. NormOpenDebugLog()
4.8.3. NormCloseDebugLog()
4.8.4. NormOpenDebugPipe()
4.8.5. NormCloseDebugPipe()

1. Background

This document describes an application programming interface (API) for the Nack-Oriented Reliable Multicast (NORM) protocol implementation developed by the Protocol Engineering and Advance Networking (PROTEAN) Research Group of the United States Naval Research Laboratory (NRL). The NORM protocol provides general purpose reliable data transport for applications wishing to use Internet Protocol (IP) Multicast services for group data delivery. NORM can also support unicast (point-to-point) data communication and may be used for such when deemed appropriate. The current NORM protocol specification is given in the Internet Engineering Task Force (IETF) RFC 5740.

The NORM protocol is designed to provide end-to-end reliable transport of bulk data objects or streams over generic IP multicast routing and forwarding services. NORM uses a selective, negative acknowledgement (NACK) mechanism for transport reliability and offers additional protocol mechanisms to conduct reliable multicast sessions with limited "a priori" coordination among senders and receivers. A congestion control scheme is specified to allow the NORM protocol to fairly share available network bandwidth with other transport protocols such as Transmission Control Protocol (TCP). It is capable of operating with both reciprocal multicast routing among senders and receivers and with asymmetric connectivity (possibly a unicast return path) from the senders to receivers. The protocol offers a number of features to allow different types of applications or possibly other higher-level transport protocols to utilize its service in different ways. The protocol leverages the use of FEC-based repair and other proven reliable multicast transport techniques in its design.

The NRL NORM library attempts to provide a general useful capability for development of reliable multicast applications for bulk file or other data delivery as well as support of stream-based transport with possible real-time delivery requirements. The API allows access to many NORM protocol parameters and control functions to tailor performance for specific applications. While default parameters, where provided, can be useful to a potential wide range of requirements, the many different possible group communication paradigms dictate different needs for different applications. Even with NORM, the developer should have a thorough understanding of the specific application's group communication needs.

2. Overview

The NORM API has been designed to provide simple, straightforward access to and control of NORM protocol state and functions. Functions are provided to create and initialize instances of the NORM API and associated transport sessions (NormSessions). Subsequently, NORM data transmission (NormSender) operation can be activated and the application can queue various types of data (NormObjects) for reliable transport. Additionally or alternatively, NORM reception (NormReceiver) operation can also be enabled on a per-session basis and the protocol implementation alerts the application of receive events.

By default, the NORM API will create an operating system thread in which the NORM protocol engine runs. This allows user application code and the underlying NORM code to execute somewhat independently of one another. The NORM protocol thread notifies the application of various protocol events through a thread-safe event dispatching mechanism and API calls are provided to allow the application to control NORM operation. (Note: API mechanisms for lower-level, non-threaded control and execution of the NORM protocol engine code may also be provided in the future.)

The NORM API operation can be roughly summarized with the following categories of functions:

  1. API Initialization

  2. Session Creation and Control

  3. Data Transport

  4. API Event Notification

Note the order of these categories roughly reflects the order of function calls required to use NORM in an application. The first step is to create and initialize, as needed, at least one instance of the NORM API. Then one or more NORM transport sessions (where a "session" corresponds to data exchanges on a given multicast group (or unicast address) and host port number) may be created and controlled. Applications may participate as senders and/or receivers within a NORM session. NORM senders transmit data to the session destination address (usually an IP multicast group) while receivers are notified of incoming data. The NORM API provides and event notification scheme to notify the application of significant sender and receiver events. There are also a number support functions provided for the application to control and monitor its participation within a NORM transport session.

2.1. API Initialization

The NORM API requires that an application explicitly create at least one instance of the NORM protocol engine that is subsequently used as a conduit for further NORM API calls. By default, the NORM protocol engine runs in its own operating system thread and interacts with the application in a thread-safe manner through the API calls and event dispatching mechanism.

In general, only a single thread should access the NormGetNextEvent() API call for a given NormInstance. This function serves as the conduit for delivering NORM protocol engine events to the application. A NORM application can be designed to be single-threaded, even with multiple active NormSessions, but also multiple API instances can be created (see NormCreateInstance()) as needed for applications with specific requirements for accessing and controlling participation in multiple NormSessions from separate operating system multiple threads. Or, alternatively, a single NormInstance could be used, with a "master thread" serving as an intermediary between the NormGetNextEvent() function, demultiplexing and dispatching events as appropriate to other "child threads" that are created to handle "per-NormSession" input/output. The advantage of this alternative approach is that the end result would be one NORM protocol engine thread plus one "master thread" plus one "child thread" per NormSession instead of two threads (protocol engine plus application thread) per NormSession if such multi-threaded operation is needed by the application.

2.2. Session Creation and Control

Once an API instance has been successfully created, the application may then create NORM transport session instances as needed. The application can participate in each session as a sender and/or receiver of data. If an application is participating as a sender, it may enqueue data transport objects for transmission. The control of transmission is largely left to the senders and API calls are provided to control transmission rate, FEC parameters, etc. Applications participating as receivers will be notified via the NORM API's event dispatching mechanism of pending and completed reliable reception of data along with other significant events. Additionally, API controls for some optional NORM protocol mechanisms, such as positive acknowledgment collection, are also provided.

Note when multiple senders are involved, receivers allocate system resources (buffer space) for each active sender. With a very large number of concurrently active senders, this may translate to significant memory allocation on receiver nodes. Currently, the API allows the application to control how much buffer space is allocated for each active sender (NOTE: In the future, API functions may be provided limit the number of active senders monitored and/or provide the application with finer control over receive buffer allocation, perhaps on a per sender basis).

2.3. Data Transport

The NORM protocol supports transport of three basic types of data content. These include the types NORM_OBJECT_FILE and NORM_OBJECT_DATA which represent predetermined, fixed-size application data content. The only differentiation with respect to these two types is the implicit "hint" to the receiver to use non-volatile (i.e. file system) storage or memory. This "hint" lets the receiver allocate appropriate storage space with no other information on the incoming data. The NORM implementation reads/writes data for the NORM_OBJECT_FILE type directly from/to file storage, while application memory space is accessed for the NORM_OBJECT_DATA type. The third data content type, NORM_OBJECT_STREAM, represents unbounded, possibly persistent, streams of data content. Using this transport paradigm, traditional, byte-oriented streaming transport service (e.g. similar to that provided by a TCP socket) can be provided. Additionally, NORM has provisions for application-defined message-oriented transport where receivers can recover message boundaries without any "handshake" with the sender. Stream content is buffered by the NORM implementation for transmission/retransmission and as it is received.

2.3.1. Data Transmission

The behavior of data transport operation is largely placed in the control of the NORM sender(s). NORM senders controls their data transmission rate, forward error correction (FEC) encoding settings, and parameters controlling feedback from the receiver group. Multiple senders may operate in a session, each with independent transmission parameters. NORM receivers learn needed parameter values from fields in NORM message headers.

NORM transport "objects" (file, data, or stream) are queued for transmission by NORM senders. NORM senders may also cancel transmission of objects at any time. The NORM sender controls the transmission rate either manually (fixed transmission rate) or automatically when NORM congestion control operation is enabled. The NORM congestion control mechanism is designed to be "friendly" to other data flows on the network, fairly sharing available bandwidth.NormSetAutoParity()) to achieve reliable transfer) receive object transmission before any extensive repair process that may be required to satisfy other receivers with poor network connectivity. The repair boundary can also be set for individual remote senders using the NormNodeSetRepairBoundary() function.NORM_OBJECT_FILE objects. This function must be called before any file objects may be received and thus should be called before any calls to NormStartReceiver() are made. However, note that the cache directory may be changed even during active NORM reception. In this case, the new specified directory path will be used for subsequently-received files. Any files received before a directory path change will remain in the previous cache location. Note that the NormFileRename() function may be used to rename, and thus potentially move, received files after reception has begun.

By default, the NORM sender transmits application-enqueued data content, providing repair transmissions (usually in the form of FEC messages) only when requested by NACKs from the receivers. However, the application may also configure NORM to proactively send some amount of FEC content along with the original data content to create a "robust" transmission that, in some cases, may be reliably received without any NACKing activity. This can allow for some degree of reliable protocol operation even without receiver feedback available. NORM senders may also requeue (within the limits of "transmit cache" settings) objects for repeat transmission, and receivers may combine together multiple transmissions to reliably receive content. Additionally, hybrid proactive/reactive FEC repair operation is possible with the receiver NACK process as a "backup" for when network packet loss exceeds the repair capability of the proactive FEC settings.

The NRL NORM implementation also supports optional collection of positive acknowledgment from a subset of the receiver group at application-determined positions during data transmission. The NORM API allows the application to specify the receiver subset ("acking node list") and set "watermark" points for which positive acknowledgement is collected. This process can provide the application with explicit flow control for an application-determined critical set of receivers in the group.

For a NORM application to perform data transmission, it must first create a session using NormCreateSession() and make a call to NormStartSender() before sending actual user data. The functions NormFileEnqueue(), NormDataEnqueue(), and NormStreamWrite() are available for the application to pass data to the NORM protocol engine for transmission. Note that to use NormStreamWrite(), a "sender stream" must first be created using NormStreamOpen(). In the case of NormFileEnqueue() and NormDataEnqueue(), the NORM protocol engine directly accesses the application file or memory space to refer to the transmitted content and does not make its own copy of this data.

The calls to enqueue transport objects or write to a stream may be called at any time, but the NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY notification events (see NormGetNextEvent()) provide useful cues for when these functions may be successfully called. Typically, an application might catch both NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY event types as cues for enqueuing additional transport objects or writing to a stream. However, an application may choose to cue off of NORM_TX_QUEUE_EMPTY only if it wishes to provide the "freshest" data to NORM for transmission. The advantage of additionally using NORM_TX_QUEUE_VACANCY is that if the application uses this cue to fill up NORM transport object or stream buffers, it can keep the NORM stream busy sending data and realize the highest possible transmission rate when attempting very high speed communication (Otherwise, the NORM protocol engine may experience some "dead air time" waiting for the application thread to respond to a NORM_TX_QUEUE_EMPTY event). Note the sender application can control buffer depths as needed with the NormSetTxCacheBounds() and NormStreamOpen() calls. Additionally, it is possible for applications to configure the transmit object "cache" (see NormSetTxCacheBounds()) and use the NormRequeueObject() call (for objects that have not yet received a NORM_TX_OBJECT_PURGED notification) to effect a sort of "data carousel" operation with repeated transmission of the cached objects. The NORM_TX_OBJECT_SENT notification can be used a cue to properly control the "requeue" cycle(s).

The NORM implementation provides a form of timer-based flow control that limits how quickly sender applications may enqueue new objects or stream data for transmission. The NormSetFlowControl() call is provided to control this behavior, including the option to disable it. This timer-based mechanism is a type of "soft" flow control by allowing receivers "sufficient" time to request repair of pending data the sender has enqueued. A more explicit form of flow control using the optional "watermark flushing" mechanism is described below.

Another cue that can be leveraged by the sender application to determine when it is appropriate to enqueue (or write) additional data for transmission is the NORM_TX_WATERMARK_COMPLETED event. This event is posted when the flushing or explicit positive acknowledgment collection process has completed for a "watermark" point in transmission that was set by the sender (see NormSetWatermark() and NormAddAckingNode()). A list of NormNodeId values can be supplied from which explicit acknowledgement is expected and/or the NormNodeId NORM_NODE_NONE can be set (using NormAddAckingNode()) for completion of a NACK-based version of the watermark flushing procedure. This flushing process can be used as a flow control mechanism for NORM applications. Note this is distinct from NORM's congestion control mechanism that, while it provides network-friendly transmission rate control, does guarantee flow control to receiving nodes.NORM_NODE_NONE can be set (using NormAddAckingNode()) for completion of a NACK-based version of the watermark flushing procedure. This flushing process can be used as a flow control mechanism for NORM applications. Note this is distinct from NORM's congestion control mechanism that, while it provides network-friendly transmission rate control, does guarantee flow control to receiving nodes.

2.3.2. Data Reception

NORM receiver applications learn of active senders and their corresponding pending and completed data transfers, etc via the API event dispatching mechanism. By default, NORM receivers use NACK messages to request repair of transmitted content from the originating sender as needed to achieve reliable transfer. Some API functions are available to provide some additional control over the NACKing behavior, such as initially NACKing for NORM_INFO content only or even to the extent of disabling receiver feedback (silent receiver or emission-controlled (EMCON) operation) entirely. Otherwise, the parameters and operation of reliable data transmission are left to sender applications and receivers learn of sender parameters in NORM protocol message headers and are instructed by NORM_CMD messages from the sender(s).

With respect to the NORM API, the receiver application is informed of new senders and receive data objects via the the NORM_REMOTE_SENDER_NEW and NORM_RX_OBJECT_NEW notifications, respectfully. Additionally, object reception progress is indicated with the NORM_RX_OBJECT_UPDATED notification and this also serves as an indicator for the NORM_OBJECT_STREAM type that the receive application should make calls to NormStreamRead() to read newly received stream content. NORM sender status is also conveyed via the NORM_REMOTE_SENDER_ACTIVE and NORM_REMOTE_SENDER_INACTIVE notifications. For example, the receiver application may use the NORM_REMOTE_SENDER_INACTIVE as a cue to make calls to NormNodeFreeBuffers() and/or NormNodeDelete() to free memory resources allocated for buffering received content for the given sender. The amount of memory allocated per sender is set in the NormStartReceiver() call.

2.4. API Event Notification

An asynchronous event dispatching mechanism is provided to notify the application of significant NORM protocol events. The centerpiece of this is the NormGetNextEvent() function that can be used to retrieve the next NORM protocol engine event in the form of a NormEvent structure. This function will typically block until a NormEvent occurs. However, non-blocking operation may be achieved by using the NormGetDescriptor() call to get a NormDescriptor (file descriptor) value (Unix int or Win32 HANDLE) suitable for use in a asynchronous I/O monitoring functions such as the Unix select() or Win32 MsgWaitForMultipleObjects() system calls. The a NormDescriptor will be signaled when a NormEvent is available. For Win32 platforms, dispatching of a user-defined Windows message for NORM event notification is also planned for a future update to the NORM API.

3. Build Notes

To build applications that use the NORM library, a path to the "normApi.h" header file must be provided and the linker step needs to reference the NORM library file ("libnorm.a" for Unix platforms and "Norm.lib" for Win32 platforms). NORM also depends upon the NRL Protean Protocol Prototyping toolkit "Protokit" library (a.k.a "Protolib") (static library files "libProtokit.a" for Unix and "Protokit.lib" for Win32). Shared or dynamically-linked versions of these libraries may also be built from the NORM source code or provided. Depending upon the platform, some additional library dependencies may be required to support the needs of NORM and/or Protokit. These are described below.

The "makefiles" directory contains Unix Makefiles for various platforms the "win32" and "wince" sub-directories there contain Microsoft Visual C++ (VC++) and Embedded VC++ project files for building the NORM implementation. Additionally, a "waf" (Python-based build tool) build option is supported that can be used to build and install the NORM library code on the supported platforms. Finally, Python and Java bindings to the NORM API are included and "src/python" and "src/java" directories contain the code for these and the "makefiles/java" directory contains Makefiles to build the NORM Java JNI bindings. Note the "waf" tool can also be used to build the Java and Python bindings.

3.1. Unix Platforms

NORM has been built and tested on Linux (various architectures), MacOS (BSD), Solaris, and IRIX (SGI) platforms. The code should be readily portable to other Unix platforms.

To support IPv6 operation, the NORM and the Protokit library must be compiled with the "HAVE_IPV6" macro defined. This is default in the NORM and Protokit Makefiles for platforms that support IPv6. It is important that NORM and Protokit be built with this macro defined the same. With NORM, it is recommended that "large file support" options be enabled when possible.

The NORM API uses threading so that the NORM protocol engine may run independent of the application. Thus the "POSIX Threads" library must be included ("-pthread") in the linking step. MacOS/BSD also requires the addition of the "-lresolv" (resolver) library and Solaris requires the dynamic loader, network/socket, and resolver libraries ("-lnsl -lsocket -lresolv") to achieve successful compilation. The Makefiles in the NORM source code distribution are a reference for these requirements. Note that MacOS 9 and earlier are not supported.

Additionally, it is critical that the _FILE_OFFSET_BITS macro be consistently defined for the NORM library build and the application build using the library. The distributed NORM Makefiles have -D_FILE_OFFSET_BITS=64 set in the compilation to enable "large file support". Applications built using NORM should have the same compilation option set to operate correctly (The definition of the NormSize type in "normApi.h" depends upon this compilation flag).

3.2. Win32/WiNCE Platforms

NORM has been built using Microsoft's Visual C++ (6.0 and .NET) and Embedded VC++ 4.2 environments. In addition to proper macro definitions (e.g., HAVE_IPV6, etc) that are included in the respective "Protokit" and "NORM" project files, it is important that common code generation settings be used when building the NORM application. The NORM and Protokit projects are built with the "Multi-threading DLL" library usage set. The NORM API requires multi-threading support. This is a critical setting and numerous compiler and linker errors will result if this is not properly set for your application project.

NORM and Protokit also depend on the Winsock 2.0 ("ws2_32.lib" (or "ws2.lib" (WinCE)) and the IP Helper API ("iphlpapi.lib") libraries and these must be included in the project "Link" attributes.

An additional note is that a bug in VC++ 6.0 and earlier compilers (includes embedded VC++ 4.x compilers) prevent compilation of Protokit-based code with debugging capabilities enabled. However, this has been resolved in VC++ .NET and is hoped to be resolved in the future for the WinCE build tools.

Operation on Windows NT4 (and perhaps other older Windows operating systems) requires that the compile time macro WINVER=0x0400 defined. This is because the version of the IP Helper API library (iphlpapi.lib) used by Protolib (and hence NORM) for this system doesn't support some of the functions defined for this library. This may be related to IPv6 support issues so it may be possible that the Protolib build could be tweaked to provide a single binary executable suitable for IPv4 operation only across a large range of Windows platforms.

4. API Reference

This section provides a reference to the NORM API variable types, constants and functions.

4.1. API Variable Types and Constants

The NORM API defines and enumerates a number of supporting variable types and values which are used in different function calls. The variable types are described here.

4.1.1. NormInstanceHandle

The NormInstanceHandle type is returned when a NORM API instance is created (see NormCreateInstance()). This handle can be subsequently used for API calls which require reference to a specific NORM API instance. By default, each NORM API instance instantiated creates an operating system thread for protocol operation. Note that multiple NORM transport sessions may be created for a single API instance. In general, it is expected that applications will create a single NORM API instance, but some multi-threaded application designs may prefer multiple corresponding NORM API instances. The value NORM_INSTANCE_INVALID corresponds to an invalid API instance.

4.1.2. NormSessionHandle

The NormSessionHandle type is used to reference NORM transport sessions which have been created using the NormCreateSession() API call. Multiple NormSessionHandle values may be associated with a given NormInstanceHandle. The special value NORM_SESSION_INVALID is used to refer to invalid session references.

4.1.3. NormSessionId

The NormSessionId type is used by applications to uniquely identify their instance of participation as a sender within a NormSession. This type is a parameter to the NormStartSender() function. Robust applications can use different NormSessionId values when initiating sender operation so that receivers can discriminate when a sender has terminated and restarted (whether intentional or due to system failure). For example, an application could cache its prior NormSessionId value in non-volatile storage which could then be recovered and incremented (for example) upon system restart to produce a new value. The NormSessionId value is used for the value of the instance_id field in NORM protocol sender messages (see the NORM protocol specification) and receivers use this field to detect sender restart within a NormSession.

4.1.4. NormNodeHandle

The NormNodeHandle type is used to reference state kept by the NORM implementation with respect to other participants within a NormSession. Most typically, the NormNodeHandle is used by receiver applications to dereference information about remote senders of data as needed. The special value NORM_NODE_INVALID corresponds to an invalid reference.

4.1.5. NormNodeId

The NormNodeId type corresponds to a 32-bit numeric value which should uniquely identify a participant (node) in a given NormSession. The NormNodeGetId() function can be used to retrieve this value given a valid NormNodeHandle. The special value NORM_NODE_NONE corresponds to an invalid (or null) node while the value NORM_NODE_ANY serves as a wild card value for some functions.

4.1.6. NormObjectHandle

The NormObjectHandle type is used to reference state kept for data transport objects being actively transmitted or received. The state kept for NORM transport objects is temporary, but the NORM API provides a function to persistently retain state associated with a sender or receiver NormObjectHandle (see NormObjectRetain()) if needed. For sender objects, unless explicitly retained, the NormObjectHandle can be considered valid until the referenced object is explicitly canceled (see NormObjectCancel()) or purged from the sender transmission queue (see the event NORM_TX_OBJECT_PURGED). For receiver objects, these handles should be treated as valid only until a subsequent call to NormGetNextEvent() unless, again, specifically retained. The special value NORM_OBJECT_INVALID corresponds to an invalid transport object reference.

4.1.7. NormObjectType

The NormObjectType type is an enumeration of possible NORM data transport object types. As previously mentioned, valid types include:

  1. NORM_OBJECT_FILE

  2. NORM_OBJECT_DATA, and

  3. NORM_OBJECT_STREAM

Given a NormObjectHandle, the application may determine an object's type using the NormObjectGetType() function call. A special NormObjectType value, NORM_OBJECT_NONE, indicates an invalid object type.

4.1.8. NormSize

The NormSize is the type used for NormObject size information. For example, the NormObjectGetSize() function returns a value of type NormSize. The range of NormSize values depends upon the operating system and NORM library compilation settings. With "large file support" enabled, as is the case with distributed NORM library "Makefiles", the NormSize type is a 64-bit integer. However, some platforms may support only 32-bit object sizes.

4.1.9. NormObjectTransportId

The NormObjectTransportId type is a 16-bit numerical value assigned to NormObjects by senders during active transport. These values are temporarily unique with respect to a given sender within a NormSession and may be "recycled" for use for future transport objects. NORM sender nodes assign these values in a monotonically increasing fashion during the course of a session as part of protocol operation. Typically, the application should not need access to these values, but an API call such as NormObjectGetTransportId() (TBD) may be provided to retrieve these values if needed. (Note this type may be deprecated; i.e., it may not be needed at since the NormRequeueObject() function is implemented using handles only, but _some_ applications requiring persistence even after a system reboot may need the ability to recall previous transport ids?)

4.1.10. NormEventType

The NormEventType is an enumeration of NORM API events. "Events" are used by the NORM API to signal the application of significant NORM protocol operation events (e.g., receipt of a new receive object, etc). A description of possible NormEventType values and their interpretation is given below. The function call NormGetNextEvent() is used to retrieve events from the NORM protocol engine.

4.1.11. NormEvent

The NormEvent type is a structure used to describe significant NORM protocol events. This structure is defined as follows:

typedef struct
+   NORM Developer's Guide (version 1.5b5)
 NORM Developer's Guide (version 1.5b5)
Abstract
This document describes an application programming interface (API) for the Nack-Oriented Reliable Multicast (NORM) protocol implementation developed by the Protocol Engineering and Advance Networking (PROTEAN) Research Group of the United States Naval Research Laboratory (NRL). The NORM protocol provides general purpose reliable data transport for applications wishing to use Internet Protocol (IP) Multicast services for group data delivery. NORM can also support unicast (point-to-point) data communication and may be used for such when deemed appropriate. The current NORM protocol specification is given in the Internet Engineering Task Force (IETF) RFC 3940. This document is currently a reference guide to the NORM API of the NRL reference implementation. More tutorial material may be include in a future version of this document or a separate developer's tutorial may be created at a later date.
Table of Contents
1. Background
2. Overview
2.1. API Initialization
2.2. Session Creation and Control
2.3. Data Transport
2.3.1. Data Transmission
2.3.2. Data Reception
2.4. API Event Notification
3. Build Notes
3.1. Unix Platforms
3.2. Win32/WiNCE Platforms
4. API Reference
4.1. API Variable Types and Constants
4.1.1. NormInstanceHandle
4.1.2. NormSessionHandle
4.1.3. NormSessionId
4.1.4. NormNodeHandle
4.1.5. NormNodeId
4.1.6. NormObjectHandle
4.1.7. NormObjectType
4.1.8. NormSize
4.1.9. NormObjectTransportId
4.1.10. NormEventType
4.1.11. NormEvent
4.1.12. NormDescriptor
4.1.13. NormFlushMode
4.1.14. NormProbingMode
4.1.15. NormSyncPolicy
4.1.16. NormNackingMode
4.1.17. NormRepairBoundary
4.1.18. NormAckingStatus
4.2. API Initialization and Operation
4.2.1. NormCreateInstance()
4.2.2. NormDestroyInstance()
4.2.3. NormStopInstance()
4.2.4. NormRestartInstance()
4.2.5. NormSetCacheDirectory()
4.2.6. NormGetNextEvent()
4.2.7. NormGetDescriptor()
4.3. Session Creation and Control Functions
4.3.1. NormCreateSession()
4.3.2. NormDestroySession()
4.3.3. NormSetUserData()
4.3.4. NormGetUserData()
4.3.5. NormGetLocalNodeId()
4.3.6. NormSetTxPort()
4.3.7. NormSetTxOnly()
4.3.8. NormSetRxPortReuse()
4.3.9. NormSetMulticastInterface()
4.3.10. NormSetSSM()
4.3.11. NormSetTTL()
4.3.12. NormSetTOS()
4.3.13. NormSetLoopback()
4.3.14. NormSetFragmentation()
4.4. NORM Sender Functions
4.4.1. NormStartSender()
4.4.2. NormStopSender()
4.4.3. NormSetTxRate()
4.4.4. NormGetTxRate()
4.4.5. NormSetTxSocketBuffer()
4.4.6. NormSetFlowControl()
4.4.7. NormSetCongestionControl()
4.4.8. NormSetTxRateBounds()
4.4.9. NormSetTxCacheBounds()
4.4.10. NormSetAutoParity()
4.4.11. NormGetGrttEstimate()
4.4.12. NormSetGrttEstimate()
4.4.13. NormSetGrttMax()
4.4.14. NormSetGrttProbingMode()
4.4.15. NormSetGrttProbingInterval()
4.4.16. NormSetBackoffFactor()
4.4.17. NormSetGroupSize()
4.4.18. NormSetTxRobustFactor()
4.4.19. NormFileEnqueue()
4.4.20. NormDataEnqueue()
4.4.21. NormRequeueObject()
4.4.22. NormStreamOpen()
4.4.23. NormStreamClose()
4.4.24. NormStreamWrite()
4.4.25. NormStreamFlush()
4.4.26. NormStreamSetAutoFlush()
4.4.27. NormStreamSetPushEnable()
4.4.28. NormStreamHasVacancy()
4.4.29. NormStreamMarkEom()
4.4.30. NormSetWatermark()
4.4.31. NormCancelWatermark()
4.4.32. NormAddAckingNode()
4.4.33. NormRemoveAckingNode()
4.4.34. NormGetNextAckingNode()
4.4.35. NormGetAckingStatus()
4.4.36. NormSendCommand()
4.4.37. NormCancelCommand()
4.5. NORM Receiver Functions
4.5.1. NormStartReceiver()
4.5.2. NormStopReceiver()
4.5.3. NormSetRxCacheLimit()
4.5.4. NormSetRxSocketBuffer()
4.5.5. NormSetSilentReceiver()
4.5.6. NormSetDefaultUnicastNack()
4.5.7. NormNodeSetUnicastNack()
4.5.8. NormSetDefaultSyncPolicy()
4.5.9. NormSetDefaultNackingMode()
4.5.10. NormNodeSetNackingMode()
4.5.11. NormObjectSetNackingMode()
4.5.12. NormSetDefaultRepairBoundary()
4.5.13. NormNodeSetRepairBoundary()
4.5.14. NormSetDefaultRxRobustFactor()
4.5.15. NormNodeSetRxRobustFactor()
4.5.16. NormStreamRead()
4.5.17. NormStreamSeekMsgStart()
4.5.18. NormStreamGetReadOffset()
4.6. NORM Object Functions
4.6.1. NormObjectGetType()
4.6.2. NormObjectHasInfo()
4.6.3. NormObjectGetInfoLength()
4.6.4. NormObjectGetInfo()
4.6.5. NormObjectGetSize()
4.6.6. NormObjectGetBytesPending()
4.6.7. NormObjectCancel()
4.6.8. NormObjectRetain()
4.6.9. NormObjectRelease()
4.6.10. NormFileGetName()
4.6.11. NormFileRename()
4.6.12. NormDataAccessData()
4.6.13. NormDataDetachData()
4.6.14. NormObjectGetSender()
4.7. NORM Node Functions
4.7.1. NormNodeGetId()
4.7.2. NormNodeGetAddress()
4.7.3. NormNodeGetGrtt()
4.7.4. NormNodeGetCommand()
4.7.5. NormNodeFreeBuffers()
4.7.6. NormNodeDelete()
4.7.7. NormNodeRetain()
4.7.8. NormNodeRelease()
4.8. NORM Debugging Functions
4.8.1. NormSetDebugLevel()
4.8.2. NormOpenDebugLog()
4.8.3. NormCloseDebugLog()
4.8.4. NormOpenDebugPipe()
4.8.5. NormCloseDebugPipe()
1. Background
This document describes an application programming interface (API) for the Nack-Oriented Reliable Multicast (NORM) protocol implementation developed by the Protocol Engineering and Advance Networking (PROTEAN) Research Group of the United States Naval Research Laboratory (NRL). The NORM protocol provides general purpose reliable data transport for applications wishing to use Internet Protocol (IP) Multicast services for group data delivery. NORM can also support unicast (point-to-point) data communication and may be used for such when deemed appropriate. The current NORM protocol specification is given in the Internet Engineering Task Force (IETF) RFC 5740.
The NORM protocol is designed to provide end-to-end reliable transport of bulk data objects or streams over generic IP multicast routing and forwarding services. NORM uses a selective, negative acknowledgement (NACK) mechanism for transport reliability and offers additional protocol mechanisms to conduct reliable multicast sessions with limited "a priori" coordination among senders and receivers. A congestion control scheme is specified to allow the NORM protocol to fairly share available network bandwidth with other transport protocols such as Transmission Control Protocol (TCP). It is capable of operating with both reciprocal multicast routing among senders and receivers and with asymmetric connectivity (possibly a unicast return path) from the senders to receivers. The protocol offers a number of features to allow different types of applications or possibly other higher-level transport protocols to utilize its service in different ways. The protocol leverages the use of FEC-based repair and other proven reliable multicast transport techniques in its design.
The NRL NORM library attempts to provide a general useful capability for development of reliable multicast applications for bulk file or other data delivery as well as support of stream-based transport with possible real-time delivery requirements. The API allows access to many NORM protocol parameters and control functions to tailor performance for specific applications. While default parameters, where provided, can be useful to a potential wide range of requirements, the many different possible group communication paradigms dictate different needs for different applications. Even with NORM, the developer should have a thorough understanding of the specific application's group communication needs.
2. Overview
The NORM API has been designed to provide simple, straightforward access to and control of NORM protocol state and functions. Functions are provided to create and initialize instances of the NORM API and associated transport sessions (NormSessions). Subsequently, NORM data transmission (NormSender) operation can be activated and the application can queue various types of data (NormObjects) for reliable transport. Additionally or alternatively, NORM reception (NormReceiver) operation can also be enabled on a per-session basis and the protocol implementation alerts the application of receive events.
By default, the NORM API will create an operating system thread in which the NORM protocol engine runs. This allows user application code and the underlying NORM code to execute somewhat independently of one another. The NORM protocol thread notifies the application of various protocol events through a thread-safe event dispatching mechanism and API calls are provided to allow the application to control NORM operation. (Note: API mechanisms for lower-level, non-threaded control and execution of the NORM protocol engine code may also be provided in the future.)
The NORM API operation can be roughly summarized with the following categories of functions:
  1. API Initialization
  2. Session Creation and Control
  3. Data Transport
  4. API Event Notification
Note the order of these categories roughly reflects the order of function calls required to use NORM in an application. The first step is to create and initialize, as needed, at least one instance of the NORM API. Then one or more NORM transport sessions (where a "session" corresponds to data exchanges on a given multicast group (or unicast address) and host port number) may be created and controlled. Applications may participate as senders and/or receivers within a NORM session. NORM senders transmit data to the session destination address (usually an IP multicast group) while receivers are notified of incoming data. The NORM API provides and event notification scheme to notify the application of significant sender and receiver events. There are also a number support functions provided for the application to control and monitor its participation within a NORM transport session.
2.1. API Initialization
The NORM API requires that an application explicitly create at least one instance of the NORM protocol engine that is subsequently used as a conduit for further NORM API calls. By default, the NORM protocol engine runs in its own operating system thread and interacts with the application in a thread-safe manner through the API calls and event dispatching mechanism.
In general, only a single thread should access the NormGetNextEvent() API call for a given NormInstance. This function serves as the conduit for delivering NORM protocol engine events to the application. A NORM application can be designed to be single-threaded, even with multiple active NormSessions, but also multiple API instances can be created (see NormCreateInstance()) as needed for applications with specific requirements for accessing and controlling participation in multiple NormSessions from separate operating system multiple threads. Or, alternatively, a single NormInstance could be used, with a "master thread" serving as an intermediary between the NormGetNextEvent() function, demultiplexing and dispatching events as appropriate to other "child threads" that are created to handle "per-NormSession" input/output. The advantage of this alternative approach is that the end result would be one NORM protocol engine thread plus one "master thread" plus one "child thread" per NormSession instead of two threads (protocol engine plus application thread) per NormSession if such multi-threaded operation is needed by the application.
2.2. Session Creation and Control
Once an API instance has been successfully created, the application may then create NORM transport session instances as needed. The application can participate in each session as a sender and/or receiver of data. If an application is participating as a sender, it may enqueue data transport objects for transmission. The control of transmission is largely left to the senders and API calls are provided to control transmission rate, FEC parameters, etc. Applications participating as receivers will be notified via the NORM API's event dispatching mechanism of pending and completed reliable reception of data along with other significant events. Additionally, API controls for some optional NORM protocol mechanisms, such as positive acknowledgment collection, are also provided.
Note when multiple senders are involved, receivers allocate system resources (buffer space) for each active sender. With a very large number of concurrently active senders, this may translate to significant memory allocation on receiver nodes. Currently, the API allows the application to control how much buffer space is allocated for each active sender (NOTE: In the future, API functions may be provided limit the number of active senders monitored and/or provide the application with finer control over receive buffer allocation, perhaps on a per sender basis).
2.3. Data Transport
The NORM protocol supports transport of three basic types of data content. These include the types NORM_OBJECT_FILE and NORM_OBJECT_DATA which represent predetermined, fixed-size application data content. The only differentiation with respect to these two types is the implicit "hint" to the receiver to use non-volatile (i.e. file system) storage or memory. This "hint" lets the receiver allocate appropriate storage space with no other information on the incoming data. The NORM implementation reads/writes data for the NORM_OBJECT_FILE type directly from/to file storage, while application memory space is accessed for the NORM_OBJECT_DATA type. The third data content type, NORM_OBJECT_STREAM, represents unbounded, possibly persistent, streams of data content. Using this transport paradigm, traditional, byte-oriented streaming transport service (e.g. similar to that provided by a TCP socket) can be provided. Additionally, NORM has provisions for application-defined message-oriented transport where receivers can recover message boundaries without any "handshake" with the sender. Stream content is buffered by the NORM implementation for transmission/retransmission and as it is received.
2.3.1. Data Transmission
The behavior of data transport operation is largely placed in the control of the NORM sender(s). NORM senders controls their data transmission rate, forward error correction (FEC) encoding settings, and parameters controlling feedback from the receiver group. Multiple senders may operate in a session, each with independent transmission parameters. NORM receivers learn needed parameter values from fields in NORM message headers.
NORM transport "objects" (file, data, or stream) are queued for transmission by NORM senders. NORM senders may also cancel transmission of objects at any time. The NORM sender controls the transmission rate either manually (fixed transmission rate) or automatically when NORM congestion control operation is enabled. The NORM congestion control mechanism is designed to be "friendly" to other data flows on the network, fairly sharing available bandwidth.NormSetAutoParity()) to achieve reliable transfer) receive object transmission before any extensive repair process that may be required to satisfy other receivers with poor network connectivity. The repair boundary can also be set for individual remote senders using the NormNodeSetRepairBoundary() function.NORM_OBJECT_FILE objects. This function must be called before any file objects may be received and thus should be called before any calls to NormStartReceiver() are made. However, note that the cache directory may be changed even during active NORM reception. In this case, the new specified directory path will be used for subsequently-received files. Any files received before a directory path change will remain in the previous cache location. Note that the NormFileRename() function may be used to rename, and thus potentially move, received files after reception has begun.
By default, the NORM sender transmits application-enqueued data content, providing repair transmissions (usually in the form of FEC messages) only when requested by NACKs from the receivers. However, the application may also configure NORM to proactively send some amount of FEC content along with the original data content to create a "robust" transmission that, in some cases, may be reliably received without any NACKing activity. This can allow for some degree of reliable protocol operation even without receiver feedback available. NORM senders may also requeue (within the limits of "transmit cache" settings) objects for repeat transmission, and receivers may combine together multiple transmissions to reliably receive content. Additionally, hybrid proactive/reactive FEC repair operation is possible with the receiver NACK process as a "backup" for when network packet loss exceeds the repair capability of the proactive FEC settings.
The NRL NORM implementation also supports optional collection of positive acknowledgment from a subset of the receiver group at application-determined positions during data transmission. The NORM API allows the application to specify the receiver subset ("acking node list") and set "watermark" points for which positive acknowledgement is collected. This process can provide the application with explicit flow control for an application-determined critical set of receivers in the group.
For a NORM application to perform data transmission, it must first create a session using NormCreateSession() and make a call to NormStartSender() before sending actual user data. The functions NormFileEnqueue(), NormDataEnqueue(), and NormStreamWrite() are available for the application to pass data to the NORM protocol engine for transmission. Note that to use NormStreamWrite(), a "sender stream" must first be created using NormStreamOpen(). In the case of NormFileEnqueue() and NormDataEnqueue(), the NORM protocol engine directly accesses the application file or memory space to refer to the transmitted content and does not make its own copy of this data.
The calls to enqueue transport objects or write to a stream may be called at any time, but the NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY notification events (see NormGetNextEvent()) provide useful cues for when these functions may be successfully called. Typically, an application might catch both NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY event types as cues for enqueuing additional transport objects or writing to a stream. However, an application may choose to cue off of NORM_TX_QUEUE_EMPTY only if it wishes to provide the "freshest" data to NORM for transmission. The advantage of additionally using NORM_TX_QUEUE_VACANCY is that if the application uses this cue to fill up NORM transport object or stream buffers, it can keep the NORM stream busy sending data and realize the highest possible transmission rate when attempting very high speed communication (Otherwise, the NORM protocol engine may experience some "dead air time" waiting for the application thread to respond to a NORM_TX_QUEUE_EMPTY event). Note the sender application can control buffer depths as needed with the NormSetTxCacheBounds() and NormStreamOpen() calls. Additionally, it is possible for applications to configure the transmit object "cache" (see NormSetTxCacheBounds()) and use the NormRequeueObject() call (for objects that have not yet received a NORM_TX_OBJECT_PURGED notification) to effect a sort of "data carousel" operation with repeated transmission of the cached objects. The NORM_TX_OBJECT_SENT notification can be used a cue to properly control the "requeue" cycle(s).
The NORM implementation provides a form of timer-based flow control that limits how quickly sender applications may enqueue new objects or stream data for transmission. The NormSetFlowControl() call is provided to control this behavior, including the option to disable it. This timer-based mechanism is a type of "soft" flow control by allowing receivers "sufficient" time to request repair of pending data the sender has enqueued. A more explicit form of flow control using the optional "watermark flushing" mechanism is described below.
Another cue that can be leveraged by the sender application to determine when it is appropriate to enqueue (or write) additional data for transmission is the NORM_TX_WATERMARK_COMPLETED event. This event is posted when the flushing or explicit positive acknowledgment collection process has completed for a "watermark" point in transmission that was set by the sender (see NormSetWatermark() and NormAddAckingNode()). A list of NormNodeId values can be supplied from which explicit acknowledgement is expected and/or the NormNodeId NORM_NODE_NONE can be set (using NormAddAckingNode()) for completion of a NACK-based version of the watermark flushing procedure. This flushing process can be used as a flow control mechanism for NORM applications. Note this is distinct from NORM's congestion control mechanism that, while it provides network-friendly transmission rate control, does guarantee flow control to receiving nodes.NORM_NODE_NONE can be set (using NormAddAckingNode()) for completion of a NACK-based version of the watermark flushing procedure. This flushing process can be used as a flow control mechanism for NORM applications. Note this is distinct from NORM's congestion control mechanism that, while it provides network-friendly transmission rate control, does guarantee flow control to receiving nodes.
2.3.2. Data Reception
NORM receiver applications learn of active senders and their corresponding pending and completed data transfers, etc via the API event dispatching mechanism. By default, NORM receivers use NACK messages to request repair of transmitted content from the originating sender as needed to achieve reliable transfer. Some API functions are available to provide some additional control over the NACKing behavior, such as initially NACKing for NORM_INFO content only or even to the extent of disabling receiver feedback (silent receiver or emission-controlled (EMCON) operation) entirely. Otherwise, the parameters and operation of reliable data transmission are left to sender applications and receivers learn of sender parameters in NORM protocol message headers and are instructed by NORM_CMD messages from the sender(s).
With respect to the NORM API, the receiver application is informed of new senders and receive data objects via the the NORM_REMOTE_SENDER_NEW and NORM_RX_OBJECT_NEW notifications, respectfully. Additionally, object reception progress is indicated with the NORM_RX_OBJECT_UPDATED notification and this also serves as an indicator for the NORM_OBJECT_STREAM type that the receive application should make calls to NormStreamRead() to read newly received stream content. NORM sender status is also conveyed via the NORM_REMOTE_SENDER_ACTIVE and NORM_REMOTE_SENDER_INACTIVE notifications. For example, the receiver application may use the NORM_REMOTE_SENDER_INACTIVE as a cue to make calls to NormNodeFreeBuffers() and/or NormNodeDelete() to free memory resources allocated for buffering received content for the given sender. The amount of memory allocated per sender is set in the NormStartReceiver() call.
2.4. API Event Notification
An asynchronous event dispatching mechanism is provided to notify the application of significant NORM protocol events. The centerpiece of this is the NormGetNextEvent() function that can be used to retrieve the next NORM protocol engine event in the form of a NormEvent structure. This function will typically block until a NormEvent occurs. However, non-blocking operation may be achieved by using the NormGetDescriptor() call to get a NormDescriptor (file descriptor) value (Unix int or Win32 HANDLE) suitable for use in a asynchronous I/O monitoring functions such as the Unix select() or Win32 MsgWaitForMultipleObjects() system calls. The a NormDescriptor will be signaled when a NormEvent is available. For Win32 platforms, dispatching of a user-defined Windows message for NORM event notification is also planned for a future update to the NORM API.
3. Build Notes
To build applications that use the NORM library, a path to the "normApi.h" header file must be provided and the linker step needs to reference the NORM library file ("libnorm.a" for Unix platforms and "Norm.lib" for Win32 platforms). NORM also depends upon the NRL Protean Protocol Prototyping toolkit "Protokit" library (a.k.a "Protolib") (static library files "libProtokit.a" for Unix and "Protokit.lib" for Win32). Shared or dynamically-linked versions of these libraries may also be built from the NORM source code or provided. Depending upon the platform, some additional library dependencies may be required to support the needs of NORM and/or Protokit. These are described below.
The "makefiles" directory contains Unix Makefiles for various platforms the "win32" and "wince" sub-directories there contain Microsoft Visual C++ (VC++) and Embedded VC++ project files for building the NORM implementation. Additionally, a "waf" (Python-based build tool) build option is supported that can be used to build and install the NORM library code on the supported platforms. Finally, Python and Java bindings to the NORM API are included and "src/python" and "src/java" directories contain the code for these and the "makefiles/java" directory contains Makefiles to build the NORM Java JNI bindings. Note the "waf" tool can also be used to build the Java and Python bindings.
3.1. Unix Platforms
NORM has been built and tested on Linux (various architectures), MacOS (BSD), Solaris, and IRIX (SGI) platforms. The code should be readily portable to other Unix platforms.
To support IPv6 operation, the NORM and the Protokit library must be compiled with the "HAVE_IPV6" macro defined. This is default in the NORM and Protokit Makefiles for platforms that support IPv6. It is important that NORM and Protokit be built with this macro defined the same. With NORM, it is recommended that "large file support" options be enabled when possible.
The NORM API uses threading so that the NORM protocol engine may run independent of the application. Thus the "POSIX Threads" library must be included ("-pthread") in the linking step. MacOS/BSD also requires the addition of the "-lresolv" (resolver) library and Solaris requires the dynamic loader, network/socket, and resolver libraries ("-lnsl -lsocket -lresolv") to achieve successful compilation. The Makefiles in the NORM source code distribution are a reference for these requirements. Note that MacOS 9 and earlier are not supported.
Additionally, it is critical that the _FILE_OFFSET_BITS macro be consistently defined for the NORM library build and the application build using the library. The distributed NORM Makefiles have -D_FILE_OFFSET_BITS=64 set in the compilation to enable "large file support". Applications built using NORM should have the same compilation option set to operate correctly (The definition of the NormSize type in "normApi.h" depends upon this compilation flag).
3.2. Win32/WiNCE Platforms
NORM has been built using Microsoft's Visual C++ (6.0 and .NET) and Embedded VC++ 4.2 environments. In addition to proper macro definitions (e.g., HAVE_IPV6, etc) that are included in the respective "Protokit" and "NORM" project files, it is important that common code generation settings be used when building the NORM application. The NORM and Protokit projects are built with the "Multi-threading DLL" library usage set. The NORM API requires multi-threading support. This is a critical setting and numerous compiler and linker errors will result if this is not properly set for your application project.
NORM and Protokit also depend on the Winsock 2.0 ("ws2_32.lib" (or "ws2.lib" (WinCE)) and the IP Helper API ("iphlpapi.lib") libraries and these must be included in the project "Link" attributes.
An additional note is that a bug in VC++ 6.0 and earlier compilers (includes embedded VC++ 4.x compilers) prevent compilation of Protokit-based code with debugging capabilities enabled. However, this has been resolved in VC++ .NET and is hoped to be resolved in the future for the WinCE build tools.
Operation on Windows NT4 (and perhaps other older Windows operating systems) requires that the compile time macro WINVER=0x0400 defined. This is because the version of the IP Helper API library (iphlpapi.lib) used by Protolib (and hence NORM) for this system doesn't support some of the functions defined for this library. This may be related to IPv6 support issues so it may be possible that the Protolib build could be tweaked to provide a single binary executable suitable for IPv4 operation only across a large range of Windows platforms.
4. API Reference
This section provides a reference to the NORM API variable types, constants and functions.
4.1. API Variable Types and Constants
The NORM API defines and enumerates a number of supporting variable types and values which are used in different function calls. The variable types are described here.
4.1.1. NormInstanceHandle
The NormInstanceHandle type is returned when a NORM API instance is created (see NormCreateInstance()). This handle can be subsequently used for API calls which require reference to a specific NORM API instance. By default, each NORM API instance instantiated creates an operating system thread for protocol operation. Note that multiple NORM transport sessions may be created for a single API instance. In general, it is expected that applications will create a single NORM API instance, but some multi-threaded application designs may prefer multiple corresponding NORM API instances. The value NORM_INSTANCE_INVALID corresponds to an invalid API instance.
4.1.2. NormSessionHandle
The NormSessionHandle type is used to reference NORM transport sessions which have been created using the NormCreateSession() API call. Multiple NormSessionHandle values may be associated with a given NormInstanceHandle. The special value NORM_SESSION_INVALID is used to refer to invalid session references.
4.1.3. NormSessionId
The NormSessionId type is used by applications to uniquely identify their instance of participation as a sender within a NormSession. This type is a parameter to the NormStartSender() function. Robust applications can use different NormSessionId values when initiating sender operation so that receivers can discriminate when a sender has terminated and restarted (whether intentional or due to system failure). For example, an application could cache its prior NormSessionId value in non-volatile storage which could then be recovered and incremented (for example) upon system restart to produce a new value. The NormSessionId value is used for the value of the instance_id field in NORM protocol sender messages (see the NORM protocol specification) and receivers use this field to detect sender restart within a NormSession.
4.1.4. NormNodeHandle
The NormNodeHandle type is used to reference state kept by the NORM implementation with respect to other participants within a NormSession. Most typically, the NormNodeHandle is used by receiver applications to dereference information about remote senders of data as needed. The special value NORM_NODE_INVALID corresponds to an invalid reference.
4.1.5. NormNodeId
The NormNodeId type corresponds to a 32-bit numeric value which should uniquely identify a participant (node) in a given NormSession. The NormNodeGetId() function can be used to retrieve this value given a valid NormNodeHandle. The special value NORM_NODE_NONE corresponds to an invalid (or null) node while the value NORM_NODE_ANY serves as a wild card value for some functions.
4.1.6. NormObjectHandle
The NormObjectHandle type is used to reference state kept for data transport objects being actively transmitted or received. The state kept for NORM transport objects is temporary, but the NORM API provides a function to persistently retain state associated with a sender or receiver NormObjectHandle (see NormObjectRetain()) if needed. For sender objects, unless explicitly retained, the NormObjectHandle can be considered valid until the referenced object is explicitly canceled (see NormObjectCancel()) or purged from the sender transmission queue (see the event NORM_TX_OBJECT_PURGED). For receiver objects, these handles should be treated as valid only until a subsequent call to NormGetNextEvent() unless, again, specifically retained. The special value NORM_OBJECT_INVALID corresponds to an invalid transport object reference.
4.1.7. NormObjectType
The NormObjectType type is an enumeration of possible NORM data transport object types. As previously mentioned, valid types include:
  1. NORM_OBJECT_FILE
  2. NORM_OBJECT_DATA, and
  3. NORM_OBJECT_STREAM
Given a NormObjectHandle, the application may determine an object's type using the NormObjectGetType() function call. A special NormObjectType value, NORM_OBJECT_NONE, indicates an invalid object type.
4.1.8. NormSize
The NormSize is the type used for NormObject size information. For example, the NormObjectGetSize() function returns a value of type NormSize. The range of NormSize values depends upon the operating system and NORM library compilation settings. With "large file support" enabled, as is the case with distributed NORM library "Makefiles", the NormSize type is a 64-bit integer. However, some platforms may support only 32-bit object sizes.
4.1.9. NormObjectTransportId
The NormObjectTransportId type is a 16-bit numerical value assigned to NormObjects by senders during active transport. These values are temporarily unique with respect to a given sender within a NormSession and may be "recycled" for use for future transport objects. NORM sender nodes assign these values in a monotonically increasing fashion during the course of a session as part of protocol operation. Typically, the application should not need access to these values, but an API call such as NormObjectGetTransportId() (TBD) may be provided to retrieve these values if needed. (Note this type may be deprecated; i.e., it may not be needed at since the NormRequeueObject() function is implemented using handles only, but _some_ applications requiring persistence even after a system reboot may need the ability to recall previous transport ids?)
4.1.10. NormEventType
The NormEventType is an enumeration of NORM API events. "Events" are used by the NORM API to signal the application of significant NORM protocol operation events (e.g., receipt of a new receive object, etc). A description of possible NormEventType values and their interpretation is given below. The function call NormGetNextEvent() is used to retrieve events from the NORM protocol engine.
4.1.11. NormEvent
The NormEvent type is a structure used to describe significant NORM protocol events. This structure is defined as follows:
typedef struct
 {
     NormEventType     type;
     NormSessionHandle session; 
@@ -64,7 +64,7 @@ void NormGetUserData(NormSessionHandle sessionHandle);
4.3.4.2. Description
This function retrieves the "user data" value set for the specified sessionHandle with a prior call to NormSetUserData().
4.3.4.3. Return Values
This function returns the user data value set for the specified session. If no user data value has been previously set, a NULL (i.e., (const void*)0) value is returned.
4.3.5. NormGetLocalNodeId()
4.3.5.1. Synopsis
#include <normApi.h>
 
-NormNodeId NormGetLocalNodeId(NormSessionHandle sessionHandle);
4.3.5.2. Description
This function retrieves the NormNodeId value used for the application's participation in the NormSession identified by the sessionHandle parameter. The value may have been explicitly set during the NormCreateSession() call or may have been automatically derived using the host computer's "default" IP network address.
4.3.5.3. Return Values
The returned value indicates the NormNode identifier used by the NORM protocol engine for the local application's participation in the specified NormSession.
4.3.6. NormSetTxPort()
4.3.6.1. Synopsis
#include <normApi.h>
+NormNodeId NormGetLocalNodeId(NormSessionHandle sessionHandle);
4.3.5.2. Description
This function retrieves the NormNodeId value used for the application's participation in the NormSession identified by the sessionHandle parameter. The value may have been explicitly set during the NormCreateSession() call or may have been automatically derived using the host computer's "default" IP network address.
4.3.5.3. Return Valuess
The returned value indicates the NormNode identifier used by the NORM protocol engine for the local application's participation in the specified NormSession.
4.3.6. NormSetTxPort()
4.3.6.1. Synopsis
#include <normApi.h>
 
 bool NormSetTxPort(NormSessionHandle sessionHandle,
                    unsigned short    txPort,
@@ -84,264 +84,267 @@ void NormSetMulticastInterface(NormSessionHandle session,
                                const char*       interfaceName);
4.3.9.2. Description
This function specifies which host network interface is used for IP Multicast transmissions and group membership. This should be called before any call to NormStartSender() or NormStartReceiver() is made so that the IP multicast group is joined on the proper host interface. However, if a call to NormSetMulticastInterface() is made after either of these function calls, the call will not affect the group membership interface, but only dictate that a possibly different network interface is used for transmitted NORM messages. Thus, the code:
NormSetMulticastInterface(session, "interface1");
 NormStartReceiver(session, ...);
-NormSetMulticastInterface(session, "interface2");
will result in NORM group membership (i.e. multicast reception) being managed on "interface1" while NORM multicast transmissions are made via "interface2".
4.3.9.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified interface was valid. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if an invalid interface was specified with the call described here.
4.3.10. NormSetTTL()
4.3.10.1. Synopsis
#include <normApi.h>
+NormSetMulticastInterface(session, "interface2");
will result in NORM group membership (i.e. multicast reception) being managed on "interface1" while NORM multicast transmissions are made via "interface2".
4.3.9.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified interface was invalid. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if an invalid interface was specified with the call described here.
4.3.10. NormSetSSM()
4.3.10.1. Synopsis
#include <normApi.h>
 
-bool NormSetTTL(NormSessionHandle session,
-                unsigned char     ttl);
4.3.10.2. Description
This function specifies the time-to-live (ttl) for IP Multicast datagrams generated by NORM for the specified sessionHandle. The IP TTL field limits the number of router "hops" that a generated multicast packet may traverse before being dropped. For example, if TTL is equal to one, the transmissions will be limited to the local area network (LAN) of the host computers network interface. Larger TTL values should be specified to span large networks. Also note that some multicast router configurations use artificial "TTL threshold" values to constrain some multicast traffic to an administrative boundary. In these cases, the NORM TTL setting must also exceed the router "TTL threshold" in order for the NORM traffic to be allowed to exit the administrative area.
4.3.10.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified ttl could not be set. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if the desired ttl value cannot be set.
4.3.11. NormSetTOS()
4.3.11.1. Synopsis
#include <normApi.h>
+bool NormSetSSM(NormSessionHandle session,
+                const char*       sourceAddress);
4.3.10.2. Description
This function sets the source address for Source-Specific Multicast (SSM) operation.  This should be called before any call to NormStartSender() or NormStartReceiver() is made so that the proper group join is done.  The receiver application MUST also use the NormSetDefaultUnicastNack() call so that feedback traffic is directed back to appropriate sender.
4.3.10.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified source address was invalid. Note that if a valid IP address is specified but is improper for SSM (e.g., an IP multicast address) the later calls to  NormStartSender() or NormStartReceiver() may fail.
4.3.11. NormSetTTL()
4.3.11.1. Synopsis
#include <normApi.h>
 
-bool NormSetTOS(NormSessionHandle       sessionHandle,
-                unsigned char           tos);
4.3.11.2. Description
This function specifies the type-of-service (tos) field value used in IP Multicast datagrams generated by NORM for the specified sessionHandle. The IP TOS field value can be used as an indicator that a "flow" of packets may merit special Quality-of-Service (QoS) treatment by network devices. Users should refer to applicable QoS information for their network to determine the expected interpretation and treatment (if any) of packets with explicit TOS marking.
4.3.11.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified tos could not be set. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if the desired tos value cannot be set.
4.3.12. NormSetLoopback()
4.3.12.1. Synopsis
#include <normApi.h>
+bool NormSetTTL(NormSessionHandle session,
+                unsigned char     ttl);
4.3.11.2. Description
This function specifies the time-to-live (ttl) for IP Multicast datagrams generated by NORM for the specified sessionHandle. The IP TTL field limits the number of router "hops" that a generated multicast packet may traverse before being dropped. For example, if TTL is equal to one, the transmissions will be limited to the local area network (LAN) of the host computers network interface. Larger TTL values should be specified to span large networks. Also note that some multicast router configurations use artificial "TTL threshold" values to constrain some multicast traffic to an administrative boundary. In these cases, the NORM TTL setting must also exceed the router "TTL threshold" in order for the NORM traffic to be allowed to exit the administrative area.
4.3.11.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified ttl could not be set. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if the desired ttl value cannot be set.
4.3.12. NormSetTOS()
4.3.12.1. Synopsis
#include <normApi.h>
 
-void NormSetLoopback(NormSessionHandle sessionHandle,
-                     bool              loopbackEnable);
4.3.12.2. Description
This function enables or disables loopback operation for the indicated NORM sessionHandle. If loopbackEnable is set to true, loopback operation is enabled which allows the application to receive its own message traffic. Thus, an application which is both actively receiving and sending may receive its own transmissions. Note it is expected that this option would be principally be used for test purposes and that applications would generally not need to transfer data to themselves. If loopbackEnable is false, the application is prevented from receiving its own NORM message transmissions. By default, loopback operation is disabled when a NormSession is created.
4.3.12.3. Return Values
This function has no return values.
4.3.13. NormSetFragmentation()
4.3.13.1. Synopsis
#include <normApi.h>
+bool NormSetTOS(NormSessionHandle       sessionHandle,
+                unsigned char           tos);
4.3.12.2. Description
This function specifies the type-of-service (tos) field value used in IP Multicast datagrams generated by NORM for the specified sessionHandle. The IP TOS field value can be used as an indicator that a "flow" of packets may merit special Quality-of-Service (QoS) treatment by network devices. Users should refer to applicable QoS information for their network to determine the expected interpretation and treatment (if any) of packets with explicit TOS marking.
4.3.12.3. Return Values
A return value of true indicates success while a return value of false indicates that the specified tos could not be set. This function will always return true if made before calls to NormStartSender() or NormStartReceiver(). However, those calls may fail if the desired tos value cannot be set.
4.3.13. NormSetLoopback()
4.3.13.1. Synopsis
#include <normApi.h>
 
-bool NormSetFragmentation(NormSessionHandle sessionHandle,
-                          bool              fragmentation);
4.3.13.2. Description
This function sets an underlying socket option that enables or disables IP datagram fragmentation by network intermediate systems according to whether the fragmentation parameter is set to a value of true or false, respectively.  If set to true to enable fragmentation, the DF (don't fragment) bit of the headers of NORM UDP/IP packets sent will be cleared.  Otherwise the DF bit is set and packets will not be fragmented by network devices if they exceed a link Maximum Transmission Unit (MTU) and will instead be dropped.  For IP Multicast destinations, some operating systems may always set the DF bit of transmitted packets, regardless of the setting here and the underlying socket option status.  Typically, the DF bit is set (i.e., fragmentation disabled) by default on most operating systems.  
This call is not currently functional on the Mac OSX system that does not support the needed IP_MTU_DISCOVER or IP_DONTFRAG socket options.
4.3.13.3. Return Values
This function returns true upon success and false upon failure.
4.4. NORM Sender Functions
The functions described in this section apply only to NORM sender operation. Applications may participate strictly as senders or as receivers, or may act as both in the context of a NORM protocol session. The NORM sender is responsible for most parameters pertaining to its transmission of data. This includes transmission rate, data segmentation sizes, FEC coding parameters, stream buffer sizes, etc.
4.4.1. NormStartSender()
4.4.1.1. Synopsis
#include <normApi.h>
+void NormSetLoopback(NormSessionHandle sessionHandle,
+                     bool              loopbackEnable);
4.3.13.2. Description
This function enables or disables loopback operation for the indicated NORM sessionHandle. If loopbackEnable is set to true, loopback operation is enabled which allows the application to receive its own message traffic. Thus, an application which is both actively receiving and sending may receive its own transmissions. Note it is expected that this option would be principally be used for test purposes and that applications would generally not need to transfer data to themselves. If loopbackEnable is false, the application is prevented from receiving its own NORM message transmissions. By default, loopback operation is disabled when a NormSession is created.
4.3.13.3. Return Values
This function has no return values.
4.3.14. NormSetFragmentation()
4.3.14.1. Synopsis
#include <normApi.h>
+
+bool NormSetFragmentation(NormSessionHandle sessionHandle,
+                          bool              fragmentation);
4.3.14.2. Description
This function sets an underlying socket option that enables or disables IP datagram fragmentation by network intermediate systems according to whether the fragmentation parameter is set to a value of true or false, respectively. If set to true to enable fragmentation, the DF (don't fragment) bit of the headers of NORM UDP/IP packets sent will be cleared. Otherwise the DF bit is set and packets will not be fragmented by network devices if they exceed a link Maximum Transmission Unit (MTU) and will instead be dropped. For IP Multicast destinations, some operating systems may always set the DF bit of transmitted packets, regardless of the setting here and the underlying socket option status. Typically, the DF bit is set (i.e., fragmentation disabled) by default on most operating systems.
This call is not currently functional on the Mac OSX system that does not support the needed IP_MTU_DISCOVER or IP_DONTFRAG socket options.
4.3.14.3. Return Values
This function returns true upon success and false upon failure.
4.4. NORM Sender Functions
The functions described in this section apply only to NORM sender operation. Applications may participate strictly as senders or as receivers, or may act as both in the context of a NORM protocol session. The NORM sender is responsible for most parameters pertaining to its transmission of data. This includes transmission rate, data segmentation sizes, FEC coding parameters, stream buffer sizes, etc.
4.4.1. NormStartSender()
4.4.1.1. Synopsis
#include <normApi.h>
 
 bool NormStartSender(NormSessionHandle        sessionHandle,
                      NormSessionId            instanceId,
                      unsigned long            bufferSpace,
                      unsigned short           segmentSize,
                      unsigned char            blockSize,
-                     unsigned char            numParity);
4.4.1.2. Description
The application's participation as a sender within a specified NormSession begins when this function is called. This includes protocol activity such as congestion control and/or group round-trip timing (GRTT) feedback collection and application API activity such as posting of sender-related NormEvent notifications. The parameters required for this function call include:
sessionHandle
This must be a valid NormSessionHandle previously obtained with a call to NormCreateSession().
instanceId
Application-defined value used as the instance_id field of NORM sender messages for the application's participation within a session. Receivers can detect when a sender has terminated and restarted if the application uses different instanceId values when initiating sender operation. For example, a robust application could cache previous instanceId values in non-volatile storage and gracefully recover (without confusing receivers) from a total system shutdown and reboot by using a new instanceId value upon restart.
bufferSpace
This specifies the maximum memory space (in bytes) the NORM protocol engine is allowed to use to buffer any sender calculated FEC segments and repair state for the session. The optimum bufferSpace value is function of the network topology bandwidth*delay product and packet loss characteristics. If the bufferSpace limit is too small, the protocol may operate less efficiently as the sender is required to possibly recalculate FEC parity segments and/or provide less efficient repair transmission strategies (resort to explicit repair) when state is dropped due to constrained buffering resources. However, note the protocol will still provide reliable transfer. A large bufferSpace allocation is safer at the expense of possibly committing more memory resources.
segmentSize
This parameter sets the maximum payload size (in bytes) of NORM sender messages (not including any NORM message header fields). A sender's segmentSize value is also used by receivers to limit the payload content of some feedback messages (e.g. NORM_NACK message content, etc.) generated in response to that sender. Note different senders within a NormSession may use different segmentSize values. Generally, the appropriate segment size to use is dependent upon the types of networks forming the multicast topology, but applications may choose different values for other purposes. Note that application designers MUST account for the size of NORM message headers when selecting a segmentSize. For example, the NORM_DATA message header for a NORM_OBJECT_STREAM with full header extensions is 48 bytes in length. In this case, the UDP payload size of these messages generated by NORM would be up to (48 + segmentSize) bytes.
blockSize
This parameter sets the number of source symbol segments (packets) per coding block, for the systematic Reed-Solomon FEC code used in the current NORM implementation. For traditional systematic block code "(n,k)" nomenclature, the blockSize value corresponds to "k". NORM logically segments transport object data content into coding blocks and the blockSize parameter determines the number of source symbol segments (packets) comprising a single coding block where each source symbol segment is up to segmentSize bytes in length.. A given block's parity symbol segments are calculated using the corresponding set of source symbol segments. The maximum blockSize allowed by the 8-bit Reed-Solomon codes in NORM is 255, with the further limitation that (blockSize + numParity) <= 255.
numParity
This parameter sets the maximum number of parity symbol segments (packets) the sender is willing to calculate per FEC coding block. The parity symbol segments for a block are calculated from the corresponding blockSize source symbol segments. In the "(n,k)" nomenclature mention above, the numParity value corresponds to "n - k". A property of the Reed-Solomon FEC codes used in the current NORM implementation is that one parity segment can fill any one erasure (missing segment (packet)) for a coding block. For a given blockSize, the maximum numParity value is (255 - blockSize). However, note that computational complexity increases significantly with increasing numParity values and applications may wish to be conservative with respect to numParity selection, given anticipated network packet loss conditions and group size scalability concerns. Additional FEC code options may be provided for this NORM implementation in the future with different parameters, capabilities, trade-offs, and computational requirements.
These parameters are currently immutable with respect to a sender's participation within a NormSession. Sender operation must be stopped (see NormStopSender()) and restarted with another call to NormStartSender() if these parameters require alteration. The API may be extended in the future to support additional flexibility here, if required. For example, the NORM protocol "intance_id" field may possibly be leveraged to permit a node to establish multiple virtual presences as a sender within a NormSession in the future. This would allow the sender to provide multiple concurrent streams of transport, with possibly different FEC and other parameters if appropriate within the context of a single NormSession. Again, this extended functionality is not yet supported in this implementation.
4.4.1.3. Return Values
A value of true is returned upon success and false upon failure. The reasons failure may occur include limited system resources or that the network sockets required for communication failed to open or properly configure. (TBD - Provide a NormGetError(NormSessionHandle sessionHandle) function to retrieve a more specific error indication for this and other functions.)
4.4.2. NormStopSender()
4.4.2.1. Synopsis
#include <normApi.h>
+                     unsigned char            numParity);
4.4.1.2. Description
The application's participation as a sender within a specified NormSession begins when this function is called. This includes protocol activity such as congestion control and/or group round-trip timing (GRTT) feedback collection and application API activity such as posting of sender-related NormEvent notifications. The parameters required for this function call include:
sessionHandle
This must be a valid NormSessionHandle previously obtained with a call to NormCreateSession().
instanceId
Application-defined value used as the instance_id field of NORM sender messages for the application's participation within a session. Receivers can detect when a sender has terminated and restarted if the application uses different instanceId values when initiating sender operation. For example, a robust application could cache previous instanceId values in non-volatile storage and gracefully recover (without confusing receivers) from a total system shutdown and reboot by using a new instanceId value upon restart.
bufferSpace
This specifies the maximum memory space (in bytes) the NORM protocol engine is allowed to use to buffer any sender calculated FEC segments and repair state for the session. The optimum bufferSpace value is function of the network topology bandwidth*delay product and packet loss characteristics. If the bufferSpace limit is too small, the protocol may operate less efficiently as the sender is required to possibly recalculate FEC parity segments and/or provide less efficient repair transmission strategies (resort to explicit repair) when state is dropped due to constrained buffering resources. However, note the protocol will still provide reliable transfer. A large bufferSpace allocation is safer at the expense of possibly committing more memory resources.
segmentSize
This parameter sets the maximum payload size (in bytes) of NORM sender messages (not including any NORM message header fields). A sender's segmentSize value is also used by receivers to limit the payload content of some feedback messages (e.g. NORM_NACK message content, etc.) generated in response to that sender. Note different senders within a NormSession may use different segmentSize values. Generally, the appropriate segment size to use is dependent upon the types of networks forming the multicast topology, but applications may choose different values for other purposes. Note that application designers MUST account for the size of NORM message headers when selecting a segmentSize. For example, the NORM_DATA message header for a NORM_OBJECT_STREAM with full header extensions is 48 bytes in length. In this case, the UDP payload size of these messages generated by NORM would be up to (48 + segmentSize) bytes.
blockSize
This parameter sets the number of source symbol segments (packets) per coding block, for the systematic Reed-Solomon FEC code used in the current NORM implementation. For traditional systematic block code "(n,k)" nomenclature, the blockSize value corresponds to "k". NORM logically segments transport object data content into coding blocks and the blockSize parameter determines the number of source symbol segments (packets) comprising a single coding block where each source symbol segment is up to segmentSize bytes in length.. A given block's parity symbol segments are calculated using the corresponding set of source symbol segments. The maximum blockSize allowed by the 8-bit Reed-Solomon codes in NORM is 255, with the further limitation that (blockSize + numParity) <= 255.
numParity
This parameter sets the maximum number of parity symbol segments (packets) the sender is willing to calculate per FEC coding block. The parity symbol segments for a block are calculated from the corresponding blockSize source symbol segments. In the "(n,k)" nomenclature mention above, the numParity value corresponds to "n - k". A property of the Reed-Solomon FEC codes used in the current NORM implementation is that one parity segment can fill any one erasure (missing segment (packet)) for a coding block. For a given blockSize, the maximum numParity value is (255 - blockSize). However, note that computational complexity increases significantly with increasing numParity values and applications may wish to be conservative with respect to numParity selection, given anticipated network packet loss conditions and group size scalability concerns. Additional FEC code options may be provided for this NORM implementation in the future with different parameters, capabilities, trade-offs, and computational requirements.
These parameters are currently immutable with respect to a sender's participation within a NormSession. Sender operation must be stopped (see NormStopSender()) and restarted with another call to NormStartSender() if these parameters require alteration. The API may be extended in the future to support additional flexibility here, if required. For example, the NORM protocol "intance_id" field may possibly be leveraged to permit a node to establish multiple virtual presences as a sender within a NormSession in the future. This would allow the sender to provide multiple concurrent streams of transport, with possibly different FEC and other parameters if appropriate within the context of a single NormSession. Again, this extended functionality is not yet supported in this implementation.
4.4.1.3. Return Values
A value of true is returned upon success and false upon failure. The reasons failure may occur include limited system resources or that the network sockets required for communication failed to open or properly configure. (TBD - Provide a NormGetError(NormSessionHandle sessionHandle) function to retrieve a more specific error indication for this and other functions.)
4.4.2. NormStopSender()
4.4.2.1. Synopsis
#include <normApi.h>
 
 void NormStopSender(NormSessionHandle sessionHandle,
-                    bool              graceful = false);
4.4.2.2. Description
This function terminates the application's participation in a NormSession as a sender. By default, the sender will immediately exit the session identified by the sessionHandle parameter without notifying the receiver set of its intention. However a "graceful shutdown" option, enabled by setting the graceful parameter to true, is provided to terminate sender operation gracefully, notifying the receiver set its pending exit with appropriate protocol messaging. A NormEvent, NORM_LOCAL_SENDER_CLOSED, is dispatched when the graceful shutdown process has completed.
4.4.2.3. Return Values
This function has no return values.
4.4.3. NormSetTxRate()
4.4.3.1. Synopsis
#include <normApi.h>
+                    bool              graceful = false);
4.4.2.2. Description
This function terminates the application's participation in a NormSession as a sender. By default, the sender will immediately exit the session identified by the sessionHandle parameter without notifying the receiver set of its intention. However a "graceful shutdown" option, enabled by setting the graceful parameter to true, is provided to terminate sender operation gracefully, notifying the receiver set its pending exit with appropriate protocol messaging. A NormEvent, NORM_LOCAL_SENDER_CLOSED, is dispatched when the graceful shutdown process has completed.
4.4.2.3. Return Values
This function has no return values.
4.4.3. NormSetTxRate()
4.4.3.1. Synopsis
#include <normApi.h>
 
 void NormSetTxRate(NormSessionHandle sessionHandle,
-                   double            rate);
4.4.3.2. Description
This function sets the transmission rate (in bits per second (bps)) limit used for NormSender transmissions for the given sessionHandle. For fixed-rate transmission of NORM_OBJECT_FILE or NORM_OBJECT_DATA, this limit determines the data rate at which NORM protocol messages and data content are sent. For NORM_OBJECT_STREAM transmissions, this is the maximum rate allowed for transmission (i.e. if the application writes to the stream at a lower rate, a lower average NORM transmission rate will occur). Note that the application will need to consider the overhead of NORM protocol headers when determining an appropriate transmission rate for its purposes. When NORM congestion control is enabled (see NormSetCongestionControl()), the rate set here will be set, but congestion control operation, if enabled, may quickly readjust the transmission rate.
4.4.3.3. Return Values
This function has no return values.
4.4.4. NormGetTxRate()
4.4.4.1. Synopsis
#include <normApi.h>
+                   double            rate);
4.4.3.2. Description
This function sets the transmission rate (in bits per second (bps)) limit used for NormSender transmissions for the given sessionHandle. For fixed-rate transmission of NORM_OBJECT_FILE or NORM_OBJECT_DATA, this limit determines the data rate at which NORM protocol messages and data content are sent. For NORM_OBJECT_STREAM transmissions, this is the maximum rate allowed for transmission (i.e. if the application writes to the stream at a lower rate, a lower average NORM transmission rate will occur). Note that the application will need to consider the overhead of NORM protocol headers when determining an appropriate transmission rate for its purposes. When NORM congestion control is enabled (see NormSetCongestionControl()), the rate set here will be set, but congestion control operation, if enabled, may quickly readjust the transmission rate.
4.4.3.3. Return Values
This function has no return values.
4.4.4. NormGetTxRate()
4.4.4.1. Synopsis
#include <normApi.h>
 
-double NormGetTxRate(NormSessionHandle sessionHandle);
4.4.4.2. Description
This function retrieves the current sender transmission rate in units of bits per second (bps) for the given sessionHandle. When NORM congestion control is enabled (see NormSetCongestionControl()), this reflects the current rate set (or suggested) by NORM congestion control operation. Otherwise, this returns the rate that was set with the NormSetTxRate() call.
4.4.4.3. Return Values
This function returns the sender transmission rate in units of bits per second (bps).
4.4.5. NormSetTxSocketBuffer()
4.4.5.1. Synopsis
#include <normApi.h>
+double NormGetTxRate(NormSessionHandle sessionHandle);
4.4.4.2. Description
This function retrieves the current sender transmission rate in units of bits per second (bps) for the given sessionHandle. When NORM congestion control is enabled (see NormSetCongestionControl()), this reflects the current rate set (or suggested) by NORM congestion control operation. Otherwise, this returns the rate that was set with the NormSetTxRate() call.
4.4.4.3. Return Values
This function returns the sender transmission rate in units of bits per second (bps).
4.4.5. NormSetTxSocketBuffer()
4.4.5.1. Synopsis
#include <normApi.h>
 
 bool NormSetTxSocketBuffer(NormSessionHandle sessionHandle,
-                           unsigned int      bufferSize);
4.4.5.2. Description
This function can be used to set a non-default socket buffer size for the UDP socket used by the specified NORM sessionHandle for data transmission. The bufferSize parameter specifies the desired socket buffer size in bytes. Large transmit socket buffer sizes may be necessary to achieve high transmission rates when NORM, as a user-space process, is unable to precisely time its packet transmissions. Similarly, NORM receivers may need to set large receive socket buffer sizes to achieve successful, sustained high data rate reception (see NormSetRxSocketBuffer()). Typically, it is more important to set the receive socket buffer size (see NormSetRxSocketBuffer()) as this maintains reliability (i.e. by avoiding receive socket buffer overflow) at high data rates while setting a larger transmit socket buffer size allows higher average transmission rates to be achieved.
4.4.5.3. Return Values
This function returns true upon success and false upon failure. Possible failure modes include an invalid sessionHandle parameter, a call to NormStartReceiver() or NormStartSender() has not yet been made for the session, or an invalid bufferSize was given. Note some operating systems may require additional system configuration to use non-standard socket buffer sizes.
4.4.6. NormSetFlowControl()
4.4.6.1. Synopsis
#include <normApi.h>
+                           unsigned int      bufferSize);
4.4.5.2. Description
This function can be used to set a non-default socket buffer size for the UDP socket used by the specified NORM sessionHandle for data transmission. The bufferSize parameter specifies the desired socket buffer size in bytes. Large transmit socket buffer sizes may be necessary to achieve high transmission rates when NORM, as a user-space process, is unable to precisely time its packet transmissions. Similarly, NORM receivers may need to set large receive socket buffer sizes to achieve successful, sustained high data rate reception (see NormSetRxSocketBuffer()). Typically, it is more important to set the receive socket buffer size (see NormSetRxSocketBuffer()) as this maintains reliability (i.e. by avoiding receive socket buffer overflow) at high data rates while setting a larger transmit socket buffer size allows higher average transmission rates to be achieved.
4.4.5.3. Return Values
This function returns true upon success and false upon failure. Possible failure modes include an invalid sessionHandle parameter, a call to NormStartReceiver() or NormStartSender() has not yet been made for the session, or an invalid bufferSize was given. Note some operating systems may require additional system configuration to use non-standard socket buffer sizes.
4.4.6. NormSetFlowControl()
4.4.6.1. Synopsis
#include <normApi.h>
 
 void NormSetFlowControl(NormSessionHandle sessionHandle,
-                        double            flowControlFactor);
4.4.6.2. Description
This function controls a scaling factor that is used for sender timer-based flow control for the the specified NORM sessionHandle. Timer-based flow control works by preventing the NORM sender application from enqueueing new transmit objects or stream data that would purge "old" objects or stream data when there has been recent NACK activity for those old objects or data. If the flowControlFactor is set to ZERO, then the flow control mechanism is effectively disabled. Larger flowControlFactor values enforce more robust flow control by forcing the sender to maintain state longer, but then larger transmit buffer, stream buffer, transmit cache bounds and receive cache limits (see NormStartSender(), NormStreamOpen(), NormSetTxCacheBounds(), and NormSetRxCacheLimit(), respectively) may be needed to maintain throughput in larger <delay*bandwidth, loss> conditions. Effectively, a larger flowControlFactor can favor reliability over throughput when buffer-constrained.
The flowControlFactor is used to compute a delay time for when a sender buffered object (or block of stream data) may be released (i.e. purged) after transmission or applicable NACKs reception. The delay time function is:
flowControlDelay = flowControlFactor * GRTT * (backoffFactor + 1)
where the "GRTT" is the sender's advertised GRTT estimate and the backoffFactor is the sender's configured timer-based feedback scaling factor.
The default value (when this function is not called) of the flowControlFactor is 2.0. Note that a NORM application can also implement more explicit, deterministic flow control through use of the NormSetWatermark() API call, potentially even requiring positive acknowledgement of older data before enqueueing new data. Note that using the NormSetWatermark() API call with a NORM_NODE_NONE member in acking node list to force a "full" watermark flush is somewhat equivalent to timer-based flow control with a flowControlFactor equal to 2.0 * txRobustFactor.
If such explicit flow control is implemented by the application, then a reduced flowControlFactor (or even ZERO) may be used. If "push mode" is enabled for a NORM_OBJECT_STREAM (see NormStreamSetPushEnable()), then flow control has no effect for the stream.
4.4.6.3. Return Values
This function has no return values.
4.4.7. NormSetCongestionControl()
4.4.7.1. Synopsis
#include <normApi.h>
+                        double            flowControlFactor);
4.4.6.2. Description
This function controls a scaling factor that is used for sender timer-based flow control for the the specified NORM sessionHandle. Timer-based flow control works by preventing the NORM sender application from enqueueing new transmit objects or stream data that would purge "old" objects or stream data when there has been recent NACK activity for those old objects or data. If the flowControlFactor is set to ZERO, then the flow control mechanism is effectively disabled. Larger flowControlFactor values enforce more robust flow control by forcing the sender to maintain state longer, but then larger transmit buffer, stream buffer, transmit cache bounds and receive cache limits (see NormStartSender(), NormStreamOpen(), NormSetTxCacheBounds(), and NormSetRxCacheLimit(), respectively) may be needed to maintain throughput in larger <delay*bandwidth, loss> conditions. Effectively, a larger flowControlFactor can favor reliability over throughput when buffer-constrained.
The flowControlFactor is used to compute a delay time for when a sender buffered object (or block of stream data) may be released (i.e. purged) after transmission or applicable NACKs reception. The delay time function is:
flowControlDelay = flowControlFactor * GRTT * (backoffFactor + 1)
where the "GRTT" is the sender's advertised GRTT estimate and the backoffFactor is the sender's configured timer-based feedback scaling factor.
The default value (when this function is not called) of the flowControlFactor is 2.0. Note that a NORM application can also implement more explicit, deterministic flow control through use of the NormSetWatermark() API call, potentially even requiring positive acknowledgement of older data before enqueueing new data. Note that using the NormSetWatermark() API call with a NORM_NODE_NONE member in acking node list to force a "full" watermark flush is somewhat equivalent to timer-based flow control with a flowControlFactor equal to 2.0 * txRobustFactor.
If such explicit flow control is implemented by the application, then a reduced flowControlFactor (or even ZERO) may be used. If "push mode" is enabled for a NORM_OBJECT_STREAM (see NormStreamSetPushEnable()), then flow control has no effect for the stream.
4.4.6.3. Return Values
This function has no return values.
4.4.7. NormSetCongestionControl()
4.4.7.1. Synopsis
#include <normApi.h>
 
 void NormSetCongestionControl(NormSessionHandle sessionHandle,
                               bool              enable,
-                              bool              adjustRate = true);
4.4.7.2. Description
This function enables (or disables) the NORM sender congestion control operation for the session designated by the sessionHandle parameter. For best operation, this function should be called before the call to NormStartSender() is made, but congestion control operation can be dynamically enabled/disabled during the course of sender operation. If the value of the enable parameter is true, congestion control operation is enabled while it is disabled for enable equal to false. When congestion control operation is enabled, the NORM sender automatically adjusts its transmission rate based on feedback from receivers. If bounds on transmission rate have been set (see NormSetTxRateBounds()) the rate adjustment will remain within the set bounds. The application will be notified of any changes to the sender transmission rate via a NormEvent of type NORM_TX_RATE_CHANGED.
The rate set by NormSetTxRate() has no effect when congestion control operation is enabled, unless the adjustRate parameter here is set to false. When the adjustRate parameter is set to false, the NORM Congestion Control operates as usual, with feedback collected from the receiver set and the "current limiting receiver" identified, except that no actual adjustment is made to the sender's transmission rate. I.e., the transmission rate that was set by NormSetTxRate() is observed by the sender regardless of the feedback received. The NORM_TX_RATE_CHANGED notification will still occur as if the rate were being adjusted and the value returned by NormGetTxRate() reflects the rate that would have been used had the adjustRate parameter been enabled even though no actual rate change has occurred. The purpose of this variation of NORM Congestion Control operation is to allow applications to get a "suggested" rate from the NORM-CC mechanism. But, it is important to note that this "suggested" rate may or may not be appropriate since the operation of the NORM-CC algorithm is somewhat dependent on the associated NORM sender load on the network. For example, the "suggested" rate may be artificially high if the sender application has not been correspondingly setting the rate and actively transmitting data at that rate. This optional mode of operation is provided for EXPERIMENTAL purposes and is NOT RECOMMENDED for typical use of NORM.
NORM's congestion algorithm provides rate adjustment to fairly compete for available network bandwidth with other TCP, NORM, or similarly governed traffic flows.
(TBD - Describe the NormSetEcnSupport() function as this experimental option matures.)
4.4.7.3. Return Values
This function has no return values.
4.4.8. NormSetTxRateBounds()
4.4.8.1. Synopsis
#include <normApi.h>
+                              bool              adjustRate = true);
4.4.7.2. Description
This function enables (or disables) the NORM sender congestion control operation for the session designated by the sessionHandle parameter. For best operation, this function should be called before the call to NormStartSender() is made, but congestion control operation can be dynamically enabled/disabled during the course of sender operation. If the value of the enable parameter is true, congestion control operation is enabled while it is disabled for enable equal to false. When congestion control operation is enabled, the NORM sender automatically adjusts its transmission rate based on feedback from receivers. If bounds on transmission rate have been set (see NormSetTxRateBounds()) the rate adjustment will remain within the set bounds. The application will be notified of any changes to the sender transmission rate via a NormEvent of type NORM_TX_RATE_CHANGED.
The rate set by NormSetTxRate() has no effect when congestion control operation is enabled, unless the adjustRate parameter here is set to false. When the adjustRate parameter is set to false, the NORM Congestion Control operates as usual, with feedback collected from the receiver set and the "current limiting receiver" identified, except that no actual adjustment is made to the sender's transmission rate. I.e., the transmission rate that was set by NormSetTxRate() is observed by the sender regardless of the feedback received. The NORM_TX_RATE_CHANGED notification will still occur as if the rate were being adjusted and the value returned by NormGetTxRate() reflects the rate that would have been used had the adjustRate parameter been enabled even though no actual rate change has occurred. The purpose of this variation of NORM Congestion Control operation is to allow applications to get a "suggested" rate from the NORM-CC mechanism. But, it is important to note that this "suggested" rate may or may not be appropriate since the operation of the NORM-CC algorithm is somewhat dependent on the associated NORM sender load on the network. For example, the "suggested" rate may be artificially high if the sender application has not been correspondingly setting the rate and actively transmitting data at that rate. This optional mode of operation is provided for EXPERIMENTAL purposes and is NOT RECOMMENDED for typical use of NORM.
NORM's congestion algorithm provides rate adjustment to fairly compete for available network bandwidth with other TCP, NORM, or similarly governed traffic flows.
(TBD - Describe the NormSetEcnSupport() function as this experimental option matures.)
4.4.7.3. Return Values
This function has no return values.
4.4.8. NormSetTxRateBounds()
4.4.8.1. Synopsis
#include <normApi.h>
 
 bool NormSetTxRateBounds(NormSessionHandle sessionHandle,
                                double            rateMin,
-                               double            rateMax);
4.4.8.2. Description
This function sets the range of sender transmission rates within which the NORM congestion control algorithm is allowed to operate for the given sessionHandle. By default, the NORM congestion control algorithm operates with no lower or upper bound on its rate adjustment. This function allows this to be limited where rateMin corresponds to the minimum transmission rate (bps) and rateMax corresponds to the maximum transmission rate. One or both of these parameters may be set to values less than zero to remove one or both bounds. For example, the call "NormSetTxRateBounds(session, -1.0, 64000.0)" will set an upper limit of 64 kbps for the sender transmission rate with no lower bound. These rate bounds apply only when congestion control operation is enabled (see NormSetCongestionControl()). If the current congestion control rate falls outside of the specified bounds, the sender transmission rate will be adjusted to stay within the set bounds.
4.4.8.3. Return Values
This function returns true upon success. If both rateMin and rateMax are greater than or equal to zero, but (rateMax < rateMin), the rate bounds will remain unset or unchanged and the function will return false.
4.4.9. NormSetTxCacheBounds()
4.4.9.1. Synopsis
#include <normApi.h>
+                               double            rateMax);
4.4.8.2. Description
This function sets the range of sender transmission rates within which the NORM congestion control algorithm is allowed to operate for the given sessionHandle. By default, the NORM congestion control algorithm operates with no lower or upper bound on its rate adjustment. This function allows this to be limited where rateMin corresponds to the minimum transmission rate (bps) and rateMax corresponds to the maximum transmission rate. One or both of these parameters may be set to values less than zero to remove one or both bounds. For example, the call "NormSetTxRateBounds(session, -1.0, 64000.0)" will set an upper limit of 64 kbps for the sender transmission rate with no lower bound. These rate bounds apply only when congestion control operation is enabled (see NormSetCongestionControl()). If the current congestion control rate falls outside of the specified bounds, the sender transmission rate will be adjusted to stay within the set bounds.
4.4.8.3. Return Values
This function returns true upon success. If both rateMin and rateMax are greater than or equal to zero, but (rateMax < rateMin), the rate bounds will remain unset or unchanged and the function will return false.
4.4.9. NormSetTxCacheBounds()
4.4.9.1. Synopsis
#include <normApi.h>
 
 void NormSetTxCacheBounds(NormSessionHandle sessionHandle,
                                 NormSize          sizeMax,
                                 unsigned int      countMin,
-                                unsigned int      countMax);
4.4.9.2. Description
This function sets limits that define the number and total size of pending transmit objects a NORM sender will allow to be enqueued by the application. Setting these bounds to large values means the NORM protocol engine will keep history and state for previously transmitted objects for a larger interval of time (depending upon the transmission rate) when the application is actively enqueueing additional objects in response to NORM_TX_QUEUE_EMPTY notifications. This can allow more time for receivers suffering degraded network conditions to make repair requests before the sender "purges" older objects from its "transmit cache" when new objects are enqueued. A NORM_TX_OBJECT_PURGED notification is issued when the enqueuing of a new transmit object causes the NORM transmit cache to overflow, indicating the NORM sender no longer needs to reference the designated old transmit object and the application is free to release related resources as needed.
The sizeMax parameter sets the maximum total size, in bytes, of enqueued objects allowed, providing the constraints of the countMin and countMax parameters are met. The countMin parameter sets the minimum number of objects the application may enqueue, regardless of the objects' sizes and the sizeMax value. For example, the default sizeMax value is 20 Mbyte and the default countMin is 8, thus allowing the application to always have at least 8 pending objects enqueued for transmission if it desires, even if their total size is greater than 20 Mbyte. Similarly, the countMax parameter sets a ceiling on how many objects may be enqueued, regardless of their total sizes with respect to the sizeMax setting. For example, the default countMax value is 256, which means the application is never allowed to have more than 256 objects pending transmission enqueued, even if they are 256 very small objects. Note that countMax must be greater than or equal to countMin and countMin is recommended to be at least two.
Note that in the case of NORM_OBJECT_FILE objects, some operating systems impose limits (e.g. 256) on how many open files a process may have at one time and it may be appropriate to limit the countMax value accordingly. In other cases, a large countMin or countMax may be desired to allow the NORM sender to act as virtual cache of files or other data available for reliable transmission. Future iterations of the NRL NORM implementation may support alternative NORM receiver "group join" policies that would allow the receivers to request transmission of cached content.
The utility of the NormRequeueObject() API call also depends on the parameters set by this function. The NormRequeueObject() call will only succeed when the given objectHandle corresponds to an object maintained in the NORM senders "transmit cache".
4.4.9.3. Return Values
This function has no return value.
4.4.10. NormSetAutoParity()
4.4.10.1. Synopsis
#include <normApi.h>
+                                unsigned int      countMax);
4.4.9.2. Description
This function sets limits that define the number and total size of pending transmit objects a NORM sender will allow to be enqueued by the application. Setting these bounds to large values means the NORM protocol engine will keep history and state for previously transmitted objects for a larger interval of time (depending upon the transmission rate) when the application is actively enqueueing additional objects in response to NORM_TX_QUEUE_EMPTY notifications. This can allow more time for receivers suffering degraded network conditions to make repair requests before the sender "purges" older objects from its "transmit cache" when new objects are enqueued. A NORM_TX_OBJECT_PURGED notification is issued when the enqueuing of a new transmit object causes the NORM transmit cache to overflow, indicating the NORM sender no longer needs to reference the designated old transmit object and the application is free to release related resources as needed.
The sizeMax parameter sets the maximum total size, in bytes, of enqueued objects allowed, providing the constraints of the countMin and countMax parameters are met. The countMin parameter sets the minimum number of objects the application may enqueue, regardless of the objects' sizes and the sizeMax value. For example, the default sizeMax value is 20 Mbyte and the default countMin is 8, thus allowing the application to always have at least 8 pending objects enqueued for transmission if it desires, even if their total size is greater than 20 Mbyte. Similarly, the countMax parameter sets a ceiling on how many objects may be enqueued, regardless of their total sizes with respect to the sizeMax setting. For example, the default countMax value is 256, which means the application is never allowed to have more than 256 objects pending transmission enqueued, even if they are 256 very small objects. Note that countMax must be greater than or equal to countMin and countMin is recommended to be at least two.
Note that in the case of NORM_OBJECT_FILE objects, some operating systems impose limits (e.g. 256) on how many open files a process may have at one time and it may be appropriate to limit the countMax value accordingly. In other cases, a large countMin or countMax may be desired to allow the NORM sender to act as virtual cache of files or other data available for reliable transmission. Future iterations of the NRL NORM implementation may support alternative NORM receiver "group join" policies that would allow the receivers to request transmission of cached content.
The utility of the NormRequeueObject() API call also depends on the parameters set by this function. The NormRequeueObject() call will only succeed when the given objectHandle corresponds to an object maintained in the NORM senders "transmit cache".
4.4.9.3. Return Values
This function has no return value.
4.4.10. NormSetAutoParity()
4.4.10.1. Synopsis
#include <normApi.h>
 
 void NormSetAutoParity(NormSessionHandle sessionHandle,
-                       unsigned char     autoParity);
4.4.10.2. Description
This function sets the quantity of proactive "auto parity" NORM_DATA messages sent at the end of each FEC coding block. By default (i.e., autoParity = 0), FEC content is sent only in response to repair requests (NACKs) from receivers. But, by setting a non-zero value for autoParity, the sender can automatically accompany each coding block of transport object source data segments ((NORM_DATA messages) with the set number of FEC segments. The number of source symbol messages (segments) per FEC coding block is determined by the blockSize parameter used when NormStartSender() was called for the given sessionHandle.
The use of proactively-sent "auto parity" may eliminate the need for any receiver NACKing to achieve reliable transfer in networks with low packet loss. However, note that the quantity of "auto parity" set adds overhead to transport object transmission. In networks with a predictable level of packet loss and potentially large round-trip times, the use of "auto parity" may allow lower latency in the reliable delivery process. Also, its use may contribute to a smaller amount of receiver feedback as only receivers with exceptional packet loss may need to NACK for additional repair content.
The value of autoParity set must be less than or equal to the numParity parameter set when NormStartSender() was called for the given sessionHandle.
4.4.10.3. Return Values
This function has no return values.
4.4.11. NormGetGrttEstimate()
4.4.11.1. Synopsis
#include <normApi.h>
+                       unsigned char     autoParity);
4.4.10.2. Description
This function sets the quantity of proactive "auto parity" NORM_DATA messages sent at the end of each FEC coding block. By default (i.e., autoParity = 0), FEC content is sent only in response to repair requests (NACKs) from receivers. But, by setting a non-zero value for autoParity, the sender can automatically accompany each coding block of transport object source data segments ((NORM_DATA messages) with the set number of FEC segments. The number of source symbol messages (segments) per FEC coding block is determined by the blockSize parameter used when NormStartSender() was called for the given sessionHandle.
The use of proactively-sent "auto parity" may eliminate the need for any receiver NACKing to achieve reliable transfer in networks with low packet loss. However, note that the quantity of "auto parity" set adds overhead to transport object transmission. In networks with a predictable level of packet loss and potentially large round-trip times, the use of "auto parity" may allow lower latency in the reliable delivery process. Also, its use may contribute to a smaller amount of receiver feedback as only receivers with exceptional packet loss may need to NACK for additional repair content.
The value of autoParity set must be less than or equal to the numParity parameter set when NormStartSender() was called for the given sessionHandle.
4.4.10.3. Return Values
This function has no return values.
4.4.11. NormGetGrttEstimate()
4.4.11.1. Synopsis
#include <normApi.h>
 
-double NormGetGrttEstimate(NormSessionHandle sessionHandle);
4.4.11.2. Description
This function returns the sender's current estimate(in seconds) of group round-trip timing (GRTT) for the given NORM session. This function may be useful for applications to leverage for other purposes the assessment of round-trip timing made by the NORM protocol engine. For example, an application may scale its own timeouts based on connectivity delays among participants in a NORM session. Note that the NORM_GRTT_UPDATED event is posted (see NormGetNextEvent()) by the NORM protocol engine to indicate when changes in the local sender or remote senders' GRTT estimate occurs.
4.4.11.3. Return Values
This function returns the current sender group round-trip timing (GRTT) estimate (in units of seconds). A value of -1.0 is returned if an invalid session value is provided.
4.4.12. NormSetGrttEstimate()
4.4.12.1. Synopsis
#include <normApi.h>
+double NormGetGrttEstimate(NormSessionHandle sessionHandle);
4.4.11.2. Description
This function returns the sender's current estimate(in seconds) of group round-trip timing (GRTT) for the given NORM session. This function may be useful for applications to leverage for other purposes the assessment of round-trip timing made by the NORM protocol engine. For example, an application may scale its own timeouts based on connectivity delays among participants in a NORM session. Note that the NORM_GRTT_UPDATED event is posted (see NormGetNextEvent()) by the NORM protocol engine to indicate when changes in the local sender or remote senders' GRTT estimate occurs.
4.4.11.3. Return Values
This function returns the current sender group round-trip timing (GRTT) estimate (in units of seconds). A value of -1.0 is returned if an invalid session value is provided.
4.4.12. NormSetGrttEstimate()
4.4.12.1. Synopsis
#include <normApi.h>
 
 void NormSetGrttEstimate(NormSessionHandle sessionHandle,
-                         double            grtt);
4.4.12.2. Description
This function sets the sender's estimate of group round-trip time (GRTT) (in units of seconds) for the given NORM sessionHandle. This function is expected to most typically used to initialize the sender's GRTT estimate prior to the call to NormStartSender() when the application has a priori confidence that the default initial GRTT value of 0.5 second is inappropriate. The sender GRTT estimate will be updated during normal sender protocol operation after sender startup or if this call is made while sender operation is active. For experimental purposes (or very special application needs), this API provides a mechanism to control or disable the sender GRTT update process (see NormSetGrttProbingMode()). The grtt value (in seconds) will be limited to the maximum GRTT as set (see NormSetGrttMax()) or the default maximum of 10 seconds.
The sender GRTT is advertised to the receiver group and is used to scale various NORM protocol timers. The default NORM GRTT estimation process dynamically measures round-trip timing to determine an appropriate operating value. An overly-large GRTT estimate can introduce additional latency into the reliability process (resulting in a larger virtual delay*bandwidth product for the protocol and potentially requiring more buffer space to maintain reliability). An overly-small GRTT estimate may introduce the potential for feedback implosion, limiting the scalability of group size.
Also note that the advertised GRTT estimate can also be limited by transmission rate. When the sender transmission rate is low, the GRTT is also governed to a lower bound of the nominal packet transmission interval (i.e., 1/txRate). This maintains the "event driven" nature of the NORM protocol with respect to receiver reception of NORM sender data and commands.
4.4.12.3. Return Values
This function has no return values.
4.4.13. NormSetGrttMax()
4.4.13.1. Synopsis
#include <normApi.h>
+                         double            grtt);
4.4.12.2. Description
This function sets the sender's estimate of group round-trip time (GRTT) (in units of seconds) for the given NORM sessionHandle. This function is expected to most typically used to initialize the sender's GRTT estimate prior to the call to NormStartSender() when the application has a priori confidence that the default initial GRTT value of 0.5 second is inappropriate. The sender GRTT estimate will be updated during normal sender protocol operation after sender startup or if this call is made while sender operation is active. For experimental purposes (or very special application needs), this API provides a mechanism to control or disable the sender GRTT update process (see NormSetGrttProbingMode()). The grtt value (in seconds) will be limited to the maximum GRTT as set (see NormSetGrttMax()) or the default maximum of 10 seconds.
The sender GRTT is advertised to the receiver group and is used to scale various NORM protocol timers. The default NORM GRTT estimation process dynamically measures round-trip timing to determine an appropriate operating value. An overly-large GRTT estimate can introduce additional latency into the reliability process (resulting in a larger virtual delay*bandwidth product for the protocol and potentially requiring more buffer space to maintain reliability). An overly-small GRTT estimate may introduce the potential for feedback implosion, limiting the scalability of group size.
Also note that the advertised GRTT estimate can also be limited by transmission rate. When the sender transmission rate is low, the GRTT is also governed to a lower bound of the nominal packet transmission interval (i.e., 1/txRate). This maintains the "event driven" nature of the NORM protocol with respect to receiver reception of NORM sender data and commands.
4.4.12.3. Return Values
This function has no return values.
4.4.13. NormSetGrttMax()
4.4.13.1. Synopsis
#include <normApi.h>
 
 void NormSetGrttMax(NormSessionHandle sessionHandle,
-                    double            grttMax);
4.4.13.2. Description
This function sets the sender's maximum advertised GRTT value for the given NORM sessionHandle. The grttMax parameter, in units of seconds, limits the GRTT used by the group for scaling protocol timers, regardless of larger measured round trip times. The default maximum for the NRL NORM library is 10 seconds. See the NormSetGrttEstimate() function description for the purpose of the NORM GRTT measurement process.
4.4.13.3. Return Values
This function has no return values.
4.4.14. NormSetGrttProbingMode()
4.4.14.1. Synopsis
#include <normApi.h>
+                    double            grttMax);
4.4.13.2. Description
This function sets the sender's maximum advertised GRTT value for the given NORM sessionHandle. The grttMax parameter, in units of seconds, limits the GRTT used by the group for scaling protocol timers, regardless of larger measured round trip times. The default maximum for the NRL NORM library is 10 seconds. See the NormSetGrttEstimate() function description for the purpose of the NORM GRTT measurement process.
4.4.13.3. Return Values
This function has no return values.
4.4.14. NormSetGrttProbingMode()
4.4.14.1. Synopsis
#include <normApi.h>
 
 void NormSetGrttProbingMode(NormSessionHandle sessionHandle,
-                            NormProbingMode   probingMode);
4.4.14.2. Description
This function sets the sender's mode of probing for round trip timing measurement responses from the receiver set for the given NORM sessionHandle. Possible values for the probingMode parameter include NORM_PROBE_NONE, NORM_PROBE_PASSIVE, and NORM_PROBE_ACTIVE. The default probing mode is NORM_PROBE_ACTIVE. In this mode, the receiver set explicitly acknowledges NORM sender GRTT probes ((NORM_CMD(CC) messages) with NORM_ACK responses that are group-wise suppressed. Note that NORM receivers also will include their response to GRTT probing piggy-backed on any NORM_NACK messages sent in this mode as well to minimize feedback.
Note that the NORM_PROBE_ACTIVE probing mode is required and automatically set when NORM congestion control operation is enabled (see NormSetCongestionControl()). Thus, when congestion control is enabled, the NormSetGrttProbingMode() function has no effect.
If congestion control operation is not enabled, the NORM application may elect to reduce the volume of feedback traffic by setting the probingMode to NORM_PROBE_PASSIVE. Here, the NORM sender still transmits NORM_CMD(CC) probe messages multiplexed with its data transmission, but the receiver set does not explicitly acknowledge these probes. Instead the receiver set is limited to opportunistically piggy-backing responses when NORM_NACK messages are generated. Note that this may, in some cases, introduce some opportunity for bursts of large volume receiver feedback when the sender's estimate of GRTT is incorrect due to the reduced probing feedback. But, in some controlled network environments, this option for passive probing may provide some benefits in reducing protocol overhead.
Finally, the probingMode can be set to NORM_PROBE_NONE to eliminate the overhead (and benefits) of NORM GRTT measurement entirely. In this case, the sender application must explicitly set its estimate of GRTT using the NormSetGrttEstimate() function. See this function for a description of the purpose of the NORM GRTT measurement.
4.4.14.3. Return Values
This function has no return values.
4.4.15. NormSetGrttProbingInterval()
4.4.15.1. Synopsis
#include <normApi.h>
+                            NormProbingMode   probingMode);
4.4.14.2. Description
This function sets the sender's mode of probing for round trip timing measurement responses from the receiver set for the given NORM sessionHandle. Possible values for the probingMode parameter include NORM_PROBE_NONE, NORM_PROBE_PASSIVE, and NORM_PROBE_ACTIVE. The default probing mode is NORM_PROBE_ACTIVE. In this mode, the receiver set explicitly acknowledges NORM sender GRTT probes ((NORM_CMD(CC) messages) with NORM_ACK responses that are group-wise suppressed. Note that NORM receivers also will include their response to GRTT probing piggy-backed on any NORM_NACK messages sent in this mode as well to minimize feedback.
Note that the NORM_PROBE_ACTIVE probing mode is required and automatically set when NORM congestion control operation is enabled (see NormSetCongestionControl()). Thus, when congestion control is enabled, the NormSetGrttProbingMode() function has no effect.
If congestion control operation is not enabled, the NORM application may elect to reduce the volume of feedback traffic by setting the probingMode to NORM_PROBE_PASSIVE. Here, the NORM sender still transmits NORM_CMD(CC) probe messages multiplexed with its data transmission, but the receiver set does not explicitly acknowledge these probes. Instead the receiver set is limited to opportunistically piggy-backing responses when NORM_NACK messages are generated. Note that this may, in some cases, introduce some opportunity for bursts of large volume receiver feedback when the sender's estimate of GRTT is incorrect due to the reduced probing feedback. But, in some controlled network environments, this option for passive probing may provide some benefits in reducing protocol overhead.
Finally, the probingMode can be set to NORM_PROBE_NONE to eliminate the overhead (and benefits) of NORM GRTT measurement entirely. In this case, the sender application must explicitly set its estimate of GRTT using the NormSetGrttEstimate() function. See this function for a description of the purpose of the NORM GRTT measurement.
4.4.14.3. Return Values
This function has no return values.
4.4.15. NormSetGrttProbingInterval()
4.4.15.1. Synopsis
#include <normApi.h>
 
 void NormSetGrttProbingInterval(NormSessionHandle sessionHandle,
                                 double            intervalMin,
-                                double            intervalMax);
4.4.15.2. Description
This function controls the sender GRTT measurement and estimation process for the given NORM sessionHandle. The NORM sender multiplexes periodic transmission of NORM_CMD(CC) messages with its ongoing data transmission or when data transmission is idle. When NORM congestion control operation is enabled, these probes are sent once per RTT of the current limiting receiver (with respect to congestion control rate). In this case the intervalMin and intervalMax parameters (in units of seconds) control the rate at which the sender's estimate of GRTT is updated. At session start, the estimate is updated at intervalMin and the update interval time is doubled until intervalMax is reached. This dynamic allows for a rapid initial estimation of GRTT and a slower, steady-state update of GRTT. When congestion control is disabled and NORM GRTT probing is enabled ((NORM_PROBE_ACTIVE or NORM_PROBE_PASSIVE) the intervalMin and intervalMax values also determine the rate at which NORM_CMD(CC) probes are transmitted by the sender. Thus by setting larger values for intervalMin and intervalMax, the NORM sender application can reduce the overhead of the GRTT measurement process. However, this also reduces the ability of NORM to adapt to changes in GRTT.
The default NORM GRTT intervalMin and intervalMax values, i.e., when this call is not made, are 1.0 second and 30.0 seconds, respectively.
4.4.15.3. Return Values
This function has no return values.
4.4.16. NormSetBackoffFactor()
4.4.16.1. Synopsis
#include <normApi.h>
+                                double            intervalMax);
4.4.15.2. Description
This function controls the sender GRTT measurement and estimation process for the given NORM sessionHandle. The NORM sender multiplexes periodic transmission of NORM_CMD(CC) messages with its ongoing data transmission or when data transmission is idle. When NORM congestion control operation is enabled, these probes are sent once per RTT of the current limiting receiver (with respect to congestion control rate). In this case the intervalMin and intervalMax parameters (in units of seconds) control the rate at which the sender's estimate of GRTT is updated. At session start, the estimate is updated at intervalMin and the update interval time is doubled until intervalMax is reached. This dynamic allows for a rapid initial estimation of GRTT and a slower, steady-state update of GRTT. When congestion control is disabled and NORM GRTT probing is enabled ((NORM_PROBE_ACTIVE or NORM_PROBE_PASSIVE) the intervalMin and intervalMax values also determine the rate at which NORM_CMD(CC) probes are transmitted by the sender. Thus by setting larger values for intervalMin and intervalMax, the NORM sender application can reduce the overhead of the GRTT measurement process. However, this also reduces the ability of NORM to adapt to changes in GRTT.
The default NORM GRTT intervalMin and intervalMax values, i.e., when this call is not made, are 1.0 second and 30.0 seconds, respectively.
4.4.15.3. Return Values
This function has no return values.
4.4.16. NormSetBackoffFactor()
4.4.16.1. Synopsis
#include <normApi.h>
 
 void NormSetBackoffFactor(NormSessionHandle sessionHandle,
-                          double            backoffFactor);
4.4.16.2. Description
This function sets the sender's "backoff factor" for the given sessionHandle. The backoffFactor (in units of seconds) is used to scale various timeouts related to the NACK repair process. The sender advertises its backoffFactor setting to the receiver group in NORM protocol message headers. The default backoffFactor for NORM sessions is 4.0 seconds. The backoffFactor is used to determine the maximum time that receivers may delay NACK transmissions (and other feedback messages) as part of NORM's probabilistic feedback suppression technique. For example, the maximum NACK delay time is backoffFactor*GRTT. Thus a large backoffFactor value introduces latency into the NORM repair process. However, a small backoffFactor value causes feedback suppression to be less effective and increases the risk of feedback implosion for large receiver group sizes.
The default setting of 4.0 provides reasonable feedback suppression for moderate to large group sizes when multicast feedback is possible. The NORM specification recommends a backoffFactor value of 6.0 when unicast feedback is used. However, for demanding applications (with respect to repair latency) when group sizes are modest, a small (even 0.0) backoffFactor value can be specified to reduce the latency of reliable data delivery.
4.4.16.3. Return Values
This function has no return values.
4.4.17. NormSetGroupSize()
4.4.17.1. Synopsis
#include <normApi.h>
+                          double            backoffFactor);
4.4.16.2. Description
This function sets the sender's "backoff factor" for the given sessionHandle. The backoffFactor (in units of seconds) is used to scale various timeouts related to the NACK repair process. The sender advertises its backoffFactor setting to the receiver group in NORM protocol message headers. The default backoffFactor for NORM sessions is 4.0 seconds. The backoffFactor is used to determine the maximum time that receivers may delay NACK transmissions (and other feedback messages) as part of NORM's probabilistic feedback suppression technique. For example, the maximum NACK delay time is backoffFactor*GRTT. Thus a large backoffFactor value introduces latency into the NORM repair process. However, a small backoffFactor value causes feedback suppression to be less effective and increases the risk of feedback implosion for large receiver group sizes.
The default setting of 4.0 provides reasonable feedback suppression for moderate to large group sizes when multicast feedback is possible. The NORM specification recommends a backoffFactor value of 6.0 when unicast feedback is used. However, for demanding applications (with respect to repair latency) when group sizes are modest, a small (even 0.0) backoffFactor value can be specified to reduce the latency of reliable data delivery.
4.4.16.3. Return Values
This function has no return values.
4.4.17. NormSetGroupSize()
4.4.17.1. Synopsis
#include <normApi.h>
 
 void NormSetGroupSize(NormSessionHandle sessionHandle,
-                      unsigned int      groupSize);
4.4.17.2. Description
This function sets the sender's estimate of receiver group size for the given sessionHandle. The sender advertises its groupSize setting to the receiver group in NORM protocol message headers that, in turn, use this information to shape the distribution curve of their random timeouts for the timer-based, probabilistic feedback suppression technique used in the NORM protocol. Note that the groupSize estimate does not have to be very accurate and values within an order of magnitude of the actual group size tend to produce acceptable performance.
The default groupSize setting in NORM is 1,000 and thus can work well for a wide range of actual receiver group sizes. The penalty of an overly large estimate is statistically a little more latency in reliable data delivery with respect to the round trip time and some potential for excess feedback. A substantial underestimation of groupSize increases the risk of feedback implosion. Currently, the NORM implementation does not attempt to automatically measure groupSize from receiver feedback. Applications could add their own mechanism for this (perhaps keeping explicit track of group membership), or it is possible that future versions of the NRL NORM implementation may have some provision for automatic groupSize estimation by the sender based on receiver feedback messages.
4.4.17.3. Return Values
This function has no return values.
4.4.18. NormSetTxRobustFactor()
4.4.18.1. Synopsis
#include <normApi.h>
+                      unsigned int      groupSize);
4.4.17.2. Description
This function sets the sender's estimate of receiver group size for the given sessionHandle. The sender advertises its groupSize setting to the receiver group in NORM protocol message headers that, in turn, use this information to shape the distribution curve of their random timeouts for the timer-based, probabilistic feedback suppression technique used in the NORM protocol. Note that the groupSize estimate does not have to be very accurate and values within an order of magnitude of the actual group size tend to produce acceptable performance.
The default groupSize setting in NORM is 1,000 and thus can work well for a wide range of actual receiver group sizes. The penalty of an overly large estimate is statistically a little more latency in reliable data delivery with respect to the round trip time and some potential for excess feedback. A substantial underestimation of groupSize increases the risk of feedback implosion. Currently, the NORM implementation does not attempt to automatically measure groupSize from receiver feedback. Applications could add their own mechanism for this (perhaps keeping explicit track of group membership), or it is possible that future versions of the NRL NORM implementation may have some provision for automatic groupSize estimation by the sender based on receiver feedback messages.
4.4.17.3. Return Values
This function has no return values.
4.4.18. NormSetTxRobustFactor()
4.4.18.1. Synopsis
#include <normApi.h>
 
 void NormSetTxRobustFactor(NormSessionHandle sessionHandle,
-                           int               txRobustFactor);
4.4.18.2. Description
This routine sets the "robustness factor" used for various NORM sender functions. These functions include the number of repetitions of "robustly-transmitted" NORM sender commands such as NORM_CMD(FLUSH) or similar application-defined commands, and the number of attempts that are made to collect positive acknowledgement from receivers. These commands are distinct from the NORM reliable data transmission process, but play a role in overall NORM protocol operation. The default txRobustFactor value is 20. This relatively large value makes the NORM sender end-of-transmission flushing and positive acknowledgement collection functions somewhat immune from packet loss. However, for some applications, the default value may make the NORM protocol more "chatty" than desired (particularly if flushing is invoked often). In other situations where the network connectivity may be intermittent or extremely lossy, it may be useful to actually increase this value. The default value (20) is expected to provide reasonable operation across a wide range of network conditions and application types. Since this value is not communicated among NORM participants as part of the protocol operation, it is important that applications consistently set this value among all applications participating in a NORM session.
Setting txRobustFactor to a value of -1 makes the redundant transmission of these commands continue indefinitely until completion. For example, with positive acknowledgement collection, the request process will continue indefinitely until all recipients requested acknowledge or the request is canceled by the application. Similarly, flushing commands would be transmitted repeatedly until data transmission is resumed. Typically, setting txRobustFactor to -1 is not recommended.
4.4.18.3. Return Values
This function has no return values.
4.4.19. NormFileEnqueue()
4.4.19.1. Synopsis
#include <normApi.h>
+                           int               txRobustFactor);
4.4.18.2. Description
This routine sets the "robustness factor" used for various NORM sender functions. These functions include the number of repetitions of "robustly-transmitted" NORM sender commands such as NORM_CMD(FLUSH) or similar application-defined commands, and the number of attempts that are made to collect positive acknowledgement from receivers. These commands are distinct from the NORM reliable data transmission process, but play a role in overall NORM protocol operation. The default txRobustFactor value is 20. This relatively large value makes the NORM sender end-of-transmission flushing and positive acknowledgement collection functions somewhat immune from packet loss. However, for some applications, the default value may make the NORM protocol more "chatty" than desired (particularly if flushing is invoked often). In other situations where the network connectivity may be intermittent or extremely lossy, it may be useful to actually increase this value. The default value (20) is expected to provide reasonable operation across a wide range of network conditions and application types. Since this value is not communicated among NORM participants as part of the protocol operation, it is important that applications consistently set this value among all applications participating in a NORM session.
Setting txRobustFactor to a value of -1 makes the redundant transmission of these commands continue indefinitely until completion. For example, with positive acknowledgement collection, the request process will continue indefinitely until all recipients requested acknowledge or the request is canceled by the application. Similarly, flushing commands would be transmitted repeatedly until data transmission is resumed. Typically, setting txRobustFactor to -1 is not recommended.
4.4.18.3. Return Values
This function has no return values.
4.4.19. NormFileEnqueue()
4.4.19.1. Synopsis
#include <normApi.h>
 
 NormObjectHandle NormFileEnqueue(NormSessionHandle      sessionHandle,
                                  const char*            filename,
                                  const char*            infoPtr = NULL,
-                                 unsigned int           infoLen = 0);
4.4.19.2. Description
This function enqueues a file for transmission within the specified NORM sessionHandle. Note that NormStartSender() must have been previously called before files or any transport objects may be enqueued and transmitted. The fileName parameter specifies the path to the file to be transmitted. The NORM protocol engine read and writes directly from/to file system storage for file transport, potentially providing for a very large virtual "repair window" as needed for some applications. While relative paths with respect to the "current working directory" may be used, it is recommended that full paths be used when possible. The optional infoPtr and infoLen parameters are used to associate NORM_INFO content with the sent transport object. The maximum allowed infoLen corresponds to the segmentSize used in the prior call to NormStartSender(). The use and interpretation of the NORM_INFO content is left to the application's discretion. Example usage of NORM_INFO content for NORM_OBJECT_FILE might include file name, creation date, MIME-type or other information which will enable NORM receivers to properly handle the file when reception is complete.
The application is allowed to enqueue multiple transmit objects within in the "transmit cache" bounds (see NormSetTxCacheBounds()) and enqueued objects are transmitted (and repaired as needed) within the limits determined by automated congestion control (see NormSetCongestionControl()) or fixed rate (see NormSetTxRate()) parameters.
4.4.19.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" limits have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.20. NormDataEnqueue()
4.4.20.1. Synopsis
#include <normApi.h>
+                                 unsigned int           infoLen = 0);
4.4.19.2. Description
This function enqueues a file for transmission within the specified NORM sessionHandle. Note that NormStartSender() must have been previously called before files or any transport objects may be enqueued and transmitted. The fileName parameter specifies the path to the file to be transmitted. The NORM protocol engine read and writes directly from/to file system storage for file transport, potentially providing for a very large virtual "repair window" as needed for some applications. While relative paths with respect to the "current working directory" may be used, it is recommended that full paths be used when possible. The optional infoPtr and infoLen parameters are used to associate NORM_INFO content with the sent transport object. The maximum allowed infoLen corresponds to the segmentSize used in the prior call to NormStartSender(). The use and interpretation of the NORM_INFO content is left to the application's discretion. Example usage of NORM_INFO content for NORM_OBJECT_FILE might include file name, creation date, MIME-type or other information which will enable NORM receivers to properly handle the file when reception is complete.
The application is allowed to enqueue multiple transmit objects within in the "transmit cache" bounds (see NormSetTxCacheBounds()) and enqueued objects are transmitted (and repaired as needed) within the limits determined by automated congestion control (see NormSetCongestionControl()) or fixed rate (see NormSetTxRate()) parameters.
4.4.19.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" limits have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.20. NormDataEnqueue()
4.4.20.1. Synopsis
#include <normApi.h>
 
 NormObjectHandle NormDataEnqueue(NormSessionHandle      sessionHandle,
                                  const char*            dataPtr,
                                  unsigned int           dataLen,
                                  const char*            infoPtr = NULL,
-                                 unsigned int           infoLen = 0);
4.4.20.2. Description
This function enqueues a segment of application memory space for transmission within the specified NORM sessionHandle. Note that NormStartSender() MUST have been previously called before files or any transport objects may be enqueued and transmitted. The dataPtr parameter must be a valid pointer to the area of application memory to be transmitted and the dataLen parameter indicates the quantity of data to transmit. The NORM protocol engine read and writes directly from/to application memory space so it is important that the application does not modify (or deallocate) the memory space during the time the NORM protocol engine may access this area. After calling NormDataEnqueue() for a specific application "dataPtr" memory space, the application MUST NOT deallocate (or change the contents of) that memory space until a NORM_TX_OBJECT_PURGED notification is received for the given object or the application itself explicitly cancels the object's transmission (see NormObjectCancel()).
The optional infoPtr and infoLen parameters are used to associate NORM_INFO content with the sent transport object. The maximum allowed infoLen corresponds to the segmentSize used in the prior call to NormStartSender(). The use and interpretation of the NORM_INFO content is left to the application's discretion. Example usage of NORM_INFO content for NORM_OBJECT_DATA might include application-defined data typing or other information which will enable NORM receiver applications to properly interpret the received data when reception is complete. Of course, it is possible that the application may embed such typing information in the object data content itself. This is left to the application's discretion.
The application is allowed to enqueue multiple transmit objects within in the "transmit cache" bounds (see NormSetTxCacheBounds()) and enqueued objects are transmitted (and repaired as needed) within the limits determined by automated congestion control (see NormSetCongestionControl()) or fixed rate (see NormSetTxRate()) parameters.
4.4.20.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" limits have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.21. NormRequeueObject()
4.4.21.1. Synopsis
#include <normApi.h>
+                                 unsigned int           infoLen = 0);
4.4.20.2. Description
This function enqueues a segment of application memory space for transmission within the specified NORM sessionHandle. Note that NormStartSender() MUST have been previously called before files or any transport objects may be enqueued and transmitted. The dataPtr parameter must be a valid pointer to the area of application memory to be transmitted and the dataLen parameter indicates the quantity of data to transmit. The NORM protocol engine read and writes directly from/to application memory space so it is important that the application does not modify (or deallocate) the memory space during the time the NORM protocol engine may access this area. After calling NormDataEnqueue() for a specific application "dataPtr" memory space, the application MUST NOT deallocate (or change the contents of) that memory space until a NORM_TX_OBJECT_PURGED notification is received for the given object or the application itself explicitly cancels the object's transmission (see NormObjectCancel()).
The optional infoPtr and infoLen parameters are used to associate NORM_INFO content with the sent transport object. The maximum allowed infoLen corresponds to the segmentSize used in the prior call to NormStartSender(). The use and interpretation of the NORM_INFO content is left to the application's discretion. Example usage of NORM_INFO content for NORM_OBJECT_DATA might include application-defined data typing or other information which will enable NORM receiver applications to properly interpret the received data when reception is complete. Of course, it is possible that the application may embed such typing information in the object data content itself. This is left to the application's discretion.
The application is allowed to enqueue multiple transmit objects within in the "transmit cache" bounds (see NormSetTxCacheBounds()) and enqueued objects are transmitted (and repaired as needed) within the limits determined by automated congestion control (see NormSetCongestionControl()) or fixed rate (see NormSetTxRate()) parameters.
4.4.20.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" limits have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.21. NormRequeueObject()
4.4.21.1. Synopsis
#include <normApi.h>
 
 boolNormRequeueObject(NormSessionHandle sessionHandle,
-                      NormObjectHandle  objectHandle);
4.4.21.2. Description
This function allows the application to resend (or reset transmission of) a NORM_OBJECT_FILE or NORM_OBJECT_DATA transmit object that was previously enqueued for the indicated sessionHandle. This function is useful for applications sending to silent (non-NACKing) receivers as it enables the receivers to take advantage of multiple retransmissions of objects (including any auto-parity set, see NormSetAutoParity()) to more robustly receive content. The objectHandle parameter must be a valid transmit NormObjectHandle that has not yet been "purged" from the sender's transmit queue. Upon success, the specified object will be fully retransmitted using the same NORM object transport identifier as was used on its initial transmission. This call may be made at any time to restart transmission of a previously-enqueued object, but the NORM_TX_OBJECT_SENT or NORM_TX_FLUSH_COMPLETED notifications can serve as good cues for an appropriate time to resend an object. If multiple objects are re-queued, they will be resent in order of their initial enqueueing.
The transmit cache bounds set by NormSetTxCacheBounds() determine the number of previously-sent objects retained in the sender's transmit queue and that are thus eligible to be requeued for retransmission. An object may be requeued via this call multiple times, but each distinct requeue should be done after an indication such as NORM_TX_OBJECT_SENT or NORM_TX_FLUSH_COMPLETED for the given object. Otherwise, the object will simply be reset from its current transmission point to transmit from the beginning (i.e. restart). Note that the object type NORM_OBJECT_STREAM cannot currently be requeued.
(TBD - should a "numRepeats" parameter be added to this function?)
4.4.21.3. Return Values
A value of true is returned upon success and a value of false is returned upon failure. Possible reasons for failure include an invalid objectHandle was provided (i.e. a non-transmit object or transmit object that has been "purged" from the transmit queue (see NORM_TX_OBJECT_PURGED)) or the provided object was of type NORM_OBJECT_STREAM.
4.4.22. NormStreamOpen()
4.4.22.1. Synopsis
#include <normApi.h>
+                      NormObjectHandle  objectHandle);
4.4.21.2. Description
This function allows the application to resend (or reset transmission of) a NORM_OBJECT_FILE or NORM_OBJECT_DATA transmit object that was previously enqueued for the indicated sessionHandle. This function is useful for applications sending to silent (non-NACKing) receivers as it enables the receivers to take advantage of multiple retransmissions of objects (including any auto-parity set, see NormSetAutoParity()) to more robustly receive content. The objectHandle parameter must be a valid transmit NormObjectHandle that has not yet been "purged" from the sender's transmit queue. Upon success, the specified object will be fully retransmitted using the same NORM object transport identifier as was used on its initial transmission. This call may be made at any time to restart transmission of a previously-enqueued object, but the NORM_TX_OBJECT_SENT or NORM_TX_FLUSH_COMPLETED notifications can serve as good cues for an appropriate time to resend an object. If multiple objects are re-queued, they will be resent in order of their initial enqueueing.
The transmit cache bounds set by NormSetTxCacheBounds() determine the number of previously-sent objects retained in the sender's transmit queue and that are thus eligible to be requeued for retransmission. An object may be requeued via this call multiple times, but each distinct requeue should be done after an indication such as NORM_TX_OBJECT_SENT or NORM_TX_FLUSH_COMPLETED for the given object. Otherwise, the object will simply be reset from its current transmission point to transmit from the beginning (i.e. restart). Note that the object type NORM_OBJECT_STREAM cannot currently be requeued.
(TBD - should a "numRepeats" parameter be added to this function?)
4.4.21.3. Return Values
A value of true is returned upon success and a value of false is returned upon failure. Possible reasons for failure include an invalid objectHandle was provided (i.e. a non-transmit object or transmit object that has been "purged" from the transmit queue (see NORM_TX_OBJECT_PURGED)) or the provided object was of type NORM_OBJECT_STREAM.
4.4.22. NormStreamOpen()
4.4.22.1. Synopsis
#include <normApi.h>
 
 NormObjectHandle NormStreamOpen(NormSessionHandle      sessionHandle,
                                 unsigned int           bufferSize,
                                 const char*            infoPtr = NULL,
-                                unsigned int           infoLen = 0);
4.4.22.2. Description
This function opens a NORM_OBJECT_STREAM sender object and enqueues it for transmission within the indicated sessionHandle. NORM streams provide reliable, in-order delivery of data content written to the stream by the sender application. Note that no data is sent until subsequent calls to NormStreamWrite() are made unless NORM_INFO content is specified for the stream with the infoPtr and infoLen parameters. Example usage of NORM_INFO content for NORM_OBJECT_STREAM might include application-defined data typing or other information which will enable NORM receiver applications to properly interpret the received stream as it is being received. The NORM protocol engine buffers data written to the stream for original transmission and repair transmissions as needed to achieve reliable transfer. The bufferSize parameter controls the size of the stream's "repair window" which limits how far back the sender will "rewind" to satisfy receiver repair requests.
NORM, as a NACK-oriented protocol, currently lacks a mechanism for receivers to explicitly feedback flow control status to the sender unless the sender application specifically leverages NORM's optional positive-acknowledgement (ACK) features. Thus, the bufferSize selection plays an important role in reliable delivery of NORM stream content. Generally, a larger bufferSize value is safer with respect to reliability, but some applications may wish to limit how far the sender rewinds to repair receivers with poor connectivity with respect to the group at large. Such applications may set a smaller bufferSize to avoid the potential for large latency in data delivery (i.e. favor peak delivery latency over full reliability). This may result in breaks in the reliable delivery of stream data to some receivers, but this form of quasi-reliability while limiting latency may be useful for some types of applications (e.g. reliable real-time messaging, video or sensor or media data transport). Note that NORM receivers can quickly, automatically "resync" to the sender after such breaks if the application leverages the application message boundary recovery features of NORM (see NormStreamMarkEom()).
Note that the current implementation of NORM is designed to support only one active stream per session, and that any NORM_OBJECT_DATA or NORM_OBJECT_FILE objects enqueued for transmission will not begin transmission until an active stream is closed. Applications requiring multiple streams or concurrent file/data transfer SHOULD generally instantiate multiple NormSessions as needed.
Note there is no corresponding "open" call for receiver streams. Receiver NORM_OBJECT_STREAMs are automatically opened by the NORM protocol engine and the receiver applications is notified of new streams via the NORM_RX_OBJECT_NEW notification (see NormGetNextEvent()).
4.4.22.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" bounds have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.23. NormStreamClose()
4.4.23.1. Synopsis
#include <normApi.h>
+                                unsigned int           infoLen = 0);
4.4.22.2. Description
This function opens a NORM_OBJECT_STREAM sender object and enqueues it for transmission within the indicated sessionHandle. NORM streams provide reliable, in-order delivery of data content written to the stream by the sender application. Note that no data is sent until subsequent calls to NormStreamWrite() are made unless NORM_INFO content is specified for the stream with the infoPtr and infoLen parameters. Example usage of NORM_INFO content for NORM_OBJECT_STREAM might include application-defined data typing or other information which will enable NORM receiver applications to properly interpret the received stream as it is being received. The NORM protocol engine buffers data written to the stream for original transmission and repair transmissions as needed to achieve reliable transfer. The bufferSize parameter controls the size of the stream's "repair window" which limits how far back the sender will "rewind" to satisfy receiver repair requests.
NORM, as a NACK-oriented protocol, currently lacks a mechanism for receivers to explicitly feedback flow control status to the sender unless the sender application specifically leverages NORM's optional positive-acknowledgement (ACK) features. Thus, the bufferSize selection plays an important role in reliable delivery of NORM stream content. Generally, a larger bufferSize value is safer with respect to reliability, but some applications may wish to limit how far the sender rewinds to repair receivers with poor connectivity with respect to the group at large. Such applications may set a smaller bufferSize to avoid the potential for large latency in data delivery (i.e. favor peak delivery latency over full reliability). This may result in breaks in the reliable delivery of stream data to some receivers, but this form of quasi-reliability while limiting latency may be useful for some types of applications (e.g. reliable real-time messaging, video or sensor or media data transport). Note that NORM receivers can quickly, automatically "resync" to the sender after such breaks if the application leverages the application message boundary recovery features of NORM (see NormStreamMarkEom()).
Note that the current implementation of NORM is designed to support only one active stream per session, and that any NORM_OBJECT_DATA or NORM_OBJECT_FILE objects enqueued for transmission will not begin transmission until an active stream is closed. Applications requiring multiple streams or concurrent file/data transfer SHOULD generally instantiate multiple NormSessions as needed.
Note there is no corresponding "open" call for receiver streams. Receiver NORM_OBJECT_STREAMs are automatically opened by the NORM protocol engine and the receiver applications is notified of new streams via the NORM_RX_OBJECT_NEW notification (see NormGetNextEvent()).
4.4.22.3. Return Values
A NormObjectHandle is returned which the application may use in other NORM API calls as needed. This handle can be considered valid until the application explicitly cancels the object's transmission (see NormObjectCancel()) or a NORM_TX_OBJECT_PURGED event is received for the given object. Note the application may use the NormObjectRetain() method if it wishes to refer to the object after the NORM_TX_OBJECT_PURGED notification. In this case, the application, when finished with the object, must use NormObjectRelease() to free any resources used or else a memory leak condition will result. A value of NORM_OBJECT_INVALID is return upon error. Possible failure conditions include the specified session is not operating as a NormSender, insufficient memory resources were available, or the "transmit cache" bounds have been reached and all previously enqueued NORM transmit objects are pending transmission. Also the call will fail if the infoLen parameter exceeds the local NormSender segmentSize limit.
4.4.23. NormStreamClose()
4.4.23.1. Synopsis
#include <normApi.h>
 
 void NormStreamClose(NormObjectHandle streamHandle,
-                     bool             graceful = false);
4.4.23.2. Description
This function halts transfer of the stream specified by the streamHandle parameter and releases any resources used unless the associated object has been explicitly retained by a call to NormObjectRetain(). No further calls to NormStreamWrite() will be successful for the given streamHandle. The optional graceful parameter, when set to a value of true, may be used by NORM senders to initiate "graceful" shutdown of a transmit stream. In this case, the sender application will be notified that stream has (most likely) completed reliable transfer via the NORM_TX_OBJECT_PURGED notification upon completion of the graceful shutdown process. When the graceful option is set to true, receivers are notified of the stream end via an "stream end" stream control code in NORM_DATA message and will receive a NORM_RX_OBJECT_COMPLETED notification after all received stream content has been read. Otherwise, the stream is immediately terminated, regardless of receiver state. In this case, this function is equivalent to the NormObjectCancel() routine and may be used for sender or receiver streams. So, it is expected this function (NormStreamClose()) will typically be used for transmit streams by NORM senders.
4.4.23.3. Return Values
This function has no return values.
4.4.24. NormStreamWrite()
4.4.24.1. Synopsis
#include <normApi.h>
+                     bool             graceful = false);
4.4.23.2. Description
This function halts transfer of the stream specified by the streamHandle parameter and releases any resources used unless the associated object has been explicitly retained by a call to NormObjectRetain(). No further calls to NormStreamWrite() will be successful for the given streamHandle. The optional graceful parameter, when set to a value of true, may be used by NORM senders to initiate "graceful" shutdown of a transmit stream. In this case, the sender application will be notified that stream has (most likely) completed reliable transfer via the NORM_TX_OBJECT_PURGED notification upon completion of the graceful shutdown process. When the graceful option is set to true, receivers are notified of the stream end via an "stream end" stream control code in NORM_DATA message and will receive a NORM_RX_OBJECT_COMPLETED notification after all received stream content has been read. Otherwise, the stream is immediately terminated, regardless of receiver state. In this case, this function is equivalent to the NormObjectCancel() routine and may be used for sender or receiver streams. So, it is expected this function (NormStreamClose()) will typically be used for transmit streams by NORM senders.
4.4.23.3. Return Values
This function has no return values.
4.4.24. NormStreamWrite()
4.4.24.1. Synopsis
#include <normApi.h>
 
 unsigned int NormStreamWrite(NormObjectHandle streamHandle 
                              const char*      buffer,
-                             unsigned int     numBytes);
4.4.24.2. Description
This function enqueues data for transmission within the NORM stream specified by the streamHandle parameter. The buffer parameter must be a pointer to the data to be enqueued and the numBytes parameter indicates the length of the data content. Note this call does not block and will return immediately. The return value indicates the number of bytes copied from the provided buffer to the internal stream transmission buffers. Calls to this function will be successful unless the stream's transmit buffer space is fully occupied with data pending original or repair transmission if the stream's "push mode" is set to false (default, see NormStreamSetPushEnable() for details). If the stream's "push mode" is set to true, a call to NormStreamWrite() will always result in copying of application data to the stream at the cost of previously enqueued data pending transmission (original or repair) being dropped by the NORM protocol engine. While NORM NACK-based reliability does not provide explicit flow control, there is some degree of implicit flow control in limiting writing new data to the stream against pending repairs. Other flow control strategies are possible using the NormSetWatermark() function.NormSetWatermark() function.
The NormEvent values NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY are posted with the NormEvent::object field set to a valid sender stream NormObjectHandle to indicate when the stream is ready for writing via this function. Note that the NORM_TX_QUEUE_VACANCY event type is posted only after the stream's transmit buffer has been completely filled. Thus, the application must make a call to NormStreamWrite() that copies less than the requested numBytes value (return value less than numBytes) before additional NORM_TX_QUEUE_VACANCY events are posted for the given streamHandle (i.e., the event type is not re-posted until the application has again filled the available stream transmit buffer space). By cueing off of NORM_TX_QUEUE_EMPTY, the application can write its "freshest" available data to the stream, but by cueing off of NORM_TX_QUEUE_VACANCY, an application can keep the NORM protocol engine busiest, to achieve the maximum possible throughput at high data rates.
4.4.24.3. Return Values
This function returns the number of bytes of data successfully enqueued for NORM stream transmission. If the underlying send stream buffer is full, this function may return zero or a value less than the requested numBytes.
4.4.25. NormStreamFlush()
4.4.25.1. Synopsis
#include <normApi.h>
+                             unsigned int     numBytes);
4.4.24.2. Description
This function enqueues data for transmission within the NORM stream specified by the streamHandle parameter. The buffer parameter must be a pointer to the data to be enqueued and the numBytes parameter indicates the length of the data content. Note this call does not block and will return immediately. The return value indicates the number of bytes copied from the provided buffer to the internal stream transmission buffers. Calls to this function will be successful unless the stream's transmit buffer space is fully occupied with data pending original or repair transmission if the stream's "push mode" is set to false (default, see NormStreamSetPushEnable() for details). If the stream's "push mode" is set to true, a call to NormStreamWrite() will always result in copying of application data to the stream at the cost of previously enqueued data pending transmission (original or repair) being dropped by the NORM protocol engine. While NORM NACK-based reliability does not provide explicit flow control, there is some degree of implicit flow control in limiting writing new data to the stream against pending repairs. Other flow control strategies are possible using the NormSetWatermark() function.NormSetWatermark() function.
The NormEvent values NORM_TX_QUEUE_EMPTY and NORM_TX_QUEUE_VACANCY are posted with the NormEvent::object field set to a valid sender stream NormObjectHandle to indicate when the stream is ready for writing via this function. Note that the NORM_TX_QUEUE_VACANCY event type is posted only after the stream's transmit buffer has been completely filled. Thus, the application must make a call to NormStreamWrite() that copies less than the requested numBytes value (return value less than numBytes) before additional NORM_TX_QUEUE_VACANCY events are posted for the given streamHandle (i.e., the event type is not re-posted until the application has again filled the available stream transmit buffer space). By cueing off of NORM_TX_QUEUE_EMPTY, the application can write its "freshest" available data to the stream, but by cueing off of NORM_TX_QUEUE_VACANCY, an application can keep the NORM protocol engine busiest, to achieve the maximum possible throughput at high data rates.
4.4.24.3. Return Values
This function returns the number of bytes of data successfully enqueued for NORM stream transmission. If the underlying send stream buffer is full, this function may return zero or a value less than the requested numBytes.
4.4.25. NormStreamFlush()
4.4.25.1. Synopsis
#include <normApi.h>
 
 void NormStreamFlush(NormObjectHandle streamHandle,
                      bool             eom = false,
-                     NormFlushMode    flushMode = NORM_FLUSH_PASSIVE);
4.4.25.2. Description
This function causes an immediate "flush" of the transmit stream specified by the streamHandle parameter. Normally, unless NormStreamSetAutoFlush() has been invoked, the NORM protocol engine buffers data written to a stream until it has accumulated a sufficient quantity to generate a NORM_DATA message with a full payload (as designated by the segmentSize parameter of the NormStartSender() call). This results in most efficient operation with respect to protocol overhead. However, for some NORM streams, the application may not wish wait for such accumulation when critical data has been written to a stream. The default stream "flush" operation invoked via NormStreamFlush() for flushMode equal to NORM_FLUSH_PASSIVE causes NORM to immediately transmit all enqueued data for the stream (subject to session transmit rate limits), even if this results in NORM_DATA messages with "small" payloads. If the optional flushMode parameter is set to NORM_FLUSH_ACTIVE, the application can achieve reliable delivery of stream content up to the current write position in an even more proactive fashion. In this case, the sender additionally, actively transmits NORM_CMD(FLUSH) messages after any enqueued stream content has been sent. This immediately prompt receivers for repair requests which reduces latency of reliable delivery, but at a cost of some additional messaging. Note any such "active" flush activity will be terminated upon the next subsequent write to the stream. If flushMode is set to NORM_FLUSH_NONE, this call has no effect other than the optional end-of-message marking described here.
The optional eom parameter, when set to true, allows the sender application to mark an end-of-message indication (see NormStreamMarkEom()) for the stream and initiate flushing in a single function call. The end-of-message indication causes NORM to embed the appropriate message start byte offset in the NORM_DATA message generated following a subsequent write to the stream with the NORM_FLAGS_MSG_START flag. This mechanism provide a means for automatic application message boundary recovery when receivers join or re-sync to a sender mid-stream.
Note that frequent flushing, particularly for NORM_FLUSH_ACTIVE operation, may result in more NORM protocol activity than usual, so care must be taken in application design and deployment when scalability to large group sizes is expected.
4.4.25.3. Return Values
This function has no return values.
4.4.26. NormStreamSetAutoFlush()
4.4.26.1. Synopsis
#include <normApi.h>
+                     NormFlushMode    flushMode = NORM_FLUSH_PASSIVE);
4.4.25.2. Description
This function causes an immediate "flush" of the transmit stream specified by the streamHandle parameter. Normally, unless NormStreamSetAutoFlush() has been invoked, the NORM protocol engine buffers data written to a stream until it has accumulated a sufficient quantity to generate a NORM_DATA message with a full payload (as designated by the segmentSize parameter of the NormStartSender() call). This results in most efficient operation with respect to protocol overhead. However, for some NORM streams, the application may not wish wait for such accumulation when critical data has been written to a stream. The default stream "flush" operation invoked via NormStreamFlush() for flushMode equal to NORM_FLUSH_PASSIVE causes NORM to immediately transmit all enqueued data for the stream (subject to session transmit rate limits), even if this results in NORM_DATA messages with "small" payloads. If the optional flushMode parameter is set to NORM_FLUSH_ACTIVE, the application can achieve reliable delivery of stream content up to the current write position in an even more proactive fashion. In this case, the sender additionally, actively transmits NORM_CMD(FLUSH) messages after any enqueued stream content has been sent. This immediately prompt receivers for repair requests which reduces latency of reliable delivery, but at a cost of some additional messaging. Note any such "active" flush activity will be terminated upon the next subsequent write to the stream. If flushMode is set to NORM_FLUSH_NONE, this call has no effect other than the optional end-of-message marking described here.
The optional eom parameter, when set to true, allows the sender application to mark an end-of-message indication (see NormStreamMarkEom()) for the stream and initiate flushing in a single function call. The end-of-message indication causes NORM to embed the appropriate message start byte offset in the NORM_DATA message generated following a subsequent write to the stream with the NORM_FLAGS_MSG_START flag. This mechanism provide a means for automatic application message boundary recovery when receivers join or re-sync to a sender mid-stream.
Note that frequent flushing, particularly for NORM_FLUSH_ACTIVE operation, may result in more NORM protocol activity than usual, so care must be taken in application design and deployment when scalability to large group sizes is expected.
4.4.25.3. Return Values
This function has no return values.
4.4.26. NormStreamSetAutoFlush()
4.4.26.1. Synopsis
#include <normApi.h>
 
 void NormStreamSetAutoFlush(NormObjectHandle streamHandle
-                            NormFlushMode    flushMode);
4.4.26.2. Description
This function sets "automated flushing" for the NORM transmit stream indicated by the streamHandle parameter. By default, a NORM transmit stream is "flushed" only when explicitly requested by the application (see NormStreamFlush()). However, to simplify programming, the NORM API allows that automated flushing be enabled such that the "flush" operation occurs every time the full requested buffer provided to a NormStreamWrite() call is successfully enqueued. This may be appropriate for messaging applications where the provided buffers corresponds to an application messages requiring immediate, full transmission. This may make the NORM protocol perhaps more "chatty" than its typical "bulk transfer" form of operation, but can provide a useful capability for some applications.
Possible values for the flushMode parameter include NORM_FLUSH_NONE, NORM_FLUSH_PASSIVE, and NORM_FLUSH_ACTIVE. The default setting for a NORM stream is NORM_FLUSH_NONE where no flushing occurs unless explicitly requested via NormStreamFlush(). By setting the automated flushMode to NORM_FLUSH_PASSIVE, the only action taken is to immediately transmit any data that has been written to the stream, even if "runt" NORM_DATA messages (with payloads less than the NormSender segmentSize parameter) are generated as a result. If NORM_FLUSH_ACTIVE is specified, the automated flushing operation is further augmented with the additional transmission of NORM_CMD(FLUSH) messages to proactively excite the receiver group for repair requests.
4.4.26.3. Return Values
This function has no return values.
4.4.27. NormStreamSetPushEnable()
4.4.27.1. Synopsis
#include <normApi.h>
+                            NormFlushMode    flushMode);
4.4.26.2. Description
This function sets "automated flushing" for the NORM transmit stream indicated by the streamHandle parameter. By default, a NORM transmit stream is "flushed" only when explicitly requested by the application (see NormStreamFlush()). However, to simplify programming, the NORM API allows that automated flushing be enabled such that the "flush" operation occurs every time the full requested buffer provided to a NormStreamWrite() call is successfully enqueued. This may be appropriate for messaging applications where the provided buffers corresponds to an application messages requiring immediate, full transmission. This may make the NORM protocol perhaps more "chatty" than its typical "bulk transfer" form of operation, but can provide a useful capability for some applications.
Possible values for the flushMode parameter include NORM_FLUSH_NONE, NORM_FLUSH_PASSIVE, and NORM_FLUSH_ACTIVE. The default setting for a NORM stream is NORM_FLUSH_NONE where no flushing occurs unless explicitly requested via NormStreamFlush(). By setting the automated flushMode to NORM_FLUSH_PASSIVE, the only action taken is to immediately transmit any data that has been written to the stream, even if "runt" NORM_DATA messages (with payloads less than the NormSender segmentSize parameter) are generated as a result. If NORM_FLUSH_ACTIVE is specified, the automated flushing operation is further augmented with the additional transmission of NORM_CMD(FLUSH) messages to proactively excite the receiver group for repair requests.
4.4.26.3. Return Values
This function has no return values.
4.4.27. NormStreamSetPushEnable()
4.4.27.1. Synopsis
#include <normApi.h>
 
 void NormStreamSetPushEnable(NormObjectHandle streamHandle,
-                             bool             pushEnable);
4.4.27.2. Description
This function controls how the NORM API behaves when the application attempts to enqueue new stream data for transmission when the associated stream's transmit buffer is fully occupied with data pending original or repair transmission. By default (pushEnable = false), a call to NormStreamWrite() will return a zero value under this condition, indicating it was unable to enqueue the new data. However, if pushEnable is set to true for a given streamHandle, the NORM protocol engine will discard the oldest buffered stream data (even if it is pending repair transmission or has never been transmitted) as needed to enqueue the new data. Thus a call to NormStreamWrite() will never fail to copy data. This behavior may be desirable for applications where it is more important to quickly delivery new data than to reliably deliver older data written to a stream. The default behavior for a newly opened stream corresponds to pushEnable equals false. This limits the rate to which an application can write new data to the stream to the current transmission rate and status of the reliable repair process.
4.4.27.3. Return Values
This function has no return values.
4.4.28. NormStreamHasVacancy()
4.4.28.1. Synopsis
#include <normApi.h>
+                             bool             pushEnable);
4.4.27.2. Description
This function controls how the NORM API behaves when the application attempts to enqueue new stream data for transmission when the associated stream's transmit buffer is fully occupied with data pending original or repair transmission. By default (pushEnable = false), a call to NormStreamWrite() will return a zero value under this condition, indicating it was unable to enqueue the new data. However, if pushEnable is set to true for a given streamHandle, the NORM protocol engine will discard the oldest buffered stream data (even if it is pending repair transmission or has never been transmitted) as needed to enqueue the new data. Thus a call to NormStreamWrite() will never fail to copy data. This behavior may be desirable for applications where it is more important to quickly delivery new data than to reliably deliver older data written to a stream. The default behavior for a newly opened stream corresponds to pushEnable equals false. This limits the rate to which an application can write new data to the stream to the current transmission rate and status of the reliable repair process.
4.4.27.3. Return Values
This function has no return values.
4.4.28. NormStreamHasVacancy()
4.4.28.1. Synopsis
#include <normApi.h>
 
-bool NormStreamHasVacancy(NormObjectHandle streamHandle);
4.4.28.2. Description
This function can be used to query whether the transmit stream, specified by the streamHandle parameter, has buffer space available so that the application may successfully make a call to NormStreamWrite(). Normally, a call to NormStreamWrite() itself can be used to make this determination, but this function can be useful when "push mode" has been enabled (see the description of the NormStreamSetPushEnable() function) and the application wants to avoid overwriting data previously written to the stream that has not yet been transmitted. Note that when "push mode" is enabled, a call to NormStreamWrite() will always succeed, overwriting previously-enqueued data if necessary. Normally, this function will return true after a NORM_TX_QUEUE_VACANCY notification has been received for a given NORM stream object.
4.4.28.3. Return Values
This function returns a value of true when there is transmit buffer space to which the application may write and false otherwise.
4.4.29. NormStreamMarkEom()
4.4.29.1. Synopsis
#include <normApi.h>
+bool NormStreamHasVacancy(NormObjectHandle streamHandle);
4.4.28.2. Description
This function can be used to query whether the transmit stream, specified by the streamHandle parameter, has buffer space available so that the application may successfully make a call to NormStreamWrite(). Normally, a call to NormStreamWrite() itself can be used to make this determination, but this function can be useful when "push mode" has been enabled (see the description of the NormStreamSetPushEnable() function) and the application wants to avoid overwriting data previously written to the stream that has not yet been transmitted. Note that when "push mode" is enabled, a call to NormStreamWrite() will always succeed, overwriting previously-enqueued data if necessary. Normally, this function will return true after a NORM_TX_QUEUE_VACANCY notification has been received for a given NORM stream object.
4.4.28.3. Return Values
This function returns a value of true when there is transmit buffer space to which the application may write and false otherwise.
4.4.29. NormStreamMarkEom()
4.4.29.1. Synopsis
#include <normApi.h>
 
-void NormStreamMarkEom(NormObjectHandle streamHandle);
4.4.29.2. Description
This function allows the application to indicate to the NORM protocol engine that the last data successfully written to the stream indicated by streamHandle corresponded to the end of an application-defined message boundary. The end-of-message indication given here will cause the NORM protocol engine to embed the appropriate message start byte offset in the NORM_DATA message generated that contains the data for the subsequent application call to NormStreamWrite(). Use of this end-of-message marking enables NORM receivers to automatically re-sync to application-defined message boundaries when joining (or re-joining) a NORM session already in progress.
4.4.29.3. Return Values
This function has no return values.
4.4.30. NormSetWatermark()
4.4.30.1. Synopsis
#include <normApi.h>
+void NormStreamMarkEom(NormObjectHandle streamHandle);
4.4.29.2. Description
This function allows the application to indicate to the NORM protocol engine that the last data successfully written to the stream indicated by streamHandle corresponded to the end of an application-defined message boundary. The end-of-message indication given here will cause the NORM protocol engine to embed the appropriate message start byte offset in the NORM_DATA message generated that contains the data for the subsequent application call to NormStreamWrite(). Use of this end-of-message marking enables NORM receivers to automatically re-sync to application-defined message boundaries when joining (or re-joining) a NORM session already in progress.
4.4.29.3. Return Values
This function has no return values.
4.4.30. NormSetWatermark()
4.4.30.1. Synopsis
#include <normApi.h>
 
 bool NormSetWatermark(NormSessionHandle sessionHandle,
                       NormObjectHandle  objectHandle, 
-                      bool              overrideFlush = true);
4.4.30.2. Description
This function specifies a "watermark" transmission point at which NORM sender protocol operation should perform a flushing process and/or positive acknowledgment collection for a given sessionHandle. For NORM_OBJECT_FILE and NORM_OBJECT_DATA transmissions, the positive acknowledgement collection will begin when the specified object has been completely transmitted. The objectHandle parameter must be a valid handle to a previously-created sender object (see NormFileEnqueue(), NormDataEnqueue(), or NormStreamOpen()). For NORM_OBJECT_STREAM transmission, the positive acknowledgment collection begins immediately, using the current position (offset of most recent data written) of the sender stream as a reference.
The functions NormAddAckingNode() and NormRemoveAckingNode() are used to manage the list of NormNodeId values corresponding to NORM receivers that are expected to explicitly acknowledge the watermark flushing messages transmitted by the sender. Note that the NormNodeId NORM_NODE_NONE may be included in the list. Inclusion of NORM_NODE_NONE forces the watermark flushing process to proceed through a full NORM_ROBUST_FACTOR number of rounds before completing, prompting any receivers that have not completed reliable reception to the given watermark point to NACK for any repair needs. If NACKs occur, the flushing process is reset and repeated until completing with no NACKs for data through the given watermark transmission point are received. Thus, even without explicit positive acknowledgment, the sender can use this process (by adding NORM_NODE_NONE to the session's list of "acking nodes") for a high level of assurance that the receiver set is "happy" (completed reliable data reception) through the given object (or stream transmission point).
The event NORM_TX_WATERMARK_COMPLETED is posted for the given session when the flushing process or positive acknowledgment collection has completed. The process completes as soon as all listed receivers have responded unless NORM_NODE_NONE is included in the "acking node" list. The sender application may use the function NormGetAckingStatus() to determine the degree of success of the flushing process in general or for individual NormNodeId values.
The flushing is conducted concurrently with ongoing data transmission and does not impede the progress of reliable data transfer. Thus the sender may still enqueue NormObjects for transmission (or write to the existing stream) and the positive acknowledgement collection and flushing procedure will be multiplexed with the ongoing data transmission. However, the sender application may wish to defer from or limit itself in sending more data until a NORM_TX_WATERMARK_COMPLETED event is received for the given session. This provides a form of sender->receiver(s) flow control which does not exist in NORM's default protocol operation. If a subsequent call is made to NormSetWatermark() before the current acknowledgement request has completed, the pending acknowledgment request is canceled and the new one begins.
The optional overrideFlush parameter, when set to true, causes the watermark acknowledgment process that is established with this function call to potentially fully supersede the usual NORM end-of-transmission flushing process that occurs. If overrideFlush is set and the "watermark" transmission point corresponds to the last transmission that will result from data enqueued by the sending application, then the watermark flush completion will terminate the usual flushing process. I.e., if positive acknowledgement of watermark is received from the full "acking node list", then no further flushing is conducted. Thus, the overrideFlush parameter should only be set when the "acking node list" contains a complete list of intended recipients. This is useful for small receiver groups (or unicast operation) to reduce the "chattiness" of NORM's default end-of-transmission flush process. Note that once the watermark flush is completed and further data enqueued and transmitted, the normal default end-of-transmission behavior will be resumed unless another "watermark" is set with overrideFlush enabled. Thus, as long as new watermarks are established by successive use of this API call, this effectively "morphs" NORM into a protocol driven by positive acknowledgement behavior.
4.4.30.3. Return Values
The function returns true upon successful establishment of the watermark point. The function may return false upon failure.
4.4.31. NormCancelWatermark()
4.4.31.1. Synopsis
#include <normApi.h>
+                      bool              overrideFlush = true);
4.4.30.2. Description
This function specifies a "watermark" transmission point at which NORM sender protocol operation should perform a flushing process and/or positive acknowledgment collection for a given sessionHandle. For NORM_OBJECT_FILE and NORM_OBJECT_DATA transmissions, the positive acknowledgement collection will begin when the specified object has been completely transmitted. The objectHandle parameter must be a valid handle to a previously-created sender object (see NormFileEnqueue(), NormDataEnqueue(), or NormStreamOpen()). For NORM_OBJECT_STREAM transmission, the positive acknowledgment collection begins immediately, using the current position (offset of most recent data written) of the sender stream as a reference.
The functions NormAddAckingNode() and NormRemoveAckingNode() are used to manage the list of NormNodeId values corresponding to NORM receivers that are expected to explicitly acknowledge the watermark flushing messages transmitted by the sender. Note that the NormNodeId NORM_NODE_NONE may be included in the list. Inclusion of NORM_NODE_NONE forces the watermark flushing process to proceed through a full NORM_ROBUST_FACTOR number of rounds before completing, prompting any receivers that have not completed reliable reception to the given watermark point to NACK for any repair needs. If NACKs occur, the flushing process is reset and repeated until completing with no NACKs for data through the given watermark transmission point are received. Thus, even without explicit positive acknowledgment, the sender can use this process (by adding NORM_NODE_NONE to the session's list of "acking nodes") for a high level of assurance that the receiver set is "happy" (completed reliable data reception) through the given object (or stream transmission point).
The event NORM_TX_WATERMARK_COMPLETED is posted for the given session when the flushing process or positive acknowledgment collection has completed. The process completes as soon as all listed receivers have responded unless NORM_NODE_NONE is included in the "acking node" list. The sender application may use the function NormGetAckingStatus() to determine the degree of success of the flushing process in general or for individual NormNodeId values.
The flushing is conducted concurrently with ongoing data transmission and does not impede the progress of reliable data transfer. Thus the sender may still enqueue NormObjects for transmission (or write to the existing stream) and the positive acknowledgement collection and flushing procedure will be multiplexed with the ongoing data transmission. However, the sender application may wish to defer from or limit itself in sending more data until a NORM_TX_WATERMARK_COMPLETED event is received for the given session. This provides a form of sender->receiver(s) flow control which does not exist in NORM's default protocol operation. If a subsequent call is made to NormSetWatermark() before the current acknowledgement request has completed, the pending acknowledgment request is canceled and the new one begins.
The optional overrideFlush parameter, when set to true, causes the watermark acknowledgment process that is established with this function call to potentially fully supersede the usual NORM end-of-transmission flushing process that occurs. If overrideFlush is set and the "watermark" transmission point corresponds to the last transmission that will result from data enqueued by the sending application, then the watermark flush completion will terminate the usual flushing process. I.e., if positive acknowledgement of watermark is received from the full "acking node list", then no further flushing is conducted. Thus, the overrideFlush parameter should only be set when the "acking node list" contains a complete list of intended recipients. This is useful for small receiver groups (or unicast operation) to reduce the "chattiness" of NORM's default end-of-transmission flush process. Note that once the watermark flush is completed and further data enqueued and transmitted, the normal default end-of-transmission behavior will be resumed unless another "watermark" is set with overrideFlush enabled. Thus, as long as new watermarks are established by successive use of this API call, this effectively "morphs" NORM into a protocol driven by positive acknowledgement behavior.
4.4.30.3. Return Values
The function returns true upon successful establishment of the watermark point. The function may return false upon failure.
4.4.31. NormCancelWatermark()
4.4.31.1. Synopsis
#include <normApi.h>
 
-bool NormCancelWatermark(NormSessionHandle sessionHandle);
4.4.31.2. Description
This function cancels any "watermark" acknowledgement request that was previously set via the NormSetWatermark() function for the given sessionHandle. The status of any NORM receivers that may have acknowledged prior to cancellation can be queried using the NormGetAckingStatus() function even after NormCancelWatermark() is called. Typically, applications should wait until a event has been posted, but in some special cases it may be useful to terminate the acknowledgement collection process early.
4.4.31.3. Return Values
The function has no return values.
4.4.32. NormAddAckingNode()
4.4.32.1. Synopsis
#include <normApi.h>
+bool NormCancelWatermark(NormSessionHandle sessionHandle);
4.4.31.2. Description
This function cancels any "watermark" acknowledgement request that was previously set via the NormSetWatermark() function for the given sessionHandle. The status of any NORM receivers that may have acknowledged prior to cancellation can be queried using the NormGetAckingStatus() function even after NormCancelWatermark() is called. Typically, applications should wait until a event has been posted, but in some special cases it may be useful to terminate the acknowledgement collection process early.
4.4.31.3. Return Values
The function has no return values.
4.4.32. NormAddAckingNode()
4.4.32.1. Synopsis
#include <normApi.h>
 
 bool NormAddAckingNode(NormSessionHandle sessionHandle,
-                       NormNodeId        nodeId);
4.4.32.2. Description
When this function is called, the specified nodeId is added to the list of NormNodeId values (i.e., the "acking node" list) used when NORM sender operation performs positive acknowledgement (ACK) collection for the specified sessionHandle. The optional NORM positive acknowledgement collection occurs when a specified transmission point (see NormSetWatermark()) is reached or for specialized protocol actions such as positively-acknowledged application-defined commands.
Additionally the special value of nodeId equal to NORM_NODE_NONE may be set to force the watermark flushing process through a full NORM_ROBUST_FACTOR number of rounds regardless of actual acking nodes. Otherwise the flushing process is terminated when all of the nodes in the acking node list have responded. Setting a "watermark" and forcing a full flush process with the special NORM_NODE_NONE value of nodeId enables the resultant NORM_TX_WATERMARK_COMPLETED notification to be a indicator with high (but not absolute) assurance that the receiver set has completed reliable reception of content up through the "watermark" transmission point. This provides a form of scalable reliable multicast "flow control" for NACK-based operation without requiring explicit positive acknowledgement from all group members. Note that the use of the NORM_NODE_NONE value may be mixed with other nodeId for a mix of positive acknowledgement collection from some nodes and a measure of assurance for the group at large.
4.4.32.3. Return Values
The function returns true upon success and false upon failure. The only failure condition is that insufficient memory resources were available. If a specific nodeId is added more than once, this has no effect.
4.4.33. NormRemoveAckingNode()
4.4.33.1. Synopsis
#include <normApi.h>
+                       NormNodeId        nodeId);
4.4.32.2. Description
When this function is called, the specified nodeId is added to the list of NormNodeId values (i.e., the "acking node" list) used when NORM sender operation performs positive acknowledgement (ACK) collection for the specified sessionHandle. The optional NORM positive acknowledgement collection occurs when a specified transmission point (see NormSetWatermark()) is reached or for specialized protocol actions such as positively-acknowledged application-defined commands.
Additionally the special value of nodeId equal to NORM_NODE_NONE may be set to force the watermark flushing process through a full NORM_ROBUST_FACTOR number of rounds regardless of actual acking nodes. Otherwise the flushing process is terminated when all of the nodes in the acking node list have responded. Setting a "watermark" and forcing a full flush process with the special NORM_NODE_NONE value of nodeId enables the resultant NORM_TX_WATERMARK_COMPLETED notification to be a indicator with high (but not absolute) assurance that the receiver set has completed reliable reception of content up through the "watermark" transmission point. This provides a form of scalable reliable multicast "flow control" for NACK-based operation without requiring explicit positive acknowledgement from all group members. Note that the use of the NORM_NODE_NONE value may be mixed with other nodeId for a mix of positive acknowledgement collection from some nodes and a measure of assurance for the group at large.
4.4.32.3. Return Values
The function returns true upon success and false upon failure. The only failure condition is that insufficient memory resources were available. If a specific nodeId is added more than once, this has no effect.
4.4.33. NormRemoveAckingNode()
4.4.33.1. Synopsis
#include <normApi.h>
 
 void NormRemoveAckingNode(NormSessionHandle sessionHandle,
-                          NormNodeId        nodeId);
4.4.33.2. Description
This function deletes the specified nodeId from the list of NormNodeId values used when NORM sender operation performs positive acknowledgement (ACK) collection for the specified sessionHandle. Note that if the special nodeId value "NORM_NODE_NONE" has been added to the list, it too must be explicitly removed to change the watermark flushing behavior if desired.
4.4.33.3. Return Values
The function has no return values.
4.4.34. NormGetNextAckingNode()
4.4.34.1. Synopsis
#include <normApi.h>
+                          NormNodeId        nodeId);
4.4.33.2. Description
This function deletes the specified nodeId from the list of NormNodeId values used when NORM sender operation performs positive acknowledgement (ACK) collection for the specified sessionHandle. Note that if the special nodeId value "NORM_NODE_NONE" has been added to the list, it too must be explicitly removed to change the watermark flushing behavior if desired.
4.4.33.3. Return Values
The function has no return values.
4.4.34. NormGetNextAckingNode()
4.4.34.1. Synopsis
#include <normApi.h>
 
-NormNodeId NormGetNextAckingNode(NormSessionHandle session, bool reset = false);
4.4.34.2. Description
This function iteratively retrieves the NormNodeId values in the "acking node" list maintained by a NORM sender (see NormAddAckingNode()) for the given sessionHandle. If the optional reset parameter is set to a value of true, the first NormNodeId value in the list is returned and subsequent calls to NormGetNextAckingNode()with the reset parameter set to its default false value will iteratively return the remaining NormNodeId values contained in the list. A value of NORM_NODE_NONE is returned when the end of the list is reached.
The "acking node" list is populated with application calls to NormAddAckingNode() or auto-populated if that optional behavior is set for a NormSession. Note that this API does not enable the programmer to check if the NORM_NODE_NONE value itself is contained in the list. The programmer should keep track of that by other means.
The following code example illustrates how to use this call to iterate through the set of stored NormNodeId values and get the current "acking status" for each:
NormNodeId nextNodeId = NormGetNextAckingNode(session, true);
+NormNodeId NormGetNextAckingNode(NormSessionHandle session, bool reset = false);
4.4.34.2. Description
This function iteratively retrieves the NormNodeId values in the "acking node" list maintained by a NORM sender (see NormAddAckingNode()) for the given sessionHandle. If the optional reset parameter is set to a value of true, the first NormNodeId value in the list is returned and subsequent calls to NormGetNextAckingNode()with the reset parameter set to its default false value will iteratively return the remaining NormNodeId values contained in the list. A value of NORM_NODE_NONE is returned when the end of the list is reached.
The "acking node" list is populated with application calls to NormAddAckingNode() or auto-populated if that optional behavior is set for a NormSession. Note that this API does not enable the programmer to check if the NORM_NODE_NONE value itself is contained in the list. The programmer should keep track of that by other means.
The following code example illustrates how to use this call to iterate through the set of stored NormNodeId values and get the current "acking status" for each:
NormNodeId nextNodeId = NormGetNextAckingNode(session, true);
 while(NORM_NODE_NONE != nextNodeId)
 {
     NormAckingStatus ackingStatus = NormGetAckingStatus(session, nextNodeId);
     printf("ACKing node id = %lu acking status = %d\n", nextNodeId, (int)ackingStatus);
-}
As noted below, a good time to check the acking status of the receiver set is after a NORM_TX_WATERMARK_COMPLETED notification has occurred.
4.4.34.3. Return Values
The function iteratively returns NormNodeId values from the given session's local sender "acking node" list. A value of NORM_NODE_NONE is returned when the end of the list is reached.
4.4.35. NormGetAckingStatus()
4.4.35.1. Synopsis
#include <normApi.h>
+}
As noted below, a good time to check the acking status of the receiver set is after a NORM_TX_WATERMARK_COMPLETED notification has occurred.
4.4.34.3. Return Values
The function iteratively returns NormNodeId values from the given session's local sender "acking node" list. A value of NORM_NODE_NONE is returned when the end of the list is reached.
4.4.35. NormGetAckingStatus()
4.4.35.1. Synopsis
#include <normApi.h>
 
 NormAckingStatus NormGetAckingStatus(NormSessionHandle sessionHandle,
-                                     NormNodeId        nodeId = NORM_NODE_ANY);
4.4.35.2. Description
This function queries the status of the watermark flushing process and/or positive acknowledgment collection initiated by a prior call to NormSetWatermark() for the given sessionHandle. In general, it is expected that applications will invoke this function after the corresponding NORM_TX_WATERMARK_COMPLETED event has been posted. Setting the default parameter value nodeId = NORM_NODE_ANY returns a "status" indication for the overall process. Also, individual nodeId values may be queried using the NormNodeId values of receivers that were included in previous calls to NormAddAckingNode() to populate the sender session's acking node list.
If the flushing/acknowledgment process is being used for application flow control, the sender application may wish to reset the watermark and flushing process (using NormSetWatermark()) if the response indicates that some nodes have failed to respond. However, note that the flushing/acknowledgment process itself does elicit NACKs from receivers as needed and is interrupted and reset by any repair response that occurs. Thus, even by the time the flushing process has completed (and NORM_TX_WATERMARK_COMPLETED is posted) once, this is an indication that the NORM protocol has made a valiant attempt to deliver the content. Resetting the watermark process can increase robustness, but it may be in vain to repeat this process multiple times when likely network connectivity has been lost or expected receivers have failed (dropped out, shut down, etc).
4.4.35.3. Return Values
Possible return values include:
NORM_ACK_INVALID
The given sessionHandle is invalid or the given nodeId is not in the sender's acking list.
NORM_ACK_FAILURE
The positive acknowledgement collection process did not receive acknowledgment from every listed receiver (nodeId = NORM_NODE_ANY) or the identified nodeId did not respond.
NORM_ACK_PENDING
The flushing process at large has not yet completed (nodeId = NORM_NODE_ANY) or the given individual nodeId is still being queried for response.
NORM_ACK_SUCCESS
All receivers (nodeId = NORM_NODE_ANY) responded with positive acknowledgement or the given specific nodeId did acknowledge.
4.4.36. NormSendCommand()
4.4.36.1. Synopsis
#include <normApi.h>
+                                     NormNodeId        nodeId = NORM_NODE_ANY);
4.4.35.2. Description
This function queries the status of the watermark flushing process and/or positive acknowledgment collection initiated by a prior call to NormSetWatermark() for the given sessionHandle. In general, it is expected that applications will invoke this function after the corresponding NORM_TX_WATERMARK_COMPLETED event has been posted. Setting the default parameter value nodeId = NORM_NODE_ANY returns a "status" indication for the overall process. Also, individual nodeId values may be queried using the NormNodeId values of receivers that were included in previous calls to NormAddAckingNode() to populate the sender session's acking node list.
If the flushing/acknowledgment process is being used for application flow control, the sender application may wish to reset the watermark and flushing process (using NormSetWatermark()) if the response indicates that some nodes have failed to respond. However, note that the flushing/acknowledgment process itself does elicit NACKs from receivers as needed and is interrupted and reset by any repair response that occurs. Thus, even by the time the flushing process has completed (and NORM_TX_WATERMARK_COMPLETED is posted) once, this is an indication that the NORM protocol has made a valiant attempt to deliver the content. Resetting the watermark process can increase robustness, but it may be in vain to repeat this process multiple times when likely network connectivity has been lost or expected receivers have failed (dropped out, shut down, etc).
4.4.35.3. Return Values
Possible return values include:
NORM_ACK_INVALID
The given sessionHandle is invalid or the given nodeId is not in the sender's acking list.
NORM_ACK_FAILURE
The positive acknowledgement collection process did not receive acknowledgment from every listed receiver (nodeId = NORM_NODE_ANY) or the identified nodeId did not respond.
NORM_ACK_PENDING
The flushing process at large has not yet completed (nodeId = NORM_NODE_ANY) or the given individual nodeId is still being queried for response.
NORM_ACK_SUCCESS
All receivers (nodeId = NORM_NODE_ANY) responded with positive acknowledgement or the given specific nodeId did acknowledge.
4.4.36. NormSendCommand()
4.4.36.1. Synopsis
#include <normApi.h>
 
 bool NormSendCommand(NormSessionHandle session,
                      const char*       cmdBuffer,
                      unsigned int      cmdLength,
-                     bool              robust = false); 
4.4.36.2. Description
This function enqueues a NORM application-defined command for transmission. The cmdBuffer parameter points to a buffer containing the application-defined command content that will be contained in the NORM_CMD(APPLICATION) message payload. The cmdLength indicates the length of this content (in bytes) and MUST be less than or equal to the segmentLength value for the given session (see NormStartSender()). The NORM command transmission will be multiplexed with any NORM data transmission. The command is NOT delivered reliably, but can be optionally transmitted with repetition (once per GRTT) according to the NORM transmit robust factor value (see NormSetTxRobustFactor()) for the given session if the robust parameter is set to true. The command transmission is subject to any congestion control or set rate limits for the NORM session. Once the command has been transmitted (with repetition if robust is set to true), a NORM_TX_CMD_SENT notification is issued. An application can only enqueue a single command at a time (i.e. the NORM_TX_CMD_SENT notification must occur before another command can be sent). The NormCancelCommand() call is available to terminate command transmission if needed. Note that if a rapid succession of commands are sent it is possible that the commands may be delivered to the receivers out-of-order. Also, when repetition is requested (i.e., if robust is set to true) the receiver may receive duplicate copies of the same command. It is up to the application to provide any needed mechanism for detecting and/or filtering duplicate command reception.
The application-defined command feature allows NORM applications to provide some out-of-band (with respect to reliable data delivery) signaling to support session management or other functions. The reception of these "atomic" commands is relatively stateless (as compared to reliable data delivery) and thus it is possible for many senders within a group to send commands without extreme resource burden on receivers (i.e. other participants). Again, this "light-weight" signaling mechanism may be used to provide ancillary communication for the group. In the future, an additional API mechanism will be provided to support application-defined positive acknowledgement requests that could conceivably be used to help guarantee command delivery if desired.
4.4.36.3. Return Values
The function returns true upon success. The function may fail, returning false, if the session is not set for sender operation (see NormStartSender()), the cmdLength exceeds the configured session segmentLength, or a previously-enqueued command has not yet been sent.
4.4.37. NormCancelCommand()
4.4.37.1. Synopsis
#include <normApi.h>
+                     bool              robust = false); 
4.4.36.2. Description
This function enqueues a NORM application-defined command for transmission. The cmdBuffer parameter points to a buffer containing the application-defined command content that will be contained in the NORM_CMD(APPLICATION) message payload. The cmdLength indicates the length of this content (in bytes) and MUST be less than or equal to the segmentLength value for the given session (see NormStartSender()). The NORM command transmission will be multiplexed with any NORM data transmission. The command is NOT delivered reliably, but can be optionally transmitted with repetition (once per GRTT) according to the NORM transmit robust factor value (see NormSetTxRobustFactor()) for the given session if the robust parameter is set to true. The command transmission is subject to any congestion control or set rate limits for the NORM session. Once the command has been transmitted (with repetition if robust is set to true), a NORM_TX_CMD_SENT notification is issued. An application can only enqueue a single command at a time (i.e. the NORM_TX_CMD_SENT notification must occur before another command can be sent). The NormCancelCommand() call is available to terminate command transmission if needed. Note that if a rapid succession of commands are sent it is possible that the commands may be delivered to the receivers out-of-order. Also, when repetition is requested (i.e., if robust is set to true) the receiver may receive duplicate copies of the same command. It is up to the application to provide any needed mechanism for detecting and/or filtering duplicate command reception.
The application-defined command feature allows NORM applications to provide some out-of-band (with respect to reliable data delivery) signaling to support session management or other functions. The reception of these "atomic" commands is relatively stateless (as compared to reliable data delivery) and thus it is possible for many senders within a group to send commands without extreme resource burden on receivers (i.e. other participants). Again, this "light-weight" signaling mechanism may be used to provide ancillary communication for the group. In the future, an additional API mechanism will be provided to support application-defined positive acknowledgement requests that could conceivably be used to help guarantee command delivery if desired.
4.4.36.3. Return Values
The function returns true upon success. The function may fail, returning false, if the session is not set for sender operation (see NormStartSender()), the cmdLength exceeds the configured session segmentLength, or a previously-enqueued command has not yet been sent.
4.4.37. NormCancelCommand()
4.4.37.1. Synopsis
#include <normApi.h>
 
-void NormCancelCommand(NormSessionHandle session);
4.4.37.2. Description
This function terminates any pending NORM_CMD(APPLICATION) transmission that was previously initiated with the NormSendCommand() call. Due to the asynchrony of the NORM protocol engine thread and the application, it is possible that the command may have been already sent but the NormCancelCommand() call will ensure a NORM_TX_CMD_SENT notification is not issued for that prior command.
The application-defined command feature allows NORM applications to provide some out-of-band (with respect to reliable data delivery) signaling to support session management or other functions. The reception of these "atomic" commands is relatively stateless (as compared to reliable data delivery) and thus it is possible for many senders within a group to send commands without extreme resource burden on receivers (i.e. other participants). Again, this "light-weight" signaling mechanism may be used to provide ancillary communication for the group. In the future, an additional API mechanism will be provided to support application-defined positive acknowledgement requests that could conceivably be used to help guarantee command delivery if desired.
4.4.37.3. Return Values
The function has not return value.
4.5. NORM Receiver Functions
4.5.1. NormStartReceiver()
4.5.1.1. Synopsis
#include <normApi.h>
+void NormCancelCommand(NormSessionHandle session);
4.4.37.2. Description
This function terminates any pending NORM_CMD(APPLICATION) transmission that was previously initiated with the NormSendCommand() call. Due to the asynchrony of the NORM protocol engine thread and the application, it is possible that the command may have been already sent but the NormCancelCommand() call will ensure a NORM_TX_CMD_SENT notification is not issued for that prior command.
The application-defined command feature allows NORM applications to provide some out-of-band (with respect to reliable data delivery) signaling to support session management or other functions. The reception of these "atomic" commands is relatively stateless (as compared to reliable data delivery) and thus it is possible for many senders within a group to send commands without extreme resource burden on receivers (i.e. other participants). Again, this "light-weight" signaling mechanism may be used to provide ancillary communication for the group. In the future, an additional API mechanism will be provided to support application-defined positive acknowledgement requests that could conceivably be used to help guarantee command delivery if desired.
4.4.37.3. Return Values
The function has not return value.
4.5. NORM Receiver Functions
4.5.1. NormStartReceiver()
4.5.1.1. Synopsis
#include <normApi.h>
 
 bool NormStartReceiver(NormSessionHandle sessionHandle,
-                       unsigned long     bufferSpace);
4.5.1.2. Description
This function initiates the application's participation as a receiver within the NormSession identified by the sessionHandle parameter. The NORM protocol engine will begin providing the application with receiver-related NormEvent notifications, and, unless NormSetSilentReceiver(true) is invoked, respond to senders with appropriate protocol messages. The bufferSpace parameter is used to set a limit on the amount of bufferSpace allocated by the receiver per active NormSender within the session. The appropriate bufferSpace to use is a function of expected network delay*bandwidth product and packet loss characteristics. A discussion of trade-offs associated with NORM transmit and receiver buffer space selection is provided later in this document. An insufficient bufferSpace allocation will result in potentially inefficient protocol operation, even though reliable operation may be maintained. In some cases of a large delay*bandwidth product and/or severe packet loss, a small bufferSpace allocation (coupled with the lack of explicit flow control in NORM) may result in the receiver "re-syncing" to the sender, resulting in "outages" in the reliable transmissions from a sender (this is analogous to a TCP connection timeout failure).
4.5.1.3. Return Values
A value of true is returned upon success and false upon failure. The reasons failure may occur include limited system resources or that the network sockets required for session communication failed to open or properly configure.
4.5.2. NormStopReceiver()
4.5.2.1. Synopsis
#include <normApi.h>
+                       unsigned long     bufferSpace);
4.5.1.2. Description
This function initiates the application's participation as a receiver within the NormSession identified by the sessionHandle parameter. The NORM protocol engine will begin providing the application with receiver-related NormEvent notifications, and, unless NormSetSilentReceiver(true) is invoked, respond to senders with appropriate protocol messages. The bufferSpace parameter is used to set a limit on the amount of bufferSpace allocated by the receiver per active NormSender within the session. The appropriate bufferSpace to use is a function of expected network delay*bandwidth product and packet loss characteristics. A discussion of trade-offs associated with NORM transmit and receiver buffer space selection is provided later in this document. An insufficient bufferSpace allocation will result in potentially inefficient protocol operation, even though reliable operation may be maintained. In some cases of a large delay*bandwidth product and/or severe packet loss, a small bufferSpace allocation (coupled with the lack of explicit flow control in NORM) may result in the receiver "re-syncing" to the sender, resulting in "outages" in the reliable transmissions from a sender (this is analogous to a TCP connection timeout failure).
4.5.1.3. Return Values
A value of true is returned upon success and false upon failure. The reasons failure may occur include limited system resources or that the network sockets required for session communication failed to open or properly configure.
4.5.2. NormStopReceiver()
4.5.2.1. Synopsis
#include <normApi.h>
 
 void NormStopReceiver(NormSessionHandle sessionHandle,
-                      unsigned int      gracePeriod = 0);
4.5.2.2. Description
This function ends the application's participation as a receiver in the NormSession specified by the session parameter. By default, all receiver-related protocol activity is immediately halted and all receiver-related resources are freed (except for those which have been specifically retained (see NormNodeRetain() and NormObjectRetain()). However, and optional gracePeriod parameter is provided to allow the receiver an opportunity to inform the group of its intention. This is applicable when the local receiving NormNode has been designated as an active congestion control representative (i.e. current limiting receiver (CLR) or potential limiting receiver (PLR)). In this case, a non-zero gracePeriod value provides an opportunity for the receiver to respond to the applicable sender(s) so the sender will not expect further congestion control feedback from this receiver. The gracePeriod integer value is used as a multiplier with the largest sender GRTT to determine the actual time period for which the receiver will linger in the group to provide such feedback (i.e. "graceTime" = (gracePeriod * GRTT)). During this time, the receiver will not generate any requests for repair or other protocol actions aside from response to applicable congestion control probes. When the receiver is removed from the current list of receivers in the sender congestion control probe messages (or the gracePeriod expires, whichever comes first), the NORM protocol engine will post a NORM_LOCAL_RECEIVER_CLOSED event for the applicable session, and related resources are then freed.
4.5.2.3. Return Values
This function has no return values.
4.5.3. NormSetRxCacheLimit()
4.5.3.1. Synopsis
#include <normApi.h>
+                      unsigned int      gracePeriod = 0);
4.5.2.2. Description
This function ends the application's participation as a receiver in the NormSession specified by the session parameter. By default, all receiver-related protocol activity is immediately halted and all receiver-related resources are freed (except for those which have been specifically retained (see NormNodeRetain() and NormObjectRetain()). However, and optional gracePeriod parameter is provided to allow the receiver an opportunity to inform the group of its intention. This is applicable when the local receiving NormNode has been designated as an active congestion control representative (i.e. current limiting receiver (CLR) or potential limiting receiver (PLR)). In this case, a non-zero gracePeriod value provides an opportunity for the receiver to respond to the applicable sender(s) so the sender will not expect further congestion control feedback from this receiver. The gracePeriod integer value is used as a multiplier with the largest sender GRTT to determine the actual time period for which the receiver will linger in the group to provide such feedback (i.e. "graceTime" = (gracePeriod * GRTT)). During this time, the receiver will not generate any requests for repair or other protocol actions aside from response to applicable congestion control probes. When the receiver is removed from the current list of receivers in the sender congestion control probe messages (or the gracePeriod expires, whichever comes first), the NORM protocol engine will post a NORM_LOCAL_RECEIVER_CLOSED event for the applicable session, and related resources are then freed.
4.5.2.3. Return Values
This function has no return values.
4.5.3. NormSetRxCacheLimit()
4.5.3.1. Synopsis
#include <normApi.h>
 
 void NormSetRxCacheLimit(NormSessionHandle sessionHandle,
-                         unsigned short    countMax);
4.5.3.2. Description
This function sets a limit on the number of outstanding (pending) NormObjects for which a receiver will keep state on a per-sender basis. Note that the value countMax sets a limit on the maximum consecutive range of objects that can be pending. The default value (when this function is not called) of countMax is 256. This should be sufficient for most bulk transfer usage, but if small object sizes (e.g. small NORM_OBJECT_DATA messages) are being transferred, it may be useful to raise this limit in cases of high transmission speeds or large <delay*bandwidth, loss> network conditions. If the receiver cache limit is set too small (i.e. for high speed or large <delay*bandwidth> operation), the receiver may not maintain reliable reception or impact session throughput when flow control is enabled (see NormSetFlowControl()). The maximum allowed value of countMax is 16,384.
If this value is changed after NormStartReceiver() has been called, it will only affect newly-detected remote senders, so this should typically be called before NORM receiver operation is initiated.
4.5.3.3. Return Values
This function has no return value.
4.5.4. NormSetRxSocketBuffer()
4.5.4.1. Synopsis
#include <normApi.h>
+                         unsigned short    countMax);
4.5.3.2. Description
This function sets a limit on the number of outstanding (pending) NormObjects for which a receiver will keep state on a per-sender basis. Note that the value countMax sets a limit on the maximum consecutive range of objects that can be pending. The default value (when this function is not called) of countMax is 256. This should be sufficient for most bulk transfer usage, but if small object sizes (e.g. small NORM_OBJECT_DATA messages) are being transferred, it may be useful to raise this limit in cases of high transmission speeds or large <delay*bandwidth, loss> network conditions. If the receiver cache limit is set too small (i.e. for high speed or large <delay*bandwidth> operation), the receiver may not maintain reliable reception or impact session throughput when flow control is enabled (see NormSetFlowControl()). The maximum allowed value of countMax is 16,384.
If this value is changed after NormStartReceiver() has been called, it will only affect newly-detected remote senders, so this should typically be called before NORM receiver operation is initiated.
4.5.3.3. Return Values
This function has no return value.
4.5.4. NormSetRxSocketBuffer()
4.5.4.1. Synopsis
#include <normApi.h>
 
 bool NormSetRxSocketBuffer(NormSessionHandle sessionHandle,
-                           unsigned int      bufferSize);
4.5.4.2. Description
This function allows the application to set an alternative, non-default buffer size for the UDP socket used by the specified NORM sessionHandle for packet reception. This may be necessary for high speed NORM sessions where the UDP receive socket buffer becomes a bottleneck when the NORM protocol engine (which is running as a user-space process) doesn't get to service the receive socket quickly enough resulting in packet loss when the socket buffer overflows. The bufferSize parameter specifies the socket buffer size in bytes. Different operating systems and sometimes system configurations allow different ranges of socket buffer sizes to be set. Note that a call to NormStartReceiver() (or NormStartSender()) must have been previously made for this call to succeed (i.e., the socket must be already open).
4.5.4.3. Return Values
This function returns true upon success and false upon failure. Possible reasons for failure include, 1) the specified session is not valid, 2) that NORM "receiver" (or "sender") operation has not yet been started for the given session, or 3) an invalid bufferSize specification was given.
4.5.5. NormSetSilentReceiver()
4.5.5.1. Synopsis
#include <normApi.h>
+                           unsigned int      bufferSize);
4.5.4.2. Description
This function allows the application to set an alternative, non-default buffer size for the UDP socket used by the specified NORM sessionHandle for packet reception. This may be necessary for high speed NORM sessions where the UDP receive socket buffer becomes a bottleneck when the NORM protocol engine (which is running as a user-space process) doesn't get to service the receive socket quickly enough resulting in packet loss when the socket buffer overflows. The bufferSize parameter specifies the socket buffer size in bytes. Different operating systems and sometimes system configurations allow different ranges of socket buffer sizes to be set. Note that a call to NormStartReceiver() (or NormStartSender()) must have been previously made for this call to succeed (i.e., the socket must be already open).
4.5.4.3. Return Values
This function returns true upon success and false upon failure. Possible reasons for failure include, 1) the specified session is not valid, 2) that NORM "receiver" (or "sender") operation has not yet been started for the given session, or 3) an invalid bufferSize specification was given.
4.5.5. NormSetSilentReceiver()
4.5.5.1. Synopsis
#include <normApi.h>
 
 void NormSetSilentReceiver(NormSessionHandle sessionHandle,
                            bool              silent,
-                           INT32             maxDelay = -1);
4.5.5.2. Description
This function provides the option to configure a NORM receiver application as a "silent receiver". This mode of receiver operation dictates that the host does not generate any protocol messages while operating as a receiver within the specified sessionHandle. Setting the silent parameter to true enables silent receiver operation while setting it to false results in normal protocol operation where feedback is provided as needed for reliability and protocol operation. Silent receivers are dependent upon proactive FEC transmission (see NormSetAutoParity()) or using repair information requested by other non-silent receivers within the group to achieve reliable transfers.
The optional maxDelay parameter is most applicable for reception of the NORM_OBJECT_STREAM type. The default value of maxDelay = -1 corresponds to normal operation where source data segments for incompletely-received FEC coding blocks (or transport objects) are passed to the application only when imposed buffer constraints (either the NORM_OBJECT_STREAM buffer size (see NormStreamOpen()) or the FEC receive buffer limit (see NormStartReceiver()) require. Thus, the default behavior (maxDelay = -1), causes the receiver to buffer received FEC code blocks for as long as possible (within buffer constraints as newer data arrives) before allowing the application to read the data. Hence, the receive latency (delay) can be quite long depending upon buffer size settings, transmission rate, etc. When the maxDelay parameter is set to a non-negative value, the value determines the maximum number of FEC coding blocks (according to a NORM sender's current transmit position) the receiver will cache an incompletely-received FEC block before giving the application the (incomplete) set of received source segments. For example, a value of maxDelay = 0 will provide the receive application with any data from the previous FEC block as soon as a subsequent FEC block is begun reception. However, this provide no protection against the possibility of out-of-order delivery of packets by the network. Therefore, if lower latency operation is desired when using silent receivers, a minimum maxDelay value of 1 is recommended. For NORM_OBJECT_FILE and NORM_OBJECT_DATA, the only impact of a non-negative maxDelay value is that previous transport objects will be immediately aborted when subsequent object begin reception. Thus, it is not usually recommended to apply a non-negative maxDelay value when NORM_OBJECT_STREAM is not being used.
4.5.5.3. Return Values
This function has no return values.
4.5.6. NormSetDefaultUnicastNack()
4.5.6.1. Synopsis
#include <normApi.h>
+                           INT32             maxDelay = -1);
4.5.5.2. Description
This function provides the option to configure a NORM receiver application as a "silent receiver". This mode of receiver operation dictates that the host does not generate any protocol messages while operating as a receiver within the specified sessionHandle. Setting the silent parameter to true enables silent receiver operation while setting it to false results in normal protocol operation where feedback is provided as needed for reliability and protocol operation. Silent receivers are dependent upon proactive FEC transmission (see NormSetAutoParity()) or using repair information requested by other non-silent receivers within the group to achieve reliable transfers.
The optional maxDelay parameter is most applicable for reception of the NORM_OBJECT_STREAM type. The default value of maxDelay = -1 corresponds to normal operation where source data segments for incompletely-received FEC coding blocks (or transport objects) are passed to the application only when imposed buffer constraints (either the NORM_OBJECT_STREAM buffer size (see NormStreamOpen()) or the FEC receive buffer limit (see NormStartReceiver()) require. Thus, the default behavior (maxDelay = -1), causes the receiver to buffer received FEC code blocks for as long as possible (within buffer constraints as newer data arrives) before allowing the application to read the data. Hence, the receive latency (delay) can be quite long depending upon buffer size settings, transmission rate, etc. When the maxDelay parameter is set to a non-negative value, the value determines the maximum number of FEC coding blocks (according to a NORM sender's current transmit position) the receiver will cache an incompletely-received FEC block before giving the application the (incomplete) set of received source segments. For example, a value of maxDelay = 0 will provide the receive application with any data from the previous FEC block as soon as a subsequent FEC block is begun reception. However, this provide no protection against the possibility of out-of-order delivery of packets by the network. Therefore, if lower latency operation is desired when using silent receivers, a minimum maxDelay value of 1 is recommended. For NORM_OBJECT_FILE and NORM_OBJECT_DATA, the only impact of a non-negative maxDelay value is that previous transport objects will be immediately aborted when subsequent object begin reception. Thus, it is not usually recommended to apply a non-negative maxDelay value when NORM_OBJECT_STREAM is not being used.
4.5.5.3. Return Values
This function has no return values.
4.5.6. NormSetDefaultUnicastNack()
4.5.6.1. Synopsis
#include <normApi.h>
 
 void NormSetDefaultUnicastNack(NormSessionHandle sessionHandle,
-                               bool              enable);
4.5.6.2. Description
This function controls the default behavior determining the destination of receiver feedback messages generated while participating in the session. If the enable parameter is true, "unicast NACKing" is enabled for new remote senders while it is disabled for state equal to false. The NACKing behavior for current remote senders is not affected. When "unicast NACKing" is disabled (default), NACK messages are sent to the session address (usually a multicast address) and port, but when "unicast NACKing" is enabled, receiver feedback messages are sent to the unicast address (and port) based on the source address of sender messages received. For unicast NORM sessions, it is recommended that "unicast NACKing" be enabled. Note that receiver feedback messages subject to potential "unicast NACKing" include NACK-messages as well as some ACK messages such as congestion control feedback. Explicitly solicited ACK messages, such as those used to satisfy sender watermark acknowledgement requests (see NormSetWatermark()) are always unicast to the applicable sender. (TBD - provide API option so that all messages are multicast.) The default session-wide behavior for unicast NACKing can be overridden via the NormNodeSetUnicastNack() function for individual remote senders.
4.5.6.3. Return Values
This function has no return values.
4.5.7. NormNodeSetUnicastNack()
4.5.7.1. Synopsis
#include <normApi.h>
+                               bool              enable);
4.5.6.2. Description
This function controls the default behavior determining the destination of receiver feedback messages generated while participating in the session. If the enable parameter is true, "unicast NACKing" is enabled for new remote senders while it is disabled for state equal to false. The NACKing behavior for current remote senders is not affected. When "unicast NACKing" is disabled (default), NACK messages are sent to the session address (usually a multicast address) and port, but when "unicast NACKing" is enabled, receiver feedback messages are sent to the unicast address (and port) based on the source address of sender messages received. For unicast NORM sessions, it is recommended that "unicast NACKing" be enabled. Note that receiver feedback messages subject to potential "unicast NACKing" include NACK-messages as well as some ACK messages such as congestion control feedback. Explicitly solicited ACK messages, such as those used to satisfy sender watermark acknowledgement requests (see NormSetWatermark()) are always unicast to the applicable sender. (TBD - provide API option so that all messages are multicast.) The default session-wide behavior for unicast NACKing can be overridden via the NormNodeSetUnicastNack() function for individual remote senders.
4.5.6.3. Return Values
This function has no return values.
4.5.7. NormNodeSetUnicastNack()
4.5.7.1. Synopsis
#include <normApi.h>
 
 void NormNodeSetUnicastNack(NormNodeHandle senderNode,
-                            bool           enable);
4.5.7.2. Description
This function controls the destination address of receiver feedback messages generated in response to a specific remote NORM sender corresponding to the senderNode parameter. If enable is true, "unicast NACKing" is enabled while it is disabled for enable equal to false. See the description of NormSetDefaultUnicastNack() for details on "unicast NACKing" behavior.
4.5.7.3. Return Values
This function has no return values.
4.5.8. NormSetDefaultSyncPolicy()
4.5.8.1. Synopsis
#include <normApi.h>
+                            bool           enable);
4.5.7.2. Description
This function controls the destination address of receiver feedback messages generated in response to a specific remote NORM sender corresponding to the senderNode parameter. If enable is true, "unicast NACKing" is enabled while it is disabled for enable equal to false. See the description of NormSetDefaultUnicastNack() for details on "unicast NACKing" behavior.
4.5.7.3. Return Values
This function has no return values.
4.5.8. NormSetDefaultSyncPolicy()
4.5.8.1. Synopsis
#include <normApi.h>
 
 void NormSetDefaultSyncPolicy(NormSessionHandle sessionHandle,
-                              NormSyncPolicy   syncPolicy);
4.5.8.2. Description
This function sets the default "synchronization policy" used when beginning (or restarting) reception of objects from a remote sender (i.e., "syncing" to the sender) for the given sessionHandle. The "synchronization policy" is the behavior observed by the receiver with regards to what objects it attempts to reliably receive (via transmissions of Negative Acknowledgements to the sender(s) or group as needed). There are currently two synchronization policy types defined:
NORM_SYNC_CURRENT
Attempt reception of "current" and new objects only. (default)
NORM_SYNC_ALL
Attempt recovery and reliable reception of all objects held in sender transmit object cache and newer objects.
The behavior of a receiver using the default NORM_SYNC_CURRENT policy is to attempt reliable reception only for the first received "current" and newer (with respect to the ordinal NORM object transport identifiers used by the protocol) objects from a given NORM sender. Additionally, reliable reception is only attempted when receiving a non-repair NORM_DATA message (or optionally a NORM positive acknowledgement request) from the first forward error correction (FEC) encoding block of the given object. This somewhat conservative synchronization behavior helps prevent late-joining (or otherwise "flaky" with respect to group membership) receivers from penalizing other receivers in the group by causing the sender to "rewind" and transmit older object content to satisfy the late joiner instead of moving forward with transmission of new content. For large scale, loosely-organized multicast applications, the NORM_SYNC_CURRENT policy is typically recommended.
The NORM_SYNC_ALL policy allows newly joining receivers much more aggressive behavior as they will immediately NACK for all objects from the "current" object backwards through the entire range of objects set by the NormSetRxCacheLimit() function. This behavior depends upon the sender to issue an appropriate NORM_CMD(SQUELCH) response (if applicable) to align (i.e. "synchronize") the new receiver with its current transmit object cache (similar to a "repair window"). This synchronization behavior may be useful for unicast uses of NORM or other applications where the group membership is more carefully managed and it is important that all content (including older content) is received. Note that the sender transmit cache bounds (see NormSetTxCacheBounds()) and the receiver receive cache limit (see NormSetRxCacheLimit()) settings will limit how far back onto the sender transmission history that transmitted objects can be reliably recovered from the "current" transmission point when the receiver begins reception.
When this function is not invoked, the NORM_SYNC_CURRENT behavior is observed as the default receiver synchronization policy. This call SHOULD be made before NormStartReceiver() is called.
4.5.8.3. Return Values
This function has no return values.
4.5.9. NormSetDefaultNackingMode()
4.5.9.1. Synopsis
#include <normApi.h>
+                              NormSyncPolicy   syncPolicy);
4.5.8.2. Description
This function sets the default "synchronization policy" used when beginning (or restarting) reception of objects from a remote sender (i.e., "syncing" to the sender) for the given sessionHandle. The "synchronization policy" is the behavior observed by the receiver with regards to what objects it attempts to reliably receive (via transmissions of Negative Acknowledgements to the sender(s) or group as needed). There are currently two synchronization policy types defined:
NORM_SYNC_CURRENT
Attempt reception of "current" and new objects only. (default)
NORM_SYNC_ALL
Attempt recovery and reliable reception of all objects held in sender transmit object cache and newer objects.
The behavior of a receiver using the default NORM_SYNC_CURRENT policy is to attempt reliable reception only for the first received "current" and newer (with respect to the ordinal NORM object transport identifiers used by the protocol) objects from a given NORM sender. Additionally, reliable reception is only attempted when receiving a non-repair NORM_DATA message (or optionally a NORM positive acknowledgement request) from the first forward error correction (FEC) encoding block of the given object. This somewhat conservative synchronization behavior helps prevent late-joining (or otherwise "flaky" with respect to group membership) receivers from penalizing other receivers in the group by causing the sender to "rewind" and transmit older object content to satisfy the late joiner instead of moving forward with transmission of new content. For large scale, loosely-organized multicast applications, the NORM_SYNC_CURRENT policy is typically recommended.
The NORM_SYNC_ALL policy allows newly joining receivers much more aggressive behavior as they will immediately NACK for all objects from the "current" object backwards through the entire range of objects set by the NormSetRxCacheLimit() function. This behavior depends upon the sender to issue an appropriate NORM_CMD(SQUELCH) response (if applicable) to align (i.e. "synchronize") the new receiver with its current transmit object cache (similar to a "repair window"). This synchronization behavior may be useful for unicast uses of NORM or other applications where the group membership is more carefully managed and it is important that all content (including older content) is received. Note that the sender transmit cache bounds (see NormSetTxCacheBounds()) and the receiver receive cache limit (see NormSetRxCacheLimit()) settings will limit how far back onto the sender transmission history that transmitted objects can be reliably recovered from the "current" transmission point when the receiver begins reception.
When this function is not invoked, the NORM_SYNC_CURRENT behavior is observed as the default receiver synchronization policy. This call SHOULD be made before NormStartReceiver() is called.
4.5.8.3. Return Values
This function has no return values.
4.5.9. NormSetDefaultNackingMode()
4.5.9.1. Synopsis
#include <normApi.h>
 
 void NormSetDefaultNackingMode(NormSessionHandle sessionHandle,
-                               NormNackingMode   nackingMode);
4.5.9.2. Description
This function sets the default "nacking mode" used when receiving objects for the given sessionHandle. This allows the receiver application some control of its degree of participation in the repair process. By limiting receivers to only request repair of objects in which they are really interested in receiving, some overall savings in unnecessary network loading might be realized for some applications and users. Available nacking modes include:
NORM_NACK_NONE
Do not transmit any repair requests for the newly received object.
NORM_NACK_INFO_ONLY
Transmit repair requests for NORM_INFO content only as needed.
NORM_NACK_NORMAL
Transmit repair requests for entire object as needed.
This function specifies the default behavior with respect to any new sender or object. This default behavior may be overridden for specific sender nodes or specific object using NormNodeSetNackingMode() or NormObjectSetNackingMode(), respectively. The receiver application's use of NORM_NACK_NONE essentially disables a guarantee of reliable reception, although the receiver may still take advantage of sender repair transmissions in response to other receivers' requests. When the sender provides, NORM_INFO content for transmitted objects, the NORM_NACK_INFO_ONLY mode may allows the receiver to reliably receive object context information from which it may choose to "upgrade" its nackingMode for the specific object via the NormObjectSetNackingMode() call. Similarly, the receiver may changes its default nackingMode with respect to specific senders via the NormNodeSetNackingMode() call. The default "default nackingMode" when this call is not made is NORM_NACK_NORMAL.
4.5.9.3. Return Values
This function has no return values.
4.5.10. NormNodeSetNackingMode()
4.5.10.1. Synopsis
#include <normApi.h>
+                               NormNackingMode   nackingMode);
4.5.9.2. Description
This function sets the default "nacking mode" used when receiving objects for the given sessionHandle. This allows the receiver application some control of its degree of participation in the repair process. By limiting receivers to only request repair of objects in which they are really interested in receiving, some overall savings in unnecessary network loading might be realized for some applications and users. Available nacking modes include:
NORM_NACK_NONE
Do not transmit any repair requests for the newly received object.
NORM_NACK_INFO_ONLY
Transmit repair requests for NORM_INFO content only as needed.
NORM_NACK_NORMAL
Transmit repair requests for entire object as needed.
This function specifies the default behavior with respect to any new sender or object. This default behavior may be overridden for specific sender nodes or specific object using NormNodeSetNackingMode() or NormObjectSetNackingMode(), respectively. The receiver application's use of NORM_NACK_NONE essentially disables a guarantee of reliable reception, although the receiver may still take advantage of sender repair transmissions in response to other receivers' requests. When the sender provides, NORM_INFO content for transmitted objects, the NORM_NACK_INFO_ONLY mode may allows the receiver to reliably receive object context information from which it may choose to "upgrade" its nackingMode for the specific object via the NormObjectSetNackingMode() call. Similarly, the receiver may changes its default nackingMode with respect to specific senders via the NormNodeSetNackingMode() call. The default "default nackingMode" when this call is not made is NORM_NACK_NORMAL.
4.5.9.3. Return Values
This function has no return values.
4.5.10. NormNodeSetNackingMode()
4.5.10.1. Synopsis
#include <normApi.h>
 
 void NormNodeSetNackingMode(NormNodeHandle  nodeHandle,
-                            NormNackingMode nackingMode);
4.5.10.2. Description
This function sets the default "nacking mode" used for receiving new objects from a specific sender as identified by the nodeHandle parameter. This overrides the default nackingMode set for the receive session. See NormSetDefaultNackingMode() for a description of possible nackingMode parameter values and other related information.
4.5.10.3. Return Values
This function has no return values.
4.5.11. NormObjectSetNackingMode()
4.5.11.1. Synopsis
#include <normApi.h>
+                            NormNackingMode nackingMode);
4.5.10.2. Description
This function sets the default "nacking mode" used for receiving new objects from a specific sender as identified by the nodeHandle parameter. This overrides the default nackingMode set for the receive session. See NormSetDefaultNackingMode() for a description of possible nackingMode parameter values and other related information.
4.5.10.3. Return Values
This function has no return values.
4.5.11. NormObjectSetNackingMode()
4.5.11.1. Synopsis
#include <normApi.h>
 
 void NormObjectSetNackingMode(NormObjectHandle objectHandle,
-                              NormNackingMode  nackingMode);
4.5.11.2. Description
This function sets the "nacking mode" used for receiving a specific transport object as identified by the objectHandle parameter. This overrides the default nacking mode set for the applicable sender node. See NormSetDefaultNackingMode() for a description of possible nackingMode parameter values and other related information.
4.5.11.3. Return Values
This function has no return values.
4.5.12. NormSetDefaultRepairBoundary()
4.5.12.1. Synopsis
#include <normApi.h>
+                              NormNackingMode  nackingMode);
4.5.11.2. Description
This function sets the "nacking mode" used for receiving a specific transport object as identified by the objectHandle parameter. This overrides the default nacking mode set for the applicable sender node. See NormSetDefaultNackingMode() for a description of possible nackingMode parameter values and other related information.
4.5.11.3. Return Values
This function has no return values.
4.5.12. NormSetDefaultRepairBoundary()
4.5.12.1. Synopsis
#include <normApi.h>
 
 void NormSetDefaultRepairBoundary(NormSessionHandle  sessionHandle,
-                                  NormRepairBoundary repairBoundary);
4.5.12.2. Description
This function allows the receiver application to customize, for a given sessionHandle, at what points the receiver initiates the NORM NACK repair process during protocol operation. Normally, the NORM receiver initiates NACKing for repairs at the FEC code block and transport object boundaries. For smaller block sizes, the NACK repair process is often/quickly initiated and the repair of an object will occur, as needed, during the transmission of the object. This default operation corresponds to repairBoundary equal to NORM_BOUNDARY_BLOCK. Using this function, the application may alternatively, setting repairBoundary equal to NORM_BOUNDARY_OBJECT, cause the protocol to defer NACK process initiation until the current transport object has been completely transmitted.
4.5.12.3. Return Values
This function has no return values.
4.5.13. NormNodeSetRepairBoundary()
4.5.13.1. Synopsis
#include <normApi.h>
+                                  NormRepairBoundary repairBoundary);
4.5.12.2. Description
This function allows the receiver application to customize, for a given sessionHandle, at what points the receiver initiates the NORM NACK repair process during protocol operation. Normally, the NORM receiver initiates NACKing for repairs at the FEC code block and transport object boundaries. For smaller block sizes, the NACK repair process is often/quickly initiated and the repair of an object will occur, as needed, during the transmission of the object. This default operation corresponds to repairBoundary equal to NORM_BOUNDARY_BLOCK. Using this function, the application may alternatively, setting repairBoundary equal to NORM_BOUNDARY_OBJECT, cause the protocol to defer NACK process initiation until the current transport object has been completely transmitted.
4.5.12.3. Return Values
This function has no return values.
4.5.13. NormNodeSetRepairBoundary()
4.5.13.1. Synopsis
#include <normApi.h>
 
 void NormNodeSetRepairBoundary(NormNodeHandle     nodeHandle,
-                               NormRepairBoundary repairBoundary);
4.5.13.2. Description
This function allows the receiver application to customize, for the specific remote sender referenced by the nodeHandle parameter, at what points the receiver initiates the NORM NACK repair process during protocol operation. See the description of NormSetDefaultRepairBoundary() for further details on the impact of setting the NORM receiver repair boundary and possible values for the repairBoundary parameter.
4.5.13.3. Return Values
This function has no return values.
4.5.14. NormSetDefaultRxRobustFactor()
4.5.14.1. Synopsis
#include <normApi.h>
+                               NormRepairBoundary repairBoundary);
4.5.13.2. Description
This function allows the receiver application to customize, for the specific remote sender referenced by the nodeHandle parameter, at what points the receiver initiates the NORM NACK repair process during protocol operation. See the description of NormSetDefaultRepairBoundary() for further details on the impact of setting the NORM receiver repair boundary and possible values for the repairBoundary parameter.
4.5.13.3. Return Values
This function has no return values.
4.5.14. NormSetDefaultRxRobustFactor()
4.5.14.1. Synopsis
#include <normApi.h>
 
 void NormSetDefaultRxRobustFactor(NormSessionHandle sessionHandle,
-                                  int               rxRobustFactor);
4.5.14.2. Description
This routine controls how persistently NORM receivers will maintain state for sender(s) and continue to request repairs from the sender(s) even when packet reception has ceased. The rxRobustFactor value determines how many times a NORM receiver will self-initiate NACKing (repair requests) upon cessation of packet reception from a sender. The default value is 20. Setting rxRobustFactor to -1 will make the NORM receiver infinitely persistent (i.e., it will continue to NACK indefinitely as long as it is missing data content). It is important to note that the NormSetTxRobustFactor() also affects receiver operation in setting the time interval that is used to gauge that sender packet transmission has ceased (i.e., the sender inactivity timeout). This "timeout" interval is a equal of (2 * GRTT * txRobustFactor). Thus the overall timeout before a NORM receiver quits NACKing is (rxRobustFactor * 2 * GRTT * txRobustFactor).
The NormNodeSetRxRobustFactor() function can be used to control this behavior on a per-sender basis. When a new remote sender is detected, the default rxRobustFactor set here is used. Again, the default value is 20.
4.5.14.3. Return Values
This function has no return values.
4.5.15. NormNodeSetRxRobustFactor()
4.5.15.1. Synopsis
#include <normApi.h>
+                                  int               rxRobustFactor);
4.5.14.2. Description
This routine controls how persistently NORM receivers will maintain state for sender(s) and continue to request repairs from the sender(s) even when packet reception has ceased. The rxRobustFactor value determines how many times a NORM receiver will self-initiate NACKing (repair requests) upon cessation of packet reception from a sender. The default value is 20. Setting rxRobustFactor to -1 will make the NORM receiver infinitely persistent (i.e., it will continue to NACK indefinitely as long as it is missing data content). It is important to note that the NormSetTxRobustFactor() also affects receiver operation in setting the time interval that is used to gauge that sender packet transmission has ceased (i.e., the sender inactivity timeout). This "timeout" interval is a equal of (2 * GRTT * txRobustFactor). Thus the overall timeout before a NORM receiver quits NACKing is (rxRobustFactor * 2 * GRTT * txRobustFactor).
The NormNodeSetRxRobustFactor() function can be used to control this behavior on a per-sender basis. When a new remote sender is detected, the default rxRobustFactor set here is used. Again, the default value is 20.
4.5.14.3. Return Values
This function has no return values.
4.5.15. NormNodeSetRxRobustFactor()
4.5.15.1. Synopsis
#include <normApi.h>
 
 void NormNodeSetRxRobustFactor(NormNodeHandle nodeHandle,
-                               int            rxRobustFactor);
4.5.15.2. Description
This routine sets the rxRobustFactor as described in NormSetDefaultRxRobustFactor() for an individual remote sender identified by the nodeHandle parameter. See the description of NormSetDefaultRxRobustFactor() for details
4.5.15.3. Return Values
This function has no return values.
4.5.16. NormStreamRead()
4.5.16.1. Synopsis
#include <normApi.h>
+                               int            rxRobustFactor);
4.5.15.2. Description
This routine sets the rxRobustFactor as described in NormSetDefaultRxRobustFactor() for an individual remote sender identified by the nodeHandle parameter. See the description of NormSetDefaultRxRobustFactor() for details
4.5.15.3. Return Values
This function has no return values.
4.5.16. NormStreamRead()
4.5.16.1. Synopsis
#include <normApi.h>
 
 bool NormStreamRead(NormObjectHandle streamHandle,
                     char*            buffer
-                    unsigned int*    numBytes);
4.5.16.2. Description
This function can be used by the receiver application to read any available data from an incoming NORM stream. NORM receiver applications "learn" of available NORM streams via NORM_RX_OBJECT_NEW notification events. The streamHandle parameter here must correspond to a valid NormObjectHandle value provided during such a prior NORM_RX_OBJECT_NEW notification. The buffer parameter must be a pointer to an array where the received data can be stored of a length as referenced by the numBytes pointer. On successful completion, the numBytes storage will be modified to indicate the actual number of bytes copied into the provided buffer. If the numBytes storage is modified to a zero value, this indicates that no stream data was currently available for reading.
Note that NormStreamRead() is never a blocking call and only returns failure (false) when a break in the integrity of the received stream occurs. The NORM_RX_OBJECT_UPDATE provides an indication to when there is stream data available for reading. When such notification occurs, the application should repeatedly read from the stream until the numBytes storage is set to zero, even if a false value is returned. Additional NORM_RX_OBJECT_UPDATE notifications might not be posted until the application has read all available data.
4.5.16.3. Return Values
This function normally returns a value of true. However, if a break in the integrity of the reliable received stream occurs (or the stream has been ended by the sender), a value of false is returned to indicate the break. Unless the stream has been ended (and the receiver application will receive NORM_RX_OBJECT_COMPLETED notification for the stream in that case), the application may continue to read from the stream as the NORM protocol will automatically "resync" to streams, even if network conditions are sufficiently poor that breaks in reliability occur. If such a "break" and "resync" occurs, the application may be able to leverage other NORM API calls such as NormStreamSeekMsgStart() or NormStreamGetReadOffset() if needed to recover its alignment with received stream content. This depends upon the nature of the application and its stream content.
4.5.17. NormStreamSeekMsgStart()
4.5.17.1. Synopsis
#include <normApi.h>
+                    unsigned int*    numBytes);
4.5.16.2. Description
This function can be used by the receiver application to read any available data from an incoming NORM stream. NORM receiver applications "learn" of available NORM streams via NORM_RX_OBJECT_NEW notification events. The streamHandle parameter here must correspond to a valid NormObjectHandle value provided during such a prior NORM_RX_OBJECT_NEW notification. The buffer parameter must be a pointer to an array where the received data can be stored of a length as referenced by the numBytes pointer. On successful completion, the numBytes storage will be modified to indicate the actual number of bytes copied into the provided buffer. If the numBytes storage is modified to a zero value, this indicates that no stream data was currently available for reading.
Note that NormStreamRead() is never a blocking call and only returns failure (false) when a break in the integrity of the received stream occurs. The NORM_RX_OBJECT_UPDATE provides an indication to when there is stream data available for reading. When such notification occurs, the application should repeatedly read from the stream until the numBytes storage is set to zero, even if a false value is returned. Additional NORM_RX_OBJECT_UPDATE notifications might not be posted until the application has read all available data.
4.5.16.3. Return Values
This function normally returns a value of true. However, if a break in the integrity of the reliable received stream occurs (or the stream has been ended by the sender), a value of false is returned to indicate the break. Unless the stream has been ended (and the receiver application will receive NORM_RX_OBJECT_COMPLETED notification for the stream in that case), the application may continue to read from the stream as the NORM protocol will automatically "resync" to streams, even if network conditions are sufficiently poor that breaks in reliability occur. If such a "break" and "resync" occurs, the application may be able to leverage other NORM API calls such as NormStreamSeekMsgStart() or NormStreamGetReadOffset() if needed to recover its alignment with received stream content. This depends upon the nature of the application and its stream content.
4.5.17. NormStreamSeekMsgStart()
4.5.17.1. Synopsis
#include <normApi.h>
 
-bool NormStreamSeekMsgStart(NormObjectHandle streamHandle);
4.5.17.2. Description
This function advances the read offset of the receive stream referenced by the streamHandle parameter to align with the next available message boundary. Message boundaries are defined by the sender application using the NormStreamMarkEom() call. Note that any received data prior to the next message boundary is discarded by the NORM protocol engine and is not available to the application (i.e., there is currently no "rewind" function for a NORM stream). Also note this call cannot be used to skip messages. Once a valid message boundary is found, the application must read from the stream using NormStreamRead() to further advance the read offset. The current offset (in bytes) for the stream can be retrieved via NormStreamGetReadOffset().
4.5.17.3. Return Values
This function returns a value of true when start-of-message is found. The next call to NormStreamRead() will retrieve data aligned with the message start. If no new message boundary is found in the buffered receive data for the stream, the function returns a value of false. In this case, the application should defer repeating a call to this function until a subsequent NORM_RX_OBJECT_UPDATE notification is posted.
4.5.18. NormStreamGetReadOffset()
4.5.18.1. Synopsis
#include <normApi.h>
+bool NormStreamSeekMsgStart(NormObjectHandle streamHandle);
4.5.17.2. Description
This function advances the read offset of the receive stream referenced by the streamHandle parameter to align with the next available message boundary. Message boundaries are defined by the sender application using the NormStreamMarkEom() call. Note that any received data prior to the next message boundary is discarded by the NORM protocol engine and is not available to the application (i.e., there is currently no "rewind" function for a NORM stream). Also note this call cannot be used to skip messages. Once a valid message boundary is found, the application must read from the stream using NormStreamRead() to further advance the read offset. The current offset (in bytes) for the stream can be retrieved via NormStreamGetReadOffset().
4.5.17.3. Return Values
This function returns a value of true when start-of-message is found. The next call to NormStreamRead() will retrieve data aligned with the message start. If no new message boundary is found in the buffered receive data for the stream, the function returns a value of false. In this case, the application should defer repeating a call to this function until a subsequent NORM_RX_OBJECT_UPDATE notification is posted.
4.5.18. NormStreamGetReadOffset()
4.5.18.1. Synopsis
#include <normApi.h>
 
-unsigned long NormStreamGetReadOffset(NormObjectHandle streamHandle);
4.5.18.2. Description
This function retrieves the current read offset value for the receive stream indicated by the streamHandle parameter. Note that for very long-lived streams, this value may wrap. Thus, in general, applications should not be highly dependent upon the stream offset, but this feature may be valuable for certain applications which associate some application context with stream position.
4.5.18.3. Return Values
This function returns the current read offset in bytes. The return value is undefined for sender streams. There is no error result.
4.6. NORM Object Functions
The functions described in this section may be used for sender or receiver purposes to manage transmission and reception of NORM transport objects. In most cases, the receiver will be the typical user of these functions to retrieve additional information on newly-received objects. All of these functions require a valid NormObjectHandle argument which specifies the applicable object. Note that NormObjectHandle values obtained from a NormEvent notification may be considered valid only until a subsequent call to NormGetNextEvent(), unless explicitly retained by the application (see NormObjectRetain()). NormObjectHandle values obtained as a result of NormFileEnqueue(), NormDataEnqueue(), or NormStreamOpen() calls can be considered valid only until a corresponding NORM_TX_OBJECT_PURGED notification is posted or the object is dequeued using NormObjectCancel(), unless, again, otherwise explicitly retained (see NormObjectRetain()).
4.6.1. NormObjectGetType()
4.6.1.1. Synopsis
#include <normApi.h>
+unsigned long NormStreamGetReadOffset(NormObjectHandle streamHandle);
4.5.18.2. Description
This function retrieves the current read offset value for the receive stream indicated by the streamHandle parameter. Note that for very long-lived streams, this value may wrap. Thus, in general, applications should not be highly dependent upon the stream offset, but this feature may be valuable for certain applications which associate some application context with stream position.
4.5.18.3. Return Values
This function returns the current read offset in bytes. The return value is undefined for sender streams. There is no error result.
4.6. NORM Object Functions
The functions described in this section may be used for sender or receiver purposes to manage transmission and reception of NORM transport objects. In most cases, the receiver will be the typical user of these functions to retrieve additional information on newly-received objects. All of these functions require a valid NormObjectHandle argument which specifies the applicable object. Note that NormObjectHandle values obtained from a NormEvent notification may be considered valid only until a subsequent call to NormGetNextEvent(), unless explicitly retained by the application (see NormObjectRetain()). NormObjectHandle values obtained as a result of NormFileEnqueue(), NormDataEnqueue(), or NormStreamOpen() calls can be considered valid only until a corresponding NORM_TX_OBJECT_PURGED notification is posted or the object is dequeued using NormObjectCancel(), unless, again, otherwise explicitly retained (see NormObjectRetain()).
4.6.1. NormObjectGetType()
4.6.1.1. Synopsis
#include <normApi.h>
 
-NormObjectType NormObjectGetType(NormObjectHandle objectHandle);
4.6.1.2. Description
This function can be used to determine the object type ((NORM_OBJECT_DAT, NORM_OBJECT_FILE, or NORM_OBJECT_STREAM) for the NORM transport object identified by the objectHandle parameter. The objectHandle must refer to a current, valid transport object.
4.6.1.3. Return Values
This function returns the NORM object type. Valid NORM object types include NORM_OBJECT_DATA, NORM_OBJECT_FILE, or NORM_OBJECT_STREAM. A type value of NORM_OBJECT_NONE will be returned for an objectHandle value of NORM_OBJECT_INVALID.
4.6.2. NormObjectHasInfo()
4.6.2.1. Synopsis
#include <normApi.h>
+NormObjectType NormObjectGetType(NormObjectHandle objectHandle);
4.6.1.2. Description
This function can be used to determine the object type ((NORM_OBJECT_DAT, NORM_OBJECT_FILE, or NORM_OBJECT_STREAM) for the NORM transport object identified by the objectHandle parameter. The objectHandle must refer to a current, valid transport object.
4.6.1.3. Return Values
This function returns the NORM object type. Valid NORM object types include NORM_OBJECT_DATA, NORM_OBJECT_FILE, or NORM_OBJECT_STREAM. A type value of NORM_OBJECT_NONE will be returned for an objectHandle value of NORM_OBJECT_INVALID.
4.6.2. NormObjectHasInfo()
4.6.2.1. Synopsis
#include <normApi.h>
 
-bool NormObjectHasInfo(NormObjectHandle objectHandle);
4.6.2.2. Description
This function can be used to determine if the sender has associated any NORM_INFO content with the transport object specified by the objectHandle parameter. This can even be used before the NORM_INFO content is delivered to the receiver and a NORM_RX_OBJECT_INFO notification is posted.
4.6.2.3. Return Values
A value of true is returned if NORM_INFO is (or will be) available for the specified transport object. A value of false is returned otherwise.
4.6.3. NormObjectGetInfoLength()
4.6.3.1. Synopsis
#include <normApi.h>
+bool NormObjectHasInfo(NormObjectHandle objectHandle);
4.6.2.2. Description
This function can be used to determine if the sender has associated any NORM_INFO content with the transport object specified by the objectHandle parameter. This can even be used before the NORM_INFO content is delivered to the receiver and a NORM_RX_OBJECT_INFO notification is posted.
4.6.2.3. Return Values
A value of true is returned if NORM_INFO is (or will be) available for the specified transport object. A value of false is returned otherwise.
4.6.3. NormObjectGetInfoLength()
4.6.3.1. Synopsis
#include <normApi.h>
 
-unsigned short NormObjectGetInfoLength(NormObjectHandle objectHandle);
4.6.3.2. Description
This function can be used to determine the length of currently available NORM_INFO content (if any) associated with the transport object referenced by the objectHandle parameter.
4.6.3.3. Return Values
The length of the NORM_INFO content, in bytes, of currently available for the specified transport object is returned. A value of 0 is returned if no NORM_INFO content is currently available or associated with the object.
4.6.4. NormObjectGetInfo()
4.6.4.1. Synopsis
#include <normApi.h>
+unsigned short NormObjectGetInfoLength(NormObjectHandle objectHandle);
4.6.3.2. Description
This function can be used to determine the length of currently available NORM_INFO content (if any) associated with the transport object referenced by the objectHandle parameter.
4.6.3.3. Return Values
The length of the NORM_INFO content, in bytes, of currently available for the specified transport object is returned. A value of 0 is returned if no NORM_INFO content is currently available or associated with the object.
4.6.4. NormObjectGetInfo()
4.6.4.1. Synopsis
#include <normApi.h>
 
 unsigned short NormObjectGetInfo(NormObjectHandle         objectHandle,
                                  char*                    buffer,
-                                 unsigned short           bufferLen);
4.6.4.2. Description
This function copies any NORM_INFO content associated (by the sender application) with the transport object specified by objectHandle into the provided memory space referenced by the buffer parameter. The bufferLen parameter indicates the length of the buffer space in bytes. If the provided bufferLen is less than the actual NORM_INFO length, a partial copy will occur. The actual length of NORM_INFO content available for the specified object is returned. However, note that until a NORM_RX_OBJECT_INFO notification is posted to the receive application, no NORM_INFO content is available and a zero result will be returned, even if NORM_INFO content may be subsequently available. The NormObjectHasInfo() call can be used to determine if any NORM_INFO content will ever be available for a specified transport object (i.e., determine if the sender has associated any NORM_INFO with the object in question).
4.6.4.3. Return Values
The actual length of currently available NORM_INFO content for the specified transport object is returned. This function can be used to determine the length of NORM_INFO content for the object even if a NULL buffer value and zero bufferLen is provided. A zero value is returned if NORM_INFO content has not yet been received (or is non-existent) for the specified object.
4.6.5. NormObjectGetSize()
4.6.5.1. Synopsis
#include <normApi.h>
+                                 unsigned short           bufferLen);
4.6.4.2. Description
This function copies any NORM_INFO content associated (by the sender application) with the transport object specified by objectHandle into the provided memory space referenced by the buffer parameter. The bufferLen parameter indicates the length of the buffer space in bytes. If the provided bufferLen is less than the actual NORM_INFO length, a partial copy will occur. The actual length of NORM_INFO content available for the specified object is returned. However, note that until a NORM_RX_OBJECT_INFO notification is posted to the receive application, no NORM_INFO content is available and a zero result will be returned, even if NORM_INFO content may be subsequently available. The NormObjectHasInfo() call can be used to determine if any NORM_INFO content will ever be available for a specified transport object (i.e., determine if the sender has associated any NORM_INFO with the object in question).
4.6.4.3. Return Values
The actual length of currently available NORM_INFO content for the specified transport object is returned. This function can be used to determine the length of NORM_INFO content for the object even if a NULL buffer value and zero bufferLen is provided. A zero value is returned if NORM_INFO content has not yet been received (or is non-existent) for the specified object.
4.6.5. NormObjectGetSize()
4.6.5.1. Synopsis
#include <normApi.h>
 
-NormSize NormObjectGetSize(NormObjectHandle objectHandle);
4.6.5.2. Description
This function can be used to determine the size (in bytes) of the transport object specified by the objectHandle parameter. NORM can support large object sizes for the NORM_OBJECT_FILE type, so typically the NORM library is built with any necessary, related macros defined such that operating system large file support is enabled (e.g., "#define _FILE_OFFSET_BITS 64" or equivalent). The NormSize type is defined accordingly, so the application should be built with the same large file support configuration.
For objects of type NORM_OBJECT_STREAM, the size returned here corresponds to the stream buffer size set by the sender application when opening the referenced stream object.
4.6.5.3. Return Values
A size of the data content of the specified object, in bytes, is returned. Note that it may be possible that some objects have zero data content, but do have NORM_INFO content available.
4.6.6. NormObjectGetBytesPending()
4.6.6.1. Synopsis
#include <normApi.h>
+NormSize NormObjectGetSize(NormObjectHandle objectHandle);
4.6.5.2. Description
This function can be used to determine the size (in bytes) of the transport object specified by the objectHandle parameter. NORM can support large object sizes for the NORM_OBJECT_FILE type, so typically the NORM library is built with any necessary, related macros defined such that operating system large file support is enabled (e.g., "#define _FILE_OFFSET_BITS 64" or equivalent). The NormSize type is defined accordingly, so the application should be built with the same large file support configuration.
For objects of type NORM_OBJECT_STREAM, the size returned here corresponds to the stream buffer size set by the sender application when opening the referenced stream object.
4.6.5.3. Return Values
A size of the data content of the specified object, in bytes, is returned. Note that it may be possible that some objects have zero data content, but do have NORM_INFO content available.
4.6.6. NormObjectGetBytesPending()
4.6.6.1. Synopsis
#include <normApi.h>
 
-NormSize NormObjectGetBytesPending(NormObjectHandle objectHandle);
4.6.6.2. Description
This function can be used to determine the progress of reception of the NORM transport object identified by the objectHandle parameter. This function indicates the number of bytes that are pending reception (I.e., when the object is completely received, "bytes pending" will equal ZERO). This function is not necessarily applicable to objects of type NORM_OBJECT_STREAM which do not have a finite size. Note it is possible that this function might also be useful to query the "transmit pending" status of sender objects, but it does not account for pending FEC repair transmissions and thus may not produce useful results for this purpose.
4.6.6.3. Return Values
A number of object source data bytes pending reception (or transmission) is returned.
4.6.7. NormObjectCancel()
4.6.7.1. Synopsis
#include <normApi.h>
+NormSize NormObjectGetBytesPending(NormObjectHandle objectHandle);
4.6.6.2. Description
This function can be used to determine the progress of reception of the NORM transport object identified by the objectHandle parameter. This function indicates the number of bytes that are pending reception (I.e., when the object is completely received, "bytes pending" will equal ZERO). This function is not necessarily applicable to objects of type NORM_OBJECT_STREAM which do not have a finite size. Note it is possible that this function might also be useful to query the "transmit pending" status of sender objects, but it does not account for pending FEC repair transmissions and thus may not produce useful results for this purpose.
4.6.6.3. Return Values
A number of object source data bytes pending reception (or transmission) is returned.
4.6.7. NormObjectCancel()
4.6.7.1. Synopsis
#include <normApi.h>
 
-void NormObjectCancel(NormObjectHandle objectHandle);
4.6.7.2. Description
This function immediately cancels the transmission of a local sender transport object or the reception of a specified object from a remote sender as specified by the objectHandle parameter. The objectHandle must refer to a currently valid NORM transport object. Any resources used by the transport object in question are immediately freed unless the object has been otherwise retained by the application via the NormObjectRetain() call. Unless the application has retained the object in such fashion, the object in question should be considered invalid and the application must not again reference the objectHandle after this call is made.
If the canceled object is a sender object not completely received by participating receivers, the receivers will be informed of the object's cancellation via the NORM protocol NORM_CMD(SQUELCH) message in response to any NACKs requesting repair or retransmission of the applicable object. In the case of receive objects, the NORM receiver will not make further requests for repair of the indicated object, but furthermore, will acknowledge the object as completed with respect to any associated positive acknowledgement requests (see NormSetWatermark()).
4.6.7.3. Return Values
This function has no return value.
4.6.8. NormObjectRetain()
4.6.8.1. Synopsis
#include <normApi.h>
+void NormObjectCancel(NormObjectHandle objectHandle);
4.6.7.2. Description
This function immediately cancels the transmission of a local sender transport object or the reception of a specified object from a remote sender as specified by the objectHandle parameter. The objectHandle must refer to a currently valid NORM transport object. Any resources used by the transport object in question are immediately freed unless the object has been otherwise retained by the application via the NormObjectRetain() call. Unless the application has retained the object in such fashion, the object in question should be considered invalid and the application must not again reference the objectHandle after this call is made.
If the canceled object is a sender object not completely received by participating receivers, the receivers will be informed of the object's cancellation via the NORM protocol NORM_CMD(SQUELCH) message in response to any NACKs requesting repair or retransmission of the applicable object. In the case of receive objects, the NORM receiver will not make further requests for repair of the indicated object, but furthermore, will acknowledge the object as completed with respect to any associated positive acknowledgement requests (see NormSetWatermark()).
4.6.7.3. Return Values
This function has no return value.
4.6.8. NormObjectRetain()
4.6.8.1. Synopsis
#include <normApi.h>
 
-void NormObjectRetain(NormObjectHandle objectHandle);
4.6.8.2. Description
This function "retains" the objectHandle and any state associated with it for further use by the application even when the NORM protocol engine may no longer require access to the associated transport object. Normally, the application is guaranteed that a given NormObjectHandle is valid only while it is being actively transported by NORM (i.e., for sender objects, from the time an object is created by the application until it is canceled by the application or purged (see the NORM_TX_OBJECT_PURGED notification) by the protocol engine, or, for receiver objects, from the time of the object's NORM_RX_OBJECT_NEW notification until its reception is canceled by the application or a NORM_RX_OBJECT_COMPLETED or NORM_RX_OBJECT_ABORTED notification is posted). Note that an application may refer to a given object after any related notification until the application makes a subsequent call to NormGetNextEvent().
When the application makes a call to NormObjectRetain() for a given objectHandle, the application may use that objectHandle value in any NORM API calls until the application makes a call to NormObjectRelease() for the given object. Note that the application MUST make a corresponding call to NormObjectRelease() for each call it has made to NormObjectRetain() in order to free any system resources (i.e., memory) used by that object. Also note that retaining a receive object also automatically retains any state associated with the NormNodeHandle corresponding to the remote sender of that receive object so that the application may use NORM node API calls for the value returned by NormObjectGetSender() as needed.
4.6.8.3. Return Values
This function has no return value.
4.6.9. NormObjectRelease()
4.6.9.1. Synopsis
#include <normApi.h>
+void NormObjectRetain(NormObjectHandle objectHandle);
4.6.8.2. Description
This function "retains" the objectHandle and any state associated with it for further use by the application even when the NORM protocol engine may no longer require access to the associated transport object. Normally, the application is guaranteed that a given NormObjectHandle is valid only while it is being actively transported by NORM (i.e., for sender objects, from the time an object is created by the application until it is canceled by the application or purged (see the NORM_TX_OBJECT_PURGED notification) by the protocol engine, or, for receiver objects, from the time of the object's NORM_RX_OBJECT_NEW notification until its reception is canceled by the application or a NORM_RX_OBJECT_COMPLETED or NORM_RX_OBJECT_ABORTED notification is posted). Note that an application may refer to a given object after any related notification until the application makes a subsequent call to NormGetNextEvent().
When the application makes a call to NormObjectRetain() for a given objectHandle, the application may use that objectHandle value in any NORM API calls until the application makes a call to NormObjectRelease() for the given object. Note that the application MUST make a corresponding call to NormObjectRelease() for each call it has made to NormObjectRetain() in order to free any system resources (i.e., memory) used by that object. Also note that retaining a receive object also automatically retains any state associated with the NormNodeHandle corresponding to the remote sender of that receive object so that the application may use NORM node API calls for the value returned by NormObjectGetSender() as needed.
4.6.8.3. Return Values
This function has no return value.
4.6.9. NormObjectRelease()
4.6.9.1. Synopsis
#include <normApi.h>
 
-void NormObjectRelease(NormObjectHandle objectHandle);
4.6.9.2. Description
This function complements the NormObjectRetain() call by immediately freeing any resources associated with the given objectHandle, assuming the underlying NORM protocol engine no longer requires access to the corresponding transport object. Note the NORM protocol engine retains/releases state for associated objects for its own needs and thus it is very unsafe for an application to call NormObjectRelease() for an objectHandle for which it has not previously explicitly retained via NormObjectRetain().
4.6.9.3. Return Values
This function has no return value.
4.6.10. NormFileGetName()
4.6.10.1. Synopsis
#include <normApi.h>
+void NormObjectRelease(NormObjectHandle objectHandle);
4.6.9.2. Description
This function complements the NormObjectRetain() call by immediately freeing any resources associated with the given objectHandle, assuming the underlying NORM protocol engine no longer requires access to the corresponding transport object. Note the NORM protocol engine retains/releases state for associated objects for its own needs and thus it is very unsafe for an application to call NormObjectRelease() for an objectHandle for which it has not previously explicitly retained via NormObjectRetain().
4.6.9.3. Return Values
This function has no return value.
4.6.10. NormFileGetName()
4.6.10.1. Synopsis
#include <normApi.h>
 
 bool NormFileGetName(NormObjectHandle objectHandle,
                      char*            nameBuffer,
-                     unsigned int     bufferLen);
4.6.10.2. Description
This function copies the name, as a NULL-terminated string, of the file object specified by the objectHandle parameter into the nameBuffer of length bufferLen bytes provided by the application. The objectHandle parameter must refer to a valid NormObjectHandle for an object of type NORM_OBJECT_FILE. If the actual name is longer than the provided bufferLen, a partial copy will occur. Note that the file name consists of the entire path name of the specified file object and the application should give consideration to operating system file path lengths when providing the nameBuffer.
4.6.10.3. Return Values
This function returns true upon success and false upon failure. Possible failure conditions include the objectHandle does not refer to an object of type NORM_OBJECT_FILE.
4.6.11. NormFileRename()
4.6.11.1. Synopsis
#include <normApi.h>
+                     unsigned int     bufferLen);
4.6.10.2. Description
This function copies the name, as a NULL-terminated string, of the file object specified by the objectHandle parameter into the nameBuffer of length bufferLen bytes provided by the application. The objectHandle parameter must refer to a valid NormObjectHandle for an object of type NORM_OBJECT_FILE. If the actual name is longer than the provided bufferLen, a partial copy will occur. Note that the file name consists of the entire path name of the specified file object and the application should give consideration to operating system file path lengths when providing the nameBuffer.
4.6.10.3. Return Values
This function returns true upon success and false upon failure. Possible failure conditions include the objectHandle does not refer to an object of type NORM_OBJECT_FILE.
4.6.11. NormFileRename()
4.6.11.1. Synopsis
#include <normApi.h>
 
 bool NormFileRename(NormObjectHandle objectHandle,
-                    const char*      fileName);
4.6.11.2. Description
This function renames the file used to store content for the NORM_OBJECT_FILE transport object specified by the objectHandle parameter. This allows receiver applications to rename (or move) received files as needed. NORM uses temporary file names for received files until the application explicitly renames the file. For example, sender applications may choose to use the NORM_INFO content associated with a file object to provide name and/or typing information to receivers. The fileName parameter must be a NULL-terminated string which should specify the full desired path name to be used. NORM will attempt to create sub-directories as needed to satisfy the request. Note that existing files of the same name may be overwritten.
4.6.11.3. Return Values
This function returns true upon success and false upon failure. Possible failure conditions include the case where the objectHandle does not refer to an object of type NORM_OBJECT_FILE and where NORM was unable to successfully create any needed directories and/or the file itself.
4.6.12. NormDataAccessData()
4.6.12.1. Synopsis
#include <normApi.h>
+                    const char*      fileName);
4.6.11.2. Description
This function renames the file used to store content for the NORM_OBJECT_FILE transport object specified by the objectHandle parameter. This allows receiver applications to rename (or move) received files as needed. NORM uses temporary file names for received files until the application explicitly renames the file. For example, sender applications may choose to use the NORM_INFO content associated with a file object to provide name and/or typing information to receivers. The fileName parameter must be a NULL-terminated string which should specify the full desired path name to be used. NORM will attempt to create sub-directories as needed to satisfy the request. Note that existing files of the same name may be overwritten.
4.6.11.3. Return Values
This function returns true upon success and false upon failure. Possible failure conditions include the case where the objectHandle does not refer to an object of type NORM_OBJECT_FILE and where NORM was unable to successfully create any needed directories and/or the file itself.
4.6.12. NormDataAccessData()
4.6.12.1. Synopsis
#include <normApi.h>
 
-const char* NormDataAccessData(NormObjectHandle objectHandle);
4.6.12.2. Description
This function allows the application to access the data storage area associated with a transport object of type NORM_OBJECT_DATA. For example, the application may use this function to copy the received data content for its own use. Alternatively, the application may establish "ownership" for the allocated memory space using the NormDataDetachData() function if it is desired to avoid the copy.
If the object specified by the objectHandle parameter has no data content (or is not of type NORM_OBJECT_DATA), a NULL value may be returned. The application MUST NOT attempt to modify the memory space used by NORM_OBJECT_DATA objects during the time an associated objectHandle is valid. The length of data storage area can be determined with a call to NormObjectGetSize() for the same objectHandle value.
4.6.12.3. Return Values
This function returns a pointer to the data storage area for the specified transport object. A NULL value may be returned if the object has no associated data content or is not of type NORM_OBJECT_DATA.
4.6.13. NormDataDetachData()
4.6.13.1. Synopsis
#include <normApi.h>
+const char* NormDataAccessData(NormObjectHandle objectHandle);
4.6.12.2. Description
This function allows the application to access the data storage area associated with a transport object of type NORM_OBJECT_DATA. For example, the application may use this function to copy the received data content for its own use. Alternatively, the application may establish "ownership" for the allocated memory space using the NormDataDetachData() function if it is desired to avoid the copy.
If the object specified by the objectHandle parameter has no data content (or is not of type NORM_OBJECT_DATA), a NULL value may be returned. The application MUST NOT attempt to modify the memory space used by NORM_OBJECT_DATA objects during the time an associated objectHandle is valid. The length of data storage area can be determined with a call to NormObjectGetSize() for the same objectHandle value.
4.6.12.3. Return Values
This function returns a pointer to the data storage area for the specified transport object. A NULL value may be returned if the object has no associated data content or is not of type NORM_OBJECT_DATA.
4.6.13. NormDataDetachData()
4.6.13.1. Synopsis
#include <normApi.h>
 
-char* NormDataDetachData(NormObjectHandle objectHandle);
4.6.13.2. Description
This function allows the application to disassociate data storage allocated by the NORM protocol engine for a receive object from the NORM_OBJECT_DATA transport object specified by the objectHandle parameter. It is important that this function is called after the NORM protocol engine has indicated it is finished with the data object (i.e., after a NORM_TX_OBJECT_PURGED, NORM_RX_OBJECT_COMPLETED, or NORM_RX_OBJECT_ABORTED notification event). But the application must call NormDataDetachData() before a call is made to NormObjectCancel() or NormObjectRelease() for the object if it plans to access the data content afterwards. Otherwise, the NORM protocol engine will free the applicable memory space when the associated NORM_OBJECT_DATA transport object is deleted and the application will be unable to access the received data unless it has previously copied the content.
Once the application has used this call to "detach" the data content, it is the application's responsibility to subsequently free the data storage space as needed.
4.6.13.3. Return Values
This function returns a pointer to the data storage area for the specified transport object. A NULL value may be returned if the object has no associated data content or is not of type NORM_OBJECT_DATA.
4.6.14. NormObjectGetSender()
4.6.14.1. Synopsis
#include <normApi.h>
+char* NormDataDetachData(NormObjectHandle objectHandle);
4.6.13.2. Description
This function allows the application to disassociate data storage allocated by the NORM protocol engine for a receive object from the NORM_OBJECT_DATA transport object specified by the objectHandle parameter. It is important that this function is called after the NORM protocol engine has indicated it is finished with the data object (i.e., after a NORM_TX_OBJECT_PURGED, NORM_RX_OBJECT_COMPLETED, or NORM_RX_OBJECT_ABORTED notification event). But the application must call NormDataDetachData() before a call is made to NormObjectCancel() or NormObjectRelease() for the object if it plans to access the data content afterwards. Otherwise, the NORM protocol engine will free the applicable memory space when the associated NORM_OBJECT_DATA transport object is deleted and the application will be unable to access the received data unless it has previously copied the content.
Once the application has used this call to "detach" the data content, it is the application's responsibility to subsequently free the data storage space as needed.
4.6.13.3. Return Values
This function returns a pointer to the data storage area for the specified transport object. A NULL value may be returned if the object has no associated data content or is not of type NORM_OBJECT_DATA.
4.6.14. NormObjectGetSender()
4.6.14.1. Synopsis
#include <normApi.h>
 
-NormNodeHandle NormObjectGetSender(NormObjectHandle objectHandle);
4.6.14.2. Description
This function retrieves the NormNodeHandle corresponding to the remote sender of the transport object associated with the given objectHandle parameter. Note that the returned NormNodeHandle value is only valid for the same period that the objectHandle is valid. The returned NormNodeHandle may optionally be retained for further use by the application using the NormNodeRetain() function call. The returned value can be used in the NORM Node Functions described later in this document.
4.6.14.3. Return Values
This function returns the NormNodeHandle corresponding to the remote sender of the transport object associated with the given objectHandle parameter. A value of NORM_NODE_INVALID is returned if the specified objectHandle references a locally originated, sender object.
4.7. NORM Node Functions
The functions described in this section may be used for NORM sender or receiver (most typically receiver) purposes to retrieve additional information about a remote NormNode, given a valid NormNodeHandle. Note that, unless specifically retained (see NormNodeRetain()), a NormNodeHandle provided in a NormEvent notification should be considered valid only until a subsequent call to NormGetNextEvent() is made. NormNodeHandle values retrieved using NormObjectGetSender() can be considered valid for the same period of time as the corresponding NormObjectHandle is valid.
4.7.1. NormNodeGetId()
4.7.1.1. Synopsis
#include <normApi.h>
+NormNodeHandle NormObjectGetSender(NormObjectHandle objectHandle);
4.6.14.2. Description
This function retrieves the NormNodeHandle corresponding to the remote sender of the transport object associated with the given objectHandle parameter. Note that the returned NormNodeHandle value is only valid for the same period that the objectHandle is valid. The returned NormNodeHandle may optionally be retained for further use by the application using the NormNodeRetain() function call. The returned value can be used in the NORM Node Functions described later in this document.
4.6.14.3. Return Values
This function returns the NormNodeHandle corresponding to the remote sender of the transport object associated with the given objectHandle parameter. A value of NORM_NODE_INVALID is returned if the specified objectHandle references a locally originated, sender object.
4.7. NORM Node Functions
The functions described in this section may be used for NORM sender or receiver (most typically receiver) purposes to retrieve additional information about a remote NormNode, given a valid NormNodeHandle. Note that, unless specifically retained (see NormNodeRetain()), a NormNodeHandle provided in a NormEvent notification should be considered valid only until a subsequent call to NormGetNextEvent() is made. NormNodeHandle values retrieved using NormObjectGetSender() can be considered valid for the same period of time as the corresponding NormObjectHandle is valid.
4.7.1. NormNodeGetId()
4.7.1.1. Synopsis
#include <normApi.h>
 
-NormNodeId NormNodeGetId(NormNodeHandle nodeHandle);
4.7.1.2. Description
This function retrieves the NormNodeId identifier for the remote participant referenced by the given nodeHandle value. The NormNodeId is a 32-bit value used within the NORM protocol to uniquely identify participants within a NORM session. The participants identifiers are assigned by the application or derived (by the NORM API code) from the host computers default IP address.
4.7.1.3. Return Values
This function returns the NormNodeId value associated with the specified nodeHandle. In the case nodeHandle is equal to NORM_NODE_INVALID, the return value will be NORM_NODE_NONE.
4.7.2. NormNodeGetAddress()
4.7.2.1. Synopsis
#include <normApi.h>
+NormNodeId NormNodeGetId(NormNodeHandle nodeHandle);
4.7.1.2. Description
This function retrieves the NormNodeId identifier for the remote participant referenced by the given nodeHandle value. The NormNodeId is a 32-bit value used within the NORM protocol to uniquely identify participants within a NORM session. The participants identifiers are assigned by the application or derived (by the NORM API code) from the host computers default IP address.
4.7.1.3. Return Values
This function returns the NormNodeId value associated with the specified nodeHandle. In the case nodeHandle is equal to NORM_NODE_INVALID, the return value will be NORM_NODE_NONE.
4.7.2. NormNodeGetAddress()
4.7.2.1. Synopsis
#include <normApi.h>
 
 bool NormNodeGetAddress(NormNodeHandle          nodeHandle,
                         char*                   addrBuffer,
                         unsigned int*           bufferLen,
-                        unsigned short*         port = NULL);
4.7.2.2. Description
This function retrieves the current network source address detected for packets received from remote NORM sender referenced by the nodeHandle parameter. The addrBuffer must be a pointer to storage of bufferLen bytes in length in which the referenced sender node's address will be returned. Optionally, the remote sender source port number (see NormSetTxPort()) is also returned if the optional port pointer to storage parameter is provided in the call. Note that in the case of Network Address Translation (NAT) or other firewall activities, the source address detected by the NORM receiver may not be the original address of the original NORM sender.
4.7.2.3. Return Values
A value of true is returned upon success and false upon failure. An invalid nodeHandle parameter value would lead to such failure.
4.7.3. NormNodeGetGrtt()
4.7.3.1. Synopsis
#include <normApi.h>
+                        unsigned short*         port = NULL);
4.7.2.2. Description
This function retrieves the current network source address detected for packets received from remote NORM sender referenced by the nodeHandle parameter. The addrBuffer must be a pointer to storage of bufferLen bytes in length in which the referenced sender node's address will be returned. Optionally, the remote sender source port number (see NormSetTxPort()) is also returned if the optional port pointer to storage parameter is provided in the call. Note that in the case of Network Address Translation (NAT) or other firewall activities, the source address detected by the NORM receiver may not be the original address of the original NORM sender.
4.7.2.3. Return Values
A value of true is returned upon success and false upon failure. An invalid nodeHandle parameter value would lead to such failure.
4.7.3. NormNodeGetGrtt()
4.7.3.1. Synopsis
#include <normApi.h>
 
-double NormNodeGetId(NormNodeHandle nodeHandle);
4.7.3.2. Description
This function retrieves the advertised estimate of group round-trip timing (GRTT) for the remote sender referenced by the given nodeHandle value. Newly-starting senders that have been participating as a receiver within a group may wish to use this function to provide a more accurate startup estimate of GRTT (see NormSetGrttEstimate()) prior to a call to NormStartSender(). Applications may use this information for other purpose as well. Note that the NORM_GRTT_UPDATED event is posted (see NormGetNextEvent()) by the NORM protocol engine to indicate when changes in the local sender or remote senders' GRTT estimate occurs.
4.7.3.3. Return Values
This function returns the remote sender's advertised GRTT estimate in units of seconds. A value of -1.0 is returned upon failure. An invalid nodeHandle parameter value will lead to such failure.
4.7.4. NormNodeGetCommand()
4.7.4.1. Synopsis
#include <normApi.h>
+double NormNodeGetId(NormNodeHandle nodeHandle);
4.7.3.2. Description
This function retrieves the advertised estimate of group round-trip timing (GRTT) for the remote sender referenced by the given nodeHandle value. Newly-starting senders that have been participating as a receiver within a group may wish to use this function to provide a more accurate startup estimate of GRTT (see NormSetGrttEstimate()) prior to a call to NormStartSender(). Applications may use this information for other purpose as well. Note that the NORM_GRTT_UPDATED event is posted (see NormGetNextEvent()) by the NORM protocol engine to indicate when changes in the local sender or remote senders' GRTT estimate occurs.
4.7.3.3. Return Values
This function returns the remote sender's advertised GRTT estimate in units of seconds. A value of -1.0 is returned upon failure. An invalid nodeHandle parameter value will lead to such failure.
4.7.4. NormNodeGetCommand()
4.7.4.1. Synopsis
#include <normApi.h>
 
 bool NormNodeGetCommand(NormNodeHandle nodeHandle,
                         char*          buffer,
-                        unsigned int*  buflen);
4.7.4.2. Description
This function retrieves the content of an application-defined command that was received from a remote sender associated with the given nodeHandle. This call should be made in response to the NORM_RX_CMD_NEW notification. This notification is issued for each command received. However the application may use this call to poll for received commands if desired. Additionally, the received command length can be "queried" by setting the value referenced by the buflen parameter to ZERO. Upon return, this value referenced by the buflen parameter is adjusted to reflect the command length. Then a subsequent call to NormNodeGetCommand() can be made with an appropriately-sized buffer to retrieve the received command content. The command size will be less than or equal to the NORM segment size configured for the given remote sender.
Note that if a rapid succession of commands are sent it is possible that the commands may be delivered to the receivers out-of-order. Also, when repetition is requested (i.e., if robust is set to true) the receiver may receive duplicate copies of the same command. It is up to the application to provide any needed mechanism for detecting and/or filtering duplicate command reception.
4.7.4.3. Return Values
This function returns true upon successful retrieval of command content. A return value of false indicates that either no command was available or the provided buffer size (buflen parameter) was inadequate. The value referenced by the buflen parameter is adjusted to indicate the actual command length (in bytes) upon return.
4.7.5. NormNodeFreeBuffers()
4.7.5.1. Synopsis
#include <normApi.h>
+                        unsigned int*  buflen);
4.7.4.2. Description
This function retrieves the content of an application-defined command that was received from a remote sender associated with the given nodeHandle. This call should be made in response to the NORM_RX_CMD_NEW notification. This notification is issued for each command received. However the application may use this call to poll for received commands if desired. Additionally, the received command length can be "queried" by setting the value referenced by the buflen parameter to ZERO. Upon return, this value referenced by the buflen parameter is adjusted to reflect the command length. Then a subsequent call to NormNodeGetCommand() can be made with an appropriately-sized buffer to retrieve the received command content. The command size will be less than or equal to the NORM segment size configured for the given remote sender.
Note that if a rapid succession of commands are sent it is possible that the commands may be delivered to the receivers out-of-order. Also, when repetition is requested (i.e., if robust is set to true) the receiver may receive duplicate copies of the same command. It is up to the application to provide any needed mechanism for detecting and/or filtering duplicate command reception.
4.7.4.3. Return Values
This function returns true upon successful retrieval of command content. A return value of false indicates that either no command was available or the provided buffer size (buflen parameter) was inadequate. The value referenced by the buflen parameter is adjusted to indicate the actual command length (in bytes) upon return.
4.7.5. NormNodeFreeBuffers()
4.7.5.1. Synopsis
#include <normApi.h>
 
-void NormNodeFreeBuffers(NormNodeHandle nodeHandle);
4.7.5.2. Description
This function releases memory resources that were allocated for a remote sender. For example, the receiver application may wish to free memory resources when receiving a NORM_REMOTE_SENDER_INACTIVE notification for a given remote sender when multiple senders may be providing content. The NORM protocol engine allocates memory for reliable transport buffering on a per sender basis according to the limit set in the NormStartReceiver() call. These buffering resources comprise the majority of the state allocated for a given remote sender. For NORM applications with possibly multiple senders active at different times, this function can be used to manage to amount of memory allocated for reliable reception. If a sender becomes "active" again after a call to NormNodeFreeBuffers(), new memory resources will be allocated. Note that state for any pending (uncompleted) objects will be dropped when this function is called and the receiver may request retransmission and repair of content if the sender once again becomes "active". The application SHOULD call NormObjectCancel() for any pending objects before calling NormNodeFreeBuffers() if it wishes to never receive those pending objects. Alternatively, a call to NormNodeDelete() will completely eliminate all state for a given remote sender and, if that sender becomes "active" again, it will be treated as a completely new sender.
4.7.5.3. Return Values
This function has no return value.
4.7.6. NormNodeDelete()
4.7.6.1. Synopsis
#include <normApi.h>
+void NormNodeFreeBuffers(NormNodeHandle nodeHandle);
4.7.5.2. Description
This function releases memory resources that were allocated for a remote sender. For example, the receiver application may wish to free memory resources when receiving a NORM_REMOTE_SENDER_INACTIVE notification for a given remote sender when multiple senders may be providing content. The NORM protocol engine allocates memory for reliable transport buffering on a per sender basis according to the limit set in the NormStartReceiver() call. These buffering resources comprise the majority of the state allocated for a given remote sender. For NORM applications with possibly multiple senders active at different times, this function can be used to manage to amount of memory allocated for reliable reception. If a sender becomes "active" again after a call to NormNodeFreeBuffers(), new memory resources will be allocated. Note that state for any pending (uncompleted) objects will be dropped when this function is called and the receiver may request retransmission and repair of content if the sender once again becomes "active". The application SHOULD call NormObjectCancel() for any pending objects before calling NormNodeFreeBuffers() if it wishes to never receive those pending objects. Alternatively, a call to NormNodeDelete() will completely eliminate all state for a given remote sender and, if that sender becomes "active" again, it will be treated as a completely new sender.
4.7.5.3. Return Values
This function has no return value.
4.7.6. NormNodeDelete()
4.7.6.1. Synopsis
#include <normApi.h>
 
-void NormNodeDelete(NormNodeHandle nodeHandle);
4.7.6.2. Description
This function can be used by a NORM receiver application to completely remove the state associated with a remote sender for the given nodeHandle. For example, when a NORM_REMOTE_SENDER_INACTIVE notification occurs for a given sender, the application may wish to completely free all associated resources. Note this is distinct from the NormNodeFreeBuffers() call where only the buffering resources are freed and other state pertaining to the sender is kept. If the deleted sender again becomes "active", it will be treated as a brand new sender. Unless explicitly retained with a call to NormNodeRetain(), the nodeHandle should be considered invalid after this call is made. Additionally, any NormObjectHandle values for pending objects from this sender are also invalidated (unless otherwise retained), although NORM_RX_OBJECT_ABORTED notifications may be issued for those pending objects.
4.7.6.3. Return Values
This function has no return value.
4.7.7. NormNodeRetain()
4.7.7.1. Synopsis
#include <normApi.h>
+void NormNodeDelete(NormNodeHandle nodeHandle);
4.7.6.2. Description
This function can be used by a NORM receiver application to completely remove the state associated with a remote sender for the given nodeHandle. For example, when a NORM_REMOTE_SENDER_INACTIVE notification occurs for a given sender, the application may wish to completely free all associated resources. Note this is distinct from the NormNodeFreeBuffers() call where only the buffering resources are freed and other state pertaining to the sender is kept. If the deleted sender again becomes "active", it will be treated as a brand new sender. Unless explicitly retained with a call to NormNodeRetain(), the nodeHandle should be considered invalid after this call is made. Additionally, any NormObjectHandle values for pending objects from this sender are also invalidated (unless otherwise retained), although NORM_RX_OBJECT_ABORTED notifications may be issued for those pending objects.
4.7.6.3. Return Values
This function has no return value.
4.7.7. NormNodeRetain()
4.7.7.1. Synopsis
#include <normApi.h>
 
-void NormNodeRetain(NormNodeHandle nodeHandle);
4.7.7.2. Description
In the same manner as the NormObjectRetain() function, this function allows the application to retain state associated with a given nodeHandle value even when the underlying NORM protocol engine might normally free the associated state and thus invalidate the NormNodeHandle. If the application uses this function, it must make a corresponding call to NormNodeRelease() when finished with the node information to avoid a memory leak condition. NormNodeHandle values (unless retained) are valid from the time of a NORM_REMOTE_SENDER_NEW notification until a complimentary NORM_REMOTE_SENDER_PURGED notification. During that interval, the application will receive NORM_REMOTE_SENDER_ACTIVE and NORM_REMOTE_SENDER_INACTIVE notifications according to the sender's message transmission activity within the session.
It is important to note that, if the NORM protocol engine posts a NORM_REMOTE_SENDER_PURGED notification for a given NormNodeHandle, the NORM protocol engine could possibly, subsequently establish a new, different NormNodeHandle value for the same remote sender (i.e., one of equivalent NormNodeId) if it again becomes active in the session. A new NormNodeHandle may likely be established even if the application has retained the previous NormNodeHandle value. Therefore, to the application, it might appear that two different senders with the same NormNodeId are participating if these notifications are not carefully monitored. This behavior is contingent upon how the application has configured the NORM protocol engine to manage resources when there is potential for a large number of remote senders within a session (related APIs are TBD). For example, the application may wish to control which specific remote senders for which it keeps state (or limit the memory resources used for remote sender state, etc) and the NORM API may be extended in the future to control this behavior.
4.7.7.3. Return Values
This function has no return value.
4.7.8. NormNodeRelease()
4.7.8.1. Synopsis
#include <normApi.h>
+void NormNodeRetain(NormNodeHandle nodeHandle);
4.7.7.2. Description
In the same manner as the NormObjectRetain() function, this function allows the application to retain state associated with a given nodeHandle value even when the underlying NORM protocol engine might normally free the associated state and thus invalidate the NormNodeHandle. If the application uses this function, it must make a corresponding call to NormNodeRelease() when finished with the node information to avoid a memory leak condition. NormNodeHandle values (unless retained) are valid from the time of a NORM_REMOTE_SENDER_NEW notification until a complimentary NORM_REMOTE_SENDER_PURGED notification. During that interval, the application will receive NORM_REMOTE_SENDER_ACTIVE and NORM_REMOTE_SENDER_INACTIVE notifications according to the sender's message transmission activity within the session.
It is important to note that, if the NORM protocol engine posts a NORM_REMOTE_SENDER_PURGED notification for a given NormNodeHandle, the NORM protocol engine could possibly, subsequently establish a new, different NormNodeHandle value for the same remote sender (i.e., one of equivalent NormNodeId) if it again becomes active in the session. A new NormNodeHandle may likely be established even if the application has retained the previous NormNodeHandle value. Therefore, to the application, it might appear that two different senders with the same NormNodeId are participating if these notifications are not carefully monitored. This behavior is contingent upon how the application has configured the NORM protocol engine to manage resources when there is potential for a large number of remote senders within a session (related APIs are TBD). For example, the application may wish to control which specific remote senders for which it keeps state (or limit the memory resources used for remote sender state, etc) and the NORM API may be extended in the future to control this behavior.
4.7.7.3. Return Values
This function has no return value.
4.7.8. NormNodeRelease()
4.7.8.1. Synopsis
#include <normApi.h>
 
-void NormNodeRelease(NormNodeHandle nodeHandle);
4.7.8.2. Description
In complement to the NormNodeRetain() function, this API call releases the specified nodeHandle so that the NORM protocol engine may free associated resources as needed. Once this call is made, the application should no longer reference the specified NormNodeHandle, unless it is still valid.
4.7.8.3. Return Values
This function has no return value.
4.8. NORM Debugging Functions
This section describes some additional function calls that are available to set debugging output options and control other aspects of the NORM implementation.
4.8.1. NormSetDebugLevel()
4.8.1.1. Synopsis
#include <normApi.h>
+void NormNodeRelease(NormNodeHandle nodeHandle);
4.7.8.2. Description
In complement to the NormNodeRetain() function, this API call releases the specified nodeHandle so that the NORM protocol engine may free associated resources as needed. Once this call is made, the application should no longer reference the specified NormNodeHandle, unless it is still valid.
4.7.8.3. Return Values
This function has no return value.
4.8. NORM Debugging Functions
This section describes some additional function calls that are available to set debugging output options and control other aspects of the NORM implementation.
4.8.1. NormSetDebugLevel()
4.8.1.1. Synopsis
#include <normApi.h>
 
-void NormSetDebugLevel(unsigned int level);
4.8.1.2. Description
This function controls the verbosity of NORM debugging output. Higher values of level result in more detailed output. The highest level of debugging is 12. The debug output consists of text written to STDOUT by default but may be directed to a log file using the NormOpenDebugLog() function.
4.8.1.3. Return Values
This function has no return value.
4.8.2. NormOpenDebugLog()
4.8.2.1. Synopsis
#include <normApi.h>
+void NormSetDebugLevel(unsigned int level);
4.8.1.2. Description
This function controls the verbosity of NORM debugging output. Higher values of level result in more detailed output. The highest level of debugging is 12. The debug output consists of text written to STDOUT by default but may be directed to a log file using the NormOpenDebugLog() function.
4.8.1.3. Return Values
This function has no return value.
4.8.2. NormOpenDebugLog()
4.8.2.1. Synopsis
#include <normApi.h>
 
-bool NormOpenDebugLog(NormInstanceHandle instance, const char* fileName);
4.8.2.2. Description
This function allows NORM debug output to be directed to a file instead of the default STDERR.
4.8.2.3. Return Values
The function returns true on success. If the specified file cannot be opened a value of false is returned.
4.8.3. NormCloseDebugLog()
4.8.3.1. Synopsis
#include <normApi.h>
+bool NormOpenDebugLog(NormInstanceHandle instance, const char* fileName);
4.8.2.2. Description
This function allows NORM debug output to be directed to a file instead of the default STDERR.
4.8.2.3. Return Values
The function returns true on success. If the specified file cannot be opened a value of false is returned.
4.8.3. NormCloseDebugLog()
4.8.3.1. Synopsis
#include <normApi.h>
 
-bool NormCloseDebugLog(NormInstanceHandle instance);
4.8.3.2. Description
TBD
4.8.3.3. Return Values
TBD
4.8.4. NormOpenDebugPipe()
4.8.4.1. Synopsis
#include <normApi.h>
+bool NormCloseDebugLog(NormInstanceHandle instance);
4.8.3.2. Description
TBD
4.8.3.3. Return Values
TBD
4.8.4. NormOpenDebugPipe()
4.8.4.1. Synopsis
#include <normApi.h>
 
-bool NormOpenDebugPipe(NormInstanceHandle instance, const char* pipeName);
4.8.4.2. Description
TBD
4.8.4.3. Return Values
TBD
4.8.5. NormCloseDebugPipe()
4.8.5.1. Synopsis
#include <normApi.h>
+bool NormOpenDebugPipe(NormInstanceHandle instance, const char* pipeName);
4.8.4.2. Description
TBD
4.8.4.3. Return Values
TBD
4.8.5. NormCloseDebugPipe()
4.8.5.1. Synopsis
#include <normApi.h>
 
-bool NormCloseDebugPipe(NormInstanceHandle instance);
4.8.5.2. Description
TBD
4.8.5.3. Return Values
TBD
\ No newline at end of file +bool NormCloseDebugPipe(NormInstanceHandle instance);
4.8.5.2. Description

TBD

4.8.5.3. Return Values

TBD

\ No newline at end of file diff --git a/doc/NormDeveloperGuide.pdf b/doc/NormDeveloperGuide.pdf index ac297c48cd1b517161416206df3b082e3c98d555..db614bc2ecb7846dec2f74be414be1a6af98eae8 100644 GIT binary patch literal 460960 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

dIDw{F+j$pPmSyx4fpw_kVQfYQxF-CzJG8p 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

RuM>{~8X3|mu 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≫;O=F?au4F&@7Eq$BhiaNXo=T1iA-eS=`m`Uq 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%0A}!?@$&f#D!%- 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 H_~m~9iBLZQ diff --git a/doc/NormDeveloperGuide.xml b/doc/NormDeveloperGuide.xml index 9c7b386..c4b5229 100644 --- a/doc/NormDeveloperGuide.xml +++ b/doc/NormDeveloperGuide.xml @@ -5,9 +5,9 @@ <inlinemediaobject> <imageobject> - <imagedata align="center" fileref="NormLogo.gif" scale="50" /> + <imagedata align="center" fileref="NormLogo.gif" scale="50"/> </imageobject> - </inlinemediaobject> NORM Developer's Guide (version 1.4b4) + NORM Developer's Guide (version 1.5b5) NORM Developer's Guide @@ -1234,9 +1234,9 @@ bool NormGetNextEvent - + - + @@ -1430,8 +1430,8 @@ bool NormGetNextEvent NORM_REMOTE_SENDER_ACTIVE This event is posted when a previously inactive - (or new) remote sender is detected operating as an active + (or new) remote sender is detected operating as an active sender within the session. @@ -1675,9 +1675,9 @@ NormSessionHandle No - + - + @@ -1886,7 +1886,7 @@ const void* NormGetUserData - Return Values + Return Valuess The returned value indicates the NormNode identifier used by the NORM protocol engine for the local @@ -2185,8 +2185,8 @@ NormSetMulticastInterface(session, "interface2");A return value of true indicates success while a return value of false indicates that - the specified interface was valid. This function will always return - true if made before calls to true if made before calls to NormStartSender() or NormStartReceiver(). @@ -2195,6 +2195,50 @@ NormSetMulticastInterface(session, "interface2"); + + NormSetSSM() + + + Synopsis + + #include <normApi.h> + +bool NormSetSSM(NormSessionHandle session, + const char* sourceAddress); + + + + Description + + This function sets the source address for Source-Specific + Multicast (SSM) operation. This should be called + before any call to NormStartSender() + or NormStartReceiver() + is made so that the proper group join is done. The receiver + application MUST also use the NormSetDefaultUnicastNack() + call so that feedback traffic is directed back to appropriate + sender. + + + + Return Values + + A return value of true indicates success + while a return value of false indicates that + the specified source address was invalid. Note that if a valid IP + address is specified but is improper for SSM (e.g., an IP multicast + address) the later calls to NormStartSender() + or NormStartReceiver() + may fail. + + + NormSetTTL() @@ -2352,8 +2396,7 @@ bool NormSetFragmentation + fragmentation disabled) by default on most operating systems. This call is not currently functional on the Mac OSX system that does not support the needed @@ -2371,7 +2414,7 @@ bool NormSetFragmentation - <anchor id="_NORM_Sender_Functions" />NORM Sender + <title><anchor id="_NORM_Sender_Functions"/>NORM Sender Functions The functions described in this section apply only to NORM sender @@ -2412,9 +2455,9 @@ bool NormStartSender(< - + - + diff --git a/examples/normClient.cpp b/examples/normClient.cpp new file mode 100644 index 0000000..9043b2c --- /dev/null +++ b/examples/normClient.cpp @@ -0,0 +1,296 @@ +#include "normSocket.h" +#include +#include +#include +#include // for, well, fnctl() +#include // obvious child + +// BUILD: (assumes "normApi.h" in "include" ... +// g++ -I../include -o normClient normClient.cpp normSocket.cpp ../lib/libnorm.a ../protolib/lib/libprotokit.a -lresolv + + +// NOTES: +// 1) THIS IS A WORK IN PROGRESS AND NOT YET FUNCTIONAL! +// 2) Some of the functions here may be added to the NORM API in the future. + +// Client initiates connection to "server". When the "client" gets a NORM_REMOTE_SENDER_NEW +// from the "server", it knows its connection has been accepted. + +// To deny a connection, the "server" can send a stream close??? Which means the server will have +// to establish state just to deny a client a connection (yuck!) + +const unsigned int MSG_LENGTH_MAX = 64; + +int main(int argc, char* argv[]) +{ + char serverAddr[64]; + strcpy(serverAddr, "127.0.0.1"); + UINT16 serverPort = 5000; + char groupAddr[64]; + const char* groupAddrPtr = NULL; + const char* mcastInterface = NULL; + NormNodeId clientId = 2; + bool trace = false; + unsigned int debugLevel = 0; + + for (int i = 1; i < argc; i++) + { + const char* cmd = argv[i]; + unsigned int len = strlen(cmd); + if (0 == strncmp(cmd, "connect", len)) + { + // connect /[, + const char* val = argv[++i]; + const char* portPtr = strchr(val, '/'); + if (NULL == portPtr) + { + fprintf(stderr, "normClient error: missing number\n"); + return -1; + } + portPtr++; + unsigned int addrTextLen = portPtr - val; + if (addrTextLen > 0) + { + addrTextLen -= 1; + strncpy(serverAddr, val, addrTextLen); + serverAddr[addrTextLen] = '\0'; + } + else + { + fprintf(stderr, "normClient error: missing \n"); + return -1; + } + char portText[32]; + const char* groupPtr = strchr(portPtr, ','); + if (NULL == groupPtr) + { + strcpy(portText, portPtr); + } + else + { + groupPtr++; + unsigned int portTextLen = groupPtr - portPtr - 1; + strncpy(portText, portPtr, portTextLen); + portText[portTextLen] = '\0'; + } + if (1 != sscanf(portText, "%hu", &serverPort)) + { + fprintf(stderr, "normClient error: invalid \n"); + return -1; + } + if (NULL != groupPtr) + { + strcpy(groupAddr, groupPtr); + groupAddrPtr = groupAddr; + } + } + else if (0 == strncmp(cmd, "interface", len)) + { + mcastInterface = argv[++i]; + } + else if (0 == strncmp(cmd, "trace", len)) + { + trace = true; + } + else if (0 == strncmp(cmd, "debug", len)) + { + if (1 != sscanf(argv[++i], "%u", &debugLevel)) + { + fprintf(stderr, "normServer error: invalid debug level\n"); + return -1; + } + } + else if (0 == strncmp(cmd, "id", len)) + { + const char* val = argv[++i]; + unsigned long id; + if (1 != sscanf(val, "%lu", &id)) + { + fprintf(stderr, "normClient error: invalid 'id' value\n"); + return -1; + } + clientId = id; + } + else + { + fprintf(stderr, "normServer error: invalid command \"%s\"\n", cmd); + return -1; + } + } + + NormInstanceHandle instance = NormCreateInstance(); + + // Initate connection to server ... + fprintf(stderr, "normClient: connecting to %s/%hu ...\n", serverAddr, serverPort); + NormSocketHandle normSocket = NormConnect(instance, serverAddr, serverPort, groupAddrPtr, clientId); + + if (trace) + { + NormSetMessageTrace(NormGetSession(normSocket), true); + if (NULL != groupAddrPtr) + NormSetMessageTrace(NormGetMulticastSession(normSocket), true); + } + if (0 != debugLevel) NormSetDebugLevel(debugLevel); + + //NormSetDebugLevel(3); + //NormSetMessageTrace(NormGetSession(normSocket), true); + + // We use a select() call to multiplex input reading and NormSocket handling + fd_set fdset; + FD_ZERO(&fdset); + + // Get our input (STDIN) descriptor and set non-blocking + FILE* inputFile = stdin; + int inputfd = fileno(inputFile); + if (-1 == fcntl(inputfd, F_SETFL, fcntl(inputfd, F_GETFL, 0) | O_NONBLOCK)) + perror("normClient: fcntl(inputfd, O_NONBLOCK) error"); + // Get our NormInstance descriptor + int normfd = NormGetDescriptor(instance); + bool keepGoing = true; + bool writeReady = false; + unsigned int inputLength = 0; + unsigned int bytesWritten = 0; + const unsigned int BUFFER_LENGTH = 2048; + char inputBuffer[BUFFER_LENGTH]; + bool inputNeeded = false; // will be set to "true" upon CONNECT + while (keepGoing) + { + FD_SET(normfd, &fdset); + int maxfd = normfd; + if (inputNeeded) + { + FD_SET(inputfd, &fdset); + if (inputfd > maxfd) maxfd = inputfd; + } + else + { + FD_CLR(inputfd, &fdset); + } + int result = select(maxfd+1, &fdset, NULL, NULL, NULL); + if (result <= 0) + { + perror("normClient: select() error"); + break; + } + if (FD_ISSET(inputfd, &fdset)) + { + // Read input into our txBuffer + inputLength = fread(inputBuffer, 1, BUFFER_LENGTH, inputFile); + if (inputLength > 0) + { + // We got our input + bytesWritten = 0; + inputNeeded = false; + } + else if (feof(inputFile)) + { + // TBD - initiate client shutdown + if (NULL == groupAddrPtr) + { + fprintf(stderr, "normClient: CLOSING connection to server ...\n"); + NormShutdown(normSocket); + } + inputNeeded = false; // TBD -should we also fclose(inputFile)??? + + // else stick around to receive stuff from the server + } + else if (ferror(inputFile)) + { + switch (errno) + { + case EINTR: + // interupted, try again + break; + case EAGAIN: + // input starved, wait for next notification + break; + default: + perror("normClient: error reading input"); + break; + } + } + } + if (FD_ISSET(normfd, &fdset)) + { + + // There's a NORM event pending + NormSocketEvent event; + if (NormGetSocketEvent(instance, &event)) + { + switch (event.type) + { + case NORM_SOCKET_ACCEPT: + // shouldn't happen + break; + + case NORM_SOCKET_CONNECT: + { + fprintf(stderr, "normClient: CONNECTED to server ...\n"); + inputNeeded = true; + writeReady = true; + break; + } + case NORM_SOCKET_READ: + { + // This is a cue to try to read data from stream + // For our test app here, the data is read and output to STDOUT + bool rxReady = true; + while (rxReady) + { + char buffer[1024]; + ssize_t bytesRead = NormRead(event.socket, buffer, 1024); + if (bytesRead < 0) + { + // This shouldn't happen with ack-based flow control used + fprintf(stderr, "normClient: broken stream ...\n"); + continue; + } + if (bytesRead > 0) + fwrite(buffer, sizeof(char), bytesRead, stdout); + if (bytesRead < 1024) rxReady = false; + } + break; + } + case NORM_SOCKET_WRITE: + writeReady = true; + break; + case NORM_SOCKET_CLOSING: + fprintf(stderr, "normClient: server CLOSING connection ...\n"); + inputNeeded = false; + break; + case NORM_SOCKET_CLOSED: + { + fprintf(stderr, "normClient: connection to server CLOSED.\n"); + inputNeeded = false; + keepGoing = false; + break; + } + case NORM_SOCKET_NONE: + break; + } // end switch(event.type) + } + else + { + fprintf(stderr, "normClient: NormGetSocketEvent() returned false\n"); + } + } // end if FD_ISSET(normfd) + + // If we have data in our inputBuffer and the NormSocket is "writeReady", then send it + if (writeReady && (inputLength > 0)) + { + bytesWritten += NormWrite(normSocket, inputBuffer + bytesWritten, inputLength - bytesWritten); + if (bytesWritten < inputLength) + { + // Couldn't write whole inputBuffer, need to wait for NORM_SOCKET_WRITE event + writeReady = false; + } + else + { + // inputBuffer has been completely written + inputLength = 0; + inputNeeded = true; + NormFlush(normSocket); + } + } + } // end while(keepGoing) +} diff --git a/examples/normMsgr.cpp b/examples/normMsgr.cpp index 1ba8017..b1a6a24 100644 --- a/examples/normMsgr.cpp +++ b/examples/normMsgr.cpp @@ -1,6 +1,8 @@ #include "normApi.h" +#include "protoCheck.h" + #include // for printf(), etc #include // for srand() #include // for strrchr(), memset(), etc @@ -49,8 +51,8 @@ class NormMsgr char* AccessBuffer() {return msg_buffer;} - void ResetIndex() - {msg_index = 0;} + void ResetIndex(unsigned int index = 0) + {msg_index = index;} void IncrementIndex(unsigned int count) {msg_index += count;} unsigned int GetIndex() const @@ -150,6 +152,15 @@ class NormMsgr bool OutputPending() const {return output_pending;} bool WriteOutput(); + + void OmitHeader(bool state) + {omit_header = state;} + + // These can only be called post-OpenNormSession + void SetSilentReceiver(bool state) + {NormSetSilentReceiver(norm_session, true);} + void SetTxLoss(double txloss) + {NormSetTxLoss(norm_session, txloss);} private: bool is_running; @@ -159,6 +170,7 @@ class NormMsgr MessageQueue input_msg_list; // list of enqueued messages (in norm sender cache) NormSessionHandle norm_session; + bool is_multicast; unsigned int norm_tx_queue_max; // max number of objects that can be enqueued at once unsigned int norm_tx_queue_count; // count of unacknowledged enqueued objects (TBD - optionally track size too) bool norm_tx_watermark_pending; @@ -170,14 +182,19 @@ class NormMsgr bool output_pending; Message* output_msg; MessageQueue output_msg_queue; + // These are some options mainly for testing purposes + bool omit_header; // if "true", receive message length header is _not_ written to output + bool rx_silent; + double tx_loss; }; // end class NormMsgr NormMsgr::NormMsgr() - : input_file(stdin), input_needed(true), input_msg(NULL), - norm_session(NORM_SESSION_INVALID), norm_tx_queue_max(2048), norm_tx_queue_count(0), + : input_file(stdin), input_needed(false), input_msg(NULL), + norm_session(NORM_SESSION_INVALID), is_multicast(false), norm_tx_queue_max(2048), norm_tx_queue_count(0), norm_tx_watermark_pending(false), norm_tx_vacancy(true), norm_acking(false), - output_file(stdout), output_ready(true), output_pending(false), output_msg(NULL) + output_file(stdout), output_ready(true), output_pending(false), output_msg(NULL), + omit_header(false), rx_silent(false), tx_loss(0.0) { } @@ -191,12 +208,25 @@ NormMsgr::~NormMsgr() bool NormMsgr::OpenNormSession(NormInstanceHandle instance, const char* addr, unsigned short port, NormNodeId nodeId) { + if (NormIsUnicastAddress(addr)) + is_multicast = false; + else + is_multicast = true; norm_session = NormCreateSession(instance, addr, port, nodeId); if (NORM_SESSION_INVALID == norm_session) { fprintf(stderr, "normMsgr error: unable to create NORM session\n"); return false; } + + if (is_multicast) + { + NormSetRxPortReuse(norm_session, true); + // TBD - make full loopback a command line option? + NormSetMulticastLoopback(norm_session, true); + } + + // Set some default parameters (maybe we should put parameter setting in Start()) NormSetRxCacheLimit(norm_session, norm_tx_queue_max); NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_ALL); @@ -205,6 +235,9 @@ bool NormMsgr::OpenNormSession(NormInstanceHandle instance, const char* addr, un NormSetTxCacheBounds(norm_session, 10*1024*1024, norm_tx_queue_max, norm_tx_queue_max); //NormSetMessageTrace(norm_session, true); + + NormSetTxRobustFactor(norm_session, 2); + return true; } // end NormMsgr::OpenNormSession() @@ -268,6 +301,7 @@ bool NormMsgr::Start(bool sender, bool receiver) if (receiver) NormStopReceiver(norm_session); return false; } + input_needed = true; } is_running = true; return true; @@ -379,6 +413,7 @@ bool NormMsgr::WriteOutput() bufferPtr = output_msg->GetBuffer() + offset; } size_t result = fwrite(bufferPtr, 1, writeLength, output_file); + output_msg->IncrementIndex(result); if (result < writeLength) { @@ -389,6 +424,7 @@ bool NormMsgr::WriteOutput() } else if (ferror(input_file)) { + fprintf(stderr, "normMsgr: output error detected ...\n"); switch (errno) { case EINTR: @@ -406,12 +442,20 @@ bool NormMsgr::WriteOutput() } if (output_msg->IsComplete()) { + fflush(output_file); delete output_msg; output_msg = output_msg_queue.RemoveHead(); if (NULL != output_msg) - output_msg->ResetIndex(); + { + if (omit_header) + output_msg->ResetIndex(MSG_HEADER_SIZE); + else + output_msg->ResetIndex(); + } else + { output_pending = false; + } break; } } @@ -490,6 +534,7 @@ bool NormMsgr::EnqueueMessageObject() void NormMsgr::HandleNormEvent(const NormEvent& event) { + bool logAllocs = false; switch (event.type) { case NORM_TX_QUEUE_EMPTY: @@ -528,6 +573,18 @@ void NormMsgr::HandleNormEvent(const NormEvent& event) } break; } + + case NORM_REMOTE_SENDER_INACTIVE: + //fprintf(stderr, "REMOTE SENDER INACTIVE node: %u\n", NormNodeGetId(event.sender)); + //NormNodeDelete(event.sender); + //logAllocs = true; + break; + + case NORM_RX_OBJECT_ABORTED: + //fprintf(stderr, "NORM_RX_OBJECT_ABORTED\n");// %hu\n", NormObjectGetTransportId(event.object)); + logAllocs = true; + break; + case NORM_RX_OBJECT_COMPLETED: { char* data = NormDataDetachData(event.object); @@ -536,7 +593,7 @@ void NormMsgr::HandleNormEvent(const NormEvent& event) Message* msg = new Message(data, NormObjectGetSize(event.object)); if (NULL == msg) { - perror("normMsgr new receive Message error"); + perror("normMsgr: new Message() error"); delete[] data; // TBD - may need to finally implement NormDelete() function! // TBD Stop() as a fatal out of memory error? break; @@ -544,7 +601,10 @@ void NormMsgr::HandleNormEvent(const NormEvent& event) if (NULL == output_msg) { output_msg = msg; - output_msg->ResetIndex(); + if (omit_header) + output_msg->ResetIndex(MSG_HEADER_SIZE); + else + output_msg->ResetIndex(); output_pending = true; } else @@ -559,13 +619,23 @@ void NormMsgr::HandleNormEvent(const NormEvent& event) default: break; } + //NormReleasePreviousEvent(NormGetInstance(norm_session)); + + if (logAllocs) + { +#ifdef USE_PROTO_CHECK + ProtoCheckLogAllocations(stderr); +#endif // USE_PROTO_CHECK + } + } // end NormMsgr::HandleNormEvent() void Usage() { fprintf(stderr, "Usage: normMsgr id {send &| recv} [addr [/]][ack [,,...]\n" - " [cc|cce|ccl|rate ][interface ][debug ][trace]\n"); + " [cc|cce|ccl|rate ][interface ][debug ][trace]\n" + " [omit][silent][txloss ]\n"); } int main(int argc, char* argv[]) { @@ -587,6 +657,9 @@ int main(int argc, char* argv[]) int debugLevel = 0; bool trace = false; + bool omitHeaderOnOutput = false; + bool silentReceiver = false; + double txloss = 0.0; // Parse command-line int i = 1; @@ -700,6 +773,23 @@ int main(int argc, char* argv[]) } mcastIface = argv[i++]; } + else if (0 == strncmp(cmd, "omit", len)) + { + omitHeaderOnOutput = true; + } + else if (0 == strncmp(cmd, "silent", len)) + { + silentReceiver = true; + } + else if (0 == strncmp(cmd, "txloss", len)) + { + if (1 != sscanf(argv[i++], "%lf", &txloss)) + { + fprintf(stderr, "nodeMsgr error: invalid 'txloss' value!\n"); + Usage(); + return -1; + } + } else if (0 == strncmp(cmd, "debug", len)) { if (i >= argc) @@ -746,6 +836,8 @@ int main(int argc, char* argv[]) NormMsgr normMsgr; + if (omitHeaderOnOutput) normMsgr.OmitHeader(true); + if (!normMsgr.OpenNormSession(normInstance, sessionAddr, sessionPort, (NormNodeId)nodeId)) { fprintf(stderr, "normMsgr error: unable to open NORM session\n"); @@ -753,6 +845,10 @@ int main(int argc, char* argv[]) return false; } + + if (silentReceiver) normMsgr.SetSilentReceiver(true); + if (txloss > 0.0) normMsgr.SetTxLoss(txloss); + for (unsigned int i = 0; i < ackingNodeCount; i++) normMsgr.AddAckingNode(ackingNodeList[i]); @@ -848,6 +944,9 @@ int main(int argc, char* argv[]) normMsgr.WriteOutput(); // TBD - implement output async i/o notification as needed } // end while(normMsgr.IsRunning() + + fprintf(stderr, "normMsgr exiting ...\n"); + NormDestroyInstance(normInstance); } // end main() @@ -865,6 +964,8 @@ NormMsgr::Message::Message(char* buffer, unsigned int size) uint16_t msgSize = size + MSG_HEADER_SIZE; msgSize = htons(msgSize); memcpy(msg_header, &msgSize, MSG_HEADER_SIZE); + + fprintf(stderr, "output msg ctor data = %.20s\n", buffer); } NormMsgr::Message::~Message() diff --git a/examples/normServer.cpp b/examples/normServer.cpp new file mode 100644 index 0000000..cca42c8 --- /dev/null +++ b/examples/normServer.cpp @@ -0,0 +1,463 @@ + +// This example NORM application acts as unicast "server". A NORM receive-only session "listens" +// on a "serverPort". When new remote senders are detected, the sender is assigned to a +// newly create "client" NormSession that is "connected" to the remote sender/client addr/port. +// The NormSetRxPortReuse() call provides an option to "connect" the underlying NORM UDP socket +// to the remote sender/client address/port. Note this is not yet supported for NORM-CCE (ECN) +// congestion control operation. + +// By creating "client" NormSessions for each client connection, this enables multiple clients +// from the same host (with the same NormNodeId to connect to the server at the same time. +// Otherwise, clients with the same NormNodeId would "collide" at the server receive session. +// Even the approach here is not perfect as a packet from a another client instance with the +// same NormNodeId might change the given "remote sender" source addr/port before the +// connected "client" session is created as a sort of race condition. +// A potential enhancement to NORM would be to allow tracking of multiple remote senders +// with the same NormNodeId but different instanceIds ... + +// BUILD: (assumes "normApi.h" in "include" ... +// g++ -I../include -o normServer normServer.cpp normSocket.cpp ../lib/libnorm.a ../protolib/lib/libprotokit.a -lresolv + + +// EXAMPLE NOTES: +// +// 0) THIS IS A WORK IN PROGRESS AND NOT YET FUNCTIONAL! +// +// 1) Some of the functions here may be added to the NORM API in the future. +// +// 2) The "main()" below is a single-threaded example with a single NormInstance and a +// single NormGetNextEvent() main loop. Note that the NormAccept() call allows for a +// new instance (and hence new NormDescriptor) for each accepted client, so multiple +// threads or event thread-pooling versions of this could be implemented for +// performance or application design purposes. A future version of the NORM API and +// this could even provide for very "socket-like" API calls where each "client" +// session has its own descriptor independent of threading (e.g. a "normSocket.h" API +// that is implemented around the current low level NORM API). This sort of "NORM +// socket" approach could be supported for unicast and SSM streams without too much +// difficulty. + +#include "normSocket.h" +#include // for inet_ntoa +#include // for fprintf() +#include // for memcmp() +#include // for std::map<> +#include +#include // for, well, fnctl() +#include // obvious child + +// Our "server" indexes clients by their source addr/port +class ClientInfo +{ + public: + ClientInfo(UINT8 ipVersion = 0, const char* theAddr = NULL, UINT16 thePort = 0); + bool operator < (const ClientInfo& a) const; + + int GetAddressFamily() const; + const char* GetAddress() const + {return client_addr;} + UINT16 GetPort() const + {return client_port;} + + const char* GetAddressString() const; + void Print(FILE* filePtr) const; + + private: + UINT8 addr_version; // 4 or 6 + char client_addr[16]; // big enough for IPv6 + UINT16 client_port; + +}; // end class ClientInfo + + +ClientInfo::ClientInfo(UINT8 addrVersion, const char* clientAddr, UINT16 clientPort) + : addr_version(addrVersion), client_port(clientPort) +{ + if (NULL == clientAddr) addrVersion = 0; // forces zero initialization + switch (addrVersion) + { + case 4: + memcpy(client_addr, clientAddr, 4); + memset(client_addr+4, 0, 12); + break; + case 6: + memcpy(client_addr, clientAddr, 16); + break; + default: + memset(client_addr, 0, 16); + break; + } +} + +// returns "true" if "this" less than "a" (used by C++ map) +bool ClientInfo::operator <(const ClientInfo& a) const +{ + if (addr_version != a.addr_version) + return (addr_version < a.addr_version); + else if (client_port != a.client_port) + return (client_port < a.client_port); + else if (4 == addr_version) + return (0 > memcmp(client_addr, a.client_addr, 4)); + else + return (0 > memcmp(client_addr, a.client_addr, 16)); +} // end ClientInfo::operator <() + +int ClientInfo::GetAddressFamily() const +{ + if (4 == addr_version) + return AF_INET; + else + return AF_INET6; +} // end ClientInfo::GetAddressFamily() + + +const char* ClientInfo::GetAddressString() const +{ + static char text[64]; + text[63] = '\0'; + int addrFamily; + if (4 == addr_version) + addrFamily = AF_INET; + else + addrFamily = AF_INET6; + inet_ntop(addrFamily, client_addr, text, 63); + return text; +} // end ClientInfo::GetAddressString() + +void ClientInfo::Print(FILE* filePtr) const +{ + char text[64]; + text[63] = '\0'; + int addrFamily; + if (4 == addr_version) + addrFamily = AF_INET; + else + addrFamily = AF_INET6; + inet_ntop(addrFamily, client_addr, text, 63); + fprintf(filePtr, "%s/%hu", text, client_port); +} // end ClientInfo::Print() + + +// C++ map used to index client sessions by the client source addr/port +typedef std::map ClientMap; + +ClientInfo NormGetClientInfo(NormNodeHandle client) +{ + char addr[16]; // big enough for IPv6 + unsigned int addrLen = 16; + UINT16 port; + NormNodeGetAddress(client, addr, &addrLen, &port); + int addrFamily; + UINT8 version; + if (4 == addrLen) + { + addrFamily = AF_INET; + version = 4; + } + else + { + addrFamily = AF_INET6; + version = 6; + } + return ClientInfo(version, addr, port); +} // end NormGetClientInfo() + +NormSocketHandle FindClientSocket(ClientMap& clientMap, const ClientInfo& clientInfo) +{ + ClientMap::iterator it = clientMap.find(clientInfo); + if (clientMap.end() != it) + return &(it->second); + else + return NORM_SOCKET_INVALID; +} // end FindClientSocket() + + + +int main(int argc, char* argv[]) +{ + ClientMap clientMap; + + UINT16 serverPort = 5000; + UINT16 serverInstanceId = 1; + char groupAddr[64]; + const char* groupAddrPtr = NULL; + const char* mcastInterface = NULL; + + bool trace = false; + unsigned int debugLevel = 0; + + + for (int i = 1; i < argc; i++) + { + const char* cmd = argv[i]; + unsigned int len = strlen(cmd); + if (0 == strncmp(cmd, "listen", len)) + { + // listen [/] + const char* val = argv[++i]; + const char* portPtr = strchr(val, '/'); + if (NULL != portPtr) + portPtr++; + else + portPtr = val; + unsigned int addrTextLen = portPtr - val; + if (addrTextLen > 0) + { + addrTextLen -= 1; + strncpy(groupAddr, val, addrTextLen); + groupAddr[addrTextLen] = '\0'; + groupAddrPtr = groupAddr; + } + if (1 != sscanf(portPtr, "%hu", &serverPort)) + { + fprintf(stderr, "normServer error: invalid \"%s\"\n", portPtr); + return -1; + } + } + else if (0 == strncmp(cmd, "interface", len)) + { + mcastInterface = argv[++i]; + } + else if (0 == strncmp(cmd, "trace", len)) + { + trace = true; + } + else if (0 == strncmp(cmd, "debug", len)) + { + if (1 != sscanf(argv[++i], "%u", &debugLevel)) + { + fprintf(stderr, "normServer error: invalid debug level\n"); + return -1; + } + } + else + { + fprintf(stderr, "normServer error: invalid command \"%s\"\n", cmd); + return -1; + } + } + + // For unicast operation in this demo app, the server only "talks back" + // to one client on a first come, first serve basis. (Multiple clients + // can connect and send data _to_ the server, but in this simple example, + // the server only sends to one at a time. For the multicast server case, + // the server multicasts to the entire group. + NormSocketHandle firstClientSocket = NORM_SOCKET_INVALID; + + NormInstanceHandle instance = NormCreateInstance(); + + NormSocketHandle serverSocket = NormListen(instance, serverPort, groupAddrPtr); + + if (trace) NormSetMessageTrace(NormGetSession(serverSocket), true); + if (0 != debugLevel) NormSetDebugLevel(debugLevel); + + //NormSetDebugLevel(8); + //NormSetMessageTrace(NormGetSession(serverSocket), true); + + // We use a select() call to multiplex input reading and NormSocket handling + fd_set fdset; + FD_ZERO(&fdset); + + // Get our input (STDIN) descriptor and set non-blocking + FILE* inputFile = stdin; + int inputfd = fileno(inputFile); + if (-1 == fcntl(inputfd, F_SETFL, fcntl(inputfd, F_GETFL, 0) | O_NONBLOCK)) + perror("normClient: fcntl(inputfd, O_NONBLOCK) error"); + // Get our NormInstance descriptor + int normfd = NormGetDescriptor(instance); + bool keepGoing = true; + bool writeReady = false; + unsigned int inputLength = 0; + unsigned int bytesWritten = 0; + const unsigned int BUFFER_LENGTH = 2048; + char inputBuffer[BUFFER_LENGTH]; + bool inputNeeded = false; // will be set to "true" upon CONNECT + while (keepGoing) + { + FD_SET(normfd, &fdset); + int maxfd = normfd; + if (inputNeeded) + { + FD_SET(inputfd, &fdset); + if (inputfd > maxfd) maxfd = inputfd; + } + else + { + FD_CLR(inputfd, &fdset); + } + int result = select(maxfd+1, &fdset, NULL, NULL, NULL); + if (result <= 0) + { + perror("normClient: select() error"); + break; + } + if (FD_ISSET(inputfd, &fdset)) + { + // Read input into our txBuffer + inputLength = fread(inputBuffer, 1, BUFFER_LENGTH, inputFile); + if (inputLength > 0) + { + // We got our input + bytesWritten = 0; + inputNeeded = false; + } + else if (feof(inputFile)) + { + // TBD - initiate server shutdown if it's job is + // only until the input is closed + // Meanwhile, we just stick around to receive stuff from the clients + inputNeeded = false; // TBD - should also fclose(inputFile)?? + } + else if (ferror(inputFile)) + { + switch (errno) + { + case EINTR: + // interupted, try again + break; + case EAGAIN: + // input starved, wait for next notification + break; + default: + perror("normClient: error reading input"); + break; + } + } + } + if (FD_ISSET(normfd, &fdset)) + { + + // There's a NORM event pending + NormSocketEvent event; + if (NormGetSocketEvent(instance, &event)) + { + ClientInfo clientInfo; + if (NORM_NODE_INVALID != event.sender) + clientInfo = NormGetClientInfo(event.sender); + switch (event.type) + { + case NORM_SOCKET_ACCEPT: + { + if (event.socket == serverSocket) + { + // Possibly a new "client" connecting to our "server" + // First confirm that this really is a new client. + if (NORM_SOCKET_INVALID != FindClientSocket(clientMap, clientInfo)) + { + // We think we're already connected to this client + fprintf(stderr, "normServer: duplicative %s client ...\n", + (NORM_REMOTE_SENDER_NEW == event.event.type) ? "new" : "reset"); + continue; + } + NormSocketHandle clientSocket = NormAccept(serverSocket, event.sender); + + // TBD - For multicast, if we are sending a tx_stream, we could flush it here to + // bring the new receiver "up to date" ... probably would be best to + // do this on some sort of timer-basis in the case of a bunch of receivers + // joining in a short window of time ... + + if (trace) // note we're already tracing the mcast session + NormSetMessageTrace(NormGetSession(clientSocket), true); + //NormSetMessageTrace(NormGetSession(clientSocket), true); + clientMap[clientInfo] = clientSocket; + fprintf(stderr, "normServer: ACCEPTED connection from %s/%hu\n", + clientInfo.GetAddressString(), clientInfo.GetPort()); + // We have at least one client, so lets serve up some juicy input + inputNeeded = true; + writeReady = true; + } + else + { + // shouldn't happen + } + break; + } + case NORM_SOCKET_CONNECT: + { + fprintf(stderr, "normServer: CONNECTED to %s/%hu ...\n", + clientInfo.GetAddressString(), clientInfo.GetPort()); + if (NORM_SOCKET_INVALID == firstClientSocket) + firstClientSocket = event.socket; + break; + } + case NORM_SOCKET_READ: + { + // This is a cue to try to read data from stream + // For our test app here, the data is read and output to STDOUT + bool rxReady = true; + while (rxReady) + { + char buffer[1024]; + ssize_t bytesRead = NormRead(event.socket, buffer, 1024); + if (bytesRead < 0) + { + // This shouldn't happen with ack-based flow control used + fprintf(stderr, "normServer: broken stream ...\n"); + continue; + } + if (bytesRead > 0) + fwrite(buffer, sizeof(char), bytesRead, stdout); + if (bytesRead < 1024) rxReady = false; + } + break; + } + case NORM_SOCKET_WRITE: + // We only demo server data transmission for the multicast server case + // (see comment below) + if ((NULL != groupAddrPtr) || (event.socket == firstClientSocket)) + writeReady = true; + break; + case NORM_SOCKET_CLOSING: + fprintf(stderr, "normServer: client %s/%hu CLOSING connection ...\n", + clientInfo.GetAddressString(), clientInfo.GetPort()); + if (event.socket == firstClientSocket) + firstClientSocket = NORM_SOCKET_INVALID; + + break; + case NORM_SOCKET_CLOSED: + { + fprintf(stderr, "normServer: connection to client %s/%hu CLOSED ...\n", + clientInfo.GetAddressString(), clientInfo.GetPort()); + if (event.socket == firstClientSocket) + firstClientSocket = NORM_SOCKET_INVALID; + clientMap.erase(clientInfo); + break; + } + case NORM_SOCKET_NONE: + break; + break; + } // end switch(event.type) + } + else + { + fprintf(stderr, "normServer: NormGetNextSocketEvent() returned false\n"); + } + } // end if FD_ISSET(normfd) + + // For our _multicast_ "normServer" example, the server can send to the group + // (For a unicast "normServer", we would need to do something more complex + // to manage sending data to each individual client that connects to us. + // So, for the moment, the unicast "normServer" only sends to the "firstClientSocket" + NormSocketHandle sendSocket = (NULL != groupAddrPtr) ? serverSocket : firstClientSocket; + if (NORM_SOCKET_INVALID != sendSocket) + { + if (writeReady && (inputLength > 0)) + { + // We have data in our inputBuffer and the NormSocket is "writeReady", so send it + bytesWritten += NormWrite(sendSocket, inputBuffer + bytesWritten, inputLength - bytesWritten); + if (bytesWritten < inputLength) + { + // Couldn't write whole inputBuffer, need to wait for NORM_SOCKET_WRITE event + writeReady = false; + } + else + { + // inputBuffer has been completely written + inputLength = 0; + inputNeeded = true; + NormFlush(sendSocket); + } + } + } + + } // end while (keepGoing) +} // end main() diff --git a/examples/normSocket.cpp b/examples/normSocket.cpp new file mode 100644 index 0000000..5b1a35f --- /dev/null +++ b/examples/normSocket.cpp @@ -0,0 +1,1037 @@ + +#include "normSocket.h" +#include // for stderr +#include // for assert() +#include // for strlen() +#include // for inet_ntoa() (TBD - change to use Protolib routines?) + +// COMPILE: (assumes "normApi.h" in "include" ... +// g++ -I../include -c normSocket.cpp + + +// This "NormSocket" class is used to maintain tx/rx state for a NORM "socket" connection. +// At the moment this "socket" connection represents a single, bi-directional NORM_OBJECT_STREAM +// in either a unicast context or an asymmetric "server" multicast stream to possibly multiple "client" +// nodes with individual unicast streams in return from those "client" nodes. (I.e., the server will need to +// have a normSocket per client even for the server multicast case (maybe :-) ) + +const NormSocketHandle NORM_SOCKET_INVALID = (NormSocketHandle)0; + +const double NORM_DEFAULT_CONNECT_TIMEOUT = 60.0; + +// a 'helper' function we use for debugging +const char* NormNodeGetAddressString(NormNodeHandle node) +{ + char addr[16]; // big enough for IPv6 + unsigned int addrLen = 16; + UINT16 port; + if (NormNodeGetAddress(node, addr, &addrLen, &port)) + { + static char text[64]; + text[0] = text[31] = '\0'; + int addrFamily; + if (4 == addrLen) + addrFamily = AF_INET; + else + addrFamily = AF_INET6; + inet_ntop(addrFamily, addr, text, 31); + sprintf(text + strlen(text), "/%hu", port); + return text; + } + else + { + return "???"; + } +} // end NormNodeGetAddressString() + +class NormSocket +{ + public: + NormSocket(NormSessionHandle normSession = NORM_SESSION_INVALID); + + // These methods identify the role of this socket with respect + // to the client / server relationship (a "server socket" is + // one for which NormListen() has been invoked). + bool IsServerSocket() const + {return (server_socket == this);} + bool IsClientSocket() const + {return (server_socket != this);} + bool IsUnicastSocket() const + {return (NORM_SESSION_INVALID == mcast_session);} + bool IsMulticastSocket() const + {return !IsUnicastSocket();} + bool IsMulticastServer() const + {return (IsMulticastSocket() && IsServerSocket());} + bool IsMulticastClient() const + {return (IsMulticastSocket() && IsClientSocket());} + bool IsServerSide() const + {return (NULL != server_socket);} + bool IsClientSide() const + {return (NULL == server_socket);} + + NormSessionHandle GetSession() const + {return norm_session;} + NormSessionHandle GetMulticastSession() const + {return mcast_session;} + + void InitRxStream(NormObjectHandle rxStream) + {rx_stream = rxStream;} + NormObjectHandle GetRxStream() const + {return rx_stream;} + + void InitTxStream(NormObjectHandle txStream, unsigned int bufferSize, UINT16 segmentSize, UINT16 blockSize) + { + tx_stream = txStream; + tx_segment_size = segmentSize; + tx_stream_buffer_max = NormGetStreamBufferSegmentCount(bufferSize, segmentSize, blockSize); + tx_stream_buffer_max -= blockSize; // a little safety margin (perhaps not necessary) + tx_stream_buffer_count = 0; + tx_stream_bytes_remain = 0; + tx_watermark_pending = false; + } + + + bool Listen(NormInstanceHandle instance, UINT16 serverPort, const char* groupAddr); + NormSocket* Accept(NormNodeHandle client, NormInstanceHandle instance = NORM_INSTANCE_INVALID); + bool Connect(NormInstanceHandle instance, const char* serverAddr, UINT16 serverPort, const char* groupAddr, NormNodeId clientId); + + + // Write to tx stream (with flow control) + unsigned int Write(const char* buffer, unsigned int numBytes); + void Flush(bool eom = false, NormFlushMode flushMode = NORM_FLUSH_ACTIVE); + // Read from rx_stream + bool Read(char* buffer, unsigned int& numBytes); + + // "graceful" shutdown (stream is flushed and stream end, etc) + void Shutdown(); + + // hard, immediate closure + void Close(); + + void GetSocketEvent(const NormEvent& event, NormSocketEvent& socketEvent); + + typedef enum State + { + CLOSED, + LISTENING, + CONNECTING, + ACCEPTING, + CONNECTED, + CLOSING + } State; + + bool AddAckingNode(NormNodeId nodeId) + { + if (NormAddAckingNode(norm_session, nodeId)) + { + client_count++; + return true; + } + else + { + return false; + } + } + void RemoveAckingNode(NormNodeId nodeId) + {NormRemoveAckingNode(norm_session, nodeId);} + + + private: + State socket_state; + NormSessionHandle norm_session; + NormSessionHandle mcast_session; // equals norm_session for a multicast server + NormSocket* server_socket; // only applies to server-side sockets + unsigned int client_count; // only applies to mcast server sockets + NormNodeId client_id; // only applies to mcast client socket + NormNodeHandle remote_node; // + // Send stream and associated flow control state variables + NormObjectHandle tx_stream; + bool tx_ready; + UINT16 tx_segment_size; + unsigned int tx_stream_buffer_max; + unsigned int tx_stream_buffer_count; + unsigned int tx_stream_bytes_remain; + bool tx_watermark_pending; + // Receive stream state + NormObjectHandle rx_stream; + +}; // end class NormSocket + + +NormSocket::NormSocket(NormSessionHandle normSession) + : socket_state(CLOSED), norm_session(normSession), + mcast_session(NORM_SESSION_INVALID), server_socket(NULL), + client_count(0), client_id(NORM_NODE_NONE), remote_node(NORM_NODE_INVALID), + tx_stream(NORM_OBJECT_INVALID), tx_ready(false), tx_segment_size(0), + tx_stream_buffer_max(0), tx_stream_buffer_count(0), + tx_stream_bytes_remain(0), tx_watermark_pending(false), + rx_stream(NORM_OBJECT_INVALID) +{ + // For now we use the NormSession "user data" option to associate + // the session with a "socket". In the future we may add a + // dedicated NormSetSocket(NormSessionHandle session, NormSocketHandle normSocket) API + // to keep the "user data" feature available for other purposes + if (NORM_SESSION_INVALID != normSession) // this should always be true + NormSetUserData(normSession, this); +} + + +bool NormSocket::Listen(NormInstanceHandle instance, UINT16 serverPort, const char* groupAddr) +{ + if (CLOSED != socket_state) + { + fprintf(stderr, "NormSocket::Listen() error: socket already open?!\n"); + return false; + } + + if (NULL != groupAddr) + { + // TBD - validate that "groupAddr" is indeed a multicast address + norm_session = NormCreateSession(instance, groupAddr, serverPort, NORM_NODE_ANY); + NormSetTxPort(norm_session, serverPort); // can't do this and receive unicast feedback + mcast_session = norm_session; + } + else + { + // For unicast , the "server" has a NormNodeId of '1' and the "clients" are '2' + // to obviate need for explicit id management and will allow NAT to work, etc + norm_session = NormCreateSession(instance, "127.0.0.1", serverPort, 1); + } + if (NORM_SESSION_INVALID == norm_session) + { + fprintf(stderr, "NormSocket::Listen() error: NormCreateSession() failure\n"); + return false; + } + NormSetUserData(norm_session, this); + // Note the port reuse here lets us manage our "client" rx-only unicast connections the + // way we need, but does allow a second multicast server to be started on this group which leads + // to undefined behavior. TBD - see if we can prevent via binding wizardry + // (How is it done for TCP servers? - probably because the accept() call is in the network stack + // instead of user-space) Perhaps we could have a semaphore lock to block a second "server" + NormSetRxPortReuse(norm_session, true); + + // use default sync policy so a "serversocket" doesn't NACK the senders it detects + // NORM_SYNC_STREAM tries to get everything the sender has cached/buffered + //NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_STREAM); + //NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_ALL); + + if (NULL == groupAddr) + { + // Unicast server + // Note we use a small buffer size here since a "listening" socket isn't + // going to be receiving data (TBD - implement a mechanism to handoff remote + // sender (i.e. "client") from parent + if (!NormStartReceiver(norm_session, 2048)) + { + fprintf(stderr, "NormSocket::Listen() error: NormStartReceiver() failure (perhaps port already in use)\n"); + NormDestroySession(norm_session); + norm_session = NORM_SESSION_INVALID; + } + } + else + { + //NormSetMulticastInterface(norm_session, "lo0"); + NormSetMulticastLoopback(norm_session, true); // for testing + if (!NormStartReceiver(norm_session, 2048)) + { + fprintf(stderr, "NormSocket::Listen() error: NormStartReceiver() failure (perhaps port already in use)\n"); + NormDestroySession(norm_session); + norm_session = NORM_SESSION_INVALID; + } + // TBD - We _could_ go ahead and call NormStartSender(), but for now we'll wait until we hear the application + // makes at least one NormAccept() call ... + } + server_socket = this; + socket_state = LISTENING; + return true; +} // end NormSocket::Listen() + +NormSocket* NormSocket::Accept(NormNodeHandle client, NormInstanceHandle instance) +{ + if (!IsServerSocket()) return NULL; + char clientAddr[64]; + clientAddr[63] = '\0'; + char addr[16]; // big enough for IPv6 + unsigned int addrLen = 16; + UINT16 clientPort; + NormNodeGetAddress(client, addr, &addrLen, &clientPort); + int addrFamily; + UINT8 version; + if (4 == addrLen) + { + addrFamily = AF_INET; + version = 4; + } + else + { + addrFamily = AF_INET6; + version = 6; + } + inet_ntop(addrFamily, addr, clientAddr, 63); + + UINT16 serverPort = NormGetRxPort(norm_session); + if (NORM_INSTANCE_INVALID == instance) + instance = NormGetInstance(norm_session); + + NormSessionHandle clientSession = NormCreateSession(instance, clientAddr, serverPort, 1); + + NormSetTxPort(clientSession, serverPort, false); + + // This next API call will cause NORM to tightly bind the remote client src addr/port to + // our server port so the "clientSession" captures the client packets instead of the "server" session + + // Any new packets will come to our new connected clientSession instead + // However, note that even though we've "connected" this sender, + // there is a chance that additional packets in the "serverSession" + // rx socket buffer may look like a new sender if deleted now, so + // we wait for NORM_REMOTE_SENDER_INACTIVE to delete + + // NORM_SYNC_STREAM tries to get everything the sender has cached/buffered + //NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_STREAM); + NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_ALL); + + NormSetRxPortReuse(clientSession, true, 0, clientAddr, clientPort); // "connects" to remote client addr/port + NormSetDefaultUnicastNack(clientSession, true); + + NormStartReceiver(clientSession, 2*1024*1024); + + NormSocket* clientSocket = new NormSocket(clientSession); + clientSocket->server_socket = this; // this is a server-side socket + clientSocket->remote_node = client; + NormNodeSetUserData(client, clientSocket); + + NormNodeId clientId = NormNodeGetId(client); + + if (IsUnicastSocket()) + { + // The clientSession is bi-directional so we need to NormStartSender(), etc + NormAddAckingNode(clientSession, 2); //clientId); + NormSetFlowControl(clientSession, 0); // disable timer-based flow control since we do explicit, ACK-based flow control + NormStartSender(clientSession, NormGetRandomSessionId(), 2*1024*1024, 1400, 16, 4); + } + else // if IsMulticastSocket() + { + // TBD - should we make sure this not a NormNodeId we already have? + // TBD - should we wait to add the client as acking node until CONNECT + // (probably for heavyweight; for lightweight we know the client + // has already started his multicast receiver) + AddAckingNode(clientId); // TBD - check result + NormNodeHandle node = NormGetAckingNodeHandle(mcast_session, clientId); + NormNodeSetUserData(node, clientSocket); // a way to track mcast client sockets + clientSocket->mcast_session = mcast_session; + clientSocket->client_id = client_id; + if (LISTENING == socket_state) + { + NormSetFlowControl(norm_session, 0); // disable timer-based flow control since we do explicit, ACK-based flow control + NormStartSender(norm_session, NormGetRandomSessionId(), 2*1024*1024, 1400, 16, 4); + socket_state = CONNECTED; + } + /* The code below would be invoked for "heavyweight" mcast client admission + (for the moment we go with a "lightweight" model - this might be invokable upon + as an optional behavior later) + + // Here, we start the clientSession (w/ a minimal buffer size) and create a temporary sender + // stream that is immediately flushed/closed to inform the "client" that his connection + // has been accepted. The sender function is terminated upon client acknowledgement + NormAddAckingNode(clientSession, clientId); + NormSetFlowControl(clientSession, 0); // disable timer-based flow control since we do explicit, ACK-based flow control + NormStartSender(clientSession, NormGetRandomSessionId(), 1024, 512, 1, 0); + NormObjectHandle tempStream = NormStreamOpen(clientSession, 1024); + NormStreamClose(tempStream, true); // Note our "trick" here to do a graceful close, _then_ watermark to get ack + NormSetWatermark(clientSession, tempStream, true); // future NORM API will add "bool watermark" option to graceful close + */ + } + clientSocket->socket_state = ACCEPTING; // will transision to CONNECTED when client is detected on new clientSession + return clientSocket; +} // end NormSocket::Accept() + +// TBD - provide options for binding to a specific local address, interface, etc +bool NormSocket::Connect(NormInstanceHandle instance, const char* serverAddr, UINT16 serverPort, const char* groupAddr, NormNodeId clientId) +{ + // For unicast connections, the "client" manages a single NormSession for send and receive + // (For multicast connections, there are two sessions: The same unicast session that will + // be set to txOnly upon CONNECT and a NormSession for multicast reception) + norm_session = NormCreateSession(instance, "127.0.0.1", 0, clientId); // TBD - use "clientId" here for mcast sockets? + if (NORM_SESSION_INVALID == norm_session) + { + fprintf(stderr, "NormSocket::Connect() error: NormCreateSession() failure\n"); + return false; + } + // NORM_SYNC_STREAM tries to get everything the sender has cached/buffered + //NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_STREAM); + NormSetDefaultSyncPolicy(norm_session, NORM_SYNC_ALL); + + NormSetUserData(norm_session, this); + NormSetRxPortReuse(norm_session, true, NULL, serverAddr, serverPort); + // TBD - for a multicast connection, the unicast receiver could be started with minimal buffer + // (not that it matters since the buffers aren't activated until a sender starts sending _data_) + if (!NormStartReceiver(norm_session, 2*1024*1024)) // to get ephemeral port assigned + { + fprintf(stderr, "NormSocket::Connect() error: unicast NormStartReceiver() failure\n"); + return false; + } + NormChangeDestination(norm_session, serverAddr, serverPort, false); // "connect" our NORM tx_socket (so we can get ICMP) + NormSessionId sessionId = NormGetRandomSessionId(); + NormAddAckingNode(norm_session, 1); // servers always have NormNodeId '1' + NormSetFlowControl(norm_session, 0); // since we do explicit, ACK-based flow control + if (!NormStartSender(norm_session, sessionId, 2*1024*1024, 1400, 16, 4)) + { + fprintf(stderr, "NormSocket::Connect() error: NormStartSender() failure\n"); + return false; + } + + if (NULL != groupAddr) + { + // Create the "mcast_session" for multicast reception + mcast_session = NormCreateSession(instance, groupAddr, serverPort, clientId); + //NormSetTxPort(mcast_session, serverPort); // TBD - not sure this is a good idea if multiple clients on a machine? + NormSetUserData(mcast_session, this); + // NORM_SYNC_STREAM tries to get everything the sender has cached/buffered + //NormSetDefaultSyncPolicy(mcast_session, NORM_SYNC_STREAM); + NormSetDefaultSyncPolicy(mcast_session, NORM_SYNC_ALL); + + NormSetDefaultUnicastNack(mcast_session, true); // we could optionally allow multicast NACKing, too + NormSetMulticastLoopback(norm_session, true); // for testing + client_id = clientId; + // TBD - make this SSM??? ... this would allow for multiple servers using the same groupAddr/port + NormSetRxPortReuse(mcast_session, true, groupAddr); // Should we upgrade rx port reuse and 'connect' to server tx port upon CONNECT? + // For a "lightweight" client->server connection establishment, we go ahead and + // stop our unicast receiver and start multicast receiver, assuming the server + // will admit us into the group. + // (TBD - provide a "heavier weight" connection acceptance confirmation/denial signal from server + // via unicast from server -> client here (i.e. keep the unicast receiver open) + if (!NormStartReceiver(mcast_session, 2*1024*1024)) // to get ephemeral port assigned + { + fprintf(stderr, "NormSocket::Connect() error: multicast NormStartReceiver() failure\n"); + return false; + } + } + else + { + // Set timeout for connect attempt (for "heavyweight" mcast connect, this would also be done) + NormSetUserTimer(norm_session, NORM_DEFAULT_CONNECT_TIMEOUT); + } + server_socket = NULL; // this is a client-side socket + + socket_state = CONNECTING; + + return true; +} // end NormSocket::Connect() + + +unsigned int NormSocket::Write(const char* buffer, unsigned int numBytes) +{ + // TBD - make sure the socket is CONNECTED first + if (IsMulticastClient() && IsServerSide()) + { + // This is multicast server rxonly client socket, so we redirect + // the write() to the associated txonly multicast socket + return server_socket->Write(buffer, numBytes); + } + // TBD - if tx_stream not yet open, open it!!! + if (NORM_OBJECT_INVALID == tx_stream) + { + tx_stream = NormStreamOpen(norm_session, 2*1024*1024); + InitTxStream(tx_stream, 2*1024*1024, 1400, 16); + } + + // This method uses NormStreamWrite(), but limits writes by explicit ACK-based flow control status + if (tx_stream_buffer_count < tx_stream_buffer_max) + { + // 1) How many buffer bytes are available? + unsigned int bytesAvailable = tx_segment_size * (tx_stream_buffer_max - tx_stream_buffer_count); + bytesAvailable -= tx_stream_bytes_remain; // unflushed segment portiomn + if (numBytes <= bytesAvailable) + { + unsigned int totalBytes = numBytes + tx_stream_bytes_remain; + unsigned int numSegments = totalBytes / tx_segment_size; + tx_stream_bytes_remain = totalBytes % tx_segment_size; + tx_stream_buffer_count += numSegments; + } + else + { + numBytes = bytesAvailable; + tx_stream_buffer_count = tx_stream_buffer_max; + } + // 2) Write to the stream + unsigned int bytesWritten = NormStreamWrite(tx_stream, buffer, numBytes); + //assert(bytesWritten == numBytes); // this could happen if timer-based flow control is left enabled + // 3) Check if we need to issue a watermark ACK request? + if (!tx_watermark_pending && (tx_stream_buffer_count >= (tx_stream_buffer_max / 2))) + { + //fprintf(stderr, "tx_engine_t::WriteToNormStream() initiating watermark ACK request (buffer count:%lu max:%lu usage:%u)...\n", + // tx_stream_buffer_count, tx_stream_buffer_max, NormStreamGetBufferUsage(tx_stream)); + NormSetWatermark(norm_session, tx_stream); + tx_watermark_pending = true; + } + return bytesWritten; + } + else + { + return 0; + } +} // end NormSocket::Write() + +void NormSocket::Flush(bool eom, NormFlushMode flushMode) +{ + // TBD - make sure the socket is CONNECTED first + if (IsMulticastClient() && IsServerSide()) + { + // This is multicast server rxOnly client socket, so we redirect + // the flush() to the associated txonly multicast socket + return server_socket->Flush(eom, flushMode); + } + + // NormStreamFlush always will transmit pending runt segments, if applicable + // (thus we need to manage our buffer counting accordingly if pending bytes remain) + if (tx_watermark_pending) + { + NormStreamFlush(tx_stream, eom, flushMode); + } + else if (NORM_FLUSH_ACTIVE == flushMode) + { + // we flush passive, because watermark forces active ack request + NormStreamFlush(tx_stream, eom, NORM_FLUSH_PASSIVE); + NormSetWatermark(norm_session, tx_stream, true); + } + else + { + NormStreamFlush(tx_stream, eom, flushMode); + } + + if (0 != tx_stream_bytes_remain) + { + // The flush forces the runt segment out, so we increment our buffer usage count + tx_stream_buffer_count++; + tx_stream_bytes_remain = 0; + if (!tx_watermark_pending && (tx_stream_buffer_count >= (tx_stream_buffer_max >> 1))) + { + //fprintf(stderr, "tx_engine_t::stream_flush() initiating watermark ACK request (buffer count:%lu max:%lu usage:%u)...\n", + // tx_stream_buffer_count, tx_stream_buffer_max); + NormSetWatermark(norm_session, tx_stream, true); + tx_watermark_pending = true; + } + } + } // end NormSocket::Flush() + + bool NormSocket::Read(char* buffer, unsigned int& numBytes) + { + // TBD - make sure rx_stream is valid! + // TBD - make sure this is not a tx only client socket ... + return NormStreamRead(rx_stream, buffer, &numBytes); + } // end NormSocket::Read() + + void NormSocket::Shutdown() + { + if ((NORM_OBJECT_INVALID == tx_stream) || + (IsServerSide() && IsMulticastClient())) + { + Close(); // close immediately since this socket doesn't control a tx_stream + } + else + { + // It controls a tx_stream, so shutdown the tx_stream gracefully + NormStreamClose(tx_stream, true); // Note our "trick" here to do a graceful close, _then_ watermark to get ack + NormSetWatermark(norm_session, tx_stream, true); // future NORM API will add "bool watermark" option to graceful close + socket_state = CLOSING; + } + } // end NormSocket::Shutdown() + + void NormSocket::Close() + { + if (IsMulticastSocket()) + { + if (IsServerSide()) + { + if (IsServerSocket()) + { + // IsMulticastSocket() guarantees the mcast_session is valid + // Dissociate remaining clients from this session and set their + // timer so that NORM_SOCKET_CLOSED events are dispatched for them + NormNodeId nodeId = NORM_NODE_NONE; + while (NormGetNextAckingNode(mcast_session, &nodeId)) + { + NormNodeHandle node = NormGetAckingNodeHandle(mcast_session, nodeId); + assert(NORM_NODE_INVALID != node); + NormSocket* clientSocket = (NormSocket*)NormNodeGetUserData(node); + NormSetUserTimer(clientSocket->norm_session, 0.0); + } + // for mcast server mcast_session == norm_session so it's destroyed below + } + else + { + // "IsServerSide()" guarantees the "server_socket" is non-NULL + // server-side multicast client socket closing, so we + // need to remove this "client" NormNodeId from the mcast + // session's acking node list + server_socket->RemoveAckingNode(client_id); + } + } + else // client-side multicast socket, so we need to destroy mcast_session, too + { + NormDestroySession(mcast_session); + } + mcast_session = NORM_SESSION_INVALID; + } + if (NORM_SESSION_INVALID != norm_session) + { + NormDestroySession(norm_session); + norm_session = NORM_SESSION_INVALID; + } + server_socket = NULL; + tx_stream = NORM_OBJECT_INVALID; + tx_segment_size = 0; + tx_stream_buffer_max = tx_stream_buffer_count = tx_stream_bytes_remain = 0; + tx_watermark_pending = false; + rx_stream = NORM_OBJECT_INVALID; + socket_state = CLOSED; + } // end NormSocket::Close() + + +void NormSocket::GetSocketEvent(const NormEvent& event, NormSocketEvent& socketEvent) +{ + socketEvent.socket = (NormSocketHandle)this; + socketEvent.type = NORM_SOCKET_NONE; // default socket event type if no socket-specific state change occurs + socketEvent.event = event; + switch (event.type) + { + case NORM_TX_QUEUE_EMPTY: + case NORM_TX_QUEUE_VACANCY: + { + // The socket may be tx ready, so issue a NORM_SOCKET_WRITE event + if (CONNECTED == socket_state) + { + if (!tx_ready) + { + tx_ready = true; + socketEvent.type = NORM_SOCKET_WRITE; + } + } + break; + } + case NORM_TX_WATERMARK_COMPLETED: + { + switch (socket_state) + { + case ACCEPTING: + { + // This only comes into play for the "confirmed connection" + // model for multicast sockets (not yet implemented) + assert(0); + assert(IsServerSide() && IsMulticastClient()); + if (NORM_ACK_SUCCESS == NormGetAckingStatus(norm_session)) + { + // Client has acknowledged our acceptance + socketEvent.type = NORM_SOCKET_CONNECT; + NormStopSender(norm_session); // the mcast_session is our tx channel + break; + } + else + { + // Client didn't acknowledge, so we cull him from our server + Close(); + socketEvent.type = NORM_SOCKET_CLOSED; + } + break; + } + case CLOSING: + { + // Socket that was shutdown has either been acknowledged or timed out + // TBD - should we issue a different event if ACK_FAILURE??? + Close(); + socketEvent.type = NORM_SOCKET_CLOSED; + break; + } + default: + { + // TBD - implement option for more persistence + bool success = false; + if (NORM_ACK_SUCCESS == NormGetAckingStatus(norm_session)) + { + success = true; + } + else + { + // At least one receiver didn't acknowledge + if (IsUnicastSocket() || IsMulticastClient()) + { + // We could be infinitely persistent w/ NormResetWatermark() + //NormResetWatermark(event.session); + // For now, we'll just declare the connection broken/closed + Close(); + socketEvent.type = NORM_SOCKET_CLOSED; + } + else + { + // Multicast server, so determine who failed to acknowledge + // and cull them from our acking node list ... and shutdown + // their associated unicast sockets ... ugh!!! + NormNodeId nodeId = NORM_NODE_NONE; + NormAckingStatus ackingStatus; + while (NormGetNextAckingNode(mcast_session, &nodeId, &ackingStatus)) + { + if (NORM_ACK_SUCCESS == ackingStatus) + { + success = true; // there was at least one success + } + else + { + NormNodeHandle node = NormGetAckingNodeHandle(mcast_session, nodeId); + assert(NORM_NODE_INVALID != node); + NormSocket* clientSocket = (NormSocket*)NormNodeGetUserData(node); + assert(NULL != clientSocket); + // We use the session timer to dispatch a NORM_SOCKET_CLOSED per failed client + // (This will also remove the client from this server's acking list) + NormSetUserTimer(clientSocket->norm_session, 0.0); + clientSocket->socket_state = CLOSING; + } + } + // TBD - what do we if all clients failed ... issue a NORM_SOCKET_DISCONNECT event, + // probably stop sending data and resume when a new client appears ??? + } + } + if (tx_watermark_pending && success) + { + // flow control acknowledgement + tx_watermark_pending = false; + tx_stream_buffer_count -= (tx_stream_buffer_max >> 1); + if (!tx_ready) + { + tx_ready = true; + socketEvent.type = NORM_SOCKET_WRITE; + } + } + break; + } + } + break; + } + case NORM_REMOTE_SENDER_RESET: + case NORM_REMOTE_SENDER_NEW: + { + switch (socket_state) + { + case LISTENING: + socketEvent.type = NORM_SOCKET_ACCEPT; + break; + case ACCEPTING: + if (IsServerSide() && IsClientSocket() && (NORM_NODE_INVALID != remote_node)) + NormNodeDelete(remote_node); + case CONNECTING: + // TBD - We should validate that it's the right remote sender + // (i.e., by source address and/or nodeId) + NormCancelUserTimer(norm_session); + socketEvent.type = NORM_SOCKET_CONNECT; + socket_state = CONNECTED; + remote_node = event.sender; + break; + case CONNECTED: + if (IsMulticastSocket()) + { + if (IsServerSocket()) + { + // New client showing up at our multicast party + socketEvent.type = NORM_SOCKET_ACCEPT; + } + else + { + // Different sender showing up in multicast group!? + fprintf(stderr, "NormSocket warning: multicast sender %s reset?!\n", NormNodeGetAddressString(event.sender)); + // TBD - should Close() the socket and issue a NORM_SOCKET_CLOSED event + // and leave it up to the application to reconnect? Or should we + // provides some sort of NORM_SOCKET_DISCONNECT event + socketEvent.type = NORM_SOCKET_CLOSED; + Close(); + } + } + else // unicast + { + // Eemote sender reset? How do we tell? + fprintf(stderr, "NormSocket warning: unicast sender %s reset?!\n", NormNodeGetAddressString(event.sender)); + socketEvent.type = NORM_SOCKET_CLOSED; + Close(); + } + break; + + default: // CLOSING, CLOSED + // shouldn't happen + break; + } + break; + } + case NORM_SEND_ERROR: + { + switch (socket_state) + { + case CONNECTING: + case ACCEPTING: + case CONNECTED: + case CLOSING: + if (IsMulticastServer()) + fprintf(stderr, "SEND_ERROR on a multicast server socket?!\n"); + socketEvent.event.sender = remote_node; + socketEvent.type = NORM_SOCKET_CLOSED; + Close(); + break; + default: + // shouldn't happen + break; + } + break; + } + + case NORM_USER_TIMEOUT: + { + switch (socket_state) + { + case CONNECTING: // client connection attempt timed out + case ACCEPTING: // accepted client didn't follow through + case CONNECTED: // multicast client ack failure + case CLOSING: + socketEvent.event.sender = remote_node; + socketEvent.type = NORM_SOCKET_CLOSED; + Close(); + break; + default: + // shouldn't happen + assert(0); + break; + } + break; + } + case NORM_REMOTE_SENDER_INACTIVE: + { + switch (socket_state) + { + case LISTENING: + { + // delete state for remote sender that has been accepted (or not) + // TBD - do something a little more tidy here + NormSocket* clientSocket = (NormSocket*)NormNodeGetUserData(event.sender); + if ((NULL != clientSocket) && (clientSocket->remote_node == event.sender)) + clientSocket->remote_node = NORM_NODE_INVALID; + NormNodeDelete(event.sender); + break; + } + case CONNECTED: + { + if (IsServerSocket()) + { + NormSocket* clientSocket = (NormSocket*)NormNodeGetUserData(event.sender); + if ((NULL != clientSocket) && (clientSocket->remote_node == event.sender)) + clientSocket->remote_node = NORM_NODE_INVALID; + NormNodeDelete(event.sender); + } + // TBD - should we do something here (perhaps issue a NORM_SOCKET_IDLE event or something + // that could be used as a clue that our "connection" may have broken or timed out??? + // (Meanwhile, applications will have to figure that our for themselves) + break; + } + default: // CONNECTING, ACCEPTING, CLOSING, CLOSED + { + // shouldn't happen + break; + } + } + break; + } + case NORM_RX_OBJECT_NEW: + { + switch (socket_state) + { + case LISTENING: + // TBD - shouldn't happen, delete sender right away? + break; + case CONNECTED: + // TBD - make sure the sender is who we expect it to be??? + if (IsServerSocket()) break; + if (NORM_OBJECT_INVALID == rx_stream) + { + // We're expecting this, new stream ready for reading ... + InitRxStream(event.object); + socketEvent.type = NORM_SOCKET_READ; + } + else + { + // Stream reset + fprintf(stderr, "NormSocket::GetSocketEvent(): client stream reset?!\n"); + } + break; + default: // CONNECTING, ACCEPTING, CLOSING, CLOSED + // shouldn't happen + break; + } + break; + } + case NORM_RX_OBJECT_UPDATED: + { + switch (socket_state) + { + case CONNECTED: + case CLOSING: // we allow reading during graceful closure + // TBD - use an rx_ready indication to filter this event a little more + if (IsServerSocket()) break; // we don't receive data on server socket + assert(event.object == rx_stream); + socketEvent.type = NORM_SOCKET_READ; + break; + default: + // shouldn't happen + break; + } + break; + } + case NORM_RX_OBJECT_COMPLETED: + { + rx_stream = NORM_OBJECT_INVALID; + switch (socket_state) + { + case CONNECTED: + // Initiate graceful closure of our tx_stream to allow at least some time to + // acknowledge the remote before closing everything down + NormStreamClose(tx_stream, true); // Note our "trick" here to do a graceful close, _then_ watermark to get ack + NormSetWatermark(norm_session, tx_stream, true); // future NORM API will add "bool watermark" option to graceful close + socket_state = CLOSING; + socketEvent.type = NORM_SOCKET_CLOSING; + break; + + case CLOSING: + // We're already closing, so just let that complete. This helps make sure we allow + // at least some time to acknowledge the remote before closing everything down + break; + default: + // shouldn't happen + break; + } + } + default: + break; + } +} // end NormSocket::GetSocketEvent() + + + + /////////////////////////////////////////////////////////////////////////////////// + // NormSocket API implementation + +// TBD - provide options for binding to a specific local address, interface, etc +NormSocketHandle NormListen(NormInstanceHandle instance, UINT16 serverPort, const char* groupAddr) +{ + // TBD - check results + NormSocket* normSocket = new NormSocket(); + normSocket->Listen(instance, serverPort, groupAddr); + return (NormSocketHandle)normSocket; +} // end NormListen() + + +NormSocketHandle NormAccept(NormSocketHandle serverSocket, NormNodeHandle client) +{ + // TBD - VALIDATE PARAMETERS AND ERROR CHECK ALL THE API CALLS MADE HERE !!!!! + NormSocket* s = (NormSocket*)serverSocket; + return (NormSocketHandle)(s->Accept(client)); +} // end NormAccept() + + +// TBD - provide options for binding to a specific local address, interface, etc +NormSocketHandle NormConnect(NormInstanceHandle instance, const char* serverAddr, UINT16 serverPort, const char* groupAddr, NormNodeId clientId) +{ + NormSocket* normSocket = new NormSocket(); + if (NULL == normSocket) + { + perror("NormConnect() new NormSocket() error"); + return NULL; + } + if (normSocket->Connect(instance, serverAddr, serverPort, groupAddr, clientId)) + { + return normSocket; + } + else + { + delete normSocket; + return NULL; + } +} // end NormConnect() + + +ssize_t NormWrite(NormSocketHandle normSocket, const void *buf, size_t nbyte) +{ + // TBD - we could make write() and read() optionally blocking or non-blocking + // by using GetSocketEvent() as appropriate (incl. returning error conditions, etc) + NormSocket* s = (NormSocket*)normSocket; + return (ssize_t)s->Write((const char*)buf, nbyte); +} // end NormWrite() + +int NormFlush(NormSocketHandle normSocket) +{ + NormSocket* s = (NormSocket*)normSocket; + s->Flush(); + return 0; +} // end NormFlush() + +ssize_t NormRead(NormSocketHandle normSocket, void *buf, size_t nbyte) +{ + // TBD - we could make write() and read() optionally blocking or non-blocking + // by using GetSocketEvent() as appropriate (incl. returning error conditions, etc) + NormSocket* s = (NormSocket*)normSocket; + // TBD - make sure s->rx_stream is valid + unsigned int numBytes = nbyte; + if (s->Read((char*)buf, numBytes)) + return numBytes; + else + return -1; // broken stream error (TBD - enumerate socket error values) +} // end NormWrite() + + +void NormShutdown(NormSocketHandle normSocket) +{ + NormSocket* s = (NormSocket*)normSocket; + s->Shutdown(); +} // end NormShutdown() + +void NormClose(NormSocketHandle normSocket) +{ + NormSocket* s = (NormSocket*)normSocket; + s->Close(); +} // end NormClose() + +// This gets and translates low level NORM API events to NormSocket events +// given the "normSocket" state +bool NormGetSocketEvent(NormInstanceHandle instance, NormSocketEvent* socketEvent, bool waitForEvent) +{ + if (NULL == socketEvent) return false; + NormEvent event; + if (NormGetNextEvent(instance, &event, waitForEvent)) + { + NormSocket* normSocket = NULL; + if (NORM_SESSION_INVALID != event.session) + normSocket = (NormSocket*)NormGetUserData(event.session); + if (NULL == normSocket) + { + socketEvent->type = NORM_SOCKET_NONE; + socketEvent->socket = NORM_SOCKET_INVALID; + socketEvent->event = event; + } + else + { + normSocket->GetSocketEvent(event, *socketEvent); + } + return true; + } + else + { + return false; + } +} // end NormGetSocketEvent() + +// Other helper functions + +NormSessionHandle NormGetSession(NormSocketHandle normSocket) +{ + NormSocket* s = (NormSocket*)normSocket; + return s->GetSession(); +} // end NormGetSession() + +NormSessionHandle NormGetMulticastSession(NormSocketHandle normSocket) +{ + NormSocket* s = (NormSocket*)normSocket; + return s->GetMulticastSession(); +} // end NormGetSession() diff --git a/examples/normSocket.h b/examples/normSocket.h new file mode 100644 index 0000000..a4e3ebb --- /dev/null +++ b/examples/normSocket.h @@ -0,0 +1,120 @@ + +#ifndef _NORM_SOCKET +#define _NORM_SOCKET + +// IMPORTANT NOTE: THIS IS A WORK IN PROGRESS. This code, if/when fully developed, will be +// "promoted" from the 'examples' directory to a standard part of the NORM +// library if appropriate. + +// This provides a higher level API that facilitates a socket-like programming interface +// to use NORM for a specific usage pattern. The usage pattern uses NORM_OBJECT_STREAM +// (as a byte-stream initially with eventual support for NORM's message-stream capability, too) +// where "clients" explicitly connect to a "server" and bi-directional stream communication is +// established. This enables ACK-based flow control to/from the server and client(s). This +// is supported for NORM unicast and also (as this is completed) an asymmetric model where the +// server can multicast to the clients while the clients unicast back to the server. + + +// TODO: +// +// 0) Make "NormInstanceHandle" optional for Listen/Connect/Accept +// (for eventual blocking usage, it wouldn't be needed) +// 1) Support asymmetric server->multicast, client->unicast model +// 2) Provide non-blocking option for read/write calls +// 3) leverage ICMP (e.g., port unreachable) feedback to detect connect() failure (DONE) +// 4) provide means for connect() to time out??? (DONE) +// 5) Separate socket open (i.e. session creation) from connect/accept to allow +// opportunity for application to set NORM parameters prior to sender/receiver start +// 6) Extend to include message stream, and data/file object sockets +// 7) Option to associate NORM_INFO w/ stream (or objects eventually) + + +// Here is a list of NORM parameters that need to be set _before_ sender or receiver +// startup. These will need to be "NormSocket" parameters that can be set after +// NormOpen() but before NormListen(), NormAccept(), or NormConnect(): +// +// a) SSM source address (perhaps incorporate into NormListen() and NormConnect()?) +// b) TTL (could be set _after_ connect/accept, but may be something convenient to preset? +// c) TOS (same as for TTL) +// d) Fragmentation (not one to worry much about initially?) +// e) FEC parameters (block size, parity count, segment size, "auto" parity) +// f) Buffer size (sender, stream, receiver) +// g) cache bounds / limits + +#include "normApi.h" + +typedef const void* NormSocketHandle; + +extern const NormSocketHandle NORM_SOCKET_INVALID; + +extern const double NORM_DEFAULT_CONNECT_TIMEOUT; + +#ifndef NULL +#define NULL 0 +#endif // !NULL + +// Main NormSocket API Functions + +NormSocketHandle NormOpen(NormInstanceHandle instance = NORM_INSTANCE_INVALID); + +NormSocketHandle NormListen(NormInstanceHandle instance, UINT16 serverPort, const char* groupAddr = NULL); + +NormSocketHandle NormConnect(NormInstanceHandle instance, + const char* serverAddr, + UINT16 serverPort, + const char* groupAddr = NULL, + NormNodeId clientId = NORM_NODE_NONE); + +NormSocketHandle NormAccept(NormSocketHandle serverSocket, NormNodeHandle clientNode, NormInstanceHandle instance = NORM_INSTANCE_INVALID); + +void NormShutdown(NormSocketHandle normSocket); + +void NormClose(NormSocketHandle normSocket); + +ssize_t NormRead(NormSocketHandle normSocket, void *buf, size_t nbyte); + +ssize_t NormWrite(NormSocketHandle normSocket, const void *buf, size_t nbyte); + +int NormFlush(NormSocketHandle normSocket); + +// Helper API functions + +NormSessionHandle NormGetSession(NormSocketHandle normSocket); +NormSessionHandle NormGetMulticastSession(NormSocketHandle normSocket); + +typedef enum NormSocketEventType +{ + NORM_SOCKET_NONE = 0, + NORM_SOCKET_ACCEPT, // only issued for listening server sockets + NORM_SOCKET_CONNECT, // notification confirming connection to server + NORM_SOCKET_READ, // edge-triggered notification that socket is ready for reading + NORM_SOCKET_WRITE, // edge-triggered notification that socket is ready for writing + NORM_SOCKET_CLOSING, // indicates remote endpoint is closing socket (only read data at this point) + NORM_SOCKET_CLOSED // indicates socket is now closed (invalid for further operations) +} NormSocketEventType; + +typedef struct +{ + NormSocketEventType type; + NormSocketHandle socket; + // The underlying NormEvent is embedded. The union + // here lets us access the NormEvent fields directly. + // (E.g., *.sender, *.object, etc. as needed) + union + { + NormEvent event; // underlying NormEvent that evoked this socketEvent + struct + { + NormEventType etype; // underlying NormEventType + NormSessionHandle session; // NormEvent session + NormNodeHandle sender; // NormEvent sender + NormObjectHandle object; // NormEvent object + }; + }; +} NormSocketEvent; + +bool NormGetSocketEvent(NormInstanceHandle normInstance, NormSocketEvent* event, bool waitForEvent = true); + + + +#endif // !_NORM_SOCKET diff --git a/include/normApi.h b/include/normApi.h index 7708f66..6e8b702 100644 --- a/include/normApi.h +++ b/include/normApi.h @@ -173,6 +173,8 @@ typedef enum NormEventType NORM_TX_RATE_CHANGED, NORM_LOCAL_SENDER_CLOSED, NORM_REMOTE_SENDER_NEW, + NORM_REMOTE_SENDER_RESET, // remote sender instanceId or FEC params changed + NORM_REMOTE_SENDER_ADDRESS, // remote sender src addr and/or port changed NORM_REMOTE_SENDER_ACTIVE, NORM_REMOTE_SENDER_INACTIVE, NORM_REMOTE_SENDER_PURGED, // not yet implemented @@ -184,7 +186,10 @@ typedef enum NormEventType NORM_RX_OBJECT_ABORTED, NORM_GRTT_UPDATED, NORM_CC_ACTIVE, - NORM_CC_INACTIVE + NORM_CC_INACTIVE, + NORM_ACKING_NODE_NEW, // whe NormSetAutoAcking xxx + NORM_SEND_ERROR, // ICMP error (e.g. destination unreachable) + NORM_USER_TIMEOUT // issues when timeout set by NormSetUserTimer() expires } NormEventType; typedef struct @@ -222,7 +227,6 @@ NORM_API_LINKAGE void NormResumeInstance(NormInstanceHandle instanceHandle); - // This MUST be set to enable NORM_OBJECT_FILE reception! // (otherwise received files are ignored) NORM_API_LINKAGE @@ -263,6 +267,9 @@ NormSessionHandle NormCreateSession(NormInstanceHandle instanceHandle, NORM_API_LINKAGE void NormDestroySession(NormSessionHandle sessionHandle); +NORM_API_LINKAGE +NormInstanceHandle NormGetInstance(NormSessionHandle sessionHandle); + NORM_API_LINKAGE bool NormIsUnicastAddress(const char* address); @@ -272,10 +279,19 @@ void NormSetUserData(NormSessionHandle sessionHandle, const void* userData); NORM_API_LINKAGE const void* NormGetUserData(NormSessionHandle sessionHandle); +NORM_API_LINKAGE +void NormSetUserTimer(NormSessionHandle sessionHandle, double seconds); + +NORM_API_LINKAGE +void NormCancelUserTimer(NormSessionHandle sessionHandle); + NORM_API_LINKAGE NormNodeId NormGetLocalNodeId(NormSessionHandle sessionHandle); +NORM_API_LINKAGE +UINT16 NormGetRxPort(NormSessionHandle sessionHandle); + NORM_API_LINKAGE bool NormSetTxPort(NormSessionHandle sessionHandle, UINT16 txPortNumber, @@ -291,12 +307,13 @@ void NormSetTxOnly(NormSessionHandle sessionHandle, bool connectToSessionAddress DEFAULT(false)); -// This does not affect the rx_socket binding if already bound +// This does not affect the rx_socket binding if already bound (sender or receiver already started) // (i.e., just affects where NORM packets are sent) NORM_API_LINKAGE bool NormChangeDestination(NormSessionHandle sessionHandle, const char* sessionAddress, - UINT16 sessionPort); + UINT16 sessionPort, + bool connectToSessionAddress DEFAULT(false)); NORM_API_LINKAGE void NormSetRxPortReuse(NormSessionHandle sessionHandle, @@ -319,6 +336,10 @@ NORM_API_LINKAGE bool NormSetMulticastInterface(NormSessionHandle sessionHandle, const char* interfaceName); +NORM_API_LINKAGE +bool NormSetSSM(NormSessionHandle sessionHandle, + const char* sourceAddress); + NORM_API_LINKAGE bool NormSetTTL(NormSessionHandle sessionHandle, unsigned char ttl); @@ -331,6 +352,10 @@ NORM_API_LINKAGE bool NormSetLoopback(NormSessionHandle sessionHandle, bool loopback); +NORM_API_LINKAGE +bool NormSetMulticastLoopback(NormSessionHandle sessionHandle, + bool loopback); + NORM_API_LINKAGE bool NormSetFragmentation(NormSessionHandle sessionHandle, @@ -375,13 +400,17 @@ double NormGetReportInterval(NormSessionHandle sessionHandle); NORM_API_LINKAGE NormSessionId NormGetRandomSessionId(); + +// This function has been updated so that 16-bit Reed-Solomon +// codecs can be accessed. This may cause an issue for linking +// to older versions of the NORM library NORM_API_LINKAGE bool NormStartSender(NormSessionHandle sessionHandle, NormSessionId instanceId, UINT32 bufferSpace, UINT16 segmentSize, - unsigned char numData, - unsigned char numParity); + UINT16 numData, + UINT16 numParity); NORM_API_LINKAGE void NormStopSender(NormSessionHandle sessionHandle); @@ -529,6 +558,10 @@ NORM_API_LINKAGE void NormRemoveAckingNode(NormSessionHandle sessionHandle, NormNodeId nodeId); +NORM_API_LINKAGE +NormNodeHandle NormGetAckingNodeHandle(NormSessionHandle sessionHandle, + NormNodeId nodeId); + NORM_API_LINKAGE void NormSetAutoAckingNodes(NormSessionHandle sessionHandle, NormTrackingStatus trackingStatus); @@ -540,7 +573,7 @@ NormAckingStatus NormGetAckingStatus(NormSessionHandle sessionHandle, NORM_API_LINKAGE bool NormGetNextAckingNode(NormSessionHandle sessionHandle, NormNodeId* nodeId, - NormAckingStatus* ackingStatus); + NormAckingStatus* ackingStatus DEFAULT(0)); NORM_API_LINKAGE bool NormSendCommand(NormSessionHandle sessionHandle, @@ -687,6 +720,12 @@ bool NormNodeGetAddress(NormNodeHandle nodeHandle, unsigned int* bufferLen, UINT16* port DEFAULT((UINT16*)0)); +NORM_API_LINKAGE +void NormNodeSetUserData(NormNodeHandle nodeHandle, const void* userData); + +NORM_API_LINKAGE +const void* NormNodeGetUserData(NormNodeHandle nodeHandle); + NORM_API_LINKAGE double NormNodeGetGrtt(NormNodeHandle remoteSender); @@ -702,7 +741,22 @@ void NormNodeFreeBuffers(NormNodeHandle remoteSender); NORM_API_LINKAGE void NormNodeDelete(NormNodeHandle remoteSender); -// The next 4 functions have not yet been implemented +NORM_API_LINKAGE +void NormNodeRetain(NormNodeHandle nodeHandle); + +NORM_API_LINKAGE +void NormNodeRelease(NormNodeHandle nodeHandle); + +/** Some experimental functions */ + +NORM_API_LINKAGE +void NormReleasePreviousEvent(NormInstanceHandle instanceHandle); + +NORM_API_LINKAGE +UINT32 NormCountCompletedObjects(NormSessionHandle sessionHandle); + + +// The next functions have _not_ yet been implemented // (work in progress) NORM_API_LINKAGE void NormNodeSetAutoDelete(NormNodeHandle remoteSender, @@ -712,19 +766,7 @@ NORM_API_LINKAGE bool NormNodeAllowSender(NormNodeId senderId); NORM_API_LINKAGE -bool NormNodeDenySender(NormNodeId senderId); - - -NORM_API_LINKAGE -void NormNodeRetain(NormNodeHandle nodeHandle); - -NORM_API_LINKAGE -void NormNodeRelease(NormNodeHandle nodeHandle); - -/** Some experimental functions */ - -NORM_API_LINKAGE -UINT32 NormCountCompletedObjects(NormSessionHandle sessionHandle); +bool NormNodeDenySender(NormNodeId senderId); #ifdef __cplusplus } // end extern "C" diff --git a/include/normMessage.h b/include/normMessage.h index 26bcf5d..057df7b 100644 --- a/include/normMessage.h +++ b/include/normMessage.h @@ -120,12 +120,12 @@ class NormObjectSize NormObjectSize(UINT16 msb, UINT32 lsb) { size = (Offset)lsb; -#if _FILE_OFFSET_BITS > 32 +#if (_FILE_OFFSET_BITS > 32) && !defined(ANDROID) size |= ((Offset)msb) << 32; #endif } Offset GetOffset() const {return size;} -#if _FILE_OFFSET_BITS > 32 +#if (_FILE_OFFSET_BITS > 32) && !defined(ANDROID) UINT16 MSB() const {return ((UINT16)((size >> 32) & 0x0000ffff));} #else UINT16 MSB() const {return 0;} diff --git a/include/normNode.h b/include/normNode.h index 511d2f2..22876a4 100644 --- a/include/normNode.h +++ b/include/normNode.h @@ -14,13 +14,28 @@ class NormNode friend class NormNodeListIterator; public: - NormNode(class NormSession& theSession, NormNodeId nodeId); + enum Type + { + ACKER, + SENDER, + CC_NODE + }; + + NormNode(Type theType, class NormSession& theSession, NormNodeId nodeId); virtual ~NormNode(); + Type GetType() const + {return node_type;} + NormSession& GetSession() const {return session;} void Retain(); void Release(); + void SetUserData(const void* userData) + {user_data = userData;} + const void* GetUserData() const + {return user_data;} + const ProtoAddress& GetAddress() const {return addr;} void SetAddress(const ProtoAddress& address) {addr = address;} const NormNodeId& GetId() const {return id;} @@ -52,9 +67,11 @@ class NormNode class NormSession& session; private: + Type node_type; NormNodeId id; ProtoAddress addr; unsigned int reference_count; + const void* user_data; // We keep NormNodes in a binary tree (TBD) make this a ProtoTree NormNode* parent; NormNode* right; @@ -544,6 +561,7 @@ class NormSenderNode : public NormNode // Watermark acknowledgement ProtoTimer ack_timer; + bool ack_pending; NormObjectId watermark_object_id; NormBlockId watermark_block_id; NormSegmentId watermark_segment_id; diff --git a/include/normSession.h b/include/normSession.h index d031e5e..7bea248 100644 --- a/include/normSession.h +++ b/include/normSession.h @@ -40,6 +40,8 @@ class NormController TX_RATE_CHANGED, LOCAL_SENDER_CLOSED, REMOTE_SENDER_NEW, + REMOTE_SENDER_RESET, + REMOTE_SENDER_ADDRESS, REMOTE_SENDER_ACTIVE, REMOTE_SENDER_INACTIVE, REMOTE_SENDER_PURGED, @@ -51,13 +53,16 @@ class NormController RX_OBJECT_ABORTED, GRTT_UPDATED, CC_ACTIVE, // posted when cc feedback is detected - CC_INACTIVE // posted when no cc feedback and min rate reached + CC_INACTIVE, // posted when no cc feedback and min rate reached + ACKING_NODE_NEW, + SEND_ERROR, + USER_TIMEOUT }; virtual void Notify(NormController::Event event, class NormSessionMgr* sessionMgr, class NormSession* session, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object) = 0; }; // end class NormController @@ -81,11 +86,11 @@ class NormSessionMgr void Notify(NormController::Event event, class NormSession* session, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object) { if (controller) - controller->Notify(event, this, session, sender, object); + controller->Notify(event, this, session, node, object); } void ActivateTimer(ProtoTimer& timer) {timer_mgr.ActivateTimer(timer);} @@ -163,6 +168,7 @@ class NormSession const ProtoAddress& Address() {return address;} void SetAddress(const ProtoAddress& addr) {address = addr;} bool SetMulticastInterface(const char* interfaceName); + bool SetSSM(const char* sourceAddress); bool SetTTL(UINT8 theTTL) { bool result = tx_socket->IsOpen() ? tx_socket->SetTTL(theTTL) : true; @@ -179,11 +185,18 @@ class NormSession } bool SetLoopback(bool state) { - bool result = tx_socket->IsOpen() ? tx_socket->SetLoopback(state) : true; + bool result = state ? SetMulticastLoopback(true) : true; loopback = result ? state : loopback; return result; } + bool SetMulticastLoopback(bool state) + { + bool result = tx_socket->IsOpen() ? tx_socket->SetLoopback(state) : true; + mcast_loopback = result ? state : mcast_loopback; + return result; + } + bool SetFragmentation(bool state) { bool result = tx_socket->IsOpen() ? tx_socket->SetFragmentation(state) : true; @@ -289,11 +302,11 @@ class NormSession unsigned long countMin, unsigned long countMax); void Notify(NormController::Event event, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object) { notify_pending = true; - session_mgr.Notify(event, this, sender, object); + session_mgr.Notify(event, this, node, object); notify_pending = false; } @@ -308,6 +321,8 @@ class NormSession const void* GetUserData() const {return user_data;} + void SetUserTimer(double seconds); // set to value less than zero to cancel + // Sender methods void SenderSetBaseObjectId(NormObjectId baseId) { @@ -322,6 +337,8 @@ class NormSession UINT16 numParity); void StopSender(); void SetTxOnly(bool txOnly, bool connectToSessionAddress = false); + bool GetTxOnly() const + {return tx_only;} NormStreamObject* QueueTxStream(UINT32 bufferSize, bool doubleBuffer = false, @@ -353,11 +370,16 @@ class NormSession void SenderSetAutoAckingNodes(TrackingStatus trackingStatus) {acking_auto_populate = trackingStatus;} - bool SenderAddAckingNode(NormNodeId nodeId); + NormAckingNode* SenderAddAckingNode(NormNodeId nodeId, const ProtoAddress* srcAddr = NULL); void SenderRemoveAckingNode(NormNodeId nodeId); AckingStatus SenderGetAckingStatus(NormNodeId nodeId); // Set "prevNodeId = NORM_NODE_NONE" to init this iteration (returns "false" when done) bool SenderGetNextAckingNode(NormNodeId& prevNodeId, AckingStatus* ackingStatus = NULL); + + NormAckingNode* SenderFindAckingNode(NormNodeId nodeId) const + { + return static_cast(acking_node_tree.FindNodeById(nodeId)); + } // App-defined command support methods bool SenderSendCmd(const char* cmdBuffer, unsigned int cmdLength, bool robust); @@ -557,6 +579,7 @@ class NormSession bool OnReportTimeout(ProtoTimer& theTimer); bool OnCmdTimeout(ProtoTimer& theTimer); bool OnFlowControlTimeout(ProtoTimer& theTimer); + bool OnUserTimeout(ProtoTimer& theTimer); void TxSocketRecvHandler(ProtoSocket& theSocket, ProtoSocket::Event theEvent); void RxSocketRecvHandler(ProtoSocket& theSocket, ProtoSocket::Event theEvent); @@ -624,12 +647,14 @@ class NormSession // General session parameters NormNodeId local_node_id; - ProtoAddress address; // session destination address/port - UINT8 ttl; // session multicast ttl - UINT8 tos; // session IPv4 TOS (or IPv6 traffic class - TBD) - bool loopback; // receive own traffic it true - bool fragmentation; // enable UDP/IP fragmentation (i.e. clear DF bit) if true - bool ecn_enabled; // set true to get raw packets and check for ECN status + ProtoAddress address; // session destination address/port + ProtoAddress ssm_source_addr; // optional SSM source address + UINT8 ttl; // session multicast ttl + UINT8 tos; // session IPv4 TOS (or IPv6 traffic class - TBD) + bool loopback; // receive own traffic it true + bool mcast_loopback; // enable socket multicast loopback if true + bool fragmentation; // enable UDP/IP fragmentation (i.e. clear DF bit) if true + bool ecn_enabled; // set true to get raw packets and check for ECN status char interface_name[IFACE_NAME_MAX+1]; double tx_rate; // bytes per second @@ -763,6 +788,7 @@ class NormSession double rx_loss_rate; // for uncorrelated loss double report_timer_interval; + ProtoTimer user_timer; const void* user_data; // Linkers @@ -774,6 +800,7 @@ void NormTrace(const struct timeval& currentTime, NormNodeId localId, const NormMsg& msg, bool sent, - UINT8 fecM); + UINT8 fecM, + UINT16 instId = 0); // this might not always be available to caller #endif // _NORM_SESSION diff --git a/include/normVersion.h b/include/normVersion.h index fe83e11..685004b 100644 --- a/include/normVersion.h +++ b/include/normVersion.h @@ -36,6 +36,6 @@ #ifndef _NORM_VERSION #define _NORM_VERSION -#define VERSION "1.5b4" +#define VERSION "1.5r5" #endif // _NORM_VERSION diff --git a/makefiles/Makefile.common b/makefiles/Makefile.common index a53bffd..782f17b 100644 --- a/makefiles/Makefile.common +++ b/makefiles/Makefile.common @@ -15,6 +15,7 @@ NS = ../src/sim/ns INCLUDES = $(SYSTEM_INCLUDES) -I$(UNIX) -I../include -I$(PROTOLIB)/include CFLAGS = -g -DPROTO_DEBUG -DUNIX -D_FILE_OFFSET_BITS=64 -O $(SYSTEM_CFLAGS) $(SYSTEM_HAVES) $(INCLUDES) +#CFLAGS = -g -DPROTO_DEBUG -DUNIX -D_FILE_OFFSET_BITS=64 $(SYSTEM_CFLAGS) $(SYSTEM_HAVES) $(INCLUDES) LDFLAGS = $(SYSTEM_LDFLAGS) @@ -239,7 +240,7 @@ gtf: $(GTF_OBJ) cp $@ ../bin/$@ clean: - rm -f $(COMMON)/*.o $(UNIX)/*.o $(NS)/*.o \ + rm -f $(COMMON)/*.o $(UNIX)/*.o $(NS)/*.o $(EXAMPLE)/*.o \ libnorm.a libnorm.$(SYSTEM_SOEXT) ../lib/libnorm.a ../lib/libnorm.$(SYSTEM_SOEXT) \ norm raft normTest normTest2 normThreadTest normThreadTest2 ../bin/*; $(MAKE) -C $(PROTOLIB)/makefiles -f Makefile.$(SYSTEM) clean diff --git a/makefiles/Makefile.freebsd b/makefiles/Makefile.freebsd index 3b3f68e..612c234 100644 --- a/makefiles/Makefile.freebsd +++ b/makefiles/Makefile.freebsd @@ -40,9 +40,10 @@ SYSTEM_HAVES = -DHAVE_IPV6 -DHAVE_ASSERT -DHAVE_GETLOGIN -DHAVE_FLOCK -DHAVE_DI SYSTEM_SRC = SYSTEM = freebsd -CC = g++ +CC = c++ SYSTEM_CFLAGS = -fPIC -Wall -pedantic -Wcast-align -SYSTEM_SOFLAGS = -shared +SYSTEM_SOFLAGS = -shared +SYSTEM_SOEXT = so RANLIB = ranlib AR = ar diff --git a/makefiles/Makefile.macosx b/makefiles/Makefile.macosx index 1ed670b..f8c802e 100644 --- a/makefiles/Makefile.macosx +++ b/makefiles/Makefile.macosx @@ -37,7 +37,7 @@ SYSTEM_LIBS = -lresolv -lpcap # SYSTEM_HAVES = -DMACOSX -DECN_SUPPORT -DHAVE_IPV6 -DHAVE_ASSERT -DHAVE_GETLOGIN -DHAVE_FLOCK \ --D_FILE_OFFSET_BITS=64 -DHAVE_DIRFD +-D_FILE_OFFSET_BITS=64 -DHAVE_DIRFD -DUSE_SELECT SYSTEM_SRC = ../protolib/src/unix/bpfCap.cpp diff --git a/makefiles/win32/Norm-2008.sln b/makefiles/win32/Norm-2008.sln new file mode 100644 index 0000000..026f01d --- /dev/null +++ b/makefiles/win32/Norm-2008.sln @@ -0,0 +1,63 @@ +Microsoft Visual Studio Solution File, Format Version 10.00 +# Visual Studio 2008 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormLib", "NormLib.vcproj", "{D7B0023C-8798-4918-8DA0-05C9054D70B9}" + ProjectSection(ProjectDependencies) = postProject + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "norm", "norm\norm.vcproj", "{6E1308A6-D40F-489E-A4F1-40D859380D64}" + ProjectSection(ProjectDependencies) = postProject + {D7B0023C-8798-4918-8DA0-05C9054D70B9} = {D7B0023C-8798-4918-8DA0-05C9054D70B9} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "normTest", "normTest.vcproj", "{32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}" + ProjectSection(ProjectDependencies) = postProject + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} + {182006F3-188F-466E-89FE-8421C0478691} = {182006F3-188F-466E-89FE-8421C0478691} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormDll", "NormDll.vcproj", "{182006F3-188F-466E-89FE-8421C0478691}" + ProjectSection(ProjectDependencies) = postProject + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "npc", "npc.vcproj", "{7BF4525B-9185-4296-A2BF-FFE77BB66EAF}" + ProjectSection(ProjectDependencies) = postProject + {D7B0023C-8798-4918-8DA0-05C9054D70B9} = {D7B0023C-8798-4918-8DA0-05C9054D70B9} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Protokit", "..\..\protolib\makefiles\win32\Protokit.vcproj", "{DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Release|Win32 = Release|Win32 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {D7B0023C-8798-4918-8DA0-05C9054D70B9}.Debug|Win32.ActiveCfg = Debug|Win32 + {D7B0023C-8798-4918-8DA0-05C9054D70B9}.Debug|Win32.Build.0 = Debug|Win32 + {D7B0023C-8798-4918-8DA0-05C9054D70B9}.Release|Win32.ActiveCfg = Release|Win32 + {D7B0023C-8798-4918-8DA0-05C9054D70B9}.Release|Win32.Build.0 = Release|Win32 + {6E1308A6-D40F-489E-A4F1-40D859380D64}.Debug|Win32.ActiveCfg = Debug|Win32 + {6E1308A6-D40F-489E-A4F1-40D859380D64}.Debug|Win32.Build.0 = Debug|Win32 + {6E1308A6-D40F-489E-A4F1-40D859380D64}.Release|Win32.ActiveCfg = Release|Win32 + {6E1308A6-D40F-489E-A4F1-40D859380D64}.Release|Win32.Build.0 = Release|Win32 + {32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}.Debug|Win32.ActiveCfg = Debug|Win32 + {32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}.Debug|Win32.Build.0 = Debug|Win32 + {32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}.Release|Win32.ActiveCfg = Release|Win32 + {32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}.Release|Win32.Build.0 = Release|Win32 + {182006F3-188F-466E-89FE-8421C0478691}.Debug|Win32.ActiveCfg = Debug|Win32 + {182006F3-188F-466E-89FE-8421C0478691}.Debug|Win32.Build.0 = Debug|Win32 + {182006F3-188F-466E-89FE-8421C0478691}.Release|Win32.ActiveCfg = Release|Win32 + {182006F3-188F-466E-89FE-8421C0478691}.Release|Win32.Build.0 = Release|Win32 + {7BF4525B-9185-4296-A2BF-FFE77BB66EAF}.Debug|Win32.ActiveCfg = Debug|Win32 + {7BF4525B-9185-4296-A2BF-FFE77BB66EAF}.Release|Win32.ActiveCfg = Release|Win32 + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}.Debug|Win32.ActiveCfg = Debug|Win32 + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}.Debug|Win32.Build.0 = Debug|Win32 + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}.Release|Win32.ActiveCfg = Release|Win32 + {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}.Release|Win32.Build.0 = Release|Win32 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/makefiles/win32/Norm.sln b/makefiles/win32/Norm.sln index 026f01d..4fb993f 100644 --- a/makefiles/win32/Norm.sln +++ b/makefiles/win32/Norm.sln @@ -1,32 +1,18 @@ -Microsoft Visual Studio Solution File, Format Version 10.00 -# Visual Studio 2008 -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormLib", "NormLib.vcproj", "{D7B0023C-8798-4918-8DA0-05C9054D70B9}" - ProjectSection(ProjectDependencies) = postProject - {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} - EndProjectSection +Microsoft Visual Studio Solution File, Format Version 12.00 +# Visual Studio Express 2013 for Windows Desktop +VisualStudioVersion = 12.0.30723.0 +MinimumVisualStudioVersion = 10.0.40219.1 +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormLib", "NormLib.vcxproj", "{D7B0023C-8798-4918-8DA0-05C9054D70B9}" EndProject -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "norm", "norm\norm.vcproj", "{6E1308A6-D40F-489E-A4F1-40D859380D64}" - ProjectSection(ProjectDependencies) = postProject - {D7B0023C-8798-4918-8DA0-05C9054D70B9} = {D7B0023C-8798-4918-8DA0-05C9054D70B9} - EndProjectSection +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "norm", "norm\norm.vcxproj", "{6E1308A6-D40F-489E-A4F1-40D859380D64}" EndProject -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "normTest", "normTest.vcproj", "{32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}" - ProjectSection(ProjectDependencies) = postProject - {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} - {182006F3-188F-466E-89FE-8421C0478691} = {182006F3-188F-466E-89FE-8421C0478691} - EndProjectSection +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "normTest", "normTest.vcxproj", "{32CF83E0-D2E0-4E43-8F7B-72BD0AB64647}" EndProject -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormDll", "NormDll.vcproj", "{182006F3-188F-466E-89FE-8421C0478691}" - ProjectSection(ProjectDependencies) = postProject - {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} = {DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9} - EndProjectSection +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "NormDll", "NormDll.vcxproj", "{182006F3-188F-466E-89FE-8421C0478691}" EndProject -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "npc", "npc.vcproj", "{7BF4525B-9185-4296-A2BF-FFE77BB66EAF}" - ProjectSection(ProjectDependencies) = postProject - {D7B0023C-8798-4918-8DA0-05C9054D70B9} = {D7B0023C-8798-4918-8DA0-05C9054D70B9} - EndProjectSection +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "npc", "npc.vcxproj", "{7BF4525B-9185-4296-A2BF-FFE77BB66EAF}" EndProject -Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Protokit", "..\..\protolib\makefiles\win32\Protokit.vcproj", "{DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}" +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Protokit", "..\..\protolib\makefiles\win32\Protokit.vcxproj", "{DE94F096-A09B-44B6-8EFE-C7BF1F65C4C9}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution diff --git a/makefiles/win32/Norm.suo b/makefiles/win32/Norm.suo index 2d18e9761f5a16a84f6fe2a07cec64f4711de972..e5c11445a40f7bc181b0ecb1062e419a3483d568 100644 GIT binary patch delta 17334 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 F{{>@>S#SUV diff --git a/makefiles/win32/NormDll.vcxproj b/makefiles/win32/NormDll.vcxproj new file mode 100755 index 0000000..fa07e73 --- /dev/null +++ b/makefiles/win32/NormDll.vcxproj @@ -0,0 +1,125 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + + {182006F3-188F-466E-89FE-8421C0478691} + Win32Proj + + + + DynamicLibrary + v120 + MultiByte + + + DynamicLibrary + v120 + MultiByte + + + + + + + + + + + + + + + <_ProjectFileVersion>11.0.50727.1 + + + Debug\ + Debug\ + true + + + Release\ + Release\ + false + + + + Disabled + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NORM_USE_DLL;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_LIB;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + true + EnableFastChecks + MultiThreadedDebugDLL + + Level3 + EditAndContinue + + + ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) + $(OutDir)Norm.dll + true + $(OutDir)NormDll.pdb + Windows + false + + $(OutDir)Norm.lib + MachineX86 + + + + + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NORM_USE_DLL;NDEBUG;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_LIB;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + MultiThreadedDLL + + Level3 + ProgramDatabase + + + ws2_32.lib;iphlpapi.lib;%(AdditionalDependencies) + $(OutDir)Norm.dll + true + Windows + true + true + false + + $(OutDir)Norm.lib + MachineX86 + + + + + + + + + + + + + + + + + + + + + + {de94f096-a09b-44b6-8efe-c7bf1f65c4c9} + false + + + + + + \ No newline at end of file diff --git a/makefiles/win32/NormLib.vcxproj b/makefiles/win32/NormLib.vcxproj new file mode 100755 index 0000000..432612f --- /dev/null +++ b/makefiles/win32/NormLib.vcxproj @@ -0,0 +1,121 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + + {D7B0023C-8798-4918-8DA0-05C9054D70B9} + + + + StaticLibrary + v120_xp + false + MultiByte + + + StaticLibrary + v120_xp + false + MultiByte + + + + + + + + + + + + + + + <_ProjectFileVersion>11.0.50727.1 + + + .\Debug\ + .\Debug\ + + + .\Release\ + .\Release\ + + + + Disabled + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_LIB;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + EnableFastChecks + MultiThreadedDebugDLL + + .\Debug/NormLib.pch + .\Debug/ + .\Debug/ + .\Debug/ + Level3 + true + Default + + + _DEBUG;%(PreprocessorDefinitions) + 0x0409 + + + .\Debug\NormLib.lib + true + + + + + MaxSpeed + OnlyExplicitInline + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NDEBUG;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_LIB;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + true + MultiThreadedDLL + true + + .\Release/NormLib.pch + .\Release/ + .\Release/ + .\Release/ + Level3 + true + Default + + + NDEBUG;%(PreprocessorDefinitions) + 0x0409 + + + .\Release\NormLib.lib + true + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/makefiles/win32/README.TXT b/makefiles/win32/README.TXT new file mode 100755 index 0000000..5efe011 --- /dev/null +++ b/makefiles/win32/README.TXT @@ -0,0 +1,15 @@ +Visual Studio 2012 and 2013 require different versions of the Platform Toolset: + +Visual Studio 2012 v110 (or v110_xp for applications that need to run +under Windows XP) + +Visual Studio 2013 v120 (or v120_xp for applications that need to run +under Windows XP) + +For each project included by the solution file modify the Platform +Toolset under project Configuration Properties, General as appropriate +for your Visual Studio version. + +A Visual Studio solutions file and associated .vcproj files are +included as a convenience for those using earlier versions of visual +studio (2008 and 2010): Norm-2008.sln diff --git a/makefiles/win32/norm/norm.vcxproj b/makefiles/win32/norm/norm.vcxproj new file mode 100755 index 0000000..a4772f4 --- /dev/null +++ b/makefiles/win32/norm/norm.vcxproj @@ -0,0 +1,155 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + + {6E1308A6-D40F-489E-A4F1-40D859380D64} + + + + Application + v120 + false + MultiByte + + + Application + v120 + false + MultiByte + + + + + + + + + + + + + + + <_ProjectFileVersion>11.0.61030.0 + + + .\Debug\ + .\Debug\ + false + + + .\Release\ + .\Release\ + false + + + + _DEBUG;%(PreprocessorDefinitions) + true + true + Win32 + .\Debug/norm.tlb + + + + /vmg %(AdditionalOptions) + Disabled + ..\..\..\include;..\..\..\protolib\include;%(AdditionalIncludeDirectories) + _DEBUG;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_CRT_SECURE_NO_WARNINGS;_WINDOWS;%(PreprocessorDefinitions) + EnableFastChecks + MultiThreadedDebugDLL + + .\Debug/norm.pch + .\Debug/ + .\Debug/ + .\Debug/ + Level3 + true + EditAndContinue + Default + + + _DEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + .\Debug/norm.exe + true + true + .\Debug/norm.pdb + Windows + false + + MachineX86 + + + + + NDEBUG;%(PreprocessorDefinitions) + true + true + Win32 + .\Release/norm.tlb + + + + /vmg %(AdditionalOptions) + MaxSpeed + OnlyExplicitInline + ..\..\..\include;..\..\..\protolib\include;%(AdditionalIncludeDirectories) + NDEBUG;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_WINDOWS;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + true + MultiThreadedDLL + true + + .\Release/norm.pch + .\Release/ + .\Release/ + .\Release/ + true + Level3 + true + Default + + + NDEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + .\Release/norm.exe + true + .\Release/norm.pdb + Windows + false + + MachineX86 + + + + + + + + + + {de94f096-a09b-44b6-8efe-c7bf1f65c4c9} + + + {d7b0023c-8798-4918-8da0-05c9054d70b9} + + + + + + \ No newline at end of file diff --git a/makefiles/win32/normTest.vcxproj b/makefiles/win32/normTest.vcxproj new file mode 100755 index 0000000..873b847 --- /dev/null +++ b/makefiles/win32/normTest.vcxproj @@ -0,0 +1,149 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + + {32CF83E0-D2E0-4E43-8F7B-72BD0AB64647} + normTest + + + + Application + v120 + false + MultiByte + + + Application + v120 + false + MultiByte + + + + + + + + + + + + + + + <_ProjectFileVersion>11.0.50727.1 + + + .\Debug\ + .\Debug\ + + + + .\Release\ + .\Release\ + false + false + + + + .\Debug/normTest.tlb + + + + Disabled + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NORM_USE_DLL;PROTO_DEBUG;HAVE_ASSERT;WIN32;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + EnableFastChecks + MultiThreadedDebugDLL + true + + .\Debug/normTest.pch + .\Debug/ + .\Debug/ + .\Debug/ + Level3 + true + EditAndContinue + Default + + + _DEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + .\Debug/normTest.exe + true + ./;%(AdditionalLibraryDirectories) + true + .\Debug/normTest.pdb + Console + false + + MachineX86 + + + + + .\Release/normTest.tlb + + + + MaxSpeed + OnlyExplicitInline + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NORM_USE_DLL;PROTO_DEBUG;WIN32;HAVE_ASSERT;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + true + MultiThreadedDLL + true + + .\Release/normTest.pch + .\Release/ + .\Release/ + .\Release/ + Level3 + true + ProgramDatabase + Default + + + NDEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + .\Release/normTest.exe + true + .\Release/normTest.pdb + Console + false + + MachineX86 + + + + + + + + {de94f096-a09b-44b6-8efe-c7bf1f65c4c9} + false + + + {182006f3-188f-466e-89fe-8421c0478691} + false + + + + + + \ No newline at end of file diff --git a/makefiles/win32/npc.vcxproj b/makefiles/win32/npc.vcxproj new file mode 100755 index 0000000..8198a7d --- /dev/null +++ b/makefiles/win32/npc.vcxproj @@ -0,0 +1,141 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + + {7BF4525B-9185-4296-A2BF-FFE77BB66EAF} + normTest + + + + Application + v120 + false + MultiByte + + + Application + v120 + false + MultiByte + + + + + + + + + + + + + + + <_ProjectFileVersion>11.0.50727.1 + + + .\Debug\ + .\Debug\ + + + + .\Release\ + .\Release\ + false + false + + + + .\Debug/normTest.tlb + + + + Disabled + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + EnableFastChecks + MultiThreadedDebugDLL + true + + .\Debug/normTest.pch + .\Debug/ + .\Debug/ + .\Debug/ + Level3 + true + EditAndContinue + Default + + + _DEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + true + ./;%(AdditionalLibraryDirectories) + true + Windows + false + + MachineX86 + + + + + .\Release/normTest.tlb + + + + MaxSpeed + OnlyExplicitInline + ..\..\include;..\..\protolib\include;%(AdditionalIncludeDirectories) + NDEBUG;PROTO_DEBUG;HAVE_IPV6;HAVE_ASSERT;WIN32;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions) + true + MultiThreadedDLL + true + + .\Release/normTest.pch + .\Release/ + .\Release/ + .\Release/ + Level3 + true + ProgramDatabase + Default + + + NDEBUG;%(PreprocessorDefinitions) + 0x0409 + + + iphlpapi.lib;ws2_32.lib;odbc32.lib;odbccp32.lib;%(AdditionalDependencies) + true + Windows + false + + MachineX86 + + + + + + + + {d7b0023c-8798-4918-8da0-05c9054d70b9} + false + + + + + + \ No newline at end of file diff --git a/src/common/normApi.cpp b/src/common/normApi.cpp index f09e959..84e7b4d 100644 --- a/src/common/normApi.cpp +++ b/src/common/normApi.cpp @@ -40,7 +40,7 @@ class NormInstance : public NormController void Notify(NormController::Event event, class NormSessionMgr* sessionMgr, class NormSession* session, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object); bool Startup(bool priorityBoost = false); @@ -68,10 +68,13 @@ class NormInstance : public NormController bool GetNextEvent(NormEvent* theEvent); bool SetCacheDirectory(const char* cachePath); + void ReleasePreviousEvent(); + bool NotifyQueueIsEmpty() const {return notify_queue.IsEmpty();} void PurgeSessionNotifications(NormSessionHandle sessionHandle); + void PurgeNodeNotifications(NormNodeHandle nodeHandle); void PurgeObjectNotifications(NormObjectHandle objectHandle); void PurgeNotifications(NormSessionHandle sessionHandle, NormEventType eventType); @@ -96,7 +99,7 @@ class NormInstance : public NormController static NormInstance* GetInstanceFromNode(NormNodeHandle nodeHandle) { if (NORM_NODE_INVALID == nodeHandle) return ((NormInstance*)NULL); - NormSession& session = ((NormSenderNode*)nodeHandle)->GetSession(); + NormSession& session = ((NormNode*)nodeHandle)->GetSession(); return static_cast(session.GetSessionMgr().GetController()); } static NormInstance* GetInstanceFromObject(NormObjectHandle objectHandle) @@ -158,6 +161,17 @@ class NormInstance : public NormController NormSessionMgr session_mgr; private: + void ResetNotificationEvent() + { +#ifdef WIN32 + if (0 == ResetEvent(notify_event)) + PLOG(PL_ERROR, "NormInstance::GetNextEvent() ResetEvent error: %s\n", GetErrorString()); +#else + char byte[32]; + while (read(notify_fd[0], byte, 32) > 0); // TBD - error check +#endif // if/else WIN32/UNIX + } + Notification::Queue notify_pool; Notification::Queue notify_queue; Notification* previous_notification; @@ -248,7 +262,7 @@ bool NormInstance::SetCacheDirectory(const char* cachePath) void NormInstance::Notify(NormController::Event event, class NormSessionMgr* sessionMgr, class NormSession* session, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object) { // (TBD) set a limit on how many pending notifications @@ -389,13 +403,13 @@ void NormInstance::Notify(NormController::Event event, // "Retain" any valid "object" or "sender" handles for API access if (NORM_OBJECT_INVALID != object) ((NormObject*)object)->Retain(); - else if (NORM_NODE_INVALID != sender) - ((NormSenderNode*)sender)->Retain(); + else if (NORM_NODE_INVALID != node) + ((NormNode*)node)->Retain(); bool doNotify = notify_queue.IsEmpty(); n->event.type = (NormEventType)event; n->event.session = session; - n->event.sender = sender; + n->event.sender = node; n->event.object = object; notify_queue.Append(n); @@ -422,6 +436,7 @@ void NormInstance::Notify(NormController::Event event, } } // end NormInstance::Notify() +// Purge any notifications associated with a specific object void NormInstance::PurgeObjectNotifications(NormObjectHandle objectHandle) { if (NORM_OBJECT_INVALID == objectHandle) return; @@ -449,17 +464,28 @@ void NormInstance::PurgeObjectNotifications(NormObjectHandle objectHandle) next = next->GetNext(); } } + if ((NULL != previous_notification) && (objectHandle == previous_notification->event.object)) + { + // "Release" any previously-retained object or node handle + ((NormObject*)(previous_notification->event.object))->Release(); + notify_pool.Append(previous_notification); + previous_notification = NULL; + } // TBD - check if event queue is emptied and reset event/fd } // end NormInstance::PurgeObjectNotifications() -void NormInstance::PurgeSessionNotifications(NormSessionHandle sessionHandle) +// Purge any notifications associated with a specific object +void NormInstance::PurgeNodeNotifications(NormNodeHandle nodeHandle) { + if (NORM_NODE_INVALID == nodeHandle) return; Notification* prev = NULL; Notification* next = notify_queue.GetHead(); - while (NULL != next) + while (next) { - if (next->event.session == sessionHandle) + if (nodeHandle == next->event.sender) { + // "Release" the previously-retained object handle + ((NormNode*)nodeHandle)->Release(); // Remove this notification from queue and return to pool Notification* current = next; next = next->GetNext(); @@ -471,16 +497,70 @@ void NormInstance::PurgeSessionNotifications(NormSessionHandle sessionHandle) notify_pool.Append(current); } else + { + prev = next; + next = next->GetNext(); + } + } + if ((NULL != previous_notification) && (nodeHandle == previous_notification->event.sender)) + { + // "Release" any previously-retained object or node handle + if (NORM_OBJECT_INVALID != previous_notification->event.object) + ((NormObject*)(previous_notification->event.object))->Release(); + else if (NORM_NODE_INVALID != previous_notification->event.sender) + ((NormNode*)(previous_notification->event.sender))->Release(); + notify_pool.Append(previous_notification); + previous_notification = NULL; + } + if (notify_queue.IsEmpty()) ResetNotificationEvent(); +} // end NormInstance::PurgeNodeNotifications() + +void NormInstance::PurgeSessionNotifications(NormSessionHandle sessionHandle) +{ + if (NORM_SESSION_INVALID == sessionHandle) return; + Notification* prev = NULL; + Notification* next = notify_queue.GetHead(); + while (NULL != next) + { + if (next->event.session == sessionHandle) + { + // Remove this notification from queue and return to pool + Notification* current = next; + next = next->GetNext(); + if (NULL != prev) + prev->Append(next); + else + notify_queue.RemoveHead(); + if (NULL == next) notify_queue.SetTail(prev); + if (NORM_OBJECT_INVALID != current->event.object) + ((NormObject*)current->event.object)->Release(); + else if (NORM_NODE_INVALID != current->event.sender) + ((NormNode*)current->event.sender)->Release(); + notify_pool.Append(current); + } + else { prev = next; next = next->GetNext(); } } - // TBD - check if event queue is emptied and reset event/fd + if ((NULL != previous_notification) && (sessionHandle == previous_notification->event.session)) + { + // "Release" any previously-retained object or node handle + if (NORM_OBJECT_INVALID != previous_notification->event.object) + ((NormObject*)(previous_notification->event.object))->Release(); + else if (NORM_NODE_INVALID != previous_notification->event.sender) + ((NormNode*)(previous_notification->event.sender))->Release(); + notify_pool.Append(previous_notification); + previous_notification = NULL; + } + if (notify_queue.IsEmpty()) ResetNotificationEvent(); } // end NormInstance::PurgeSessionNotifications() +// Purges notifications of a specific type for a specific session void NormInstance::PurgeNotifications(NormSessionHandle sessionHandle, NormEventType eventType) { + if (NORM_SESSION_INVALID == sessionHandle) return; Notification* prev = NULL; Notification* next = notify_queue.GetHead(); while (next) @@ -496,6 +576,10 @@ void NormInstance::PurgeNotifications(NormSessionHandle sessionHandle, NormEvent else notify_queue.RemoveHead(); if (NULL == next) notify_queue.SetTail(prev); + if (NORM_OBJECT_INVALID != current->event.object) + ((NormObject*)current->event.object)->Release(); + else if (NORM_NODE_INVALID != current->event.sender) + ((NormNode*)current->event.sender)->Release(); notify_pool.Append(current); } else @@ -504,7 +588,7 @@ void NormInstance::PurgeNotifications(NormSessionHandle sessionHandle, NormEvent next = next->GetNext(); } } - // TBD - check if event queue is emptied and reset event/fd + if (notify_queue.IsEmpty()) ResetNotificationEvent(); } // end NormInstance::PurgeNotifications() // NormInstance::dispatcher MUST be suspended _before_ calling this @@ -517,7 +601,7 @@ bool NormInstance::GetNextEvent(NormEvent* theEvent) if (NORM_OBJECT_INVALID != previous_notification->event.object) ((NormObject*)(previous_notification->event.object))->Release(); else if (NORM_NODE_INVALID != previous_notification->event.sender) - ((NormSenderNode*)(previous_notification->event.sender))->Release(); + ((NormNode*)(previous_notification->event.sender))->Release(); notify_pool.Append(previous_notification); previous_notification = NULL; } @@ -556,23 +640,17 @@ bool NormInstance::GetNextEvent(NormEvent* theEvent) else if (NULL != theEvent) { theEvent->type = NORM_EVENT_INVALID; - theEvent->session = NORM_SESSION_INVALID; - theEvent->sender = NORM_SESSION_INVALID; - theEvent->object = NORM_SESSION_INVALID; - } - if (notify_queue.IsEmpty()) - { -#ifdef WIN32 - if (0 == ResetEvent(notify_event)) - PLOG(PL_ERROR, "NormInstance::GetNextEvent() ResetEvent error: %s\n", GetErrorString()); -#else - char byte[32]; - while (read(notify_fd[0], byte, 32) > 0); // TBD - error check -#endif // if/else WIN32/UNIX + theEvent->session = NORM_SESSION_INVALID; + theEvent->sender = NORM_NODE_INVALID; + theEvent->object = NORM_OBJECT_INVALID; } + if (notify_queue.IsEmpty()) + ResetNotificationEvent(); return (NULL != n); } // end NormInstance::GetNextEvent() + + bool NormInstance::WaitForEvent() { if (!dispatcher.IsThreaded()) @@ -640,6 +718,35 @@ bool NormInstance::Startup(bool priorityBoost) return dispatcher.StartThread(priorityBoost); } // end NormInstance::Startup() + + +void NormInstance::ReleasePreviousEvent() +{ + // Garbage collect our "previous_notification" + if (NULL != previous_notification) + { + // Release any previously-retained object or node handles + if (NORM_OBJECT_INVALID != previous_notification->event.object) + ((NormObject*)(previous_notification->event.object))->Release(); + else if (NORM_NODE_INVALID != previous_notification->event.sender) + ((NormNode*)(previous_notification->event.sender))->Release(); + notify_pool.Append(previous_notification); + previous_notification = NULL; + } +} // end NormInstance::ReleasePreviousEvent() + +NORM_API_LINKAGE +void NormReleasePreviousEvent(NormInstanceHandle instanceHandle) +{ + NormInstance* instance = (NormInstance*)instanceHandle; + if (instance && instance->dispatcher.SuspendThread()) + { + instance->ReleasePreviousEvent(); + instance->dispatcher.ResumeThread(); + } +} // end NormReleasePreviousEvent() + + void NormInstance::Shutdown() { dispatcher.Stop(); @@ -670,7 +777,7 @@ void NormInstance::Shutdown() if (NORM_OBJECT_INVALID != previous_notification->event.object) ((NormObject*)(previous_notification->event.object))->Release(); else if (NORM_NODE_INVALID != previous_notification->event.sender) - ((NormSenderNode*)(previous_notification->event.sender))->Release(); + ((NormNode*)(previous_notification->event.sender))->Release(); notify_pool.Append(previous_notification); previous_notification = NULL; } @@ -699,7 +806,7 @@ void NormInstance::Shutdown() if (NORM_OBJECT_INVALID != n->event.object) ((NormObject*)(n->event.object))->Release(); else if (NORM_NODE_INVALID != n->event.sender) - ((NormSenderNode*)(n->event.sender))->Release(); + ((NormNode*)(n->event.sender))->Release(); delete n; } notify_pool.Destroy(); @@ -838,8 +945,8 @@ bool NormGetNextEvent(NormInstanceHandle instanceHandle, NormEvent* theEvent, bo if (!instance->WaitForEvent()) { // Indication that NormInstance is dead - // TBD - how do we inform app although this shouldn't - // happen unless the app destroys the "instance" + // TBD - how do we inform app although this shouldn't + // happen unless the app destroys the "instance" return false; } // re-suspend thread after wait @@ -857,6 +964,7 @@ bool NormGetNextEvent(NormInstanceHandle instanceHandle, NormEvent* theEvent, bo NORM_API_LINKAGE bool NormIsUnicastAddress(const char* address) { + // TBD - is this really a thread-safe thing to do? ProtoAddress addr; if ((NULL != address) && addr.ResolveFromString(address)) return addr.IsUnicast(); @@ -873,11 +981,13 @@ NormSessionHandle NormCreateSession(NormInstanceHandle instanceHandle, { // (TBD) wrap this with SuspendThread/ResumeThread ??? NormInstance* instance = (NormInstance*)instanceHandle; - if (instance) + if (instance && instance->dispatcher.SuspendThread()) { NormSession* session = instance->session_mgr.NewSession(sessionAddr, sessionPort, localNodeId); - if (session) return ((NormSessionHandle)session); + instance->dispatcher.ResumeThread(); + if (session) + return ((NormSessionHandle)session); } return NORM_SESSION_INVALID; } // end NormCreateSession() @@ -886,34 +996,35 @@ NORM_API_LINKAGE void NormDestroySession(NormSessionHandle sessionHandle) { NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); - if (instance) - { - if (instance->dispatcher.SuspendThread()) - { - NormSession* session = (NormSession*)sessionHandle; - if (NULL != session) - { - session->Close(); - session->GetSessionMgr().DeleteSession(session); - instance->PurgeSessionNotifications(sessionHandle); - } - instance->dispatcher.ResumeThread(); + if (instance && instance->dispatcher.SuspendThread()) + { + NormSession* session = (NormSession*)sessionHandle; + if (NULL != session) + { + session->Close(); + session->GetSessionMgr().DeleteSession(session); + instance->PurgeSessionNotifications(sessionHandle); } + instance->dispatcher.ResumeThread(); } } // end NormDestroySession() +NORM_API_LINKAGE +NormInstanceHandle NormGetInstance(NormSessionHandle sessionHandle) +{ + + return (NormInstanceHandle)NormInstance::GetInstanceFromSession(sessionHandle); +} // end NormGetIntance() + NORM_API_LINKAGE void NormSetUserData(NormSessionHandle sessionHandle, const void* userData) { NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); - if (instance) - { - if (instance->dispatcher.SuspendThread()) - { - NormSession* session = (NormSession*)sessionHandle; - if (session) session->SetUserData(userData); - instance->dispatcher.ResumeThread(); - } + if (instance && instance->dispatcher.SuspendThread()) + { + NormSession* session = (NormSession*)sessionHandle; + if (session) session->SetUserData(userData); + instance->dispatcher.ResumeThread(); } } // end NormSetUserData() @@ -935,6 +1046,40 @@ const void* NormGetUserData(NormSessionHandle sessionHandle) return userData; } // end NormGetUserData() + +NORM_API_LINKAGE +void NormSetUserTimer(NormSessionHandle sessionHandle, double seconds) +{ + NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); + if (instance) + { + if (instance->dispatcher.SuspendThread()) + { + NormSession* session = (NormSession*)sessionHandle; + if (session) session->SetUserTimer(seconds); + instance->PurgeNotifications(sessionHandle, NORM_USER_TIMEOUT); + instance->dispatcher.ResumeThread(); + } + } +} // end NormSetUserTimer() + +NORM_API_LINKAGE +void NormCancelUserTimer(NormSessionHandle sessionHandle) +{ + NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); + if (instance) + { + if (instance->dispatcher.SuspendThread()) + { + NormSession* session = (NormSession*)sessionHandle; + if (session) session->SetUserTimer(-1.0); // interval less than zero cancels timer + instance->PurgeNotifications(sessionHandle, NORM_USER_TIMEOUT); + instance->dispatcher.ResumeThread(); + } + } +} // end NormCancelUserTimer() + + NORM_API_LINKAGE NormNodeId NormGetLocalNodeId(NormSessionHandle sessionHandle) { @@ -945,6 +1090,17 @@ NormNodeId NormGetLocalNodeId(NormSessionHandle sessionHandle) return NORM_NODE_NONE; } // end NormGetLocalNodeId() +NORM_API_LINKAGE +UINT16 NormGetRxPort(NormSessionHandle sessionHandle) +{ + NormSession* session = (NormSession*)sessionHandle; + if (NULL != session) + return session->GetRxPort(); + else + return 0; +} // end NormGetRxPort() + + NORM_API_LINKAGE bool NormSetTxPort(NormSessionHandle sessionHandle, UINT16 txPort, @@ -993,7 +1149,8 @@ void NormSetTxOnly(NormSessionHandle sessionHandle, NORM_API_LINKAGE bool NormChangeDestination(NormSessionHandle sessionHandle, const char* sessionAddress, - UINT16 sessionPort) + UINT16 sessionPort, + bool connectToSessionAddress) { // First, see if we can make a valid ProtoAddress ProtoAddress dest; @@ -1004,7 +1161,12 @@ bool NormChangeDestination(NormSessionHandle sessionHandle, if (instance && instance->dispatcher.SuspendThread()) { NormSession* session = (NormSession*)sessionHandle; - if (session) session->SetAddress(dest); + if (session) + { + session->SetAddress(dest); + if (connectToSessionAddress) + session->SetTxOnly(session->GetTxOnly(), true); + } instance->dispatcher.ResumeThread(); } return true; @@ -1029,16 +1191,6 @@ void NormSetRxPortReuse(NormSessionHandle sessionHandle, } } // end NormSetRxPortReuse() -NORM_API_LINKAGE -UINT16 NormGetRxPort(NormSessionHandle sessionHandle) -{ - NormSession* session = (NormSession*)sessionHandle; - if (NULL != session) - return session->GetRxPort(); - else - return 0; -} // end NormGetRxPort() - NORM_API_LINKAGE void NormSetEcnSupport(NormSessionHandle sessionHandle, bool ecnEnable, bool ignoreLoss, bool tolerateLoss) @@ -1074,6 +1226,25 @@ bool NormSetMulticastInterface(NormSessionHandle sessionHandle, return result; } // end NormSetMulticastInterface() +NORM_API_LINKAGE +bool NormSetSSM(NormSessionHandle sessionHandle, + const char* sourceAddress) +{ + bool result = false; + NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); + if (NULL != instance) + { + if (instance->dispatcher.SuspendThread()) + { + NormSession* session = (NormSession*)sessionHandle; + if (session) + result = session->SetSSM(sourceAddress); + instance->dispatcher.ResumeThread(); + } + } + return result; +} // end NormSetSSM() + NORM_API_LINKAGE bool NormSetTTL(NormSessionHandle sessionHandle, unsigned char ttl) @@ -1125,6 +1296,16 @@ bool NormSetLoopback(NormSessionHandle sessionHandle, bool state) } // end NormSetLoopback() +NORM_API_LINKAGE +bool NormSetMulticastLoopback(NormSessionHandle sessionHandle, bool state) +{ + NormSession* session = (NormSession*)sessionHandle; + if (session) + return session->SetMulticastLoopback(state); + else + return false; +} // end NormSetLoopback() + NORM_API_LINKAGE bool NormSetFragmentation(NormSessionHandle sessionHandle, bool state) { @@ -1263,10 +1444,10 @@ NormSessionId NormGetRandomSessionId() NORM_API_LINKAGE bool NormStartSender(NormSessionHandle sessionHandle, NormSessionId sessionId, - UINT32 bufferSpace, - UINT16 segmentSize, - unsigned char numData, - unsigned char numParity) + UINT32 bufferSpace, + UINT16 segmentSize, + UINT16 numData, + UINT16 numParity) { bool result = false; NormInstance* instance = NormInstance::GetInstanceFromSession(sessionHandle); @@ -1727,6 +1908,8 @@ bool NormSetWatermark(NormSessionHandle sessionHandle, NormObject* obj = (NormObject*)objectHandle; if (session && obj) { + // Purge any existing to NORM_TX_WATERMARK_COMPLETED notification to be safe + instance->PurgeNotifications(sessionHandle, NORM_TX_WATERMARK_COMPLETED); // (segmentId doesn't matter for non-stream) if (obj->IsStream()) { @@ -1791,7 +1974,7 @@ bool NormAddAckingNode(NormSessionHandle sessionHandle, { NormSession* session = (NormSession*)sessionHandle; if (session) - result = session->SenderAddAckingNode(nodeId); + result = (NULL != session->SenderAddAckingNode(nodeId)); instance->dispatcher.ResumeThread(); } return result; @@ -1810,6 +1993,20 @@ void NormRemoveAckingNode(NormSessionHandle sessionHandle, } } // end NormRemoveAckingNode() +NORM_API_LINKAGE +NormNodeHandle NormGetAckingNodeHandle(NormSessionHandle sessionHandle, + NormNodeId nodeId) +{ + if (NORM_SESSION_INVALID != sessionHandle) + { + NormSession* session = (NormSession*)sessionHandle; + NormAckingNode* acker = session->SenderFindAckingNode(nodeId); + if (NULL != acker) + return ((NormNodeHandle)static_cast(acker)); + } + return NORM_NODE_INVALID; +} // end NormGetAckingNodeHandle() + NORM_API_LINKAGE void NormSetAutoAckingNodes(NormSessionHandle sessionHandle, NormTrackingStatus trackingStatus) @@ -1994,8 +2191,12 @@ void NormNodeSetUnicastNack(NormNodeHandle nodeHandle, bool unicastNacks) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - if (node) node->SetUnicastNacks(unicastNacks); + NormNode* node = (NormNode*)nodeHandle; + if ((NULL != node) && (NormNode::SENDER == node->GetType())) + { + NormSenderNode* sender = static_cast(node); + sender->SetUnicastNacks(unicastNacks); + } } // end NormNodeSetUnicastNack() NORM_API_LINKAGE @@ -2018,8 +2219,12 @@ NORM_API_LINKAGE void NormNodeSetNackingMode(NormNodeHandle nodeHandle, NormNackingMode nackingMode) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - if (node) node->SetDefaultNackingMode((NormObject::NackingMode)nackingMode); + NormNode* node = (NormNode*)nodeHandle; + if ((NULL != node) && (NormNode::SENDER == node->GetType())) + { + NormSenderNode* sender = static_cast(node); + sender->SetDefaultNackingMode((NormObject::NackingMode)nackingMode); + } } // end NormNodeSetNackingMode() NORM_API_LINKAGE @@ -2043,9 +2248,12 @@ NORM_API_LINKAGE void NormNodeSetRepairBoundary(NormNodeHandle nodeHandle, NormRepairBoundary repairBoundary) { - NormSenderNode* node = static_cast((NormSenderNode*)nodeHandle); - if (node) - node->SetRepairBoundary((NormSenderNode::RepairBoundary)repairBoundary); + NormNode* node = (NormNode*)nodeHandle; + if ((NULL != node) && (NormNode::SENDER == node->GetType())) + { + NormSenderNode* sender = static_cast(node); + sender->SetRepairBoundary((NormSenderNode::RepairBoundary)repairBoundary); + } } // end NormNodeSetRepairBoundary() @@ -2071,8 +2279,12 @@ void NormNodeSetRxRobustFactor(NormNodeHandle nodeHandle, NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - node->SetRobustFactor(robustFactor); + NormNode* node = (NormNode*)nodeHandle; + if (NormNode::SENDER == node->GetType()) + { + NormSenderNode* sender = static_cast(node); + sender->SetRobustFactor(robustFactor); + } instance->dispatcher.ResumeThread(); } } @@ -2322,9 +2534,15 @@ const char* NormDataAccessData(NormObjectHandle dataHandle) NORM_API_LINKAGE char* NormDataDetachData(NormObjectHandle dataHandle) { - NormDataObject* dataObj = - static_cast((NormObject*)dataHandle); - return dataObj->DetachData(); + char* ptr = NULL; + NormInstance* instance = NormInstance::GetInstanceFromObject(dataHandle); + if (instance && instance->dispatcher.SuspendThread()) + { + NormDataObject* dataObj = static_cast((NormObject*)dataHandle); + ptr = dataObj->DetachData(); + instance->dispatcher.ResumeThread(); + } + return ptr; } // end NormDataDetachData() NORM_API_LINKAGE @@ -2339,7 +2557,7 @@ NormNodeHandle NormObjectGetSender(NormObjectHandle objectHandle) NORM_API_LINKAGE NormNodeId NormNodeGetId(NormNodeHandle nodeHandle) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; + NormNode* node = (NormNode*)nodeHandle; if (NULL != node) return node->GetId(); else @@ -2355,10 +2573,10 @@ bool NormNodeGetAddress(NormNodeHandle nodeHandle, bool result = false; if (NORM_NODE_INVALID != nodeHandle) { - NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); - if (instance && instance->dispatcher.SuspendThread()) + //NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); + //if (instance && instance->dispatcher.SuspendThread()) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; + NormNode* node = (NormSenderNode*)nodeHandle; const ProtoAddress& nodeAddr = node->GetAddress(); unsigned int addrLen = nodeAddr.GetLength(); if (addrBuffer && bufferLen && (addrLen <= *bufferLen)) @@ -2372,20 +2590,45 @@ bool NormNodeGetAddress(NormNodeHandle nodeHandle, } if (bufferLen) *bufferLen = addrLen; if (port) *port = nodeAddr.GetPort(); - instance->dispatcher.ResumeThread(); + //instance->dispatcher.ResumeThread(); } } return result; -} // end NormNodeGetId() +} // end NormNodeGetAddress() + +NORM_API_LINKAGE +void NormNodeSetUserData(NormNodeHandle nodeHandle, const void* userData) +{ + if (NORM_NODE_INVALID != nodeHandle) + { + NormNode* node = (NormNode*)nodeHandle; + return node->SetUserData(userData); + } +} + +NORM_API_LINKAGE +const void* NormNodeGetUserData(NormNodeHandle nodeHandle) +{ + NormNode* node = (NormNode*)nodeHandle; + if (NULL != node) + return node->GetUserData(); + else + return NULL; +} // end NormNodeGetUserData() NORM_API_LINKAGE double NormNodeGetGrtt(NormNodeHandle nodeHandle) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - if (NULL != node) - return node->GetGrttEstimate(); + NormNode* node = (NormNode*)nodeHandle; + if ((NULL != node) && (NormNode::SENDER == node->GetType())) + { + NormSenderNode* sender = static_cast(node); + return sender->GetGrttEstimate(); + } else + { return -1.0; + } } // end NormNodeGetGrtt() NORM_API_LINKAGE @@ -2399,8 +2642,12 @@ bool NormNodeGetCommand(NormNodeHandle nodeHandle, NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - result = node->ReadNextCmd(cmdBuffer, cmdLength); + NormNode* node = (NormNode*)nodeHandle; + if (NormNode::SENDER == node->GetType()) + { + NormSenderNode* sender = static_cast(node); + result = sender->ReadNextCmd(cmdBuffer, cmdLength); + } instance->dispatcher.ResumeThread(); } } @@ -2415,8 +2662,14 @@ void NormNodeFreeBuffers(NormNodeHandle nodeHandle) NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - node->FreeBuffers(); + NormNode* node = (NormNode*)nodeHandle; + if (NormNode::SENDER == node->GetType()) + { + NormSenderNode* sender = static_cast(node); + sender->FreeBuffers(); + // Since this results in aborted objects, should we purge those object notifications? + // or let the be delivered since the app may have associate state + } instance->dispatcher.ResumeThread(); } } @@ -2430,8 +2683,14 @@ void NormNodeDelete(NormNodeHandle nodeHandle) NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - NormSenderNode* node = (NormSenderNode*)nodeHandle; - node->GetSession().DeleteRemoteSender(*node); + NormNode* node = (NormNode*)nodeHandle; + if (NormNode::SENDER == node->GetType()) + { + NormSenderNode* sender = static_cast(node); + sender->GetSession().DeleteRemoteSender(*sender); + } + // else if NormNode::ACKER, should we remove from acking node list??? + instance->PurgeNodeNotifications(nodeHandle); instance->dispatcher.ResumeThread(); } } @@ -2445,7 +2704,7 @@ void NormNodeRetain(NormNodeHandle nodeHandle) NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - ((NormSenderNode*)nodeHandle)->Retain(); + ((NormNode*)nodeHandle)->Retain(); instance->dispatcher.ResumeThread(); } } @@ -2459,7 +2718,7 @@ void NormNodeRelease(NormNodeHandle nodeHandle) NormInstance* instance = NormInstance::GetInstanceFromNode(nodeHandle); if (instance && instance->dispatcher.SuspendThread()) { - ((NormSenderNode*)nodeHandle)->Release(); + ((NormNode*)nodeHandle)->Release(); instance->dispatcher.ResumeThread(); } } diff --git a/src/common/normApp.cpp b/src/common/normApp.cpp index 72d5dab..c46eda2 100644 --- a/src/common/normApp.cpp +++ b/src/common/normApp.cpp @@ -76,7 +76,7 @@ class NormApp : public NormController, public ProtoApp virtual void Notify(NormController::Event event, class NormSessionMgr* sessionMgr, class NormSession* session, - class NormSenderNode* sender, + class NormNode* node, class NormObject* object); bool OnIntervalTimeout(ProtoTimer& theTimer); @@ -490,8 +490,9 @@ bool NormApp::OnCommand(const char* cmd, const char* val) len = strlen(buffer); len = (len > 8191) ? 8191 : len; buffer[len++] = '\0'; - if (!control_pipe.Send(buffer, (unsigned int&)len)) - { + unsigned int numBytes = (unsigned int)len; + if (!control_pipe.Send(buffer, numBytes)) + { PLOG(PL_FATAL, "NormApp::OnCommand() error sending command to remote instance\n"); return false; } @@ -1494,7 +1495,7 @@ void NormApp::OnInputReady() void NormApp::Notify(NormController::Event event, class NormSessionMgr* sessionMgr, class NormSession* session, - class NormSenderNode* sender, + class NormNode* sender, class NormObject* object) { switch (event) @@ -1558,7 +1559,8 @@ void NormApp::Notify(NormController::Event event, case REMOTE_SENDER_INACTIVE: PLOG(PL_DEBUG, "NormApp::Notify(REMOTE_SENDER_INACTIVE) ...\n"); - if (!rx_persistent) sender->FreeBuffers(); + if (!rx_persistent) + static_cast(sender)->FreeBuffers(); break; diff --git a/src/common/normEncoderRS16.cpp b/src/common/normEncoderRS16.cpp index d474bfa..9788452 100644 --- a/src/common/normEncoderRS16.cpp +++ b/src/common/normEncoderRS16.cpp @@ -764,13 +764,13 @@ int NormDecoderRS16::Decode(char** vectorList, unsigned int numData, unsigned i bool NormDecoderRS16::InvertDecodingMatrix() { gf* src = (gf*)dec_matrix; - int k = ndata; + unsigned int k = ndata; memset(inv_id_row, 0, k*sizeof(gf)); // inv_pivt marks elements already used as pivots. memset(inv_pivt, 0, k*sizeof(unsigned int)); - for (int col = 0; col < k ; col++) + for (unsigned int col = 0; col < k ; col++) { /* * Zeroing column 'col', look for a non-zero element. @@ -788,7 +788,7 @@ bool NormDecoderRS16::InvertDecodingMatrix() { if (inv_pivt[row] != 1) { - for (int ix = 0 ; ix < k ; ix++) + for (unsigned int ix = 0 ; ix < k ; ix++) { if (inv_pivt[ix] == 0) { @@ -821,7 +821,7 @@ bool NormDecoderRS16::InvertDecodingMatrix() */ if (irow != icol) { - for (int ix = 0 ; ix < k ; ix++ ) + for (unsigned int ix = 0 ; ix < k ; ix++ ) SWAP(src[irow*k + ix], src[icol*k + ix], gf); } inv_ndxr[col] = irow ; @@ -841,7 +841,7 @@ bool NormDecoderRS16::InvertDecodingMatrix() */ c = inverse[ c ] ; pivotRow[icol] = 1 ; - for (int ix = 0 ; ix < k ; ix++ ) + for (unsigned int ix = 0 ; ix < k ; ix++ ) pivotRow[ix] = gf_mul(c, pivotRow[ix] ); } /* @@ -869,11 +869,11 @@ bool NormDecoderRS16::InvertDecodingMatrix() for (int col = k - 1 ; col >= 0 ; col-- ) { - if (inv_ndxr[col] < 0 || inv_ndxr[col] >= (unsigned int)k) + if (inv_ndxr[col] >= k) { PLOG(PL_ERROR, "NormDecoderRS16::InvertDecodingMatrix() error: AARGH, inv_ndxr[col] %d\n", inv_ndxr[col]); } - else if (inv_ndxc[col] <0 || inv_ndxc[col] >= (unsigned int)k) + else if (inv_ndxc[col] >= k) { PLOG(PL_ERROR, "NormDecoderRS16::InvertDecodingMatrix() error: AARGH, indxc[col] %d\n", inv_ndxc[col]); } diff --git a/src/common/normEncoderRS8.cpp b/src/common/normEncoderRS8.cpp index 3b50aad..778efba 100644 --- a/src/common/normEncoderRS8.cpp +++ b/src/common/normEncoderRS8.cpp @@ -37,7 +37,7 @@ #include "protoDebug.h" #ifdef SIMULATE -#include "normMessage.h" +#include "normMessage.h" #endif // SIMULATE /* @@ -52,7 +52,7 @@ */ #define GF_BITS 8 // 8-bit RS code -#if (GF_BITS < 2 && GF_BITS > 16) +#if (GF_BITS < 2) || (GF_BITS > 16) #error "GF_BITS must be 2 .. 16" #endif #if (GF_BITS <= 8) @@ -766,13 +766,13 @@ int NormDecoderRS8::Decode(char** vectorList, unsigned int numData, unsigned in bool NormDecoderRS8::InvertDecodingMatrix() { gf* src = (gf*)dec_matrix; - int k = ndata; + unsigned int k = ndata; memset(inv_id_row, 0, k*sizeof(gf)); // inv_pivt marks elements already used as pivots. memset(inv_pivt, 0, k*sizeof(unsigned int)); - for (int col = 0; col < k ; col++) + for (unsigned int col = 0; col < k ; col++) { /* * Zeroing column 'col', look for a non-zero element. @@ -786,11 +786,11 @@ bool NormDecoderRS8::InvertDecodingMatrix() icol = col ; goto found_piv ; } - for (int row = 0 ; row < k ; row++) + for (unsigned int row = 0 ; row < k ; row++) { if (inv_pivt[row] != 1) { - for (int ix = 0 ; ix < k ; ix++) + for (unsigned int ix = 0 ; ix < k ; ix++) { if (inv_pivt[ix] == 0) { @@ -823,7 +823,7 @@ bool NormDecoderRS8::InvertDecodingMatrix() */ if (irow != icol) { - for (int ix = 0 ; ix < k ; ix++ ) + for (unsigned int ix = 0 ; ix < k ; ix++ ) SWAP(src[irow*k + ix], src[icol*k + ix], gf); } inv_ndxr[col] = irow ; @@ -843,7 +843,7 @@ bool NormDecoderRS8::InvertDecodingMatrix() */ c = inverse[ c ] ; pivotRow[icol] = 1 ; - for (int ix = 0 ; ix < k ; ix++ ) + for (unsigned int ix = 0 ; ix < k ; ix++ ) pivotRow[ix] = gf_mul(c, pivotRow[ix] ); } /* @@ -871,17 +871,17 @@ bool NormDecoderRS8::InvertDecodingMatrix() for (int col = k - 1 ; col >= 0 ; col-- ) { - if (inv_ndxr[col] < 0 || inv_ndxr[col] >= (unsigned int)k) + if (inv_ndxr[col] >= k) { PLOG(PL_ERROR, "NormDecoderRS8::InvertDecodingMatrix() error: AARGH, inv_ndxr[col] %d\n", inv_ndxr[col]); } - else if (inv_ndxc[col] <0 || inv_ndxc[col] >= (unsigned int)k) + else if (inv_ndxc[col] >= k) { PLOG(PL_ERROR, "NormDecoderRS8::InvertDecodingMatrix() error: AARGH, indxc[col] %d\n", inv_ndxc[col]); } else if (inv_ndxr[col] != inv_ndxc[col] ) { - for (int row = 0 ; row < k ; row++ ) + for (unsigned int row = 0 ; row < k ; row++ ) SWAP( src[row*k + inv_ndxr[col]], src[row*k + inv_ndxc[col]], gf) ; } } diff --git a/src/common/normNode.cpp b/src/common/normNode.cpp index 045b0f6..daad585 100644 --- a/src/common/normNode.cpp +++ b/src/common/normNode.cpp @@ -5,8 +5,8 @@ #include "normEncoderRS8.h" // 8-bit Reed-Solomon encoder of RFC 5510 #include "normEncoderRS16.h" // 16-bit Reed-Solomon encoder of RFC 5510 -NormNode::NormNode(class NormSession& theSession, NormNodeId nodeId) - : session(theSession), id(nodeId), reference_count(1), +NormNode::NormNode(Type nodeType, class NormSession& theSession, NormNodeId nodeId) + : session(theSession), node_type(nodeType), id(nodeId), reference_count(1), user_data(NULL), parent(NULL), right(NULL), left(NULL) { @@ -14,8 +14,10 @@ NormNode::NormNode(class NormSession& theSession, NormNodeId nodeId) NormNode::~NormNode() { + //TRACE("NormNode %lu dtor ...\n", (unsigned long)id); } + void NormNode::Retain() { reference_count++; @@ -40,9 +42,8 @@ NormNode::Accumulator::Accumulator() } - NormCCNode::NormCCNode(class NormSession& theSession, NormNodeId nodeId) - : NormNode(theSession, nodeId) + : NormNode(CC_NODE, theSession, nodeId) { } @@ -65,11 +66,11 @@ const double NormSenderNode::DEFAULT_NOMINAL_INTERVAL = 2*NormSession::DEFAULT_G const double NormSenderNode::ACTIVITY_INTERVAL_MIN = 1.0; // 1 second min activity timeout NormSenderNode::NormSenderNode(class NormSession& theSession, NormNodeId nodeId) - : NormNode(theSession, nodeId), instance_id(0), robust_factor(session.GetRxRobustFactor()), + : NormNode(SENDER, theSession, nodeId), instance_id(0), robust_factor(session.GetRxRobustFactor()), synchronized(false), sync_id(0), is_open(false), segment_size(0), fec_m(0), ndata(0), nparity(0), repair_boundary(BLOCK_BOUNDARY), decoder(NULL), erasure_loc(NULL), - retrieval_loc(NULL), retrieval_pool(NULL), + retrieval_loc(NULL), retrieval_pool(NULL), ack_pending(false), cc_sequence(0), cc_enable(false), cc_feedback_needed(false), cc_rate(0.0), rtt_confirmed(false), is_clr(false), is_plr(false), slow_start(true), send_rate(0.0), recv_rate(0.0), recv_rate_prev(0.0), @@ -160,6 +161,7 @@ void NormSenderNode::Close() if (activity_timer.IsActive()) activity_timer.Deactivate(); if (repair_timer.IsActive()) repair_timer.Deactivate(); if (cc_timer.IsActive()) cc_timer.Deactivate(); + if (ack_timer.IsActive()) ack_timer.Deactivate(); FreeBuffers(); // Delete any command buffers from cmd_buffer queue @@ -566,7 +568,7 @@ void NormSenderNode::HandleCommand(const struct timeval& currentTime, } // 1) Sync to squelch (discards all objects prior to squelch objectId) NormObjectId objectId = squelch.GetObjectId(); - Sync(objectId); + Sync(objectId); // 2) Prune stream object if applicable NormObject* obj = rx_table.Find(objectId); if ((NULL != obj) && (NormObject::STREAM == obj->GetType())) @@ -638,7 +640,6 @@ void NormSenderNode::HandleCommand(const struct timeval& currentTime, is_clr = is_plr = false; } double maxBackoff; - if (is_clr || is_plr || !session.Address().IsMulticast()) { // Respond immediately (i.e., no backoff, holdoff etc) @@ -757,6 +758,7 @@ void NormSenderNode::HandleCommand(const struct timeval& currentTime, { double ackBackoff = session.Address().IsMulticast() ? UniformRand(grtt_estimate) : 0.0; ack_timer.SetInterval(ackBackoff); + ack_pending = true; session.ActivateTimer(ack_timer); } break; // no pending repairs, skip regular "RepairCheck" @@ -1546,9 +1548,7 @@ void NormSenderNode::HandleObjectMessage(const NormObjectMsg& msg) break; } // end switch(status) - - - if (obj) + if (NULL != obj) { obj->HandleObjectMessage(msg, msgType, blockId, segmentId); @@ -1742,11 +1742,9 @@ NormSenderNode::ObjectStatus NormSenderNode::UpdateSyncStatus(const NormObjectId { NormObjectId lastPending(65535); GetLastPending(lastPending); - TRACE("lp:%hu\n", (UINT16)lastPending); if (syncId > lastPending) { UINT16 delta = syncId - lastPending; - TRACE("SYNC DELTA = %d\n", delta); if (delta < max_pending_range) { syncId -= (max_pending_range - 1); @@ -2179,7 +2177,6 @@ bool NormSenderNode::OnRepairTimeout(ProtoTimer& /*theTimer*/) default: break; } - if (NULL != obj) { if (obj->IsPending(nextId != max_pending_object)) @@ -2401,8 +2398,8 @@ bool NormSenderNode::OnActivityTimeout(ProtoTimer& /*theTimer*/) } else if (0 == activity_timer.GetRepeatCount()) { - // Serve completely inactive? - PLOG(PL_ERROR, "NormSenderNode::OnActivityTimeout() node>%lu sender>%lu gone inactive?\n", + // Remote sender completely inactive? + PLOG(PL_INFO, "NormSenderNode::OnActivityTimeout() node>%lu sender>%lu gone inactive?\n", LocalNodeId(), GetId()); //FreeBuffers(); This now needs to be done by the app as of norm version 1.4b3 session.Notify(NormController::REMOTE_SENDER_INACTIVE, this, NULL); @@ -2419,7 +2416,7 @@ bool NormSenderNode::OnActivityTimeout(ProtoTimer& /*theTimer*/) NormObject* objMax = rx_table.Find(max_pending_object); if (NULL != objMax) { - /*NormSegmentId segMax = objMax->GetMaxPendingSegmentId(); + NormSegmentId segMax = objMax->GetMaxPendingSegmentId(); if (0 != segMax) RepairCheck(NormObject::THRU_SEGMENT, max_pending_object, @@ -2429,10 +2426,14 @@ bool NormSenderNode::OnActivityTimeout(ProtoTimer& /*theTimer*/) RepairCheck(NormObject::TO_BLOCK, max_pending_object, objMax->GetMaxPendingBlockId(), - 0);*/ - // Let's try this instead - RepairCheck(NormObject::THRU_OBJECT, // (TBD) thru object??? - max_pending_object, 0, 0); + 0); + + // The above has been reinstated because the alternative "THRU_OBJECT" here + // causes gratuitous NACKing when the sender goes IDLE .. + + // Or we could do this instead (possibly some unnecessary NACKing for NORM_OBJECT_STREAM will occur here) + //RepairCheck(NormObject::THRU_OBJECT, // (TBD) thru object??? + // max_pending_object, 0, 0); // (TBD) What should we really do here? Our current NormNode::RepairCheck() and // NormObject::ReceiverRepairCheck() methods update the "max_pending" indices @@ -2445,7 +2446,12 @@ bool NormSenderNode::OnActivityTimeout(ProtoTimer& /*theTimer*/) // I guess the activity timeout NACK isn't perfect ... but could help some // so we leave it as it is for the moment ("THRU_OBJECT") ... perhaps we could // add a parameter so NormObject::ReceiverRepairCheck() doesn't update its - // "max_pending" indices - or would this break NACK building + // "max_pending" indices - or would this break NACK building? + + // Maybe we should do THRU_OBJECT when the remote sender is fully inactive as + // opposed to this inactivity timeout that only pays attend to NORM_DATA. I.e., + // do the above refined RepairCheck() when we still have NORM_CMD activity but + // no NORM_DATA activity??? We'd still have potentially a lot of EOT NACKing } else { @@ -2455,7 +2461,7 @@ bool NormSenderNode::OnActivityTimeout(ProtoTimer& /*theTimer*/) // max_pending_object, 0, 0); } } - // We manually managed the "repeat_count" here to avoid the + // We manually manage the "repeat_count" here to avoid the // case where "bursty" receiver scheduling may lead to false // inactivity indication int repeatCount = activity_timer.GetRepeatCount(); @@ -2572,6 +2578,14 @@ void NormSenderNode::AttachCCFeedback(NormAckMsg& ack) bool NormSenderNode::OnCCTimeout(ProtoTimer& /*theTimer*/) { // Build and send NORM_ACK(CC) + if (ack_pending && (1 == cc_timer.GetRepeatCount())) + { + // Send ACK flush right away (CC feedback is included + if (ack_timer.IsActive()) ack_timer.Deactivate(); + if (cc_timer.IsActive()) cc_timer.Deactivate(); // will be reactivated if needed + OnAckTimeout(ack_timer); + return false; + } switch (cc_timer.GetRepeatCount()) { case 0: @@ -2601,23 +2615,31 @@ bool NormSenderNode::OnCCTimeout(ProtoTimer& /*theTimer*/) ack->SetDestination(GetAddress()); else ack->SetDestination(session.Address()); - session.SendMessage(*ack); + bool success = session.SendMessage(*ack); session.ReturnMessageToPool(ack); - cc_feedback_needed = false; - - // Begin cc_timer "holdoff" phase - if (!is_clr && !is_plr && session.Address().IsMulticast()) + if (success) { - cc_timer.SetInterval(grtt_estimate*backoff_factor); - return true; + cc_feedback_needed = false; + // Begin cc_timer "holdoff" phase + if (!is_clr && !is_plr && session.Address().IsMulticast()) + { + cc_timer.SetInterval(grtt_estimate*backoff_factor); + } + else if (cc_timer.IsActive()) + { + cc_timer.Deactivate(); + return false; + } } - else if (cc_timer.IsActive()) + else { - cc_timer.Deactivate(); + // TBD - queue ack so it gets send retry? + PLOG(PL_ERROR, "NormSenderNode::OnCCTimeout() error: SendMessage(ack) failure\n"); + if (cc_timer.IsActive()) cc_timer.Deactivate(); + return false; } break; } - default: // Should never occur ASSERT(0); @@ -2630,7 +2652,7 @@ bool NormSenderNode::OnAckTimeout(ProtoTimer& /*theTimer*/) { // Build and send NORM_ACK(FLUSH) NormAckFlushMsg* ack = (NormAckFlushMsg*)session.GetMessageFromPool(); - if (ack) + if (NULL != ack) { ack->Init(); ack->SetSenderId(GetId()); @@ -2657,24 +2679,31 @@ bool NormSenderNode::OnAckTimeout(ProtoTimer& /*theTimer*/) ack->SetDestination(session.Address()); // Don't rate limit feedback messages - session.SendMessage(*ack); - session.ReturnMessageToPool(ack); - cc_feedback_needed = false; - if (cc_enable && !is_clr && !is_plr && session.Address().IsMulticast()) + if (session.SendMessage(*ack)) + { + ack_pending = false; + cc_feedback_needed = false; + if (cc_enable && !is_clr && !is_plr && session.Address().IsMulticast()) + { + // Install cc feedback holdoff + cc_timer.SetInterval(grtt_estimate*backoff_factor); + if (cc_timer.IsActive()) + cc_timer.Reschedule(); + else + session.ActivateTimer(cc_timer); + cc_timer.DecrementRepeatCount(); // put timer into "holdoff" phase + } + else if (cc_timer.IsActive()) + { + cc_timer.Deactivate(); + } + } + else { - // Install cc feedback holdoff - cc_timer.SetInterval(grtt_estimate*backoff_factor); - if (cc_timer.IsActive()) - cc_timer.Reschedule(); - else - session.ActivateTimer(cc_timer); - cc_timer.DecrementRepeatCount(); // put timer into "holdoff" phase - } - else if (cc_timer.IsActive()) - { - cc_timer.Deactivate(); - return false; + // TBD - should we queue the message so it can get a send retry? + PLOG(PL_ERROR, "NormSenderNode::OnAckTimeout() error: SendMessage(ack) failure\n"); } + session.ReturnMessageToPool(ack); } else { @@ -2685,7 +2714,7 @@ bool NormSenderNode::OnAckTimeout(ProtoTimer& /*theTimer*/) NormAckingNode::NormAckingNode(class NormSession& theSession, NormNodeId nodeId) - : NormNode(theSession, nodeId), ack_received(false), req_count(theSession.GetTxRobustFactor()) + : NormNode(ACKER, theSession, nodeId), ack_received(false), req_count(theSession.GetTxRobustFactor()) { } diff --git a/src/common/normObject.cpp b/src/common/normObject.cpp index 211bfd0..6718d21 100644 --- a/src/common/normObject.cpp +++ b/src/common/normObject.cpp @@ -47,6 +47,10 @@ void NormObject::Retain() void NormObject::Release() { + + //if ((NULL != sender) && (reference_count == 1)) + // TRACE("NormObject final release node>%lu object>%hu\n", (unsigned long)sender->GetId(), (unsigned short)transport_id); + if (sender) sender->Release(); if (reference_count) { @@ -235,7 +239,7 @@ void NormObject::Close() NormObjectSize NormObject::GetBytesPending() const { NormBlockId nextId; - if (GetFirstPending(nextId)) + if (!IsStream() && GetFirstPending(nextId)) { NormObjectSize largeBlockBytes = NormObjectSize(large_block_size) * NormObjectSize(segment_size); @@ -264,7 +268,7 @@ NormObjectSize NormObject::GetBytesPending() const { return NormObjectSize(0); } -} // end NormObject::GetBytesCompleted() +} // end NormObject::GetBytesPending() // Used by sender bool NormObject::HandleInfoRequest(bool holdoff) @@ -824,7 +828,7 @@ bool NormObject::ReceiverRepairCheck(CheckLevel level, if (segmentId >= max_pending_segment) max_pending_segment = segmentId + 1; } - if (blockId == final_block_id) + if (!IsStream() && (blockId == final_block_id)) { unsigned int finalSegment = GetBlockSize(blockId) - 1; if (finalSegment <= segmentId) @@ -858,7 +862,6 @@ bool NormObject::ReceiverRepairCheck(CheckLevel level, } else { - NormBlockId firstPending; if (GetFirstPending(firstPending)) { @@ -901,7 +904,7 @@ bool NormObject::ReceiverRepairCheck(CheckLevel level, max_pending_block = blockId; max_pending_segment = GetBlockSize(blockId); } - if (blockId == final_block_id) + if (!IsStream() && (blockId == final_block_id)) thruObject = true; if (timerActive) { @@ -1178,7 +1181,7 @@ bool NormObject::AppendRepairRequest(NormNackMsg& nack, return requestAppended; } } - if (flush || (nextId != max_pending_block)) + if (flush || (nextId != max_pending_block)) { block->AppendRepairRequest(nack, fec_id, fec_m, numData, nparity, transport_id, pending_info, segment_size); // (TBD) error check @@ -1192,10 +1195,10 @@ bool NormObject::AppendRepairRequest(NormNackMsg& nack, block->AppendRepairRequest(nack, fec_id, fec_m, numData, nparity, transport_id, pending_info, segment_size); // (TBD) error check } - requestAppended = true; + requestAppended = true; + prevForm = NormRepairRequest::INVALID; } consecutiveCount = 0; - prevForm = NormRepairRequest::INVALID; } else if (iterating) { @@ -2832,7 +2835,7 @@ bool NormStreamObject::StreamUpdateStatus(NormBlockId blockId) { // This is a fresh rx stream, so init the read indices read_init = false; - read_index.block = blockId; + read_index.block = blockId; // for initial SYNC_STREAM sync, this will be zero (stream beginning) read_index.segment = 0; read_offset = 0; } @@ -3940,6 +3943,7 @@ void NormObjectTable::Destroy() { // TBD - should we issue PURGED/ABORTED notifications here??? // (We haven't since this is destroyed only when session is terminated) + // or when a NormSenderNode is deleted Remove(obj); obj->Release(); } diff --git a/src/common/normSession.cpp b/src/common/normSession.cpp index 8c0f723..129332a 100644 --- a/src/common/normSession.cpp +++ b/src/common/normSession.cpp @@ -32,7 +32,7 @@ NormSession::NormSession(NormSessionMgr& sessionMgr, NormNodeId localNodeId) : session_mgr(sessionMgr), notify_pending(false), tx_port(0), tx_port_reuse(false), tx_socket_actual(ProtoSocket::UDP), tx_socket(&tx_socket_actual), rx_socket(ProtoSocket::UDP), rx_cap(NULL), rx_port_reuse(false), local_node_id(localNodeId), - ttl(DEFAULT_TTL), tos(0), loopback(false), fragmentation(false), ecn_enabled(false), + ttl(DEFAULT_TTL), tos(0), loopback(false), mcast_loopback(false), fragmentation(false), ecn_enabled(false), tx_rate(DEFAULT_TRANSMIT_RATE/8.0), tx_rate_min(-1.0), tx_rate_max(-1.0), backoff_factor(DEFAULT_BACKOFF_FACTOR), is_sender(false), tx_robust_factor(DEFAULT_ROBUST_FACTOR), instance_id(0), @@ -66,8 +66,8 @@ NormSession::NormSession(NormSessionMgr& sessionMgr, NormNodeId localNodeId) user_data(NULL), next(NULL) { interface_name[0] = '\0'; - tx_socket->SetNotifier(&sessionMgr.GetSocketNotifier()); - tx_socket->SetListener(this, &NormSession::TxSocketRecvHandler); + tx_socket_actual.SetNotifier(&sessionMgr.GetSocketNotifier()); + tx_socket_actual.SetListener(this, &NormSession::TxSocketRecvHandler); tx_address.Invalidate(); rx_socket.SetNotifier(&sessionMgr.GetSocketNotifier()); @@ -112,10 +112,15 @@ NormSession::NormSession(NormSessionMgr& sessionMgr, NormNodeId localNodeId) report_timer.SetListener(this, &NormSession::OnReportTimeout); report_timer.SetInterval(10.0); report_timer.SetRepeat(-1); + + user_timer.SetListener(this, &NormSession::OnUserTimeout); + user_timer.SetInterval(0.0); + user_timer.SetRepeat(0); } NormSession::~NormSession() { + if (user_timer.IsActive()) user_timer.Deactivate(); if (NULL != preset_sender) { delete preset_sender; @@ -170,7 +175,6 @@ bool NormSession::Open() { tx_socket = &rx_socket; } - } if (!rx_socket.IsOpen() && (!tx_only || (&rx_socket == tx_socket))) { @@ -180,6 +184,7 @@ bool NormSession::Open() Close(); return false; } + rx_socket.EnableRecvDstAddr(); if (rx_port_reuse) { // Enable port/addr reuse and bind socket to destination address @@ -204,7 +209,7 @@ bool NormSession::Open() Close(); return false; } - if (rx_connect_addr.IsValid()) + if (rx_connect_addr.IsValid() && (0 != rx_connect_addr.GetPort())) { // For unicast, we use the "connect()" call to effectively // uniquely "bind" our rx_socket to the remote addr. @@ -243,7 +248,7 @@ bool NormSession::Open() Close(); return false; } - if (!tx_socket->SetLoopback(loopback)) + if (!tx_socket->SetLoopback(mcast_loopback)) { // TBD - Should this be set on the rx_socket instead??? PLOG(PL_FATAL, "NormSession::Open() tx_socket.SetLoopback() error\n"); @@ -265,7 +270,7 @@ bool NormSession::Open() } if (!tx_only) { - if (!rx_socket.JoinGroup(address, interfaceName)) + if (!rx_socket.JoinGroup(address, interfaceName, ssm_source_addr.IsValid() ? &ssm_source_addr : NULL)) { PLOG(PL_FATAL, "NormSession::Open() rx_socket.JoinGroup error\n"); Close(); @@ -371,7 +376,7 @@ void NormSession::Close() { const char* interfaceName = ('\0' != interface_name[0]) ? interface_name : NULL; - rx_socket.LeaveGroup(address, interfaceName); + rx_socket.LeaveGroup(address, interfaceName, ssm_source_addr.IsValid() ? &ssm_source_addr : NULL); } rx_socket.Close(); } @@ -406,6 +411,27 @@ bool NormSession::SetMulticastInterface(const char* interfaceName) } } // end NormSession::SetMulticastInterface() +bool NormSession::SetSSM(const char* sourceAddress) +{ + if (NULL != sourceAddress) + { + if (ssm_source_addr.ResolveFromString(sourceAddress)) + { + return true; + } + else + { + PLOG(PL_ERROR, "NormSession::SetSSM() error: invalid source address\n"); + return false; + } + } + else + { + ssm_source_addr.Invalidate(); + return true; + } +} // end NormSession::SetSSM() + bool NormSession::SetRxPortReuse(bool enableReuse, const char* rxBindAddress, // bind() to / const char* senderAddress, // connect() to / @@ -424,6 +450,7 @@ bool NormSession::SetRxPortReuse(bool enableReuse, } if (NULL != senderAddress) { + // TBD - if open, connect() to sender? if (rx_connect_addr.ResolveFromString(senderAddress)) { rx_connect_addr.SetPort(senderPort); @@ -491,18 +518,21 @@ void NormSession::SetTxOnly(bool txOnly, bool connectToSessionAddress) { tx_only = txOnly; tx_connect = connectToSessionAddress; - if (txOnly && IsOpen()) + if (IsOpen()) { - if (IsReceiver()) StopReceiver(); - if (rx_socket.IsOpen()) rx_socket.Close(); -#ifdef ECN_SUPPORT - if (NULL != rx_cap) + if (txOnly) { - rx_cap->Close(); - delete rx_cap; - rx_cap = NULL; - } + if (IsReceiver()) StopReceiver(); + if (rx_socket.IsOpen()) rx_socket.Close(); +#ifdef ECN_SUPPORT + if (NULL != rx_cap) + { + rx_cap->Close(); + delete rx_cap; + rx_cap = NULL; + } #endif // ECN_SUPPORT + } // We connect tx_only session sockets when tx port // reuse is set _and_ it is a unicast session // (This makes sure unicast NACKs get back to the right tx_socket!) @@ -530,13 +560,14 @@ double NormSession::GetTxRate() } // end NormSession::GetTxRate() +/* +// This hack can be uncommented give us a tx rate interval that is POISSON instead of PERIODIC static double PoissonRand(double mean) { return(-log(((double)rand())/((double)RAND_MAX))*mean); } - +*/ -// This hack can give us a tx rate interval that is POISSON instead of PERIODIC static inline double GetTxInterval(unsigned int msgSize, double txRate) { double interval = (double)msgSize / txRate; @@ -653,6 +684,17 @@ void NormSession::SetTxRateBounds(double rateMin, double rateMax) } // end NormSession::SetTxRateBounds() +void NormSession::SetUserTimer(double seconds) +{ + if (user_timer.IsActive()) user_timer.Deactivate(); + if (seconds >= 0.0) + { + user_timer.SetInterval(seconds); + ActivateTimer(user_timer); + } +} // end NormSession::SetUserTimer() + + bool NormSession::StartSender(UINT16 instanceId, UINT32 bufferSpace, UINT16 segmentSize, @@ -797,7 +839,7 @@ bool NormSession::StartSender(UINT16 instanceId, } else { - // Don't let txRate below MIN(one segment per grtt, one segment per seconds) + // Don't let txRate below MIN(one segment per grtt, one segment per second) txRate = ((double)segment_size) / grtt_measured; if (txRate > ((double)(segment_size))) txRate = (double)(segment_size); @@ -898,7 +940,7 @@ void NormSession::StopReceiver() // Iterate sender_tree and close/release sender nodes NormSenderNode* senderNode = static_cast(sender_tree.GetRoot()); - while (senderNode) + while (NULL != senderNode) { sender_tree.DetachNode(senderNode); senderNode->Close(); @@ -916,7 +958,7 @@ void NormSession::DeleteRemoteSender(NormSenderNode& senderNode) sender_tree.DetachNode(&senderNode); senderNode.Close(); senderNode.Release(); -} // end NormSession::DeleteSender() +} // end NormSession::DeleteRemoteSender() bool NormSession::PreallocateRemoteSender(UINT16 segmentSize, UINT16 numData, @@ -1153,7 +1195,7 @@ void NormSession::Serve() { SenderQueueFlush(); } - else if (GetTxRobustFactor() == flush_count) //xxx + else if (GetTxRobustFactor() == flush_count) { PLOG(PL_TRACE, "NormSession::Serve() node>%lu sender stream flush complete ...\n", @@ -1270,7 +1312,7 @@ void NormSession::SenderCancelWatermark() watermark_pending = false; } // end NormSession::SenderCancelWatermark() -bool NormSession::SenderAddAckingNode(NormNodeId nodeId) +NormAckingNode* NormSession::SenderAddAckingNode(NormNodeId nodeId, const ProtoAddress* srcAddress) { NormAckingNode* theNode = static_cast(acking_node_tree.FindNodeById(nodeId)); if (NULL == theNode) @@ -1281,18 +1323,19 @@ bool NormSession::SenderAddAckingNode(NormNodeId nodeId) theNode->Reset(GetTxRobustFactor()); acking_node_tree.AttachNode(theNode); acking_node_count++; - return true; } else { PLOG(PL_ERROR, "NormSession::SenderAddAckingNode() new NormAckingNode error: %s\n", GetErrorString()); + return NULL; } } else { - PLOG(PL_ERROR, "NormSession::SenderAddAckingNode() warning: node already in list!?\n"); + PLOG(PL_WARN, "NormSession::SenderAddAckingNode() warning: node already in list!?\n"); } - return true; + if (NULL != srcAddress) theNode->SetAddress(*srcAddress); + return theNode; } // end NormSession::AddAckingNode(NormNodeId nodeId) void NormSession::SenderRemoveAckingNode(NormNodeId nodeId) @@ -1967,33 +2010,45 @@ char* NormSession::SenderGetFreeSegment(NormObjectId objectId, return segment_pool.Get(); } // end NormSession::SenderGetFreeSegment() -void NormSession::TxSocketRecvHandler(ProtoSocket& /*theSocket*/, +void NormSession::TxSocketRecvHandler(ProtoSocket& theSocket, ProtoSocket::Event theEvent) { if (ProtoSocket::RECV == theEvent) { NormMsg msg; unsigned int msgLength = NormMsg::MAX_SIZE; - while (tx_socket->RecvFrom(msg.AccessBuffer(), + while (true) + { + + if (theSocket.RecvFrom(msg.AccessBuffer(), msgLength, msg.AccessAddress())) - { - if (0 == msgLength) break; // no more data to read - if (msg.InitFromBuffer(msgLength)) { - HandleReceiveMessage(msg, true); - msgLength = NormMsg::MAX_SIZE; + if (0 == msgLength) break; // no more data to read + if (msg.InitFromBuffer(msgLength)) + { + // Since it arrived on the tx_socket, we know it was unicast + HandleReceiveMessage(msg, true); + msgLength = NormMsg::MAX_SIZE; + } + else + { + PLOG(PL_ERROR, "NormSession::TxSocketRecvHandler() warning: received bad message\n"); + } } else { - PLOG(PL_ERROR, "NormSession::TxSocketRecvHandler() warning: received bad message\n"); + // Probably an ICMP "port unreachable" error + if (Address().IsUnicast()) + Notify(NormController::SEND_ERROR, NULL, NULL); + break; } } } else if (ProtoSocket::SEND == theEvent) { // This is a little cheesy, but ... - tx_socket->StopOutputNotification(); + theSocket.StopOutputNotification(); if (tx_timer.IsActive()) tx_timer.Deactivate(); if (OnTxTimeout(tx_timer)) { @@ -2014,80 +2069,110 @@ int rxMeasureGapMax = 0; #endif // RX_MEASURE_ONLY void NormSession::RxSocketRecvHandler(ProtoSocket& theSocket, - ProtoSocket::Event /*theEvent*/) + ProtoSocket::Event theEvent) { - unsigned int recvCount = 0; - NormMsg msg; - unsigned int msgLength = NormMsg::MAX_SIZE; - while (theSocket.RecvFrom(msg.AccessBuffer(), - msgLength, - msg.AccessAddress())) + if (ProtoSocket::RECV == theEvent) { - if (0 == msgLength) break; - if (msg.InitFromBuffer(msgLength)) + unsigned int recvCount = 0; + NormMsg msg; + unsigned int msgLength = NormMsg::MAX_SIZE; + while (true) { + ProtoAddress destAddr; // we get the pkt destAddr to determine unicast/multicast + if (theSocket.RecvFrom(msg.AccessBuffer(), + msgLength, + msg.AccessAddress(), + destAddr)) + { + if (0 == msgLength) break; + if (msg.InitFromBuffer(msgLength)) + { #ifdef RX_MEASURE_ONLY - // Measure rx rate / loss stats only - struct timeval currentTime; - ProtoSystemTime(currentTime); - UINT16 seq = msg.GetSequence(); - if (rxMeasureInit) - { - rxMeasureRefTime = currentTime; - rxMeasureSeqPrev = seq; - rxMeasurePktCount = rxMeasurePktTotal = 1; - rxMeasureByteTotal = msgLength; - rxMeasureInit = false; - return; - } - int seqDelta = (int)seq - (int)rxMeasureSeqPrev; - ASSERT(seqDelta > 0); - - rxMeasurePktTotal += seqDelta; // total should have received. - rxMeasurePktCount++; // total actually received - rxMeasureByteTotal += msgLength; - - if (seqDelta > rxMeasureGapMax) - rxMeasureGapMax = seqDelta; - - int deltaSec = currentTime.tv_sec - rxMeasureRefTime.tv_sec; - if (deltaSec >= 10) - { - if (currentTime.tv_usec > rxMeasureRefTime.tv_usec) - deltaSec += 1.0e-06 * (double)(currentTime.tv_usec - rxMeasureRefTime.tv_usec); - else - deltaSec -= 1.0e-06 * (double)(rxMeasureRefTime.tv_usec - currentTime.tv_usec); - double rxRate = (8.0/1000.0) * (double)rxMeasureByteTotal / (double)deltaSec; - double rxLoss = 100.0 * (1.0 - (double)rxMeasurePktCount / (double)rxMeasurePktTotal); - - rxMeasureRefTime = currentTime; - rxMeasureByteTotal = rxMeasurePktCount = rxMeasurePktTotal = rxMeasureGapMax = 0; - } - rxMeasureSeqPrev = seq; - return; + // Measure rx rate / loss stats only + struct timeval currentTime; + ProtoSystemTime(currentTime); + UINT16 seq = msg.GetSequence(); + if (rxMeasureInit) + { + rxMeasureRefTime = currentTime; + rxMeasureSeqPrev = seq; + rxMeasurePktCount = rxMeasurePktTotal = 1; + rxMeasureByteTotal = msgLength; + rxMeasureInit = false; + return; + } + int seqDelta = (int)seq - (int)rxMeasureSeqPrev; + ASSERT(seqDelta > 0); + + rxMeasurePktTotal += seqDelta; // total should have received. + rxMeasurePktCount++; // total actually received + rxMeasureByteTotal += msgLength; + + if (seqDelta > rxMeasureGapMax) + rxMeasureGapMax = seqDelta; + + int deltaSec = currentTime.tv_sec - rxMeasureRefTime.tv_sec; + if (deltaSec >= 10) + { + if (currentTime.tv_usec > rxMeasureRefTime.tv_usec) + deltaSec += 1.0e-06 * (double)(currentTime.tv_usec - rxMeasureRefTime.tv_usec); + else + deltaSec -= 1.0e-06 * (double)(rxMeasureRefTime.tv_usec - currentTime.tv_usec); + double rxRate = (8.0/1000.0) * (double)rxMeasureByteTotal / (double)deltaSec; + double rxLoss = 100.0 * (1.0 - (double)rxMeasurePktCount / (double)rxMeasurePktTotal); + + rxMeasureRefTime = currentTime; + rxMeasureByteTotal = rxMeasurePktCount = rxMeasurePktTotal = rxMeasureGapMax = 0; + } + rxMeasureSeqPrev = seq; + return; #endif // RX_MEASURE_ONLY - bool ecnStatus = false; + bool ecnStatus = false; #ifdef SIMULATE - ecnStatus = theSocket.GetEcnStatus(); - //if (ecnStatus) TRACE("NORM RECEIVED PACKET W/ ECN BIT SET!!!!!\n"); + ecnStatus = theSocket.GetEcnStatus(); + //if (ecnStatus) TRACE("NORM RECEIVED PACKET W/ ECN BIT SET!!!!!\n"); #endif // SIMULATE - HandleReceiveMessage(msg, false, ecnStatus); - msgLength = NormMsg::MAX_SIZE; - } - else - { - PLOG(PL_ERROR, "NormSession::RxSocketRecvHandler() warning: received bad message\n"); - } - // If our system gets very busy reading sockets, we should occasionally - // execute any timeouts to keep protocol operation smooth (i.e., sending feedback) - // TBD - perhaps this should be time based - if (++recvCount >= 100) - { - break; - //session_mgr.DoSystemTimeout(); - //recvCount = 0; + bool wasUnicast; + if (destAddr.IsValid()) + wasUnicast = destAddr.IsUnicast(); + else + wasUnicast = false; + HandleReceiveMessage(msg, wasUnicast, ecnStatus); + msgLength = NormMsg::MAX_SIZE; + } + else + { + PLOG(PL_ERROR, "NormSession::RxSocketRecvHandler() warning: received bad message\n"); + } + // If our system gets very busy reading sockets, we should occasionally + // execute any timeouts to keep protocol operation smooth (i.e., sending feedback) + // TBD - perhaps this should be time based + if (++recvCount >= 100) + { + break; + //session_mgr.DoSystemTimeout(); + //recvCount = 0; + } + } + else + { + // Probably an ICMP "port unreachable" error + if (Address().IsUnicast()) + Notify(NormController::SEND_ERROR, NULL, NULL); + break; + } } } + else if (ProtoSocket::SEND == theEvent) + { + // This is a little cheesy, but ... + theSocket.StopOutputNotification(); + if (tx_timer.IsActive()) tx_timer.Deactivate(); + if (OnTxTimeout(tx_timer)) + { + if (!tx_timer.IsActive()) ActivateTimer(tx_timer); + } + } // end if/else (theEvent == RECV/SEND) } // end NormSession::RxSocketRecvHandler() @@ -2176,8 +2261,24 @@ void NormSession::OnPktCapture(ProtoChannel& theChannel, continue; // not a UDP packet for our session, go read next packet // If our rx_socket is "connected", make sure source addr/port matches srcIp.SetPort(udpPkt.GetSrcPort()); - if (rx_connect_addr.IsValid() && !rx_connect_addr.IsEqual(srcIp)) - continue; // not from the remote tx_socket to which we are "connected" + // if socket is connected, validate that the packet's from the specified source addr + if (rx_connect_addr.IsValid()) + { + if (0 != rx_connect_addr.GetPort()) + { + // check host addr component only for match + if (!rx_connect_addr.HostIsEqual(srcIp)) continue; + + + } + else + { + // check for addr _and_ port match + if (!rx_connect_addr.IsEqual(srcIp)) continue; + } + } + // if we are using SSM multicast make sure it's the right source addr + if (ssm_source_addr.IsValid() && !ssm_source_addr.HostIsEqual(srcIp)) continue; // IMPORTANT NOTE: We ignore the checksum for OUTBOUND packets since these // are often computed by the Ethernet hardware these days @@ -2194,7 +2295,7 @@ void NormSession::OnPktCapture(ProtoChannel& theChannel, { msg.AccessAddress() = srcIp; - HandleReceiveMessage(msg, !dstIp.IsMulticast(), (ProtoSocket::ECN_CE == ecnStatus)); + HandleReceiveMessage(msg, dstIp.IsUnicast(), (ProtoSocket::ECN_CE == ecnStatus)); } else { @@ -2209,7 +2310,8 @@ void NormTrace(const struct timeval& currentTime, NormNodeId localId, const NormMsg& msg, bool sent, - UINT8 fecM) + UINT8 fecM, + UINT16 instId) { static const char* MSG_NAME[] = { @@ -2270,7 +2372,7 @@ void NormTrace(const struct timeval& currentTime, { const NormInfoMsg& info = (const NormInfoMsg&)msg; PLOG(PL_ALWAYS, "inst>%hu seq>%hu INFO obj>%hu ", - info.GetInstanceId(), seq, (UINT16)info.GetObjectId()); + info.GetInstanceId(), seq, (UINT16)info.GetObjectId()); break; } case NormMsg::DATA: @@ -2367,6 +2469,7 @@ void NormTrace(const struct timeval& currentTime, case NormMsg::ACK: case NormMsg::NACK: { + PLOG(PL_ALWAYS, "inst>%hu ", instId); // look for NormCCFeedback extension NormHeaderExtension ext; while (msg.GetNextExtension(ext)) @@ -2394,7 +2497,7 @@ void NormTrace(const struct timeval& currentTime, } else { - PLOG(PL_ALWAYS, "ACK(XXX) "); + PLOG(PL_ALWAYS, "ACK(ZZZ) "); } } else @@ -2425,7 +2528,42 @@ void NormSession::HandleReceiveMessage(NormMsg& msg, bool wasUnicast, bool ecnSt struct timeval currentTime; ::ProtoSystemTime(currentTime); - if (trace) NormTrace(currentTime, LocalNodeId(), msg, false, 16); // TBD don't assume m == 16 (i.e. for fec_id == 2) + if (trace) + { + // Initially assume it's a message we generated (or similarly configured sender) + UINT8 fecM = fec_m; + UINT16 instId = instance_id; + NormNodeId senderId; + switch (msg.GetType()) + { + case NormMsg::ACK: + senderId = static_cast(msg).GetSenderId(); + break; + case NormMsg::NACK: + senderId = static_cast(msg).GetSenderId(); + break; + default: + senderId = msg.GetSourceId(); + break; + } + if (IsReceiver() && (senderId != LocalNodeId())) + { + // Use our receiver state to look up sender if possible + NormSenderNode* sender = static_cast(sender_tree.FindNodeById(senderId)); + if (NULL != sender) + { + fecM = sender->GetFecFieldSize(); + instId = sender->GetInstanceId(); + } + else + { + fecM = 16; // reasonable assumption + instId = 0; + } + } + + NormTrace(currentTime, LocalNodeId(), msg, false, fecM, instId); // TBD don't assume m == 16 (i.e. for fec_id == 2) + } NormMsg::Type msgType = msg.GetType(); @@ -2454,6 +2592,8 @@ void NormSession::HandleReceiveMessage(NormMsg& msg, bool wasUnicast, bool ecnSt { if (!SenderAddAckingNode(msg.GetSourceId())) PLOG(PL_ERROR, "NormSession::HandleReceiveMessage() error: unable to add acking node!\n"); + NormAckingNode* acker = (NormAckingNode*)acking_node_tree.FindNodeById(sourceId); + Notify(NormController::ACKING_NODE_NEW, acker, NULL); } } } @@ -2512,7 +2652,8 @@ void NormSession::ReceiverHandleObjectMessage(const struct timeval& currentTim { PLOG(PL_INFO, "NormSession::ReceiverHandleObjectMessage() node>%lu sender>%lu instanceId change - resyncing.\n", LocalNodeId(), theSender->GetId()); - theSender->Close(); + theSender->Close(); + Notify(NormController::REMOTE_SENDER_RESET, theSender, NULL); if (!theSender->Open(msg.GetInstanceId())) { PLOG(PL_ERROR, "NormSession::ReceiverHandleObjectMessage() node>%lu error re-opening NormSenderNode\n"); @@ -2528,6 +2669,7 @@ void NormSession::ReceiverHandleObjectMessage(const struct timeval& currentTim theSender = preset_sender; preset_sender = NULL; theSender->SetId(msg.GetSourceId()); + theSender->SetAddress(msg.GetSource()); theSender->SetInstanceId(msg.GetInstanceId()); sender_tree.AttachNode(theSender); PLOG(PL_DEBUG, "NormSession::ReceiverHandleObjectMessage() node>%lu new remote sender:%lu ...\n", @@ -2535,6 +2677,7 @@ void NormSession::ReceiverHandleObjectMessage(const struct timeval& currentTim } else if (NULL != (theSender = new NormSenderNode(*this, msg.GetSourceId()))) { + theSender->SetAddress(msg.GetSource()); Notify(NormController::REMOTE_SENDER_NEW, theSender, NULL); if (theSender->Open(msg.GetInstanceId())) { @@ -2558,7 +2701,12 @@ void NormSession::ReceiverHandleObjectMessage(const struct timeval& currentTim } } theSender->Activate(true); - theSender->SetAddress(msg.GetSource()); + if (!theSender->GetAddress().IsEqual(msg.GetSource())) + { + // sender source address has changed + theSender->SetAddress(msg.GetSource()); + Notify(NormController::REMOTE_SENDER_ADDRESS, theSender, NULL); + } theSender->UpdateRecvRate(currentTime, msg.GetLength()); //if (ecnStatus) TRACE("UPDATING LOSS EST w/ ECN pkt\n"); theSender->UpdateLossEstimate(currentTime, msg.GetSequence(), ecnStatus); @@ -2576,13 +2724,14 @@ void NormSession::ReceiverHandleCommand(const struct timeval& currentTime, // Do common updates for senders we already know. NormNodeId sourceId = cmd.GetSourceId(); NormSenderNode* theSender = (NormSenderNode*)sender_tree.FindNodeById(sourceId); - if (theSender) + if (NULL != theSender) { if (cmd.GetInstanceId() != theSender->GetInstanceId()) { PLOG(PL_INFO, "NormSession::ReceiverHandleCommand() node>%lu sender>%lu instanceId change - resyncing.\n", LocalNodeId(), theSender->GetId()); theSender->Close(); + Notify(NormController::REMOTE_SENDER_RESET, theSender, NULL); if (!theSender->Open(cmd.GetInstanceId())) { PLOG(PL_ERROR, "NormSession::ReceiverHandleCommand() node>%lu error re-opening NormSenderNode\n"); @@ -2600,6 +2749,7 @@ void NormSession::ReceiverHandleCommand(const struct timeval& currentTime, theSender = preset_sender; preset_sender = NULL; theSender->SetId(cmd.GetSourceId()); + theSender->SetAddress(cmd.GetSource()); theSender->SetInstanceId(cmd.GetInstanceId()); sender_tree.AttachNode(theSender); PLOG(PL_DEBUG, "NormSession::ReceiverHandleObjectMessage() node>%lu new remote sender:%lu ...\n", @@ -2608,6 +2758,7 @@ void NormSession::ReceiverHandleCommand(const struct timeval& currentTime, else if ((theSender = new NormSenderNode(*this, cmd.GetSourceId()))) { Notify(NormController::REMOTE_SENDER_NEW, theSender, NULL); + theSender->SetAddress(cmd.GetSource()); if (theSender->Open(cmd.GetInstanceId())) { sender_tree.AttachNode(theSender); @@ -2634,7 +2785,12 @@ void NormSession::ReceiverHandleCommand(const struct timeval& currentTime, theSender->Activate(true); else theSender->Activate(false); - theSender->SetAddress(cmd.GetSource()); + if (!theSender->GetAddress().IsEqual(cmd.GetSource())) + { + // sender source address has changed + theSender->SetAddress(cmd.GetSource()); + Notify(NormController::REMOTE_SENDER_ADDRESS, theSender, NULL); + } theSender->UpdateRecvRate(currentTime, cmd.GetLength()); theSender->UpdateLossEstimate(currentTime, cmd.GetSequence(), ecnStatus); theSender->IncrementRecvTotal(cmd.GetLength()); // for statistics only (TBD) #ifdef NORM_DEBUG @@ -3076,14 +3232,14 @@ void NormSession::SenderHandleNackMessage(const struct timeval& currentTime, Nor if (GetDebugLevel() >= PL_DEBUG) { - PLOG(PL_ALWAYS, "node>%lu sender (tactive:%d)received NACK message with content:\n", + PLOG(PL_ALWAYS, "node>%lu sender (tactive:%d) received NACK message with content:\n", LocalNodeId(), repair_timer.IsActive()); LogRepairContent(nack.GetRepairContent(), nack.GetRepairContentLength(), fec_id, fec_m); PLOG(PL_ALWAYS, "\n"); } // (TBD) maintain average of "numErasures" for SEGMENT repair requests - // to use as input to a an automatic "auto parity" adjustor + // to use as input to a future automatic "auto parity" adjustor??? // Update GRTT estimate struct timeval grttResponse; nack.GetGrttResponse(grttResponse); @@ -3660,8 +3816,8 @@ void NormSession::ReceiverHandleAckMessage(const NormAckMsg& ack) } else { - PLOG(PL_DEBUG, "NormSession::ReceiverHandleAckMessage() node>%lu heard ACK for unknown sender.\n", - LocalNodeId()); + PLOG(PL_DEBUG, "NormSession::ReceiverHandleAckMessage() node>%lu heard ACK for unknown sender>%lu.\n", + LocalNodeId(), ack.GetSenderId()); } } // end NormSession::ReceiverHandleAckMessage() @@ -4239,16 +4395,17 @@ bool NormSession::SendMessage(NormMsg& msg) // (TBD) fill in InstanceId fields on all messages as needed // We need "fec_m" for the message for NormTrace() purposes UINT8 fecM = fec_m; // assume it's a sender message (will be overridden otherwise) + UINT16 instId = instance_id; // assume it's a sender message (will be overridden otherwise) switch (msg.GetType()) { case NormMsg::INFO: case NormMsg::DATA: - ((NormObjectMsg&)msg).SetInstanceId(instance_id); + ((NormObjectMsg&)msg).SetInstanceId(instId); msg.SetSequence(tx_sequence++); // (TBD) set for session dst msgs break; case NormMsg::CMD: { - ((NormCmdMsg&)msg).SetInstanceId(instance_id); + ((NormCmdMsg&)msg).SetInstanceId(instId); switch (((NormCmdMsg&)msg).GetFlavor()) { case NormCmdMsg::CC: @@ -4276,6 +4433,7 @@ bool NormSession::SendMessage(NormMsg& msg) (NormSenderNode*)sender_tree.FindNodeById(nack.GetSenderId()); ASSERT(NULL != theSender); fecM = theSender->GetFecFieldSize(); + instId = theSender->GetInstanceId(); struct timeval currentTime; ProtoSystemTime(currentTime); struct timeval grttResponse; @@ -4292,6 +4450,7 @@ bool NormSession::SendMessage(NormMsg& msg) (NormSenderNode*)sender_tree.FindNodeById(ack.GetSenderId()); ASSERT(NULL != theSender); fecM = theSender->GetFecFieldSize(); + instId = theSender->GetInstanceId(); struct timeval grttResponse; struct timeval currentTime; ProtoSystemTime(currentTime); @@ -4325,7 +4484,7 @@ bool NormSession::SendMessage(NormMsg& msg) { struct timeval currentTime; ProtoSystemTime(currentTime); - NormTrace(currentTime, LocalNodeId(), msg, true, fecM); + NormTrace(currentTime, LocalNodeId(), msg, true, fecM, instId); } // Update sent rate tracker even if dropped (for testing/debugging) sent_accumulator.Increment(msgSize); @@ -4340,7 +4499,7 @@ bool NormSession::SendMessage(NormMsg& msg) { struct timeval currentTime; ProtoSystemTime(currentTime); - NormTrace(currentTime, LocalNodeId(), msg, true, fecM); + NormTrace(currentTime, LocalNodeId(), msg, true, fecM, instId); } // To keep track of _actual_ sent rate sent_accumulator.Increment(msgSize); @@ -4349,7 +4508,8 @@ bool NormSession::SendMessage(NormMsg& msg) } else { - PLOG(PL_DETAIL, "NormSession::SendMessage() sendto() error: %s\n", GetErrorString()); + PLOG(PL_ERROR, "NormSession::SendMessage() sendto(%s/%hu) error: %s\n", + msg.GetDestination().GetHostString(), msg.GetDestination().GetPort(), GetErrorString()); tx_sequence--; return false; } @@ -4876,10 +5036,19 @@ bool NormSession::OnReportTimeout(ProtoTimer& /*theTimer*/) struct tm* ct = &timeStruct; #else time_t secs = (time_t)currentTime.tv_sec; - struct tm* ct = gmtime(&secs); + struct tm timeStruct; + //struct tm* ct = gmtime(&secs); +#ifdef WIN32 + gmtime_s(&timeStruct, &secs); + struct tm* ct = &timeStruct; +#else + struct tm* ct = gmtime_r(&secs, &timeStruct); +#endif + #endif // if/else _WIN32_WCE + ASSERT(NULL != ct); PLOG(PL_INFO, "REPORT time>%02d:%02d:%02d.%06lu node>%lu ***************************************\n", - ct->tm_hour, ct->tm_min, ct->tm_sec, currentTime.tv_usec, LocalNodeId()); + ct->tm_hour, ct->tm_min, ct->tm_sec, currentTime.tv_usec, LocalNodeId()); if (IsSender()) { PLOG(PL_INFO, "Local status:\n"); @@ -4925,6 +5094,14 @@ bool NormSession::OnReportTimeout(ProtoTimer& /*theTimer*/) return true; } // end NormSession::OnReportTimeout() +bool NormSession::OnUserTimeout(ProtoTimer& /*theTimer*/) +{ + Notify(NormController::USER_TIMEOUT, (NormSenderNode*)NULL, (NormObject*)NULL); + return true; +} // end NormSession::OnUserTimeout( + + + NormSessionMgr::NormSessionMgr(ProtoTimerMgr& timerMgr, ProtoSocket::Notifier& socketNotifier, ProtoChannel::Notifier* channelNotifier) diff --git a/src/common/pcap2norm.cpp b/src/common/pcap2norm.cpp index fa2268d..a774dc3 100644 --- a/src/common/pcap2norm.cpp +++ b/src/common/pcap2norm.cpp @@ -342,7 +342,8 @@ void NormTrace2(const struct timeval& currentTime, clrFlag = ((NormCCFeedbackExtension&)ext).CCFlagIsSet(NormCC::CLR); // Print ccRtt (only valid if pcap file is from sender node) double ccRtt = NormUnquantizeRtt(((NormCCFeedbackExtension&)ext).GetCCRtt()); - PLOG(PL_ALWAYS, "ccRtt:%lf ", ccRtt); + double ccLoss = NormUnquantizeLoss32(((NormCCFeedbackExtension&)ext).GetCCLoss32()); + PLOG(PL_ALWAYS, "ccRtt:%lf ccLoss:%lf ", ccRtt, ccLoss); break; } } diff --git a/src/java/jni/normEventJni.cpp b/src/java/jni/normEventJni.cpp index 75e7922..fb17dec 100644 --- a/src/java/jni/normEventJni.cpp +++ b/src/java/jni/normEventJni.cpp @@ -6,8 +6,7 @@ JNIEXPORT jobject JNICALL PKGNAME(NormEvent_getObject) NormObjectHandle objectHandle; jobject object = NULL; - objectHandle = (NormObjectHandle)env->GetLongField(obj, - fid_NormEvent_objectHandle); + objectHandle = (NormObjectHandle)env->GetLongField(obj, fid_NormEvent_objectHandle); switch (NormObjectGetType(objectHandle)) { case NORM_OBJECT_DATA: diff --git a/src/java/jni/normSessionJni.cpp b/src/java/jni/normSessionJni.cpp index 1c7322c..f3c4eef 100644 --- a/src/java/jni/normSessionJni.cpp +++ b/src/java/jni/normSessionJni.cpp @@ -95,6 +95,26 @@ JNIEXPORT void JNICALL PKGNAME(NormSession_setMulticastInterface) env->ReleaseStringUTFChars(interfaceName, str); } + +JNIEXPORT void JNICALL PKGNAME(NormSession_setSSM) + (JNIEnv *env, jobject obj, jstring sourceAddr) { + NormSessionHandle session; + const char *str; + + session = (NormSessionHandle)env->GetLongField(obj, fid_NormSession_handle); + + str = env->GetStringUTFChars(sourceAddr, NULL); + + if (!NormSetSSM(session, str)) { + env->ReleaseStringUTFChars(sourceAddr, str); + env->ThrowNew((jclass)env->NewLocalRef(jw_IOException), "Failed to set SSM source address"); + return; + } + + env->ReleaseStringUTFChars(sourceAddr, str); +} + + JNIEXPORT void JNICALL PKGNAME(NormSession_setTTL) (JNIEnv *env, jobject obj, jbyte ttl) { NormSessionHandle session; diff --git a/src/java/jni/normSessionJni.h b/src/java/jni/normSessionJni.h index e3ea161..49ff473 100644 --- a/src/java/jni/normSessionJni.h +++ b/src/java/jni/normSessionJni.h @@ -42,7 +42,7 @@ JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_setRxPortReuse /* * Class: mil_navy_nrl_norm_NormSession * Method: setEcnSupport - * Signature: (ZZ)V + * Signature: (ZZZ)V */ JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_setEcnSupport (JNIEnv *, jobject, jboolean, jboolean, jboolean); @@ -55,6 +55,14 @@ JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_setEcnSupport JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_setMulticastInterface (JNIEnv *, jobject, jstring); +/* + * Class: mil_navy_nrl_norm_NormSession + * Method: setSSM + * Signature: (Ljava/lang/String;)V + */ +JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_setSSM + (JNIEnv *, jobject, jstring); + /* * Class: mil_navy_nrl_norm_NormSession * Method: setTTL @@ -321,7 +329,7 @@ JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_cancelWatermark /* * Class: mil_navy_nrl_norm_NormSession - * Method: cancelWatermark + * Method: resetWatermark * Signature: ()V */ JNIEXPORT void JNICALL Java_mil_navy_nrl_norm_NormSession_resetWatermark diff --git a/src/java/src/mil/navy/nrl/norm/NormEvent.java b/src/java/src/mil/navy/nrl/norm/NormEvent.java index f0a069c..1bcf9ed 100644 --- a/src/java/src/mil/navy/nrl/norm/NormEvent.java +++ b/src/java/src/mil/navy/nrl/norm/NormEvent.java @@ -31,7 +31,7 @@ public class NormEvent { } /** - * @return Returns the node. + * @return Returns the session. */ public NormSession getSession() { if (sessionHandle == 0) { @@ -51,6 +51,9 @@ public class NormEvent { return new NormNode(nodeHandle); } + /** + * @return Returns the object. + */ public native NormObject getObject(); /** diff --git a/src/java/src/mil/navy/nrl/norm/NormObject.java b/src/java/src/mil/navy/nrl/norm/NormObject.java index 154f842..72113f9 100644 --- a/src/java/src/mil/navy/nrl/norm/NormObject.java +++ b/src/java/src/mil/navy/nrl/norm/NormObject.java @@ -11,7 +11,7 @@ import mil.navy.nrl.norm.enums.NormObjectType; * @author Jason Rush */ public class NormObject { - private long handle; // The pointer to the native NormInstanceHandle + private long handle; // The pointer to the native NormObjectHandle NormObject(long handle) { this.handle = handle; diff --git a/src/java/src/mil/navy/nrl/norm/NormSession.java b/src/java/src/mil/navy/nrl/norm/NormSession.java index d6fdf11..dd286f4 100644 --- a/src/java/src/mil/navy/nrl/norm/NormSession.java +++ b/src/java/src/mil/navy/nrl/norm/NormSession.java @@ -19,7 +19,7 @@ import mil.navy.nrl.norm.enums.NormSyncPolicy; public class NormSession { private static Map normSessions = new HashMap(); - private long handle; // The pointer to the native NormInstanceHandle + private long handle; // The pointer to the native NormSessionHandle /** * Package protected constructor is invoked by NormInstance @@ -38,7 +38,6 @@ public class NormSession { public void destroySession() { normSessions.remove(handle); - destroySessionNative(); } @@ -63,7 +62,10 @@ public class NormSession { public native void setMulticastInterface(String interfaceName) throws IOException; - + + public native void setSSM(String sourceAddr) + throws IOException; + public native void setTTL(byte ttl) throws IOException; public native void setTOS(byte tos) throws IOException; diff --git a/src/java/src/mil/navy/nrl/norm/enums/NormEventType.java b/src/java/src/mil/navy/nrl/norm/enums/NormEventType.java index 5a023fa..7d5d1c2 100644 --- a/src/java/src/mil/navy/nrl/norm/enums/NormEventType.java +++ b/src/java/src/mil/navy/nrl/norm/enums/NormEventType.java @@ -19,6 +19,8 @@ public enum NormEventType { NORM_TX_RATE_CHANGED, NORM_LOCAL_SENDER_CLOSED, NORM_REMOTE_SENDER_NEW, + NORM_REMOTE_SENDER_RESET, + NORM_REMOTE_SENDER_ADDRESS, NORM_REMOTE_SENDER_ACTIVE, NORM_REMOTE_SENDER_INACTIVE, NORM_REMOTE_SENDER_PURGED, diff --git a/src/java/src/mil/navy/nrl/norm/enums/NormSyncPolicy.java b/src/java/src/mil/navy/nrl/norm/enums/NormSyncPolicy.java index 20d6c46..5237456 100644 --- a/src/java/src/mil/navy/nrl/norm/enums/NormSyncPolicy.java +++ b/src/java/src/mil/navy/nrl/norm/enums/NormSyncPolicy.java @@ -1,7 +1,4 @@ -/* - * Copyright (c) 2010 by General Dynamics Advanced Information Systems - * Classification: UNCLASSIFIED - */ + package mil.navy.nrl.norm.enums; /** @@ -11,6 +8,7 @@ package mil.navy.nrl.norm.enums; * * @author Jason Rush */ + public enum NormSyncPolicy { NORM_SYNC_CURRENT, NORM_SYNC_STREAM, diff --git a/src/java/src/mil/navy/nrl/norm/io/INormEventListener.java b/src/java/src/mil/navy/nrl/norm/io/INormEventListener.java index d98e3c0..11984d4 100644 --- a/src/java/src/mil/navy/nrl/norm/io/INormEventListener.java +++ b/src/java/src/mil/navy/nrl/norm/io/INormEventListener.java @@ -1,7 +1,4 @@ -/* - * Copyright (c) 2010 by General Dynamics Advanced Information Systems - * Classification: UNCLASSIFIED - */ + package mil.navy.nrl.norm.io; import mil.navy.nrl.norm.NormEvent; diff --git a/src/java/src/mil/navy/nrl/norm/io/NormInputStream.java b/src/java/src/mil/navy/nrl/norm/io/NormInputStream.java index 526ad8b..df33c35 100644 --- a/src/java/src/mil/navy/nrl/norm/io/NormInputStream.java +++ b/src/java/src/mil/navy/nrl/norm/io/NormInputStream.java @@ -1,7 +1,3 @@ -/* - * Copyright (c) 2010 by General Dynamics Advanced Information Systems - * Classification: UNCLASSIFIED - */ package mil.navy.nrl.norm.io; import java.io.IOException; @@ -33,6 +29,7 @@ public class NormInputStream extends InputStream { private Object closeLock; private boolean bufferIsEmpty; + private boolean receivedEof; public NormInputStream(String address, int port) throws IOException { // Create the NORM instance @@ -50,6 +47,7 @@ public class NormInputStream extends InputStream { closeLock = new Object(); bufferIsEmpty = true; + receivedEof = false; } public synchronized void openDebugLog(String filename) throws IOException { @@ -59,11 +57,11 @@ public class NormInputStream extends InputStream { public synchronized void closeDebugLog() { normInstance.closeDebugLog(); } - + public synchronized void setDebugLevel(int level) { normInstance.setDebugLevel(level); } - + public synchronized void setMessageTrace(boolean messageTrace) { normSession.setMessageTrace(messageTrace); } @@ -198,12 +196,12 @@ public class NormInputStream extends InputStream { } do { - while (normInstance.hasNextEvent(0, 0)) { + while (bufferIsEmpty || normInstance.hasNextEvent(0, 0)) { processEvent(); - } - while (bufferIsEmpty) { - processEvent(); + if (receivedEof) { + return -1; + } } if (normStream == null) { @@ -254,6 +252,9 @@ public class NormInputStream extends InputStream { case NORM_RX_OBJECT_ABORTED: case NORM_RX_OBJECT_COMPLETED: normStream = null; + + // Signal that the stream has ended + receivedEof = true; break; default: diff --git a/src/java/src/mil/navy/nrl/norm/io/NormOutputStream.java b/src/java/src/mil/navy/nrl/norm/io/NormOutputStream.java index c23c737..c6d2fdd 100644 --- a/src/java/src/mil/navy/nrl/norm/io/NormOutputStream.java +++ b/src/java/src/mil/navy/nrl/norm/io/NormOutputStream.java @@ -1,7 +1,4 @@ -/* - * Copyright (c) 2010 by General Dynamics Advanced Information Systems - * Classification: UNCLASSIFIED - */ + package mil.navy.nrl.norm.io; import java.io.IOException; diff --git a/src/java/src/mil/navy/nrl/norm/io/StreamBreakException.java b/src/java/src/mil/navy/nrl/norm/io/StreamBreakException.java index 51e1122..06f5a65 100644 --- a/src/java/src/mil/navy/nrl/norm/io/StreamBreakException.java +++ b/src/java/src/mil/navy/nrl/norm/io/StreamBreakException.java @@ -1,7 +1,4 @@ -/* - * Copyright (c) 2010 by General Dynamics Advanced Information Systems - * Classification: UNCLASSIFIED - */ + package mil.navy.nrl.norm.io; import java.io.IOException; diff --git a/src/pynorm/constants.py b/src/pynorm/constants.py index 4f24bca..c2ad5d0 100644 --- a/src/pynorm/constants.py +++ b/src/pynorm/constants.py @@ -58,18 +58,20 @@ NORM_TX_OBJECT_PURGED = 7 NORM_TX_RATE_CHANGED = 8 NORM_LOCAL_SENDER_CLOSED = 9 NORM_REMOTE_SENDER_NEW = 10 -NORM_REMOTE_SENDER_ACTIVE = 11 -NORM_REMOTE_SENDER_INACTIVE = 12 -NORM_REMOTE_SENDER_PURGED = 13 -NORM_RX_CMD_NEW = 14 -NORM_RX_OBJECT_NEW = 15 -NORM_RX_OBJECT_INFO = 16 -NORM_RX_OBJECT_UPDATED = 17 -NORM_RX_OBJECT_COMPLETED = 18 -NORM_RX_OBJECT_ABORTED = 19 -NORM_GRTT_UPDATED = 20 -NORM_CC_ACTIVE = 21 -NORM_CC_INACTIVE = 22 +NORM_REMOTE_SENDER_RESET = 11 +NORM_REMOTE_SENDER_ADDRESS = 12 +NORM_REMOTE_SENDER_ACTIVE = 13 +NORM_REMOTE_SENDER_INACTIVE = 14 +NORM_REMOTE_SENDER_PURGED = 15 +NORM_RX_CMD_NEW = 16 +NORM_RX_OBJECT_NEW = 17 +NORM_RX_OBJECT_INFO = 18 +NORM_RX_OBJECT_UPDATED = 19 +NORM_RX_OBJECT_COMPLETED = 20 +NORM_RX_OBJECT_ABORTED = 21 +NORM_GRTT_UPDATED = 22 +NORM_CC_ACTIVE = 23 +NORM_CC_INACTIVE = 24 diff --git a/src/pynorm/core.py b/src/pynorm/core.py index 1d0b74c..d18a5a2 100644 --- a/src/pynorm/core.py +++ b/src/pynorm/core.py @@ -154,10 +154,13 @@ def get_libnorm(): ctypes.c_bool, ctypes.c_bool] libnorm.NormSetMulticastInterface.restype = ctypes.c_bool - libnorm.NormSetMulticastInterface.argtypes = [ctypes.c_void_p, - ctypes.c_char_p] + libnorm.NormSetMulticastInterface.argtypes = [ctypes.c_void_p, ctypes.c_char_p] libnorm.NormSetMulticastInterface.errcheck = errcheck_bool - + + libnorm.NormSetSSM.restype = ctypes.c_bool + libnorm.NormSetSSM.argtypes = [ctypes.c_void_p, ctypes.c_char_p] + libnorm.NormSetSSM.errcheck = errcheck_bool + libnorm.NormSetTTL.restype = ctypes.c_bool libnorm.NormSetTTL.argtypes = [ctypes.c_void_p, ctypes.c_uint8] libnorm.NormSetTTL.errcheck = errcheck_bool diff --git a/src/pynorm/event.py b/src/pynorm/event.py index 8439932..a9a17e5 100644 --- a/src/pynorm/event.py +++ b/src/pynorm/event.py @@ -63,6 +63,10 @@ class Event(object): return "NORM_LOCAL_SENDER_CLOSED" elif self.type == c.NORM_REMOTE_SENDER_NEW: return "NORM_REMOTE_SENDER_NEW" + elif self.type == c.NORM_REMOTE_SENDER_RESET: + return "NORM_REMOTE_SENDER_RESET" + elif self.type == c.NORM_REMOTE_SENDER_ADDRESS: + return "NORM_REMOTE_SENDER_ADDRESS" elif self.type == c.NORM_REMOTE_SENDER_ACTIVE: return "NORM_REMOTE_SENDER_ACTIVE" elif self.type == c.NORM_REMOTE_SENDER_INACTIVE: diff --git a/src/pynorm/session.py b/src/pynorm/session.py index 7655f29..9c6924f 100644 --- a/src/pynorm/session.py +++ b/src/pynorm/session.py @@ -49,7 +49,10 @@ class Session(object): def setMulticastInterface(self, iface): libnorm.NormSetMulticastInterface(self, iface) - + + def setSSM(self, srcAddr): + libnorm.NormSetSSM(self, srcAddr) + def setTTL(self, ttl): libnorm.NormSetTTL(self, ttl) diff --git a/src/sim/opnet/12.0/norm_protolib.pr.cpp b/src/sim/opnet/12.0/norm_protolib.pr.cpp index 1656eeb..246bd30 100644 --- a/src/sim/opnet/12.0/norm_protolib.pr.cpp +++ b/src/sim/opnet/12.0/norm_protolib.pr.cpp @@ -1,8 +1,6 @@ /* Process model C++ form file: norm_protolib.pr.cpp */ /* Portions of this file copyright 1992-2006 by OPNET Technologies, Inc. */ - - /* This variable carries the header into the object file */ const char norm_protolib_pr_cpp [] = "MIL_3_Tfile_Hdr_ 120A 30A modeler 7 464DEF85 464DEF85 1 wn12jh Jim@Hauser 0 0 none none 0 0 none 0 0 0 0 0 0 0 0 10de 3 "; #include diff --git a/waf b/waf index 4e68fedc548287026a69560acb79f5c030596550..f6e96169d3883a30306aacc5a9c0553348be6f6c 100755 GIT binary patch delta 94471 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 Z*4q6(432lPcK_c?fzn0(zpu)F{txx|GqL~x delta 87852 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 L&;SY}JUu-MuC|dN

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 z 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