4.2.1. Participant profiles configuration access

This section explains how to access the different configurable parameters in a DomainParticipant profile. The scope of this section does not include explaining the usage of these specific parameters. Please, refer to Fast DDS documentation for that information.

The DomainParticipant profile is accessed through the participant element. The profile name is mandatory and must be passed within brackets. Whitespaces are allowed in the profile name if the profile name is quoted. Consequently, participant is a complex parameter map according to the Configuration parameter classification with the profile name as key.

Important

The only case when the profile name is not required is when printing or clearing the default profile attribute.

fastddsqosprof <file> <verb> participant[profile_name].<subelement>
fastddsqosprof <file> <verb> participant["profile name"].<subelement>

The currently supported DomainParticipant configurable <subelements> are explained in the table below.

<subelement>	CLI access	Configuration parameter classification	Valid set values
Builtin configuration	participant[profile_name].builtin	Complex parameter. Please, refer to Builtin configuration section for more information.	N/A
Default external unicast locators configuration	participant[profile_name].external_locators.default_unicast[(index)]	Complex parameter list. Please, refer to External locators configuration section for more information.	N/A
Default profile attribute	participant[(profile_name)].default_profile	Simple parameter	true false (profile_name is only required with verb set).
Name element	participant[profile_name].name	Simple parameter	string
Use builtin transports flag	participant[profile_name].use_builtin_transports	Simple parameter	true false
User transports list	participant[profile_name].user_transports[(index)]	Simple parameter list	string

Warning

Any other configurable <subelement> is not yet supported.

4.2.1.1. Builtin configuration

The DomainParticipant builtin configuration is accessed through the builtin element which is a complex parameter according to the Configuration parameter classification. The scope of this section does not include explaining the usage of these specific parameters. Please, refer to Fast DDS documentation for that information.

The currently supported builtin configurable <subelements> are explained in the table below.

<subelement>	CLI access	Configuration parameter classification	Valid set value
Discovery configuration	participant[profile_name].builtin.discovery_config	Complex parameter. Please, refer to Discovery configuration section for more information.	N/A
Initial peers configuration	participant[profile_name].builtin.locators.initial_peers[(index)]	Complex parameter list. Please, refer to Locators configuration section for more information.	N/A
Metatraffic external unicast locators configuration	participant[profile_name].builtin.external_locators.metatraffic_unicast[(index)]	Complex parameter list. Please, refer to External locators configuration section for more information.	N/A

Warning

Any other configurable subelement is not yet supported.

4.2.1.1.1. Discovery configuration

The DomainParticipant builtin discovery configuration is accessed through the discovery_config element which is a complex parameter according to the Configuration parameter classification. The scope of this section does not include explaining the usage of these specific parameters. Please, refer to Fast DDS documentation for that information.

The currently supported discovery configurable <subelements> are explained in the table below.

<subelement>	CLI access	Configuration parameter classification	Valid set value
Lease announcements	participant[profile_name].builtin.discovery_config.duration.announcements	Complex parameter. Please, refer to Duration type configuration section for more information.	N/A
Lease duration	participant[profile_name].builtin.discovery_config.duration.lease	Complex parameter. Please, refer to Duration type configuration section for more information.	N/A

Warning

Any other configurable subelement is not yet supported.