Skip to content

Commit c0539f9

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

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
@@ -356,19 +356,22 @@ configurable settings.
356356
+=================================+================================================+=====================+=============+
357357
| ``<discoveryProtocol>`` | Indicates which discovery protocol |br| | |SIMPLE| | |SIMPLE| |
358358
| | the DomainParticipant will use. |br| +---------------------+ |
359-
| | See :ref:`disc_mechanisms`. If set to |br| | |CLIENT| | |
360-
| | |CLIENT|, ``<discoveryServersList>`` |br| +---------------------+ |
359+
| | See :ref:`disc_mechanisms`. If not set to |br| | |CLIENT| | |
360+
| | |SIMPLE| or |NONE|, +---------------------+ |
361+
| | ``<discoveryServersList>`` |br| | | |
361362
| | element would be used. | |SERVER| | |
362363
| | +---------------------+ |
363364
| | | |BACKUP| | |
364365
| | +---------------------+ |
366+
| | | |SUPER_CLIENT| | |
367+
| | +---------------------+ |
365368
| | | |NONE| | |
366369
+---------------------------------+------------------------------------------------+---------------------+-------------+
367-
| ``<discoveryServersList>`` | Describes servers from which it receives |br| | :ref:`discserverlst`| |
368-
| | only the discovery information they |br| | | |
369-
| | require to establish communication with |br| | | |
370-
| | matching endpoints. |br| | | |
371-
| | See :ref:`discovery_server` | | |
370+
| ``<discoveryServersList>`` | Describes locators of servers from which |br| | ``<locator>`` | |
371+
| | it receives only the discovery information |br|| | |
372+
| | they require to establish communication |br| | | |
373+
| | with matching endpoints. |br| | | |
374+
| | It expects a :ref:`LocatorListType`. | | |
372375
+---------------------------------+------------------------------------------------+---------------------+-------------+
373376
| ``<ignoreParticipantFlags>`` | Restricts metatraffic using several |br| | :ref:`partfiltering`| |NO_FILTER| |
374377
| | filtering criteria. | | |
@@ -411,63 +414,6 @@ configurable settings.
411414
| | ``STATIC``. See :ref:`discovery_static`. | | |
412415
+---------------------------------+------------------------------------------------+---------------------+-------------+
413416

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

473419
ignoreParticipantFlags

0 commit comments

Comments
 (0)