DDS::ReceiverPoolQosPolicy Class Reference
[RECEIVER_POOL]

Configures threads used by RTI Data Distribution Service to receive and process data from transports (for example, UDP sockets). More...

#include <managed_infrastructure.h>

List of all members.

Static Public Member Functions

static System::String^ get_receiverpool_qos_policy_name ()
 Stringified human-readable name for DDS::ReceiverPoolQosPolicy.

Public Attributes

ThreadSettings_tthread
 Receiver pool thread(s).
System::Int32 buffer_size
 The receive buffer size.
System::Int32 buffer_alignment
 The receive buffer alignment.


Detailed Description

Configures threads used by RTI Data Distribution Service to receive and process data from transports (for example, UDP sockets).

This QoS policy is an extension to the DDS standard.

Entity:
DDS::DomainParticipant
Properties:
RxO = N/A
Changeable = NO
See also:
Controlling CPU Core Affinity for RTI Threads

Usage

This QoS policy sets the thread properties such as priority level and stack size for the threads used by the middleware to receive and process data from transports.

RTI uses a separate receive thread per port per transport plug-in. To force RTI Data Distribution Service to use a separate thread to process the data for a DDS::DataReader, set a unique port for the DDS::TransportUnicastQosPolicy or DDS::TransportMulticastQosPolicy for the DDS::DataReader.

This QoS policy also sets the size of the buffer used to store packets received from a transport. This buffer size will limit the largest single packet of data that a DDS::DomainParticipant will accept from a transport. Users will often set this size to the largest packet that any of the transports used by their application will deliver. For many applications, the value 65,536 (64 K) is a good choice; this value is the largest packet that can be sent/received via UDP.


Member Data Documentation

Receiver pool thread(s).

There is at least one receive thread, possibly more.

[default] priority above normal.
The actual value depends on your architecture:

For Windows: 2
For Solaris: OS default priority
For Linux: OS default priority
For LynxOS: 29
For INTEGRITY: 100
For VxWorks: 71

For all others: OS default priority.

[default] The actual value depends on your architecture:

For Windows: OS default stack size
For Solaris: OS default stack size
For Linux: OS default stack size
For LynxOS: 4*16*1024
For INTEGRITY: 4*20*1024
For VxWorks: 4*16*1024

For all others: OS default stack size.

[default] mask DDS::ThreadSettingsKind::THREAD_SETTINGS_FLOATING_POINT | DDS::ThreadSettingsKind::THREAD_SETTINGS_STDIO

The receive buffer size.

The receive buffer is used by the receive thread to store the raw data that arrives over the transport.

In many applications, users will change the configuration of the built-in transport DDS::Transport_Property_t::message_size_max to increase the size of the largest data packet that can be sent or received through the transport. Typically, users will change the UDPv4 transport plugin's DDS::Transport_Property_t::message_size_max to 65536 (64 K), which is the largest packet that can be sent/received via UDP.

Ihe ReceiverPoolQosPolicy's buffer_size should be set to be the same value as the maximum DDS::Transport_Property_t::message_size_max across all of the transports being used.

If you are using the default configuration of the built-in transports, you should not need to change this buffer size.

In addition, if your application only uses transports that support zero-copy, then you do not need to modify the value of buffer_size, even if the DDS::Transport_Property_t::message_size_max of the transport is changed. Transports that support zero-copy do not copy their data into the buffer provided by the receive thread. Instead, they provide the receive thread data in a buffer allocated by the transport itself. The only built-in transport that supports zero-copy is the UDPv4 transport on VxWorks platforms.

[default] 9216

[range] [1, 1 GB]

The receive buffer alignment.

Most users will not need to change this alignment.

[default] 16

[range] [1,1024] Value must be a power of 2.


RTI Data Distribution Service .Net APIs Version 4.5c Copyright © 9 Jun 2010 Real-Time Innovations, Inc