Enum rmw_qos_reliability_policy_e

• Defined in File types.h

Enum Documentation

enum rmw_qos_reliability_policy_e

Values:

enumerator RMW_QOS_POLICY_RELIABILITY_SYSTEM_DEFAULT

Implementation specific default.

enumerator RMW_QOS_POLICY_RELIABILITY_RELIABLE

Guarantee that samples are delivered, may retry multiple times.

enumerator RMW_QOS_POLICY_RELIABILITY_BEST_EFFORT

Attempt to deliver samples, but some may be lost if the network is not robust.

enumerator RMW_QOS_POLICY_RELIABILITY_UNKNOWN

Reliability policy has not yet been set.

enumerator RMW_QOS_POLICY_RELIABILITY_BEST_AVAILABLE

Will match the majority of endpoints and use a reliable policy if possible.

A policy will be chosen at the time of creating a subscription or publisher. A reliable policy will by chosen if it matches with all discovered endpoints, otherwise a best effort policy will be chosen.

The QoS policy reported by functions like rmw_subscription_get_actual_qos or rmw_publisher_get_actual_qos may be best available, reliable, or best effort.

Services and clients are not supported and default to the reliability value in rmw_qos_profile_services_default.

The middleware is not expected to update the policy after creating a subscription or publisher, even if the chosen policy is incompatible with newly discovered endpoints. Therefore, this policy should be used with care since non-deterministic behavior can occur due to races with discovery.