Examples

Default Behavior

./rtiddsspy

RTI Connext DDS Spy
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

12:12:29 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType"
12:32:18 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"
12:32:18 Modified instance from 192.168.43.223  : topic="Circle" type="ShapeType"

---- Statistics ----
Discovered 1 DataWriters and 0 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Sample Display Options

There are two options to display the sample information.

Plain (Default)

This is the default option. It pretty-prints sample information for best readability.

./rtiddsspy -printSample PLAIN

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

12:12:29 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType"
12:35:24 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"
color: "BLUE"
x: 53
y: 190
shapesize: 30
fillKind: SOLID_FILL
angle: 0

12:35:24 Modified instance from 192.168.43.223  : topic="Circle" type="ShapeType"
color: "BLUE"
x: 54
y: 195
shapesize: 30
fillKind: SOLID_FILL
angle: 0

---- Statistics ----
Discovered 1 DataWriters and 0 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Compact

This option prints sample information in a single line using a JSON format.

./rtiddsspy -printSample COMPACT

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

12:12:29 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType"
12:38:15 New data          from 192.168.43.223  : topic="Circle" type="ShapeType" sample={"color":"BLUE","x":202,"y":175,"shapesize":30,"fillKind":"SOLID_FILL","angle":0}
12:38:15 Modified instance from 192.168.43.223  : topic="Circle" type="ShapeType" sample={"color":"BLUE","x":203,"y":180,"shapesize":30,"fillKind":"SOLID_FILL","angle":0}

---- Statistics ----
Discovered 1 DataWriters and 0 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Discovery vs. User Modes

By default, rtiddsspy prints both discovery and user data together; however, you can choose to print either discovery or user data.

Discovery Mode

Use -mode DISC to print just discovery data and leave out user data. This mode forces the -showEntityName, -showHandle, and -showPartition arguments.

./rtiddsspy -mode DISC

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:26:17 New reader        from 192.168.43.223  : topic="Circle" type="ShapeType" guid="0x0101CEB8,0x3426926B,0xA577212D:0x80000004" partition="A, B, C" name="roleName:testDataReader"
13:26:15 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType" guid="0x0101A438,0xBAE7B797,0x5443C840:0x80000003" partition="A, E, I" name="roleName:testDataWriter"
13:29:22 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType" guid="0x0101B1F3,0xE6C768BE,0xFB33BCF3:0x80000003" partition="D, F, G" name="roleName:testDataWriter"


---- Statistics ----
Discovered 2 DataWriters and 1 DataReaders

User Mode

Use -mode USER to print user data and leave out discovery data. This mode forces the -printSample argument.

./rtiddsspy -mode USER

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

15:14:37 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"
color: "BLUE"
x: 53
y: 190
shapesize: 30
fillKind: SOLID_FILL
angle: 0

15:14:38 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"
color: "BLUE"
x: 54
y: 195
shapesize: 30
fillKind: SOLID_FILL
angle: 0

---- Statistics ----
Discovered 2 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Additional Display Options

This example uses arguments that print all of the extra information related to discovery and user data.

./rtiddsspy -showEntityName -showPartition -showHandle -showSampleIdentity -showSampleFlags -printSample COMPACT

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:26:17 New reader        from 192.168.43.223  : topic="Circle" type="ShapeType" guid="0x0101CEB8,0x3426926B,0xA577212D:0x80000004" name="roleName:testDataReader" partition="A, B, C"
13:26:15 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType" guid="0x0101A438,0xBAE7B797,0x5443C840:0x80000003" name="roleName:testDataWriter" partition="A, E, I"
15:41:09 New data          from 192.168.43.223  : topic="Circle" type="ShapeType" virtual_guid="0x0101A438,0xBAE7B797,0x5443C840:0x80000003" virtual_sn="(0, 8093)" name="roleName:testDataWriter" partition="A, E, I" sample={"color":"BLUE","x":202,"y":175,"shapesize":30,"fillKind":"SOLID_FILL","angle":0}
15:41:10 New data          from 192.168.43.223  : topic="Circle" type="ShapeType" virtual_guid="0x0101A438,0xBAE7B797,0x5443C840:0x80000003" virtual_sn="(0, 8094)" name="roleName:testDataWriter" partition="A, E, I" sample={"color":"BLUE","x":203,"y":180,"shapesize":30,"fillKind":"SOLID_FILL","angle":0}

---- Statistics ----
Discovered 1 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Filter by Topic and Type

This example uses arguments to filter discovery and user data by Topic and type.

./rtiddsspy -typeRegex "Shape*" -topicRegex "Circ*"

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:26:17 New reader        from 192.168.43.223  : topic="Circle" type="ShapeType"
13:26:15 New writer        from 192.168.43.223  : topic="Circle" type="ShapeType"
16:24:16 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"
16:24:17 New data          from 192.168.43.223  : topic="Circle" type="ShapeType"


---- Statistics ----
Discovered 1 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Circle"  Type="ShapeType")

Partitions

Display All Partitions

This example displays the partitions to which an entity belongs each time a new entity is discovered and a sample is received. (See PARTITION QosPolicy, in the RTI Connext DDS Core Libraries User’s Manual for more information on partitions.)

./rtiddsspy -showPartition

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:29:22 New writer        from 192.168.43.223  : topic="Example test" type="test" P partition="D"
13:26:15 New writer        from 192.168.43.223  : topic="Example test" type="test" P partition="A"
13:26:17 New reader        from 192.168.43.223  : topic="Example test" type="test" S partition="A"
13:29:42 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="A"
13:29:43 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="D"
13:29:43 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="A"
13:29:44 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="D"


---- Statistics ----
Discovered 2 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    4, 0, 0         (Topic="Example test"  Type="test")

Display Select Partitions

This example shows how to display data only for specified partitions. By using -subscriberPartition A, we only receive data from publishers that belong to partition A.

Although rtiddsspy first displays all discovered entities (New writer, New reader), regardless of partition, any data received (New data) is shown only for the specified partition.

./rtiddsspy -showPartition -subscriberPartition A

RTI Connext DDS Spy built with DDS version:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:29:22 New writer        from 192.168.43.223  : topic="Example test" type="test" P partition="D"
13:26:15 New writer        from 192.168.43.223  : topic="Example test" type="test" P partition="A"
13:26:17 New reader        from 192.168.43.223  : topic="Example test" type="test" S partition="A"
13:30:24 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="A"
13:30:25 New data          from 192.168.43.223  : topic="Example test" type="test" P partition="A"


---- Statistics ----
Discovered 2 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Example test"  Type="test")

By using -participantPartition A, we only receive data from Domain Participants that belong to partition A.

In this example, rtiddsspy will only display discovered entities (New writer, New reader), for the specified partition.

./rtiddsspy -showPartition -participantPartition A

RTI Connext DDS Spy built with DDS version: |CONNEXT_currentVersion|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rtiddsspy is listening for data, press CTRL+C to stop it.

13:26:15 New writer        from 192.168.43.223  : topic="Example test" type="test" DP partition="A"
13:26:17 New reader        from 192.168.43.223  : topic="Example test" type="test" DP partition="A"
13:30:24 New data          from 192.168.43.223  : topic="Example test" type="test" DP partition="A"
13:30:25 New data          from 192.168.43.223  : topic="Example test" type="test" DP partition="A"


---- Statistics ----
Discovered 1 DataWriters and 1 DataReaders
Received samples (Data, Dispose, NoWriters):
    2, 0, 0         (Topic="Example test"  Type="test")