Skip to content

Commit 782514c

Browse files
authored
Allow all durability configurations (#907)
* Refs #21538: Specify new PERSISTENT behavior and TRANSIENT with no persistence guid Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com> * Refs #21538: Apply Miguels review Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com> * Refs #21538: Apply last suggestion Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com> --------- Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com>
1 parent 41af5aa commit 782514c

File tree

2 files changed

+6
-4
lines changed

2 files changed

+6
-4
lines changed

docs/fastdds/dds_layer/core/policy/standardQosPolicies.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -211,8 +211,8 @@ There are four possible values (see |DurabilityQosPolicyKind-api|):
211211
* |TRANSIENT_LOCAL_DURABILITY_QOS-api|: When a new DataReader joins, its History is filled with past samples.
212212
* |TRANSIENT_DURABILITY_QOS-api|: When a new DataReader joins, its History is filled with past samples, which are stored
213213
on persistent storage (see :ref:`persistence_service`).
214-
* |PERSISTENT_DURABILITY_QOS-api|: (`Not Implemented`): All the samples are stored on a permanent storage, so that they
215-
can outlive a system session.
214+
* |PERSISTENT_DURABILITY_QOS-api|: When a new DataReader joins, its History is filled with past samples,
215+
which are stored on persistent storage (see :ref:`persistence_service`).
216216

217217
.. _durability_compatibilityrule:
218218

docs/fastdds/persistence/persistence.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ The configuration of the persistence service is accomplished by setting of the a
4040
or DataReader) |PropertyPolicyQos|.
4141

4242
* For the :ref:`persistence_service` to have any effect, the |DurabilityQosPolicyKind-api| needs to be set to
43-
|TRANSIENT_DURABILITY_QOS-api|.
43+
|TRANSIENT_DURABILITY_QOS-api| or |PERSISTENT_DURABILITY_QOS-api|.
4444

4545
* A persistence identifier (|Guid_t-api|) must be set for the entity using the property ``dds.persistence.guid``.
4646
This identifier is used to load the appropriate data from the database, and also to synchronize DataWriter and
@@ -56,10 +56,12 @@ or DataReader) |PropertyPolicyQos|.
5656
For selecting an appropriate GUID for the DataReader and DataWriter, please refer to
5757
`RTPS standard <https://www.omg.org/spec/DDSI-RTPS/2.2/PDF>`_ (section *9.3.1 The Globally Unique Identifier (GUID)*).
5858

59+
If no ``dds.persistence.guid`` is specified,
60+
the durability behavior will fallback to |TRANSIENT_LOCAL_DURABILITY_QOS-api|.
61+
5962
* A persistence plugin must be configured for managing the database using property ``dds.persistence.plugin`` (see
6063
:ref:`persistence_sqlite3_builtin_plugin`):
6164

62-
6365
.. _persistence_sqlite3_builtin_plugin:
6466

6567
PERSISTENCE:SQLITE3 built-in plugin

0 commit comments

Comments
 (0)