4.1.1. Participants¶
Participants is a command that retrieves information of the DomainParticipants currently active in the network.
4.1.1.1. Key-words¶
These are the key-words recognize as this command:
participant
participants
p
P
.
4.1.1.2. Arguments¶
Participants command support 0 or 1 argument:
4.1.1.2.1. No argument¶
When no arguments are given to this command, the information shown is a list with every participant currently active in the network, giving their Guid and names. The output format is as follows: Simple Participant info.
4.1.1.2.2. Verbose¶
This argument queries for more complete information about each of the DomainParticipants in the network. It adds the information about endpoints and the topics they communicate in of each of the participants. The output got is a list of data with verbose information. Check the verbose section in order to know which key-words are available for this argument.
4.1.1.2.3. Guid¶
This argument requires a string with Guid format. This command queries the database for a single DomainParticipant and retrieves its verbose information. This Guid must exist inside the DDS network.
Note
If you are using eProsima Fast DDS Spy as one-shot application, you will need to put GUID in quotes.
4.1.1.3. Output Format¶
The participant information is retrieved in 2 formats depending on the verbose option.
4.1.1.3.1. Simple Participant info¶
name: <participant name>
guid: <guid>
4.1.1.3.2. Verbose Participant info¶
name: <participant name>
guid: <guid>
datawriters:
- <topic name> [<topic data type name>] (<number of datawriters>)
- ...
datareaders:
- <topic name> [<topic data type name>] (<number of datareaders>)
- ...
4.1.1.4. Example¶
Let’s assume we have a DDS network where 2 ShapesDemo applications are running.
This would be the expected output for the command participants
:
- name: Fast DDS ShapesDemo Participant
guid: 01.0f.44.59.21.58.14.d2.00.00.00.00|0.0.1.c1
- name: Fast DDS ShapesDemo Participant
guid: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.1.c1
- ...
This would be the expected output for the command participants verbose
:
- name: Fast DDS ShapesDemo Participant
guid: 01.0f.44.59.21.58.14.d2.00.00.00.00|0.0.1.c1
datawriters:
- Triangle [ShapeType] (1)
datareaders:
- Square [ShapeType] (1)
- name: Fast DDS ShapesDemo Participant
guid: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.1.c1
datawriters:
- Square [ShapeType] (2)
- Circle [ShapeType] (1)
- ...
This would be the expected output for the command participants 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.1.c1
:
name: Fast DDS ShapesDemo Participant
guid: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.1.c1
datawriters:
- Square [ShapeType] (2)
- Circle [ShapeType] (1)