RTI Connext Traditional C++ API Version 7.3.0
|
System Properties.
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 method DDSDomainParticipantFactory::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 method DDSPropertyQosPolicyHelper::remove_property.
The number of system properties set on the DDS_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 DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_list_max_length and DDS_DomainParticipantResourceLimitsQosPolicy::participant_property_string_max_length.