RTI Connext Traditional C++ API Version 7.3.0

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. More...
 

Detailed Description

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

Enumeration Type Documentation

◆ DDS_LivelinessQosPolicyKind

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 DDSDataWriter (S) 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 DataWriters 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

◆ DDS_LIVELINESS_QOS_POLICY_NAME

const char* const DDS_LIVELINESS_QOS_POLICY_NAME
extern

Stringified human-readable name for DDS_LivelinessQosPolicy.