RTI Connext Modern C++ API  Version 5.3.0
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
System Properties

System Properties. More...

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.

System Properties List

The following table lists the supported system properties. For more information, see Section 8.7, System Properties, in the Core Libraries and Utilities 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 Resource Consideration

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.

RTI Connext Modern C++ API Version 5.3.0 Copyright © Sun Jun 25 2017 Real-Time Innovations, Inc