RTI Connext C API
Version 5.0.0
|
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.
The following table lists the supported system properties.
Property Name | Description |
---|---|
dds.sys_info.hostname | Hostname |
dds.sys_info.process_id | Process ID |
System properties are affected by the resource limits DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_list_max_length and DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_string_max_length.