10. XML profiles¶

eProsima Fast DDS allows for loading XML configuration files, each one containing one or more XML profiles. In addition to the API functions for loading user XML files, Fast DDS tries to locate and load several XML files upon initialization. Fast DDS offers the following options:

  • Load an XML file named DEFAULT_FASTRTPS_PROFILES.xml located in the current execution path.

  • Load an XML file which location is defined using the environment variable FASTRTPS_DEFAULT_PROFILES_FILE (see FASTRTPS_DEFAULT_PROFILES_FILE).

  • Load the configuration parameters directly from the classes’ definitions without looking for the DEFAULT_FASTRTPS_PROFILES.xml in the working directory (see SKIP_DEFAULT_XML).

  • Load directly the XML as a string data buffer.

An XML profile is defined by a unique name that is used to reference the XML profile during the creation of an Entity, the Transport configuration, or the DynamicTypes definition.

Both options can be complemented, i.e. it is possible to load multiple XML files but these must not have XML profiles with the same name. This section explains how to configure DDS entities using XML profiles. This includes the description of all the configuration values available for each of the XML profiles, as well as how to create complete XML files.