RTI Connext Modern C++ API Version 7.3.0
|
System Properties.
System Properties.
RTI Connext uses the rti::core::policy::Property of a DomainParticipant to maintain a set of properties that provide system information such as hostname.
Unless the default dds::domain::qos::DomainParticipantQos value is overwritten, the system properties are automatically set in the dds::domain::qos::DomainParticipantQos obtained by calling the method dds::domain::DomainParticipant::default_participant_qos() or using the constant PARTICIPANT_QOS_DEFAULT.
System properties are also automatically set in the dds::domain::qos::DomainParticipantQos 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 dds::topic::ParticipantBuiltinTopicData::property.
You can disable the propagation of individual properties by setting the flag Property_t::propagate to false or by removing the property using the method PropertyQosPolicyHelper::remove_property.
The number of system properties set on the dds::domain::qos::DomainParticipantQos is platform specific.
The following table lists the supported system properties. For more information, see System Properties, in the Core Libraries User's Manual.
Property Name | Description |
---|---|
dds.sys_info.hostname | Name of the host where the process is running |
dds.sys_info.process_id | Process ID |
dds.sys_info.username | Name of the user running the process |
dds.sys_info.execution_timestamp | Time when the execution started |
dds.sys_info.creation_timestamp | Time when the executable was created |
dds.sys_info.executable_filepath | Name and full path of the executable |
dds.sys_info.target | Architecture for which the library was compiled |
System properties are affected by the resource limits rti::core::policy::DomainParticipantResourceLimits::participant_property_list_max_length and rti::core::policy::DomainParticipantResourceLimits::participant_property_string_max_length.