System Properties

Connext DDS uses the DomainParticipant’s PropertyQosPolicy to maintain a set of properties that provide system information, such as the hostname.

Unless the default the DDS_DomainParticipantQos structure (see Setting DomainParticipant QosPolicies) is overwritten, the system properties are automatically set in the DDS_DomainParticipantQos structure that is obtained by calling the DomainParticipantFactory’s get_default_participant_qos() operation or by using the constant DDS_PARTICIPANT_QOS_DEFAULT.

System properties are also automatically set in the DDS_DomainParticipantQos structure loaded from an XML QoS profile unless you disable property inheritance using the attribute inherit in the XML tag <property>.

By default, the system properties are propagated to other DomainParticipants in the system and can be accessed through the property field in the Table 1 .

You can disable propagation of individual properties by setting the property’s propagate flag to FALSE or by removing the property using the PropertyQosPolicyHelper operation, remove_property() (see Table 57 PropertyQoSPolicyHelper Operations).

The number of system properties that are initialized for a DomainParticipant is platform specific: only process_id and os_arch are supported on all platforms.

These properties will only be created if Connext DDS can obtain the information for them; see Table 22 .

System properties are affected by the DomainParticipantResourceLimitsQosPolicy’s participant_property_list_max_length and participant_property_string_max_length.

Table 22 System Properties

Property Name	Description
dds.sys_info.creation_timestamp	Time when the executable was created.1Only supported on Windows and Linux architectures.
dds.sys_info.executable_filepath	Name and full path of the executable.2Only supported on Windows and Linux architectures.
dds.sys_info.execution_timestamp	Time when the execution started.3Only supported on Windows and Linux architectures.
dds.sys_info.hostname	Hostname4Only supported on Windows and Linux architectures.
dds.sys_info.target	Architecture for which the library was compiled (for example, x64Darwin10gcc4.2.1).
dds.sys_info.process_id	Process ID
dds.sys_info.username	Username that is running the process.5Only supported on Windows and Linux architectures.

© 2015 RTI