LIVELINESS
[QoS Policies]

Specifies and configures the mechanism that allows DDSDataReader entities to detect when DDSDataWriter entities become disconnected or "dead.". More...

Classes

struct  DDS_LivelinessQosPolicy
 Specifies and configures the mechanism that allows DDSDataReader entities to detect when DDSDataWriter entities become disconnected or "dead.". More...

Enumerations

enum  DDS_LivelinessQosPolicyKind {
  DDS_AUTOMATIC_LIVELINESS_QOS,
  DDS_MANUAL_BY_PARTICIPANT_LIVELINESS_QOS,
  DDS_MANUAL_BY_TOPIC_LIVELINESS_QOS
}
 Kinds of liveliness. More...

Variables

const char *const DDS_LIVELINESS_QOS_POLICY_NAME
 Stringified human-readable name for DDS_LivelinessQosPolicy.

Detailed Description

Specifies and configures the mechanism that allows DDSDataReader entities to detect when DDSDataWriter entities become disconnected or "dead.".


Enumeration Type Documentation

Kinds of liveliness.

QoS:
DDS_LivelinessQosPolicy
Enumerator:
DDS_AUTOMATIC_LIVELINESS_QOS  [default] The infrastructure will automatically signal liveliness for the DDSDataWriter (s) at least as often as required by the lease_duration.

A DDSDataWriter with this setting does not need to take any specific action in order to be considered 'alive.' The DDSDataWriter is only 'not alive' when the participant to which it belongs terminates (gracefully or not), or when there is a network problem that prevents the current participant from contacting that remote participant.

DDS_MANUAL_BY_PARTICIPANT_LIVELINESS_QOS  RTI Connext will assume that as long as at least one DDSDataWriter belonging to the DDSDomainParticipant (or the DDSDomainParticipant itself) has asserted its liveliness, then the other Entities belonging to that same DDSDomainParticipant are also alive.

The user application takes responsibility to signal liveliness to RTI Connext either by calling DDSDomainParticipant::assert_liveliness, or by calling DDSDataWriter::assert_liveliness, or FooDataWriter::write on any DDSDataWriter belonging to the DDSDomainParticipant.

DDS_MANUAL_BY_TOPIC_LIVELINESS_QOS  RTI Connext will only assume liveliness of the DDSDataWriter if the application has asserted liveliness of that DDSDataWriter itself.

The user application takes responsibility to signal liveliness to RTI Connext using the DDSDataWriter::assert_liveliness method, or by writing some data.


Variable Documentation

const char* const DDS_LIVELINESS_QOS_POLICY_NAME

Stringified human-readable name for DDS_LivelinessQosPolicy.


RTI Connext C++ API Version 4.5f Copyright © 17 Mar 2012 Real-Time Innovations, Inc