---

28.5.9 GDB/MI Heterogeneous Dispatch Information

Whenever ROCGDB has to report information about a heterogeneous dispatch (see Debugging Heterogeneous Programs), 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.