448 #define AMD_DBGAPI_H 1 451 #if !defined(AMD_DBGAPI_CALL) 452 #define AMD_DBGAPI_CALL 455 #if !defined(AMD_DBGAPI_EXPORT_DECORATOR) 456 #if defined(__GNUC__) 457 #define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default"))) 458 #elif defined(_MSC_VER) 459 #define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport) 463 #if !defined(AMD_DBGAPI_IMPORT_DECORATOR) 464 #if defined(__GNUC__) 465 #define AMD_DBGAPI_IMPORT_DECORATOR 466 #elif defined(_MSC_VER) 467 #define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport) 471 #define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL 472 #define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL 474 #if !defined(AMD_DBGAPI) 475 #if defined(AMD_DBGAPI_EXPORTS) 476 #define AMD_DBGAPI AMD_DBGAPI_EXPORT 478 #define AMD_DBGAPI AMD_DBGAPI_IMPORT 482 #if __cplusplus >= 201103L 484 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) (type{ value }) 485 #elif __STDC_VERSION__ >= 199901L 487 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) ((type){ value }) 489 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) {value} 492 #if defined(__cplusplus) 496 #if defined(__linux__) 497 #include <sys/types.h> 522 #define AMD_DBGAPI_VERSION_0_54 528 #define AMD_DBGAPI_VERSION_0_56 534 #define AMD_DBGAPI_VERSION_0_58 540 #define AMD_DBGAPI_VERSION_0_62 546 #define AMD_DBGAPI_VERSION_0_64 552 #define AMD_DBGAPI_VERSION_0_67 558 #define AMD_DBGAPI_VERSION_0_68 564 #define AMD_DBGAPI_VERSION_0_70 625 #if defined(__linux__) 653 #if defined(__linux__) 664 #if defined(__linux__) 674 #if defined(__linux__) 686 #if defined(__linux__) 697 #if defined(__linux__) 1002 #define AMD_DBGAPI_VERSION_MAJOR 0 1008 #define AMD_DBGAPI_VERSION_MINOR 70 1110 AMD_DBGAPI_VERSION_0_54;
1141 #define AMD_DBGAPI_ARCHITECTURE_NONE \ 1142 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_architecture_id_t, 0) 1277 uint32_t elf_amdgpu_machine,
1383 amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,
1384 const void *memory,
char **instruction_text,
1385 amd_dbgapi_symbolizer_id_t symbolizer_id,
1387 amd_dbgapi_symbolizer_id_t symbolizer_id,
1388 amd_dbgapi_global_address_t address,
1594 amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,
1640 #define AMD_DBGAPI_PROCESS_NONE \ 1641 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_process_id_t, 0) 1822 amd_dbgapi_client_process_id_t client_process_id,
2033 #define AMD_DBGAPI_CODE_OBJECT_NONE \ 2034 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_code_object_id_t, 0) 2234 #define AMD_DBGAPI_AGENT_NONE \ 2235 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_agent_id_t, 0) 2466 #define AMD_DBGAPI_QUEUE_NONE \ 2467 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_queue_id_t, 0) 2809 amd_dbgapi_os_queue_packet_id_t *read_packet_id,
2810 amd_dbgapi_os_queue_packet_id_t *write_packet_id,
2839 #define AMD_DBGAPI_DISPATCH_NONE \ 2840 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_dispatch_id_t, 0) 3106 #define AMD_DBGAPI_WORKGROUP_NONE \ 3107 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_workgroup_id_t, 0) 3284 #define AMD_DBGAPI_WAVE_NONE \ 3285 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_wave_id_t, 0) 4088 #define AMD_DBGAPI_DISPLACED_STEPPING_NONE \ 4089 (amd_dbgapi_displaced_stepping_id_t{ 0 }) 4333 #define AMD_DBGAPI_WATCHPOINT_NONE \ 4334 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_watchpoint_id_t, 0) 4593 #define AMD_DBGAPI_REGISTER_CLASS_NONE \ 4594 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_class_id_t, 0) 4723 #define AMD_DBGAPI_REGISTER_NONE \ 4724 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_id_t, 0) 5212 amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5278 amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5395 #define AMD_DBGAPI_LANE_NONE ((amd_dbgapi_lane_id_t) (-1)) 5418 #define AMD_DBGAPI_ADDRESS_CLASS_NONE \ 5419 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_class_id_t, 0) 5603 #define AMD_DBGAPI_ADDRESS_SPACE_NONE \ 5604 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 0) 5612 #define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL \ 5613 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 1) 5938 amd_dbgapi_segment_address_t source_segment_address,
5940 amd_dbgapi_segment_address_t *destination_segment_address,
5941 amd_dbgapi_size_t *destination_contiguous_bytes)
6017 amd_dbgapi_segment_address_t segment_address,
6113 amd_dbgapi_segment_address_t segment_address,
6218 amd_dbgapi_lane_id_t lane_id,
6220 amd_dbgapi_segment_address_t segment_address,
6323 amd_dbgapi_lane_id_t lane_id,
6325 amd_dbgapi_segment_address_t segment_address,
6441 #define AMD_DBGAPI_EVENT_NONE \ 6442 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_event_id_t, 0) 6842 #define AMD_DBGAPI_BREAKPOINT_NONE \ 6843 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_breakpoint_id_t, 0) 6968 amd_dbgapi_client_thread_id_t client_thread_id,
6991 void *(*allocate_memory) (
size_t byte_size);
7039 amd_dbgapi_client_process_id_t client_process_id,
7040 amd_dbgapi_os_process_id_t *os_pid);
7078 amd_dbgapi_client_process_id_t client_process_id,
7079 amd_dbgapi_global_address_t address,
7113 amd_dbgapi_client_process_id_t client_process_id,
7129 #if defined(__cplusplus) Queue supports the AMD PM4 protocol.
Definition: amd-dbgapi.h:711
const char AMD_DBGAPI * amd_dbgapi_get_build_name(void) AMD_DBGAPI_VERSION_0_54
Query the installed library build name.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_classify_instruction(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size, const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind, amd_dbgapi_instruction_properties_t *instruction_properties, void **instruction_information) AMD_DBGAPI_VERSION_0_58
Classify a single instruction.
Opaque agent handle.
Definition: amd-dbgapi.h:2226
Return the event kind.
Definition: amd-dbgapi.h:6636
The wave stopped due to executing an assert trap instruction.
Definition: amd-dbgapi.h:3604
uint64_t amd_dbgapi_global_address_t
Integral type used for a global virtual memory address in the inferior process.
Definition: amd-dbgapi.h:596
void(* deallocate_memory)(void *data)
Deallocate memory that was allocated by amd_dbgapi_callbacks_s::allocate_memory.
Definition: amd-dbgapi.h:7009
The wave stopped due to detecting an unrecoverable ECC error.
Definition: amd-dbgapi.h:3667
uint64_t handle
Definition: amd-dbgapi.h:6435
uint64_t handle
Definition: amd-dbgapi.h:1135
Return the dispatch grid size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:2905
The address space is only read the waves of a kernel dispatch.
Definition: amd-dbgapi.h:5634
A set of watchpoints.
Definition: amd-dbgapi.h:4464
The wave stopped due to a memory violation.
Definition: amd-dbgapi.h:3630
The wave stopped due to triggering an enabled floating point invalid operation exception.
Definition: amd-dbgapi.h:3565
There are no properties.
Definition: amd-dbgapi.h:4737
A wave waits for memory instructions to complete before executing further instructions.
Definition: amd-dbgapi.h:6357
The client process handle is invalid.
Definition: amd-dbgapi.h:943
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize(amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_54
Initialize the library.
uint64_t amd_dbgapi_os_queue_id_t
Native operating system queue ID.
Definition: amd-dbgapi.h:675
An invalid argument was given to the function.
Definition: amd-dbgapi.h:784
uint64_t handle
Definition: amd-dbgapi.h:4327
Opaque displaced stepping handle.
Definition: amd-dbgapi.h:4080
Print fatal error messages.
Definition: amd-dbgapi.h:6769
There is a fence with system memory scope.
Definition: amd-dbgapi.h:3026
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_class_get_info(amd_dbgapi_address_class_id_t address_class_id, amd_dbgapi_address_class_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_62
Query information about a source language address class of an architecture.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_stop(amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_54
Request a wave to stop executing.
The segment address cannot be converted to the requested address space.
Definition: amd-dbgapi.h:927
The instruction causes the wave to stop executing for some period of time, before continuing executio...
Definition: amd-dbgapi.h:1495
amd_dbgapi_wave_creation_t
The kinds of wave creation supported by the hardware.
Definition: amd-dbgapi.h:1959
Reading or writing the segment address depends on the wavefront.
Definition: amd-dbgapi.h:5962
Queue is in a valid state.
Definition: amd-dbgapi.h:2576
Opaque queue handle.
Definition: amd-dbgapi.h:2458
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_next_pending_event(amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id, amd_dbgapi_event_kind_t *kind) AMD_DBGAPI_VERSION_0_54
Obtain the next pending event.
Watchpoints are not supported.
Definition: amd-dbgapi.h:4415
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_queue_list(amd_dbgapi_process_id_t process_id, size_t *queue_count, amd_dbgapi_queue_id_t **queues, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54
Return the list of queues.
Print fatal error and warning messages.
Definition: amd-dbgapi.h:6773
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_class_get_info(amd_dbgapi_register_class_id_t register_class_id, amd_dbgapi_register_class_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a register class of an architecture.
The inferior's runtime has been unloaded.
Definition: amd-dbgapi.h:6610
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_report_breakpoint_hit(amd_dbgapi_breakpoint_id_t breakpoint_id, amd_dbgapi_client_thread_id_t client_thread_id, amd_dbgapi_breakpoint_action_t *breakpoint_action) AMD_DBGAPI_VERSION_0_54
Report that a breakpoint inserted by the amd_dbgapi_callbacks_s::insert_breakpoint callback has been ...
Opaque process handle.
Definition: amd-dbgapi.h:1632
Read access by load instructions.
Definition: amd-dbgapi.h:4441
The instruction classification is unknown.
Definition: amd-dbgapi.h:1400
Native operating system queue ID.
Definition: amd-dbgapi.h:2523
The register value may change as a consequence of changing a register of the same wavefront with the ...
Definition: amd-dbgapi.h:4750
The instruction terminates the wave execution.
Definition: amd-dbgapi.h:1463
The number of lanes supported by the wave.
Definition: amd-dbgapi.h:3401
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_code_object_get_info(amd_dbgapi_code_object_id_t code_object_id, amd_dbgapi_code_object_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a code object.
amd_dbgapi_breakpoint_action_t
The action to perform after reporting a breakpoint has been hit.
Definition: amd-dbgapi.h:6906
Return how watchpoints are shared between processes.
Definition: amd-dbgapi.h:1667
Return the architecture of this dispatch.
Definition: amd-dbgapi.h:2869
Return the source language address class name.
Definition: amd-dbgapi.h:5436
There is a fence with agent memory scope.
Definition: amd-dbgapi.h:3022
The address space is read only.
Definition: amd-dbgapi.h:5629
amd_dbgapi_wave_state_t
The execution state of a wave.
Definition: amd-dbgapi.h:3457
#define AMD_DBGAPI_VERSION_0_56
The function was introduced in version 0.56 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:528
Return the dispatch workgroup size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:2900
uint32_t amd_dbgapi_lane_id_t
A wave lane handle.
Definition: amd-dbgapi.h:5390
Return the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture.
Definition: amd-dbgapi.h:1167
There is no fence.
Definition: amd-dbgapi.h:3018
The wave is running in single-step mode.
Definition: amd-dbgapi.h:3467
amd_dbgapi_changed_t
Indication of if a value has changed.
Definition: amd-dbgapi.h:606
The wave is stopped.
Definition: amd-dbgapi.h:865
amd_dbgapi_register_exists_t
Indication of if a wave has a register.
Definition: amd-dbgapi.h:4912
The wave's number in the workgroup.
Definition: amd-dbgapi.h:3396
The wave cannot be resumed.
Definition: amd-dbgapi.h:873
The wave does not have the register.
Definition: amd-dbgapi.h:4917
Opaque register class handle.
Definition: amd-dbgapi.h:4585
uint64_t handle
Definition: amd-dbgapi.h:1634
The segment address in the address space is a member of the source language address class...
Definition: amd-dbgapi.h:6036
Return the architecture to which this register class belongs.
Definition: amd-dbgapi.h:4609
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_space_get_info(amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_address_space_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_62
Query information about an address space.
amd_dbgapi_agent_info_t
Agent queries that are supported by amd_dbgapi_agent_get_info.
Definition: amd-dbgapi.h:2243
amd_dbgapi_dispatch_barrier_t
Dispatch barrier.
Definition: amd-dbgapi.h:2994
Return the size of the register in bytes.
Definition: amd-dbgapi.h:4784
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_disassemble_instruction(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size, const void *memory, char **instruction_text, amd_dbgapi_symbolizer_id_t symbolizer_id, amd_dbgapi_status_t(*symbolizer)( amd_dbgapi_symbolizer_id_t symbolizer_id, amd_dbgapi_global_address_t address, char **symbol_text)) AMD_DBGAPI_VERSION_0_54
Disassemble a single instruction.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_dispatch_list(amd_dbgapi_process_id_t process_id, size_t *dispatch_count, amd_dbgapi_dispatch_id_t **dispatches, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54
Return the list of dispatches.
The wave has an active displaced stepping buffer.
Definition: amd-dbgapi.h:886
A dispatch packet on the queue has an invalid workgroup size.
Definition: amd-dbgapi.h:2667
No more watchpoints available.
Definition: amd-dbgapi.h:899
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_watchpoint(amd_dbgapi_process_id_t process_id, amd_dbgapi_global_address_t address, amd_dbgapi_size_t size, amd_dbgapi_watchpoint_kind_t kind, amd_dbgapi_watchpoint_id_t *watchpoint_id) AMD_DBGAPI_VERSION_0_62
Set a hardware data watchpoint.
Opaque hardware data watchpoint handle.
Definition: amd-dbgapi.h:4325
amd_dbgapi_wave_stop_reasons_t
A bit mask of the reasons that a wave stopped.
Definition: amd-dbgapi.h:3489
Return the wave of a AMD_DBGAPI_EVENT_KIND_WAVE_STOP or AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED...
Definition: amd-dbgapi.h:6642
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_watchpoint_get_info(amd_dbgapi_watchpoint_id_t watchpoint_id, amd_dbgapi_watchpoint_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a watchpoint.
uint64_t handle
Definition: amd-dbgapi.h:6836
Return the breakpoint of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition: amd-dbgapi.h:6647
Print no messages.
Definition: amd-dbgapi.h:6764
Return the architecture of this wave.
Definition: amd-dbgapi.h:3359
Changing the value of the register may change a register of the same wavefront with the AMD_DBGAPI_RE...
Definition: amd-dbgapi.h:4757
Opaque workgroup handle.
Definition: amd-dbgapi.h:3098
amd_dbgapi_log_level_t
The logging levels supported.
Definition: amd-dbgapi.h:6759
Return the process to which this code object belongs.
Definition: amd-dbgapi.h:2048
The byte size of the created watchpoint.
Definition: amd-dbgapi.h:4358
The watchpoint handle is invalid.
Definition: amd-dbgapi.h:895
Return the dispatch to which this workgroup belongs.
Definition: amd-dbgapi.h:3126
No forward progress is needed.
Definition: amd-dbgapi.h:1917
uint64_t amd_dbgapi_os_agent_id_t
Native operating system agent ID.
Definition: amd-dbgapi.h:665
PCI slot of the agent in BDF format (see [Bus:Device.Function (BDF) Notation][bfd].
Definition: amd-dbgapi.h:2280
The instruction enters the trap handler.
Definition: amd-dbgapi.h:1477
The function has executed successfully.
Definition: amd-dbgapi.h:740
The value has changed.
Definition: amd-dbgapi.h:615
Read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:4450
The wave stopped due to executing a breakpoint instruction.
Definition: amd-dbgapi.h:3501
The instruction has some form of special behavior not covered by any of the other instruction kinds...
Definition: amd-dbgapi.h:1504
The wave is not stopped.
Definition: amd-dbgapi.h:861
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_architecture(uint32_t elf_amdgpu_machine, amd_dbgapi_architecture_id_t *architecture_id) AMD_DBGAPI_VERSION_0_54
Get an architecture from the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture...
A wave on the queue executed an illegal instruction.
Definition: amd-dbgapi.h:2636
amd_dbgapi_queue_state_t
Queue state.
Definition: amd-dbgapi.h:2571
Return the agent to which this workgroup belongs.
Definition: amd-dbgapi.h:3136
Queue supports the AMD SDMA protocol.
Definition: amd-dbgapi.h:715
The code object handle is invalid.
Definition: amd-dbgapi.h:828
The wave stopped due to triggering a data watchpoint.
Definition: amd-dbgapi.h:3513
Return the dispatch barrier setting.
Definition: amd-dbgapi.h:2880
#define AMD_DBGAPI_VERSION_0_54
The function was introduced in version 0.54 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:522
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_status_string(amd_dbgapi_status_t status, const char **status_string) AMD_DBGAPI_VERSION_0_54
Query a textual description of a status code.
The inferior's runtime has put a queue into the queue error state due to exceptions being reported fo...
Definition: amd-dbgapi.h:6555
amd_dbgapi_event_info_t
Event queries that are supported by amd_dbgapi_event_get_info.
Definition: amd-dbgapi.h:6625
amd_dbgapi_runtime_state_t
Inferior's runtime state.
Definition: amd-dbgapi.h:6600
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize(void) AMD_DBGAPI_VERSION_0_54
Finalize the library.
Resume execution.
Definition: amd-dbgapi.h:6911
PCI vendor ID of the agent.
Definition: amd-dbgapi.h:2284
The list of code objects has changed.
Definition: amd-dbgapi.h:6493
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dwarf_address_space_to_address_space(amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space, amd_dbgapi_address_space_id_t *address_space_id) AMD_DBGAPI_VERSION_0_54
Return the address space from an AMD GPU DWARF address space number for an architecture.
Return the wave's state.
Definition: amd-dbgapi.h:3299
Return the dispatch release fence.
Definition: amd-dbgapi.h:2890
The requested information is not available.
Definition: amd-dbgapi.h:776
Return the queue to which this wave belongs.
Definition: amd-dbgapi.h:3344
The instruction unconditionally branches to a literal address.
Definition: amd-dbgapi.h:1412
uint64_t handle
Definition: amd-dbgapi.h:3100
The breakpoint handle is invalid.
Definition: amd-dbgapi.h:935
Return the reason the wave stopped as a bit set.
Definition: amd-dbgapi.h:3306
The library is already initialized.
Definition: amd-dbgapi.h:792
amd_dbgapi_code_object_info_t
Code object queries that are supported by amd_dbgapi_code_object_get_info.
Definition: amd-dbgapi.h:2042
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_exists(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_register_exists_t *exists) AMD_DBGAPI_VERSION_0_54
Query if a register exists for a wave.
Return the agent to which this queue belongs.
Definition: amd-dbgapi.h:2481
amd_dbgapi_status_t(* insert_breakpoint)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_global_address_t address, amd_dbgapi_breakpoint_id_t breakpoint_id)
Insert a breakpoint in a shared library using a global address.
Definition: amd-dbgapi.h:7077
#define AMD_DBGAPI_VERSION_0_70
The function was introduced in version 0.70 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:564
int amd_dbgapi_notifier_t
Type used to notify the client of the library that a process may have pending events.
Definition: amd-dbgapi.h:654
The instruction unconditionally branches to an address held in a pair of registers.
Definition: amd-dbgapi.h:1427
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_is_in_address_class(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id, amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_segment_address_t segment_address, amd_dbgapi_address_class_id_t address_class_id, amd_dbgapi_address_class_state_t *address_class_state) AMD_DBGAPI_VERSION_0_54
Determine if a segment address in an address space is a member of a source language address class...
#define AMD_DBGAPI
Definition: amd-dbgapi.h:478
A command for a wave was not able to complete because the wave has terminated.
Definition: amd-dbgapi.h:6471
Return the byte size of an address in the address space.
Definition: amd-dbgapi.h:5657
Agent name.
Definition: amd-dbgapi.h:2255
The lane handle is invalid.
Definition: amd-dbgapi.h:911
void AMD_DBGAPI amd_dbgapi_set_log_level(amd_dbgapi_log_level_t level) AMD_DBGAPI_VERSION_0_54
Set the logging level.
The wave handle is invalid.
Definition: amd-dbgapi.h:857
Opaque code object handle.
Definition: amd-dbgapi.h:2025
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_wave_list(amd_dbgapi_process_id_t process_id, size_t *wave_count, amd_dbgapi_wave_id_t **waves, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54
Return the list of existing waves.
Return the agent state.
Definition: amd-dbgapi.h:2270
amd_dbgapi_address_class_state_t
Indication of whether a segment address in an address space is a member of an source language address...
Definition: amd-dbgapi.h:6025
Return the AMD GPU DWARF address space number for the address space's architecture.
Definition: amd-dbgapi.h:5672
amd_dbgapi_address_class_info_t
Source language address class queries that are supported by amd_dbgapi_address_class_get_info.
Definition: amd-dbgapi.h:5428
uint64_t handle
Definition: amd-dbgapi.h:4082
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dwarf_register_to_register(amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register, amd_dbgapi_register_id_t *register_id) AMD_DBGAPI_VERSION_0_54
Return a register handle from an AMD GPU DWARF register number for an architecture.
The wave stopped due to triggering an enabled floating point divide by zero exception.
Definition: amd-dbgapi.h:3533
Return the address space access.
Definition: amd-dbgapi.h:5667
PCI domain the agent is in.
Definition: amd-dbgapi.h:2274
The register class handle is invalid.
Definition: amd-dbgapi.h:903
If none of the bits are set, then amd_dbgapi_wave_stop stopped the wave.
Definition: amd-dbgapi.h:3495
Return the dispatch completion event address.
Definition: amd-dbgapi.h:2940
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_class_list(amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count, amd_dbgapi_register_class_id_t **register_classes) AMD_DBGAPI_VERSION_0_54
Report the list of register classes supported by the architecture.
Return the architecture of this workgroup.
Definition: amd-dbgapi.h:3146
amd_dbgapi_register_class_state_t
Indication of whether a register is a member of a register class.
Definition: amd-dbgapi.h:5099
The instruction unconditionally halts the wave.
Definition: amd-dbgapi.h:1482
Return the number of data watchpoints supported by the process.
Definition: amd-dbgapi.h:1661
uint64_t handle
Definition: amd-dbgapi.h:4587
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_breakpoint_get_info(amd_dbgapi_breakpoint_id_t breakpoint_id, amd_dbgapi_breakpoint_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a breakpoint.
amd_dbgapi_watchpoint_kind_t
Watchpoint memory access kinds.
Definition: amd-dbgapi.h:4436
The notifier for the process that indicates if pending events are available.
Definition: amd-dbgapi.h:1655
void(* log_message)(amd_dbgapi_log_level_t level, const char *message)
Report a log message.
Definition: amd-dbgapi.h:7124
The wave stopped due to triggering an enabled floating point overflow exception.
Definition: amd-dbgapi.h:3541
Return the dispatch acquire fence.
Definition: amd-dbgapi.h:2885
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_code_object_list(amd_dbgapi_process_id_t process_id, size_t *code_object_count, amd_dbgapi_code_object_id_t **code_objects, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54
Return the list of loaded code objects.
Opaque event handle.
Definition: amd-dbgapi.h:6433
The runtime support in the inferior is enabled or disabled.
Definition: amd-dbgapi.h:6521
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_attach(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_process_id_t *process_id) AMD_DBGAPI_VERSION_0_56
Attach to a process in order to provide debug control of the AMD GPUs it uses.
Normal progress is needed.
Definition: amd-dbgapi.h:1893
amd_dbgapi_watchpoint_id_t * watchpoint_ids
Definition: amd-dbgapi.h:4467
Return the process to which this breakpoint belongs.
Definition: amd-dbgapi.h:6857
A wave on the queue executed a trap instruction used to abort a dispatch.
Definition: amd-dbgapi.h:2606
Return the dispatch to which this wave belongs.
Definition: amd-dbgapi.h:3339
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_prefetch_register(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t register_count) AMD_DBGAPI_VERSION_0_62
Prefetch register values.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_convert_address_space(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id, amd_dbgapi_address_space_id_t source_address_space_id, amd_dbgapi_segment_address_t source_segment_address, amd_dbgapi_address_space_id_t destination_address_space_id, amd_dbgapi_segment_address_t *destination_segment_address, amd_dbgapi_size_t *destination_contiguous_bytes) AMD_DBGAPI_VERSION_0_62
Convert a source segment address in the source address space into a destination segment address in th...
An invalid combination of arguments was given to the function.
Definition: amd-dbgapi.h:788
Return the queue packet ID of the dispatch packet that initiated the dispatch.
Definition: amd-dbgapi.h:2875
amd_dbgapi_event_kind_t
The event kinds.
Definition: amd-dbgapi.h:6447
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_workgroup_list(amd_dbgapi_process_id_t process_id, size_t *workgroup_count, amd_dbgapi_workgroup_id_t **workgroups, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_64
Return the list of existing workgroups.
A dispatch packet on the queue requires too many registers.
Definition: amd-dbgapi.h:2671
Return the register class name.
Definition: amd-dbgapi.h:4616
The instruction unconditionally branches to an address held in a pair of source registers and the add...
Definition: amd-dbgapi.h:1458
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_memory(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id, amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_segment_address_t segment_address, amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_54
Read memory.
The wave has an outstanding stop request.
Definition: amd-dbgapi.h:869
The library is not initialized.
Definition: amd-dbgapi.h:796
The symbol was not found.
Definition: amd-dbgapi.h:947
Write access by store instructions or read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:4446
#define AMD_DBGAPI_VERSION_0_64
The function was introduced in version 0.64 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:546
Return the register handle for the PC for the architecture.
Definition: amd-dbgapi.h:1202
amd_dbgapi_address_space_access_t
Indication of how the address space is accessed.
Definition: amd-dbgapi.h:5618
Queue supports the AMD SDMA XGMI protocol.
Definition: amd-dbgapi.h:719
The bytes being disassembled are not a legal instruction.
Definition: amd-dbgapi.h:824
uint64_t handle
Definition: amd-dbgapi.h:2460
Reading or writing the segment address depends on the workgroup.
Definition: amd-dbgapi.h:5966
uint64_t amd_dbgapi_segment_address_t
Each address space has its own linear address to access it termed a segment address.
Definition: amd-dbgapi.h:5819
The instruction has no properties.
Definition: amd-dbgapi.h:1515
#define AMD_DBGAPI_VERSION_0_67
The function was introduced in version 0.67 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:552
A wave on the queue executed an instruction that caused an exception.
Definition: amd-dbgapi.h:2616
Return the AMD GPU DWARF register number for the register's architecture.
Definition: amd-dbgapi.h:4854
Dispatch has a barrier.
Definition: amd-dbgapi.h:3004
Return the breakpoint instruction for the architecture.
Definition: amd-dbgapi.h:1191
uint64_t amd_dbgapi_os_queue_packet_id_t
Native operating system queue packet ID.
Definition: amd-dbgapi.h:687
The value has not changed.
Definition: amd-dbgapi.h:611
The instruction conditionally branches to a literal address.
Definition: amd-dbgapi.h:1419
The URI name of the ELF shared object from which the code object was loaded.
Definition: amd-dbgapi.h:2104
Opaque address space handle.
Definition: amd-dbgapi.h:5595
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_complete(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_displaced_stepping_id_t displaced_stepping) AMD_DBGAPI_VERSION_0_54
Complete a displaced stepping buffer for a wave.
The wave stopped due to an aperture violation.
Definition: amd-dbgapi.h:3645
The ELF AMD GPU machine value is invalid or unsupported.
Definition: amd-dbgapi.h:832
The difference between the address in the ELF shared object and the address the code object is loaded...
Definition: amd-dbgapi.h:2110
The address space supports all accesses.
Definition: amd-dbgapi.h:5624
The register handle is invalid.
Definition: amd-dbgapi.h:907
The wave stopped due to executing a debug trap instruction.
Definition: amd-dbgapi.h:3588
The wave stopped due to triggering an enabled floating point inexact exception.
Definition: amd-dbgapi.h:3557
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint(amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_67
Remove a hardware data watchpoint previously set by amd_dbgapi_set_watchpoint.
Memory instructions execute normally and a wave does not wait for the memory access to complete...
Definition: amd-dbgapi.h:6352
Reading or writing the segment address depends on the process.
Definition: amd-dbgapi.h:5974
Native operating system process ID.
Definition: amd-dbgapi.h:1683
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_class_list(amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count, amd_dbgapi_address_class_id_t **address_classes) AMD_DBGAPI_VERSION_0_54
Report the list of source language address classes supported by the architecture. ...
amd_dbgapi_process_info_t
Process queries that are supported by amd_dbgapi_process_get_info.
Definition: amd-dbgapi.h:1649
Return the queue of a AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR event.
Definition: amd-dbgapi.h:6664
uint64_t handle
Definition: amd-dbgapi.h:2833
The register is not a member of the register class.
Definition: amd-dbgapi.h:5104
The address class handle is invalid.
Definition: amd-dbgapi.h:915
amd_dbgapi_workgroup_info_t
Workgroup queries that are supported by amd_dbgapi_workgroup_get_info.
Definition: amd-dbgapi.h:3115
A wave has stopped.
Definition: amd-dbgapi.h:6456
Return the process to which this dispatch belongs.
Definition: amd-dbgapi.h:2864
amd_dbgapi_architecture_info_t
Architecture queries that are supported by amd_dbgapi_architecture_get_info.
Definition: amd-dbgapi.h:1151
#define AMD_DBGAPI_VERSION_0_62
The function was introduced in version 0.62 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:540
Return the process to which this wave belongs.
Definition: amd-dbgapi.h:3354
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_packet_list(amd_dbgapi_queue_id_t queue_id, amd_dbgapi_os_queue_packet_id_t *read_packet_id, amd_dbgapi_os_queue_packet_id_t *write_packet_id, size_t *packets_byte_size, void **packets_bytes) AMD_DBGAPI_VERSION_0_54
Return the packets for a queue.
Opaque register handle.
Definition: amd-dbgapi.h:4715
Return the register's properties.
Definition: amd-dbgapi.h:4859
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_is_in_register_class(amd_dbgapi_register_class_id_t register_class_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_register_class_state_t *register_class_state) AMD_DBGAPI_VERSION_0_54
Determine if a register is a member of a register class.
amd_dbgapi_dispatch_fence_scope_t
Dispatch memory fence scope.
Definition: amd-dbgapi.h:3013
Return the architecture to which this register belongs.
Definition: amd-dbgapi.h:4772
Agent does not support debugging.
Definition: amd-dbgapi.h:2335
The watchpoints of a process are shared between all processes.
Definition: amd-dbgapi.h:4427
If none of the bits are set, then the queue is not in the error state.
Definition: amd-dbgapi.h:2602
Maximum number of waves supported by an execution unit.
Definition: amd-dbgapi.h:2298
The event handle is invalid.
Definition: amd-dbgapi.h:931
Normal wave creation allows new waves to be created.
Definition: amd-dbgapi.h:1964
Return the dispatch group segment size in bytes.
Definition: amd-dbgapi.h:2915
Return the address space name.
Definition: amd-dbgapi.h:5652
Return the size in bytes of the memory holding the queue packets.
Definition: amd-dbgapi.h:2518
pid_t amd_dbgapi_os_process_id_t
Native operating system process ID.
Definition: amd-dbgapi.h:626
Return the architecture name.
Definition: amd-dbgapi.h:1159
Return the agent to which this dispatch belongs.
Definition: amd-dbgapi.h:2859
The wave stopped due to completing an instruction single-step.
Definition: amd-dbgapi.h:3517
The displaced stepping handle is invalid.
Definition: amd-dbgapi.h:877
Resume execution in in single step mode.
Definition: amd-dbgapi.h:3821
A fatal error has occurred.
Definition: amd-dbgapi.h:766
amd_dbgapi_queue_info_t
Queue queries that are supported by amd_dbgapi_queue_get_info.
Definition: amd-dbgapi.h:2475
The inferior's runtime has been loaded and debugging is supported by the library. ...
Definition: amd-dbgapi.h:6606
The segment address in the address space is not a member of the source language address class...
Definition: amd-dbgapi.h:6031
Return the dispatch kernel code entry address.
Definition: amd-dbgapi.h:2930
amd_dbgapi_register_info_t
Register queries that are supported by amd_dbgapi_register_get_info.
Definition: amd-dbgapi.h:4766
Return the process to which this event belongs.
Definition: amd-dbgapi.h:6631
uint64_t handle
Definition: amd-dbgapi.h:2228
size_t count
Definition: amd-dbgapi.h:4466
No dependence is available.
Definition: amd-dbgapi.h:5954
The watchpoints are not shared across processes.
Definition: amd-dbgapi.h:4421
amd_dbgapi_register_class_info_t
Register class queries that are supported by amd_dbgapi_architecture_register_class_get_info.
Definition: amd-dbgapi.h:4603
Return the agent to which this wave belongs.
Definition: amd-dbgapi.h:3349
Agent supports debugging.
Definition: amd-dbgapi.h:2314
Request to resume a host breakpoint.
Definition: amd-dbgapi.h:6506
The process handle is invalid.
Definition: amd-dbgapi.h:836
The instruction conditionally branches to an address held in a pair of registers. ...
Definition: amd-dbgapi.h:1437
Return the architecture specific address space that is used to implement a pointer or reference to th...
Definition: amd-dbgapi.h:5445
amd_dbgapi_watchpoint_info_t
Watchpoint queries that are supported by amd_dbgapi_watchpoint_get_info.
Definition: amd-dbgapi.h:4342
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_get_info(amd_dbgapi_event_id_t event_id, amd_dbgapi_event_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about an event.
The instruction unconditionally branches to a literal address and the address of the following instru...
Definition: amd-dbgapi.h:1448
The address space handle is invalid.
Definition: amd-dbgapi.h:919
Print fatal error, warning, and info messages.
Definition: amd-dbgapi.h:6777
Opaque dispatch handle.
Definition: amd-dbgapi.h:2831
Return the base address of the memory holding the queue packets.
Definition: amd-dbgapi.h:2513
Return the client thread of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition: amd-dbgapi.h:6652
The instruction executes sequentially.
Definition: amd-dbgapi.h:1406
The wave has the register.
Definition: amd-dbgapi.h:4921
Return the queue to which this dispatch belongs.
Definition: amd-dbgapi.h:2854
The inferior's runtime has been loaded but there is a restriction error that prevents debugging the p...
Definition: amd-dbgapi.h:6616
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_process_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_56
Query information about a process.
Return if the runtime loaded in the inferior is supported by the library for a AMD_DBGAPI_EVENT_KIND_...
Definition: amd-dbgapi.h:6659
amd_dbgapi_segment_address_dependency_t
The dependency when reading or writing a specific segment address of an address space using the amd_d...
Definition: amd-dbgapi.h:5949
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_agent_list(amd_dbgapi_process_id_t process_id, size_t *agent_count, amd_dbgapi_agent_id_t **agents, amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54
Return the list of agents.
Callbacks that the client of the library must provide.
Definition: amd-dbgapi.h:6977
amd_dbgapi_instruction_properties_t
A bit mask of the properties of an instruction.
Definition: amd-dbgapi.h:1510
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_workgroup_get_info(amd_dbgapi_workgroup_id_t workgroup_id, amd_dbgapi_workgroup_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64
Query information about a workgroup.
A dispatch packet on the queue has an invalid dimension.
Definition: amd-dbgapi.h:2651
There is a restriction error that prevents debugging the process.
Definition: amd-dbgapi.h:812
The wave stopped due to executing a trap instruction other than the AMD_DBGAPI_WAVE_STOP_REASON_DEBUG...
Definition: amd-dbgapi.h:3614
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_processed(amd_dbgapi_event_id_t event_id) AMD_DBGAPI_VERSION_0_54
Report that an event has been processed.
Return the breakpoint instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1183
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_wave_creation(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_creation_t creation) AMD_DBGAPI_VERSION_0_54
Set the wave creation mode for a process.
Return the dispatch private segment size in bytes.
Definition: amd-dbgapi.h:2910
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_get_info(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_wave_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64
Query information about a wave.
Opaque source language address class handle.
Definition: amd-dbgapi.h:5410
A wave on the queue executed an instruction that had a floating point or integer enabled exception co...
Definition: amd-dbgapi.h:2632
No more displaced stepping buffers are available that are suitable for the requested wave...
Definition: amd-dbgapi.h:882
Unknown queue type.
Definition: amd-dbgapi.h:703
Return the process to which this queue belongs.
Definition: amd-dbgapi.h:2486
amd_dbgapi_progress_t
The kinds of progress supported by the library.
Definition: amd-dbgapi.h:1886
amd_dbgapi_breakpoint_info_t
Breakpoint queries that are supported by amd_dbgapi_breakpoint_get_info.
Definition: amd-dbgapi.h:6851
amd_dbgapi_agent_state_t
Agent state.
Definition: amd-dbgapi.h:2309
A wave on the queue had an aperture violation.
Definition: amd-dbgapi.h:2647
Return the set of exceptions that caused the queue to enter the queue error state.
Definition: amd-dbgapi.h:2508
The operation is not currently implemented.
Definition: amd-dbgapi.h:772
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_start(amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes, amd_dbgapi_displaced_stepping_id_t *displaced_stepping) AMD_DBGAPI_VERSION_0_54
Associate an active displaced stepping buffer with a wave.
amd_dbgapi_register_properties_t
A bit mask on register properties.
Definition: amd-dbgapi.h:4732
amd_dbgapi_memory_precision_t
Memory access precision.
Definition: amd-dbgapi.h:6346
uint64_t handle
Definition: amd-dbgapi.h:2027
Reading or writing the segment address depends on the lane.
Definition: amd-dbgapi.h:5958
Return the process to which this watchpoint belongs.
Definition: amd-dbgapi.h:4348
Opaque wave handle.
Definition: amd-dbgapi.h:3276
Return the number of bytes to subtract from the PC after stopping due to a breakpoint instruction to ...
Definition: amd-dbgapi.h:1197
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_dependency(amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_segment_address_t segment_address, amd_dbgapi_segment_address_dependency_t *segment_address_dependency) AMD_DBGAPI_VERSION_0_64
Determine the dependency of a segment address value in a particular address space.
uint64_t handle
Definition: amd-dbgapi.h:3278
#define AMD_DBGAPI_VERSION_0_68
The function was introduced in version 0.68 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:558
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_resume(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_resume_mode_t resume_mode, amd_dbgapi_exceptions_t exceptions) AMD_DBGAPI_VERSION_0_58
Resume execution of a stopped wave.
Return the largest instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1172
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_get_info(amd_dbgapi_queue_id_t queue_id, amd_dbgapi_queue_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_68
Query information about a queue.
amd_dbgapi_address_space_info_t
Address space queries that are supported by amd_dbgapi_address_space_get_info.
Definition: amd-dbgapi.h:5644
Return the minimum instruction alignment in bytes for the architecture.
Definition: amd-dbgapi.h:1178
The native operating system process associated with a client process has exited.
Definition: amd-dbgapi.h:841
The instruction performs some kind of execution barrier which may result in the wave being halted unt...
Definition: amd-dbgapi.h:1489
The wave stopped due to triggering an enabled floating point input denormal exception.
Definition: amd-dbgapi.h:3525
Stop wave creation prevents new waves from being created.
Definition: amd-dbgapi.h:1968
Native operating system agent ID.
Definition: amd-dbgapi.h:2303
Return the dispatch kernel descriptor address.
Definition: amd-dbgapi.h:2925
The wave is running.
Definition: amd-dbgapi.h:3462
No event.
Definition: amd-dbgapi.h:6452
Resume normal execution.
Definition: amd-dbgapi.h:3817
amd_dbgapi_exceptions_t
A bit mask of the exceptions that can cause a queue to enter the queue error state.
Definition: amd-dbgapi.h:2597
The operation is not supported.
Definition: amd-dbgapi.h:780
uint64_t handle
Definition: amd-dbgapi.h:4717
uint64_t handle
Definition: amd-dbgapi.h:5597
The workgroup workgroup coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3157
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_list(amd_dbgapi_wave_id_t wave_id, size_t *register_count, amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54
Report the list of registers supported by a wave.
The workgroup handle is invalid.
Definition: amd-dbgapi.h:956
Return the dispatch grid dimensionality.
Definition: amd-dbgapi.h:2895
uint64_t amd_dbgapi_size_t
Integral type used for sizes, including memory allocations, in the inferior.
Definition: amd-dbgapi.h:601
Return the NULL segment address value in the address space.
Definition: amd-dbgapi.h:5662
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_register(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size, void *value) AMD_DBGAPI_VERSION_0_62
Read a register.
Return the queue to which this workgroup belongs.
Definition: amd-dbgapi.h:3131
The register handle is valid, but specifies a register that is not allocated in the associated wave...
Definition: amd-dbgapi.h:952
Return the dispatch kernel argument segment address.
Definition: amd-dbgapi.h:2920
Return the architecture of this queue.
Definition: amd-dbgapi.h:2491
Return the workgroup to which this wave belongs.
Definition: amd-dbgapi.h:3329
The register is a member of the register class.
Definition: amd-dbgapi.h:5108
Return the architecture of this agent.
Definition: amd-dbgapi.h:2265
There was an error preempting the queue.
Definition: amd-dbgapi.h:2684
Return the process to which this workgroup belongs.
Definition: amd-dbgapi.h:3141
Queue supports the HSA AQL protocol.
Definition: amd-dbgapi.h:707
Return the process to which this displaced stepping buffer belongs.
Definition: amd-dbgapi.h:4104
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_get_info(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_architecture_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about an architecture.
Print fatal error, warning, info, and API tracing messages.
Definition: amd-dbgapi.h:6781
A wave on the queue had a memory violation.
Definition: amd-dbgapi.h:2642
Total number of Execution Units (EUs) available in the agent.
Definition: amd-dbgapi.h:2293
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_agent_get_info(amd_dbgapi_agent_id_t agent_id, amd_dbgapi_agent_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_67
Query information about an agent.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_get_info(amd_dbgapi_displaced_stepping_id_t displaced_stepping_id, amd_dbgapi_displaced_stepping_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a displaced stepping buffer.
A callback to the client reported an error.
Definition: amd-dbgapi.h:939
amd_dbgapi_os_queue_type_t
Native operating system queue type.
Definition: amd-dbgapi.h:698
amd_dbgapi_resume_mode_t
The mode in which to resuming the execution of a wave.
Definition: amd-dbgapi.h:3812
A dispatch packet on the queue has a NULL code address.
Definition: amd-dbgapi.h:2659
amd_dbgapi_status_t
AMD debugger API status codes.
Definition: amd-dbgapi.h:735
Return the current program counter value of the wave.
Definition: amd-dbgapi.h:3365
The agent handle is invalid.
Definition: amd-dbgapi.h:845
The base address of the created watchpoint.
Definition: amd-dbgapi.h:4353
Return the AMD GPU DWARF address class number for the address class' architecture.
Definition: amd-dbgapi.h:5450
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_progress(amd_dbgapi_process_id_t process_id, amd_dbgapi_progress_t progress) AMD_DBGAPI_VERSION_0_54
Set the progress required for a process.
The architecture handle is invalid.
Definition: amd-dbgapi.h:820
Leave execution halted.
Definition: amd-dbgapi.h:6915
At least one bit of the register value is readonly.
Definition: amd-dbgapi.h:4743
Opaque architecture handle.
Definition: amd-dbgapi.h:1133
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_list(amd_dbgapi_architecture_id_t architecture_id, size_t *register_count, amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54
Report the list of registers supported by the architecture.
The wave stopped due to triggering an enabled floating point underflow exception. ...
Definition: amd-dbgapi.h:3549
Return the queue type.
Definition: amd-dbgapi.h:2496
amd_dbgapi_wave_info_t
Wave queries that are supported by amd_dbgapi_wave_get_info.
Definition: amd-dbgapi.h:3293
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_space_list(amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count, amd_dbgapi_address_space_id_t **address_spaces) AMD_DBGAPI_VERSION_0_54
Report the list of address spaces supported by the architecture.
uint64_t handle
Definition: amd-dbgapi.h:5412
Return the queue state.
Definition: amd-dbgapi.h:2501
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dwarf_address_class_to_address_class(amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class, amd_dbgapi_address_class_id_t *address_class_id) AMD_DBGAPI_VERSION_0_54
Return the architecture source language address class from a DWARF address class number for an archit...
The wave is stopped.
Definition: amd-dbgapi.h:3480
Return the process to which this agent belongs.
Definition: amd-dbgapi.h:2249
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_register(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size, const void *value) AMD_DBGAPI_VERSION_0_62
Write a register.
Reading or writing the segment address depends on the agent.
Definition: amd-dbgapi.h:5970
A packet on the queue has an invalid vendor code.
Definition: amd-dbgapi.h:2675
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_memory_precision(amd_dbgapi_process_id_t process_id, amd_dbgapi_memory_precision_t memory_precision) AMD_DBGAPI_VERSION_0_54
Control precision of memory access reporting.
Queue is in the queue error state.
Definition: amd-dbgapi.h:2590
struct amd_dbgapi_symbolizer_id_s * amd_dbgapi_symbolizer_id_t
Opaque client symbolizer handle.
Definition: amd-dbgapi.h:1286
An error occurred while trying to access memory in the inferior.
Definition: amd-dbgapi.h:923
A generic error has occurred.
Definition: amd-dbgapi.h:744
A dispatch packet on the queue has an invalid group segment size.
Definition: amd-dbgapi.h:2655
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_memory(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id, amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_segment_address_t segment_address, amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_54
Write memory.
The process is already attached to the given inferior process.
Definition: amd-dbgapi.h:816
struct amd_dbgapi_client_process_s * amd_dbgapi_client_process_id_t
Opaque client process handle.
Definition: amd-dbgapi.h:1620
amd_dbgapi_displaced_stepping_info_t
Displaced stepping queries that are supported by amd_dbgapi_displaced_stepping_id_t.
Definition: amd-dbgapi.h:4098
Dispatch has no barrier.
Definition: amd-dbgapi.h:2999
The wave stopped due to executing an illegal instruction.
Definition: amd-dbgapi.h:3654
amd_dbgapi_watchpoint_share_kind_t
The way watchpoints are shared between processes.
Definition: amd-dbgapi.h:4410
The dispatch handle is invalid.
Definition: amd-dbgapi.h:853
amd_dbgapi_instruction_kind_t
The kinds of instruction classifications.
Definition: amd-dbgapi.h:1394
Read, write, or read-modify-write access by load, store, or atomic instructions.
Definition: amd-dbgapi.h:4455
Return the watchpoint(s) the wave triggered.
Definition: amd-dbgapi.h:3319
A packet on the queue has an unsupported code.
Definition: amd-dbgapi.h:2663
struct amd_dbgapi_client_thread_s * amd_dbgapi_client_thread_id_t
Opaque client thread handle.
Definition: amd-dbgapi.h:6927
Return the register name.
Definition: amd-dbgapi.h:4779
The wave workgroup coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3384
Return if the architectures of all the agents of a process support controlling memory precision...
Definition: amd-dbgapi.h:1673
Print fatal error, warning, info, API tracing, and verbose messages.
Definition: amd-dbgapi.h:6785
The queue handle is invalid.
Definition: amd-dbgapi.h:849
amd_dbgapi_status_t(* remove_breakpoint)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_breakpoint_id_t breakpoint_id)
Remove a breakpoint previously inserted by amd_dbgapi_callbacks_s::insert_breakpoint.
Definition: amd-dbgapi.h:7112
The wave stopped due to triggering an enabled integer divide by zero exception.
Definition: amd-dbgapi.h:3573
PCI device ID of the agent.
Definition: amd-dbgapi.h:2288
void AMD_DBGAPI amd_dbgapi_get_version(uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_54
Query the version of the installed library.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_detach(amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_54
Detach from a process and no longer have debug control of the AMD GPU devices it uses.
Return the register type as a C style type string.
Definition: amd-dbgapi.h:4845
amd_dbgapi_status_t(* get_os_pid)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_os_process_id_t *os_pid)
Return the native operating system process handle for the process identified by the client process ha...
Definition: amd-dbgapi.h:7038
amd_dbgapi_dispatch_info_t
Dispatch queries that are supported by amd_dbgapi_dispatch_get_info.
Definition: amd-dbgapi.h:2848
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dispatch_get_info(amd_dbgapi_dispatch_id_t dispatch_id, amd_dbgapi_dispatch_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54
Query information about a dispatch.
#define AMD_DBGAPI_VERSION_0_58
The function was introduced in version 0.58 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:534
The wave stopped after causing a hardware fatal halt.
Definition: amd-dbgapi.h:3674
The wave cannot be resumed in the manner requested due to displaced stepping restrictions.
Definition: amd-dbgapi.h:891
Opaque breakpoint handle.
Definition: amd-dbgapi.h:6834
Return the current execution mask of the wave.
Definition: amd-dbgapi.h:3373
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_get_info(amd_dbgapi_register_id_t register_id, amd_dbgapi_register_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_70
Query information about a register.