4.2.1. Show

This command prints every User Data received in a human readable way. The information shown with this command is real-time data that is being received by Fast DDS Spy. In order to stop the command, press enter and the CLI will finish showing the data received.

Note

This is a real-time command that will not stop until enter is pressed.

4.2.1.1. Key-words

These are the key-words recognize as this command: show print s S.

4.2.1.2. Data Type discovered

In order for a Topic to be printable by the application, the Fast DDS Spy requires to know the data type of such topic. The information whether the topic data type is already discovered be the application can be shown by using Topic command.

4.2.1.3. Arguments

Show command support different combination of arguments:

4.2.1.3.1. Topic name

When a topic name is given, the information shown is the data received in real-time in the topic specified. The output format is as follows: Simple Data format.

4.2.1.3.2. Topic name + Verbose

Giving a topic name and the the verbose argument the output is the data received in real-time with additional meta-information as the topic name, the source timestamp, and the source DataWriter Guid. Data is printing using Verbose Data format.

4.2.1.3.3. All

This argument prints all topics which Data Type has been discovered. Data is printing using Verbose Data format.

4.2.1.4. Output Format

Note

The format of the data printed is not YAML. The correct YAML format will come in future releases.

The data information is retrieved in 2 formats depending on the verbose option.

4.2.1.4.1. Simple Data format

Only shows the data, by

---
<field name>: <value>
...
---

4.2.1.4.2. Verbose Data format

topic: <topic name> [<topic data type name>]
data: <Guid>
timestamp: <YYYY/MM/DD hh:mm:ss>
data:
---
<field name>: <value>
...
---

4.2.1.5. Example

Let’s assume we have a DDS network where 2 ShapesDemo applications are running.

This would be the expected output for the command show Circle:

---
color: GREEN
x: 168
y: 125
shapesize: 30
---

---
color: GREEN
x: 173
y: 121
shapesize: 30
---

...

This would be the expected output for the command show Circle verbose:

topic: Circle [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.6.2
timestamp: 2023/03/27 09:35:23
data:
---
color: GREEN
x: 72
y: 125
shapesize: 30
---

topic: Circle [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.6.2
timestamp: 2023/03/27 09:35:24
data:
---
color: GREEN
x: 66
y: 120
shapesize: 30
---

...

This would be the expected output for the command datas 01.0f.22.ba.3b.47.ab.3c.00.00.00.00|0.0.1.c1:

topic: Square [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.2.2
timestamp: 2023/03/27 09:35:25
data:
---
color: BLUE
x: 158
y: 70
shapesize: 20
---

topic: Triangle [ShapeType]
data: 01.0f.44.59.21.58.14.d2.00.00.00.00|0.0.1.2
timestamp: 2023/03/27 09:35:26
data:
---
color: YELLOE
x: 93
y: 75
shapesize: 25
---

...