Skip to content

Commit eaca51d

Browse files
committed
Refs #20629: Update env.var. without positional arguments
Signed-off-by: cferreiragonz <carlosferreira@eprosima.com>
1 parent 9ddb5d6 commit eaca51d

1 file changed

Lines changed: 4 additions & 17 deletions

File tree

docs/fastdds/env_vars/env_vars.rst

Lines changed: 4 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -221,45 +221,32 @@ Setting this variable configures the :ref:`DomainParticipant<dds_layer_domainPar
221221
* If no port is specified when using default UDP transport, the default port 11811 is used.
222222
* If no port is specified when using TCP transport, the default port 42100 is used.
223223
* To set more than one *server*'s address, they must be separated by semicolons.
224-
* The server's ID is determined by their position in the list.
225-
Two semicolons together means the corresponding ID is free.
226224
* When using IPv6 with DNS, the specified domain name space (*<dns>*) must be able to resolve to an IPv6
227225
address. Otherwise an error will be raised.
228226

229227
The following example shows how to set the address of two remote discovery servers with addresses
230-
'84.22.259.329:8888' and 'localhost:1234' and IDs 0 and 2 respectively.
228+
'84.22.259.329:8888' and 'localhost:1234'.
231229

232230
+----------------------------------------------------------------------------+
233231
| **Linux** |
234232
+----------------------------------------------------------------------------+
235233
| .. code-block:: bash |
236234
| |
237-
| export ROS_DISCOVERY_SERVER="84.22.259.329:8888;;localhost:1234" |
235+
| export ROS_DISCOVERY_SERVER="84.22.259.329:8888;localhost:1234" |
238236
+----------------------------------------------------------------------------+
239237
| **Windows** |
240238
+----------------------------------------------------------------------------+
241239
| .. code-block:: bash |
242240
| |
243-
| set ROS_DISCOVERY_SERVER=84.22.259.329:8888;;localhost:1234 |
241+
| set ROS_DISCOVERY_SERVER=84.22.259.329:8888;localhost:1234 |
244242
+----------------------------------------------------------------------------+
245243

246244
.. important::
247245
IP addresses specified in ``ROS_DISCOVERY_SERVER`` must be either valid IPv4/IPv6 addresses or domain names.
248246
If a name can be resolved into several addresses, it is possible to either use them all or restrict the selection to
249-
the first IPv4 using the `UDPv4:` or `TCPv4` prefixes or to the first IPv6 address using the `UDPv6:` or `TCPv6`
247+
the first IPv4 using the `UDPv4` or `TCPv4` prefixes or to the first IPv6 address using the `UDPv6` or `TCPv6`
250248
prefixes.
251249

252-
.. important::
253-
This environment variable is meant to be used in combination with :ref:`Fast DDS discovery CLI<cli_discovery>`.
254-
The *server*'s ID is used by *Fast DDS* to derived the |GuidPrefix_t-api| of the *server*.
255-
If the *server* is not instantiated using the CLI, the *server*'s GUID prefix should adhere to the same schema
256-
as the one generated from the CLI.
257-
Else, the *clients* configured with this environment variable will not be able to establish a connection with
258-
the *server*, thus not being able to connect to other *clients* either.
259-
The *server*'s GUID prefixes generated by the CLI comply with the following schema:
260-
``44.53.<server-id-in-hex>.5f.45.50.52.4f.53.49.4d.41``.
261-
This prefix schema has been chosen for its ASCII translation: ``DS<id_in_hex>_EPROSIMA``.
262-
263250
.. important::
264251
This environment variable can be changed at runtime adding new remote servers to a |SERVER|, |BACKUP| or |CLIENT|
265252
(that has been initialized with this environment variable previously) if loaded from an environment file using

0 commit comments

Comments
 (0)