RTI Connext C API  Version 6.0.0
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
System Properties

System Properties. More...

System Properties.

RTI Connext uses the DDS_PropertyQosPolicy of a DomainParticipant to maintain a set of properties that provide system information such as hostname.

Unless the default DDS_DomainParticipantQos value is overwritten, the system properties are automatically set in the DDS_DomainParticipantQos obtained by calling the function DDS_DomainParticipantFactory_get_default_participant_qos or using the constant DDS_PARTICIPANT_QOS_DEFAULT.

System properties are also automatically set in the DDS_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_ParticipantBuiltinTopicData::property.

You can disable the propagation of individual properties by setting the flag DDS_Property_t::propagate to DDS_BOOLEAN_FALSE or by removing the property using the function DDS_PropertyQosPolicyHelper_remove_property.

The number of system properties set on the DDS_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 DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_list_max_length and DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_string_max_length.


RTI Connext C API Version 6.0.0 Copyright © Sun Mar 3 2019 Real-Time Innovations, Inc