List of Properties

com.rti.serv

com.rti.serv.load_plugin

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Pattern value

.*

Description

The prefix name of the security plugin suite that will be loaded by Connext DDS.

Related to these features

DDS Secure

secure

com.rti.serv.secure.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Pattern value

.*

Description

Must be set to the security plugin suite creation function that is implemented by the library.

Related to these features

DDS Secure

com.rti.serv.secure.create_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Pattern value

.*

Description

Must be set to the security plugin suite creation function implemented by the library.

Related to these features

DDS Secure

com.rti.serv.secure.files_poll_interval

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

5

Min-Max value

[0,4294967]

Description

The time interval (in seconds) at which the Security Plugins check for changes in mutable configuration files. If any valid changes have occurred, the Security Plugins will apply the new configuration. 0 indicates no polling at all. By default, polling is enabled, consuming resources even when there are no files to track. See the “Design Considerations” chapter in RTI Security Plugins User’s Manual for details.

Related to these features

DDS Secure

com.rti.serv.secure.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Pattern value

.*

Description

Must be set to the dynamic library that implements the security plugin suite.

Related to these features

DDS Secure

com.rti.serv.secure.license_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*

Description

The value for this property can be set to the location (full path and filename) of a license file.

Related to these features

DDS Secure

com.rti.serv.secure.license_string

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*

Description

The value for this property can be set to the content of a license file.

Related to these features

DDS Secure

com.rti.serv.secure.openssl_engine

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*

Description

A semicolon-separated list of dynamic libraries that each implement an OpenSSL engine. Each engine may implement a different set of security functions. For example, one engine may implement certificate management, while another engine may implement cryptographic operations. If the authentication.keyform property value is engine, then the private key must be successfully loaded by exactly one of the engines in this list.

Related to these features

DDS Secure

com.rti.serv.secure.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

DDS Secure

access_control

com.rti.serv.secure.access_control.alternative_permissions_authority_files

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*(,.*)*

Description

A comma-separated list of alternative Permissions CA certificates.

Related to these features

DDS Secure

com.rti.serv.secure.access_control.use_530_logging_protection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

How to set the value of <metadata_protection_kind> for the Builtin Logging Topic.

Related to these features

DDS Secure

com.rti.serv.secure.access_control.use_530_partitions

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

How to determine a match between a DataWriter’s or DataReader’s partitions and an ‘allowed partitions’ condition in a Permissions Document.

Related to these features

DDS Secure

com.rti.serv.secure.access_control.use_530_permissions_rules_precedence

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

How to deal with conflicting allow/deny rules in a Permissions Document when checking if a topic or endpoint may exist.

Related to these features

DDS Secure

com.rti.serv.secure.access_control.use_610_permissions_rules_precedence

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

auto

Possible values

0
1
TRUE
FALSE
YES
NO
AUTO
auto

Description

How to deal with conflicting allow/deny rules in a Permissions Document when checking if a DomainParticipant may exist.

Related to these features

DDS Secure

authentication

com.rti.serv.secure.authentication.alternative_ca_files

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*(,.*)*

Description

A comma-separated list of alternative Identity CA certificates.

Related to these features

DDS Secure

com.rti.serv.secure.authentication.crl

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

mutable

Default Value

NULL

Pattern value

.*

Description

This Certificate Revocation List keeps track of untrusted X.509 certificates.

Related to these features

DDS Secure

com.rti.serv.secure.authentication.enable_custom_algorithms

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Configures whether to enable custom cryptographic algorithms for the Authentication plugin. When enabled (not by default) the Security Plugins will enable additional digital signature and key establishment algorithms that are not part of the DDS Security specification (EDDSA+ED25519+SHA512, EDDSA+ED448+SHAKE256, ECDHE-CEUM+X25519, ECDHE-CEUM+X448). Currently only supported in combination with OpenSSL: this property will have no effect when used in combination with wolfSSL.

Related to these features

DDS Secure

com.rti.serv.secure.authentication.enable_custom_allocators

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Configures whether to set custom crypto library (e.g., OpenSSL) allocators. When enabled (not the default) the Security Plugins will configure custom allocator functions (alloc, realloc, free) to the loaded crypto library with the goal of reducing memory fragmentation at the cost of a minimum performance impact. This is currently only supported in combination with OpenSSL. This property is only effective the first time a DomainParticipant loads the Security Plugins within the same process: subsequent DomainParticipant creations will ignore this property and leave the existing configuration unchanged. Moreover, this property is only effective if no allocation has been done with the crypto library builtin allocators before the Security Plugins have been loaded, otherwise a warning will be logged and no change will be made. Important: since the allocator functions live within the Security Plugins library, your application must not make any calls to the crypto library once the Security Plugins have been unloaded from memory.

Related to these features

DDS Secure

com.rti.serv.secure.authentication.enable_discovery_subject_name_propagation

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

If this property is true, the Subject Name of the local DomainParticipant’s Identity Certificate will be propagated during discovery

Related to these features

DDS Secure

com.rti.serv.secure.authentication.key_establishment_algorithm

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

AUTO

Possible values

AUTO
DHE+MODP-2048-256
ECDHE-CEUM+P256
ECDHE-CEUM+P384
ECDHE-CEUM+X25519
ECDHE-CEUM+X448

Description

The algorithm used to establish a shared secret during authentication. This property is deprecated. Instead, use dds.sec.auth.key_establishment_algorithm.

Related to these features

DDS Secure

The property has been deprecated in version

7.4.0

com.rti.serv.secure.authentication.keyform

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

pem

Possible values

engine
pem

Description

The format of the private key specified by dds.sec.auth.private_key. If the value is engine, then the openssl_engine property must be set, and the private key must be successfully loaded by exactly one of the engines in that list.

Related to these features

DDS Secure

com.rti.serv.secure.authentication.propagate_simplified_identity_certificate

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Indicates whether the identity certificate should be simplified

Related to these features

DDS Secure

com.rti.serv.secure.authentication.rsa_pss_pad

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

TRUE

Possible values

0
1
TRUE
FALSE
YES
NO
AUTO
auto

Description

Configures whether to use RSA PSS padding or standard RSA padding during authentication

Related to these features

DDS Secure

com.rti.serv.secure.authentication.shared_secret_algorithm

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

ecdh

Possible values

dh
ecdh

Description

The algorithm used to establish a shared secret during authentication. This property is deprecated. Instead, use dds.sec.auth.key_establishment_algorithm.

Related to these features

DDS Secure

The property has been deprecated in version

7.0.0

cryptography

com.rti.serv.secure.cryptography.enable_additional_authenticated_data

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enable Additional Authenticated Data for encode operations that support it. Currently only applicable to RTPS protection, where it is used to protect the RTPS Header and RTPS Header Extension Submessage if present. Must be set to true if using RTPS protection in combination with RTPS 2.5 Header Extension.

Related to these features

DDS Secure

com.rti.serv.secure.cryptography.encryption_algorithm

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

AES256+GCM

Possible values

AES128+GCM
AES192+GCM
AES256+GCM
aes-128-gcm
aes-192-gcm
aes-256-gcm

Description

The algorithm used for encrypting and decrypting data and metadata. This property is deprecated. Use dds.sec.crypto.symmetric_cipher_algorithm instead.

Related to these features

DDS Secure

The property has been deprecated in version

7.3.0

com.rti.serv.secure.cryptography.max_blocks_per_session

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned long long

Mutability type

immutable

Default Value

0xffffffffffffffff

Min-Max value

[1,ULLONG_MAX]

Description

The number of message blocks that can be encrypted with the same key material.

Related to these features

DDS Secure

com.rti.serv.secure.cryptography.max_receiver_specific_macs

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

0

Min-Max value

[0,3275]

Description

The maximum number of receiver-specific Message Authentication Codes (MACs) that are appended to an encoded result.

Related to these features

DDS Secure

com.rti.serv.secure.cryptography.share_key_for_metadata_and_data_protection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Mutability type

immutable

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Indicator of whether the metadata and data encoding operations share the same key material or use different keys.

Related to these features

DDS Secure

logging

com.rti.serv.secure.logging.log_level

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

3

Min-Max value

[0,7]

Description

The logging verbosity level.

Related to these features

DDS Secure
Logging

The property has been deprecated by

com.rti.serv.secure.logging.verbosity

com.rti.serv.secure.logging.mode_mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

mask

Mutability type

immutable

Default Value

BUILTIN

Possible values

BUILTIN
SECURITY_TOPIC

Description

The mask to determine the logging mode(s).

Related to these features

DDS Secure
Logging

com.rti.serv.secure.logging.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

ERROR

Possible values

SILENT
EMERGENCY
ALERT
CRITICAL
ERROR
WARNING
NOTICE
INFORMATIONAL
DEBUG

Description

The logging verbosity level

Related to these features

DDS Secure
Logging

security_topic

com.rti.serv.secure.logging.security_topic.profile

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*

Description

QoS Library and QoS profile used to create logging-related entities (Publisher, Topic and DataWriter).

Related to these features

DDS Secure
Logging

security_topic.queue

com.rti.serv.secure.logging.security_topic.queue.message_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

64

Min-Max value

[0,UINT_MAX]

Description

Maximum number of log messages in the logging queue.

Related to these features

DDS Secure
Logging

com.rti.serv.secure.logging.security_topic.queue.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

792

Min-Max value

[27,UINT_MAX]

Description

Maximum serialized size of a log message in the logging queue.

Related to these features

DDS Secure
Logging

com.rti.serv.secure.logging.security_topic.queue.size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

50688

Min-Max value

[0,UINT_MAX]

Description

Size of the logging thread queue, in bytes.

Related to these features

DDS Secure
Logging

security_topic.thread

com.rti.serv.secure.logging.security_topic.thread.message_threshold

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

256

Min-Max value

[0,UINT_MAX]

Description

Number of bytes to preallocate for the logging message string in the logging thread, beyond which dynamic allocation will occur.

Related to these features

DDS Secure
Logging

com.rti.serv.secure.logging.security_topic.thread.plugin_method_threshold

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

80

Min-Max value

[0,UINT_MAX]

Description

Number of bytes to preallocate for the plugin method string in the logging thread, beyond which dynamic allocation will occur.

Related to these features

DDS Secure
Logging

dds.builtin_type

dds.builtin_type.auto_register

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Register automatically the built-in types when a DomainParticipant is created.

Related to these features

Builtin Type

keyed_octets

