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.
idThe qualified heterogeneous dispatch ID. See qualified heterogeneous entity numbers.
queue-idThe qualified heterogeneous queue ID with which the heterogeneous dispatch is associated. See qualified heterogeneous entity numbers.
target-idThe target-specific string identifying the heterogeneous dispatch.
detailsAdditional 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.
gridA 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.
workgroupA 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.
fencesA 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:
nameThe name of the fence.
valueThe value of the fence. This field is optional. If omitted then the fence is present if in the list.
abbrevAn abbreviation that can be used to display the fence and its value. This field is optional.
address-spacesA 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:
nameThe name of the address space.
sizeThe size in bytes of the address space.
abbrevAn abbreviation that can be used to display the address space. This field is optional.
kernel-descThe global memory address of the kernel descriptor for the heterogeneous dispatch. The descriptor is target architecture dependent.
kernel-argsThe global memory address of the kernel arguments for the heterogeneous dispatch.
completionThe 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-functionThe global memory address of the kernel function entry point for the heterogeneous dispatch.