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)