AMD_DBGAPI  0.36.0
amd-dbgapi.h
Go to the documentation of this file.
1 /* Copyright (c) 2019-2020 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 
396 #ifndef AMD_DBGAPI_H
397 #define AMD_DBGAPI_H 1
398 
399 /* Placeholder for calling convention and import/export macros */
400 #if !defined(AMD_DBGAPI_CALL)
401 #define AMD_DBGAPI_CALL
402 #endif /* !defined (AMD_DBGAPI_CALL) */
403 
404 #if !defined(AMD_DBGAPI_EXPORT_DECORATOR)
405 #if defined(__GNUC__)
406 #define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default")))
407 #elif defined(_MSC_VER)
408 #define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)
409 #endif /* defined (_MSC_VER) */
410 #endif /* !defined (AMD_DBGAPI_EXPORT_DECORATOR) */
411 
412 #if !defined(AMD_DBGAPI_IMPORT_DECORATOR)
413 #if defined(__GNUC__)
414 #define AMD_DBGAPI_IMPORT_DECORATOR
415 #elif defined(_MSC_VER)
416 #define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)
417 #endif /* defined (_MSC_VER) */
418 #endif /* !defined (AMD_DBGAPI_IMPORT_DECORATOR) */
419 
420 #define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL
421 #define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL
422 
423 #if !defined(AMD_DBGAPI)
424 #if defined(AMD_DBGAPI_EXPORTS)
425 #define AMD_DBGAPI AMD_DBGAPI_EXPORT
426 #else /* !defined (AMD_DBGAPI_EXPORTS) */
427 #define AMD_DBGAPI AMD_DBGAPI_IMPORT
428 #endif /* !defined (AMD_DBGAPI_EXPORTS) */
429 #endif /* !defined (AMD_DBGAPI) */
430 
431 #if defined(__cplusplus)
432 extern "C" {
433 #endif /* defined (__cplusplus) */
434 
435 #if defined(__linux__)
436 #include <sys/types.h>
437 #endif /* __linux__ */
438 
439 #include <stddef.h>
440 #include <stdint.h>
441 
461 #define AMD_DBGAPI_VERSION_0_24
462 
467 #define AMD_DBGAPI_VERSION_0_30
468 
473 #define AMD_DBGAPI_VERSION_0_36
474 
482 
510 
514 typedef uint64_t amd_dbgapi_size_t;
515 
519 typedef enum
520 {
530 
538 #if defined(__linux__)
540 #endif /* __linux__ */
541 
565 #if defined(__linux__)
567 #endif /* __linux__ */
568 
576 #if defined(__linux__)
577 typedef uint64_t amd_dbgapi_os_agent_id_t;
578 #endif /* __linux__ */
579 
586 #if defined(__linux__)
587 typedef uint64_t amd_dbgapi_os_queue_id_t;
588 #endif /* __linux__ */
589 
598 #if defined(__linux__)
600 #endif /* __linux__ */
601 
609 #if defined(__linux__)
610 typedef enum
611 {
670 #endif /* __linux__ */
671 
684 typedef enum
685 {
897 
915  amd_dbgapi_status_t status,
916  const char **status_string) AMD_DBGAPI_VERSION_0_24;
917 
941 #define AMD_DBGAPI_VERSION_MAJOR 0
942 
947 #define AMD_DBGAPI_VERSION_MINOR 36
948 
963  uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_24;
964 
973 const char AMD_DBGAPI *
975 
1023 
1050 
1071 typedef struct
1072 {
1073  uint64_t handle;
1075 
1079 #define AMD_DBGAPI_ARCHITECTURE_NONE (amd_dbgapi_architecture_id_t{ 0 })
1088 typedef enum
1089 {
1141 
1180  amd_dbgapi_architecture_id_t architecture_id,
1181  amd_dbgapi_architecture_info_t query, size_t value_size,
1182  void *value) AMD_DBGAPI_VERSION_0_30;
1183 
1213  uint32_t elf_amdgpu_machine,
1215 
1222 typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;
1223 
1316  amd_dbgapi_architecture_id_t architecture_id,
1318  const void *memory, char **instruction_text,
1319  amd_dbgapi_symbolizer_id_t symbolizer_id,
1320  amd_dbgapi_status_t (*symbolizer) (
1321  amd_dbgapi_symbolizer_id_t symbolizer_id,
1323  char **symbol_text)) AMD_DBGAPI_VERSION_0_30;
1324 
1328 typedef enum
1329 {
1428 
1494  amd_dbgapi_architecture_id_t architecture_id,
1496  const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind,
1497  void **instruction_properties) AMD_DBGAPI_VERSION_0_24;
1498 
1520 typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;
1521 
1532 typedef struct
1533 {
1534  uint64_t handle;
1536 
1540 #define AMD_DBGAPI_PROCESS_NONE (amd_dbgapi_process_id_t{ 0 })
1548 typedef enum
1549 {
1579 
1619  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_36;
1620 
1690  amd_dbgapi_client_process_id_t client_process_id,
1692 
1739 
1754 typedef enum
1755 {
1787 
1811  amd_dbgapi_process_id_t process_id,
1813 
1825 typedef enum
1826 {
1836 
1862  amd_dbgapi_process_id_t process_id,
1864 
1891 typedef struct
1892 {
1893  uint64_t handle;
1895 
1899 #define AMD_DBGAPI_CODE_OBJECT_NONE (amd_dbgapi_code_object_id_t{ 0 })
1907 typedef enum
1908 {
1965 
2009  amd_dbgapi_process_id_t process_id,
2010  amd_dbgapi_code_object_id_t code_object_id,
2011  amd_dbgapi_code_object_info_t query, size_t value_size,
2012  void *value) AMD_DBGAPI_VERSION_0_24;
2013 
2063  amd_dbgapi_process_id_t process_id, size_t *code_object_count,
2064  amd_dbgapi_code_object_id_t **code_objects,
2066 
2083 typedef struct
2084 {
2085  uint64_t handle;
2087 
2091 #define AMD_DBGAPI_AGENT_NONE (amd_dbgapi_agent_id_t{ 0 })
2099 typedef enum
2100 {
2142 
2186  amd_dbgapi_process_id_t process_id, amd_dbgapi_agent_id_t agent_id,
2187  amd_dbgapi_agent_info_t query, size_t value_size,
2188  void *value) AMD_DBGAPI_VERSION_0_36;
2189 
2236 amd_dbgapi_agent_list (amd_dbgapi_process_id_t process_id, size_t *agent_count,
2237  amd_dbgapi_agent_id_t **agents,
2239 
2258 typedef struct
2259 {
2260  uint64_t handle;
2262 
2266 #define AMD_DBGAPI_QUEUE_NONE (amd_dbgapi_queue_id_t{ 0 })
2274 typedef enum
2275 {
2319 
2363  amd_dbgapi_process_id_t process_id, amd_dbgapi_queue_id_t queue_id,
2364  amd_dbgapi_queue_info_t query, size_t value_size,
2365  void *value) AMD_DBGAPI_VERSION_0_36;
2366 
2370 typedef enum
2371 {
2385 
2389 typedef enum
2390 {
2419 
2466 amd_dbgapi_queue_list (amd_dbgapi_process_id_t process_id, size_t *queue_count,
2467  amd_dbgapi_queue_id_t **queues,
2469 
2540  amd_dbgapi_process_id_t process_id, amd_dbgapi_queue_id_t queue_id,
2541  amd_dbgapi_os_queue_packet_id_t *read_packet_id, amd_dbgapi_os_queue_packet_id_t *write_packet_id,
2542  size_t *packets_byte_size, void **packets_bytes) AMD_DBGAPI_VERSION_0_36;
2543 
2562 typedef struct
2563 {
2564  uint64_t handle;
2566 
2570 #define AMD_DBGAPI_DISPATCH_NONE (amd_dbgapi_dispatch_id_t{ 0 })
2578 typedef enum
2579 {
2668 
2715  amd_dbgapi_process_id_t process_id, amd_dbgapi_dispatch_id_t dispatch_id,
2716  amd_dbgapi_dispatch_info_t query, size_t value_size,
2717  void *value) AMD_DBGAPI_VERSION_0_36;
2718 
2725 typedef enum
2726 {
2737 
2744 typedef enum
2745 {
2759 
2801  amd_dbgapi_process_id_t process_id, size_t *dispatch_count,
2802  amd_dbgapi_dispatch_id_t **dispatches,
2804 
2821 typedef struct
2822 {
2823  uint64_t handle;
2825 
2829 #define AMD_DBGAPI_WAVE_NONE (amd_dbgapi_wave_id_t{ 0 })
2837 typedef enum
2838 {
2925 
2973  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
2974  amd_dbgapi_wave_info_t query, size_t value_size,
2975  void *value) AMD_DBGAPI_VERSION_0_30;
2976 
2980 typedef enum
2981 {
3005 
3012 typedef enum
3013 {
3197 
3243 amd_dbgapi_wave_list (amd_dbgapi_process_id_t process_id, size_t *wave_count,
3244  amd_dbgapi_wave_id_t **waves,
3246 
3333 
3337 typedef enum
3338 {
3348 
3455  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
3457 
3551 typedef struct
3552 {
3553  uint64_t handle;
3555 
3559 #define AMD_DBGAPI_DISPLACED_STEPPING_NONE \
3560  (amd_dbgapi_displaced_stepping_id_t{ 0 })
3561 
3639  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
3640  const void *saved_instruction_bytes,
3641  amd_dbgapi_displaced_stepping_id_t *displaced_stepping)
3643 
3694  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
3695  amd_dbgapi_displaced_stepping_id_t displaced_stepping)
3697 
3731 typedef struct
3732 {
3733  uint64_t handle;
3735 
3739 #define AMD_DBGAPI_WATCHPOINT_NONE (amd_dbgapi_watchpoint_id_t{ 0 })
3747 typedef enum
3748 {
3766 
3773 typedef enum
3774 {
3794 
3801 typedef struct
3802 {
3803  size_t count;
3806 
3885  amd_dbgapi_watchpoint_id_t *watchpoint_id,
3886  amd_dbgapi_global_address_t *watchpoint_address,
3887  amd_dbgapi_size_t *watchpoint_size) AMD_DBGAPI_VERSION_0_36;
3888 
3914  amd_dbgapi_process_id_t process_id,
3916 
3938 typedef struct
3939 {
3940  uint64_t handle;
3942 
3946 #define AMD_DBGAPI_REGISTER_CLASS_NONE (amd_dbgapi_register_class_id_t{ 0 })
3955 typedef enum
3956 {
3965 
4011  amd_dbgapi_architecture_id_t architecture_id,
4012  amd_dbgapi_register_class_id_t register_class_id,
4013  amd_dbgapi_register_class_info_t query, size_t value_size,
4014  void *value) AMD_DBGAPI_VERSION_0_24;
4015 
4057  amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count,
4059 
4068 typedef struct
4069 {
4070  uint64_t handle;
4072 
4076 #define AMD_DBGAPI_REGISTER_NONE (amd_dbgapi_register_id_t{ 0 })
4087 typedef enum
4088 {
4129 
4174  amd_dbgapi_architecture_id_t architecture_id,
4176  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_24;
4177 
4226  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
4228  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_24;
4229 
4275  amd_dbgapi_architecture_id_t architecture_id, size_t *register_count,
4277 
4325  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
4326  size_t *register_count,
4328 
4360  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register,
4362 
4366 typedef enum
4367 {
4377 
4420  amd_dbgapi_architecture_id_t architecture_id,
4421  amd_dbgapi_register_id_t register_id,
4422  amd_dbgapi_register_class_id_t register_class_id,
4423  amd_dbgapi_register_class_state_t *register_class_state)
4425 
4488  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
4489  amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t offset,
4490  amd_dbgapi_size_t value_size, void *value) AMD_DBGAPI_VERSION_0_24;
4491 
4553  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
4554  amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t offset,
4555  amd_dbgapi_size_t value_size, const void *value) AMD_DBGAPI_VERSION_0_24;
4556 
4610  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
4611  amd_dbgapi_register_id_t register_id,
4613 
4653 typedef uint32_t amd_dbgapi_lane_id_t;
4654 
4658 #define AMD_DBGAPI_LANE_NONE ((amd_dbgapi_lane_id_t) (-1))
4673 typedef struct
4674 {
4675  uint64_t handle;
4677 
4681 #define AMD_DBGAPI_ADDRESS_CLASS_NONE (amd_dbgapi_address_class_id_t{ 0 })
4690 typedef enum
4691 {
4709 
4756  amd_dbgapi_architecture_id_t architecture_id,
4757  amd_dbgapi_address_class_id_t address_class_id,
4758  amd_dbgapi_address_class_info_t query, size_t value_size,
4759  void *value) AMD_DBGAPI_VERSION_0_24;
4760 
4803  amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count,
4805 
4840  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class,
4842 
4854 typedef struct
4855 {
4856  uint64_t handle;
4858 
4862 #define AMD_DBGAPI_ADDRESS_SPACE_NONE (amd_dbgapi_address_space_id_t{ 0 })
4870 #define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL (amd_dbgapi_address_space_id_t{ 1 })
4875 typedef enum
4876 {
4893 
4901 typedef enum
4902 {
4926 
4970  amd_dbgapi_architecture_id_t architecture_id,
4971  amd_dbgapi_address_space_id_t address_space_id,
4972  amd_dbgapi_address_space_info_t query, size_t value_size,
4973  void *value) AMD_DBGAPI_VERSION_0_30;
4974 
5014  amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count,
5016 
5051  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space,
5053 
5057 typedef enum
5058 {
5068 
5111  amd_dbgapi_architecture_id_t architecture_id,
5112  amd_dbgapi_address_space_id_t address_space_id1,
5113  amd_dbgapi_address_space_id_t address_space_id2,
5114  amd_dbgapi_address_space_alias_t *address_space_alias)
5116 
5134 
5211  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
5212  amd_dbgapi_lane_id_t lane_id,
5213  amd_dbgapi_address_space_id_t source_address_space_id,
5214  amd_dbgapi_segment_address_t source_segment_address,
5215  amd_dbgapi_address_space_id_t destination_address_space_id,
5216  amd_dbgapi_segment_address_t *destination_segment_address)
5218 
5223 typedef enum
5224 {
5236 
5301  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
5302  amd_dbgapi_lane_id_t lane_id,
5303  amd_dbgapi_address_space_id_t address_space_id,
5304  amd_dbgapi_segment_address_t segment_address,
5305  amd_dbgapi_address_class_id_t address_class_id,
5306  amd_dbgapi_address_class_state_t *address_class_state)
5308 
5391  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
5392  amd_dbgapi_lane_id_t lane_id,
5393  amd_dbgapi_address_space_id_t address_space_id,
5394  amd_dbgapi_segment_address_t segment_address,
5395  amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_30;
5396 
5479  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
5480  amd_dbgapi_lane_id_t lane_id,
5481  amd_dbgapi_address_space_id_t address_space_id,
5482  amd_dbgapi_segment_address_t segment_address,
5483  amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_30;
5484 
5503 typedef enum
5504 {
5516 
5556  amd_dbgapi_process_id_t process_id,
5558 
5590 typedef struct
5591 {
5592  uint64_t handle;
5594 
5598 #define AMD_DBGAPI_EVENT_NONE (amd_dbgapi_event_id_t{ 0 })
5603 typedef enum
5604 {
5704 
5735  amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id,
5737 
5741 typedef enum
5742 {
5758 
5765 typedef enum
5766 {
5796 
5841  amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t event_id,
5842  amd_dbgapi_event_info_t query, size_t value_size,
5843  void *value) AMD_DBGAPI_VERSION_0_30;
5844 
5875  amd_dbgapi_process_id_t process_id,
5877 
5899 typedef enum
5900 {
5923 
5944 
5969 typedef struct
5970 {
5971  uint64_t handle;
5973 
5977 typedef enum
5978 {
5988 
5992 #define AMD_DBGAPI_SHARED_LIBRARY_NONE (amd_dbgapi_shared_library_id_t{ 0 })
6037  amd_dbgapi_process_id_t process_id,
6038  amd_dbgapi_shared_library_id_t shared_library_id,
6039  amd_dbgapi_shared_library_state_t shared_library_state)
6041 
6054 typedef struct
6055 {
6056  uint64_t handle;
6058 
6062 #define AMD_DBGAPI_BREAKPOINT_NONE ((amd_dbgapi_breakpoint_id_t) (0))
6067 typedef enum
6068 {
6078 
6088 typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;
6089 
6134  amd_dbgapi_process_id_t process_id,
6135  amd_dbgapi_breakpoint_id_t breakpoint_id,
6136  amd_dbgapi_client_thread_id_t client_thread_id,
6138 
6146 {
6147 
6159  void *(*allocate_memory) (size_t byte_size);
6160 
6177  void (*deallocate_memory) (void *data);
6178 
6207  amd_dbgapi_client_process_id_t client_process_id,
6208  amd_dbgapi_os_process_id_t *os_pid);
6209 
6245  amd_dbgapi_client_process_id_t client_process_id,
6246  const char *shared_library_name,
6247  amd_dbgapi_shared_library_id_t shared_library_id,
6248  amd_dbgapi_shared_library_state_t *shared_library_state);
6249 
6273  amd_dbgapi_client_process_id_t client_process_id,
6274  amd_dbgapi_shared_library_id_t shared_library_id);
6308  amd_dbgapi_client_process_id_t client_process_id,
6309  amd_dbgapi_shared_library_id_t shared_library_id,
6310  const char *symbol_name, amd_dbgapi_global_address_t *address);
6311 
6360  amd_dbgapi_client_process_id_t client_process_id,
6361  amd_dbgapi_shared_library_id_t shared_library_id,
6363  amd_dbgapi_breakpoint_id_t breakpoint_id);
6364 
6396  amd_dbgapi_client_process_id_t client_process_id,
6397  amd_dbgapi_breakpoint_id_t breakpoint_id);
6398 
6407  void (*log_message) (amd_dbgapi_log_level_t level, const char *message);
6408 };
6409 
6412 #if defined(__cplusplus)
6413 } /* extern "C" */
6414 #endif /* defined (__cplusplus) */
6415 
6416 #endif /* amd-dbgapi.h */
AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_MULTIPLE_PRODUCER
@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_MULTIPLE_PRODUCER
Queue supports the HSA kernel dispatch with multiple producers protocol.
Definition: amd-dbgapi.h:630
AMD_DBGAPI_WAVE_STOP_REASON_NONE
@ 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:3018
amd_dbgapi_write_register
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_register(amd_dbgapi_process_id_t process_id, 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_24
Write a register.
AMD_DBGAPI_QUEUE_ERROR_REASON_MEMORY_VIOLATION
@ AMD_DBGAPI_QUEUE_ERROR_REASON_MEMORY_VIOLATION
A wave on the queue had a memory violation.
Definition: amd-dbgapi.h:2402
AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_COOPERATIVE
@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_COOPERATIVE
Queue supports HSA kernel dispatch with multiple producers protocol that supports cooperative dispatc...
Definition: amd-dbgapi.h:656
AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORK_GROUP
@ AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORK_GROUP
The wave's number in the workgroup.
Definition: amd-dbgapi.h:2918
amd_dbgapi_client_process_id_t
struct amd_dbgapi_client_process_s * amd_dbgapi_client_process_id_t
Opaque client process handle.
Definition: amd-dbgapi.h:1520
AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE
@ AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE
Return the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture.
Definition: amd-dbgapi.h:1104
amd_dbgapi_architecture_id_t
Opaque architecture handle.
Definition: amd-dbgapi.h:1072
amd_dbgapi_dispatch_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Return the list of dispatches for a process.
AMD_DBGAPI_STATUS_FATAL
@ AMD_DBGAPI_STATUS_FATAL
A fatal error has occurred.
Definition: amd-dbgapi.h:715
AMD_DBGAPI_SHARED_LIBRARY_STATE_UNLOADED
@ AMD_DBGAPI_SHARED_LIBRARY_STATE_UNLOADED
The shared library is unloaded.
Definition: amd-dbgapi.h:5986
amd_dbgapi_wave_creation_t
amd_dbgapi_wave_creation_t
The kinds of wave creation supported by the hardware.
Definition: amd-dbgapi.h:1826
AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP
@ AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP
The wave has an outstanding stop request.
Definition: amd-dbgapi.h:809
amd_dbgapi_watchpoint_list_t::count
size_t count
Definition: amd-dbgapi.h:3803
amd_dbgapi_process_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:1534
AMD_DBGAPI_EVENT_KIND_WAVE_STOP
@ AMD_DBGAPI_EVENT_KIND_WAVE_STOP
A wave has stopped.
Definition: amd-dbgapi.h:5612
AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS
Return the dispatch kernel descriptor address.
Definition: amd-dbgapi.h:2651
amd_dbgapi_dispatch_info_t
amd_dbgapi_dispatch_info_t
Dispatch queries that are supported by amd_dbgapi_dispatch_get_info.
Definition: amd-dbgapi.h:2579
AMD_DBGAPI_DISPATCH_INFO_QUEUE
@ AMD_DBGAPI_DISPATCH_INFO_QUEUE
Return the queue to which this dispatch belongs.
Definition: amd-dbgapi.h:2584
AMD_DBGAPI_WAVE_STOP_REASON_FP_DIVIDE_BY_0
@ 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:3062
AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT
@ AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT
Return the minimum instruction alignment in bytes for the architecture.
Definition: amd-dbgapi.h:1115
AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED
@ AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED
The operation is not supported.
Definition: amd-dbgapi.h:725
AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT
An invalid argument was given to the function.
Definition: amd-dbgapi.h:729
AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED
@ 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:5627
amd_dbgapi_event_processed
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_processed(amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t event_id) AMD_DBGAPI_VERSION_0_24
Report that an event has been processed.
AMD_DBGAPI_ADDRESS_SPACE_ALIAS_MAY
@ AMD_DBGAPI_ADDRESS_SPACE_ALIAS_MAY
Addresses in the address spaces may alias.
Definition: amd-dbgapi.h:5066
amd_dbgapi_register_class_state_t
amd_dbgapi_register_class_state_t
Indication of whether a register is a member of a register class.
Definition: amd-dbgapi.h:4367
amd_dbgapi_register_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:4070
amd_dbgapi_os_queue_packet_id_t
uint64_t amd_dbgapi_os_queue_packet_id_t
Native operating system queue packet ID.
Definition: amd-dbgapi.h:599
amd_dbgapi_wave_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_wave_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_30
Query information about a wave.
amd_dbgapi_register_class_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:3940
AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT
@ AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT
Maximum number of waves supported by an execution unit.
Definition: amd-dbgapi.h:2135
AMD_DBGAPI_ADDRESS_CLASS_STATE_NOT_MEMBER
@ 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:5229
amd_dbgapi_watchpoint_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:3733
amd_dbgapi_watchpoint_kind_t
amd_dbgapi_watchpoint_kind_t
Watchpoint memory access kinds.
Definition: amd-dbgapi.h:3774
amd_dbgapi_address_class_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:4675
AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION
@ AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION
The bytes being disassembled are not a legal instruction.
Definition: amd-dbgapi.h:769
amd_dbgapi_breakpoint_action_t
amd_dbgapi_breakpoint_action_t
The action to perform after reporting a breakpoint has been hit.
Definition: amd-dbgapi.h:6068
AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID
The breakpoint handle is invalid.
Definition: amd-dbgapi.h:870
amd_dbgapi_shared_library_state_t
amd_dbgapi_shared_library_state_t
The state of a shared library.
Definition: amd-dbgapi.h:5978
AMD_DBGAPI_QUEUE_ERROR_REASON_RESERVED
@ AMD_DBGAPI_QUEUE_ERROR_REASON_RESERVED
A reserved value only present to ensure that the underlying representation of this enumeration type i...
Definition: amd-dbgapi.h:2417
amd_dbgapi_get_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_24
Get an architecture from the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture.
AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED
The wave is not stopped.
Definition: amd-dbgapi.h:801
AMD_DBGAPI_QUEUE_ERROR_REASON_NONE
@ AMD_DBGAPI_QUEUE_ERROR_REASON_NONE
If none of the bits are set, then the queue is not in the error state.
Definition: amd-dbgapi.h:2394
amd_dbgapi_process_attach
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_30
Attach to a process in order to provide debug control of the AMD GPUs it uses.
amd_dbgapi_displaced_stepping_complete
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_complete(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_displaced_stepping_id_t displaced_stepping) AMD_DBGAPI_VERSION_0_24
Complete a displaced stepping buffer for a wave.
amd_dbgapi_agent_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_agent_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_agent_id_t agent_id, amd_dbgapi_agent_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_36
Query information about an agent.
amd_dbgapi_shared_library_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:5971
amd_dbgapi_architecture_register_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_get_info(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_register_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_24
Query information about a register of an architecture.
AMD_DBGAPI_QUEUE_ERROR_REASON_WAVE_ERROR
@ AMD_DBGAPI_QUEUE_ERROR_REASON_WAVE_ERROR
A wave on the queue executed an instruction that caused an error.
Definition: amd-dbgapi.h:2412
AMD_DBGAPI_QUEUE_INFO_AGENT
@ AMD_DBGAPI_QUEUE_INFO_AGENT
Return the agent to which this queue belongs.
Definition: amd-dbgapi.h:2280
AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS
Return the NULL segment address value in the address space.
Definition: amd-dbgapi.h:4919
amd_dbgapi_address_space_id_t
Opaque address space handle.
Definition: amd-dbgapi.h:4855
AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED
Watchpoints are not supported.
Definition: amd-dbgapi.h:3752
AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL
The instruction conditionally branches to a literal address.
Definition: amd-dbgapi.h:1353
amd_dbgapi_displaced_stepping_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:3553
amd_dbgapi_address_class_id_t
Opaque source language address class handle.
Definition: amd-dbgapi.h:4674
AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE
Return how watchpoints are shared between processes.
Definition: amd-dbgapi.h:1566
AMD_DBGAPI_RESUME_MODE_NORMAL
@ AMD_DBGAPI_RESUME_MODE_NORMAL
Resume normal execution.
Definition: amd-dbgapi.h:3342
AMD_DBGAPI_QUEUE_STATE_ERROR
@ AMD_DBGAPI_QUEUE_STATE_ERROR
Queue is in an error state.
Definition: amd-dbgapi.h:2383
AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4
Queue supports the AMD PM4 protocol.
Definition: amd-dbgapi.h:660
amd_dbgapi_queue_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_queue_id_t queue_id, amd_dbgapi_queue_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_36
Query information about a queue.
amd_dbgapi_displaced_stepping_start
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_start(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes, amd_dbgapi_displaced_stepping_id_t *displaced_stepping) AMD_DBGAPI_VERSION_0_24
Create a displaced stepping buffer.
AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_REGISTER_PAIR
@ 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:1361
AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID
The code object handle is invalid.
Definition: amd-dbgapi.h:773
amd_dbgapi_register_class_id_t
Opaque register class handle.
Definition: amd-dbgapi.h:3939
amd_dbgapi_dispatch_barrier_t
amd_dbgapi_dispatch_barrier_t
Dispatch barrier.
Definition: amd-dbgapi.h:2726
AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED
The watchpoints are not shared across processes.
Definition: amd-dbgapi.h:3758
AMD_DBGAPI_EVENT_INFO_RUNTIME_STATE
@ 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:5794
amd_dbgapi_watchpoint_share_kind_t
amd_dbgapi_watchpoint_share_kind_t
The way watchpoints are shared between processes.
Definition: amd-dbgapi.h:3748
AMD_DBGAPI_WAVE_STOP_REASON_FP_INVALID_OPERATION
@ 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:3082
AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP
@ AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP
The wave stopped due to executing an assert trap instruction.
Definition: amd-dbgapi.h:3120
amd_dbgapi_wave_stop_reason_t
amd_dbgapi_wave_stop_reason_t
A bit mask of the reasons that a wave stopped.
Definition: amd-dbgapi.h:3013
amd_dbgapi_client_thread_id_t
struct amd_dbgapi_client_thread_s * amd_dbgapi_client_thread_id_t
Opaque client thread handle.
Definition: amd-dbgapi.h:6088
AMD_DBGAPI_CODE_OBJECT_INFO_LOAD_ADDRESS
@ 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:1963
AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID
The address space handle is invalid.
Definition: amd-dbgapi.h:850
amd_dbgapi_watchpoint_list_t
A set of watchpoints.
Definition: amd-dbgapi.h:3802
amd_dbgapi_lane_id_t
uint32_t amd_dbgapi_lane_id_t
A wave lane handle.
Definition: amd-dbgapi.h:4653
AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED
The native operating system process associated with a client process has exited.
Definition: amd-dbgapi.h:883
AMD_DBGAPI_WAVE_STOP_REASON_INT_DIVIDE_BY_0
@ 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:3087
amd_dbgapi_log_level_t
amd_dbgapi_log_level_t
The logging levels supported.
Definition: amd-dbgapi.h:5900
AMD_DBGAPI_LOG_LEVEL_VERBOSE
@ AMD_DBGAPI_LOG_LEVEL_VERBOSE
Print fatal error, warning, info, and verbose messages.
Definition: amd-dbgapi.h:5921
AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA
Queue supports the AMD SDMA protocol.
Definition: amd-dbgapi.h:664
AMD_DBGAPI_LOG_LEVEL_NONE
@ AMD_DBGAPI_LOG_LEVEL_NONE
Print no messages.
Definition: amd-dbgapi.h:5904
AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION
@ AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION
The wave stopped due to executing an illegal instruction.
Definition: amd-dbgapi.h:3157
AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID
The process handle is invalid.
Definition: amd-dbgapi.h:781
AMD_DBGAPI_WAVE_INFO_QUEUE
@ AMD_DBGAPI_WAVE_INFO_QUEUE
Return the queue to which this wave belongs.
Definition: amd-dbgapi.h:2880
AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM
There is a fence with system memory scope.
Definition: amd-dbgapi.h:2757
amd_dbgapi_architecture_info_t
amd_dbgapi_architecture_info_t
Architecture queries that are supported by amd_dbgapi_architecture_get_info.
Definition: amd-dbgapi.h:1089
amd_dbgapi_process_get_info
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_36
Query information about a process.
amd_dbgapi_displaced_stepping_id_t
Opaque displaced stepping handle.
Definition: amd-dbgapi.h:3552
AMD_DBGAPI_WAVE_STATE_RUN
@ AMD_DBGAPI_WAVE_STATE_RUN
The wave is running.
Definition: amd-dbgapi.h:2985
AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_CALL_REGISTER_PAIR
@ 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:1370
AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION
The segment address cannot be converted to the requested address space.
Definition: amd-dbgapi.h:858
amd_dbgapi_watchpoint_id_t
Opaque hardware data watchpoint handle.
Definition: amd-dbgapi.h:3732
amd_dbgapi_dispatch_fence_scope_t
amd_dbgapi_dispatch_fence_scope_t
Dispatch memory fence scope.
Definition: amd-dbgapi.h:2745
AMD_DBGAPI_QUEUE_INFO_ADDRESS
@ AMD_DBGAPI_QUEUE_INFO_ADDRESS
Return the base address of the memory holding the queue packets.
Definition: amd-dbgapi.h:2307
AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID
The register handle is invalid.
Definition: amd-dbgapi.h:838
AMD_DBGAPI_INSTRUCTION_KIND_TRAP
@ AMD_DBGAPI_INSTRUCTION_KIND_TRAP
The instruction enters the trap handler.
Definition: amd-dbgapi.h:1399
amd_dbgapi_architecture_register_class_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_class_get_info(amd_dbgapi_architecture_id_t architecture_id, 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_24
Query information about a register class of an architecture.
amd_dbgapi_register_info_t
amd_dbgapi_register_info_t
Register queries that are supported by amd_dbgapi_architecture_register_get_info and amd_dbgapi_wave_...
Definition: amd-dbgapi.h:4088
amd_dbgapi_queue_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Return the list of queues for a process.
AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION
Return the breakpoint instruction for the architecture.
Definition: amd-dbgapi.h:1128
amd_dbgapi_process_set_progress
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_24
Set the progress required for a process.
AMD_DBGAPI_AGENT_INFO_OS_ID
@ AMD_DBGAPI_AGENT_INFO_OS_ID
Native operating system agent ID.
Definition: amd-dbgapi.h:2140
AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_UNAVAILABLE
@ AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_UNAVAILABLE
No more displaced stepping buffers are available that are suitable for the requested wave.
Definition: amd-dbgapi.h:822
amd_dbgapi_agent_id_t
Opaque agent handle.
Definition: amd-dbgapi.h:2084
amd_dbgapi_get_status_string
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_status_string(amd_dbgapi_status_t status, const char **status_string) AMD_DBGAPI_VERSION_0_24
Query a textual description of a status code.
amd_dbgapi_wave_info_t
amd_dbgapi_wave_info_t
Wave queries that are supported by amd_dbgapi_wave_get_info.
Definition: amd-dbgapi.h:2838
AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT
The address space is read only.
Definition: amd-dbgapi.h:4886
AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN
@ AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN
The instruction classification is unknown.
Definition: amd-dbgapi.h:1334
AMD_DBGAPI_WAVE_STOP_REASON_QUEUE_ERROR
@ AMD_DBGAPI_WAVE_STOP_REASON_QUEUE_ERROR
The wave belongs to a queue that is in the error state.
Definition: amd-dbgapi.h:3052
AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE
The wave cannot be resumed.
Definition: amd-dbgapi.h:813
AMD_DBGAPI_WATCHPOINT_KIND_LOAD
@ AMD_DBGAPI_WATCHPOINT_KIND_LOAD
Read access by load instructions.
Definition: amd-dbgapi.h:3778
AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID
@ AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID
PCI device ID of the agent.
Definition: amd-dbgapi.h:2125
amd_dbgapi_agent_info_t
amd_dbgapi_agent_info_t
Agent queries that are supported by amd_dbgapi_agent_get_info.
Definition: amd-dbgapi.h:2100
AMD_DBGAPI_EVENT_KIND_NONE
@ AMD_DBGAPI_EVENT_KIND_NONE
No event.
Definition: amd-dbgapi.h:5608
AMD_DBGAPI_WAVE_INFO_STOP_REASON
@ AMD_DBGAPI_WAVE_INFO_STOP_REASON
Return the reason the wave stopped as a bit set.
Definition: amd-dbgapi.h:2850
AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED
The watchpoints of a process are shared between all processes.
Definition: amd-dbgapi.h:3764
amd_dbgapi_dispatch_id_t
Opaque dispatch handle.
Definition: amd-dbgapi.h:2563
AMD_DBGAPI_VERSION_0_24
#define AMD_DBGAPI_VERSION_0_24
The function was introduced in version 0.24 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:461
AMD_DBGAPI_QUEUE_INFO_TYPE
@ AMD_DBGAPI_QUEUE_INFO_TYPE
Return the queue type.
Definition: amd-dbgapi.h:2290
amd_dbgapi_wave_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Return the list of existing waves for a process.
AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID
The agent handle is invalid.
Definition: amd-dbgapi.h:785
AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS
@ AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS
The runtime has been loaded and debugging is supported by the library.
Definition: amd-dbgapi.h:5746
amd_dbgapi_address_space_alias_t
amd_dbgapi_address_space_alias_t
Indication of whether addresses in two address spaces may alias.
Definition: amd-dbgapi.h:5058
amd_dbgapi_wave_stop
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_stop(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_24
Request a wave to stop executing.
AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID
The architecture handle is invalid.
Definition: amd-dbgapi.h:765
amd_dbgapi_os_queue_id_t
uint64_t amd_dbgapi_os_queue_id_t
Native operating system queue ID.
Definition: amd-dbgapi.h:587
amd_dbgapi_wave_register_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_list(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, size_t *register_count, amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_24
Report the list of registers supported by a wave.
AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID
The event handle is invalid.
Definition: amd-dbgapi.h:862
amd_dbgapi_address_spaces_may_alias
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_spaces_may_alias(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_address_space_id_t address_space_id1, amd_dbgapi_address_space_id_t address_space_id2, amd_dbgapi_address_space_alias_t *address_space_alias) AMD_DBGAPI_VERSION_0_24
Determine if an address in one address space may alias an address in another address space.
AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS
The address is not within the shared library.
Definition: amd-dbgapi.h:895
AMD_DBGAPI_WAVE_CREATION_NORMAL
@ AMD_DBGAPI_WAVE_CREATION_NORMAL
Normal wave creation allows new waves to be created.
Definition: amd-dbgapi.h:1830
AMD_DBGAPI_AGENT_INFO_ARCHITECTURE
@ AMD_DBGAPI_AGENT_INFO_ARCHITECTURE
Return the architecture of this agent.
Definition: amd-dbgapi.h:2111
amd_dbgapi_instruction_kind_t
amd_dbgapi_instruction_kind_t
The kinds of instruction classifications.
Definition: amd-dbgapi.h:1329
amd_dbgapi_callbacks_s::get_symbol_address
amd_dbgapi_status_t(* get_symbol_address)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_shared_library_id_t shared_library_id, const char *symbol_name, amd_dbgapi_global_address_t *address)
Return the address of a symbol in a shared library.
Definition: amd-dbgapi.h:6307
amd_dbgapi_wave_resume
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_resume(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_resume_mode_t resume_mode) AMD_DBGAPI_VERSION_0_24
Resume execution of a stopped wave.
amd_dbgapi_queue_error_reason_t
amd_dbgapi_queue_error_reason_t
A bit mask of the reasons that a queue is in error.
Definition: amd-dbgapi.h:2390
AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT
@ AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT
Total number of Execution Units (EUs) available in the agent.
Definition: amd-dbgapi.h:2130
AMD_DBGAPI_ARCHITECTURE_INFO_NAME
@ AMD_DBGAPI_ARCHITECTURE_INFO_NAME
Return the architecture name.
Definition: amd-dbgapi.h:1096
amd_dbgapi_read_register
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_register(amd_dbgapi_process_id_t process_id, 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_24
Read a register.
amd_dbgapi_read_memory
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_30
Read memory.
AMD_DBGAPI_PROGRESS_NORMAL
@ AMD_DBGAPI_PROGRESS_NORMAL
Normal progress is needed.
Definition: amd-dbgapi.h:1761
amd_dbgapi_prefetch_register
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_prefetch_register(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_size_t register_count) AMD_DBGAPI_VERSION_0_24
Prefetch register values.
AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE
Return the breakpoint instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1120
amd_dbgapi_resume_mode_t
amd_dbgapi_resume_mode_t
The mode in which to resuming the execution of a wave.
Definition: amd-dbgapi.h:3338
amd_dbgapi_wave_id_t
Opaque wave handle.
Definition: amd-dbgapi.h:2822
amd_dbgapi_callbacks_s::enable_notify_shared_library
amd_dbgapi_status_t(* enable_notify_shared_library)(amd_dbgapi_client_process_id_t client_process_id, const char *shared_library_name, amd_dbgapi_shared_library_id_t shared_library_id, amd_dbgapi_shared_library_state_t *shared_library_state)
Request to be notified when a shared library is loaded and unloaded.
Definition: amd-dbgapi.h:6244
AMD_DBGAPI_INSTRUCTION_KIND_BARRIER
@ 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:1411
AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD
@ AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD
Return the client thread of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition: amd-dbgapi.h:5787
AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID
The watchpoint handle is invalid.
Definition: amd-dbgapi.h:826
AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT
The address space is only read the waves of a kernel dispatch.
Definition: amd-dbgapi.h:4891
AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT
@ AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT
The wave stopped due to triggering a data watchpoint.
Definition: amd-dbgapi.h:3036
AMD_DBGAPI_BREAKPOINT_ACTION_RESUME
@ AMD_DBGAPI_BREAKPOINT_ACTION_RESUME
Resume execution.
Definition: amd-dbgapi.h:6072
amd_dbgapi_breakpoint_id_t
Opaque breakpoint handle.
Definition: amd-dbgapi.h:6055
AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION
@ AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION
The runtime has been loaded but there is a restriction error that prevents debugging the process.
Definition: amd-dbgapi.h:5756
AMD_DBGAPI_VERSION_0_30
#define AMD_DBGAPI_VERSION_0_30
The function was introduced in version 0.30 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:467
amd_dbgapi_architecture_address_space_list
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_24
Report the list of address spaces supported by the architecture.
AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_PC_ADJUST
@ 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:1134
AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID
The queue handle is invalid.
Definition: amd-dbgapi.h:789
amd_dbgapi_code_object_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_code_object_get_info(amd_dbgapi_process_id_t process_id, 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_24
Query information about a code object.
AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW
The wave stopped due to triggering an enabled floating point underflow exception.
Definition: amd-dbgapi.h:3072
amd_dbgapi_dispatch_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:2564
amd_dbgapi_callbacks_s::disable_notify_shared_library
amd_dbgapi_status_t(* disable_notify_shared_library)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_shared_library_id_t shared_library_id)
Request to stop being notified for a shared library previously set by amd_dbgapi_callbacks_s::enable_...
Definition: amd-dbgapi.h:6272
AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT
@ AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT
The wave stopped after causing a hardware fatal halt.
Definition: amd-dbgapi.h:3181
amd_dbgapi_code_object_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Return the list of loaded code objects for a process.
AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT
There is a fence with agent memory scope.
Definition: amd-dbgapi.h:2753
amd_dbgapi_code_object_id_t
Opaque code object handle.
Definition: amd-dbgapi.h:1892
AMD_DBGAPI_CHANGED_YES
@ AMD_DBGAPI_CHANGED_YES
The value has changed.
Definition: amd-dbgapi.h:528
amd_dbgapi_changed_t
amd_dbgapi_changed_t
Indication of if a value has changed.
Definition: amd-dbgapi.h:520
amd_dbgapi_architecture_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:1073
amd_dbgapi_breakpoint_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:6056
AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID
The register class handle is invalid.
Definition: amd-dbgapi.h:834
amd_dbgapi_runtime_state_t
amd_dbgapi_runtime_state_t
Inferior runtime state.
Definition: amd-dbgapi.h:5742
AMD_DBGAPI_DISPATCH_INFO_AGENT
@ AMD_DBGAPI_DISPATCH_INFO_AGENT
Return the agent to which this queue belongs.
Definition: amd-dbgapi.h:2590
amd_dbgapi_callbacks_s::log_message
void(* log_message)(amd_dbgapi_log_level_t level, const char *message)
Report a log message.
Definition: amd-dbgapi.h:6407
amd_dbgapi_queue_state_t
amd_dbgapi_queue_state_t
Queue state.
Definition: amd-dbgapi.h:2371
amd_dbgapi_callbacks_s::get_os_pid
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:6206
amd_dbgapi_watchpoint_list_t::watchpoint_ids
amd_dbgapi_watchpoint_id_t * watchpoint_ids
Definition: amd-dbgapi.h:3804
amd_dbgapi_address_class_info_t
amd_dbgapi_address_class_info_t
Source language address class queries that are supported by amd_dbgapi_architecture_address_class_get...
Definition: amd-dbgapi.h:4691
AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR
@ AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR
Print fatal error messages.
Definition: amd-dbgapi.h:5909
AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS
@ AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS
Return the dispatch grid dimensionality.
Definition: amd-dbgapi.h:2621
amd_dbgapi_address_class_state_t
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:5224
AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE
@ AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE
Return the dispatch private segment size in bytes.
Definition: amd-dbgapi.h:2636
AMD_DBGAPI_CHANGED_NO
@ AMD_DBGAPI_CHANGED_NO
The value has not changed.
Definition: amd-dbgapi.h:524
AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS
Return the dispatch kernel code entry address.
Definition: amd-dbgapi.h:2656
amd_dbgapi_remove_watchpoint
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint(amd_dbgapi_process_id_t process_id, amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_24
Remove a hardware data watchpoint previously set by amd_dbgapi_set_watchpoint.
amd_dbgapi_write_memory
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_30
Write memory.
AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE
@ AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE
The instruction terminates the wave execution.
Definition: amd-dbgapi.h:1385
amd_dbgapi_register_is_in_register_class
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_is_in_register_class(amd_dbgapi_architecture_id_t architecture_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_register_class_id_t register_class_id, amd_dbgapi_register_class_state_t *register_class_state) AMD_DBGAPI_VERSION_0_24
Determine if a register is a member of a register class.
AMD_DBGAPI_WAVE_STOP_REASON_RESERVED
@ AMD_DBGAPI_WAVE_STOP_REASON_RESERVED
A reserved value only present to ensure that the underlying representation of this enumeration type i...
Definition: amd-dbgapi.h:3195
AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES
@ AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES
Return the dispatch grid size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:2631
AMD_DBGAPI_QUEUE_STATE_VALID
@ AMD_DBGAPI_QUEUE_STATE_VALID
Queue is in a valid state.
Definition: amd-dbgapi.h:2375
amd_dbgapi_get_build_name
const char AMD_DBGAPI * amd_dbgapi_get_build_name(void) AMD_DBGAPI_VERSION_0_24
Query the installed library build name.
AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID
The lane handle is invalid.
Definition: amd-dbgapi.h:842
AMD_DBGAPI_QUEUE_ERROR_REASON_INVALID_PACKET
@ AMD_DBGAPI_QUEUE_ERROR_REASON_INVALID_PACKET
A packet on the queue is invalid.
Definition: amd-dbgapi.h:2398
AMD_DBGAPI_WAVE_INFO_PC
@ AMD_DBGAPI_WAVE_INFO_PC
Return the current program counter value of the wave.
Definition: amd-dbgapi.h:2897
AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED
@ AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED
The library is not initialized.
Definition: amd-dbgapi.h:741
AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID
The client process handle is invalid.
Definition: amd-dbgapi.h:878
AMD_DBGAPI_WAVE_INFO_WATCHPOINTS
@ AMD_DBGAPI_WAVE_INFO_WATCHPOINTS
Return the watchpoint(s) the wave triggered.
Definition: amd-dbgapi.h:2863
AMD_DBGAPI_ADDRESS_CLASS_STATE_MEMBER
@ 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:5234
amd_dbgapi_process_set_wave_creation
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_24
Set the wave creation mode for a process.
AMD_DBGAPI_WAVE_INFO_DISPATCH
@ AMD_DBGAPI_WAVE_INFO_DISPATCH
Return the dispatch to which this wave belongs.
Definition: amd-dbgapi.h:2874
AMD_DBGAPI_RESUME_MODE_SINGLE_STEP
@ AMD_DBGAPI_RESUME_MODE_SINGLE_STEP
Resume execution in in single step mode.
Definition: amd-dbgapi.h:3346
AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE
There is no fence.
Definition: amd-dbgapi.h:2749
amd_dbgapi_architecture_address_class_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_class_get_info(amd_dbgapi_architecture_id_t architecture_id, 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_24
Query information about a source language address class of an architecture.
amd_dbgapi_convert_address_space
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_convert_address_space(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 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_VERSION_0_24
Convert a source segment address in the source address space into a destination segment address in th...
amd_dbgapi_address_is_in_address_class
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_is_in_address_class(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_address_class_id_t address_class_id, amd_dbgapi_address_class_state_t *address_class_state) AMD_DBGAPI_VERSION_0_24
Determine if a segment address in an address space is a member of a source language address class.
AMD_DBGAPI_CODE_OBJECT_INFO_URI_NAME
@ 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:1957
amd_dbgapi_event_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:5592
AMD_DBGAPI_QUEUE_INFO_STATE
@ AMD_DBGAPI_QUEUE_INFO_STATE
Return the queue state.
Definition: amd-dbgapi.h:2295
AMD_DBGAPI_EVENT_INFO_KIND
@ AMD_DBGAPI_EVENT_INFO_KIND
Return the event kind.
Definition: amd-dbgapi.h:5771
amd_dbgapi_report_breakpoint_hit
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_report_breakpoint_hit(amd_dbgapi_process_id_t process_id, 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_24
Report that a breakpoint inserted by the amd_dbgapi_callbacks_s::insert_breakpoint calback has been h...
AMD_DBGAPI_PROGRESS_NO_FORWARD
@ AMD_DBGAPI_PROGRESS_NO_FORWARD
No forward progress is needed.
Definition: amd-dbgapi.h:1785
AMD_DBGAPI_WAVE_STOP_REASON_XNACK_ERROR
@ AMD_DBGAPI_WAVE_STOP_REASON_XNACK_ERROR
The wave stopped with an XNACK error.
Definition: amd-dbgapi.h:3190
amd_dbgapi_address_space_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:4856
amd_dbgapi_architecture_register_class_list
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_24
Report the list of register classes supported by the architecture.
amd_dbgapi_shared_library_id_t
Opaque shared library handle.
Definition: amd-dbgapi.h:5970
AMD_DBGAPI_WAVE_INFO_AGENT
@ AMD_DBGAPI_WAVE_INFO_AGENT
Return the agent to which this wave belongs.
Definition: amd-dbgapi.h:2886
AMD_DBGAPI_QUEUE_INFO_SIZE
@ AMD_DBGAPI_QUEUE_INFO_SIZE
Return the size in bytes of the memory holding the queue packets.
Definition: amd-dbgapi.h:2312
AMD_DBGAPI_WAVE_INFO_ARCHITECTURE
@ AMD_DBGAPI_WAVE_INFO_ARCHITECTURE
Return the architecture of this wave.
Definition: amd-dbgapi.h:2891
amd_dbgapi_wave_register_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id, amd_dbgapi_register_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_24
Query information about a register of a wave.
amd_dbgapi_dwarf_register_to_register
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_24
Return a register handle from an AMD GPU DWARF register number.
AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME
Return the source language address class name.
Definition: amd-dbgapi.h:4698
amd_dbgapi_code_object_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:1893
AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_SINGLE_PRODUCER
@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_SINGLE_PRODUCER
Queue supports the HSA kernel dispatch with single producer protocol.
Definition: amd-dbgapi.h:646
amd_dbgapi_process_info_t
amd_dbgapi_process_info_t
Process queries that are supported by amd_dbgapi_process_get_info.
Definition: amd-dbgapi.h:1549
amd_dbgapi_set_log_level
void AMD_DBGAPI amd_dbgapi_set_log_level(amd_dbgapi_log_level_t level) AMD_DBGAPI_VERSION_0_24
Set the logging level.
AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL
The address space supports all accesses.
Definition: amd-dbgapi.h:4881
amd_dbgapi_segment_address_t
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:5133
AMD_DBGAPI
#define AMD_DBGAPI
Definition: amd-dbgapi.h:427
AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED
@ AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED
The wave is stopped.
Definition: amd-dbgapi.h:805
AMD_DBGAPI_WAVE_INFO_LANE_COUNT
@ AMD_DBGAPI_WAVE_INFO_LANE_COUNT
The number of lanes supported by the wave.
Definition: amd-dbgapi.h:2923
amd_dbgapi_callbacks_s::remove_breakpoint
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:6395
AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE
@ AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE
Return the dispatch release fence.
Definition: amd-dbgapi.h:2616
AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT
The wave stopped due to triggering an enabled floating point inexact exception.
Definition: amd-dbgapi.h:3077
amd_dbgapi_finalize
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize(void) AMD_DBGAPI_VERSION_0_24
Finalize the library.
amd_dbgapi_architecture_address_class_list
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_24
Report the list of source language address classes supported by the architecture.
amd_dbgapi_classify_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, void **instruction_properties) AMD_DBGAPI_VERSION_0_24
Classify a single instruction.
AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP
@ AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP
The wave stopped due to completing an instruction single-step.
Definition: amd-dbgapi.h:3040
AMD_DBGAPI_INSTRUCTION_KIND_SPECIAL
@ 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:1426
amd_dbgapi_code_object_info_t
amd_dbgapi_code_object_info_t
Code object queries that are supported by amd_dbgapi_code_object_get_info.
Definition: amd-dbgapi.h:1908
AMD_DBGAPI_DISPATCH_INFO_WORK_GROUP_SIZES
@ AMD_DBGAPI_DISPATCH_INFO_WORK_GROUP_SIZES
Return the dispatch workgroup size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:2626
AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP
@ AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP
The wave stopped due to executing a debug trap instruction.
Definition: amd-dbgapi.h:3102
AMD_DBGAPI_REGISTER_INFO_TYPE
@ AMD_DBGAPI_REGISTER_INFO_TYPE
Return the register type as a C style type string.
Definition: amd-dbgapi.h:4127
AMD_DBGAPI_PROCESS_INFO_OS_ID
@ AMD_DBGAPI_PROCESS_INFO_OS_ID
Native operating system process ID.
Definition: amd-dbgapi.h:1577
AMD_DBGAPI_DISPATCH_INFO_OS_QUEUE_PACKET_ID
@ 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:2601
amd_dbgapi_queue_info_t
amd_dbgapi_queue_info_t
Queue queries that are supported by amd_dbgapi_queue_get_info.
Definition: amd-dbgapi.h:2275
amd_dbgapi_register_class_info_t
amd_dbgapi_register_class_info_t
Register class queries that are supported by amd_dbgapi_architecture_register_class_get_info.
Definition: amd-dbgapi.h:3956
AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID
@ AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID
PCI vendor ID of the agent.
Definition: amd-dbgapi.h:2121
AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI
Queue supports the AMD SDMA XGMI protocol.
Definition: amd-dbgapi.h:668
AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID
The dispatch handle is invalid.
Definition: amd-dbgapi.h:793
amd_dbgapi_initialize
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize(amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_30
Initialize the library.
AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION
@ AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION
The wave stopped due to triggering a memory violation.
Definition: amd-dbgapi.h:3147
amd_dbgapi_address_space_access_t
amd_dbgapi_address_space_access_t
Indication of how the address space is accessed.
Definition: amd-dbgapi.h:4876
AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER
@ AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER
Return the register handle for the PC for the architecture.
Definition: amd-dbgapi.h:1139
AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK
@ AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK
A callback to the client reported an error.
Definition: amd-dbgapi.h:874
amd_dbgapi_os_queue_type_t
amd_dbgapi_os_queue_type_t
Native operating system queue type.
Definition: amd-dbgapi.h:611
amd_dbgapi_architecture_get_info
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_30
Query information about an architecture.
AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE
@ AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE
Return the architecture of this queue.
Definition: amd-dbgapi.h:2285
AMD_DBGAPI_MEMORY_PRECISION_NONE
@ 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:5509
amd_dbgapi_architecture_register_list
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_24
Report the list of registers supported by the architecture.
AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE
The ELF AMD GPU machine value is invalid or unsupported.
Definition: amd-dbgapi.h:777
AMD_DBGAPI_DISPATCH_BARRIER_NONE
@ AMD_DBGAPI_DISPATCH_BARRIER_NONE
Dispatch has no barrier.
Definition: amd-dbgapi.h:2730
AMD_DBGAPI_PROCESS_INFO_PRECISE_MEMORY_SUPPORTED
@ 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:1572
AMD_DBGAPI_STATUS_ERROR_UNIMPLEMENTED
@ AMD_DBGAPI_STATUS_ERROR_UNIMPLEMENTED
The operation is not currently implemented.
Definition: amd-dbgapi.h:721
AMD_DBGAPI_WAVE_STATE_SINGLE_STEP
@ AMD_DBGAPI_WAVE_STATE_SINGLE_STEP
The wave is running in single-step mode.
Definition: amd-dbgapi.h:2990
AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER
@ AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER
The register is not a member of the register class.
Definition: amd-dbgapi.h:4371
amd_dbgapi_address_space_info_t
amd_dbgapi_address_space_info_t
Address space queries that are supported by amd_dbgapi_address_space_get_info.
Definition: amd-dbgapi.h:4902
AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE
@ AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE
Return the dispatch acquire fence.
Definition: amd-dbgapi.h:2611
amd_dbgapi_event_id_t
Opaque event handle.
Definition: amd-dbgapi.h:5591
AMD_DBGAPI_REGISTER_INFO_NAME
@ AMD_DBGAPI_REGISTER_INFO_NAME
Return the register name.
Definition: amd-dbgapi.h:4095
AMD_DBGAPI_WAVE_STOP_REASON_TRAP
@ AMD_DBGAPI_WAVE_STOP_REASON_TRAP
The wave stopped due to executing an trap instruction other than the AMD_DBGAPI_WAVE_STOP_REASON_DEBU...
Definition: amd-dbgapi.h:3132
AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT
Return the number of data watchpoints supported by the process.
Definition: amd-dbgapi.h:1560
amd_dbgapi_symbolizer_id_t
struct amd_dbgapi_symbolizer_id_s * amd_dbgapi_symbolizer_id_t
Opaque client symbolizer handle.
Definition: amd-dbgapi.h:1222
amd_dbgapi_queue_packet_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_packet_list(amd_dbgapi_process_id_t process_id, 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_36
Return the packets for a queue of a process.
AMD_DBGAPI_EVENT_INFO_WAVE
@ 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:5777
AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS
Return the address space access.
Definition: amd-dbgapi.h:4924
amd_dbgapi_disassemble_instruction
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_30
Disassemble a single instruction.
amd_dbgapi_wave_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:2823
AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND
@ AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND
The symbol was not found.
Definition: amd-dbgapi.h:891
AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE
@ AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE
Return the dispatch group segment size in bytes.
Definition: amd-dbgapi.h:2641
amd_dbgapi_dwarf_address_space_to_address_space
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_24
Return the address space from an AMD GPU DWARF address space number.
AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS
@ AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS
An error occurred while trying to access memory in the inferior.
Definition: amd-dbgapi.h:854
AMD_DBGAPI_EVENT_KIND_RUNTIME
@ AMD_DBGAPI_EVENT_KIND_RUNTIME
The runtime support in the inferior has been loaded or unloaded.
Definition: amd-dbgapi.h:5666
AMD_DBGAPI_AGENT_INFO_PCI_SLOT
@ 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:2117
AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW
@ AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW
Write access by store instructions or read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:3783
AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS
Return the dispatch completion event address.
Definition: amd-dbgapi.h:2666
amd_dbgapi_os_process_id_t
pid_t amd_dbgapi_os_process_id_t
Native operating system process ID.
Definition: amd-dbgapi.h:539
AMD_DBGAPI_DISPATCH_BARRIER_PRESENT
@ AMD_DBGAPI_DISPATCH_BARRIER_PRESENT
Dispatch has a barrier.
Definition: amd-dbgapi.h:2735
AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN
@ AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN
Unknown queue type.
Definition: amd-dbgapi.h:615
amd_dbgapi_progress_t
amd_dbgapi_progress_t
The kinds of progress supported by the library.
Definition: amd-dbgapi.h:1755
amd_dbgapi_queue_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:2260
amd_dbgapi_event_kind_t
amd_dbgapi_event_kind_t
The event kinds.
Definition: amd-dbgapi.h:5604
AMD_DBGAPI_RUNTIME_STATE_UNLOADED
@ AMD_DBGAPI_RUNTIME_STATE_UNLOADED
The runtime has been unloaded.
Definition: amd-dbgapi.h:5750
AMD_DBGAPI_WATCHPOINT_KIND_ALL
@ AMD_DBGAPI_WATCHPOINT_KIND_ALL
Read, write, or read-modify-write access by load, store, or atomic instructions.
Definition: amd-dbgapi.h:3792
AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH
The instruction unconditionally branches to a literal address.
Definition: amd-dbgapi.h:1346
AMD_DBGAPI_WAVE_INFO_STATE
@ AMD_DBGAPI_WAVE_INFO_STATE
Return the wave's state.
Definition: amd-dbgapi.h:2843
AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE
Return the byte size of an address in the address space.
Definition: amd-dbgapi.h:4914
AMD_DBGAPI_WAVE_CREATION_STOP
@ AMD_DBGAPI_WAVE_CREATION_STOP
Stop wave creation prevents new waves from being created.
Definition: amd-dbgapi.h:1834
AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR
@ AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR
An event has occurred that is causing the queue to enter the error state.
Definition: amd-dbgapi.h:5702
amd_dbgapi_notifier_t
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:566
AMD_DBGAPI_WATCHPOINT_KIND_RMW
@ AMD_DBGAPI_WATCHPOINT_KIND_RMW
Read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:3787
AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_SIZE
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_SIZE
An invalid size was given to the function.
Definition: amd-dbgapi.h:733
amd_dbgapi_status_t
amd_dbgapi_status_t
AMD debugger API status codes.
Definition: amd-dbgapi.h:685
AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE
@ AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE
No more watchpoints available.
Definition: amd-dbgapi.h:830
AMD_DBGAPI_REGISTER_INFO_SIZE
@ AMD_DBGAPI_REGISTER_INFO_SIZE
Return the size of the register in bytes.
Definition: amd-dbgapi.h:4105
amd_dbgapi_size_t
uint64_t amd_dbgapi_size_t
Integral type used for sizes, including memory allocations, in the inferior.
Definition: amd-dbgapi.h:514
AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID
The wave handle is invalid.
Definition: amd-dbgapi.h:797
AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED
@ AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED
The list of code objects has changed.
Definition: amd-dbgapi.h:5643
AMD_DBGAPI_WAVE_STATE_STOP
@ AMD_DBGAPI_WAVE_STATE_STOP
The wave is stopped.
Definition: amd-dbgapi.h:3003
amd_dbgapi_queue_id_t
Opaque queue handle.
Definition: amd-dbgapi.h:2259
AMD_DBGAPI_REGISTER_CLASS_INFO_NAME
@ AMD_DBGAPI_REGISTER_CLASS_INFO_NAME
Return the register class name.
Definition: amd-dbgapi.h:3963
amd_dbgapi_next_pending_event
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Obtain the next pending event for a process.
amd_dbgapi_callbacks_s::insert_breakpoint
amd_dbgapi_status_t(* insert_breakpoint)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_shared_library_id_t shared_library_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:6359
AMD_DBGAPI_BREAKPOINT_ACTION_HALT
@ AMD_DBGAPI_BREAKPOINT_ACTION_HALT
Leave execution halted.
Definition: amd-dbgapi.h:6076
AMD_DBGAPI_LOG_LEVEL_INFO
@ AMD_DBGAPI_LOG_LEVEL_INFO
Print fatal error, warning, and info messages.
Definition: amd-dbgapi.h:5917
AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_CALL_REGISTER_PAIRS
@ 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:1380
amd_dbgapi_global_address_t
uint64_t amd_dbgapi_global_address_t
Integral type used for a global virtual memory address in the inferior process.
Definition: amd-dbgapi.h:509
AMD_DBGAPI_DISPATCH_INFO_BARRIER
@ AMD_DBGAPI_DISPATCH_INFO_BARRIER
Return the dispatch barrier setting.
Definition: amd-dbgapi.h:2606
AMD_DBGAPI_ADDRESS_SPACE_ALIAS_NONE
@ AMD_DBGAPI_ADDRESS_SPACE_ALIAS_NONE
No addresses in the address spaces can alias.
Definition: amd-dbgapi.h:5062
amd_dbgapi_dispatch_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dispatch_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_dispatch_id_t dispatch_id, amd_dbgapi_dispatch_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_36
Query information about a dispatch.
AMD_DBGAPI_SHARED_LIBRARY_STATE_LOADED
@ AMD_DBGAPI_SHARED_LIBRARY_STATE_LOADED
The shared library is loaded.
Definition: amd-dbgapi.h:5982
AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR
@ AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR
The wave stopped due to detecting an unrecoverable ECC error.
Definition: amd-dbgapi.h:3172
AMD_DBGAPI_MEMORY_PRECISION_PRECISE
@ AMD_DBGAPI_MEMORY_PRECISION_PRECISE
A wave waits for memory instructions to complete before executing further instructions.
Definition: amd-dbgapi.h:5514
AMD_DBGAPI_AGENT_INFO_NAME
@ AMD_DBGAPI_AGENT_INFO_NAME
Agent name.
Definition: amd-dbgapi.h:2106
amd_dbgapi_get_version
void AMD_DBGAPI amd_dbgapi_get_version(uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_24
Query the version of the installed library.
AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE
@ AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE
Return the architecture of this dispatch.
Definition: amd-dbgapi.h:2595
amd_dbgapi_callbacks_s
Callbacks that the client of the library must provide.
Definition: amd-dbgapi.h:6146
AMD_DBGAPI_WAVE_INFO_WORK_GROUP_COORD
@ AMD_DBGAPI_WAVE_INFO_WORK_GROUP_COORD
The wave workgroup coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:2911
AMD_DBGAPI_STATUS_ERROR_LIBRARY_NOT_LOADED
@ AMD_DBGAPI_STATUS_ERROR_LIBRARY_NOT_LOADED
The shared library is not currently loaded.
Definition: amd-dbgapi.h:887
amd_dbgapi_report_shared_library
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_report_shared_library(amd_dbgapi_process_id_t process_id, amd_dbgapi_shared_library_id_t shared_library_id, amd_dbgapi_shared_library_state_t shared_library_state) AMD_DBGAPI_VERSION_0_24
Report that a shared library enabled by the amd_dbgapi_callbacks_s::enable_notify_shared_library call...
amd_dbgapi_process_id_t
Opaque process handle.
Definition: amd-dbgapi.h:1533
AMD_DBGAPI_STATUS_ERROR_RESTRICTION
@ AMD_DBGAPI_STATUS_ERROR_RESTRICTION
There is a restriction error that prevents debugging the process.
Definition: amd-dbgapi.h:757
amd_dbgapi_event_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_get_info(amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t event_id, amd_dbgapi_event_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_30
Query information about an event.
AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME
Return the address space name.
Definition: amd-dbgapi.h:4909
amd_dbgapi_set_watchpoint
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_global_address_t *watchpoint_address, amd_dbgapi_size_t *watchpoint_size) AMD_DBGAPI_VERSION_0_36
Set a hardware data watchpoint.
AMD_DBGAPI_VERSION_0_36
#define AMD_DBGAPI_VERSION_0_36
The function was introduced in version 0.36 of the interface and has the symbol version string of "AM...
Definition: amd-dbgapi.h:473
AMD_DBGAPI_WAVE_STOP_REASON_FP_INPUT_DENORMAL
@ 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:3057
AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT
@ AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT
The wave stopped due to executing a breakpoint instruction.
Definition: amd-dbgapi.h:3024
AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW
The wave stopped due to triggering an enabled floating point overflow exception.
Definition: amd-dbgapi.h:3067
AMD_DBGAPI_PROCESS_INFO_NOTIFIER
@ AMD_DBGAPI_PROCESS_INFO_NOTIFIER
The notifier for the process that indicates if pending events are available.
Definition: amd-dbgapi.h:1554
AMD_DBGAPI_STATUS_ERROR_INVALID_SHARED_LIBRARY_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_SHARED_LIBRARY_ID
The shared library handle is invalid.
Definition: amd-dbgapi.h:866
AMD_DBGAPI_INSTRUCTION_KIND_HALT
@ AMD_DBGAPI_INSTRUCTION_KIND_HALT
The instruction unconditionally halts the wave.
Definition: amd-dbgapi.h:1404
AMD_DBGAPI_EVENT_INFO_BREAKPOINT
@ AMD_DBGAPI_EVENT_INFO_BREAKPOINT
Return the breakpoint of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition: amd-dbgapi.h:5782
AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL
@ AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL
The instruction executes sequentially.
Definition: amd-dbgapi.h:1340
AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID
The displaced stepping handle is invalid.
Definition: amd-dbgapi.h:817
AMD_DBGAPI_STATUS_ERROR
@ AMD_DBGAPI_STATUS_ERROR
A generic error has occurred.
Definition: amd-dbgapi.h:693
AMD_DBGAPI_QUEUE_ERROR_REASON_ASSERT_TRAP
@ AMD_DBGAPI_QUEUE_ERROR_REASON_ASSERT_TRAP
A wave on the queue had an assert trap.
Definition: amd-dbgapi.h:2406
AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED
The process is already attached to the given inferior process.
Definition: amd-dbgapi.h:761
amd_dbgapi_memory_precision_t
amd_dbgapi_memory_precision_t
Memory access precision.
Definition: amd-dbgapi.h:5504
AMD_DBGAPI_ADDRESS_CLASS_INFO_ADDRESS_SPACE
@ 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:4707
amd_dbgapi_agent_list
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_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_24
Return the list of agents for a process.
amd_dbgapi_dwarf_address_class_to_address_class
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_24
Return the architecture source language address class from a DWARF address class number.
AMD_DBGAPI_INSTRUCTION_KIND_SLEEP
@ 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:1417
AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE
@ AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE
Return the largest instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1109
amd_dbgapi_callbacks_s::deallocate_memory
void(* deallocate_memory)(void *data)
Deallocate memory that was allocated by amd_dbgapi_callbacks_s::allocate_memory.
Definition: amd-dbgapi.h:6177
AMD_DBGAPI_WAVE_INFO_EXEC_MASK
@ AMD_DBGAPI_WAVE_INFO_EXEC_MASK
Return the current execution mask of the wave.
Definition: amd-dbgapi.h:2905
AMD_DBGAPI_STATUS_SUCCESS
@ AMD_DBGAPI_STATUS_SUCCESS
The function has executed successfully.
Definition: amd-dbgapi.h:689
AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED
The library is already initialized.
Definition: amd-dbgapi.h:737
AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID
The address class handle is invalid.
Definition: amd-dbgapi.h:846
amd_dbgapi_process_detach
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_detach(amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_24
Detach from a process and no longer have debug control of the AMD GPU devices it uses.
AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME
@ AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME
Request to resume a host breakpoint.
Definition: amd-dbgapi.h:5656
amd_dbgapi_wave_state_t
amd_dbgapi_wave_state_t
The execution state of a wave.
Definition: amd-dbgapi.h:2981
amd_dbgapi_set_memory_precision
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_24
Control precision of memory access reporting.
AMD_DBGAPI_QUEUE_INFO_OS_ID
@ AMD_DBGAPI_QUEUE_INFO_OS_ID
Native operating system queue ID.
Definition: amd-dbgapi.h:2317
AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS
Return the dispatch kernel argument segment address.
Definition: amd-dbgapi.h:2646
AMD_DBGAPI_QUEUE_INFO_ERROR_REASON
@ AMD_DBGAPI_QUEUE_INFO_ERROR_REASON
Return the reason the queue is in error as a bit set.
Definition: amd-dbgapi.h:2302
AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER
@ AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER
The register is a member of the register class.
Definition: amd-dbgapi.h:4375
amd_dbgapi_register_id_t
Opaque register handle.
Definition: amd-dbgapi.h:4069
amd_dbgapi_os_agent_id_t
uint64_t amd_dbgapi_os_agent_id_t
Native operating system agent ID.
Definition: amd-dbgapi.h:577
AMD_DBGAPI_LOG_LEVEL_WARNING
@ AMD_DBGAPI_LOG_LEVEL_WARNING
Print fatal error and warning messages.
Definition: amd-dbgapi.h:5913
amd_dbgapi_event_info_t
amd_dbgapi_event_info_t
Event queries that are supported by amd_dbgapi_event_get_info.
Definition: amd-dbgapi.h:5766
amd_dbgapi_address_space_get_info
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_space_get_info(amd_dbgapi_architecture_id_t architecture_id, 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_30
Query information about an address space.
amd_dbgapi_agent_id_t::handle
uint64_t handle
Definition: amd-dbgapi.h:2085