GDB/MI Heterogeneous Dispatch Information (Debugging with ROCGDB)

Next: GDB/MI Ada Exception Information, Previous: GDB/MI Heterogeneous Queue Information, Up: GDB/MI Output Records [Contents][Index]

#### 28.5.9 GDB/MI Heterogeneous Dispatch Information

Whenever ROCGDB has to report information about a heterogeneous dispatch (see Heterogeneous Debugging), it uses a tuple with the following fields. The fields are always present unless stated otherwise.

`id`

  The qualified heterogeneous dispatch ID. See qualified heterogeneous entity numbers.

`queue-id`

  The qualified heterogeneous queue ID with which the heterogeneous dispatch is associated. See qualified heterogeneous entity numbers.

`target-id`

  The target-specific string identifying the heterogeneous dispatch.

`details`

  Additional information about the heterogeneous dispatch provided by the target. It is supposed to be human-readable and not interpreted by the frontend. This field is optional.

`grid`

  A list of the x, y, and z heterogeneous grid dimensions, in that order, in terms of work-items of the heterogeneous dispatch. The number of elements matches the dimensionality of the heterogeneous dispatch.

`workgroup`

  A list of the x, y, and z heterogeneous work-group dimensions, in that order in terms of work-items of the heterogeneous dispatch. The number of elements matches the dimensionality of the heterogeneous dispatch.

`fences`

  A list of the fences associated with the heterogeneous dispatch packet. The kinds of fences are target architecture dependent. Each fence is a tuple with the following fields:

  `name`

    The name of the fence.

  `value`

    The value of the fence. This field is optional. If omitted then the fence is present if in the list.

  `abbrev`

    An abbreviation that can be used to display the fence and its value. This field is optional.

`address-spaces`

  A list of address spaces associated with the heterogeneous dispatch packet. The address spaces are target architecture dependent. Each address space is a tuple with the following fields:

  `name`

    The name of the address space.

  `size`

    The size in bytes of the address space.

  `abbrev`

    An abbreviation that can be used to display the address space. This field is optional.

`kernel-desc`

  The global memory address of the kernel descriptor for the heterogeneous dispatch. The descriptor is target architecture dependent.

`kernel-args`

  The global memory address of the kernel arguments for the heterogeneous dispatch.

`completion`

  The global memory address of the completion event for the heterogeneous dispatch. Omitted if the heterogeneous dispatch has no completion event. The event is target architecture and operating system dependent.

`kernel-function`

  The global memory address of the kernel function entry point for the heterogeneous dispatch.

Next: GDB/MI Ada Exception Information, Previous: GDB/MI Heterogeneous Queue Information, Up: GDB/MI Output Records [Contents][Index]