RTI Connext DDS Micro C++ API  Version 4.0.1
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
LIVELINESS

Determines the mechanism and parameters used by the application to determine whether a DDSEntity is alive. More...

Classes

struct  DDS_LivelinessQosPolicy
 <<cert>> Determines the mechanism and parameters used by the application to determine whether a DDSEntity is alive. 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...

Detailed Description

Determines the mechanism and parameters used by the application to determine whether a DDSEntity is alive.


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 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 DDS Micro 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 DDS Micro 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 DDS Micro 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 DDS Micro using the DDSDataWriter::assert_liveliness method, or by writing some data.


RTI Connext DDS Micro C++ API Version 4.0.1 Copyright © Mon Jun 3 2024 Real-Time Innovations, Inc