From d5b677f60ec4eaf25d853e8baa449be4c0115129 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BCl?= Date: Fri, 23 Jan 2026 12:20:03 +0100 Subject: [PATCH] Update discovery server client pro feature MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Raül --- docs/fastdds/discovery/discovery_server.rst | 9 +++++++-- docs/fastdds/discovery/general_disc_settings.rst | 2 +- docs/fastdds/faq/discovery/discovery.rst | 8 ++++++-- 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/fastdds/discovery/discovery_server.rst b/docs/fastdds/discovery/discovery_server.rst index e669b7a9fa..5f25e80a6d 100644 --- a/docs/fastdds/discovery/discovery_server.rst +++ b/docs/fastdds/discovery/discovery_server.rst @@ -65,15 +65,19 @@ In this architecture there are several key concepts to understand: * It is important to note that the discovery times will be negatively affected when using this type of *server*, since periodically writing to a file is an expensive operation. -- A |CLIENT| is a participant that connects to one or more *servers* from which it receives only the discovery +- A |CLIENT| |Pro| is a participant that connects to one or more *servers* from which it receives only the discovery information they require to establish communication with matching endpoints. * *Clients* require prior knowledge of the *servers* to which they want to link. Basically, it consists of a list of locators where the *servers* are listening, namely, an IP address and a port. These locators also define the transport protocol (UDP or TCP) the client will use to contact the *server*. + * **Efficient Discovery Filterning** |Pro| : The optimized topic matching algorithm that enables *clients* to + receive only relevant discovery information is available exclusively in *Fast DDS Pro*. In the open-source + Fast DDS distribution, *clients* operate with the same discovery behavior as *super clients*, receiving all + discovery information from the server. - A |SUPER_CLIENT| is a *client* that receives the discovery information known by the *server*, in opposition to - *clients*, which only receive the information they need. + Pro *clients*, which only receive the information they need. .. note:: @@ -81,6 +85,7 @@ In this architecture there are several key concepts to understand: which it is connected. It will not connect to other servers, and it will not redistribute the information it receives. Any DomainParticipant discovered by the *Server* with no endpoints will not be known by the |SUPER_CLIENT|. + In the open-source Fast DDS distribution, all *clients* function as *super clients* by default. - *Servers* do not require any prior knowledge of their *clients*, but they must listen in the address specified by the locator provided to the *clients*. diff --git a/docs/fastdds/discovery/general_disc_settings.rst b/docs/fastdds/discovery/general_disc_settings.rst index c8b469d3b4..61d487e86e 100644 --- a/docs/fastdds/discovery/general_disc_settings.rst +++ b/docs/fastdds/discovery/general_disc_settings.rst @@ -51,7 +51,7 @@ The possible values are: | Discovery Server | |SERVER| | The DomainParticipant acts as a hub for discovery traffic, receiving | | | | and distributing discovery information. | | +---------------------+--------------------------------------------------------------------------+ -| | |CLIENT| | The DomainParticipant acts as a client for discovery traffic. | +| | |CLIENT| |Pro| | The DomainParticipant acts as a client for discovery traffic. | | | | It sends its discovery information to the server, and it receives | | | | only the information that is relevant to it. | | +---------------------+--------------------------------------------------------------------------+ diff --git a/docs/fastdds/faq/discovery/discovery.rst b/docs/fastdds/faq/discovery/discovery.rst index a7572b5cbe..7b887eeb28 100644 --- a/docs/fastdds/faq/discovery/discovery.rst +++ b/docs/fastdds/faq/discovery/discovery.rst @@ -74,14 +74,18 @@ Discovery Frequently Asked Questions .. collapse:: What is a client in this context? - |br| A ``CLIENT`` is a participant that connects to one or more servers from which it receives only the discovery information they require to establish communication with matching endpoints. + |br| A ``CLIENT`` is a participant that connects to one or more servers from which it receives discovery information to establish communication with matching endpoints. + With Fast DDS Pro, clients benefit from an optimized matching algorithm that filters discovery data, delivering only the information necessary for communication with relevant endpoints. + In the open-source Fast DDS distribution, clients operate with the same discovery behavior as super clients, receiving all discovery information from the server. For further information, refer to :ref:`discovery_server`. ---------- .. collapse:: What is the difference between a CLIENT and a SUPER_CLIENT? - |br| A ``SUPER_CLIENT`` is a client that receives the discovery information known by the server, in opposition to clients, which only receive the information they need. + |br| A ``SUPER_CLIENT`` is a client that receives all discovery information known by the server. + In Fast DDS Pro, standard clients receive only filtered, relevant discovery information through an optimized matching algorithm, improving efficiency and reducing network overhead. + In the open-source Fast DDS distribution, all clients operate as super clients by default. For further information, refer to :ref:`discovery_server`. ----------