amd-dbgapi.h Source File

amd-dbgapi.h Source File#

ROCdbgapi: amd-dbgapi.h Source File
amd-dbgapi.h
Go to the documentation of this file.
1 /* Copyright (c) 2019-2024 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 
492 #ifndef AMD_DBGAPI_H
493 #define AMD_DBGAPI_H 1
494 
495 /* Placeholder for calling convention and import/export macros */
496 #if !defined(AMD_DBGAPI_CALL)
497 #define AMD_DBGAPI_CALL
498 #endif /* !defined (AMD_DBGAPI_CALL) */
499 
500 #if !defined(AMD_DBGAPI_EXPORT_DECORATOR)
501 # if defined(_WIN32)
502 # define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)
503 # elif defined(__GNUC__)
504 # define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default")))
505 # else
506 # define AMD_DBGAPI_EXPORT_DECORATOR
507 # endif
508 #endif /* !defined (AMD_DBGAPI_EXPORT_DECORATOR) */
509 
510 #if !defined(AMD_DBGAPI_IMPORT_DECORATOR)
511 # if defined(_WIN32)
512 # define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)
513 # else
514 # define AMD_DBGAPI_IMPORT_DECORATOR
515 # endif
516 #endif /* !defined (AMD_DBGAPI_IMPORT_DECORATOR) */
517 
518 /* True if dbgapi was built as a static library. */
519 #define AMD_DBGAPI_STATIC_LIB @AMD_DBGAPI_STATIC_LIB@
520 
521 #if !defined(AMD_DBGAPI)
522 # if AMD_DBGAPI_STATIC_LIB
523 # define AMD_DBGAPI AMD_DBGAPI_CALL
524 # else
525 # if defined(AMD_DBGAPI_EXPORTS)
526 # define AMD_DBGAPI AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL
527 # else
528 # define AMD_DBGAPI AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL
529 # endif
530 # endif
531 #endif /* !defined (AMD_DBGAPI) */
532 
533 /* By default, MSVC reports 199711L (C++98) for the __cplusplus macro,
534  regardless of the actual language version you are using (like C++17
535  or C++20). Instead, we need to look at _MSVC_LANG, which correctly
536  reports the C++ standard version being targeted by the
537  compiler. */
538 #if defined(__cplusplus)
539 # if defined(_MSVC_LANG)
540 # define AMD_DBGAPI_CPLUSPLUS _MSVC_LANG
541 # else
542 # define AMD_DBGAPI_CPLUSPLUS __cplusplus
543 # endif
544 #endif
545 
546 #if defined(__cplusplus) && AMD_DBGAPI_CPLUSPLUS >= 201103L
547 /* c++11 allows extended initializer lists. */
548 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) (type{ value })
549 #elif __STDC_VERSION__ >= 199901L
550 /* c99 allows compound literals. */
551 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) ((type){ value })
552 #else /* !__STDC_VERSION__ >= 199901L */
553 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) {value}
554 #endif /* !__STDC_VERSION__ >= 199901L */
555 
556 #if defined(__cplusplus) && AMD_DBGAPI_CPLUSPLUS >= 201402L
557 #define DEPRECATED [[deprecated]]
558 #else
559 #define DEPRECATED
560 #endif
561 
562 #if defined(__cplusplus)
563 extern "C" {
564 #endif /* defined (__cplusplus) */
565 
566 #if defined(__linux__)
567 #include <sys/types.h>
568 #endif /* __linux__ */
569 
570 #if defined(_WIN32)
571 /* Define these ourselves to avoid including windows.h in our public
572  header and polluting the namespace. */
573 typedef void *amd_dbgapi_HANDLE;
574 typedef unsigned long amd_dbgapi_DWORD;
575 #endif /* _WIN32 */
576 
577 #include <stddef.h>
578 #include <stdint.h>
579 
599 #define AMD_DBGAPI_VERSION_0_54
600 
605 #define AMD_DBGAPI_VERSION_0_56
606 
611 #define AMD_DBGAPI_VERSION_0_58
612 
617 #define AMD_DBGAPI_VERSION_0_62
618 
623 #define AMD_DBGAPI_VERSION_0_64
624 
629 #define AMD_DBGAPI_VERSION_0_67
630 
635 #define AMD_DBGAPI_VERSION_0_68
636 
641 #define AMD_DBGAPI_VERSION_0_70
642 
647 #define AMD_DBGAPI_VERSION_0_76
648 
653 #define AMD_DBGAPI_VERSION_0_77
654 
659 #define AMD_DBGAPI_VERSION_0_78
660 
665 #define AMD_DBGAPI_VERSION_0_79
666 
671 #define AMD_DBGAPI_VERSION_0_80
672 
677 #define AMD_DBGAPI_VERSION_0_81
678 
683 #define AMD_DBGAPI_VERSION_0_82
684 
692 
716 
720 typedef uint64_t amd_dbgapi_size_t;
721 
725 typedef enum
726 {
736 
744 #if defined(__linux__)
746 #elif defined(_WIN32)
747 typedef amd_dbgapi_DWORD amd_dbgapi_os_process_id_t;
748 #endif /* _WIN32 */
749 
780 #if defined(__linux__)
782 #elif defined(_WIN32)
783 typedef amd_dbgapi_HANDLE amd_dbgapi_notifier_t;
784 #endif /* _WIN32 */
785 
793 #if defined(__linux__) || defined(_WIN32)
794 typedef uint64_t amd_dbgapi_os_agent_id_t;
795 #endif /* __linux__ || _WIN32 */
796 
803 #if defined(__linux__) || defined(_WIN32)
804 typedef uint64_t amd_dbgapi_os_queue_id_t;
805 #endif /* __linux__ || _WIN32 */
806 
815 #if defined(__linux__) || defined(_WIN32)
817 #endif /* __linux__ || _WIN32 */
818 
826 #if defined(__linux__) || defined(_WIN32)
827 typedef enum
828 {
850 #endif /* __linux__ || _WIN32 */
851 
864 typedef enum
865 {
1115 
1133  amd_dbgapi_status_t status,
1134  const char **status_string) AMD_DBGAPI_VERSION_0_54;
1135 
1159 #define AMD_DBGAPI_VERSION_MAJOR @PROJECT_VERSION_MAJOR@
1160 
1165 #define AMD_DBGAPI_VERSION_MINOR @PROJECT_VERSION_MINOR@
1166 
1181  uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_54;
1182 
1191 const char AMD_DBGAPI *
1193 
1241 
1268 
1290 typedef struct
1291 {
1292  uint64_t handle;
1294 
1298 #define AMD_DBGAPI_ARCHITECTURE_NONE \
1299  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_architecture_id_t, 0)
1300 
1304 typedef enum
1305 {
1315 
1323 typedef enum
1324 {
1387 
1427  amd_dbgapi_architecture_id_t architecture_id,
1428  amd_dbgapi_architecture_info_t query, size_t value_size,
1429  void *value) AMD_DBGAPI_VERSION_0_54;
1430 
1460  uint32_t elf_amdgpu_machine,
1462 
1469 typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;
1470 
1565  amd_dbgapi_architecture_id_t architecture_id,
1567  const void *memory, char **instruction_text,
1568  amd_dbgapi_symbolizer_id_t symbolizer_id,
1569  amd_dbgapi_status_t (*symbolizer) (
1570  amd_dbgapi_symbolizer_id_t symbolizer_id,
1572  char **symbol_text)) AMD_DBGAPI_VERSION_0_54;
1573 
1577 typedef enum
1578 {
1699 
1703 typedef enum
1704 {
1710 
1786  amd_dbgapi_architecture_id_t architecture_id,
1788  const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind,
1789  amd_dbgapi_instruction_properties_t *instruction_properties,
1790  void **instruction_information) AMD_DBGAPI_VERSION_0_58;
1791 
1813 typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;
1814 
1825 typedef struct
1826 {
1827  uint64_t handle;
1829 
1833 #define AMD_DBGAPI_PROCESS_NONE \
1834  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_process_id_t, 0)
1835 
1839 typedef enum
1840 {
1843 
1847 
1851 typedef struct
1852 {
1858  size_t size;
1866  const void *data;
1868 
1875 typedef enum
1876 {
1940 
1992  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_80;
1993 
2091  amd_dbgapi_client_process_id_t client_process_id,
2093 
2142 
2157 typedef enum
2158 {
2190 
2220  amd_dbgapi_process_id_t process_id,
2222 
2234 typedef enum
2235 {
2245 
2275  amd_dbgapi_process_id_t process_id,
2277 
2348 
2375 
2403 typedef struct
2404 {
2405  uint64_t handle;
2407 
2411 #define AMD_DBGAPI_CODE_OBJECT_NONE \
2412  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_code_object_id_t, 0)
2413 
2420 typedef enum
2421 {
2490 
2530  amd_dbgapi_code_object_id_t code_object_id,
2531  amd_dbgapi_code_object_info_t query, size_t value_size,
2532  void *value) AMD_DBGAPI_VERSION_0_54;
2533 
2584  amd_dbgapi_process_id_t process_id, size_t *code_object_count,
2585  amd_dbgapi_code_object_id_t **code_objects,
2587 
2604 typedef struct
2605 {
2606  uint64_t handle;
2608 
2612 #define AMD_DBGAPI_AGENT_NONE \
2613  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_agent_id_t, 0)
2614 
2621 typedef enum
2622 {
2683 
2687 typedef enum
2688 {
2717 
2762  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_67;
2763 
2816  amd_dbgapi_process_id_t process_id, size_t *agent_count,
2817  amd_dbgapi_agent_id_t **agents,
2819 
2838 typedef struct
2839 {
2840  uint64_t handle;
2842 
2846 #define AMD_DBGAPI_QUEUE_NONE \
2847  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_queue_id_t, 0)
2848 
2855 typedef enum
2856 {
2905 
2946  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_68;
2947 
2951 typedef enum
2952 {
2972 
2977 typedef enum
2978 {
3033  AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION DEPRECATED
3073 
3127  amd_dbgapi_process_id_t process_id, size_t *queue_count,
3128  amd_dbgapi_queue_id_t **queues,
3130 
3195  amd_dbgapi_queue_id_t queue_id,
3196  amd_dbgapi_os_queue_packet_id_t *read_packet_id,
3197  amd_dbgapi_os_queue_packet_id_t *write_packet_id,
3198  size_t *packets_byte_size, void **packets_bytes) AMD_DBGAPI_VERSION_0_54;
3199 
3218 typedef struct
3219 {
3220  uint64_t handle;
3222 
3226 #define AMD_DBGAPI_DISPATCH_NONE \
3227  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_dispatch_id_t, 0)
3228 
3234 typedef enum
3235 {
3245 
3252 typedef enum
3253 {
3362 
3406  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_82;
3407 
3414 typedef enum
3415 {
3426 
3433 typedef enum
3434 {
3448 
3498  amd_dbgapi_process_id_t process_id, size_t *dispatch_count,
3499  amd_dbgapi_dispatch_id_t **dispatches,
3501 
3518 typedef struct
3519 {
3520  uint64_t handle;
3522 
3526 #define AMD_DBGAPI_CLUSTER_NONE \
3527  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_cluster_id_t, 0)
3528 
3535 typedef enum
3536 {
3574 
3615  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_82;
3616 
3633 typedef struct
3634 {
3635  uint64_t handle;
3637 
3641 #define AMD_DBGAPI_WORKGROUP_NONE \
3642  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_workgroup_id_t, 0)
3643 
3650 typedef enum
3651 {
3710 
3755  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_82;
3756 
3807  amd_dbgapi_process_id_t process_id, size_t *workgroup_count,
3808  amd_dbgapi_workgroup_id_t **workgroups,
3810 
3827 typedef struct
3828 {
3829  uint64_t handle;
3831 
3835 #define AMD_DBGAPI_WAVE_NONE \
3836  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_wave_id_t, 0)
3837 
3844 typedef enum
3845 {
3983 
4032  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_82;
4033 
4037 typedef enum
4038 {
4062 
4069 typedef enum
4070 {
4229  AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION DEPRECATED
4261 
4310  amd_dbgapi_process_id_t process_id, size_t *wave_count,
4311  amd_dbgapi_wave_id_t **waves,
4313 
4397 
4401 typedef enum
4402 {
4412 
4568  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_resume_mode_t resume_mode,
4570 
4672 typedef struct
4673 {
4674  uint64_t handle;
4676 
4680 #define AMD_DBGAPI_DISPLACED_STEPPING_NONE \
4681  (amd_dbgapi_displaced_stepping_id_t{ 0 })
4682 
4690 typedef enum
4691 {
4698 
4739  amd_dbgapi_displaced_stepping_id_t displaced_stepping_id,
4740  amd_dbgapi_displaced_stepping_info_t query, size_t value_size,
4741  void *value) AMD_DBGAPI_VERSION_0_54;
4742 
4829  amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes,
4830  amd_dbgapi_displaced_stepping_id_t *displaced_stepping)
4832 
4887  amd_dbgapi_wave_id_t wave_id,
4888  amd_dbgapi_displaced_stepping_id_t displaced_stepping)
4890 
4924 typedef struct
4925 {
4926  uint64_t handle;
4928 
4932 #define AMD_DBGAPI_WATCHPOINT_NONE \
4933  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_watchpoint_id_t, 0)
4934 
4941 typedef enum
4942 {
4959 
4999  amd_dbgapi_watchpoint_id_t watchpoint_id,
5000  amd_dbgapi_watchpoint_info_t query, size_t value_size,
5001  void *value) AMD_DBGAPI_VERSION_0_54;
5002 
5009 typedef enum
5010 {
5028 
5035 typedef enum
5036 {
5056 
5063 typedef struct
5064 {
5065  size_t count;
5068 
5144 
5169 
5191 typedef struct
5192 {
5193  uint64_t handle;
5195 
5199 #define AMD_DBGAPI_REGISTER_CLASS_NONE \
5200  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_class_id_t, 0)
5201 
5209 typedef enum
5210 {
5224 
5265  amd_dbgapi_register_class_id_t register_class_id,
5266  amd_dbgapi_register_class_info_t query, size_t value_size,
5267  void *value) AMD_DBGAPI_VERSION_0_54;
5268 
5310  amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count,
5312 
5321 typedef struct
5322 {
5323  uint64_t handle;
5325 
5329 #define AMD_DBGAPI_REGISTER_NONE \
5330  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_id_t, 0)
5331 
5338 typedef enum
5339 {
5365 
5372 typedef enum
5373 {
5467 
5513  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_70;
5514 
5518 typedef enum
5519 {
5529 
5564  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,
5566 
5612  amd_dbgapi_architecture_id_t architecture_id, size_t *register_count,
5614 
5659  amd_dbgapi_wave_id_t wave_id, size_t *register_count,
5661 
5699  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register,
5701 
5705 typedef enum
5706 {
5716 
5755  amd_dbgapi_register_class_id_t register_class_id,
5756  amd_dbgapi_register_id_t register_id,
5757  amd_dbgapi_register_class_state_t *register_class_state)
5759 
5817  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,
5818  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5819  void *value) AMD_DBGAPI_VERSION_0_62;
5820 
5886  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,
5887  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,
5888  const void *value) AMD_DBGAPI_VERSION_0_76;
5889 
5944  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,
5946 
5954 typedef struct
5955 {
5957  amd_dbgapi_register_id_t saved_return_address_register[2];
5959 
5999 typedef uint32_t amd_dbgapi_lane_id_t;
6000 
6004 #define AMD_DBGAPI_LANE_NONE ((amd_dbgapi_lane_id_t) (-1))
6005 
6019 typedef struct
6020 {
6021  uint64_t handle;
6023 
6027 #define AMD_DBGAPI_ADDRESS_CLASS_NONE \
6028  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_class_id_t, 0)
6029 
6037 typedef enum
6038 {
6061 
6102  amd_dbgapi_address_class_id_t address_class_id,
6103  amd_dbgapi_address_class_info_t query, size_t value_size,
6104  void *value) AMD_DBGAPI_VERSION_0_62;
6105 
6148  amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count,
6150 
6190  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class,
6192 
6204 typedef struct
6205 {
6206  uint64_t handle;
6208 
6212 #define AMD_DBGAPI_ADDRESS_SPACE_NONE \
6213  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 0)
6214 
6221 #define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL \
6222  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 1)
6223 
6227 typedef enum
6228 {
6245 
6253 typedef enum
6254 {
6283 
6323  amd_dbgapi_address_space_id_t address_space_id,
6324  amd_dbgapi_address_space_info_t query, size_t value_size,
6325  void *value) AMD_DBGAPI_VERSION_0_62;
6326 
6366  amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count,
6368 
6409  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space,
6411 
6429 
6557  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
6558  amd_dbgapi_lane_id_t lane_id,
6559  amd_dbgapi_address_space_id_t source_address_space_id,
6560  amd_dbgapi_segment_address_t source_segment_address,
6561  amd_dbgapi_address_space_id_t destination_address_space_id,
6562  amd_dbgapi_segment_address_t *destination_segment_address,
6563  amd_dbgapi_size_t *destination_contiguous_bytes)
6565 
6571 typedef enum
6572 {
6598 
6659  amd_dbgapi_process_id_t process_id,
6660  amd_dbgapi_wave_id_t wave_id,
6661  amd_dbgapi_address_space_id_t address_space_id,
6662  amd_dbgapi_segment_address_t segment_address,
6663  amd_dbgapi_segment_address_dependency_t *segment_address_dependency)
6665 
6670 typedef enum
6671 {
6683 
6756  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id,
6757  amd_dbgapi_address_space_id_t address_space_id,
6758  amd_dbgapi_segment_address_t segment_address,
6759  amd_dbgapi_address_class_id_t address_class_id,
6760  amd_dbgapi_address_class_state_t *address_class_state)
6762 
6866  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
6867  amd_dbgapi_lane_id_t lane_id,
6868  amd_dbgapi_address_space_id_t address_space_id,
6869  amd_dbgapi_segment_address_t segment_address,
6870  amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_78;
6871 
6979  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,
6980  amd_dbgapi_lane_id_t lane_id,
6981  amd_dbgapi_address_space_id_t address_space_id,
6982  amd_dbgapi_segment_address_t segment_address,
6983  amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_78;
6984 
7003 typedef enum
7004 {
7016 
7056  amd_dbgapi_process_id_t process_id,
7058 
7077 typedef enum
7078 {
7091 
7132  amd_dbgapi_process_id_t process_id,
7133  amd_dbgapi_alu_exceptions_precision_t alu_exceptions_precision)
7135 
7167 typedef struct
7168 {
7169  uint64_t handle;
7171 
7175 #define AMD_DBGAPI_EVENT_NONE \
7176  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_event_id_t, 0)
7177 
7181 typedef enum
7182 {
7291 
7328  amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id,
7330 
7334 typedef enum
7335 {
7352 
7359 typedef enum
7360 {
7400 
7442  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;
7443 
7471 
7493 typedef enum
7494 {
7521 
7542 
7568 typedef struct
7569 {
7570  uint64_t handle;
7572 
7576 #define AMD_DBGAPI_BREAKPOINT_NONE \
7577  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_breakpoint_id_t, 0)
7578 
7585 typedef enum
7586 {
7593 
7633  amd_dbgapi_breakpoint_id_t breakpoint_id,
7634  amd_dbgapi_breakpoint_info_t query, size_t value_size,
7635  void *value) AMD_DBGAPI_VERSION_0_54;
7636 
7640 typedef enum
7641 {
7651 
7661 typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;
7662 
7701  amd_dbgapi_breakpoint_id_t breakpoint_id,
7702  amd_dbgapi_client_thread_id_t client_thread_id,
7704 
7711 typedef enum
7712 {
7735 
7743 {
7744 
7756  void *(*allocate_memory) (size_t byte_size);
7757 
7774  void (*deallocate_memory) (void *data);
7775 
7811  amd_dbgapi_client_process_id_t client_process_id,
7813  size_t value_size, void *value);
7814 
7851  amd_dbgapi_client_process_id_t client_process_id,
7853  amd_dbgapi_breakpoint_id_t breakpoint_id);
7854 
7886  amd_dbgapi_client_process_id_t client_process_id,
7887  amd_dbgapi_breakpoint_id_t breakpoint_id);
7888 
7926  amd_dbgapi_client_process_id_t client_process_id,
7927  amd_dbgapi_global_address_t global_address,
7928  amd_dbgapi_size_t *value_size, void *read_buffer,
7929  const void *write_buffer);
7930 
7939  void (*log_message) (amd_dbgapi_log_level_t level, const char *message);
7940 };
7941 
7944 #if defined(__cplusplus)
7945 } /* extern "C" */
7946 #endif /* defined (__cplusplus) */
7947 
7948 #endif /* amd-dbgapi.h */
#define AMD_DBGAPI
Definition: amd-dbgapi.h:528
#define DEPRECATED
Old deprecated name kept for backward compatibility.
Definition: amd-dbgapi.h:559
amd_dbgapi_agent_state_t
Agent state.
Definition: amd-dbgapi.h:2688
amd_dbgapi_agent_info_t
Agent queries that are supported by amd_dbgapi_agent_get_info.
Definition: amd-dbgapi.h:2622
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:2715
@ AMD_DBGAPI_AGENT_STATE_SUPPORTED
Agent supports debugging.
Definition: amd-dbgapi.h:2692
@ AMD_DBGAPI_AGENT_INFO_STATE
Return the agent state.
Definition: amd-dbgapi.h:2648
@ AMD_DBGAPI_AGENT_INFO_OS_ID
Native operating system agent ID.
Definition: amd-dbgapi.h:2681
@ AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID
PCI device ID of the agent.
Definition: amd-dbgapi.h:2666
@ AMD_DBGAPI_AGENT_INFO_PROCESS
Return the process to which this agent belongs.
Definition: amd-dbgapi.h:2627
@ AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID
PCI vendor ID of the agent.
Definition: amd-dbgapi.h:2662
@ AMD_DBGAPI_AGENT_INFO_NAME
Agent name.
Definition: amd-dbgapi.h:2633
@ AMD_DBGAPI_AGENT_INFO_ARCHITECTURE
Return the architecture of this agent.
Definition: amd-dbgapi.h:2643
@ AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT
Total number of Execution Units (EUs) available in the agent.
Definition: amd-dbgapi.h:2671
@ AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN
PCI domain the agent is in.
Definition: amd-dbgapi.h:2652
@ 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:2658
@ AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT
Maximum number of waves supported by an execution unit.
Definition: amd-dbgapi.h:2676
amd_dbgapi_architecture_info_t
Architecture queries that are supported by amd_dbgapi_architecture_get_info.
Definition: amd-dbgapi.h:1324
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:1469
amd_dbgapi_instruction_kind_t
The kinds of instruction classifications.
Definition: amd-dbgapi.h:1578
amd_dbgapi_instruction_properties_t
A bit mask of the properties of an instruction.
Definition: amd-dbgapi.h:1704
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_cluster_support_t
Cluster support.
Definition: amd-dbgapi.h:1305
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:1339
@ AMD_DBGAPI_ARCHITECTURE_INFO_CLUSTERS_SUPPORTED
Return if this architecture supports clusters.
Definition: amd-dbgapi.h:1385
@ AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT
Return the minimum instruction alignment in bytes for the architecture.
Definition: amd-dbgapi.h:1350
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE
Return the breakpoint instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1355
@ AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER
Return the register handle for the PC for the architecture.
Definition: amd-dbgapi.h:1374
@ 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:1369
@ AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE
Return the largest instruction size in bytes for the architecture.
Definition: amd-dbgapi.h:1344
@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION
Return the breakpoint instruction for the architecture.
Definition: amd-dbgapi.h:1363
@ AMD_DBGAPI_ARCHITECTURE_INFO_NAME
Return the architecture name.
Definition: amd-dbgapi.h:1331
@ 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:1672
@ 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:1641
@ AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL
The instruction executes sequentially.
Definition: amd-dbgapi.h:1589
@ 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:1620
@ 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:1687
@ AMD_DBGAPI_INSTRUCTION_KIND_HALT
The instruction unconditionally halts the wave.
Definition: amd-dbgapi.h:1665
@ AMD_DBGAPI_INSTRUCTION_KIND_TRAP
The instruction enters the trap handler.
Definition: amd-dbgapi.h:1660
@ 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:1631
@ 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:1610
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL
The instruction conditionally branches to a literal address.
Definition: amd-dbgapi.h:1602
@ AMD_DBGAPI_INSTRUCTION_KIND_RELATIVE_BRANCH_REGISTER_PAIR
The instruction unconditionally branches to "PC + offset".
Definition: amd-dbgapi.h:1697
@ 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:1678
@ AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE
The instruction terminates the wave execution.
Definition: amd-dbgapi.h:1646
@ AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN
The instruction classification is unknown.
Definition: amd-dbgapi.h:1583
@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH
The instruction unconditionally branches to a literal address.
Definition: amd-dbgapi.h:1595
@ AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE
The instruction has no properties.
Definition: amd-dbgapi.h:1708
@ AMD_DBGAPI_CLUSTERS_SUPPORTED
Clusters are supported.
Definition: amd-dbgapi.h:1313
@ AMD_DBGAPI_CLUSTERS_UNSUPPORTED
Clusters are not supported.
Definition: amd-dbgapi.h:1309
uint64_t amd_dbgapi_size_t
Integral type used for sizes, including memory allocations, in the inferior.
Definition: amd-dbgapi.h:720
uint64_t amd_dbgapi_os_queue_id_t
Native operating system queue ID.
Definition: amd-dbgapi.h:804
uint64_t amd_dbgapi_global_address_t
Integral type used for a global virtual memory address in the inferior process.
Definition: amd-dbgapi.h:715
uint64_t amd_dbgapi_os_queue_packet_id_t
Native operating system queue packet ID.
Definition: amd-dbgapi.h:816
uint64_t amd_dbgapi_os_agent_id_t
Native operating system agent ID.
Definition: amd-dbgapi.h:794
amd_dbgapi_os_queue_type_t
Native operating system queue type.
Definition: amd-dbgapi.h:828
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:781
pid_t amd_dbgapi_os_process_id_t
Native operating system process ID.
Definition: amd-dbgapi.h:745
amd_dbgapi_changed_t
Indication of if a value has changed.
Definition: amd-dbgapi.h:726
@ AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN
Unknown queue type.
Definition: amd-dbgapi.h:832
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA
Queue supports the AMD SDMA protocol.
Definition: amd-dbgapi.h:844
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4
Queue supports the AMD PM4 protocol.
Definition: amd-dbgapi.h:840
@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI
Queue supports the AMD SDMA XGMI protocol.
Definition: amd-dbgapi.h:848
@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL
Queue supports the HSA AQL protocol.
Definition: amd-dbgapi.h:836
@ AMD_DBGAPI_CHANGED_YES
The value has changed.
Definition: amd-dbgapi.h:734
@ AMD_DBGAPI_CHANGED_NO
The value has not changed.
Definition: amd-dbgapi.h:730
amd_dbgapi_breakpoint_info_t
Breakpoint queries that are supported by amd_dbgapi_breakpoint_get_info.
Definition: amd-dbgapi.h:7586
amd_dbgapi_client_process_info_t
Client queries that are supported by the client_process_get_info callback.
Definition: amd-dbgapi.h:7712
amd_dbgapi_breakpoint_action_t
The action to perform after reporting a breakpoint has been hit.
Definition: amd-dbgapi.h:7641
struct amd_dbgapi_client_thread_s * amd_dbgapi_client_thread_id_t
Opaque client thread handle.
Definition: amd-dbgapi.h:7661
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:7591
@ AMD_DBGAPI_CLIENT_PROCESS_INFO_CORE_STATE
If the current process is created from a core file, return the content of the AMDGPU state note if pr...
Definition: amd-dbgapi.h:7733
@ AMD_DBGAPI_CLIENT_PROCESS_INFO_OS_PID
Return the native operating system process handle.
Definition: amd-dbgapi.h:7723
@ AMD_DBGAPI_BREAKPOINT_ACTION_RESUME
Resume execution.
Definition: amd-dbgapi.h:7645
@ AMD_DBGAPI_BREAKPOINT_ACTION_HALT
Leave execution halted.
Definition: amd-dbgapi.h:7649
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_cluster_get_info(amd_dbgapi_cluster_id_t cluster_id, amd_dbgapi_cluster_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_82
Query information about a cluster.
amd_dbgapi_cluster_info_t
Cluster queries that are supported by amd_dbgapi_cluster_get_info.
Definition: amd-dbgapi.h:3536
@ AMD_DBGAPI_CLUSTER_INFO_QUEUE
Return the queue to which this cluster belongs.
Definition: amd-dbgapi.h:3546
@ AMD_DBGAPI_CLUSTER_INFO_CLUSTER_COORD
The cluster coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3572
@ AMD_DBGAPI_CLUSTER_INFO_PROCESS
Return the process to which this cluster belongs.
Definition: amd-dbgapi.h:3556
@ AMD_DBGAPI_CLUSTER_INFO_DISPATCH
Return the dispatch to which this cluster belongs.
Definition: amd-dbgapi.h:3541
@ AMD_DBGAPI_CLUSTER_INFO_AGENT
Return the agent to which this cluster belongs.
Definition: amd-dbgapi.h:3551
@ AMD_DBGAPI_CLUSTER_INFO_ARCHITECTURE
Return the architecture of this cluster.
Definition: amd-dbgapi.h:3561
amd_dbgapi_code_object_info_t
Code object queries that are supported by amd_dbgapi_code_object_get_info.
Definition: amd-dbgapi.h:2421
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:2426
@ 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:2482
@ 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:2488
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_unfreeze(amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_76
Unfreeze the process identified by process_id.
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_freeze(amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_76
Freeze the process identified by process_id.
amd_dbgapi_dispatch_info_t
Dispatch queries that are supported by amd_dbgapi_dispatch_get_info.
Definition: amd-dbgapi.h:3253
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_cluster_mode_t
Cluster mode.
Definition: amd-dbgapi.h:3235
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_82
Query information about a dispatch.
amd_dbgapi_dispatch_barrier_t
Dispatch barrier.
Definition: amd-dbgapi.h:3415
amd_dbgapi_dispatch_fence_scope_t
Dispatch memory fence scope.
Definition: amd-dbgapi.h:3434
@ AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE
Return the dispatch acquire fence.
Definition: amd-dbgapi.h:3289
@ AMD_DBGAPI_DISPATCH_INFO_CLUSTER_SIZES
Return the dispatch cluster size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:3360
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS
Return the dispatch kernel argument segment address.
Definition: amd-dbgapi.h:3324
@ AMD_DBGAPI_DISPATCH_INFO_QUEUE
Return the queue to which this dispatch belongs.
Definition: amd-dbgapi.h:3258
@ AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE
Return the dispatch group segment size in bytes.
Definition: amd-dbgapi.h:3319
@ AMD_DBGAPI_DISPATCH_INFO_AGENT
Return the agent to which this dispatch belongs.
Definition: amd-dbgapi.h:3263
@ AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS
Return the dispatch grid dimensionality.
Definition: amd-dbgapi.h:3299
@ 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:3279
@ AMD_DBGAPI_DISPATCH_INFO_PROCESS
Return the process to which this dispatch belongs.
Definition: amd-dbgapi.h:3268
@ AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES
Return the dispatch grid size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:3309
@ AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE
Return the dispatch release fence.
Definition: amd-dbgapi.h:3294
@ AMD_DBGAPI_DISPATCH_INFO_BARRIER
Return the dispatch barrier setting.
Definition: amd-dbgapi.h:3284
@ AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE
Return the architecture of this dispatch.
Definition: amd-dbgapi.h:3273
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS
Return the dispatch kernel descriptor address.
Definition: amd-dbgapi.h:3329
@ AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE
Return the dispatch private segment size in bytes.
Definition: amd-dbgapi.h:3314
@ AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES
Return the dispatch workgroup size (work-items) in the X, Y, and Z dimensions.
Definition: amd-dbgapi.h:3304
@ AMD_DBGAPI_DISPATCH_INFO_CLUSTER_MODE
Return if the dispatch is in cluster mode.
Definition: amd-dbgapi.h:3355
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS
Return the dispatch completion event address.
Definition: amd-dbgapi.h:3344
@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS
Return the dispatch kernel code entry address.
Definition: amd-dbgapi.h:3334
@ AMD_DBGAPI_CLUSTER_MODE_ENABLED
Cluster mode is enabled.
Definition: amd-dbgapi.h:3243
@ AMD_DBGAPI_CLUSTER_MODE_DISABLED
Cluster mode is disabled.
Definition: amd-dbgapi.h:3239
@ AMD_DBGAPI_DISPATCH_BARRIER_NONE
Dispatch has no barrier.
Definition: amd-dbgapi.h:3419
@ AMD_DBGAPI_DISPATCH_BARRIER_PRESENT
Dispatch has a barrier.
Definition: amd-dbgapi.h:3424
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE
There is no fence.
Definition: amd-dbgapi.h:3438
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT
There is a fence with agent memory scope.
Definition: amd-dbgapi.h:3442
@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM
There is a fence with system memory scope.
Definition: amd-dbgapi.h:3446
amd_dbgapi_displaced_stepping_info_t
Displaced stepping queries that are supported by amd_dbgapi_displaced_stepping_id_t.
Definition: amd-dbgapi.h:4691
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_complete(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_displaced_stepping_id_t displaced_stepping) AMD_DBGAPI_VERSION_0_76
Complete a displaced stepping buffer for a wave.
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_76
Associate an active displaced stepping buffer with a wave.
@ AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS
Return the process to which this displaced stepping buffer belongs.
Definition: amd-dbgapi.h:4696
amd_dbgapi_event_info_t
Event queries that are supported by amd_dbgapi_event_get_info.
Definition: amd-dbgapi.h:7360
amd_dbgapi_runtime_state_t
Inferior's runtime state.
Definition: amd-dbgapi.h:7335
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:7182
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:7386
@ AMD_DBGAPI_EVENT_INFO_KIND
Return the event kind.
Definition: amd-dbgapi.h:7370
@ 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:7393
@ AMD_DBGAPI_EVENT_INFO_BREAKPOINT
Return the breakpoint of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.
Definition: amd-dbgapi.h:7381
@ 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:7376
@ AMD_DBGAPI_EVENT_INFO_PROCESS
Return the process to which this event belongs.
Definition: amd-dbgapi.h:7365
@ AMD_DBGAPI_EVENT_INFO_QUEUE
Return the queue of a AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR event.
Definition: amd-dbgapi.h:7398
@ AMD_DBGAPI_RUNTIME_STATE_UNLOADED
The inferior's runtime has been unloaded.
Definition: amd-dbgapi.h:7344
@ AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS
The inferior's runtime has been loaded and debugging is supported by the library.
Definition: amd-dbgapi.h:7340
@ 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:7350
@ AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED
The list of code objects has changed.
Definition: amd-dbgapi.h:7227
@ 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:7205
@ 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:7289
@ AMD_DBGAPI_EVENT_KIND_WAVE_STOP
A wave has stopped.
Definition: amd-dbgapi.h:7190
@ AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME
Request to resume a host breakpoint.
Definition: amd-dbgapi.h:7240
@ AMD_DBGAPI_EVENT_KIND_RUNTIME
The runtime support in the inferior is enabled or disabled.
Definition: amd-dbgapi.h:7255
@ AMD_DBGAPI_EVENT_KIND_NONE
No event.
Definition: amd-dbgapi.h:7186
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_76
Initialize the library.
amd_dbgapi_log_level_t
The logging levels supported.
Definition: amd-dbgapi.h:7494
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:7498
@ AMD_DBGAPI_LOG_LEVEL_VERBOSE
Print fatal error, warning, info, API tracing, and verbose messages.
Definition: amd-dbgapi.h:7519
@ AMD_DBGAPI_LOG_LEVEL_INFO
Print fatal error, warning, and info messages.
Definition: amd-dbgapi.h:7511
@ AMD_DBGAPI_LOG_LEVEL_TRACE
Print fatal error, warning, info, and API tracing messages.
Definition: amd-dbgapi.h:7515
@ AMD_DBGAPI_LOG_LEVEL_WARNING
Print fatal error and warning messages.
Definition: amd-dbgapi.h:7507
@ AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR
Print fatal error messages.
Definition: amd-dbgapi.h:7503
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_78
Read memory.
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:6038
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:5999
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_alu_exceptions_precision(amd_dbgapi_process_id_t process_id, amd_dbgapi_alu_exceptions_precision_t alu_exceptions_precision) AMD_DBGAPI_VERSION_0_77
Control precision of ALU exceptions reporting.
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_78
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.
amd_dbgapi_alu_exceptions_precision_t
ALU exceptions reporting precision.
Definition: amd-dbgapi.h:7078
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:6428
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:6572
amd_dbgapi_address_space_access_t
Indication of how the address space is accessed.
Definition: amd-dbgapi.h:6228
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_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_size_t *destination_contiguous_bytes) AMD_DBGAPI_VERSION_0_81
Convert a source segment address in the source address space into a destination segment address in th...
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:6671
amd_dbgapi_address_space_info_t
Address space queries that are supported by amd_dbgapi_address_space_get_info.
Definition: amd-dbgapi.h:6254
amd_dbgapi_memory_precision_t
Memory access precision.
Definition: amd-dbgapi.h:7004
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_dependency(amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id, 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_79
Determine the dependency of a segment address value in a particular address space.
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME
Return the source language address class name.
Definition: amd-dbgapi.h:6045
@ 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:6054
@ AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF
Return the AMD GPU DWARF address class number for the address class' architecture.
Definition: amd-dbgapi.h:6059
@ AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_NONE
ALU exceptions delivery might be reported at any time after the instructions causing them have execut...
Definition: amd-dbgapi.h:7083
@ AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_PRECISE
When an ALU exception is delivered to the waves, the wave's PC is at the instruction following the on...
Definition: amd-dbgapi.h:7089
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS
Reading or writing the segment address depends on the process.
Definition: amd-dbgapi.h:6596
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE
Reading or writing the segment address depends on the wavefront.
Definition: amd-dbgapi.h:6584
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP
Reading or writing the segment address depends on the workgroup.
Definition: amd-dbgapi.h:6588
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE
No dependence is available.
Definition: amd-dbgapi.h:6576
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE
Reading or writing the segment address depends on the lane.
Definition: amd-dbgapi.h:6580
@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT
Reading or writing the segment address depends on the agent.
Definition: amd-dbgapi.h:6592
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT
The address space is only read the waves of a kernel dispatch.
Definition: amd-dbgapi.h:6243
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT
The address space is read only.
Definition: amd-dbgapi.h:6238
@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL
The address space supports all accesses.
Definition: amd-dbgapi.h:6233
@ 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:6676
@ 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:6681
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS
Return the address space access.
Definition: amd-dbgapi.h:6276
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF
Return the AMD GPU DWARF address space number for the address space's architecture.
Definition: amd-dbgapi.h:6281
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE
Return the byte size of an address in the address space.
Definition: amd-dbgapi.h:6266
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS
Return the NULL segment address value in the address space.
Definition: amd-dbgapi.h:6271
@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME
Return the address space name.
Definition: amd-dbgapi.h:6261
@ 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:7009
@ AMD_DBGAPI_MEMORY_PRECISION_PRECISE
A wave waits for memory instructions to complete before executing further instructions.
Definition: amd-dbgapi.h:7014
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_76
Set the progress required for 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_76
Set the wave creation mode for a process.
amd_dbgapi_endianness_t
Byte endianness encoding.
Definition: amd-dbgapi.h:1840
amd_dbgapi_wave_creation_t
The kinds of wave creation supported by the hardware.
Definition: amd-dbgapi.h:2235
struct amd_dbgapi_client_process_s * amd_dbgapi_client_process_id_t
Opaque client process handle.
Definition: amd-dbgapi.h:1813
amd_dbgapi_progress_t
The kinds of progress supported by the library.
Definition: amd-dbgapi.h:2158
amd_dbgapi_process_info_t
Process queries that are supported by amd_dbgapi_process_get_info.
Definition: amd-dbgapi.h:1876
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_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_80
Query information about a process.
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_ENDIAN_LITTLE
Encoding is done using little endian.
Definition: amd-dbgapi.h:1845
@ AMD_DBGAPI_ENDIAN_BIG
Encoding is done using big endian.
Definition: amd-dbgapi.h:1842
@ AMD_DBGAPI_WAVE_CREATION_NORMAL
Normal wave creation allows new waves to be created.
Definition: amd-dbgapi.h:2239
@ AMD_DBGAPI_WAVE_CREATION_STOP
Stop wave creation prevents new waves from being created.
Definition: amd-dbgapi.h:2243
@ AMD_DBGAPI_PROGRESS_NO_FORWARD
No forward progress is needed.
Definition: amd-dbgapi.h:2188
@ AMD_DBGAPI_PROGRESS_NORMAL
Normal progress is needed.
Definition: amd-dbgapi.h:2164
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT
Return the number of data watchpoints supported by the process.
Definition: amd-dbgapi.h:1887
@ AMD_DBGAPI_PROCESS_INFO_SIGNIFICANT_ADDRESS_BITS
Return a bitmask of all the bits which are used in at least one of the address spaces of each of the ...
Definition: amd-dbgapi.h:1938
@ AMD_DBGAPI_PROCESS_INFO_CORE_STATE
Return a blob containing the content to put in the state note when generating a core dump.
Definition: amd-dbgapi.h:1930
@ 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:1899
@ AMD_DBGAPI_PROCESS_INFO_NOTIFIER
The notifier for the process that indicates if pending events are available.
Definition: amd-dbgapi.h:1881
@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE
Return how watchpoints are shared between processes.
Definition: amd-dbgapi.h:1893
@ AMD_DBGAPI_PROCESS_INFO_OS_ID
Native operating system process ID.
Definition: amd-dbgapi.h:1920
@ AMD_DBGAPI_PROCESS_INFO_PRECISE_ALU_EXCEPTIONS_SUPPORTED
Return if the architectures of all the agents of a process support controlling ALU exceptions reporti...
Definition: amd-dbgapi.h:1906
amd_dbgapi_queue_state_t
Queue state.
Definition: amd-dbgapi.h:2952
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:2978
amd_dbgapi_queue_info_t
Queue queries that are supported by amd_dbgapi_queue_get_info.
Definition: amd-dbgapi.h:2856
@ AMD_DBGAPI_QUEUE_STATE_VALID
Queue is in a valid state.
Definition: amd-dbgapi.h:2956
@ AMD_DBGAPI_QUEUE_STATE_ERROR
Queue is in the queue error state.
Definition: amd-dbgapi.h:2970
@ AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION
A wave on the queue executed an illegal instruction.
Definition: amd-dbgapi.h:3016
@ AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED
A packet on the queue has an unsupported code.
Definition: amd-dbgapi.h:3050
@ 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:3042
@ AMD_DBGAPI_EXCEPTION_WAVE_TRAP
A wave on the queue executed an instruction that caused an exception.
Definition: amd-dbgapi.h:2996
@ AMD_DBGAPI_EXCEPTION_WAVE_ABORT
A wave on the queue executed a trap instruction used to abort a dispatch.
Definition: amd-dbgapi.h:2986
@ AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR
There was an error preempting the queue.
Definition: amd-dbgapi.h:3071
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID
A dispatch packet on the queue has an invalid workgroup size.
Definition: amd-dbgapi.h:3054
@ 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:3012
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE
A dispatch packet on the queue requires too many registers.
Definition: amd-dbgapi.h:3058
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID
A dispatch packet on the queue has a NULL code address.
Definition: amd-dbgapi.h:3046
@ AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION
A wave on the queue had a memory violation.
Definition: amd-dbgapi.h:3022
@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID
A dispatch packet on the queue has an invalid dimension.
Definition: amd-dbgapi.h:3038
@ AMD_DBGAPI_EXCEPTION_WAVE_ADDRESS_ERROR
A wave on the queue had an exception due to accessing an invalid memory address.
Definition: amd-dbgapi.h:3029
@ AMD_DBGAPI_EXCEPTION_NONE
If none of the bits are set, then the queue is not in the error state.
Definition: amd-dbgapi.h:2982
@ AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED
A packet on the queue has an invalid vendor code.
Definition: amd-dbgapi.h:3062
@ AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE
Return the architecture of this queue.
Definition: amd-dbgapi.h:2871
@ AMD_DBGAPI_QUEUE_INFO_PROCESS
Return the process to which this queue belongs.
Definition: amd-dbgapi.h:2866
@ AMD_DBGAPI_QUEUE_INFO_TYPE
Return the queue type.
Definition: amd-dbgapi.h:2876
@ AMD_DBGAPI_QUEUE_INFO_ADDRESS
Return the base address of the memory holding the queue packets.
Definition: amd-dbgapi.h:2893
@ AMD_DBGAPI_QUEUE_INFO_STATE
Return the queue state.
Definition: amd-dbgapi.h:2881
@ AMD_DBGAPI_QUEUE_INFO_AGENT
Return the agent to which this queue belongs.
Definition: amd-dbgapi.h:2861
@ AMD_DBGAPI_QUEUE_INFO_SIZE
Return the size in bytes of the memory holding the queue packets.
Definition: amd-dbgapi.h:2898
@ 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:2888
@ AMD_DBGAPI_QUEUE_INFO_OS_ID
Native operating system queue ID.
Definition: amd-dbgapi.h:2903
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:5339
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_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_76
Write 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_register_info_t
Register queries that are supported by amd_dbgapi_register_get_info.
Definition: amd-dbgapi.h:5373
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:5210
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:5519
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:5706
@ 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:5363
@ AMD_DBGAPI_REGISTER_PROPERTY_NONE
There are no properties.
Definition: amd-dbgapi.h:5343
@ AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS
At least one bit of the register value is readonly.
Definition: amd-dbgapi.h:5349
@ 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:5356
@ AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE
Return the architecture to which this register belongs.
Definition: amd-dbgapi.h:5378
@ AMD_DBGAPI_REGISTER_INFO_NAME
Return the register name.
Definition: amd-dbgapi.h:5385
@ AMD_DBGAPI_REGISTER_INFO_SIZE
Return the size of the register in bytes.
Definition: amd-dbgapi.h:5390
@ AMD_DBGAPI_REGISTER_INFO_PROPERTIES
Return the register's properties.
Definition: amd-dbgapi.h:5465
@ AMD_DBGAPI_REGISTER_INFO_DWARF
Return the AMD GPU DWARF register number for the register's architecture.
Definition: amd-dbgapi.h:5460
@ AMD_DBGAPI_REGISTER_INFO_TYPE
Return the register type as a C style type string.
Definition: amd-dbgapi.h:5451
@ AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE
Return the architecture to which this register class belongs.
Definition: amd-dbgapi.h:5215
@ AMD_DBGAPI_REGISTER_CLASS_INFO_NAME
Return the register class name.
Definition: amd-dbgapi.h:5222
@ AMD_DBGAPI_REGISTER_ABSENT
The wave does not have the register.
Definition: amd-dbgapi.h:5523
@ AMD_DBGAPI_REGISTER_PRESENT
The wave has the register.
Definition: amd-dbgapi.h:5527
@ AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER
The register is not a member of the register class.
Definition: amd-dbgapi.h:5710
@ AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER
The register is a member of the register class.
Definition: amd-dbgapi.h:5714
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:865
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID
The register class handle is invalid.
Definition: amd-dbgapi.h:1036
@ AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID
The lane handle is invalid.
Definition: amd-dbgapi.h:1044
@ AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID
The breakpoint handle is invalid.
Definition: amd-dbgapi.h:1068
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID
The code object handle is invalid.
Definition: amd-dbgapi.h:961
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_ALREADY_FROZEN
The process is already frozen.
Definition: amd-dbgapi.h:1101
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID
The workgroup handle is invalid.
Definition: amd-dbgapi.h:1089
@ AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE
No more watchpoints available.
Definition: amd-dbgapi.h:1032
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_FROZEN
This operation is not allowed when the process is frozen.
Definition: amd-dbgapi.h:1097
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID
The wave handle is invalid.
Definition: amd-dbgapi.h:990
@ AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS
An error occurred while trying to access memory in the inferior.
Definition: amd-dbgapi.h:1056
@ AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION
The bytes being disassembled are not a legal instruction.
Definition: amd-dbgapi.h:957
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_NOT_FROZEN
This operation is not allowed when the process is not frozen.
Definition: amd-dbgapi.h:1105
@ AMD_DBGAPI_STATUS_SUCCESS
The function has executed successfully.
Definition: amd-dbgapi.h:869
@ AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED
The operation is not supported.
Definition: amd-dbgapi.h:909
@ AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE
The wave has an active displaced stepping buffer.
Definition: amd-dbgapi.h:1019
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED
The library is already initialized.
Definition: amd-dbgapi.h:921
@ 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:1015
@ AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP
The wave has an outstanding stop request.
Definition: amd-dbgapi.h:1002
@ AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID
The agent handle is invalid.
Definition: amd-dbgapi.h:978
@ AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED
The library is not initialized.
Definition: amd-dbgapi.h:925
@ AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND
The symbol was not found.
Definition: amd-dbgapi.h:1080
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY
An invalid combination of arguments was given to the function.
Definition: amd-dbgapi.h:917
@ AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID
The watchpoint handle is invalid.
Definition: amd-dbgapi.h:1028
@ 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:1024
@ AMD_DBGAPI_STATUS_ERROR_INCOMPATIBLE_PROCESS_STATE
The current process state is not compatible with the requested operation.
Definition: amd-dbgapi.h:1093
@ AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED
The native operating system process associated with a client process has exited.
Definition: amd-dbgapi.h:974
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID
The client process handle is invalid.
Definition: amd-dbgapi.h:1076
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID
The architecture handle is invalid.
Definition: amd-dbgapi.h:953
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT
An invalid argument was given to the function.
Definition: amd-dbgapi.h:913
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID
The address class handle is invalid.
Definition: amd-dbgapi.h:1048
@ AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID
The event handle is invalid.
Definition: amd-dbgapi.h:1064
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED
The wave is not stopped.
Definition: amd-dbgapi.h:994
@ AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED
The wave is stopped.
Definition: amd-dbgapi.h:998
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID
The address space handle is invalid.
Definition: amd-dbgapi.h:1052
@ AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID
The process handle is invalid.
Definition: amd-dbgapi.h:969
@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE
The wave cannot be resumed.
Definition: amd-dbgapi.h:1006
@ AMD_DBGAPI_STATUS_ERROR_MEMORY_UNAVAILABLE
The requested memory location is valid but currently unreachable.
Definition: amd-dbgapi.h:1109
@ AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED
The operation is not currently implemented.
Definition: amd-dbgapi.h:901
@ AMD_DBGAPI_STATUS_ERROR_RESTRICTION
There is a restriction error that prevents the operation to complete.
Definition: amd-dbgapi.h:945
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION
The segment address cannot be converted to the requested address space.
Definition: amd-dbgapi.h:1060
@ AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE
The ELF AMD GPU machine value is invalid or unsupported.
Definition: amd-dbgapi.h:965
@ AMD_DBGAPI_STATUS_FATAL
A fatal error has occurred.
Definition: amd-dbgapi.h:895
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID
The displaced stepping handle is invalid.
Definition: amd-dbgapi.h:1010
@ AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK
A callback to the client reported an error.
Definition: amd-dbgapi.h:1072
@ AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE
The requested information is not available.
Definition: amd-dbgapi.h:905
@ AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED
The process is already attached to the given inferior process.
Definition: amd-dbgapi.h:949
@ AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID
The queue handle is invalid.
Definition: amd-dbgapi.h:982
@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID
The register handle is invalid.
Definition: amd-dbgapi.h:1040
@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID
The dispatch handle is invalid.
Definition: amd-dbgapi.h:986
@ 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:1085
@ AMD_DBGAPI_STATUS_ERROR
A generic error has occurred.
Definition: amd-dbgapi.h:873
@ AMD_DBGAPI_STATUS_ERROR_INVALID_CLUSTER_ID
The cluster handle is invalid.
Definition: amd-dbgapi.h:1113
#define AMD_DBGAPI_VERSION_0_58
The function was introduced in version 0.58 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:611
#define AMD_DBGAPI_VERSION_0_56
The function was introduced in version 0.56 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:605
#define AMD_DBGAPI_VERSION_0_67
The function was introduced in version 0.67 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:629
#define AMD_DBGAPI_VERSION_0_62
The function was introduced in version 0.62 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:617
#define AMD_DBGAPI_VERSION_0_82
The function was introduced in version 0.82 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:683
#define AMD_DBGAPI_VERSION_0_81
The function was introduced in version 0.81 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:677
#define AMD_DBGAPI_VERSION_0_80
The function was introduced in version 0.80 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:671
#define AMD_DBGAPI_VERSION_0_54
The function was introduced in version 0.54 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:599
#define AMD_DBGAPI_VERSION_0_76
The function was introduced in version 0.76 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:647
#define AMD_DBGAPI_VERSION_0_64
The function was introduced in version 0.64 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:623
#define AMD_DBGAPI_VERSION_0_77
The function was introduced in version 0.77 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:653
#define AMD_DBGAPI_VERSION_0_70
The function was introduced in version 0.70 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:641
#define AMD_DBGAPI_VERSION_0_78
The function was introduced in version 0.78 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:659
#define AMD_DBGAPI_VERSION_0_68
The function was introduced in version 0.68 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:635
#define AMD_DBGAPI_VERSION_0_79
The function was introduced in version 0.79 of the interface and has the symbol version string of "@A...
Definition: amd-dbgapi.h:665
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_watchpoint_info_t
Watchpoint queries that are supported by amd_dbgapi_watchpoint_get_info.
Definition: amd-dbgapi.h:4942
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint(amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_76
Remove a hardware data watchpoint previously set by amd_dbgapi_set_watchpoint.
amd_dbgapi_watchpoint_kind_t
Watchpoint memory access kinds.
Definition: amd-dbgapi.h:5036
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_76
Set a hardware data 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:5010
@ AMD_DBGAPI_WATCHPOINT_INFO_PROCESS
Return the process to which this watchpoint belongs.
Definition: amd-dbgapi.h:4947
@ AMD_DBGAPI_WATCHPOINT_INFO_SIZE
The byte size of the created watchpoint.
Definition: amd-dbgapi.h:4957
@ AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS
The base address of the created watchpoint.
Definition: amd-dbgapi.h:4952
@ AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW
Write access by store instructions or read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:5045
@ AMD_DBGAPI_WATCHPOINT_KIND_ALL
Read, write, or read-modify-write access by load, store, or atomic instructions.
Definition: amd-dbgapi.h:5054
@ AMD_DBGAPI_WATCHPOINT_KIND_LOAD
Read access by load instructions.
Definition: amd-dbgapi.h:5040
@ AMD_DBGAPI_WATCHPOINT_KIND_RMW
Read-modify-write access by atomic instructions.
Definition: amd-dbgapi.h:5049
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED
The watchpoints are not shared across processes.
Definition: amd-dbgapi.h:5020
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED
The watchpoints of a process are shared between all processes.
Definition: amd-dbgapi.h:5026
@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED
Watchpoints are not supported.
Definition: amd-dbgapi.h:5014
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_76
Resume execution of a stopped wave.
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_82
Query information about a wave.
amd_dbgapi_wave_state_t
The execution state of a wave.
Definition: amd-dbgapi.h:4038
amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_stop(amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_76
Request a wave to stop executing.
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:4402
amd_dbgapi_wave_stop_reasons_t
A bit mask of the reasons that a wave stopped.
Definition: amd-dbgapi.h:4070
amd_dbgapi_wave_info_t
Wave queries that are supported by amd_dbgapi_wave_get_info.
Definition: amd-dbgapi.h:3845
@ AMD_DBGAPI_WAVE_STATE_STOP
The wave is stopped.
Definition: amd-dbgapi.h:4060
@ AMD_DBGAPI_WAVE_STATE_SINGLE_STEP
The wave is running in single-step mode.
Definition: amd-dbgapi.h:4047
@ AMD_DBGAPI_WAVE_STATE_RUN
The wave is running.
Definition: amd-dbgapi.h:4042
@ AMD_DBGAPI_RESUME_MODE_SINGLE_STEP
Resume execution in in single step mode.
Definition: amd-dbgapi.h:4410
@ AMD_DBGAPI_RESUME_MODE_NORMAL
Resume normal execution.
Definition: amd-dbgapi.h:4406
@ 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:4113
@ AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT
The wave stopped due to triggering a data watchpoint.
Definition: amd-dbgapi.h:4093
@ AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION
The wave stopped due to a memory violation.
Definition: amd-dbgapi.h:4210
@ AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP
The wave stopped due to completing an instruction single-step.
Definition: amd-dbgapi.h:4097
@ AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION
The wave stopped due to executing an illegal instruction.
Definition: amd-dbgapi.h:4239
@ AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP
The wave stopped due to executing a debug trap instruction.
Definition: amd-dbgapi.h:4168
@ 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:4105
@ AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR
The wave stopped due to detecting an unrecoverable ECC error.
Definition: amd-dbgapi.h:4252
@ AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT
The wave stopped after causing a hardware fatal halt.
Definition: amd-dbgapi.h:4259
@ AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP
The wave stopped due to executing an assert trap instruction.
Definition: amd-dbgapi.h:4184
@ 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:4075
@ AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT
The wave stopped due to executing a breakpoint instruction.
Definition: amd-dbgapi.h:4081
@ 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:4145
@ AMD_DBGAPI_WAVE_STOP_REASON_ADDRESS_ERROR
The wave stopped due to an aperture violation.
Definition: amd-dbgapi.h:4225
@ 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:4194
@ 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:4153
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW
The wave stopped due to triggering an enabled floating point underflow exception.
Definition: amd-dbgapi.h:4129
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT
The wave stopped due to triggering an enabled floating point inexact exception.
Definition: amd-dbgapi.h:4137
@ AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW
The wave stopped due to triggering an enabled floating point overflow exception.
Definition: amd-dbgapi.h:4121
@ AMD_DBGAPI_WAVE_INFO_ARCHITECTURE
Return the architecture of this wave.
Definition: amd-dbgapi.h:3910
@ AMD_DBGAPI_WAVE_INFO_DISPATCH
Return the dispatch to which this wave belongs.
Definition: amd-dbgapi.h:3890
@ AMD_DBGAPI_WAVE_INFO_QUEUE
Return the queue to which this wave belongs.
Definition: amd-dbgapi.h:3895
@ AMD_DBGAPI_WAVE_INFO_CLUSTER
Return the cluster this wave's workgroup belongs to.
Definition: amd-dbgapi.h:3957
@ AMD_DBGAPI_WAVE_INFO_EXEC_MASK
Return the current execution mask of the wave.
Definition: amd-dbgapi.h:3924
@ AMD_DBGAPI_WAVE_INFO_WORKGROUP
Return the workgroup to which this wave belongs.
Definition: amd-dbgapi.h:3880
@ AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD_IN_CLUSTER
The wave's workgroup's coordinate within the cluster of the workgroup.
Definition: amd-dbgapi.h:3981
@ AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP
The wave's number in the workgroup.
Definition: amd-dbgapi.h:3947
@ AMD_DBGAPI_WAVE_INFO_STATE
Return the wave's state.
Definition: amd-dbgapi.h:3850
@ AMD_DBGAPI_WAVE_INFO_PROCESS
Return the process to which this wave belongs.
Definition: amd-dbgapi.h:3905
@ AMD_DBGAPI_WAVE_INFO_CLUSTER_COORD
The wave's workgroup's cluster coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3969
@ AMD_DBGAPI_WAVE_INFO_AGENT
Return the agent to which this wave belongs.
Definition: amd-dbgapi.h:3900
@ AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD
The wave workgroup coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3935
@ AMD_DBGAPI_WAVE_INFO_WATCHPOINTS
Return the watchpoint(s) the wave triggered.
Definition: amd-dbgapi.h:3870
@ AMD_DBGAPI_WAVE_INFO_LANE_COUNT
The number of lanes supported by the wave.
Definition: amd-dbgapi.h:3952
@ AMD_DBGAPI_WAVE_INFO_PC
Return the current program counter value of the wave.
Definition: amd-dbgapi.h:3916
@ AMD_DBGAPI_WAVE_INFO_STOP_REASON
Return the reason the wave stopped as a bit set.
Definition: amd-dbgapi.h:3857
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_workgroup_info_t
Workgroup queries that are supported by amd_dbgapi_workgroup_get_info.
Definition: amd-dbgapi.h:3651
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_82
Query information about a workgroup.
@ AMD_DBGAPI_WORKGROUP_INFO_QUEUE
Return the queue to which this workgroup belongs.
Definition: amd-dbgapi.h:3666
@ AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE
Return the architecture of this workgroup.
Definition: amd-dbgapi.h:3681
@ AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD
The workgroup workgroup coordinate in the dispatch grid dimensions.
Definition: amd-dbgapi.h:3692
@ AMD_DBGAPI_WORKGROUP_INFO_CLUSTER
Return the cluster this workgroup belongs to.
Definition: amd-dbgapi.h:3697
@ AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD_IN_CLUSTER
The workgroup coordinate within the cluster of the workgroup.
Definition: amd-dbgapi.h:3708
@ AMD_DBGAPI_WORKGROUP_INFO_DISPATCH
Return the dispatch to which this workgroup belongs.
Definition: amd-dbgapi.h:3661
@ AMD_DBGAPI_WORKGROUP_INFO_PROCESS
Return the process to which this workgroup belongs.
Definition: amd-dbgapi.h:3676
@ AMD_DBGAPI_WORKGROUP_INFO_AGENT
Return the agent to which this workgroup belongs.
Definition: amd-dbgapi.h:3671
Opaque source language address class handle.
Definition: amd-dbgapi.h:6020
uint64_t handle
Definition: amd-dbgapi.h:6021
Opaque address space handle.
Definition: amd-dbgapi.h:6205
uint64_t handle
Definition: amd-dbgapi.h:6206
Opaque agent handle.
Definition: amd-dbgapi.h:2605
uint64_t handle
Definition: amd-dbgapi.h:2606
Opaque architecture handle.
Definition: amd-dbgapi.h:1291
uint64_t handle
Definition: amd-dbgapi.h:1292
Opaque breakpoint handle.
Definition: amd-dbgapi.h:7569
uint64_t handle
Definition: amd-dbgapi.h:7570
Callbacks that the client of the library must provide.
Definition: amd-dbgapi.h:7743
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:7885
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:7850
void(* deallocate_memory)(void *data)
Deallocate memory that was allocated by amd_dbgapi_callbacks_s::allocate_memory.
Definition: amd-dbgapi.h:7774
amd_dbgapi_status_t(* client_process_get_info)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_client_process_info_t query, size_t value_size, void *value)
Query information about the client process.
Definition: amd-dbgapi.h:7810
amd_dbgapi_status_t(* xfer_global_memory)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_global_address_t global_address, amd_dbgapi_size_t *value_size, void *read_buffer, const void *write_buffer)
Uncached global memory transfer.
Definition: amd-dbgapi.h:7925
void(* log_message)(amd_dbgapi_log_level_t level, const char *message)
Report a log message.
Definition: amd-dbgapi.h:7939
Opaque cluster handle.
Definition: amd-dbgapi.h:3519
uint64_t handle
Definition: amd-dbgapi.h:3520
Opaque code object handle.
Definition: amd-dbgapi.h:2404
uint64_t handle
Definition: amd-dbgapi.h:2405
AMDGPU corefile state data for a process.
Definition: amd-dbgapi.h:1852
size_t size
Size, in bytes, of the buffer pointed by amd_dbgapi_core_state_data_t::data.
Definition: amd-dbgapi.h:1858
amd_dbgapi_endianness_t endianness
Endianness encoding of the core state.
Definition: amd-dbgapi.h:1854
const void * data
Pointer to the buffer containing the core state data.
Definition: amd-dbgapi.h:1866
Instruction information for direct call instructions.
Definition: amd-dbgapi.h:5955
amd_dbgapi_global_address_t target_address
Definition: amd-dbgapi.h:5956
Opaque dispatch handle.
Definition: amd-dbgapi.h:3219
uint64_t handle
Definition: amd-dbgapi.h:3220
Opaque displaced stepping handle.
Definition: amd-dbgapi.h:4673
uint64_t handle
Definition: amd-dbgapi.h:4674
Opaque event handle.
Definition: amd-dbgapi.h:7168
uint64_t handle
Definition: amd-dbgapi.h:7169
Opaque process handle.
Definition: amd-dbgapi.h:1826
uint64_t handle
Definition: amd-dbgapi.h:1827
Opaque queue handle.
Definition: amd-dbgapi.h:2839
uint64_t handle
Definition: amd-dbgapi.h:2840
Opaque register class handle.
Definition: amd-dbgapi.h:5192
uint64_t handle
Definition: amd-dbgapi.h:5193
Opaque register handle.
Definition: amd-dbgapi.h:5322
uint64_t handle
Definition: amd-dbgapi.h:5323
Opaque hardware data watchpoint handle.
Definition: amd-dbgapi.h:4925
uint64_t handle
Definition: amd-dbgapi.h:4926
A set of watchpoints.
Definition: amd-dbgapi.h:5064
amd_dbgapi_watchpoint_id_t * watchpoint_ids
Definition: amd-dbgapi.h:5066
size_t count
Definition: amd-dbgapi.h:5065
Opaque wave handle.
Definition: amd-dbgapi.h:3828
uint64_t handle
Definition: amd-dbgapi.h:3829
Opaque workgroup handle.
Definition: amd-dbgapi.h:3634
uint64_t handle
Definition: amd-dbgapi.h:3635