AMD_DBGAPI 0.70.1
Loading...
Searching...
No Matches
amd-dbgapi.h
Go to the documentation of this file.
1/* Copyright (c) 2019-2023 Advanced Micro Devices, Inc.
2
3 Permission is hereby granted, free of charge, to any person obtaining a copy
4 of this software and associated documentation files (the "Software"), to deal
5 in the Software without restriction, including without limitation the rights
6 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7 copies of the Software, and to permit persons to whom the Software is
8 furnished to do so, subject to the following conditions:
9
10 The above copyright notice and this permission notice shall be included in
11 all copies or substantial portions of the Software.
12
13 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19 THE SOFTWARE. */
20
462#ifndef AMD_DBGAPI_H
463#define AMD_DBGAPI_H 1
464
465/* Placeholder for calling convention and import/export macros */
466#if !defined(AMD_DBGAPI_CALL)
467#define AMD_DBGAPI_CALL
468#endif /* !defined (AMD_DBGAPI_CALL) */
469
470#if !defined(AMD_DBGAPI_EXPORT_DECORATOR)
471#if defined(__GNUC__)
472#define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default")))
473#elif defined(_MSC_VER)
474#define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)
475#endif /* defined (_MSC_VER) */
476#endif /* !defined (AMD_DBGAPI_EXPORT_DECORATOR) */
477
478#if !defined(AMD_DBGAPI_IMPORT_DECORATOR)
479#if defined(__GNUC__)
480#define AMD_DBGAPI_IMPORT_DECORATOR
481#elif defined(_MSC_VER)
482#define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)
483#endif /* defined (_MSC_VER) */
484#endif /* !defined (AMD_DBGAPI_IMPORT_DECORATOR) */
485
486#define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL
487#define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL
488
489#if !defined(AMD_DBGAPI)
490#if defined(AMD_DBGAPI_EXPORTS)
491#define AMD_DBGAPI AMD_DBGAPI_EXPORT
492#else /* !defined (AMD_DBGAPI_EXPORTS) */
493#define AMD_DBGAPI AMD_DBGAPI_IMPORT
494#endif /* !defined (AMD_DBGAPI_EXPORTS) */
495#endif /* !defined (AMD_DBGAPI) */
496
497#if __cplusplus >= 201103L
498/* c++11 allows extended initializer lists. */
499#define AMD_DBGAPI_HANDLE_LITERAL(type, value) (type{ value })
500#elif __STDC_VERSION__ >= 199901L
501/* c99 allows compound literals. */
502#define AMD_DBGAPI_HANDLE_LITERAL(type, value) ((type){ value })
503#else /* !__STDC_VERSION__ >= 199901L */
504#define AMD_DBGAPI_HANDLE_LITERAL(type, value) {value}
505#endif /* !__STDC_VERSION__ >= 199901L */
506
507#if defined(__cplusplus)
508extern "C" {
509#endif /* defined (__cplusplus) */
510
511#if defined(__linux__)
512#include <sys/types.h>
513#endif /* __linux__ */
514
515#include <stddef.h>
516#include <stdint.h>
517
537#define AMD_DBGAPI_VERSION_0_54
538
543#define AMD_DBGAPI_VERSION_0_56
544
549#define AMD_DBGAPI_VERSION_0_58
550
555#define AMD_DBGAPI_VERSION_0_62
556
561#define AMD_DBGAPI_VERSION_0_64
562
567#define AMD_DBGAPI_VERSION_0_67
568
573#define AMD_DBGAPI_VERSION_0_68
574
579#define AMD_DBGAPI_VERSION_0_70
580
588
612
616typedef uint64_t amd_dbgapi_size_t;
617
632
640#if defined(__linux__)
642#endif /* __linux__ */
643
668#if defined(__linux__)
670#endif /* __linux__ */
671
679#if defined(__linux__)
681#endif /* __linux__ */
682
689#if defined(__linux__)
691#endif /* __linux__ */
692
701#if defined(__linux__)
703#endif /* __linux__ */
704
712#if defined(__linux__)
736#endif /* __linux__ */
737
750typedef enum
751{
973
991 amd_dbgapi_status_t status,
992 const char **status_string) AMD_DBGAPI_VERSION_0_54;
993
1017#define AMD_DBGAPI_VERSION_MAJOR 0
1018
1023#define AMD_DBGAPI_VERSION_MINOR 70
1024
1039 uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_54;
1040
1049const char AMD_DBGAPI *
1051
1099
1126
1148typedef struct
1149{
1150 uint64_t handle;
1152
1156#define AMD_DBGAPI_ARCHITECTURE_NONE \
1157 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_architecture_id_t, 0)
1158
1219
1259 amd_dbgapi_architecture_id_t architecture_id,
1260 amd_dbgapi_architecture_info_t query, size_t value_size,
1261 void *value) AMD_DBGAPI_VERSION_0_54;
1262
1292 uint32_t elf_amdgpu_machine,
1294
1301typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;
1302
1397 amd_dbgapi_architecture_id_t architecture_id,
1399 const void *memory, char **instruction_text,
1400 amd_dbgapi_symbolizer_id_t symbolizer_id,
1401 amd_dbgapi_status_t (*symbolizer) (
1402 amd_dbgapi_symbolizer_id_t symbolizer_id,
1404 char **symbol_text)) AMD_DBGAPI_VERSION_0_54;
1405
1521
1532
1608 amd_dbgapi_architecture_id_t architecture_id,
1610 const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind,
1611 amd_dbgapi_instruction_properties_t *instruction_properties,
1612 void **instruction_information) AMD_DBGAPI_VERSION_0_58;
1613
1635typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;
1636
1647typedef struct
1648{
1649 uint64_t handle;
1651
1655#define AMD_DBGAPI_PROCESS_NONE \
1656 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_process_id_t, 0)
1657
1700
1745 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_56;
1746
1837 amd_dbgapi_client_process_id_t client_process_id,
1839
1886
1934
1960 amd_dbgapi_process_id_t process_id,
1962
1985
2011 amd_dbgapi_process_id_t process_id,
2013
2040typedef struct
2041{
2042 uint64_t handle;
2044
2048#define AMD_DBGAPI_CODE_OBJECT_NONE \
2049 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_code_object_id_t, 0)
2050
2127
2167 amd_dbgapi_code_object_id_t code_object_id,
2168 amd_dbgapi_code_object_info_t query, size_t value_size,
2169 void *value) AMD_DBGAPI_VERSION_0_54;
2170
2221 amd_dbgapi_process_id_t process_id, size_t *code_object_count,
2222 amd_dbgapi_code_object_id_t **code_objects,
2224
2241typedef struct
2242{
2243 uint64_t handle;
2245
2249#define AMD_DBGAPI_AGENT_NONE \
2250 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_agent_id_t, 0)
2251
2320
2352
2397 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_67;
2398
2451 amd_dbgapi_process_id_t process_id, size_t *agent_count,
2452 amd_dbgapi_agent_id_t **agents,
2454
2473typedef struct
2474{
2475 uint64_t handle;
2477
2481#define AMD_DBGAPI_QUEUE_NONE \
2482 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_queue_id_t, 0)
2483
2540
2581 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_68;
2582
2607
2701
2755 amd_dbgapi_process_id_t process_id, size_t *queue_count,
2756 amd_dbgapi_queue_id_t **queues,
2758
2823 amd_dbgapi_queue_id_t queue_id,
2824 amd_dbgapi_os_queue_packet_id_t *read_packet_id,
2825 amd_dbgapi_os_queue_packet_id_t *write_packet_id,
2826 size_t *packets_byte_size, void **packets_bytes) AMD_DBGAPI_VERSION_0_54;
2827
2846typedef struct
2847{
2848 uint64_t handle;
2850
2854#define AMD_DBGAPI_DISPATCH_NONE \
2855 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_dispatch_id_t, 0)
2856
2957
3001 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;
3002
3021
3043
3093 amd_dbgapi_process_id_t process_id, size_t *dispatch_count,
3094 amd_dbgapi_dispatch_id_t **dispatches,
3096
3113typedef struct
3114{
3115 uint64_t handle;
3117
3121#define AMD_DBGAPI_WORKGROUP_NONE \
3122 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_workgroup_id_t, 0)
3123
3174
3219 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;
3220
3271 amd_dbgapi_process_id_t process_id, size_t *workgroup_count,
3272 amd_dbgapi_workgroup_id_t **workgroups,
3274
3291typedef struct
3292{
3293 uint64_t handle;
3295
3299#define AMD_DBGAPI_WAVE_NONE \
3300 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_wave_id_t, 0)
3301
3418
3467 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;
3468
3497
3691
3740 amd_dbgapi_process_id_t process_id, size_t *wave_count,
3741 amd_dbgapi_wave_id_t **waves,
3743
3823
3838
3993
4095typedef struct
4096{
4097 uint64_t handle;
4099
4103#define AMD_DBGAPI_DISPLACED_STEPPING_NONE \
4104 (amd_dbgapi_displaced_stepping_id_t{ 0 })
4105
4121
4162 amd_dbgapi_displaced_stepping_id_t displaced_stepping_id,
4163 amd_dbgapi_displaced_stepping_info_t query, size_t value_size,
4164 void *value) AMD_DBGAPI_VERSION_0_54;
4165
4248 amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes,
4249 amd_dbgapi_displaced_stepping_id_t *displaced_stepping)
4251
4303 amd_dbgapi_wave_id_t wave_id,
4304 amd_dbgapi_displaced_stepping_id_t displaced_stepping)
4306
4340typedef struct
4341{
4342 uint64_t handle;
4344
4348#define AMD_DBGAPI_WATCHPOINT_NONE \
4349 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_watchpoint_id_t, 0)
4350
4375
4415 amd_dbgapi_watchpoint_id_t watchpoint_id,
4416 amd_dbgapi_watchpoint_info_t query, size_t value_size,
4417 void *value) AMD_DBGAPI_VERSION_0_54;
4418
4444
4472
4484
4556
4578
4600typedef struct
4601{
4602 uint64_t handle;
4604
4608#define AMD_DBGAPI_REGISTER_CLASS_NONE \
4609 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_class_id_t, 0)
4610
4633
4674 amd_dbgapi_register_class_id_t register_class_id,
4675 amd_dbgapi_register_class_info_t query, size_t value_size,
4676 void *value) AMD_DBGAPI_VERSION_0_54;
4677
4719 amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count,
4721
4730typedef struct
4731{
4732 uint64_t handle;
4734
4738#define AMD_DBGAPI_REGISTER_NONE \
4739 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_id_t, 0)
4740
4774
4876
4922 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_70;
4923
4938
4975
5021 amd_dbgapi_architecture_id_t architecture_id, size_t *register_count,
5023
5068 amd_dbgapi_wave_id_t wave_id, size_t *register_count,
5070
5108 amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register,
5110
5125
5164 amd_dbgapi_register_class_id_t register_class_id,
5165 amd_dbgapi_register_id_t register_id,
5166 amd_dbgapi_register_class_state_t *register_class_state)
5168
5227 amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5228 void *value) AMD_DBGAPI_VERSION_0_62;
5229
5293 amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5294 const void *value) AMD_DBGAPI_VERSION_0_62;
5295
5352
5365
5405typedef uint32_t amd_dbgapi_lane_id_t;
5406
5410#define AMD_DBGAPI_LANE_NONE ((amd_dbgapi_lane_id_t) (-1))
5411
5425typedef struct
5426{
5427 uint64_t handle;
5429
5433#define AMD_DBGAPI_ADDRESS_CLASS_NONE \
5434 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_class_id_t, 0)
5435
5467
5508 amd_dbgapi_address_class_id_t address_class_id,
5509 amd_dbgapi_address_class_info_t query, size_t value_size,
5510 void *value) AMD_DBGAPI_VERSION_0_62;
5511
5554 amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count,
5556
5596 amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class,
5598
5610typedef struct
5611{
5612 uint64_t handle;
5614
5618#define AMD_DBGAPI_ADDRESS_SPACE_NONE \
5619 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 0)
5620
5627#define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL \
5628 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 1)
5629
5651
5689
5729 amd_dbgapi_address_space_id_t address_space_id,
5730 amd_dbgapi_address_space_info_t query, size_t value_size,
5731 void *value) AMD_DBGAPI_VERSION_0_62;
5732
5772 amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count,
5774
5815 amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space,
5817
5835
5952 amd_dbgapi_address_space_id_t source_address_space_id,
5953 amd_dbgapi_segment_address_t source_segment_address,
5954 amd_dbgapi_address_space_id_t destination_address_space_id,
5955 amd_dbgapi_segment_address_t *destination_segment_address,
5956 amd_dbgapi_size_t *destination_contiguous_bytes)
5958
5991
6031 amd_dbgapi_address_space_id_t address_space_id,
6032 amd_dbgapi_segment_address_t segment_address,
6033 amd_dbgapi_segment_address_dependency_t *segment_address_dependency)
6035
6053
6127 amd_dbgapi_address_space_id_t address_space_id,
6128 amd_dbgapi_segment_address_t segment_address,
6129 amd_dbgapi_address_class_id_t address_class_id,
6130 amd_dbgapi_address_class_state_t *address_class_state)
6132
6233 amd_dbgapi_lane_id_t lane_id,
6234 amd_dbgapi_address_space_id_t address_space_id,
6235 amd_dbgapi_segment_address_t segment_address,
6236 amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_54;
6237
6338 amd_dbgapi_lane_id_t lane_id,
6339 amd_dbgapi_address_space_id_t address_space_id,
6340 amd_dbgapi_segment_address_t segment_address,
6341 amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_54;
6342
6374
6414 amd_dbgapi_process_id_t process_id,
6416
6448typedef struct
6449{
6450 uint64_t handle;
6452
6456#define AMD_DBGAPI_EVENT_NONE \
6457 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_event_id_t, 0)
6458
6572
6609 amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id,
6611
6633
6681
6723 size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;
6724
6752
6802
6823
6849typedef struct
6850{
6851 uint64_t handle;
6853
6857#define AMD_DBGAPI_BREAKPOINT_NONE \
6858 AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_breakpoint_id_t, 0)
6859
6874
6914 amd_dbgapi_breakpoint_id_t breakpoint_id,
6915 amd_dbgapi_breakpoint_info_t query, size_t value_size,
6916 void *value) AMD_DBGAPI_VERSION_0_54;
6917
6932
6942typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;
6943
6982 amd_dbgapi_breakpoint_id_t breakpoint_id,
6983 amd_dbgapi_client_thread_id_t client_thread_id,
6985
6993{
6994
7006 void *(*allocate_memory) (size_t byte_size);
7007
7024 void (*deallocate_memory) (void *data);
7025
7054 amd_dbgapi_client_process_id_t client_process_id,
7056
7093 amd_dbgapi_client_process_id_t client_process_id,
7095 amd_dbgapi_breakpoint_id_t breakpoint_id);
7096
7128 amd_dbgapi_client_process_id_t client_process_id,
7129 amd_dbgapi_breakpoint_id_t breakpoint_id);
7130
7139 void (*log_message) (amd_dbgapi_log_level_t level, const char *message);
7140};
7141
7144#if defined(__cplusplus)
7145} /* extern "C" */
7146#endif /* defined (__cplusplus) */
7147
7148#endif /* amd-dbgapi.h */
#define AMD_DBGAPI
Definition amd-dbgapi.h:493
amd_dbgapi_agent_state_t
Agent state.
Definition amd-dbgapi.h:2325
amd_dbgapi_agent_info_t
Agent queries that are supported by amd_dbgapi_agent_get_info.
Definition amd-dbgapi.h:2259
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_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.
@ AMD_DBGAPI_AGENT_STATE_NOT_SUPPORTED
Agent does not support debugging.
Definition amd-dbgapi.h:2350
@ AMD_DBGAPI_AGENT_STATE_SUPPORTED
Agent supports debugging.
Definition amd-dbgapi.h:2329
@ AMD_DBGAPI_AGENT_INFO_STATE
Return the agent state.
Definition amd-dbgapi.h:2285
@ AMD_DBGAPI_AGENT_INFO_OS_ID
Native operating system agent ID.
Definition amd-dbgapi.h:2318
@ AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID
PCI device ID of the agent.
Definition amd-dbgapi.h:2303
@ AMD_DBGAPI_AGENT_INFO_PROCESS
Return the process to which this agent belongs.
Definition amd-dbgapi.h:2264
@ AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID
PCI vendor ID of the agent.
Definition amd-dbgapi.h:2299
@ AMD_DBGAPI_AGENT_INFO_NAME
Agent name.
Definition amd-dbgapi.h:2270
@ AMD_DBGAPI_AGENT_INFO_ARCHITECTURE
Return the architecture of this agent.
Definition amd-dbgapi.h:2280
@ AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT
Total number of Execution Units (EUs) available in the agent.
Definition amd-dbgapi.h:2308
@ AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN
PCI domain the agent is in.
Definition amd-dbgapi.h:2289
@ AMD_DBGAPI_AGENT_INFO_PCI_SLOT
PCI slot of the agent in BDF format (see [Bus:Device.Function (BDF) Notation][bfd].
Definition amd-dbgapi.h:2295
@ AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT
Maximum number of waves supported by an execution unit.
Definition amd-dbgapi.h:2313
amd_dbgapi_architecture_info_t
Architecture queries that are supported by amd_dbgapi_architecture_get_info.
Definition amd-dbgapi.h:1167
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_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.
struct amd_dbgapi_symbolizer_id_s * amd_dbgapi_symbolizer_id_t
Opaque client symbolizer handle.
Definition amd-dbgapi.h:1301
amd_dbgapi_instruction_kind_t
The kinds of instruction classifications.
Definition amd-dbgapi.h:1410
amd_dbgapi_instruction_properties_t
A bit mask of the properties of an instruction.
Definition amd-dbgapi.h:1526
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.
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.
@ AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE
Return the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture.
Definition amd-dbgapi.h:1182
@ AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT
Return the minimum instruction alignment in bytes for the architecture.
Definition amd-dbgapi.h:1193
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE
Return the breakpoint instruction size in bytes for the architecture.
Definition amd-dbgapi.h:1198
@ AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER
Return the register handle for the PC for the architecture.
Definition amd-dbgapi.h:1217
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_PC_ADJUST
Return the number of bytes to subtract from the PC after stopping due to a breakpoint instruction to ...
Definition amd-dbgapi.h:1212
@ AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE
Return the largest instruction size in bytes for the architecture.
Definition amd-dbgapi.h:1187
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION
Return the breakpoint instruction for the architecture.
Definition amd-dbgapi.h:1206
@ AMD_DBGAPI_ARCHITECTURE_INFO_NAME
Return the architecture name.
Definition amd-dbgapi.h:1174
@ AMD_DBGAPI_INSTRUCTION_KIND_BARRIER
The instruction performs some kind of execution barrier which may result in the wave being halted unt...
Definition amd-dbgapi.h:1504
@ AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_CALL_REGISTER_PAIRS
The instruction unconditionally branches to an address held in a pair of source registers and the add...
Definition amd-dbgapi.h:1473
@ AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL
The instruction executes sequentially.
Definition amd-dbgapi.h:1421
@ AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_CONDITIONAL_REGISTER_PAIR
The instruction conditionally branches to an address held in a pair of registers.
Definition amd-dbgapi.h:1452
@ AMD_DBGAPI_INSTRUCTION_KIND_SPECIAL
The instruction has some form of special behavior not covered by any of the other instruction kinds.
Definition amd-dbgapi.h:1519
@ AMD_DBGAPI_INSTRUCTION_KIND_HALT
The instruction unconditionally halts the wave.
Definition amd-dbgapi.h:1497
@ AMD_DBGAPI_INSTRUCTION_KIND_TRAP
The instruction enters the trap handler.
Definition amd-dbgapi.h:1492
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_CALL_REGISTER_PAIR
The instruction unconditionally branches to a literal address and the address of the following instru...
Definition amd-dbgapi.h:1463
@ AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_REGISTER_PAIR
The instruction unconditionally branches to an address held in a pair of registers.
Definition amd-dbgapi.h:1442
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL
The instruction conditionally branches to a literal address.
Definition amd-dbgapi.h:1434
@ AMD_DBGAPI_INSTRUCTION_KIND_SLEEP
The instruction causes the wave to stop executing for some period of time, before continuing executio...
Definition amd-dbgapi.h:1510
@ AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE
The instruction terminates the wave execution.
Definition amd-dbgapi.h:1478
@ AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN
The instruction classification is unknown.
Definition amd-dbgapi.h:1415
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH
The instruction unconditionally branches to a literal address.
Definition amd-dbgapi.h:1427
@ AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE
The instruction has no properties.
Definition amd-dbgapi.h:1530
uint64_t amd_dbgapi_size_t
Integral type used for sizes, including memory allocations, in the inferior.
Definition amd-dbgapi.h:616
uint64_t amd_dbgapi_os_queue_id_t
Native operating system queue ID.
Definition amd-dbgapi.h:690
uint64_t amd_dbgapi_global_address_t
Integral type used for a global virtual memory address in the inferior process.
Definition amd-dbgapi.h:611
uint64_t amd_dbgapi_os_queue_packet_id_t
Native operating system queue packet ID.
Definition amd-dbgapi.h:702
uint64_t amd_dbgapi_os_agent_id_t
Native operating system agent ID.
Definition amd-dbgapi.h:680
amd_dbgapi_os_queue_type_t
Native operating system queue type.
Definition amd-dbgapi.h:714
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:669
pid_t amd_dbgapi_os_process_id_t
Native operating system process ID.
Definition amd-dbgapi.h:641
amd_dbgapi_changed_t
Indication of if a value has changed.
Definition amd-dbgapi.h:622
@ AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN
Unknown queue type.
Definition amd-dbgapi.h:718
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA
Queue supports the AMD SDMA protocol.
Definition amd-dbgapi.h:730
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4
Queue supports the AMD PM4 protocol.
Definition amd-dbgapi.h:726
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI
Queue supports the AMD SDMA XGMI protocol.
Definition amd-dbgapi.h:734
@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL
Queue supports the HSA AQL protocol.
Definition amd-dbgapi.h:722
@ AMD_DBGAPI_CHANGED_YES
The value has changed.
Definition amd-dbgapi.h:630
@ AMD_DBGAPI_CHANGED_NO
The value has not changed.
Definition amd-dbgapi.h:626
amd_dbgapi_breakpoint_info_t
Breakpoint queries that are supported by amd_dbgapi_breakpoint_get_info.
Definition amd-dbgapi.h:6867
amd_dbgapi_breakpoint_action_t
The action to perform after reporting a breakpoint has been hit.
Definition amd-dbgapi.h:6922
struct amd_dbgapi_client_thread_s * amd_dbgapi_client_thread_id_t
Opaque client thread handle.
Definition amd-dbgapi.h:6942
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_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 ...
@ AMD_DBGAPI_BREAKPOINT_INFO_PROCESS
Return the process to which this breakpoint belongs.
Definition amd-dbgapi.h:6872
@ AMD_DBGAPI_BREAKPOINT_ACTION_RESUME
Resume execution.
Definition amd-dbgapi.h:6926
@ AMD_DBGAPI_BREAKPOINT_ACTION_HALT
Leave execution halted.
Definition amd-dbgapi.h:6930
amd_dbgapi_code_object_info_t
Code object queries that are supported by amd_dbgapi_code_object_get_info.
Definition amd-dbgapi.h:2058
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_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.
@ AMD_DBGAPI_CODE_OBJECT_INFO_PROCESS
Return the process to which this code object belongs.
Definition amd-dbgapi.h:2063
@ AMD_DBGAPI_CODE_OBJECT_INFO_URI_NAME
The URI name of the ELF shared object from which the code object was loaded.
Definition amd-dbgapi.h:2119
@ AMD_DBGAPI_CODE_OBJECT_INFO_LOAD_ADDRESS
The difference between the address in the ELF shared object and the address the code object is loaded...
Definition amd-dbgapi.h:2125
amd_dbgapi_dispatch_info_t
Dispatch queries that are supported by amd_dbgapi_dispatch_get_info.
Definition amd-dbgapi.h:2864
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.
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.
amd_dbgapi_dispatch_barrier_t
Dispatch barrier.
Definition amd-dbgapi.h:3010
amd_dbgapi_dispatch_fence_scope_t
Dispatch memory fence scope.
Definition amd-dbgapi.h:3029
@ AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE
Return the dispatch acquire fence.
Definition amd-dbgapi.h:2900
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS
Return the dispatch kernel argument segment address.
Definition amd-dbgapi.h:2935
@ AMD_DBGAPI_DISPATCH_INFO_QUEUE
Return the queue to which this dispatch belongs.
Definition amd-dbgapi.h:2869
@ AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE
Return the dispatch group segment size in bytes.
Definition amd-dbgapi.h:2930
@ AMD_DBGAPI_DISPATCH_INFO_AGENT
Return the agent to which this dispatch belongs.
Definition amd-dbgapi.h:2874
@ AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS
Return the dispatch grid dimensionality.
Definition amd-dbgapi.h:2910
@ AMD_DBGAPI_DISPATCH_INFO_OS_QUEUE_PACKET_ID
Return the queue packet ID of the dispatch packet that initiated the dispatch.
Definition amd-dbgapi.h:2890
@ AMD_DBGAPI_DISPATCH_INFO_PROCESS
Return the process to which this dispatch belongs.
Definition amd-dbgapi.h:2879
@ AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES
Return the dispatch grid size (work-items) in the X, Y, and Z dimensions.
Definition amd-dbgapi.h:2920
@ AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE
Return the dispatch release fence.
Definition amd-dbgapi.h:2905
@ AMD_DBGAPI_DISPATCH_INFO_BARRIER
Return the dispatch barrier setting.
Definition amd-dbgapi.h:2895
@ AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE
Return the architecture of this dispatch.
Definition amd-dbgapi.h:2884
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS
Return the dispatch kernel descriptor address.
Definition amd-dbgapi.h:2940
@ AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE
Return the dispatch private segment size in bytes.
Definition amd-dbgapi.h:2925
@ AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES
Return the dispatch workgroup size (work-items) in the X, Y, and Z dimensions.
Definition amd-dbgapi.h:2915
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS
Return the dispatch completion event address.
Definition amd-dbgapi.h:2955
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS
Return the dispatch kernel code entry address.
Definition amd-dbgapi.h:2945
@ AMD_DBGAPI_DISPATCH_BARRIER_NONE
Dispatch has no barrier.
Definition amd-dbgapi.h:3014
@ AMD_DBGAPI_DISPATCH_BARRIER_PRESENT
Dispatch has a barrier.
Definition amd-dbgapi.h:3019
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE
There is no fence.
Definition amd-dbgapi.h:3033
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT
There is a fence with agent memory scope.
Definition amd-dbgapi.h:3037
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM
There is a fence with system memory scope.
Definition amd-dbgapi.h:3041
amd_dbgapi_displaced_stepping_info_t
Displaced stepping queries that are supported by amd_dbgapi_displaced_stepping_id_t.
Definition amd-dbgapi.h:4114
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.
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_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.
@ AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS
Return the process to which this displaced stepping buffer belongs.
Definition amd-dbgapi.h:4119
amd_dbgapi_event_info_t
Event queries that are supported by amd_dbgapi_event_get_info.
Definition amd-dbgapi.h:6641
amd_dbgapi_runtime_state_t
Inferior's runtime state.
Definition amd-dbgapi.h:6616
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.
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.
amd_dbgapi_event_kind_t
The event kinds.
Definition amd-dbgapi.h:6463
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.
@ AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD
Return the client thread of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition amd-dbgapi.h:6667
@ AMD_DBGAPI_EVENT_INFO_KIND
Return the event kind.
Definition amd-dbgapi.h:6651
@ AMD_DBGAPI_EVENT_INFO_RUNTIME_STATE
Return if the runtime loaded in the inferior is supported by the library for a AMD_DBGAPI_EVENT_KIND_...
Definition amd-dbgapi.h:6674
@ AMD_DBGAPI_EVENT_INFO_BREAKPOINT
Return the breakpoint of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition amd-dbgapi.h:6662
@ AMD_DBGAPI_EVENT_INFO_WAVE
Return the wave of a AMD_DBGAPI_EVENT_KIND_WAVE_STOP or AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED...
Definition amd-dbgapi.h:6657
@ AMD_DBGAPI_EVENT_INFO_PROCESS
Return the process to which this event belongs.
Definition amd-dbgapi.h:6646
@ AMD_DBGAPI_EVENT_INFO_QUEUE
Return the queue of a AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR event.
Definition amd-dbgapi.h:6679
@ AMD_DBGAPI_RUNTIME_STATE_UNLOADED
The inferior's runtime has been unloaded.
Definition amd-dbgapi.h:6625
@ AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS
The inferior's runtime has been loaded and debugging is supported by the library.
Definition amd-dbgapi.h:6621
@ AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION
The inferior's runtime has been loaded but there is a restriction error that prevents debugging the p...
Definition amd-dbgapi.h:6631
@ AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED
The list of code objects has changed.
Definition amd-dbgapi.h:6508
@ AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED
A command for a wave was not able to complete because the wave has terminated.
Definition amd-dbgapi.h:6486
@ AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR
The inferior's runtime has put a queue into the queue error state due to exceptions being reported fo...
Definition amd-dbgapi.h:6570
@ AMD_DBGAPI_EVENT_KIND_WAVE_STOP
A wave has stopped.
Definition amd-dbgapi.h:6471
@ AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME
Request to resume a host breakpoint.
Definition amd-dbgapi.h:6521
@ AMD_DBGAPI_EVENT_KIND_RUNTIME
The runtime support in the inferior is enabled or disabled.
Definition amd-dbgapi.h:6536
@ AMD_DBGAPI_EVENT_KIND_NONE
No event.
Definition amd-dbgapi.h:6467
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize(void) AMD_DBGAPI_VERSION_0_54
Finalize the library.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize(amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_54
Initialize the library.
amd_dbgapi_log_level_t
The logging levels supported.
Definition amd-dbgapi.h:6775
void AMD_DBGAPI amd_dbgapi_set_log_level(amd_dbgapi_log_level_t level) AMD_DBGAPI_VERSION_0_54
Set the logging level.
@ AMD_DBGAPI_LOG_LEVEL_NONE
Print no messages.
Definition amd-dbgapi.h:6779
@ AMD_DBGAPI_LOG_LEVEL_VERBOSE
Print fatal error, warning, info, API tracing, and verbose messages.
Definition amd-dbgapi.h:6800
@ AMD_DBGAPI_LOG_LEVEL_INFO
Print fatal error, warning, and info messages.
Definition amd-dbgapi.h:6792
@ AMD_DBGAPI_LOG_LEVEL_TRACE
Print fatal error, warning, info, and API tracing messages.
Definition amd-dbgapi.h:6796
@ AMD_DBGAPI_LOG_LEVEL_WARNING
Print fatal error and warning messages.
Definition amd-dbgapi.h:6788
@ AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR
Print fatal error messages.
Definition amd-dbgapi.h:6784
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:5444
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.
uint32_t amd_dbgapi_lane_id_t
A wave lane handle.
Definition amd-dbgapi.h:5405
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.
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.
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:5834
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.
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_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.
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.
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:5965
amd_dbgapi_address_space_access_t
Indication of how the address space is accessed.
Definition amd-dbgapi.h:5634
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.
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...
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.
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:6041
amd_dbgapi_address_space_info_t
Address space queries that are supported by amd_dbgapi_address_space_get_info.
Definition amd-dbgapi.h:5660
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.
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...
amd_dbgapi_memory_precision_t
Memory access precision.
Definition amd-dbgapi.h:6362
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME
Return the source language address class name.
Definition amd-dbgapi.h:5451
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_ADDRESS_SPACE
Return the architecture specific address space that is used to implement a pointer or reference to th...
Definition amd-dbgapi.h:5460
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF
Return the AMD GPU DWARF address class number for the address class' architecture.
Definition amd-dbgapi.h:5465
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS
Reading or writing the segment address depends on the process.
Definition amd-dbgapi.h:5989
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE
Reading or writing the segment address depends on the wavefront.
Definition amd-dbgapi.h:5977
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP
Reading or writing the segment address depends on the workgroup.
Definition amd-dbgapi.h:5981
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE
No dependence is available.
Definition amd-dbgapi.h:5969
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE
Reading or writing the segment address depends on the lane.
Definition amd-dbgapi.h:5973
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT
Reading or writing the segment address depends on the agent.
Definition amd-dbgapi.h:5985
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT
The address space is only read the waves of a kernel dispatch.
Definition amd-dbgapi.h:5649
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT
The address space is read only.
Definition amd-dbgapi.h:5644
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL
The address space supports all accesses.
Definition amd-dbgapi.h:5639
@ AMD_DBGAPI_ADDRESS_CLASS_STATE_NOT_MEMBER
The segment address in the address space is not a member of the source language address class.
Definition amd-dbgapi.h:6046
@ AMD_DBGAPI_ADDRESS_CLASS_STATE_MEMBER
The segment address in the address space is a member of the source language address class.
Definition amd-dbgapi.h:6051
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS
Return the address space access.
Definition amd-dbgapi.h:5682
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF
Return the AMD GPU DWARF address space number for the address space's architecture.
Definition amd-dbgapi.h:5687
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE
Return the byte size of an address in the address space.
Definition amd-dbgapi.h:5672
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS
Return the NULL segment address value in the address space.
Definition amd-dbgapi.h:5677
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME
Return the address space name.
Definition amd-dbgapi.h:5667
@ AMD_DBGAPI_MEMORY_PRECISION_NONE
Memory instructions execute normally and a wave does not wait for the memory access to complete.
Definition amd-dbgapi.h:6367
@ AMD_DBGAPI_MEMORY_PRECISION_PRECISE
A wave waits for memory instructions to complete before executing further instructions.
Definition amd-dbgapi.h:6372
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.
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.
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.
amd_dbgapi_wave_creation_t
The kinds of wave creation supported by the hardware.
Definition amd-dbgapi.h:1975
struct amd_dbgapi_client_process_s * amd_dbgapi_client_process_id_t
Opaque client process handle.
Definition amd-dbgapi.h:1635
amd_dbgapi_progress_t
The kinds of progress supported by the library.
Definition amd-dbgapi.h:1902
amd_dbgapi_process_info_t
Process queries that are supported by amd_dbgapi_process_get_info.
Definition amd-dbgapi.h:1665
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.
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.
@ AMD_DBGAPI_WAVE_CREATION_NORMAL
Normal wave creation allows new waves to be created.
Definition amd-dbgapi.h:1979
@ AMD_DBGAPI_WAVE_CREATION_STOP
Stop wave creation prevents new waves from being created.
Definition amd-dbgapi.h:1983
@ AMD_DBGAPI_PROGRESS_NO_FORWARD
No forward progress is needed.
Definition amd-dbgapi.h:1932
@ AMD_DBGAPI_PROGRESS_NORMAL
Normal progress is needed.
Definition amd-dbgapi.h:1908
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT
Return the number of data watchpoints supported by the process.
Definition amd-dbgapi.h:1676
@ AMD_DBGAPI_PROCESS_INFO_PRECISE_MEMORY_SUPPORTED
Return if the architectures of all the agents of a process support controlling memory precision.
Definition amd-dbgapi.h:1688
@ AMD_DBGAPI_PROCESS_INFO_NOTIFIER
The notifier for the process that indicates if pending events are available.
Definition amd-dbgapi.h:1670
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE
Return how watchpoints are shared between processes.
Definition amd-dbgapi.h:1682
@ AMD_DBGAPI_PROCESS_INFO_OS_ID
Native operating system process ID.
Definition amd-dbgapi.h:1698
amd_dbgapi_queue_state_t
Queue state.
Definition amd-dbgapi.h:2587
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.
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_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.
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:2613
amd_dbgapi_queue_info_t
Queue queries that are supported by amd_dbgapi_queue_get_info.
Definition amd-dbgapi.h:2491
@ AMD_DBGAPI_QUEUE_STATE_VALID
Queue is in a valid state.
Definition amd-dbgapi.h:2591
@ AMD_DBGAPI_QUEUE_STATE_ERROR
Queue is in the queue error state.
Definition amd-dbgapi.h:2605
@ AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION
A wave on the queue executed an illegal instruction.
Definition amd-dbgapi.h:2651
@ AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED
A packet on the queue has an unsupported code.
Definition amd-dbgapi.h:2678
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_GROUP_SEGMENT_SIZE_INVALID
A dispatch packet on the queue has an invalid group segment size.
Definition amd-dbgapi.h:2670
@ AMD_DBGAPI_EXCEPTION_WAVE_TRAP
A wave on the queue executed an instruction that caused an exception.
Definition amd-dbgapi.h:2631
@ AMD_DBGAPI_EXCEPTION_WAVE_ABORT
A wave on the queue executed a trap instruction used to abort a dispatch.
Definition amd-dbgapi.h:2621
@ AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR
There was an error preempting the queue.
Definition amd-dbgapi.h:2699
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID
A dispatch packet on the queue has an invalid workgroup size.
Definition amd-dbgapi.h:2682
@ AMD_DBGAPI_EXCEPTION_WAVE_MATH_ERROR
A wave on the queue executed an instruction that had a floating point or integer enabled exception co...
Definition amd-dbgapi.h:2647
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE
A dispatch packet on the queue requires too many registers.
Definition amd-dbgapi.h:2686
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID
A dispatch packet on the queue has a NULL code address.
Definition amd-dbgapi.h:2674
@ AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION
A wave on the queue had a memory violation.
Definition amd-dbgapi.h:2657
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID
A dispatch packet on the queue has an invalid dimension.
Definition amd-dbgapi.h:2666
@ AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION
A wave on the queue had an aperture violation.
Definition amd-dbgapi.h:2662
@ AMD_DBGAPI_EXCEPTION_NONE
If none of the bits are set, then the queue is not in the error state.
Definition amd-dbgapi.h:2617
@ AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED
A packet on the queue has an invalid vendor code.
Definition amd-dbgapi.h:2690
@ AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE
Return the architecture of this queue.
Definition amd-dbgapi.h:2506
@ AMD_DBGAPI_QUEUE_INFO_PROCESS
Return the process to which this queue belongs.
Definition amd-dbgapi.h:2501
@ AMD_DBGAPI_QUEUE_INFO_TYPE
Return the queue type.
Definition amd-dbgapi.h:2511
@ AMD_DBGAPI_QUEUE_INFO_ADDRESS
Return the base address of the memory holding the queue packets.
Definition amd-dbgapi.h:2528
@ AMD_DBGAPI_QUEUE_INFO_STATE
Return the queue state.
Definition amd-dbgapi.h:2516
@ AMD_DBGAPI_QUEUE_INFO_AGENT
Return the agent to which this queue belongs.
Definition amd-dbgapi.h:2496
@ AMD_DBGAPI_QUEUE_INFO_SIZE
Return the size in bytes of the memory holding the queue packets.
Definition amd-dbgapi.h:2533
@ AMD_DBGAPI_QUEUE_INFO_ERROR_REASON
Return the set of exceptions that caused the queue to enter the queue error state.
Definition amd-dbgapi.h:2523
@ AMD_DBGAPI_QUEUE_INFO_OS_ID
Native operating system queue ID.
Definition amd-dbgapi.h:2538
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.
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_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.
amd_dbgapi_register_properties_t
A bit mask on register properties.
Definition amd-dbgapi.h:4748
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.
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.
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.
amd_dbgapi_register_info_t
Register queries that are supported by amd_dbgapi_register_get_info.
Definition amd-dbgapi.h:4782
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.
amd_dbgapi_register_class_info_t
Register class queries that are supported by amd_dbgapi_architecture_register_class_get_info.
Definition amd-dbgapi.h:4619
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.
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.
amd_dbgapi_register_exists_t
Indication of if a wave has a register.
Definition amd-dbgapi.h:4928
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_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.
amd_dbgapi_register_class_state_t
Indication of whether a register is a member of a register class.
Definition amd-dbgapi.h:5115
@ AMD_DBGAPI_REGISTER_PROPERTY_INVALIDATE_VOLATILE
Changing the value of the register may change a register of the same wavefront with the AMD_DBGAPI_RE...
Definition amd-dbgapi.h:4772
@ AMD_DBGAPI_REGISTER_PROPERTY_NONE
There are no properties.
Definition amd-dbgapi.h:4752
@ AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS
At least one bit of the register value is readonly.
Definition amd-dbgapi.h:4758
@ AMD_DBGAPI_REGISTER_PROPERTY_VOLATILE
The register value may change as a consequence of changing a register of the same wavefront with the ...
Definition amd-dbgapi.h:4765
@ AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE
Return the architecture to which this register belongs.
Definition amd-dbgapi.h:4787
@ AMD_DBGAPI_REGISTER_INFO_NAME
Return the register name.
Definition amd-dbgapi.h:4794
@ AMD_DBGAPI_REGISTER_INFO_SIZE
Return the size of the register in bytes.
Definition amd-dbgapi.h:4799
@ AMD_DBGAPI_REGISTER_INFO_PROPERTIES
Return the register's properties.
Definition amd-dbgapi.h:4874
@ AMD_DBGAPI_REGISTER_INFO_DWARF
Return the AMD GPU DWARF register number for the register's architecture.
Definition amd-dbgapi.h:4869
@ AMD_DBGAPI_REGISTER_INFO_TYPE
Return the register type as a C style type string.
Definition amd-dbgapi.h:4860
@ AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE
Return the architecture to which this register class belongs.
Definition amd-dbgapi.h:4624
@ AMD_DBGAPI_REGISTER_CLASS_INFO_NAME
Return the register class name.
Definition amd-dbgapi.h:4631
@ AMD_DBGAPI_REGISTER_ABSENT
The wave does not have the register.
Definition amd-dbgapi.h:4932
@ AMD_DBGAPI_REGISTER_PRESENT
The wave has the register.
Definition amd-dbgapi.h:4936
@ AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER
The register is not a member of the register class.
Definition amd-dbgapi.h:5119
@ AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER
The register is a member of the register class.
Definition amd-dbgapi.h:5123
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.
amd_dbgapi_status_t
AMD debugger API status codes.
Definition amd-dbgapi.h:751
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID
The register class handle is invalid.
Definition amd-dbgapi.h:918
@ AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID
The lane handle is invalid.
Definition amd-dbgapi.h:926
@ AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID
The breakpoint handle is invalid.
Definition amd-dbgapi.h:950
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID
The code object handle is invalid.
Definition amd-dbgapi.h:843
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID
The workgroup handle is invalid.
Definition amd-dbgapi.h:971
@ AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE
No more watchpoints available.
Definition amd-dbgapi.h:914
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID
The wave handle is invalid.
Definition amd-dbgapi.h:872
@ AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS
An error occurred while trying to access memory in the inferior.
Definition amd-dbgapi.h:938
@ AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION
The bytes being disassembled are not a legal instruction.
Definition amd-dbgapi.h:839
@ AMD_DBGAPI_STATUS_SUCCESS
The function has executed successfully.
Definition amd-dbgapi.h:755
@ AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED
The operation is not supported.
Definition amd-dbgapi.h:795
@ AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE
The wave has an active displaced stepping buffer.
Definition amd-dbgapi.h:901
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED
The library is already initialized.
Definition amd-dbgapi.h:807
@ AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_NOT_AVAILABLE
No more displaced stepping buffers are available that are suitable for the requested wave.
Definition amd-dbgapi.h:897
@ AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP
The wave has an outstanding stop request.
Definition amd-dbgapi.h:884
@ AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID
The agent handle is invalid.
Definition amd-dbgapi.h:860
@ AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED
The library is not initialized.
Definition amd-dbgapi.h:811
@ AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND
The symbol was not found.
Definition amd-dbgapi.h:962
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY
An invalid combination of arguments was given to the function.
Definition amd-dbgapi.h:803
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID
The watchpoint handle is invalid.
Definition amd-dbgapi.h:910
@ AMD_DBGAPI_STATUS_ERROR_RESUME_DISPLACED_STEPPING
The wave cannot be resumed in the manner requested due to displaced stepping restrictions.
Definition amd-dbgapi.h:906
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED
The native operating system process associated with a client process has exited.
Definition amd-dbgapi.h:856
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID
The client process handle is invalid.
Definition amd-dbgapi.h:958
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID
The architecture handle is invalid.
Definition amd-dbgapi.h:835
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT
An invalid argument was given to the function.
Definition amd-dbgapi.h:799
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID
The address class handle is invalid.
Definition amd-dbgapi.h:930
@ AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID
The event handle is invalid.
Definition amd-dbgapi.h:946
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED
The wave is not stopped.
Definition amd-dbgapi.h:876
@ AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED
The wave is stopped.
Definition amd-dbgapi.h:880
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID
The address space handle is invalid.
Definition amd-dbgapi.h:934
@ AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID
The process handle is invalid.
Definition amd-dbgapi.h:851
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE
The wave cannot be resumed.
Definition amd-dbgapi.h:888
@ AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED
The operation is not currently implemented.
Definition amd-dbgapi.h:787
@ AMD_DBGAPI_STATUS_ERROR_RESTRICTION
There is a restriction error that prevents debugging the process.
Definition amd-dbgapi.h:827
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION
The segment address cannot be converted to the requested address space.
Definition amd-dbgapi.h:942
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE
The ELF AMD GPU machine value is invalid or unsupported.
Definition amd-dbgapi.h:847
@ AMD_DBGAPI_STATUS_FATAL
A fatal error has occurred.
Definition amd-dbgapi.h:781
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID
The displaced stepping handle is invalid.
Definition amd-dbgapi.h:892
@ AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK
A callback to the client reported an error.
Definition amd-dbgapi.h:954
@ AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE
The requested information is not available.
Definition amd-dbgapi.h:791
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED
The process is already attached to the given inferior process.
Definition amd-dbgapi.h:831
@ AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID
The queue handle is invalid.
Definition amd-dbgapi.h:864
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID
The register handle is invalid.
Definition amd-dbgapi.h:922
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID
The dispatch handle is invalid.
Definition amd-dbgapi.h:868
@ AMD_DBGAPI_STATUS_ERROR_REGISTER_NOT_AVAILABLE
The register handle is valid, but specifies a register that is not allocated in the associated wave.
Definition amd-dbgapi.h:967
@ AMD_DBGAPI_STATUS_ERROR
A generic error has occurred.
Definition amd-dbgapi.h:759
#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:549
#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:543
#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:567
#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:555
#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:537
#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:561
#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:579
#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:573
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.
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_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.
amd_dbgapi_watchpoint_info_t
Watchpoint queries that are supported by amd_dbgapi_watchpoint_get_info.
Definition amd-dbgapi.h:4358
amd_dbgapi_watchpoint_kind_t
Watchpoint memory access kinds.
Definition amd-dbgapi.h:4452
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.
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.
amd_dbgapi_watchpoint_share_kind_t
The way watchpoints are shared between processes.
Definition amd-dbgapi.h:4426
@ AMD_DBGAPI_WATCHPOINT_INFO_PROCESS
Return the process to which this watchpoint belongs.
Definition amd-dbgapi.h:4363
@ AMD_DBGAPI_WATCHPOINT_INFO_SIZE
The byte size of the created watchpoint.
Definition amd-dbgapi.h:4373
@ AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS
The base address of the created watchpoint.
Definition amd-dbgapi.h:4368
@ AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW
Write access by store instructions or read-modify-write access by atomic instructions.
Definition amd-dbgapi.h:4461
@ AMD_DBGAPI_WATCHPOINT_KIND_ALL
Read, write, or read-modify-write access by load, store, or atomic instructions.
Definition amd-dbgapi.h:4470
@ AMD_DBGAPI_WATCHPOINT_KIND_LOAD
Read access by load instructions.
Definition amd-dbgapi.h:4456
@ AMD_DBGAPI_WATCHPOINT_KIND_RMW
Read-modify-write access by atomic instructions.
Definition amd-dbgapi.h:4465
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED
The watchpoints are not shared across processes.
Definition amd-dbgapi.h:4436
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED
The watchpoints of a process are shared between all processes.
Definition amd-dbgapi.h:4442
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED
Watchpoints are not supported.
Definition amd-dbgapi.h:4430
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.
amd_dbgapi_wave_state_t
The execution state of a wave.
Definition amd-dbgapi.h:3473
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.
amd_dbgapi_resume_mode_t
The mode in which to resuming the execution of a wave.
Definition amd-dbgapi.h:3828
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.
amd_dbgapi_wave_stop_reasons_t
A bit mask of the reasons that a wave stopped.
Definition amd-dbgapi.h:3505
amd_dbgapi_wave_info_t
Wave queries that are supported by amd_dbgapi_wave_get_info.
Definition amd-dbgapi.h:3309
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.
@ AMD_DBGAPI_WAVE_STATE_STOP
The wave is stopped.
Definition amd-dbgapi.h:3495
@ AMD_DBGAPI_WAVE_STATE_SINGLE_STEP
The wave is running in single-step mode.
Definition amd-dbgapi.h:3482
@ AMD_DBGAPI_WAVE_STATE_RUN
The wave is running.
Definition amd-dbgapi.h:3477
@ AMD_DBGAPI_RESUME_MODE_SINGLE_STEP
Resume execution in in single step mode.
Definition amd-dbgapi.h:3836
@ AMD_DBGAPI_RESUME_MODE_NORMAL
Resume normal execution.
Definition amd-dbgapi.h:3832
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_DIVIDE_BY_0
The wave stopped due to triggering an enabled floating point divide by zero exception.
Definition amd-dbgapi.h:3548
@ AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT
The wave stopped due to triggering a data watchpoint.
Definition amd-dbgapi.h:3528
@ AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION
The wave stopped due to a memory violation.
Definition amd-dbgapi.h:3645
@ AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP
The wave stopped due to completing an instruction single-step.
Definition amd-dbgapi.h:3532
@ AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION
The wave stopped due to executing an illegal instruction.
Definition amd-dbgapi.h:3669
@ AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP
The wave stopped due to executing a debug trap instruction.
Definition amd-dbgapi.h:3603
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_INPUT_DENORMAL
The wave stopped due to triggering an enabled floating point input denormal exception.
Definition amd-dbgapi.h:3540
@ AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR
The wave stopped due to detecting an unrecoverable ECC error.
Definition amd-dbgapi.h:3682
@ AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT
The wave stopped after causing a hardware fatal halt.
Definition amd-dbgapi.h:3689
@ AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP
The wave stopped due to executing an assert trap instruction.
Definition amd-dbgapi.h:3619
@ AMD_DBGAPI_WAVE_STOP_REASON_NONE
If none of the bits are set, then amd_dbgapi_wave_stop stopped the wave.
Definition amd-dbgapi.h:3510
@ AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT
The wave stopped due to executing a breakpoint instruction.
Definition amd-dbgapi.h:3516
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_INVALID_OPERATION
The wave stopped due to triggering an enabled floating point invalid operation exception.
Definition amd-dbgapi.h:3580
@ AMD_DBGAPI_WAVE_STOP_REASON_TRAP
The wave stopped due to executing a trap instruction other than the AMD_DBGAPI_WAVE_STOP_REASON_DEBUG...
Definition amd-dbgapi.h:3629
@ AMD_DBGAPI_WAVE_STOP_REASON_INT_DIVIDE_BY_0
The wave stopped due to triggering an enabled integer divide by zero exception.
Definition amd-dbgapi.h:3588
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW
The wave stopped due to triggering an enabled floating point underflow exception.
Definition amd-dbgapi.h:3564
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT
The wave stopped due to triggering an enabled floating point inexact exception.
Definition amd-dbgapi.h:3572
@ AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION
The wave stopped due to an aperture violation.
Definition amd-dbgapi.h:3660
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW
The wave stopped due to triggering an enabled floating point overflow exception.
Definition amd-dbgapi.h:3556
@ AMD_DBGAPI_WAVE_INFO_ARCHITECTURE
Return the architecture of this wave.
Definition amd-dbgapi.h:3374
@ AMD_DBGAPI_WAVE_INFO_DISPATCH
Return the dispatch to which this wave belongs.
Definition amd-dbgapi.h:3354
@ AMD_DBGAPI_WAVE_INFO_QUEUE
Return the queue to which this wave belongs.
Definition amd-dbgapi.h:3359
@ AMD_DBGAPI_WAVE_INFO_EXEC_MASK
Return the current execution mask of the wave.
Definition amd-dbgapi.h:3388
@ AMD_DBGAPI_WAVE_INFO_WORKGROUP
Return the workgroup to which this wave belongs.
Definition amd-dbgapi.h:3344
@ AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP
The wave's number in the workgroup.
Definition amd-dbgapi.h:3411
@ AMD_DBGAPI_WAVE_INFO_STATE
Return the wave's state.
Definition amd-dbgapi.h:3314
@ AMD_DBGAPI_WAVE_INFO_PROCESS
Return the process to which this wave belongs.
Definition amd-dbgapi.h:3369
@ AMD_DBGAPI_WAVE_INFO_AGENT
Return the agent to which this wave belongs.
Definition amd-dbgapi.h:3364
@ AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD
The wave workgroup coordinate in the dispatch grid dimensions.
Definition amd-dbgapi.h:3399
@ AMD_DBGAPI_WAVE_INFO_WATCHPOINTS
Return the watchpoint(s) the wave triggered.
Definition amd-dbgapi.h:3334
@ AMD_DBGAPI_WAVE_INFO_LANE_COUNT
The number of lanes supported by the wave.
Definition amd-dbgapi.h:3416
@ AMD_DBGAPI_WAVE_INFO_PC
Return the current program counter value of the wave.
Definition amd-dbgapi.h:3380
@ AMD_DBGAPI_WAVE_INFO_STOP_REASON
Return the reason the wave stopped as a bit set.
Definition amd-dbgapi.h:3321
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.
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.
amd_dbgapi_workgroup_info_t
Workgroup queries that are supported by amd_dbgapi_workgroup_get_info.
Definition amd-dbgapi.h:3131
@ AMD_DBGAPI_WORKGROUP_INFO_QUEUE
Return the queue to which this workgroup belongs.
Definition amd-dbgapi.h:3146
@ AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE
Return the architecture of this workgroup.
Definition amd-dbgapi.h:3161
@ AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD
The workgroup workgroup coordinate in the dispatch grid dimensions.
Definition amd-dbgapi.h:3172
@ AMD_DBGAPI_WORKGROUP_INFO_DISPATCH
Return the dispatch to which this workgroup belongs.
Definition amd-dbgapi.h:3141
@ AMD_DBGAPI_WORKGROUP_INFO_PROCESS
Return the process to which this workgroup belongs.
Definition amd-dbgapi.h:3156
@ AMD_DBGAPI_WORKGROUP_INFO_AGENT
Return the agent to which this workgroup belongs.
Definition amd-dbgapi.h:3151
Opaque source language address class handle.
Definition amd-dbgapi.h:5426
uint64_t handle
Definition amd-dbgapi.h:5427
Opaque address space handle.
Definition amd-dbgapi.h:5611
uint64_t handle
Definition amd-dbgapi.h:5612
Opaque agent handle.
Definition amd-dbgapi.h:2242
uint64_t handle
Definition amd-dbgapi.h:2243
Opaque architecture handle.
Definition amd-dbgapi.h:1149
uint64_t handle
Definition amd-dbgapi.h:1150
Opaque breakpoint handle.
Definition amd-dbgapi.h:6850
uint64_t handle
Definition amd-dbgapi.h:6851
Callbacks that the client of the library must provide.
Definition amd-dbgapi.h:6993
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:7053
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:7127
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:7092
void(* deallocate_memory)(void *data)
Deallocate memory that was allocated by amd_dbgapi_callbacks_s::allocate_memory.
Definition amd-dbgapi.h:7024
void(* log_message)(amd_dbgapi_log_level_t level, const char *message)
Report a log message.
Definition amd-dbgapi.h:7139
Opaque code object handle.
Definition amd-dbgapi.h:2041
uint64_t handle
Definition amd-dbgapi.h:2042
Instruction information for direct call instructions.
Definition amd-dbgapi.h:5361
amd_dbgapi_global_address_t target_address
Definition amd-dbgapi.h:5362
Opaque dispatch handle.
Definition amd-dbgapi.h:2847
uint64_t handle
Definition amd-dbgapi.h:2848
Opaque displaced stepping handle.
Definition amd-dbgapi.h:4096
uint64_t handle
Definition amd-dbgapi.h:4097
Opaque event handle.
Definition amd-dbgapi.h:6449
uint64_t handle
Definition amd-dbgapi.h:6450
Opaque process handle.
Definition amd-dbgapi.h:1648
uint64_t handle
Definition amd-dbgapi.h:1649
Opaque queue handle.
Definition amd-dbgapi.h:2474
uint64_t handle
Definition amd-dbgapi.h:2475
Opaque register class handle.
Definition amd-dbgapi.h:4601
uint64_t handle
Definition amd-dbgapi.h:4602
Opaque register handle.
Definition amd-dbgapi.h:4731
uint64_t handle
Definition amd-dbgapi.h:4732
Opaque hardware data watchpoint handle.
Definition amd-dbgapi.h:4341
uint64_t handle
Definition amd-dbgapi.h:4342
A set of watchpoints.
Definition amd-dbgapi.h:4480
amd_dbgapi_watchpoint_id_t * watchpoint_ids
Definition amd-dbgapi.h:4482
size_t count
Definition amd-dbgapi.h:4481
Opaque wave handle.
Definition amd-dbgapi.h:3292
uint64_t handle
Definition amd-dbgapi.h:3293
Opaque workgroup handle.
Definition amd-dbgapi.h:3114
uint64_t handle
Definition amd-dbgapi.h:3115