dds.builtin_type.keyed_octets.alloc_key_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the key published by the DataWriter or received by the DataReader (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.keyed_octets.alloc_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

2048

Min-Max value

[0,INT_MAX]

Description

Maximum size of the octet sequences published by the DataWriter or DataReader.

Related to these features

Builtin Type

dds.builtin_type.keyed_octets.max_key_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the key published by the DataWriter and received by the DataReaders belonging to the DomainParticipant (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.keyed_octets.max_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

2048

Min-Max value

[0,INT_MAX]

Description

Maximum size of the octet sequences published by the DataWriters and DataReaders belonging to a DomainParticipant.

Related to these features

Builtin Type

keyed_string

dds.builtin_type.keyed_string.alloc_key_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the keys used by the DataWriter or DataReader (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.keyed_string.alloc_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the strings published by the DataWriter or received by the DataReader (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.keyed_string.max_key_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the keys used by the DataWriters and DataReaders belonging to a DomainParticipant (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.keyed_string.max_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the strings published by the DataWriters and received by the DataReaders belonging to a DomainParticipant using the built-in type (includes the NULL-terminated character).

Related to these features

Builtin Type

octets

dds.builtin_type.octets.alloc_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

2048

Min-Max value

[0,INT_MAX]

Description

Maximum size of the octet sequences published by the DataWriter or DataReader.

Related to these features

Builtin Type

dds.builtin_type.octets.max_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

2048

Min-Max value

[0,INT_MAX]

Description

Maximum size of the octet sequences published by the DataWriters and DataReaders belonging to a DomainParticipant.

Related to these features

Builtin Type

string

dds.builtin_type.string.alloc_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the strings published by the DataWriter or received by the DataReader (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.builtin_type.string.max_size

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Maximum size of the strings published by the DataWriters and received by the DataReaders belonging to a DomainParticipant (includes the NULL-terminated character).

Related to these features

Builtin Type

dds.clock

dds.clock.external_clock

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

realtime

Possible values

realtime
system
monotonic

Description

Comma-delimited list of clocks to use for the external clock, in the order of preference.

Related to these features

Clock

dds.clock.internal_clock

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

realtime

Possible values

realtime
system
monotonic

Description

Comma-delimited list of clocks to use for the internal clock, in the order of preference.

Related to these features

Clock

dds.data_reader

dds.data_reader.accept_writer_removed_batch_samples

May be set in

DataReader

Applies to

DataReader

Type

boolean

Default Value

FALSE

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Allow accepting invalid samples in a batch at the DataReader.

Related to these features

Queue Memory Management

dds.data_reader.shared_subscriber_name

May be set in

DataWriter
DataReader

Applies to

DataWriter
DataReader

Type

string

Default Value

NULL

Pattern value

.*

Description

The DataReader must attach to the SharedSubscriber that contains the SharedReaderQueue.

Related to these features

Other

history.memory_manager.fast_pool

dds.data_reader.history.memory_manager.fast_pool.pool_buffer_max_size

May be set in

DataReader

Applies to

DataReader

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Controls the memory allocation for serialization.

Related to these features

Queue Memory Management

history.memory_manager.java_stream

dds.data_reader.history.memory_manager.java_stream.min_size

May be set in

DataReader

Applies to

DataReader

Type

integer

Default Value

Max Serialized Sample Size

Min-Max value

[0,INT_MAX]

Description

Defines the minimum size of the buffer used for the serialized data.

Related to these features

Queue Memory Management

dds.data_reader.history.memory_manager.java_stream.trim_to_size

May be set in

DataReader

Applies to

DataReader

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

A Boolean value that controls the growth of the deserialization buffer.

Related to these features

Queue Memory Management

protocol

dds.data_reader.protocol.use_43_large_data_format

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Achieve backward compatibility sending ‘Large Data’ between RTI Data Distribution Service 4.4d and older Releases.

Related to these features

Reliability
Type System

reliability

dds.data_reader.reliability.delegate_reliability

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Delegates the reliability task to a separate service.

Related to these features

Reliability

state

dds.data_reader.state.checkpoint_frequency

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Controls how often the DataReader state is stored into the database.

Related to these features

Durability

dds.data_reader.state.filter_redundant_samples

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enables durable DataReader state.

Related to these features

Durability
Filtering

dds.data_reader.state.restore

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Indicates if the persisted DataReader state must be restored or not once the DataReader is restarted.

Related to these features

Durability

odbc

dds.data_reader.state.odbc.driver

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

string

Default Value

odbc32.dll (Windows) libodbc.so (Otherwise)

Pattern value

.*

Description

Indicates which ODBC driver to load.

Related to these features

Durability

dds.data_reader.state.odbc.dsn

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

string

Pattern value

^.{1,512}$

Description

The ODBC DSN (Data Source Name) associated with the database where the DataReader state must be persisted.

Related to these features

Durability

dds.data_reader.state.odbc.password

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

string

Pattern value

^.{0,30}$

Description

Configures the password used to connect to the database.

Related to these features

Durability

dds.data_reader.state.odbc.username

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

string

Pattern value

^.{0,30}$

Description

Configures the username used to connect to the database.

Related to these features

Durability

persistence_service

dds.data_reader.state.persistence_service.request_depth

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Indicates how many of the most recent historical samples the persisted DataReader wants to receive upon start-up.

Related to these features

Durability

type_support

dds.data_reader.type_support.cdr_string_encoding_kind

May be set in

DataReader
DomainParticipant

Applies to

DataReader

Type

enum

Default Value

UTF-8

Possible values

UTF-8
ISO-8859-1

Description

Configures the IDL wire string encoding.

Related to these features

Type System

dds.data_writer

dds.data_writer.enable_turbo_mode

May be set in

DataWriter

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enables Turbo Mode and adjusts the batch max_data_bytes based on how frequently the DataWriter writes data.

Related to these features

Batching
Reliability

auto_throttle

dds.data_writer.auto_throttle.enable

May be set in

DataWriter

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enables automatic throttling in the DataWriter.

Related to these features

Reliability

cryptography

dds.data_writer.cryptography.taint_data

May be set in

DataWriter

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Simulate tainted data. Connext DDS will modify one byte of encoded data after the final layer of GMAC or GCM is computed. This property can be used for testing validation of the GMAC hash. Tainting of encoded payloads requires running on a little-endian machine. Tainting is not supported when key_revision_max_history_depth > 0, when enable_additional_authenticated_data is TRUE, or when header extension is enabled.

Related to these features

DDS Secure

history

dds.data_writer.history.key_material_key

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Default Value

NULL

Pattern value

.*

Description

The basis of the key material used to encrypt the PRSTDataWriter’s key material.

Related to these features

Durability
DDS Secure

dds.data_writer.history.plugin_name

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Default Value

dds.data_writer.history.odbc_plugin.builtin

Pattern value

dds.data_writer.history.odbc_plugin.builtin

Description

Must be set to ‘dds.data_writer.history.odbc_plugin.builtin’ to enable durable writer history in the DataWriter.

Related to these features

Durability

dds.data_writer.history.purge_samples_after_acknowledgment

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

The DataWriter’s behavior can be changed to purge DDS samples after they have been acknowledged by all the active/matching DataReaders.

Related to these features

Durability

dds.data_writer.history.source_timestamp_based_autopurge_instances_delay

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

The purging of the unregistered instances can be done based on the unregistered sample source timestamp or the time when the unregistered sample was added to the DataWriter queue.

Related to these features

Durability
Instance

memory_manager.fast_pool

dds.data_writer.history.memory_manager.fast_pool.pool_buffer_max_size

May be set in

DataWriter

Applies to

DataWriter

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Controls the memory allocation for the serialized sample.

Related to these features

Queue Memory Management

memory_manager.java_stream

dds.data_writer.history.memory_manager.java_stream.min_size

May be set in

DataWriter

Applies to

DataWriter

Type

integer

Default Value

Max Serialized Sample Size

Min-Max value

[0,INT_MAX]

Description

Defines the minimum size of the buffer that will be used to serialize DDS samples.

Related to these features

Queue Memory Management

dds.data_writer.history.memory_manager.java_stream.trim_to_size

May be set in

DataWriter

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

A boolean value that controls the growth of the serialization buffer.

Related to these features

Queue Memory Management

odbc_plugin.builtin

dds.data_writer.history.odbc_plugin.builtin.driver

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Default Value

"libodbc.so" (for Linux systems) "odbc32.dll" (for Windows systems)

Pattern value

^.{0,30}$

Description

Tells Connext DDS which ODBC driver to load.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.dsn

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Pattern value

^.{1,512}$

Description

The ODBC DSN (Data Source Name) associated with the database where the writer history must be persisted.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.in_memory_state

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Determines how much state will be kept in memory by the ODBC writer history in order to avoid accessing the database.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.instance_cache_init_size

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

integer

Min-Max value

[0,INT_MAX]

Description

Configures the resource limits associated with the ODBC writer history caches.

Related to these features

Durability
Instance

dds.data_writer.history.odbc_plugin.builtin.instance_cache_max_size

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

integer

Default Value

0

Min-Max value

[-1,INT_MAX]

Description

Configures the resource limits associated with the ODBC writer history caches.

Related to these features

Durability
Instance

dds.data_writer.history.odbc_plugin.builtin.password

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Pattern value

^.{0,30}$

Description

Configures the password used to connect to the database.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.restore

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Indicates whether or not the persisted writer history must be restored once the DataWriter is restarted.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.sample_cache_init_size

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

integer

Default Value

32

Min-Max value

[1,INT_MAX]

Description

Configures the resource limits associated with the ODBC writer history caches.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.sample_cache_max_size

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

integer

Default Value

32

Min-Max value

[-1,INT_MAX]

Description

Configure the resource limits associated with the ODBC writer history caches.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.shared

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Creates a single connection per DSN that will be shared across DataWriters within the same Publisher.

Related to these features

Durability

dds.data_writer.history.odbc_plugin.builtin.username

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

string

Pattern value

^.{0,30}$

Description

Configures the username used to connect to the database.

Related to these features

Durability

protocol

dds.data_writer.protocol.disable_repair_piggyback_heartbeat

May be set in

DataWriter

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents piggyback HBs from being sent with repair samples

Related to these features

Reliability

The property has been promoted to

<datawriter_qos><protocol><rtps_reliable_writer><disable_repair_piggyback_heartbeat>

dds.data_writer.protocol.use_43_large_data_format

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Achieve backward compatibility sending ‘Large Data’ between RTI Data Distribution Service 4.4d and older Releases.

Related to these features

Reliability
Type System

reliability

dds.data_writer.reliability.delegate_reliability

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Delegates the reliability task to a separate service.

Related to these features

Reliability

type_support

dds.data_writer.type_support.cdr_string_encoding_kind

May be set in

DataWriter
DomainParticipant

Applies to

DataWriter

Type

enum

Default Value

UTF-8

Possible values

UTF-8
ISO-8859-1

Description

Configures the IDL wire string encoding.

Related to these features

Type System

dds.discovery.endpoint

dds.discovery.endpoint.load_plugins

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

String indicating the prefix name of the plugin that will be loaded by Connext DDS.

Related to these features

Discovery

lbediscovery

dds.discovery.endpoint.lbediscovery.config_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.+.xml

Description

The name of the discovery configuration file.

Related to these features

Discovery

dds.discovery.endpoint.lbediscovery.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the function that will be called by Connext DDS to create an instance of the LBED plugin.

Related to these features

Discovery

dds.discovery.endpoint.lbediscovery.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the dynamic library that contains the LBED plugin implementation.

Related to these features

Discovery

dds.discovery.endpoint.lbediscovery.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Discovery

dds.discovery.endpoint.lbediscovery.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[-1,INT_MAX]

Description

The verbosity for the plugin, for debugging purposes.

Related to these features

Discovery
Logging

dds.discovery.participant

dds.discovery.participant.load_plugins

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

String indicating the prefix name of the plugin that will be loaded by Connext DDS.

Related to these features

Discovery

lbpdiscovery

dds.discovery.participant.lbpdiscovery.config_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.+.xml

Description

The name of the discovery configuration file.

Related to these features

Discovery

dds.discovery.participant.lbpdiscovery.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the function that will be called by Connext DDS to create an instance of the LBPD plugin.

Related to these features

Discovery

dds.discovery.participant.lbpdiscovery.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the dynamic library that contains the LBPD plugin implementation.

Related to these features

Discovery

dds.discovery.participant.lbpdiscovery.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Discovery

dds.discovery.participant.lbpdiscovery.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[-1,INT_MAX]

Description

The verbosity for the plugin, for debugging purposes.

Related to these features

Discovery
Logging

dds.domain_participant

dds.domain_participant.asynchronous_publisher_thread_destruction_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[0,60]

Related to these features

Flow Controller

dds.domain_participant.domain_tag

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

^.{0,255}$

Description

A string defining the Domain Tag the DomainParticipant will propagate through Participant Discovery.

Related to these features

Discovery

dds.domain_participant.filtering_character_encoding

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

UTF-8

Possible values

UTF-8
ISO_8859

Description

Select the character encoding for filtering

Related to these features

Filtering

dds.domain_participant.filtering_unicode_normalization

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

NFC

Possible values

OFF
NFD
NFC
NFKD
NFKC
NFKC_Casefold

Description

Select Unicode normalization for filter evaluation

Related to these features

Filtering

dds.domain_participant.max_announced_locator_list_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

16

Min-Max value

[0,16]

Description

A sequence of multicast/unicast settings used to configure the addresses associated with a channel.

Related to these features

Discovery

dds.domain_participant.network_interface_event_notification_delay

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,60000]

Description

Delays the DomainParticipant announcements that include a new interface for the number of milliseconds in the value of the property.

Related to these features

Discovery

auto_throttle

dds.domain_participant.auto_throttle.enable

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Configures the DomainParticipant to gather internal measurements (during DomainParticipant creation) that are required for the Auto Throttle feature.

Related to these features

Reliability

dds.flow_controller.token_bucket.<flow_controller_name>

dds.flow_controller.token_bucket.<flow_controller_name>.scheduling_policy

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

enum

Default Value

DDS_EDF_FLOW_CONTROLLER_SCHED_POLICY

Possible values

DDS_RR_FLOW_CONTROLLER_SCHED_POLICY
DDS_EDF_FLOW_CONTROLLER_SCHED_POLICY
DDS_HPF_FLOW_CONTROLLER_SCHED_POLICY

Description

Specifies the scheduling policy to be used.

Related to these features

Flow Controller

token_bucket

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.bytes_per_token

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

integer

Default Value

-1

Min-Max value

[0,INT_MAX]

Description

Maximum number of bytes allowed to send for each token available.

Related to these features

Flow Controller

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.max_tokens

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

integer

Default Value

-1

Min-Max value

[0,INT_MAX]

Description

Maximum number of tokens than can accumulate in the token bucket.

Related to these features

Flow Controller

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.tokens_added_per_period

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Number of tokens added to the token bucket per specified period.

Related to these features

Flow Controller

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.tokens_leaked_per_period

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Number of tokens removed from the token bucket per specified period.

Related to these features

Flow Controller

period

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.period.nanosec

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

unsigned integer

Default Value

0

Min-Max value

[0,UINT_MAX]

Description

Period for adding tokens to and removing tokens from the bucket in nanoseconds.

Related to these features

Flow Controller

dds.flow_controller.token_bucket.<flow_controller_name>.token_bucket.period.sec

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

Period for adding tokens to and removing tokens from the bucket in seconds.

Related to these features

Flow Controller

dds.license

dds.license.license_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Pattern value

.*

Description

Sets the path to the license file

Related to these features

License

dds.license.license_string

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Sets the contents of the license.

Related to these features

License

dds.participant

dds.participant.enable_backtrace_upon_sigsegv

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

auto

Possible values

0
1
TRUE
true
FALSE
false
YES
yes
NO
no
AUTO
auto

Description

Enables backtrace printing when handling SIGSEGV signals.

Related to these features

Logging

dds.participant.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Other

dds.participant.use_45d_compatible_alignment_enforcement

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Accept RTPS messages with wrong alignment incorrectly.

Related to these features

Type System

builtin_data_writer.protocol

dds.participant.builtin_data_writer.protocol.disable_repair_piggyback_heartbeat

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents piggyback HBs from being sent with repair samples for builtin discovery topics

Related to these features

Reliability

The property has been promoted to

<domain_participant_qos><discovery_config><publication_writer><disable_repair_piggyback_heartbeat>

discovery_config

dds.participant.discovery_config.force_endpoint_announcement_on_ip_mobility_event

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces the sending of endpoint discovery announcements when there is an IP mobility event.

Related to these features

Discovery

dds.participant.discovery_config.log_discovery_mismatch

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enables logging a warning when an SPDP message is received by an SPDP2 participant or vice-versa.

Related to these features

Discovery

dds.participant.discovery_config.use_stateless_participant_discovery_reader

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

If TRUE, makes Simple Participant Discovery robust against Sequence Number Attacks by switching the local Simple Participant Discovery DataReader’s mode to pure stateless.

Related to these features

Discovery

inter_participant_data_reader.protocol

dds.participant.inter_participant_data_reader.protocol.disable_preemptive_nack

May be set in

DomainParticipant

Applies to

DomainParticipant
DataReader

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disable preemptive Heartbeats and NACKs.

Related to these features

Discovery
Reliability

inter_participant_data_writer.protocol

dds.participant.inter_participant_data_writer.protocol.disable_preemptive_heartbeat

May be set in

DomainParticipant

Applies to

DomainParticipant
DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disable preemptive Heartbeats and NACKs.

Related to these features

Discovery
Reliability

logging.time_based_logging.authentication

dds.participant.logging.time_based_logging.authentication.timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

INT_MAX

Min-Max value

[0,INT_MAX]

Description

Print warning message when the authentication operation time exceeds this time threshold. The format for the threshold is #s#ms#us#ns.

Related to these features

DDS Secure
Logging

logging.time_based_logging.event

dds.participant.logging.time_based_logging.event.timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

INT_MAX

Min-Max value

[0,INT_MAX]

Description

Print warning message when the event start/execution time exceeds this time threshold. The format for the threshold is #s#ms#us#ns.

Related to these features

Logging

logging.time_based_logging.process_received_message

dds.participant.logging.time_based_logging.process_received_message.timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

INT_MAX

Min-Max value

[0,INT_MAX]

Description

Print warning message when processing a received message operation exceeds this time threshold. The format for the threshold is #s#ms#us#ns.

Related to these features

Transport
Logging

dds.participant.logging.time_based_logging.process_received_message.tracked_ports

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Print warning message when the processing of a received message on a specific port exceeds the time threshold set in dds.participant.logging.time_based_logging.process_received_message.timeout.

Related to these features

Logging
Transport

logging.time_based_logging.send

dds.participant.logging.time_based_logging.send.timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

INT_MAX

Min-Max value

[0,INT_MAX]

Description

Print warning message when send operation time exceeds this time threshold. The format for the threshold is #s#ms#us#ns.

Related to these features

Transport
Logging

protocol

dds.participant.protocol.rtps_overhead

May be set in

DomainParticipant

Applies to

DataWriter
DomainParticipant

Type

integer

Default Value

Automatically calculated.

Min-Max value

[0,INT_MAX]

Description

Used to adjust the overhead of the RTPS protocol without including security. This property is still supported, but deprecated in 6.1.2.

Related to these features

Reliability

The property has been deprecated in version

6.1.2

trust_plugins

dds.participant.trust_plugins.key_revision_max_history_depth

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

0

Min-Max value

[0,1000000]

Description

Controls the number of key revisions that are used to encode samples in the DataWriters’ queues. Must be 0 or between 7 and 1000000. If 0, then key revisions are disabled. A greater key_revision_max_history_depth will further delay the need to reencode writer queue historical samples as new key revisions are generated, but it will increase the memory footprint of the DomainParticipant. The memory used for this is preallocated, and it is roughly equal to 36 bytes (or 164 bytes if the DomainParticipant has at least one DataWriter using ODBC writer history) multiplied by the key_revision_max_history_depth. If there is at least one reliable DataWriter that is protecting its payload, then the DomainParticipant will send 7 key revisions instead of just 1 to each late joiner DomainParticipant. Each key revision adds about 128 bytes of network traffic, so that’s 128 * (7 - 1) = 768 more bytes per late joiner DomainParticipant.

Related to these features

DDS Secure

dds.participant.trust_plugins.max_removed_participants_per_key_revision

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

immutable

Default Value

50

Min-Max value

[0,50000]

Description

When enabling security, the Security Plugins keep a minimum state associated with each remote participant after the remote participant is removed. This state is used to ensure that removed remote participants whose identity credentials are invalidated after their removal are properly banished. This property controls the maximum number of remote participants for which this minimum state is maintained. Upon reaching this maximum number, the Security Plugins will automatically banish ignored participants, and the list of minimum states is cleared away. Before reaching this maximum number, if any removed participants have their identity credential invalidated (e.g., their certificate expires or gets revoked), then the Security Plugins will automatically banish ignored participants. A higher number for this property value will increase memory requirements of the local participant on systems with a high number of remote participants joining and leaving the system, and it will make automatic banishing less frequent.

Related to these features

DDS Secure

dds.participant.trust_plugins.subject_name_whitelist

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

mutable

Default Value

NULL

Pattern value

.*

Description

Configures a (semicolon-separated) whitelist of subject names for authenticated Domain Participants. If set (even if empty), authenticated Domain Participants will be allowed into the system only if their subject name matches one of the ones in the whitelist. Any authenticated Domain Participant not matching the whitelist will be ignored automatically. Since the whitelist is enforced only on authenticated Domain Participants, this property does not impact allowed non-authenticated participants: if allow_unauthenticated_participants is true, participants not using security and participants failing authentication early will still be allowed into the system. If the list is modified once the Domain Participant is enabled, any previously ignored Domain Participant will be unignored, which will create an opportunity to successfully authenticate if it is now part of the updated whitelist (if not, the Domain Participant will be ignored as usual). This property has no effect when not using the Security Plugins.

Related to these features

DDS Secure

authentication_request_delay

dds.participant.trust_plugins.authentication_request_delay.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

5

Min-Max value

[0,INT_MAX]

Description

Controls the delay in seconds before sending an authentication_request to the remote participant.

Related to these features

DDS Secure

authentication_request_timeout

dds.participant.trust_plugins.authentication_request_timeout.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

20

Min-Max value

[0,INT_MAX]

Description

It determines the timeout (in seconds) for authentication negotiations started from an authentication request message (authentication request is a DDS Security 1.1 mechanism to securely recover from an asymmetric liveliness loss). If set to a value greater than authentication_timeout, then it will be set to authentication_timeout.

Related to these features

DDS Secure

authentication_timeout

dds.participant.trust_plugins.authentication_timeout.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

60

Min-Max value

[0,INT_MAX]

Description

Controls the maximum time in seconds that an ongoing authentication can remain without completing.

Related to these features

DDS Secure

certificate_expiration_advance_notice_duration

dds.participant.trust_plugins.certificate_expiration_advance_notice_duration.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

mutableUntilEnable

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Controls how much time in advance a DomainParticipantListener callback should notify the user when the local DomainParticipant’s certificate is about to expire.

Related to these features

DDS Secure

certificate_expiration_advance_notice_reminder_period

dds.participant.trust_plugins.certificate_expiration_advance_notice_reminder_period.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Mutability type

mutableUntilEnable

Default Value

1

Min-Max value

[1,INT_MAX]

Description

Controls how often (in seconds) a DomainParticipantListener callback should remind the user of a soon-to-be expired certificate.

Related to these features

DDS Secure

max_key_redistribution_delay

dds.participant.trust_plugins.max_key_redistribution_delay.sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

immutable

Default Value

60

Min-Max value

[-1,INT_MAX]

Description

Controls the maximum time in seconds between generating and using a new key (revision). After this time, remote DomainParticipants that have not yet acknowledged the new key (revision) will be completely removed. Must be -1 or between 1 and INT_MAX. If -1, then the local DomainParticipant will wait indefinitely for acknowledgments of the new key (revision).

Related to these features

DDS Secure

wire_protocol

dds.participant.wire_protocol.computed_crc_kind

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

CRC_32

Possible values

CRC_32_LEGACY
CRC_32
CRC_64
CRC_128

Description

Determines which CRC algorithm to use if the participantQos.wire_protocol.compute_crc QoS is enabled. The number in the name indicates the length of the CRC in bits. All values enable RTPS Header Extension, except CRC_32_LEGACY (deprecated), which enables an rti-specific CRC algorithm deprecated in Connext 7.2.0. The other values represent the algorithms described in the RTPS Specification. CRC_64 is not currently supported.

Related to these features

Checksum
RTPS
Header Extension

dds.rpc

dds.rpc.compliance_mask

May be set in

DomainParticipant
DataWriter
DataReader

Applies to

DataWriter
DataReader

Type

integer

Default Value

NDDS_CONFIG_RPC_COMPLIANCE_MASK_DEFAULT (0x00000000) or value previously set by NDDS_Config_set_rpc_compliance_mask or NDDS_RCP_COMPLIANCE_MASK environment variable

Min-Max value

[0,INT_MAX]

Description

The compliance mask configures different aspects of the RPC configuration for a DataWriter and DataReader. This mask will affect Request Reply too

Related to these features

Type System

dds.sample_assignability

dds.sample_assignability.accept_unknown_enum_value

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

When set to 1, samples containing an unknown enumerator can be successfully deserialized to the default enumeration value.

Related to these features

Type System

The property has been deprecated in version

7.4.0

dds.sample_assignability.accept_unknown_union_discriminator

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

integer

Default Value

0

Possible values

0
1
2

Description

When set to 0, received samples containing a union discriminator value that selects a union member on the DataWriter but not on the DataReader are dropped. When set to 1, received samples containing a union discriminator value that selects a union member on the DataWriter but not on the DataReader are set to the default union value on the DataReader. When set to 2, received samples containing a union discriminator value that selects a union member on the DataWriter but not on the DataReader preserve the discriminator value and do not select any union member on the DataReader.

Related to these features

Type System

The property has been deprecated in version

7.4.0

dds.sec.access

dds.sec.access.governance

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

The signed document that specifies the level of security required per domain and per topic.

Related to these features

DDS Secure

dds.sec.access.permissions

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

The signed document that specifies the access control permissions per domain and per topic.

Related to these features

DDS Secure

dds.sec.access.permissions_ca

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

This Permissions Certificate Authority is used for signing access control governance and permissions XML files and verifying the signatures of those files.

Related to these features

DDS Secure

dds.sec.access.rtps_psk_protection_kind

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

ENCRYPT

Possible values

NONE
SIGN
ENCRYPT

Description

It specifies how to protect messages when using pre-shared key protection (don’t protect them, protect only their integrity, or protect both their integrity and confidentiality)

Related to these features

DDS Secure

dds.sec.auth

dds.sec.auth.identity_ca

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

This Identity Certificate Authority is used for signing authentication certificate files.

Related to these features

DDS Secure

dds.sec.auth.identity_certificate

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

mutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

Identity Certificate signed by the Identity CA. Other participants will request this certificate to verify the identity of the local participant. This is an X.509 certificate in PEM format.

Related to these features

DDS Secure

dds.sec.auth.key_establishment_algorithm

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Mutability type

immutable

Default Value

AUTO

Possible values

AUTO
DHE+MODP-2048-256
ECDHE-CEUM+P256
ECDHE-CEUM+P384
ECDHE-CEUM+X25519
ECDHE-CEUM+X448

Description

The algorithm used to establish a shared secret during authentication.

Related to these features

DDS Secure

dds.sec.auth.password

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

.*

Description

The password used to decrypt the private_key.

Related to these features

DDS Secure

dds.sec.auth.private_key

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

The private key associated with the first certificate.

Related to these features

DDS Secure

dds.sec.crypto

dds.sec.crypto.rtps_psk_secret_passphrase

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

mutable

Default Value

NULL

Pattern value

[file:|data:,].*

Description

PSK protection uses this pre-shared key secret (in combination with publicly available data) to derive the key used for encoding RTPS messages. One acceptable format is “data:,<passphrase_id>:<passphrase>”, to provide the passphrase explicitly in the property value, where <passphrase_id> is a unique number identifying the <passphrase>. Another acceptable format is “file:<FILENAME>”, which allows providing the secret in a supplemental file. The content of the file has to follow the “<passphrase_id>:<passphrase>” format. The “file:” prefix is optional. The <passphrase_id> must be a value in the [0, 4294967295] range, where the hexadecimal representation of the last byte can’t be 0xFF. The <passphrase> string shall contain up to 512 ASCII printable characters (character codes 32 to 126, both included), except that the first and last characters of the <passphrase> shall not be the space character (character code 32).

Related to these features

DDS Secure

dds.sec.crypto.rtps_psk_symmetric_cipher_algorithm

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Mutability type

immutable

Default Value

AUTO

Possible values

AUTO
AES128+GCM
AES256+GCM

Description

Algorithm used to protect messages when using pre-shared key protection

Related to these features

DDS Secure

dds.sec.crypto.symmetric_cipher_algorithm

May be set in

DomainParticipant
DataWriter
DataReader

Applies to

DomainParticipant
DataWriter
DataReader

Type

string

Mutability type

immutable

Default Value

AUTO

Possible values

AUTO
AES128+GCM
AES192+GCM
AES256+GCM

Description

The algorithm used for encrypting and decrypting data and metadata. It affects the user endpoints, the builtin topics (discovery, service request, and liveliness), and the DomainParticipant.

Related to these features

DDS Secure

dds.sys_info

dds.sys_info.creation_timestamp

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Min-Max value

[0,9999]

Description

Time when the executable was created.

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.executable_filepath

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Name and full path of the executable.

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.execution_timestamp

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Min-Max value

[0,9999]

Description

Time when the execution started.

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.hostname

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Hostname

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.process_id

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Min-Max value

[0,UINT_MAX]

Description

Process ID

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.target

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Architecture for which the library was compiled.

Related to these features

System Info
Default Discovery Propagation

dds.sys_info.username

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Username that is running the process.

Related to these features

System Info
Default Discovery Propagation

dds.transport

dds.transport.load_plugins

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Comma-separated strings indicating the prefix names of all plugins that will be loaded by Connext DDS.

Related to these features

Transport

dds.transport.minimum_compatibility_version

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

6.0.0

Pattern value

.*

Description

Minimum version that the transport should be compatible with.

Related to these features

Transport
Builtin Transport

dds.transport.use_510_compatible_locator_kinds

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Communicate between Connext DDS 5.2.0 and previous releases. This property is still supported, but deprecated in favour of dds.transport.minimum_compatibility_version.

Related to these features

Transport

The property has been deprecated in version

6.1.0

TCPv4.tcp1

dds.transport.TCPv4.tcp1.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Used to register the transport plugin returned by NDDS_Transport_TCPv4_create() (as specified by <TCP_prefix>.create_function) to the DomainParticipant.

Related to these features

Transport

dds.transport.TCPv4.tcp1.bind_interface_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

The TCP transport can be configured to bind all sockets to a specified interface.

Related to these features

Transport

dds.transport.TCPv4.tcp1.client_connection_negotiation_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[1,INT_MAX]

Description

Timeout (in seconds) for negotiating a client data connection.

Related to these features

Transport

dds.transport.TCPv4.tcp1.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

If used, must be “NDDS_Transport_TCPv4_create”.

Related to these features

Transport

dds.transport.TCPv4.tcp1.create_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Defines the function pointer to the TCP transport plugin creation function.

Related to these features

Transport

dds.transport.TCPv4.tcp1.disable_interface_tracking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disables detection of network interface changes.

Related to these features

Transport

dds.transport.TCPv4.tcp1.disable_nagle

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disables the TCP nagle algorithm.

Related to these features

Transport

dds.transport.TCPv4.tcp1.enable_keep_alive

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Configures the sending of KEEP_ALIVE messages in TCP.

Related to these features

Transport

dds.transport.TCPv4.tcp1.force_asynchronous_send

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces asynchronous send.

Related to these features

Transport

dds.transport.TCPv4.tcp1.force_crc_check

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

When set to 1, forces the checking of the CRC for received RTI TCP messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.force_interface_poll_detection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces the interface tracker to use a polling method to detect changes to the network interfaces in IP mobility scenarios.

Related to these features

Transport

dds.transport.TCPv4.tcp1.ignore_loopback_interface

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from using the IP loopback interface.

Related to these features

Transport

dds.transport.TCPv4.tcp1.ignore_nonrunning_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from using a network interface that is not reported as RUNNING by the operating system.

Related to these features

Transport

dds.transport.TCPv4.tcp1.initial_handshake_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[1,INT_MAX]

Description

Timeout (in seconds) for the initial handshake for a connection.

Related to these features

Transport

dds.transport.TCPv4.tcp1.interface_poll_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

500

Min-Max value

[0,INT_MAX]

Description

Specifies the period in milliseconds to query for changes in the state of all the interfaces.

Related to these features

Transport

dds.transport.TCPv4.tcp1.keep_alive_interval

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Specifies the interval in seconds between KEEP_ALIVE retries.

Related to these features

Transport

dds.transport.TCPv4.tcp1.keep_alive_retry_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

The maximum number of KEEP_ALIVE retries before dropping the connection.

Related to these features

Transport

dds.transport.TCPv4.tcp1.keep_alive_time

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Specifies the interval of inactivity in seconds that causes TCP to generate a KEEP_ALIVE message.

Related to these features

Transport

dds.transport.TCPv4.tcp1.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

If used, must be ‘nddstransporttcp’.

Related to these features

Transport

dds.transport.TCPv4.tcp1.logging_verbosity_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

mask

Default Value

-1

Min-Max value

[0,INT_MAX]

Description

Bitmap that specifies the verbosity of log messages from the transport.

Related to these features

Transport
Logging

dds.transport.TCPv4.tcp1.max_packet_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

The maximum size of a TCP segment.

Related to these features

Transport

dds.transport.TCPv4.tcp1.negotiate_session_id

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

When set to 1, the TCP transport plugin will perform a session negotiation that will help external load balancers identify all the connections associated with a particular session between two Connext DDS applications.

Related to these features

Transport

dds.transport.TCPv4.tcp1.outstanding_connection_cookies

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

100

Min-Max value

[0,INT_MAX]

Description

Maximum number of outstanding connection cookies allowed by the transport when acting as a server .

Related to these features

Transport

dds.transport.TCPv4.tcp1.outstanding_connection_cookies_life_span

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[INT_MIN,INT_MAX]

Description

Maximum lifespan (in seconds) of the cookies associated with pending connections.

Related to these features

Transport

dds.transport.TCPv4.tcp1.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.TCPv4.tcp1.public_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Min-Max value

[0,255]

Description

Public IP address and port (WAN address and port) (separated with ‘:’) associated with the transport instantiation.

Related to these features

Transport

dds.transport.TCPv4.tcp1.recv_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size, in bytes, of the receive buffer of a socket used for receiving.

Related to these features

Transport

dds.transport.TCPv4.tcp1.security_logging_verbosity_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

mask

Default Value

-1

Min-Max value

[0,INT_MAX]

Description

Bitmap that specifies the verbosity of security related log messages from the transport.

Related to these features

Transport
Transport Secure
Logging

dds.transport.TCPv4.tcp1.send_crc

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

When set to 1, enables the computation of the CRC for sent RTI TCP messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.send_max_wait_sec

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

3

Min-Max value

[0,INT_MAX]

Description

Controls the maximum time (in seconds) the low-level sendto() function is allowed to block the caller thread when the TCP send buffer becomes full.

Related to these features

Transport

dds.transport.TCPv4.tcp1.send_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size, in bytes, of the send buffer of a socket used for sending.

Related to these features

Transport

dds.transport.TCPv4.tcp1.server_bind_port

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

7400

Min-Max value

[0,INT_MAX]

Description

Private IP port (inside the LAN) used by the transport to accept TCP connections.

Related to these features

Transport

dds.transport.TCPv4.tcp1.server_connection_negotiation_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[1,INT_MAX]

Description

Timeout (in seconds) for negotiating a server data connection.

Related to these features

Transport

dds.transport.TCPv4.tcp1.server_socket_backlog

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

5

Min-Max value

[0,INT_MAX]

Description

The backlog parameter determines what is the maximum length of the queue of pending connections.

Related to these features

Transport

dds.transport.TCPv4.tcp1.shared_write_buffer_allocation

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Indicates if the allocation settings in write_buffer_allocation are global to the transport or per destination.

Related to these features

Transport

dds.transport.TCPv4.tcp1.socket_monitoring_kind

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

SELECT

Possible values

SELECT
WINDOWS_IOCP
WINDOWS_WAITFORMULTIPLEOBJECTS

Description

Configures the socket monitoring API used by the transport.

Related to these features

Transport

dds.transport.TCPv4.tcp1.tls_create_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

pointer

Pattern value

.*

Description

Defines the function pointer to the TLS Support creation function.

Related to these features

Transport

dds.transport.TCPv4.tcp1.tls_delete_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

pointer

Pattern value

.*

Description

Defines the function pointer to the TLS Support deletion function.

Related to these features

Transport

dds.transport.TCPv4.tcp1.transport_priority_mapping_high

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0xFF

Min-Max value

[0,INT_MAX]

Description

Sets the high value of the output range to IPv4 TOS.

Related to these features

Transport

dds.transport.TCPv4.tcp1.transport_priority_mapping_low

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Sets the low value of the output range to IPv4 TOS.

Related to these features

Transport

dds.transport.TCPv4.tcp1.transport_priority_mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Mask for the transport priority field.

Related to these features

Transport

dds.transport.TCPv4.tcp1.user_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[MIN_INT,MAX_INT]

Description

Changes the default OS TCP User Timeout configuration.

Related to these features

Transport

connection_liveliness

dds.transport.TCPv4.tcp1.connection_liveliness.assertions_per_lease_duration

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

3

Min-Max value

[0,INT_MAX]

Description

Configures the connection liveliness feature.

Related to these features

Transport

dds.transport.TCPv4.tcp1.connection_liveliness.enable

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Configures the connection liveliness feature.

Related to these features

Transport

dds.transport.TCPv4.tcp1.connection_liveliness.lease_duration

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[0,INT_MAX]

Description

Configures the connection liveliness feature.

Related to these features

Transport

control_attribute_allocation

dds.transport.TCPv4.tcp1.control_attribute_allocation.incremental_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to control message attributes.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_attribute_allocation.initial_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

2

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to control message attributes.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_attribute_allocation.max_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to control message attributes.

Related to these features

Transport

control_buffer_allocation

dds.transport.TCPv4.tcp1.control_buffer_allocation.incremental_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to buffers used to serialize and send control messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_buffer_allocation.initial_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

2

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to buffers used to serialize and send control messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_buffer_allocation.max_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to buffers used to serialize and send control messages.

Related to these features

Transport

control_message_allocation

dds.transport.TCPv4.tcp1.control_message_allocation.incremental_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-MIN_INT,MAX_INT]

Description

Allocation settings applied to control messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_message_allocation.initial_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

2

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to control messages.

Related to these features

Transport

dds.transport.TCPv4.tcp1.control_message_allocation.max_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to control messages.

Related to these features

Transport

event_thread

dds.transport.TCPv4.tcp1.event_thread.mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

mask

Default Value

PRIORITY_ENFORCE | STDIO

Possible values

STDIO
FLOATING_POINT
REALTIME_PRIORITY
PRIORITY_ENFORCE

Description

Configures the event thread used by the TCP Transport plugin for providing some features.

Related to these features

Transport

dds.transport.TCPv4.tcp1.event_thread.priority

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

THREAD_PRIORITY_NORMAL

Possible values

THREAD_PRIORITY_DEFAULT
THREAD_PRIORITY_HIGH
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_LOW

Description

Configures the event thread used by the TCP Transport plugin for providing some features.

Related to these features

Transport

dds.transport.TCPv4.tcp1.event_thread.stack_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

THREAD_STACK_SIZE_DEFAULT

Pattern value

THREAD_STACK_SIZE_DEFAULT

Min-Max value

[INT_MIN,INT_MAX]

Description

Configures the event thread used by the TCP Transport plugin for providing some features.

Related to these features

Transport

parent

dds.transport.TCPv4.tcp1.parent.allow_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that can be used by the transport.

Related to these features

Transport

dds.transport.TCPv4.tcp1.parent.classid

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

NDDS_TRANSPORT_CLASSID_TCPV4_LAN

Min-Max value

[INT_MIN,INT_MAX]

Possible values

NDDS_TRANSPORT_CLASSID_INVALID
NDDS_TRANSPORT_CLASSID_ANY
NDDS_TRANSPORT_CLASSID_TCPV4_WAN
NDDS_TRANSPORT_CLASSID_TCPV4_LAN
NDDS_TRANSPORT_CLASSID_TLSV4_LAN
NDDS_TRANSPORT_CLASSID_TLSV4_WAN

Description

Must be set to one of the listed possible values.

Related to these features

Transport

dds.transport.TCPv4.tcp1.parent.deny_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that will not be used by the transport.

Related to these features

Transport

dds.transport.TCPv4.tcp1.parent.gather_send_buffer_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

128

Min-Max value

[0,INT_MAX]

Description

Specifies the maximum number of buffers that Connext DDS can pass to the send() method of a transport plugin.

Related to these features

Transport

dds.transport.TCPv4.tcp1.parent.max_interface_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Maximum number of valid interfaces that will be used from the allow_interfaces_list

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.parent.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

65536

Min-Max value

[0,INT_MAX]

Description

The maximum size of a message in bytes that can be sent or received by the transport plugin.

Related to these features

Transport

dds.transport.TCPv4.tcp1.parent.thread_name_prefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

rTr#####

Pattern value

^.{0,8}$

Description

Prefix used to name the transport threads.

Related to these features

Transport

read_buffer_allocation

dds.transport.TCPv4.tcp1.read_buffer_allocation.incremental_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to read buffers.

Related to these features

Transport

dds.transport.TCPv4.tcp1.read_buffer_allocation.initial_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

2

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to read buffers.

Related to these features

Transport

dds.transport.TCPv4.tcp1.read_buffer_allocation.max_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[MIN_INT,MAX_INT]

Description

Allocation settings applied to read buffers.

Related to these features

Transport

tls.cipher

dds.transport.TCPv4.tcp1.tls.cipher.cipher_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

NULL

Possible values

RTITLS_CIPHER_LIST_DEFAULT
RTITLS_CIPHER_LIST_ENCRYPT_HIGH
RTITLS_CIPHER_LIST_UNENCRYPTED

Description

List of available TLS ciphers when communicating with 6.0.0 or below.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.cipher.ciphersuites

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

List of available TLS ciphersuites when communicating with 6.0.1 or above.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.cipher.dh_param_files

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Possible values

0-9

Description

List of available Diffie-Hellman (DH) key files.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.cipher.engine_id

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

ID of OpenSSL cipher engine to request.

Related to these features

Transport
Transport Secure

tls.identity

dds.transport.TCPv4.tcp1.tls.identity.certificate_chain

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

String containing an identifying certificate (in PEM format) or certificate chain (appending intermediate CA certs in order).

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.certificate_chain_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

File containing identifying certificate (in PEM format) or certificate chain (appending intermediate CA certs in order).

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.private_key

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

String containing private key (in PEM format).

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.private_key_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

File containing private key (in PEM format).

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.private_key_password

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

A string that specifies the password for the private key.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.rsa_private_key

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

String containing additional RSA private key (in PEM format).

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.identity.rsa_private_key_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

File containing additional RSA private key (in PEM format).

Related to these features

Transport
Transport Secure

tls.verify

dds.transport.TCPv4.tcp1.tls.verify.ca_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

A string that specifies the name of a file containing Certificate Authority certificates.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.verify.ca_path

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

A string that specifies paths to directories containing Certificate Authority certificates.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.verify.crl_file

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Name of the file containing the Certificate Revocation List.

Related to these features

Transport
Transport Secure

dds.transport.TCPv4.tcp1.tls.verify.verify_depth

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[INT_MIN,INT_MAX]

Description

Maximum certificate chain length for verification.

Related to these features

Transport
Transport Secure

windows_iocp

dds.transport.TCPv4.tcp1.windows_iocp.concurrency_value

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

Configures I/O completion ports.

Related to these features

Transport

dds.transport.TCPv4.tcp1.windows_iocp.thread_pool_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

2

Min-Max value

[0,INT_MAX]

Description

Configures I/O completion ports.

Related to these features

Transport

write_buffer_allocation

dds.transport.TCPv4.tcp1.write_buffer_allocation.incremental_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

10

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to buffers used for asynchronous (non-blocking) write.

Related to these features

Transport

dds.transport.TCPv4.tcp1.write_buffer_allocation.initial_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

4

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to buffers used for asynchronous (non-blocking) write.

Related to these features

Transport

dds.transport.TCPv4.tcp1.write_buffer_allocation.max_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1000

Min-Max value

[0,INT_MAX]

Description

Allocation settings applied to buffers used for asynchronous (non-blocking) write.

Related to these features

Transport

UDPv4.builtin

dds.transport.UDPv4.builtin.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Aliases used to register the transport to the DomainParticipant.

Related to these features

Transport

dds.transport.UDPv4.builtin.disable_interface_tracking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disables detection of network interface changes.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><disable_interface_tracking>

dds.transport.UDPv4.builtin.force_interface_poll_detection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces the interface tracker to use a polling method to detect changes to the network interfaces in IP mobility scenarios.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><force_interface_poll_detection>

dds.transport.UDPv4.builtin.ignore_loopback_interface

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Possible values

-1
0
1

Description

Prevents the transport plugin from using the IP loopback interface.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><ignore_loopback_interface>

dds.transport.UDPv4.builtin.ignore_nonrunning_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from using a network interface that is not reported as RUNNING by the operating system.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><ignore_nonrunning_interfaces>

dds.transport.UDPv4.builtin.ignore_nonup_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

This property is only supported on Windows platforms with statically configured IP addresses.

Related to these features

Transport
Builtin Transport

dds.transport.UDPv4.builtin.interface_poll_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

500

Min-Max value

[0,UINT_MAX]

Description

Specifies the period in milliseconds to query for changes in the state of all the interfaces.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><interface_poll_period>

dds.transport.UDPv4.builtin.join_multicast_group_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

5000

Min-Max value

[0,UINT_MAX]

Description

Controls how long Connext DDS will retry to join a multicast group with a new network interface before withdrawing.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><join_multicast_group_timeout>

dds.transport.UDPv4.builtin.multicast_enabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Allows the transport plugin to use multicast for sending and receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><multicast_enabled>

dds.transport.UDPv4.builtin.multicast_loopback_disabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from putting multicast packets onto the loopback interface.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><multicast_loopback_disabled>

dds.transport.UDPv4.builtin.multicast_ttl

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

Value for the time-to-live parameter for all multicast sends using this plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><multicast_ttl>

dds.transport.UDPv4.builtin.no_zero_copy

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from doing a zero copy.

Related to these features

Transport
Builtin Transport

dds.transport.UDPv4.builtin.port_offset

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,65535]

Description

Port offset to allow coexistence with other instances of UDP transport.

Related to these features

Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><port_offset>

dds.transport.UDPv4.builtin.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.UDPv4.builtin.protocol_overhead_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

28

Min-Max value

[0,UINT_MAX]

Description

Maximum size in bytes of protocol overhead, including headers.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><protocol_overhead_max>

dds.transport.UDPv4.builtin.public_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Public IP address associated with the transport instantiation.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><public_address>

dds.transport.UDPv4.builtin.recv_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the receive buffer of a socket used for receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><recv_socket_buffer_size>

dds.transport.UDPv4.builtin.reuse_multicast_receive_resource

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Controls whether or not to reuse receive resources.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><reuse_multicast_receive_resource>

dds.transport.UDPv4.builtin.send_blocking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS

Possible values

0
1
NDDS_TRANSPORT_UDP_BLOCKING_NEVER
NDDS_TRANSPORT_UDPV4_BLOCKING_NEVER
TRANSPORT_BLOCKING_NEVER
NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS
NDDS_TRANSPORT_UDPV4_BLOCKING_ALWAYS
TRANSPORT_BLOCKING_ALWAYS

Description

Controls the blocking behavior of send sockets.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><send_blocking>

dds.transport.UDPv4.builtin.send_ping

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

This property specifies whether to send a PING message before commencing the discovery process.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><send_ping>

dds.transport.UDPv4.builtin.send_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the send buffer of a socket used for sending.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><send_socket_buffer_size>

dds.transport.UDPv4.builtin.transport_priority_mapping_high

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0xFF

Min-Max value

[0,INT_MAX]

Description

Sets the high value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><transport_priority_mapping_high>

dds.transport.UDPv4.builtin.transport_priority_mapping_low

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Sets the low value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><transport_priority_mapping_low>

dds.transport.UDPv4.builtin.transport_priority_mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Mask for the transport priority field.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><transport_priority_mask>

dds.transport.UDPv4.builtin.unicast_enabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Allows the transport plugin to use unicast UDP for sending and receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><unicast_enabled>

dds.transport.UDPv4.builtin.use_checksum

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Specifies whether the UDP checksum will be computed.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><use_checksum>

parent

dds.transport.UDPv4.builtin.parent.allow_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that can be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><allow_interfaces_list>

dds.transport.UDPv4.builtin.parent.allow_multicast_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><allow_multicast_interfaces_list>

dds.transport.UDPv4.builtin.parent.deny_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that will not be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><deny_interfaces_list>

dds.transport.UDPv4.builtin.parent.deny_multicast_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><deny_multicast_interfaces_list>

dds.transport.UDPv4.builtin.parent.gather_send_buffer_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

16

Min-Max value

[0,INT_MAX]

Description

Specifies the maximum number of buffers that Connext DDS can pass to the send() method of a transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><gather_send_buffer_count_max>

dds.transport.UDPv4.builtin.parent.max_interface_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Maximum number of valid interfaces that will be used from the allow_interfaces_list

Related to these features

Transport
Builtin Transport

dds.transport.UDPv4.builtin.parent.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

65507

Min-Max value

[INT_MIN,MAX_INT]

Possible values

UDPV4_MESSAGE_SIZE_MAX_DEFAULT
NDDS_TRANSPORT_UDPV4_MESSAGE_SIZE_MAX_DEFAULT

Description

The maximum size of a message in bytes that can be sent or received by the transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><message_size_max>

dds.transport.UDPv4.builtin.parent.properties_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

String

Default Value

NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Possible values

0
1
2
TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
NDDS_TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
TRANSPORT_PROPERTY_BITMAP_DEFAULT
NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Description

A bitmap that defines various properties of the transport to the Connext DDS core.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><properties_bitmap>

dds.transport.UDPv4.builtin.parent.thread_name_prefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

rTr#####

Pattern value

^.{0,8}$

Description

Prefix used to name the transport threads.

Related to these features

Transport
Builtin Transport

UDPv4_WAN.builtin

dds.transport.UDPv4_WAN.builtin.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Aliases used to register the transport to the DomainParticipant.

Related to these features

Transport

dds.transport.UDPv4_WAN.builtin.binding_ping_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1000

Min-Max value

[0,INT_MAX]

Description

Specifies the period in milliseconds at which BINDING PINGS messages are sent to keep NAT mappings open

Related to these features

Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><binding_ping_period>

dds.transport.UDPv4_WAN.builtin.comm_ports

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

json

Description

Configures the mapping between <RTPS ports>, <UDP receive host ports>, and <UDP receive public ports>.

Related to these features

Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><comm_ports>

dds.transport.UDPv4_WAN.builtin.disable_interface_tracking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disables detection of network interface changes.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><disable_interface_tracking>

dds.transport.UDPv4_WAN.builtin.force_interface_poll_detection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces the interface tracker to use a polling method to detect changes to the network interfaces in IP mobility scenarios.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><force_interface_poll_detection>

dds.transport.UDPv4_WAN.builtin.ignore_loopback_interface

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Possible values

-1
0
1

Description

Prevents the transport plugin from using the IP loopback interface.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><ignore_loopback_interface>

dds.transport.UDPv4_WAN.builtin.ignore_nonrunning_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from using a network interface that is not reported as RUNNING by the operating system.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><ignore_nonrunning_interfaces>

dds.transport.UDPv4_WAN.builtin.ignore_nonup_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

This property is only supported on Windows platforms with statically configured IP addresses.

Related to these features

Transport
Builtin Transport

The property has been deprecated in version

6.1.0

dds.transport.UDPv4_WAN.builtin.interface_poll_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

500

Min-Max value

[0,UINT_MAX]

Description

Specifies the period in milliseconds to query for changes in the state of all the interfaces.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><interface_poll_period>

dds.transport.UDPv4_WAN.builtin.no_zero_copy

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from doing a zero copy.

Related to these features

Transport
Builtin Transport

The property has been deprecated in version

6.1.0

dds.transport.UDPv4_WAN.builtin.plugin_enabled_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Only required if statically linking the Real-Time Wan Transport (RWT) support library. Must be set to the stringified pointer value of RWT support library’s NDDS_Transport_UDP_WAN_Library_is_plugin_enabled function. Please refer to the RWT documentation for details.

Related to these features

Transport
Builtin Transport

dds.transport.UDPv4_WAN.builtin.port_offset

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

125

Min-Max value

[0,65535]

Description

Port offset to allow coexistence with non-WAN UDP transport.

Related to these features

Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><port_offset>

dds.transport.UDPv4_WAN.builtin.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.UDPv4_WAN.builtin.protocol_overhead_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

28

Min-Max value

[0,UINT_MAX]

Description

Maximum size in bytes of protocol overhead, including headers.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><protocol_overhead_max>

dds.transport.UDPv4_WAN.builtin.public_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Public IP address associated with the transport instantiation.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><public_address>

dds.transport.UDPv4_WAN.builtin.recv_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the receive buffer of a socket used for receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><recv_socket_buffer_size>

dds.transport.UDPv4_WAN.builtin.send_blocking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS

Possible values

0
1
NDDS_TRANSPORT_UDP_BLOCKING_NEVER
NDDS_TRANSPORT_UDPV4_BLOCKING_NEVER
TRANSPORT_BLOCKING_NEVER
NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS
NDDS_TRANSPORT_UDPV4_BLOCKING_ALWAYS
TRANSPORT_BLOCKING_ALWAYS

Description

Controls the blocking behavior of send sockets.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><send_blocking>

dds.transport.UDPv4_WAN.builtin.send_ping

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

This property specifies whether to send a PING message before commencing the discovery process.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><send_ping>

dds.transport.UDPv4_WAN.builtin.send_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the send buffer of a socket used for sending.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><send_socket_buffer_size>

dds.transport.UDPv4_WAN.builtin.transport_priority_mapping_high

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0xFF

Min-Max value

[0,INT_MAX]

Description

Sets the high value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><transport_priority_mapping_high>

dds.transport.UDPv4_WAN.builtin.transport_priority_mapping_low

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Sets the low value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><transport_priority_mapping_low>

dds.transport.UDPv4_WAN.builtin.transport_priority_mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Mask for the transport priority field.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><transport_priority_mask>

dds.transport.UDPv4_WAN.builtin.use_checksum

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Specifies whether the UDP checksum will be computed.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><use_checksum>

parent

dds.transport.UDPv4_WAN.builtin.parent.allow_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that can be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><allow_interfaces_list>

dds.transport.UDPv4_WAN.builtin.parent.deny_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that will not be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><deny_interfaces_list>

dds.transport.UDPv4_WAN.builtin.parent.gather_send_buffer_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

16

Min-Max value

[0,INT_MAX]

Description

Specifies the maximum number of buffers that Connext DDS can pass to the send() method of a transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><gather_send_buffer_count_max>

dds.transport.UDPv4_WAN.builtin.parent.max_interface_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Maximum number of valid interfaces that will be used from the allow_interfaces_list

Related to these features

Transport
Builtin Transport

dds.transport.UDPv4_WAN.builtin.parent.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

65507

Min-Max value

[INT_MIN,MAX_INT]

Possible values

UDPV4_MESSAGE_SIZE_MAX_DEFAULT
NDDS_TRANSPORT_UDPV4_MESSAGE_SIZE_MAX_DEFAULT

Description

The maximum size of a message in bytes that can be sent or received by the transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><message_size_max>

dds.transport.UDPv4_WAN.builtin.parent.properties_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

String

Default Value

NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Possible values

0
1
2
TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
NDDS_TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
TRANSPORT_PROPERTY_BITMAP_DEFAULT
NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Description

A bitmap that defines various properties of the transport to the Connext DDS core.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4_wan><properties_bitmap>

dds.transport.UDPv4_WAN.builtin.parent.thread_name_prefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

rTr#####

Pattern value

^.{0,8}$

Description

Prefix used to name the transport threads.

Related to these features

Transport
Builtin Transport

UDPv6.builtin

dds.transport.UDPv6.builtin.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Aliases used to register the transport to the DomainParticipant.

Related to these features

Transport

dds.transport.UDPv6.builtin.disable_interface_tracking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Disables detection of network interface changes.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><disable_interface_tracking>

dds.transport.UDPv6.builtin.enable_v4mapped

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Specifies whether the UDPv6 transport will process IPv4 addresses.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><enable_v4mapped>

dds.transport.UDPv6.builtin.force_interface_poll_detection

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Forces the interface tracker to use a polling method to detect changes to the network interfaces in IP mobility scenarios.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><force_interface_poll_detection>

dds.transport.UDPv6.builtin.ignore_loopback_interface

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Possible values

-1
0
1

Description

Prevents the transport plugin from using the IP loopback interface.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><ignore_loopback_interface>

dds.transport.UDPv6.builtin.ignore_nonrunning_interfaces

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from using a network interface that is not reported as RUNNING by the operating system.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><ignore_nonrunning_interfaces>

dds.transport.UDPv6.builtin.interface_poll_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

500

Min-Max value

[0,UINT_MAX]

Description

Specifies the period in milliseconds to query for changes in the state of all the interfaces.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><interface_poll_period>

dds.transport.UDPv6.builtin.join_multicast_group_timeout

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

5000

Min-Max value

[0,UINT_MAX]

Description

Controls how long Connext DDS will retry to join a multicast group with a new network interface before withdrawing.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><join_multicast_group_timeout>

dds.transport.UDPv6.builtin.multicast_enabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Allows the transport plugin to use multicast for sending and receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><multicast_enabled>

dds.transport.UDPv6.builtin.multicast_loopback_disabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from putting multicast packets onto the loopback interface.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><multicast_loopback_disabled>

dds.transport.UDPv6.builtin.multicast_ttl

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

Value for the time-to-live parameter for all multicast sends using this plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><multicast_ttl>

dds.transport.UDPv6.builtin.no_zero_copy

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Prevents the transport plugin from doing a zero copy.

Related to these features

Transport
Builtin Transport

dds.transport.UDPv6.builtin.port_offset

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,65535]

Description

Port offset to allow coexistence with other instances of UDP transport.

Related to these features

Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><port_offset>

dds.transport.UDPv6.builtin.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.UDPv6.builtin.protocol_overhead_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

48

Min-Max value

[0,UINT_MAX]

Description

Maximum size in bytes of protocol overhead, including headers.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><protocol_overhead_max>

dds.transport.UDPv6.builtin.public_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Public IP address associated with the transport instantiation.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><public_address>

dds.transport.UDPv6.builtin.recv_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the receive buffer of a socket used for receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><recv_socket_buffer_size>

dds.transport.UDPv6.builtin.reuse_multicast_receive_resource

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Controls whether or not to reuse receive resources.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><reuse_multicast_receive_resource>

dds.transport.UDPv6.builtin.send_blocking

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS

Possible values

0
1
NDDS_TRANSPORT_UDP_BLOCKING_NEVER
NDDS_TRANSPORT_UDPV6_BLOCKING_NEVER
TRANSPORT_BLOCKING_NEVER
NDDS_TRANSPORT_UDP_BLOCKING_ALWAYS
NDDS_TRANSPORT_UDPV6_BLOCKING_ALWAYS
TRANSPORT_BLOCKING_ALWAYS

Description

Controls the blocking behavior of send sockets.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv4><send_blocking>

dds.transport.UDPv6.builtin.send_ping

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[0,INT_MAX]

Description

This property specifies whether to send a PING message before commencing the discovery process.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><send_ping>

dds.transport.UDPv6.builtin.send_socket_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

131072

Min-Max value

[MIN_INT,MAX_INT]

Description

Size in bytes of the send buffer of a socket used for sending.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><send_socket_buffer_size>

dds.transport.UDPv6.builtin.transport_priority_mapping_high

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0xFF

Min-Max value

[0,INT_MAX]

Description

Sets the high value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><transport_priority_mapping_high>

dds.transport.UDPv6.builtin.transport_priority_mapping_low

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Sets the low value of the output range to IPv4 TOS.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><transport_priority_mapping_low>

dds.transport.UDPv6.builtin.transport_priority_mask

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

0

Min-Max value

[0,INT_MAX]

Description

Mask for the transport priority field.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><transport_priority_mask>

dds.transport.UDPv6.builtin.unicast_enabled

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Allows the transport plugin to use unicast UDP for sending and receiving.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><unicast_enabled>

parent

dds.transport.UDPv6.builtin.parent.allow_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that can be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><allow_interfaces_list>

dds.transport.UDPv6.builtin.parent.allow_multicast_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><allow_multicast_interfaces_list>

dds.transport.UDPv6.builtin.parent.deny_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name that will not be used by the transport.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><deny_interfaces_list>

dds.transport.UDPv6.builtin.parent.deny_multicast_interfaces_list

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*(,.*)*

Description

A list of strings, each identifying a range of interface addresses or an interface name.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><deny_multicast_interfaces_list>

dds.transport.UDPv6.builtin.parent.gather_send_buffer_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

16

Min-Max value

[0,INT_MAX]

Description

Specifies the maximum number of buffers that Connext DDS can pass to the send() method of a transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><gather_send_buffer_count_max>

dds.transport.UDPv6.builtin.parent.max_interface_count

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Maximum number of valid interfaces that will be used from the allow_interfaces_list

Related to these features

Transport
Builtin Transport

dds.transport.UDPv6.builtin.parent.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

65487

Min-Max value

[INT_MIN,MAX_INT]

Possible values

UDPV4_MESSAGE_SIZE_MAX_DEFAULT
NDDS_TRANSPORT_UDPV4_MESSAGE_SIZE_MAX_DEFAULT

Description

The maximum size of a message in bytes that can be sent or received by the transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><message_size_max>

dds.transport.UDPv6.builtin.parent.properties_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

String

Default Value

NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Possible values

0
1
2
TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
NDDS_TRANSPORT_PROPERTY_BIT_BUFFER_ALWAYS_LOANED
TRANSPORT_PROPERTY_BITMAP_DEFAULT
NDDS_TRANSPORT_PROPERTIES_BITMAP_DEFAULT

Description

A bitmap that defines various properties of the transport to the Connext DDS core.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><udpv6><properties_bitmap>

dds.transport.UDPv6.builtin.parent.thread_name_prefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

rTr#####

Pattern value

^.{0,8}$

Description

Prefix used to name the transport threads.

Related to these features

Transport
Builtin Transport

lbrtps

dds.transport.lbrtps.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Aliases used to register the LBRTPS transport plugin with the DomainParticipant.

Related to these features

Transport

dds.transport.lbrtps.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the function that will be called by Connext DDS to create an instance of the LBRTPS transport.

Related to these features

Transport

dds.transport.lbrtps.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The name of the dynamic library that contains the LBRTPS transport plugin implementation.

Related to these features

Transport

dds.transport.lbrtps.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.lbrtps.subtransport

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

[UDPv4|zrtps|.*]

Description

Name of the plugin to be loaded by the LBRTPS transport.

Related to these features

Transport

dds.transport.lbrtps.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Possible values

-1
0
2

Description

The verbosity for the plugin, for debugging purposes.

Related to these features

Transport
Logging

rtps_header

dds.transport.lbrtps.rtps_header.eliminate_protocol

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Whether or not to eliminate the 4-byte protocol field in the RTPS header.

Related to these features

Transport

dds.transport.lbrtps.rtps_header.eliminate_vendorId

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Whether or not to eliminate the 2-byte vendorId field in the RTPS header.

Related to these features

Transport

dds.transport.lbrtps.rtps_header.eliminate_version

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Whether or not to eliminate the 2-byte version field in the RTPS header.

Related to these features

Transport

dds.transport.lbrtps.rtps_header.reduce_guidPrefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

32,32,32

Min-Max value

[0,32]

Description

The reduce_guidPrefix field is composed of 12 bytes that represent 3 different fields of 4 bytes each: hostId, appId and instanceId.

Related to these features

Transport

submessage_header

dds.transport.lbrtps.submessage_header.combine_submessageId_with_flags

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Combine the first two fields in the SubmessageHeader; do not use all the bits.

Related to these features

Transport

submessages

dds.transport.lbrtps.submessages.reduce_entitiesId

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

32,32

Min-Max value

[8,32]

Description

Many submessage kinds include two fields: readerId and writerId. You may be able to reduce the size of these fields if you know ahead of time how many DataReaders and DataWriters you will have.

Related to these features

Transport

dds.transport.lbrtps.submessages.reduce_sequenceNumber

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

64

Min-Max value

[16,64]

Description

Some submessage kinds keep track of the number of submessages received by using an 8-byte sequence number field. You can reduce the number of bytes used for the sequence number by using this property.

Related to these features

Transport

shmem.builtin

dds.transport.shmem.builtin.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Description

Aliases used to register the transport to the DomainParticipant.

Related to these features

Transport

dds.transport.shmem.builtin.enable_udp_debugging

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Enables UDP debugging when using shared memory.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><enable_udp_debugging>

dds.transport.shmem.builtin.host_id

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

0

Min-Max value

[0,UINT_MAX]

Description

Host ID used to generate the shared memory transport network address.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><host_id>

dds.transport.shmem.builtin.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.shmem.builtin.receive_buffer_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

mutableUntilEnable

Default Value

1048576

Min-Max value

[0,INT_MAX]

Description

The total number of bytes that can be buffered in the receive queue.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><receive_buffer_size>

dds.transport.shmem.builtin.received_message_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Mutability type

mutableUntilEnable

Default Value

64

Min-Max value

[0,INT_MAX]

Description

Number of messages that can be buffered in the receive queue.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><received_message_count_max>

dds.transport.shmem.builtin.udp_debugging_address

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

239.255.1.2

Min-Max value

[0,255]

Description

IP address to which shared memory traffic will be published

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><udp_debugging_address>

dds.transport.shmem.builtin.udp_debugging_port

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

unsigned integer

Default Value

7399

Min-Max value

[0,UINT_MAX]

Description

Port to which shared memory traffic will be published.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><udp_debugging_port>

dds.transport.shmem.builtin.use_530_from_uuid_locator

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

This property only applies when the WireProtocol QoS policy (specifically rtps_auto_id_kind) is set to DDS_RTPS_AUTO_ID_FROM_UUID. Consider using the transport QoS or the newer dds.transport.minimum_compatibility_version property.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><use_530_from_uuid_locator>

parent

dds.transport.shmem.builtin.parent.gather_send_buffer_count_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1024

Min-Max value

[0,INT_MAX]

Description

Specifies the maximum number of buffers that Connext DDS can pass to the send() method of a transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><gather_send_buffer_count_max>

dds.transport.shmem.builtin.parent.message_size_max

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

65536

Min-Max value

[INT_MIN,INT_MAX]

Description

The maximum size of a message in bytes that can be sent or received by the transport plugin.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><message_size_max>

dds.transport.shmem.builtin.parent.properties_bitmap

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0x2

Min-Max value

[0,INT_MAX]

Description

A bitmap that defines various properties of the transport to the Connext DDS core.

Related to these features

Transport
Builtin Transport

The property has been promoted to

<domain_participant_qos><transport_builtin><shmem><properties_bitmap>

dds.transport.shmem.builtin.parent.thread_name_prefix

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

rTr#####

Pattern value

^.{0,8}$

Description

Prefix used to name the transport threads.

Related to these features

Transport
Builtin Transport

zrtps

dds.transport.zrtps.aliases

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*[,.*]*

Related to these features

Transport

dds.transport.zrtps.compression_level

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

9

Min-Max value

[1,9]

Description

Defines the compression level that the compression algorithm will use for all RTPS packages.

Related to these features

Transport

dds.transport.zrtps.compression_library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

ZLIB_COMPRESSION

Possible values

BZIP2_COMPRESSION
EXTERNAL_COMPRESSION
AUTOMATIC_COMPRESSION
ZLIB_COMPRESSION

Description

Aliases used to register the ZRTPS transport plugin with the DomainParticipant.

Related to these features

Transport

dds.transport.zrtps.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

Must be set to ZRTPS_Transport_create_plugin.

Related to these features

Transport

dds.transport.zrtps.external_library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Sets the name of a user’s external library that is to be located and used by the ZRTPS transport plugin.

Related to these features

Transport

dds.transport.zrtps.high_mark

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

512

Min-Max value

[0,INT_MAX]

Description

Specifies the size for small, medium, and large RTPS packages.

Related to these features

Transport

dds.transport.zrtps.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*

Description

The value must be rtizrtps.

Related to these features

Transport

dds.transport.zrtps.low_mark

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

128

Min-Max value

[0,INT_MAX]

Description

Specifies the size for small, medium, and large RTPS packages.

Related to these features

Transport

dds.transport.zrtps.property_validation_action

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

VALIDATION_ACTION_EXCEPTION

Possible values

VALIDATION_ACTION_WARNING
VALIDATION_ACTION_EXCEPTION
VALIDATION_ACTION_SKIP
-1
0
1

Description

Configures the validation of the properties.

Related to these features

Transport

dds.transport.zrtps.subtransport

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Pattern value

.*|UDPv4

Description

The required property, dds.transport.zrtps.subtransport, specifies the plugin to be loaded by the ZRTPS transport. Supported subtransports are UDPv4 or a user-specified transport. Connext DDS builtin transports other than UDPv4 are not currently supported as subtransports. Once you set the value for a subtransport, the names of all the properties for that subtransport should be in the form dds.transport.lbrtps.<subtransport>.<property>.

Related to these features

Transport

dds.transport.zrtps.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

0

Min-Max value

[INT_MIN,INT_MAX]

Description

The verbosity for the plugin, for debugging purposes.

Related to these features

Transport

compression_level

dds.transport.zrtps.compression_level.large_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

9

Min-Max value

[1,9]

Description

Defines the compression level that the compression algorithm will use for large RTPS packages.

Related to these features

Transport

dds.transport.zrtps.compression_level.medium_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

9

Min-Max value

[1,9]

Description

Defines the compression level that the compression algorithm will use for medium RTPS packages.

Related to these features

Transport

dds.transport.zrtps.compression_level.small_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

9

Min-Max value

[1,9]

Description

Defines the compression level that the compression algorithm will use for small RTPS packages.

Related to these features

Transport

compression_library

dds.transport.zrtps.compression_library.large_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

ZLIB_COMPRESSION

Possible values

BZIP2_COMPRESSION
EXTERNAL_COMPRESSION
AUTOMATIC_COMPRESSION
ZLIB_COMPRESSION

Description

Specifies the compression algorithm to be used for large RTPS packages.

Related to these features

Transport

dds.transport.zrtps.compression_library.medium_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

ZLIB_COMPRESSION

Possible values

BZIP2_COMPRESSION
EXTERNAL_COMPRESSION
AUTOMATIC_COMPRESSION
ZLIB_COMPRESSION

Description

Specifies the compression algorithm to be used for medium RTPS packages.

Related to these features

Transport

dds.transport.zrtps.compression_library.small_packets

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

enum

Default Value

ZLIB_COMPRESSION

Possible values

BZIP2_COMPRESSION
EXTERNAL_COMPRESSION
AUTOMATIC_COMPRESSION
ZLIB_COMPRESSION

Description

Specifies the compression algorithm to be used for small RTPS packages.

Related to these features

Transport

dds.type_consistency

dds.type_consistency.ignore_member_names

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

boolean

Default Value

false

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Controls whether member names are taken into consideration for type assignability.

Related to these features

Type System

The property has been deprecated by

<datareader_qos><type_consistency><ignore_member_names>

dds.type_consistency.ignore_sequence_bounds

May be set in

DataReader
DataWriter
DomainParticipant

Applies to

DataReader
DataWriter

Type

boolean

Default Value

true

Possible values

0
1
TRUE
FALSE
YES
NO

Description

Controls whether sequence bounds are taken into consideration for type assignability.

Related to these features

Type System

The property has been deprecated by

<datareader_qos><type_consistency><ignore_sequence_bounds>

dds.xtypes

dds.xtypes.compliance_mask

May be set in

DomainParticipant
DataWriter
DataReader

Applies to

DataWriter
DataReader

Type

integer

Default Value

NDDS_CONFIG_XTYPES_COMPLIANCE_MASK_DEFAULT (0x00000009) or value previously set by NDDS_Config_set_xtypes_compliance_mask or NDDS_XTYPES_COMPLIANCE_MASK environment variable

Min-Max value

[0,INT_MAX]

Description

The compliance mask configures different aspects of the Extended CDR encoding (XCDR and XCDR2) for a DataWriter and DataReader

Related to these features

Type System

rti.monitor

rti.monitor.create_function

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

RTIDefaultMonitor_create

Related to these features

Monitor

rti.monitor.create_function_ptr

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

pointer

Default Value

NULL

Related to these features

Monitor

rti.monitor.library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

rtimonitoring

Related to these features

Monitor

config

rti.monitor.config.get_process_statistics

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

true
false

Description

This boolean value specifies whether or not Monitoring Library should collect CPU and memory usage statistics for the process in the topic rti/dds/monitoring/domainParticipantDescription.

Related to these features

Monitor

rti.monitor.config.new_participant_domain_id

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[0,255]

Description

To create a separate participant that will be used to publish monitoring information in the application, set this to the domain ID that you want to use for the newly created participant.

Related to these features

Monitor

rti.monitor.config.publish_period

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

5

Min-Max value

[0,INT_MAX]

Description

Period of time to sample and publish all monitoring topics, in units of seconds.

Related to these features

Monitor

rti.monitor.config.publish_thread_options

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

mask

Default Value

FLOATING_POINT | STDIO

Possible values

STDIO
FLOATING_POINT
REALTIME_PRIORITY
PRIORITY_ENFORCE

Description

Describes the type of thread.

Related to these features

Monitor

rti.monitor.config.publish_thread_priority

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

RTI_OSAPI_THREAD_PRIORITY_BELOW_NORMAL

Description

Priority of the thread used to sample and publish monitoring data.

Related to these features

Monitor

rti.monitor.config.publish_thread_stacksize

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

RTI_OSAPI_THREAD_STACK_SIZE_DEFAULT

Description

Stack size used for the thread that samples and publishes monitoring data.

Related to these features

Monitor

rti.monitor.config.qos_library

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Specifies the name of the QoS library that you want to use for creating entities in the monitoring library (if you do not want to use default QoS values as set by the monitoring library).

Related to these features

Monitor

rti.monitor.config.qos_profile

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Specifies the name of the QoS profile that you want to use for creating entities in the monitoring library (if you do not want to use the default QoS values).

Related to these features

Monitor

rti.monitor.config.reset_status_change_counts

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

true
false

Description

Monitoring Library obtains all statuses of all entities in the Connext DDS application. This boolean value controls whether or not the change counts in those statuses are reset by Monitoring Library.

Related to these features

Monitor

rti.monitor.config.skip_monitor_entities

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

true

Possible values

true
false

Description

This boolean value controls whether or not the entities created internally by Monitoring Library should be included in the entity counts published by the participant entity statistics topic.

Related to these features

Monitor

rti.monitor.config.skip_participant_properties

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

true
false

Description

If set to true, DomainParticipant PropertyQosPolicy name and value pairs will not be sent out through the domainParticipantDescriptionTopic.

Related to these features

Monitor

rti.monitor.config.skip_reader_properties

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

true
false

Related to these features

Monitor

rti.monitor.config.skip_writer_properties

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

boolean

Default Value

false

Possible values

true
false

Description

If set to true, DataReader PropertyQosPolicy name and value pairs will not be sent out through the dataReaderDescriptionTopic.

Related to these features

Monitor

rti.monitor.config.topics

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Filter for monitoring topics, with regular expression matching syntax as specified in the Connext DDS documentation (similar to the POSIX fnmatch syntax).

Related to these features

Monitor

rti.monitor.config.usertopics

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

string

Default Value

NULL

Pattern value

.*

Description

Filter for user topics, with regular expression matching syntax as specified in the Connext DDS documentation (similar to the POSIX fnmatch syntax).

Related to these features

Monitor

rti.monitor.config.verbosity

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

1

Min-Max value

[-1,INT_MAX]

Description

Sets the verbosity on the monitoring library for debugging purposes.

Related to these features

Monitor
Logging

rti.monitor.config.writer_pool_buffer_max_size

May be set in

DomainParticipant

Applies to

DomainParticipant

Type

integer

Default Value

-1

Min-Max value

[-1,INT_MAX]

Description

Controls the threshold at which dynamic memory allocation is used, expressed as a number of bytes.

Related to these features

Monitor