RTI Connext C API  Version 5.0.0
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.

Property Name Description
dds.sys_info.hostname Hostname
dds.sys_info.process_id Process ID

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 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc