27.11 gdb/mi Ada Tasking Commands

The -ada-task-info Command

Synopsis

      -ada-task-info [ task-id ]

Reports information about either a specific Ada task, if the task-id parameter is present, or about all Ada tasks.

gdb Command

The `info tasks' command prints the same information about all Ada tasks (see Ada Tasks).

Result

The result is a table of Ada tasks. The following columns are defined for each Ada task:

`current'

This field exists only for the current thread. It has the value `*'.

`id'

The identifier that gdb uses to refer to the Ada task.

`task-id'

The identifier that the target uses to refer to the Ada task.

`thread-id'

The identifier of the thread corresponding to the Ada task.

This field should always exist, as Ada tasks are always implemented on top of a thread. But if gdb cannot find this corresponding thread for any reason, the field is omitted.

`parent-id'

This field exists only when the task was created by another task. In this case, it provides the ID of the parent task.

`priority'

The base priority of the task.

`state'

The current state of the task. For a detailed description of the possible states, see Ada Tasks.

`name'

The name of the task.

Example

     -ada-task-info
     ^done,tasks={nr_rows="3",nr_cols="8",
     hdr=[{width="1",alignment="-1",col_name="current",colhdr=""},
     {width="3",alignment="1",col_name="id",colhdr="ID"},
     {width="9",alignment="1",col_name="task-id",colhdr="TID"},
     {width="4",alignment="1",col_name="thread-id",colhdr=""},
     {width="4",alignment="1",col_name="parent-id",colhdr="P-ID"},
     {width="3",alignment="1",col_name="priority",colhdr="Pri"},
     {width="22",alignment="-1",col_name="state",colhdr="State"},
     {width="1",alignment="2",col_name="name",colhdr="Name"}],
     body=[{current="*",id="1",task-id="   644010",thread-id="1",priority="48",
     state="Child Termination Wait",name="main_task"}]}
     (gdb)