Skip to content

Commit 1d8d501

Browse files
cferreiragonzcferreiragonz
committed
Refs #20629: Update XML tags
Signed-off-by: cferreiragonz <carlosferreira@eprosima.com>
1 parent 079c50a commit 1d8d501

2 files changed

Lines changed: 34 additions & 100 deletions

File tree

‎code/XMLTesterExample.xml‎

Lines changed: 24 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -228,42 +228,30 @@
228228
<discovery_config>
229229
<discoveryProtocol>NONE</discoveryProtocol>
230230
<discoveryServersList>
231-
<RemoteServer prefix="72.61.73.70.66.61.72.6d.74.65.73.74">
232-
<metatrafficUnicastLocatorList>
233-
<locator>
234-
<udpv4>
235-
<address>192.168.10.57</address>
236-
<port>56542</port>
237-
</udpv4>
238-
</locator>
239-
</metatrafficUnicastLocatorList>
240-
<metatrafficMulticastLocatorList>
241-
<locator>
242-
<udpv4>
243-
<address>192.168.10.58</address>
244-
<port>24565</port>
245-
</udpv4>
246-
</locator>
247-
</metatrafficMulticastLocatorList>
248-
</RemoteServer>
249-
<RemoteServer prefix="72.61.73.70.66.61.72.6d.74.65.73.75">
250-
<metatrafficUnicastLocatorList>
251-
<locator>
252-
<udpv4>
253-
<address>192.168.10.59</address>
254-
<port>56543</port>
255-
</udpv4>
256-
</locator>
257-
</metatrafficUnicastLocatorList>
258-
<metatrafficMulticastLocatorList>
259-
<locator>
260-
<udpv4>
261-
<address>192.168.10.60</address>
262-
<port>34565</port>
263-
</udpv4>
264-
</locator>
265-
</metatrafficMulticastLocatorList>
266-
</RemoteServer>
231+
<locator>
232+
<udpv4>
233+
<address>192.168.10.57</address>
234+
<port>56542</port>
235+
</udpv4>
236+
</locator>
237+
<locator>
238+
<udpv4>
239+
<address>192.168.10.58</address>
240+
<port>24565</port>
241+
</udpv4>
242+
</locator>
243+
<locator>
244+
<udpv4>
245+
<address>192.168.10.59</address>
246+
<port>56543</port>
247+
</udpv4>
248+
</locator>
249+
<locator>
250+
<udpv4>
251+
<address>192.168.10.60</address>
252+
<port>34565</port>
253+
</udpv4>
254+
</locator>
267255
</discoveryServersList>
268256
<ignoreParticipantFlags>FILTER_DIFFERENT_PROCESS|FILTER_SAME_PROCESS</ignoreParticipantFlags>
269257
<EDP>SIMPLE</EDP>

‎docs/fastdds/xml_configuration/domainparticipant.rst‎

Lines changed: 10 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -352,19 +352,22 @@ configurable settings.
352352
+=================================+================================================+=====================+=============+
353353
| ``<discoveryProtocol>`` | Indicates which discovery protocol |br| | |SIMPLE| | |SIMPLE| |
354354
| | the DomainParticipant will use. |br| +---------------------+ |
355-
| | See :ref:`disc_mechanisms`. If set to |br| | |CLIENT| | |
356-
| | |CLIENT|, ``<discoveryServersList>`` |br| +---------------------+ |
355+
| | See :ref:`disc_mechanisms`. If not set to |br| | |CLIENT| | |
356+
| | |SIMPLE| or |NONE|, +---------------------+ |
357+
| | ``<discoveryServersList>`` |br| | | |
357358
| | element would be used. | |SERVER| | |
358359
| | +---------------------+ |
359360
| | | |BACKUP| | |
360361
| | +---------------------+ |
362+
| | | |SUPER_CLIENT| | |
363+
| | +---------------------+ |
361364
| | | |NONE| | |
362365
+---------------------------------+------------------------------------------------+---------------------+-------------+
363-
| ``<discoveryServersList>`` | Describes servers from which it receives |br| | :ref:`discserverlst`| |
364-
| | only the discovery information they |br| | | |
365-
| | require to establish communication with |br| | | |
366-
| | matching endpoints. |br| | | |
367-
| | See :ref:`discovery_server` | | |
366+
| ``<discoveryServersList>`` | Describes locators of servers from which |br| | ``<locator>`` | |
367+
| | it receives only the discovery information |br|| | |
368+
| | they require to establish communication |br| | | |
369+
| | with matching endpoints. |br| | | |
370+
| | It expects a :ref:`LocatorListType`. | | |
368371
+---------------------------------+------------------------------------------------+---------------------+-------------+
369372
| ``<ignoreParticipantFlags>`` | Restricts metatraffic using several |br| | :ref:`partfiltering`| |NO_FILTER| |
370373
| | filtering criteria. | | |
@@ -407,63 +410,6 @@ configurable settings.
407410
| | ``STATIC``. See :ref:`discovery_static`. | | |
408411
+---------------------------------+------------------------------------------------+---------------------+-------------+
409412

410-
411-
.. _discserverlst:
412-
413-
discoveryServersList
414-
####################
415-
416-
Contains a list of ``<RemoteServer>`` (*server*) elements, which are defined by the |GuidPrefix_t-api| and their own
417-
locator list which must be populated with |RemoteServerAttributes-api|.
418-
The DomainParticipant set as *client* would discover the *servers* described in this section.
419-
420-
421-
**Server attributes**
422-
423-
The ``<RemoteServer>`` element has a mandatory attribute defined: ``prefix``.
424-
425-
.. list-table::
426-
:header-rows: 1
427-
:align: left
428-
429-
* - Name
430-
- Description
431-
- Use
432-
* - ``prefix``
433-
- RTPS standard participant unique identifier, a 12-byte chain. |br|
434-
This identifier allows clients to assess whether they are |br|
435-
receiving messages from the right server.
436-
- Mandatory
437-
438-
**RemoteServer configuration**
439-
440-
Each *client* (or a *server* connecting to another *server*) must keep a list of locators associated to the *servers*
441-
to which it wants to link.
442-
Those locator would be defined as ``metatrafficUnicastLocatorList`` or ``metatrafficMulticastLocatorList``.
443-
444-
.. list-table::
445-
:header-rows: 1
446-
:align: left
447-
448-
* - Name
449-
- Description
450-
- Values
451-
* - ``<metatrafficUnicastLocatorList>``
452-
- Metatraffic Unicast Locator List.
453-
- A set of ``<locator>`` members. |br| See :ref:`LocatorListType`
454-
* - ``<metatrafficMulticastLocatorList>``
455-
- Metatraffic Multicast Locator List.
456-
- A set of ``<locator>`` members. |br| See :ref:`LocatorListType`
457-
458-
**Example**
459-
460-
.. literalinclude:: /../code/XMLTester.xml
461-
:language: xml
462-
:start-after: <!-->CONF_DS_MAIN_SCENARIO_CLIENT<-->
463-
:end-before: <!--><-->
464-
:lines: 2-3,5-
465-
:append: </profiles>
466-
467413
.. _partfiltering:
468414

469415
ignoreParticipantFlags

0 commit comments

Comments
 (0)