RTI Connext C API Version 7.3.0

Type representing a list of multicast mapping elements. More...

Data Fields

char * addresses
 A string containing a comma-separated list of IP addresses or IP address ranges to be used to receive multicast traffic for the entity with a topic that matches the DDS_TransportMulticastMapping_t::topic_expression. More...
 
char * topic_expression
 A regular expression that will be used to map topic names to corresponding multicast receive addresses. More...
 
struct DDS_TransportMulticastMappingFunction_t mapping_function
 Specifies a function that will define the mapping between a topic name and a specific multicast address from a list of addresses. More...
 

Detailed Description

Type representing a list of multicast mapping elements.

A multicast mapping element specifies a string containing a list of IP addresses, a topic expression and a mapping function.

QoS:
DDS_TransportMulticastMappingQosPolicy

Field Documentation

◆ addresses

char* DDS_TransportMulticastMapping_t::addresses

A string containing a comma-separated list of IP addresses or IP address ranges to be used to receive multicast traffic for the entity with a topic that matches the DDS_TransportMulticastMapping_t::topic_expression.

The string must contain IPv4 or IPv6 addresses separated by commas. For example: "239.255.100.1,239.255.100.2,239.255.100.3"

You may specify ranges of addresses by enclosing the start address and the end address in square brackets. For example: "[239.255.100.1,239.255.100.3]"

You may combine the two approaches. For example:

"239.255.200.1,[239.255.100.1,239.255.100.3], 239.255.200.3"

IPv4 addresses must be specified in Dot-decimal notation.

IPv6 addresses must be specified using 8 groups of 16-bit hexadecimal values separated by colons. For example: FF00:0000:0000:0000:0202:B3FF:FE1E:8329

Leading zeroes can be skipped. For example: "FF00:0:0:0:202:B3FF:FE1E:8329"

You may replace a consecutive number of zeroes with a double colon, but only once within an address. For example: "FF00::202:B3FF:FE1E:8329"

[default] NULL

◆ topic_expression

char* DDS_TransportMulticastMapping_t::topic_expression

A regular expression that will be used to map topic names to corresponding multicast receive addresses.

A topic name must match the expression before a corresponding address is assigned.

[default] NULL

◆ mapping_function

struct DDS_TransportMulticastMappingFunction_t DDS_TransportMulticastMapping_t::mapping_function

Specifies a function that will define the mapping between a topic name and a specific multicast address from a list of addresses.

This function is optional. If not specified, the middleware will use a hash function to perform the mapping.