amd-dbgapi.h Source File

• include

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 

467 #ifndef AMD_DBGAPI_H

468 #define AMD_DBGAPI_H 1

469 

470 /* Placeholder for calling convention and import/export macros */

471 #if !defined(AMD_DBGAPI_CALL)

472 #define AMD_DBGAPI_CALL

473 #endif /* !defined (AMD_DBGAPI_CALL) */

474 

475 #if !defined(AMD_DBGAPI_EXPORT_DECORATOR)

476 #if defined(__GNUC__)

477 #define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default")))

478 #elif defined(_MSC_VER)

479 #define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)

480 #endif /* defined (_MSC_VER) */

481 #endif /* !defined (AMD_DBGAPI_EXPORT_DECORATOR) */

482 

483 #if !defined(AMD_DBGAPI_IMPORT_DECORATOR)

484 #if defined(__GNUC__)

485 #define AMD_DBGAPI_IMPORT_DECORATOR

486 #elif defined(_MSC_VER)

487 #define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)

488 #endif /* defined (_MSC_VER) */

489 #endif /* !defined (AMD_DBGAPI_IMPORT_DECORATOR) */

490 

491 #define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL

492 #define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL

493 

494 #if !defined(AMD_DBGAPI)

495 #if defined(AMD_DBGAPI_EXPORTS)

496 #define AMD_DBGAPI AMD_DBGAPI_EXPORT

497 #else /* !defined (AMD_DBGAPI_EXPORTS) */

498 #define AMD_DBGAPI AMD_DBGAPI_IMPORT

499 #endif /* !defined (AMD_DBGAPI_EXPORTS) */

500 #endif /* !defined (AMD_DBGAPI) */

501 

502 #if __cplusplus >= 201103L

503 /* c++11 allows extended initializer lists. */

504 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) (type{ value })

505 #elif __STDC_VERSION__ >= 199901L

506 /* c99 allows compound literals. */

507 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) ((type){ value })

508 #else /* !__STDC_VERSION__ >= 199901L */

509 #define AMD_DBGAPI_HANDLE_LITERAL(type, value) {value}

510 #endif /* !__STDC_VERSION__ >= 199901L */

511 

512 #if defined(__cplusplus) && __cplusplus >= 201402L

513 #define DEPRECATED [[deprecated]]

514 #else

515 #define DEPRECATED

516 #endif

517 

518 #if defined(__cplusplus)

519 extern "C" {

520 #endif /* defined (__cplusplus) */

521 

522 #if defined(__linux__)

523 #include <sys/types.h>

524 #endif /* __linux__ */

525 

526 #include <stddef.h>

527 #include <stdint.h>

528 

548 #define AMD_DBGAPI_VERSION_0_54

549 

554 #define AMD_DBGAPI_VERSION_0_56

555 

560 #define AMD_DBGAPI_VERSION_0_58

561 

566 #define AMD_DBGAPI_VERSION_0_62

567 

572 #define AMD_DBGAPI_VERSION_0_64

573 

578 #define AMD_DBGAPI_VERSION_0_67

579 

584 #define AMD_DBGAPI_VERSION_0_68

585 

590 #define AMD_DBGAPI_VERSION_0_70

591 

596 #define AMD_DBGAPI_VERSION_0_76

597 

602 #define AMD_DBGAPI_VERSION_0_77

603 

610 typedef struct amd_dbgapi_callbacks_s amd_dbgapi_callbacks_t;

611 

634 typedef uint64_t amd_dbgapi_global_address_t;

635 

639 typedef uint64_t amd_dbgapi_size_t;

640 

644 typedef enum

645 {

649  AMD_DBGAPI_CHANGED_NO = 0,

653  AMD_DBGAPI_CHANGED_YES = 1

654 } amd_dbgapi_changed_t;

655 

663 #if defined(__linux__)

664 typedef pid_t amd_dbgapi_os_process_id_t;

665 #endif /* __linux__ */

666 

691 #if defined(__linux__)

692 typedef int amd_dbgapi_notifier_t;

693 #endif /* __linux__ */

694 

702 #if defined(__linux__)

703 typedef uint64_t amd_dbgapi_os_agent_id_t;

704 #endif /* __linux__ */

705 

712 #if defined(__linux__)

713 typedef uint64_t amd_dbgapi_os_queue_id_t;

714 #endif /* __linux__ */

715 

724 #if defined(__linux__)

725 typedef uint64_t amd_dbgapi_os_queue_packet_id_t;

726 #endif /* __linux__ */

727 

735 #if defined(__linux__)

736 typedef enum

737 {

741  AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN = 0,

745  AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL = 1,

749  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4 = 257,

753  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA = 513,

757  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI = 514

758 } amd_dbgapi_os_queue_type_t;

759 #endif /* __linux__ */

760 

773 typedef enum

774 {

778  AMD_DBGAPI_STATUS_SUCCESS = 0,

782  AMD_DBGAPI_STATUS_ERROR = -1,

804  AMD_DBGAPI_STATUS_FATAL = -2,

810  AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED = -3,

814  AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE = -4,

818  AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED = -5,

822  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT = -6,

826  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY = -7,

830  AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED = -8,

834  AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED = -9,

854  AMD_DBGAPI_STATUS_ERROR_RESTRICTION = -10,

858  AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED = -11,

862  AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID = -12,

866  AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION = -13,

870  AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID = -14,

874  AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE = -15,

878  AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID = -16,

883  AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED = -17,

887  AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID = -18,

891  AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID = -19,

895  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID = -20,

899  AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID = -21,

903  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED = -22,

907  AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED = -23,

911  AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP = -24,

915  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE = -25,

919  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID = -26,

924  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_NOT_AVAILABLE = -27,

928  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE = -28,

933  AMD_DBGAPI_STATUS_ERROR_RESUME_DISPLACED_STEPPING = -29,

937  AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID = -30,

941  AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE = -31,

945  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID = -32,

949  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID = -33,

953  AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID = -34,

957  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID = -35,

961  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID = -36,

965  AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS = -37,

969  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION = -38,

973  AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID = -39,

977  AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID = -40,

981  AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK = -41,

985  AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID = -42,

989  AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND = -43,

994  AMD_DBGAPI_STATUS_ERROR_REGISTER_NOT_AVAILABLE = -44,

998  AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID = -45,

1002  AMD_DBGAPI_STATUS_ERROR_INCOMPATIBLE_PROCESS_STATE = -46,

1006  AMD_DBGAPI_STATUS_ERROR_PROCESS_FROZEN = -47,

1010  AMD_DBGAPI_STATUS_ERROR_PROCESS_ALREADY_FROZEN = -48,

1014  AMD_DBGAPI_STATUS_ERROR_PROCESS_NOT_FROZEN = -49,

1015 } amd_dbgapi_status_t;

1016 

1033 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_status_string (

1034  amd_dbgapi_status_t status,

1035  const char **status_string) AMD_DBGAPI_VERSION_0_54;

1036 

1060 #define AMD_DBGAPI_VERSION_MAJOR @PROJECT_VERSION_MAJOR@

1061 

1066 #define AMD_DBGAPI_VERSION_MINOR @PROJECT_VERSION_MINOR@

1067 

1081 void AMD_DBGAPI amd_dbgapi_get_version (

1082  uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_54;

1083 

1092 const char AMD_DBGAPI *

1093 amd_dbgapi_get_build_name (void) AMD_DBGAPI_VERSION_0_54;

1094 

1140 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize (

1141  amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_76;

1142 

1167 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize (void)

1168  AMD_DBGAPI_VERSION_0_54;

1169 

1191 typedef struct

1192 {

1193  uint64_t handle;

1194 } amd_dbgapi_architecture_id_t;

1195 

1199 #define AMD_DBGAPI_ARCHITECTURE_NONE \

1200  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_architecture_id_t, 0)

1201 

1209 typedef enum

1210 {

1217  AMD_DBGAPI_ARCHITECTURE_INFO_NAME = 1,

1225  AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE = 2,

1230  AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE = 3,

1236  AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT = 4,

1241  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE = 5,

1249  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION = 6,

1255  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_PC_ADJUST = 7,

1260  AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER = 8

1261 } amd_dbgapi_architecture_info_t;

1262 

1301 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_get_info (

1302  amd_dbgapi_architecture_id_t architecture_id,

1303  amd_dbgapi_architecture_info_t query, size_t value_size,

1304  void *value) AMD_DBGAPI_VERSION_0_54;

1305 

1334 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_architecture (

1335  uint32_t elf_amdgpu_machine,

1336  amd_dbgapi_architecture_id_t *architecture_id) AMD_DBGAPI_VERSION_0_54;

1337 

1344 typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;

1345 

1439 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_disassemble_instruction (

1440  amd_dbgapi_architecture_id_t architecture_id,

1441  amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,

1442  const void *memory, char **instruction_text,

1443  amd_dbgapi_symbolizer_id_t symbolizer_id,

1444  amd_dbgapi_status_t (*symbolizer) (

1445  amd_dbgapi_symbolizer_id_t symbolizer_id,

1446  amd_dbgapi_global_address_t address,

1447  char **symbol_text)) AMD_DBGAPI_VERSION_0_54;

1448 

1452 typedef enum

1453 {

1458  AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN = 0,

1464  AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL = 1,

1470  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH = 2,

1477  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL = 3,

1485  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_REGISTER_PAIR = 4,

1495  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_CONDITIONAL_REGISTER_PAIR = 5,

1506  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_CALL_REGISTER_PAIR = 6,

1516  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_CALL_REGISTER_PAIRS = 7,

1521  AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE = 8,

1535  AMD_DBGAPI_INSTRUCTION_KIND_TRAP = 9,

1540  AMD_DBGAPI_INSTRUCTION_KIND_HALT = 10,

1547  AMD_DBGAPI_INSTRUCTION_KIND_BARRIER = 11,

1553  AMD_DBGAPI_INSTRUCTION_KIND_SLEEP = 12,

1562  AMD_DBGAPI_INSTRUCTION_KIND_SPECIAL = 13

1563 } amd_dbgapi_instruction_kind_t;

1564 

1568 typedef enum

1569 {

1573  AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE = 0

1574 } amd_dbgapi_instruction_properties_t;

1575 

1650 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_classify_instruction (

1651  amd_dbgapi_architecture_id_t architecture_id,

1652  amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,

1653  const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind,

1654  amd_dbgapi_instruction_properties_t *instruction_properties,

1655  void **instruction_information) AMD_DBGAPI_VERSION_0_58;

1656 

1678 typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;

1679 

1690 typedef struct

1691 {

1692  uint64_t handle;

1693 } amd_dbgapi_process_id_t;

1694 

1698 #define AMD_DBGAPI_PROCESS_NONE \

1699  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_process_id_t, 0)

1700 

1704 typedef enum

1705 {

1707  AMD_DBGAPI_ENDIAN_BIG = 0,

1708 

1710  AMD_DBGAPI_ENDIAN_LITTLE = 1

1711 } amd_dbgapi_endianness_t;

1712 

1716 typedef struct

1717 {

1719  amd_dbgapi_endianness_t endianness;

1723  size_t size;

1731  const void *data;

1732 } amd_dbgapi_core_state_data_t;

1733 

1740 typedef enum

1741 {

1746  AMD_DBGAPI_PROCESS_INFO_NOTIFIER = 1,

1752  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT = 2,

1758  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE = 3,

1764  AMD_DBGAPI_PROCESS_INFO_PRECISE_MEMORY_SUPPORTED = 4,

1771  AMD_DBGAPI_PROCESS_INFO_PRECISE_ALU_EXCEPTIONS_SUPPORTED = 5,

1785  AMD_DBGAPI_PROCESS_INFO_OS_ID = 6,

1795  AMD_DBGAPI_PROCESS_INFO_CORE_STATE = 7,

1796 } amd_dbgapi_process_info_t;

1797 

1847 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_get_info (

1848  amd_dbgapi_process_id_t process_id, amd_dbgapi_process_info_t query,

1849  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_77;

1850 

1947 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_attach (

1948  amd_dbgapi_client_process_id_t client_process_id,

1949  amd_dbgapi_process_id_t *process_id) AMD_DBGAPI_VERSION_0_56;

1950 

1997 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_detach (

1998  amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_54;

1999 

2014 typedef enum

2015 {

2021  AMD_DBGAPI_PROGRESS_NORMAL = 0,

2045  AMD_DBGAPI_PROGRESS_NO_FORWARD = 1

2046 } amd_dbgapi_progress_t;

2047 

2076 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_progress (

2077  amd_dbgapi_process_id_t process_id,

2078  amd_dbgapi_progress_t progress) AMD_DBGAPI_VERSION_0_76;

2079 

2091 typedef enum

2092 {

2096  AMD_DBGAPI_WAVE_CREATION_NORMAL = 0,

2100  AMD_DBGAPI_WAVE_CREATION_STOP = 1

2101 } amd_dbgapi_wave_creation_t;

2102 

2131 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_wave_creation (

2132  amd_dbgapi_process_id_t process_id,

2133  amd_dbgapi_wave_creation_t creation) AMD_DBGAPI_VERSION_0_76;

2134 

2203 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_freeze (

2204  amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_76;

2205 

2230 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_unfreeze (

2231  amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_76;

2232 

2260 typedef struct

2261 {

2262  uint64_t handle;

2263 } amd_dbgapi_code_object_id_t;

2264 

2268 #define AMD_DBGAPI_CODE_OBJECT_NONE \

2269  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_code_object_id_t, 0)

2270 

2277 typedef enum

2278 {

2283  AMD_DBGAPI_CODE_OBJECT_INFO_PROCESS = 1,

2339  AMD_DBGAPI_CODE_OBJECT_INFO_URI_NAME = 2,

2345  AMD_DBGAPI_CODE_OBJECT_INFO_LOAD_ADDRESS = 3

2346 } amd_dbgapi_code_object_info_t;

2347 

2386 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_code_object_get_info (

2387  amd_dbgapi_code_object_id_t code_object_id,

2388  amd_dbgapi_code_object_info_t query, size_t value_size,

2389  void *value) AMD_DBGAPI_VERSION_0_54;

2390 

2440 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_code_object_list (

2441  amd_dbgapi_process_id_t process_id, size_t *code_object_count,

2442  amd_dbgapi_code_object_id_t **code_objects,

2443  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2444 

2461 typedef struct

2462 {

2463  uint64_t handle;

2464 } amd_dbgapi_agent_id_t;

2465 

2469 #define AMD_DBGAPI_AGENT_NONE \

2470  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_agent_id_t, 0)

2471 

2478 typedef enum

2479 {

2484  AMD_DBGAPI_AGENT_INFO_PROCESS = 1,

2490  AMD_DBGAPI_AGENT_INFO_NAME = 2,

2500  AMD_DBGAPI_AGENT_INFO_ARCHITECTURE = 3,

2505  AMD_DBGAPI_AGENT_INFO_STATE = 4,

2509  AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN = 5,

2515  AMD_DBGAPI_AGENT_INFO_PCI_SLOT = 6,

2519  AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID = 7,

2523  AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID = 8,

2528  AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT = 9,

2533  AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT = 10,

2538  AMD_DBGAPI_AGENT_INFO_OS_ID = 11

2539 } amd_dbgapi_agent_info_t;

2540 

2544 typedef enum

2545 {

2549  AMD_DBGAPI_AGENT_STATE_SUPPORTED = 1,

2572  AMD_DBGAPI_AGENT_STATE_NOT_SUPPORTED = 2

2573 } amd_dbgapi_agent_state_t;

2574 

2617 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_agent_get_info (

2618  amd_dbgapi_agent_id_t agent_id, amd_dbgapi_agent_info_t query,

2619  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_67;

2620 

2672 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_agent_list (

2673  amd_dbgapi_process_id_t process_id, size_t *agent_count,

2674  amd_dbgapi_agent_id_t **agents,

2675  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2676 

2695 typedef struct

2696 {

2697  uint64_t handle;

2698 } amd_dbgapi_queue_id_t;

2699 

2703 #define AMD_DBGAPI_QUEUE_NONE \

2704  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_queue_id_t, 0)

2705 

2712 typedef enum

2713 {

2718  AMD_DBGAPI_QUEUE_INFO_AGENT = 1,

2723  AMD_DBGAPI_QUEUE_INFO_PROCESS = 2,

2728  AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE = 3,

2733  AMD_DBGAPI_QUEUE_INFO_TYPE = 4,

2738  AMD_DBGAPI_QUEUE_INFO_STATE = 5,

2745  AMD_DBGAPI_QUEUE_INFO_ERROR_REASON = 6,

2750  AMD_DBGAPI_QUEUE_INFO_ADDRESS = 7,

2755  AMD_DBGAPI_QUEUE_INFO_SIZE = 8,

2760  AMD_DBGAPI_QUEUE_INFO_OS_ID = 9

2761 } amd_dbgapi_queue_info_t;

2762 

2801 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_get_info (

2802  amd_dbgapi_queue_id_t queue_id, amd_dbgapi_queue_info_t query,

2803  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_68;

2804 

2808 typedef enum

2809 {

2813  AMD_DBGAPI_QUEUE_STATE_VALID = 1,

2827  AMD_DBGAPI_QUEUE_STATE_ERROR = 2

2828 } amd_dbgapi_queue_state_t;

2829 

2834 typedef enum

2835 {

2839  AMD_DBGAPI_EXCEPTION_NONE = 0,

2843  AMD_DBGAPI_EXCEPTION_WAVE_ABORT = (1 << 0),

2853  AMD_DBGAPI_EXCEPTION_WAVE_TRAP = (1 << 1),

2869  AMD_DBGAPI_EXCEPTION_WAVE_MATH_ERROR = (1 << 2),

2873  AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION = (1 << 3),

2879  AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION = (1 << 4),

2886  AMD_DBGAPI_EXCEPTION_WAVE_ADDRESS_ERROR = (1 << 5),

2890  AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION DEPRECATED

2891  = AMD_DBGAPI_EXCEPTION_WAVE_ADDRESS_ERROR,

2895  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID = (1 << 16),

2899  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_GROUP_SEGMENT_SIZE_INVALID = (1 << 17),

2903  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID = (1 << 18),

2907  AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED = (1 << 20),

2911  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID = (1 << 21),

2915  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE = (1 << 22),

2919  AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED = (1 << 23),

2928  AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR = (1 << 31)

2929 } amd_dbgapi_exceptions_t;

2930 

2983 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_queue_list (

2984  amd_dbgapi_process_id_t process_id, size_t *queue_count,

2985  amd_dbgapi_queue_id_t **queues,

2986  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2987 

3051 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_packet_list (

3052  amd_dbgapi_queue_id_t queue_id,

3053  amd_dbgapi_os_queue_packet_id_t *read_packet_id,

3054  amd_dbgapi_os_queue_packet_id_t *write_packet_id,

3055  size_t *packets_byte_size, void **packets_bytes) AMD_DBGAPI_VERSION_0_54;

3056 

3075 typedef struct

3076 {

3077  uint64_t handle;

3078 } amd_dbgapi_dispatch_id_t;

3079 

3083 #define AMD_DBGAPI_DISPATCH_NONE \

3084  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_dispatch_id_t, 0)

3085 

3092 typedef enum

3093 {

3098  AMD_DBGAPI_DISPATCH_INFO_QUEUE = 1,

3103  AMD_DBGAPI_DISPATCH_INFO_AGENT = 2,

3108  AMD_DBGAPI_DISPATCH_INFO_PROCESS = 3,

3113  AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE = 4,

3119  AMD_DBGAPI_DISPATCH_INFO_OS_QUEUE_PACKET_ID = 5,

3124  AMD_DBGAPI_DISPATCH_INFO_BARRIER = 6,

3129  AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE = 7,

3134  AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE = 8,

3139  AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS = 9,

3144  AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES = 10,

3149  AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES = 11,

3154  AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE = 12,

3159  AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE = 13,

3164  AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS = 14,

3169  AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS = 15,

3174  AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS = 16,

3184  AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS = 17

3185 } amd_dbgapi_dispatch_info_t;

3186 

3228 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dispatch_get_info (

3229  amd_dbgapi_dispatch_id_t dispatch_id, amd_dbgapi_dispatch_info_t query,

3230  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;

3231 

3238 typedef enum

3239 {

3243  AMD_DBGAPI_DISPATCH_BARRIER_NONE = 0,

3248  AMD_DBGAPI_DISPATCH_BARRIER_PRESENT = 1

3249 } amd_dbgapi_dispatch_barrier_t;

3250 

3257 typedef enum

3258 {

3262  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE = 0,

3266  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT = 1,

3270  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM = 2

3271 } amd_dbgapi_dispatch_fence_scope_t;

3272 

3321 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_dispatch_list (

3322  amd_dbgapi_process_id_t process_id, size_t *dispatch_count,

3323  amd_dbgapi_dispatch_id_t **dispatches,

3324  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

3325 

3342 typedef struct

3343 {

3344  uint64_t handle;

3345 } amd_dbgapi_workgroup_id_t;

3346 

3350 #define AMD_DBGAPI_WORKGROUP_NONE \

3351  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_workgroup_id_t, 0)

3352 

3359 typedef enum

3360 {

3370  AMD_DBGAPI_WORKGROUP_INFO_DISPATCH = 1,

3375  AMD_DBGAPI_WORKGROUP_INFO_QUEUE = 2,

3380  AMD_DBGAPI_WORKGROUP_INFO_AGENT = 3,

3385  AMD_DBGAPI_WORKGROUP_INFO_PROCESS = 4,

3390  AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE = 5,

3401  AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD = 6

3402 } amd_dbgapi_workgroup_info_t;

3403 

3446 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_workgroup_get_info (

3447  amd_dbgapi_workgroup_id_t workgroup_id, amd_dbgapi_workgroup_info_t query,

3448  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;

3449 

3499 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_workgroup_list (

3500  amd_dbgapi_process_id_t process_id, size_t *workgroup_count,

3501  amd_dbgapi_workgroup_id_t **workgroups,

3502  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_64;

3503 

3520 typedef struct

3521 {

3522  uint64_t handle;

3523 } amd_dbgapi_wave_id_t;

3524 

3528 #define AMD_DBGAPI_WAVE_NONE \

3529  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_wave_id_t, 0)

3530 

3537 typedef enum

3538 {

3543  AMD_DBGAPI_WAVE_INFO_STATE = 1,

3550  AMD_DBGAPI_WAVE_INFO_STOP_REASON = 2,

3563  AMD_DBGAPI_WAVE_INFO_WATCHPOINTS = 3,

3573  AMD_DBGAPI_WAVE_INFO_WORKGROUP = 4,

3583  AMD_DBGAPI_WAVE_INFO_DISPATCH = 5,

3588  AMD_DBGAPI_WAVE_INFO_QUEUE = 6,

3593  AMD_DBGAPI_WAVE_INFO_AGENT = 7,

3598  AMD_DBGAPI_WAVE_INFO_PROCESS = 8,

3603  AMD_DBGAPI_WAVE_INFO_ARCHITECTURE = 9,

3609  AMD_DBGAPI_WAVE_INFO_PC = 10,

3617  AMD_DBGAPI_WAVE_INFO_EXEC_MASK = 11,

3628  AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD = 12,

3640  AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP = 13,

3645  AMD_DBGAPI_WAVE_INFO_LANE_COUNT = 14

3646 } amd_dbgapi_wave_info_t;

3647 

3694 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_get_info (

3695  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_wave_info_t query,

3696  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;

3697 

3701 typedef enum

3702 {

3706  AMD_DBGAPI_WAVE_STATE_RUN = 1,

3711  AMD_DBGAPI_WAVE_STATE_SINGLE_STEP = 2,

3724  AMD_DBGAPI_WAVE_STATE_STOP = 3

3725 } amd_dbgapi_wave_state_t;

3726 

3733 typedef enum

3734 {

3739  AMD_DBGAPI_WAVE_STOP_REASON_NONE = 0,

3745  AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT = (1 << 0),

3757  AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT = (1 << 1),

3761  AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP = (1 << 2),

3769  AMD_DBGAPI_WAVE_STOP_REASON_FP_INPUT_DENORMAL = (1 << 3),

3777  AMD_DBGAPI_WAVE_STOP_REASON_FP_DIVIDE_BY_0 = (1 << 4),

3785  AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW = (1 << 5),

3793  AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW = (1 << 6),

3801  AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT = (1 << 7),

3809  AMD_DBGAPI_WAVE_STOP_REASON_FP_INVALID_OPERATION = (1 << 8),

3817  AMD_DBGAPI_WAVE_STOP_REASON_INT_DIVIDE_BY_0 = (1 << 9),

3832  AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP = (1 << 10),

3848  AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP = (1 << 11),

3858  AMD_DBGAPI_WAVE_STOP_REASON_TRAP = (1 << 12),

3874  AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION = (1 << 13),

3889  AMD_DBGAPI_WAVE_STOP_REASON_ADDRESS_ERROR = (1 << 14),

3893  AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION DEPRECATED

3894  = AMD_DBGAPI_WAVE_STOP_REASON_ADDRESS_ERROR,

3903  AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION = (1 << 15),

3916  AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR = (1 << 16),

3923  AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT = (1 << 17)

3924 } amd_dbgapi_wave_stop_reasons_t;

3925 

3973 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_wave_list (

3974  amd_dbgapi_process_id_t process_id, size_t *wave_count,

3975  amd_dbgapi_wave_id_t **waves,

3976  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

3977 

4059 amd_dbgapi_status_t AMD_DBGAPI

4060 amd_dbgapi_wave_stop (amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_76;

4061 

4065 typedef enum

4066 {

4070  AMD_DBGAPI_RESUME_MODE_NORMAL = 0,

4074  AMD_DBGAPI_RESUME_MODE_SINGLE_STEP = 1

4075 } amd_dbgapi_resume_mode_t;

4076 

4231 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_resume (

4232  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_resume_mode_t resume_mode,

4233  amd_dbgapi_exceptions_t exceptions) AMD_DBGAPI_VERSION_0_76;

4234 

4336 typedef struct

4337 {

4338  uint64_t handle;

4339 } amd_dbgapi_displaced_stepping_id_t;

4340 

4344 #define AMD_DBGAPI_DISPLACED_STEPPING_NONE \

4345  (amd_dbgapi_displaced_stepping_id_t{ 0 })

4346 

4354 typedef enum

4355 {

4360  AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS = 1

4361 } amd_dbgapi_displaced_stepping_info_t;

4362 

4402 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_get_info (

4403  amd_dbgapi_displaced_stepping_id_t displaced_stepping_id,

4404  amd_dbgapi_displaced_stepping_info_t query, size_t value_size,

4405  void *value) AMD_DBGAPI_VERSION_0_54;

4406 

4492 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_start (

4493  amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes,

4494  amd_dbgapi_displaced_stepping_id_t *displaced_stepping)

4495  AMD_DBGAPI_VERSION_0_76;

4496 

4550 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_complete (

4551  amd_dbgapi_wave_id_t wave_id,

4552  amd_dbgapi_displaced_stepping_id_t displaced_stepping)

4553  AMD_DBGAPI_VERSION_0_76;

4554 

4588 typedef struct

4589 {

4590  uint64_t handle;

4591 } amd_dbgapi_watchpoint_id_t;

4592 

4596 #define AMD_DBGAPI_WATCHPOINT_NONE \

4597  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_watchpoint_id_t, 0)

4598 

4605 typedef enum

4606 {

4611  AMD_DBGAPI_WATCHPOINT_INFO_PROCESS = 1,

4616  AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS = 2,

4621  AMD_DBGAPI_WATCHPOINT_INFO_SIZE = 3

4622 } amd_dbgapi_watchpoint_info_t;

4623 

4662 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_watchpoint_get_info (

4663  amd_dbgapi_watchpoint_id_t watchpoint_id,

4664  amd_dbgapi_watchpoint_info_t query, size_t value_size,

4665  void *value) AMD_DBGAPI_VERSION_0_54;

4666 

4673 typedef enum

4674 {

4678  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED = 0,

4684  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED = 1,

4690  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED = 2

4691 } amd_dbgapi_watchpoint_share_kind_t;

4692 

4699 typedef enum

4700 {

4704  AMD_DBGAPI_WATCHPOINT_KIND_LOAD = 1,

4709  AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW = 2,

4713  AMD_DBGAPI_WATCHPOINT_KIND_RMW = 3,

4718  AMD_DBGAPI_WATCHPOINT_KIND_ALL = 4

4719 } amd_dbgapi_watchpoint_kind_t;

4720 

4727 typedef struct

4728 {

4729  size_t count;

4730  amd_dbgapi_watchpoint_id_t *watchpoint_ids;

4731 } amd_dbgapi_watchpoint_list_t;

4732 

4804 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_watchpoint (

4805  amd_dbgapi_process_id_t process_id, amd_dbgapi_global_address_t address,

4806  amd_dbgapi_size_t size, amd_dbgapi_watchpoint_kind_t kind,

4807  amd_dbgapi_watchpoint_id_t *watchpoint_id) AMD_DBGAPI_VERSION_0_76;

4808 

4831 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint (

4832  amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_76;

4833 

4855 typedef struct

4856 {

4857  uint64_t handle;

4858 } amd_dbgapi_register_class_id_t;

4859 

4863 #define AMD_DBGAPI_REGISTER_CLASS_NONE \

4864  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_class_id_t, 0)

4865 

4873 typedef enum

4874 {

4879  AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE = 1,

4886  AMD_DBGAPI_REGISTER_CLASS_INFO_NAME = 2

4887 } amd_dbgapi_register_class_info_t;

4888 

4927 amd_dbgapi_status_t AMD_DBGAPI

4928 amd_dbgapi_architecture_register_class_get_info (

4929  amd_dbgapi_register_class_id_t register_class_id,

4930  amd_dbgapi_register_class_info_t query, size_t value_size,

4931  void *value) AMD_DBGAPI_VERSION_0_54;

4932 

4973 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_class_list (

4974  amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count,

4975  amd_dbgapi_register_class_id_t **register_classes) AMD_DBGAPI_VERSION_0_54;

4976 

4985 typedef struct

4986 {

4987  uint64_t handle;

4988 } amd_dbgapi_register_id_t;

4989 

4993 #define AMD_DBGAPI_REGISTER_NONE \

4994  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_id_t, 0)

4995 

5002 typedef enum

5003 {

5007  AMD_DBGAPI_REGISTER_PROPERTY_NONE = 0,

5013  AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS = (1 << 0),

5020  AMD_DBGAPI_REGISTER_PROPERTY_VOLATILE = (1 << 1),

5027  AMD_DBGAPI_REGISTER_PROPERTY_INVALIDATE_VOLATILE = (1 << 2)

5028 } amd_dbgapi_register_properties_t;

5029 

5036 typedef enum

5037 {

5042  AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE = 1,

5049  AMD_DBGAPI_REGISTER_INFO_NAME = 2,

5054  AMD_DBGAPI_REGISTER_INFO_SIZE = 3,

5115  AMD_DBGAPI_REGISTER_INFO_TYPE = 4,

5124  AMD_DBGAPI_REGISTER_INFO_DWARF = 5,

5129  AMD_DBGAPI_REGISTER_INFO_PROPERTIES = 6

5130 } amd_dbgapi_register_info_t;

5131 

5175 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_get_info (

5176  amd_dbgapi_register_id_t register_id, amd_dbgapi_register_info_t query,

5177  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_70;

5178 

5182 typedef enum

5183 {

5187  AMD_DBGAPI_REGISTER_ABSENT = 0,

5191  AMD_DBGAPI_REGISTER_PRESENT = 1

5192 } amd_dbgapi_register_exists_t;

5193 

5227 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_exists (

5228  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5229  amd_dbgapi_register_exists_t *exists) AMD_DBGAPI_VERSION_0_54;

5230 

5275 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_list (

5276  amd_dbgapi_architecture_id_t architecture_id, size_t *register_count,

5277  amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54;

5278 

5322 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_list (

5323  amd_dbgapi_wave_id_t wave_id, size_t *register_count,

5324  amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54;

5325 

5362 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dwarf_register_to_register (

5363  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register,

5364  amd_dbgapi_register_id_t *register_id) AMD_DBGAPI_VERSION_0_54;

5365 

5369 typedef enum

5370 {

5374  AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER = 0,

5378  AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER = 1

5379 } amd_dbgapi_register_class_state_t;

5380 

5418 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_is_in_register_class (

5419  amd_dbgapi_register_class_id_t register_class_id,

5420  amd_dbgapi_register_id_t register_id,

5421  amd_dbgapi_register_class_state_t *register_class_state)

5422  AMD_DBGAPI_VERSION_0_54;

5423 

5480 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_register (

5481  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5482  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,

5483  void *value) AMD_DBGAPI_VERSION_0_62;

5484 

5549 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_register (

5550  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5551  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,

5552  const void *value) AMD_DBGAPI_VERSION_0_76;

5553 

5607 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_prefetch_register (

5608  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5609  amd_dbgapi_size_t register_count) AMD_DBGAPI_VERSION_0_62;

5610 

5618 typedef struct

5619 {

5620  amd_dbgapi_global_address_t target_address;

5621  amd_dbgapi_register_id_t saved_return_address_register[2];

5622 } amd_dbgapi_direct_call_register_pair_information_t;

5623 

5663 typedef uint32_t amd_dbgapi_lane_id_t;

5664 

5668 #define AMD_DBGAPI_LANE_NONE ((amd_dbgapi_lane_id_t) (-1))

5669 

5683 typedef struct

5684 {

5685  uint64_t handle;

5686 } amd_dbgapi_address_class_id_t;

5687 

5691 #define AMD_DBGAPI_ADDRESS_CLASS_NONE \

5692  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_class_id_t, 0)

5693 

5701 typedef enum

5702 {

5709  AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME = 1,

5718  AMD_DBGAPI_ADDRESS_CLASS_INFO_ADDRESS_SPACE = 2,

5723  AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF = 3

5724 } amd_dbgapi_address_class_info_t;

5725 

5765 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_class_get_info (

5766  amd_dbgapi_address_class_id_t address_class_id,

5767  amd_dbgapi_address_class_info_t query, size_t value_size,

5768  void *value) AMD_DBGAPI_VERSION_0_62;

5769 

5811 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_class_list (

5812  amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count,

5813  amd_dbgapi_address_class_id_t **address_classes) AMD_DBGAPI_VERSION_0_54;

5814 

5852 amd_dbgapi_status_t AMD_DBGAPI

5853 amd_dbgapi_dwarf_address_class_to_address_class (

5854  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class,

5855  amd_dbgapi_address_class_id_t *address_class_id) AMD_DBGAPI_VERSION_0_54;

5856 

5868 typedef struct

5869 {

5870  uint64_t handle;

5871 } amd_dbgapi_address_space_id_t;

5872 

5876 #define AMD_DBGAPI_ADDRESS_SPACE_NONE \

5877  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 0)

5878 

5885 #define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL \

5886  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 1)

5887 

5891 typedef enum

5892 {

5897  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL = 1,

5902  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT = 2,

5907  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT = 3

5908 } amd_dbgapi_address_space_access_t;

5909 

5917 typedef enum

5918 {

5925  AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME = 1,

5930  AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE = 2,

5935  AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS = 3,

5940  AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS = 4,

5945  AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF = 5

5946 } amd_dbgapi_address_space_info_t;

5947 

5986 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_space_get_info (

5987  amd_dbgapi_address_space_id_t address_space_id,

5988  amd_dbgapi_address_space_info_t query, size_t value_size,

5989  void *value) AMD_DBGAPI_VERSION_0_62;

5990 

6029 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_space_list (

6030  amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count,

6031  amd_dbgapi_address_space_id_t **address_spaces) AMD_DBGAPI_VERSION_0_54;

6032 

6071 amd_dbgapi_status_t AMD_DBGAPI

6072 amd_dbgapi_dwarf_address_space_to_address_space (

6073  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space,

6074  amd_dbgapi_address_space_id_t *address_space_id) AMD_DBGAPI_VERSION_0_54;

6075 

6092 typedef uint64_t amd_dbgapi_segment_address_t;

6093 

6208 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_convert_address_space (

6209  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id,

6210  amd_dbgapi_address_space_id_t source_address_space_id,

6211  amd_dbgapi_segment_address_t source_segment_address,

6212  amd_dbgapi_address_space_id_t destination_address_space_id,

6213  amd_dbgapi_segment_address_t *destination_segment_address,

6214  amd_dbgapi_size_t *destination_contiguous_bytes)

6215  AMD_DBGAPI_VERSION_0_62;

6216 

6222 typedef enum

6223 {

6227  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE = 0,

6231  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE = 1,

6235  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE = 2,

6239  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP = 3,

6243  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT = 4,

6247  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS = 5

6248 } amd_dbgapi_segment_address_dependency_t;

6249 

6288 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_dependency (

6289  amd_dbgapi_address_space_id_t address_space_id,

6290  amd_dbgapi_segment_address_t segment_address,

6291  amd_dbgapi_segment_address_dependency_t *segment_address_dependency)

6292  AMD_DBGAPI_VERSION_0_64;

6293 

6298 typedef enum

6299 {

6304  AMD_DBGAPI_ADDRESS_CLASS_STATE_NOT_MEMBER = 0,

6309  AMD_DBGAPI_ADDRESS_CLASS_STATE_MEMBER = 1

6310 } amd_dbgapi_address_class_state_t;

6311 

6383 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_is_in_address_class (

6384  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id,

6385  amd_dbgapi_address_space_id_t address_space_id,

6386  amd_dbgapi_segment_address_t segment_address,

6387  amd_dbgapi_address_class_id_t address_class_id,

6388  amd_dbgapi_address_class_state_t *address_class_state)

6389  AMD_DBGAPI_VERSION_0_54;

6390 

6489 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_memory (

6490  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,

6491  amd_dbgapi_lane_id_t lane_id,

6492  amd_dbgapi_address_space_id_t address_space_id,

6493  amd_dbgapi_segment_address_t segment_address,

6494  amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_54;

6495 

6598 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_memory (

6599  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,

6600  amd_dbgapi_lane_id_t lane_id,

6601  amd_dbgapi_address_space_id_t address_space_id,

6602  amd_dbgapi_segment_address_t segment_address,

6603  amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_76;

6604 

6623 typedef enum

6624 {

6629  AMD_DBGAPI_MEMORY_PRECISION_NONE = 0,

6634  AMD_DBGAPI_MEMORY_PRECISION_PRECISE = 1

6635 } amd_dbgapi_memory_precision_t;

6636 

6675 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_memory_precision (

6676  amd_dbgapi_process_id_t process_id,

6677  amd_dbgapi_memory_precision_t memory_precision) AMD_DBGAPI_VERSION_0_54;

6678 

6697 typedef enum

6698 {

6703  AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_NONE = 0,

6709  AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_PRECISE = 1

6710 } amd_dbgapi_alu_exceptions_precision_t;

6711 

6751 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_alu_exceptions_precision (

6752  amd_dbgapi_process_id_t process_id,

6753  amd_dbgapi_alu_exceptions_precision_t alu_exceptions_precision)

6754  AMD_DBGAPI_VERSION_0_77;

6755 

6787 typedef struct

6788 {

6789  uint64_t handle;

6790 } amd_dbgapi_event_id_t;

6791 

6795 #define AMD_DBGAPI_EVENT_NONE \

6796  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_event_id_t, 0)

6797 

6801 typedef enum

6802 {

6806  AMD_DBGAPI_EVENT_KIND_NONE = 0,

6810  AMD_DBGAPI_EVENT_KIND_WAVE_STOP = 1,

6825  AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED = 2,

6847  AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED = 3,

6860  AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME = 4,

6875  AMD_DBGAPI_EVENT_KIND_RUNTIME = 5,

6909  AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR = 6

6910 } amd_dbgapi_event_kind_t;

6911 

6947 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_next_pending_event (

6948  amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id,

6949  amd_dbgapi_event_kind_t *kind) AMD_DBGAPI_VERSION_0_54;

6950 

6954 typedef enum

6955 {

6960  AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS = 1,

6964  AMD_DBGAPI_RUNTIME_STATE_UNLOADED = 2,

6970  AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION = 3

6971 } amd_dbgapi_runtime_state_t;

6972 

6979 typedef enum

6980 {

6985  AMD_DBGAPI_EVENT_INFO_PROCESS = 1,

6990  AMD_DBGAPI_EVENT_INFO_KIND = 2,

6996  AMD_DBGAPI_EVENT_INFO_WAVE = 3,

7001  AMD_DBGAPI_EVENT_INFO_BREAKPOINT = 4,

7006  AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD = 5,

7013  AMD_DBGAPI_EVENT_INFO_RUNTIME_STATE = 6,

7018  AMD_DBGAPI_EVENT_INFO_QUEUE = 7

7019 } amd_dbgapi_event_info_t;

7020 

7060 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_get_info (

7061  amd_dbgapi_event_id_t event_id, amd_dbgapi_event_info_t query,

7062  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;

7063 

7089 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_processed (

7090  amd_dbgapi_event_id_t event_id) AMD_DBGAPI_VERSION_0_54;

7091 

7113 typedef enum

7114 {

7118  AMD_DBGAPI_LOG_LEVEL_NONE = 0,

7123  AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR = 1,

7127  AMD_DBGAPI_LOG_LEVEL_WARNING = 2,

7131  AMD_DBGAPI_LOG_LEVEL_INFO = 3,

7135  AMD_DBGAPI_LOG_LEVEL_TRACE = 4,

7139  AMD_DBGAPI_LOG_LEVEL_VERBOSE = 5

7140 } amd_dbgapi_log_level_t;

7141 

7160 void AMD_DBGAPI amd_dbgapi_set_log_level (amd_dbgapi_log_level_t level)

7161  AMD_DBGAPI_VERSION_0_54;

7162 

7188 typedef struct

7189 {

7190  uint64_t handle;

7191 } amd_dbgapi_breakpoint_id_t;

7192 

7196 #define AMD_DBGAPI_BREAKPOINT_NONE \

7197  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_breakpoint_id_t, 0)

7198 

7205 typedef enum

7206 {

7211  AMD_DBGAPI_BREAKPOINT_INFO_PROCESS = 1

7212 } amd_dbgapi_breakpoint_info_t;

7213 

7252 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_breakpoint_get_info (

7253  amd_dbgapi_breakpoint_id_t breakpoint_id,

7254  amd_dbgapi_breakpoint_info_t query, size_t value_size,

7255  void *value) AMD_DBGAPI_VERSION_0_54;

7256 

7260 typedef enum

7261 {

7265  AMD_DBGAPI_BREAKPOINT_ACTION_RESUME = 1,

7269  AMD_DBGAPI_BREAKPOINT_ACTION_HALT = 2

7270 } amd_dbgapi_breakpoint_action_t;

7271 

7281 typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;

7282 

7320 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_report_breakpoint_hit (

7321  amd_dbgapi_breakpoint_id_t breakpoint_id,

7322  amd_dbgapi_client_thread_id_t client_thread_id,

7323  amd_dbgapi_breakpoint_action_t *breakpoint_action) AMD_DBGAPI_VERSION_0_54;

7324 

7331 typedef enum

7332 {

7343  AMD_DBGAPI_CLIENT_PROCESS_INFO_OS_PID = 1,

7353  AMD_DBGAPI_CLIENT_PROCESS_INFO_CORE_STATE = 2,

7354 } amd_dbgapi_client_process_info_t;

7355 

7362 struct amd_dbgapi_callbacks_s

7363 {

7364 

7376  void *(*allocate_memory) (size_t byte_size);

7377 

7394  void (*deallocate_memory) (void *data);

7395 

7430  amd_dbgapi_status_t (*client_process_get_info) (

7431  amd_dbgapi_client_process_id_t client_process_id,

7432  amd_dbgapi_client_process_info_t query,

7433  size_t value_size, void *value);

7434 

7470  amd_dbgapi_status_t (*insert_breakpoint) (

7471  amd_dbgapi_client_process_id_t client_process_id,

7472  amd_dbgapi_global_address_t address,

7473  amd_dbgapi_breakpoint_id_t breakpoint_id);

7474 

7505  amd_dbgapi_status_t (*remove_breakpoint) (

7506  amd_dbgapi_client_process_id_t client_process_id,

7507  amd_dbgapi_breakpoint_id_t breakpoint_id);

7508 

7545  amd_dbgapi_status_t (*xfer_global_memory) (

7546  amd_dbgapi_client_process_id_t client_process_id,

7547  amd_dbgapi_global_address_t global_address,

7548  amd_dbgapi_size_t *value_size, void *read_buffer,

7549  const void *write_buffer);

7550 

7559  void (*log_message) (amd_dbgapi_log_level_t level, const char *message);

7560 };

7561 

7564 #if defined(__cplusplus)

7565 } /* extern "C" */

7566 #endif /* defined (__cplusplus) */

7567 

7568 #endif /* amd-dbgapi.h */

AMD_DBGAPI

#define AMD_DBGAPI

Definition: amd-dbgapi.h:498

DEPRECATED

#define DEPRECATED

Old deprecated name kept for backward compatibility.

Definition: amd-dbgapi.h:515

amd_dbgapi_agent_state_t

amd_dbgapi_agent_state_t

Agent state.

Definition: amd-dbgapi.h:2545

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:2479

amd_dbgapi_agent_get_info

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_process_agent_list

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

@ AMD_DBGAPI_AGENT_STATE_NOT_SUPPORTED

Agent does not support debugging.

Definition: amd-dbgapi.h:2572

AMD_DBGAPI_AGENT_STATE_SUPPORTED

@ AMD_DBGAPI_AGENT_STATE_SUPPORTED

Agent supports debugging.

Definition: amd-dbgapi.h:2549

AMD_DBGAPI_AGENT_INFO_STATE

@ AMD_DBGAPI_AGENT_INFO_STATE

Return the agent state.

Definition: amd-dbgapi.h:2505

AMD_DBGAPI_AGENT_INFO_OS_ID

@ AMD_DBGAPI_AGENT_INFO_OS_ID

Native operating system agent ID.

Definition: amd-dbgapi.h:2538

AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID

@ AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID

PCI device ID of the agent.

Definition: amd-dbgapi.h:2523

AMD_DBGAPI_AGENT_INFO_PROCESS

@ AMD_DBGAPI_AGENT_INFO_PROCESS

Return the process to which this agent belongs.

Definition: amd-dbgapi.h:2484

AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID

@ AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID

PCI vendor ID of the agent.

Definition: amd-dbgapi.h:2519

AMD_DBGAPI_AGENT_INFO_NAME

@ AMD_DBGAPI_AGENT_INFO_NAME

Agent name.

Definition: amd-dbgapi.h:2490

AMD_DBGAPI_AGENT_INFO_ARCHITECTURE

@ AMD_DBGAPI_AGENT_INFO_ARCHITECTURE

Return the architecture of this agent.

Definition: amd-dbgapi.h:2500

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:2528

AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN

@ AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN

PCI domain the agent is in.

Definition: amd-dbgapi.h:2509

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:2515

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:2533

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:1210

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_54

Disassemble a single instruction.

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, amd_dbgapi_instruction_properties_t *instruction_properties, void **instruction_information) AMD_DBGAPI_VERSION_0_58

Classify a single instruction.

amd_dbgapi_symbolizer_id_t

struct amd_dbgapi_symbolizer_id_s * amd_dbgapi_symbolizer_id_t

Opaque client symbolizer handle.

Definition: amd-dbgapi.h:1344

amd_dbgapi_instruction_kind_t

amd_dbgapi_instruction_kind_t

The kinds of instruction classifications.

Definition: amd-dbgapi.h:1453

amd_dbgapi_instruction_properties_t

amd_dbgapi_instruction_properties_t

A bit mask of the properties of an instruction.

Definition: amd-dbgapi.h:1569

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_54

Query information about an architecture.

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_54

Get an architecture from the AMD GPU ELF EF_AMDGPU_MACH value corresponding to the architecture.

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:1225

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:1236

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:1241

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:1260

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:1255

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:1230

AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION

@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION

Return the breakpoint instruction for the architecture.

Definition: amd-dbgapi.h:1249

AMD_DBGAPI_ARCHITECTURE_INFO_NAME

@ AMD_DBGAPI_ARCHITECTURE_INFO_NAME

Return the architecture name.

Definition: amd-dbgapi.h:1217

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:1547

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:1516

AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL

@ AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL

The instruction executes sequentially.

Definition: amd-dbgapi.h:1464

AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_CONDITIONAL_REGISTER_PAIR

@ 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:1495

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:1562

AMD_DBGAPI_INSTRUCTION_KIND_HALT

@ AMD_DBGAPI_INSTRUCTION_KIND_HALT

The instruction unconditionally halts the wave.

Definition: amd-dbgapi.h:1540

AMD_DBGAPI_INSTRUCTION_KIND_TRAP

@ AMD_DBGAPI_INSTRUCTION_KIND_TRAP

The instruction enters the trap handler.

Definition: amd-dbgapi.h:1535

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:1506

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:1485

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:1477

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:1553

AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE

@ AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE

The instruction terminates the wave execution.

Definition: amd-dbgapi.h:1521

AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN

@ AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN

The instruction classification is unknown.

Definition: amd-dbgapi.h:1458

AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH

@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH

The instruction unconditionally branches to a literal address.

Definition: amd-dbgapi.h:1470

AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE

@ AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE

The instruction has no properties.

Definition: amd-dbgapi.h:1573

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:639

amd_dbgapi_os_queue_id_t

uint64_t amd_dbgapi_os_queue_id_t

Native operating system queue ID.

Definition: amd-dbgapi.h:713

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:634

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:725

amd_dbgapi_os_agent_id_t

uint64_t amd_dbgapi_os_agent_id_t

Native operating system agent ID.

Definition: amd-dbgapi.h:703

amd_dbgapi_os_queue_type_t

amd_dbgapi_os_queue_type_t

Native operating system queue type.

Definition: amd-dbgapi.h:737

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:692

amd_dbgapi_os_process_id_t

pid_t amd_dbgapi_os_process_id_t

Native operating system process ID.

Definition: amd-dbgapi.h:664

amd_dbgapi_changed_t

amd_dbgapi_changed_t

Indication of if a value has changed.

Definition: amd-dbgapi.h:645

AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN

@ AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN

Unknown queue type.

Definition: amd-dbgapi.h:741

AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA

@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA

Queue supports the AMD SDMA protocol.

Definition: amd-dbgapi.h:753

AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4

@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4

Queue supports the AMD PM4 protocol.

Definition: amd-dbgapi.h:749

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:757

AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL

@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL

Queue supports the HSA AQL protocol.

Definition: amd-dbgapi.h:745

AMD_DBGAPI_CHANGED_YES

@ AMD_DBGAPI_CHANGED_YES

The value has changed.

Definition: amd-dbgapi.h:653

AMD_DBGAPI_CHANGED_NO

@ AMD_DBGAPI_CHANGED_NO

The value has not changed.

Definition: amd-dbgapi.h:649

amd_dbgapi_breakpoint_info_t

amd_dbgapi_breakpoint_info_t

Breakpoint queries that are supported by amd_dbgapi_breakpoint_get_info.

Definition: amd-dbgapi.h:7206

amd_dbgapi_client_process_info_t

amd_dbgapi_client_process_info_t

Client queries that are supported by the client_process_get_info callback.

Definition: amd-dbgapi.h:7332

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:7261

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:7281

amd_dbgapi_breakpoint_get_info

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_report_breakpoint_hit

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

@ AMD_DBGAPI_BREAKPOINT_INFO_PROCESS

Return the process to which this breakpoint belongs.

Definition: amd-dbgapi.h:7211

AMD_DBGAPI_CLIENT_PROCESS_INFO_CORE_STATE

@ 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:7353

AMD_DBGAPI_CLIENT_PROCESS_INFO_OS_PID

@ AMD_DBGAPI_CLIENT_PROCESS_INFO_OS_PID

Return the native operating system process handle.

Definition: amd-dbgapi.h:7343

AMD_DBGAPI_BREAKPOINT_ACTION_RESUME

@ AMD_DBGAPI_BREAKPOINT_ACTION_RESUME

Resume execution.

Definition: amd-dbgapi.h:7265

AMD_DBGAPI_BREAKPOINT_ACTION_HALT

@ AMD_DBGAPI_BREAKPOINT_ACTION_HALT

Leave execution halted.

Definition: amd-dbgapi.h:7269

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:2278

amd_dbgapi_code_object_get_info

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_process_code_object_list

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

@ AMD_DBGAPI_CODE_OBJECT_INFO_PROCESS

Return the process to which this code object belongs.

Definition: amd-dbgapi.h:2283

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:2339

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:2345

amd_dbgapi_process_unfreeze

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_process_freeze

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

amd_dbgapi_dispatch_info_t

Dispatch queries that are supported by amd_dbgapi_dispatch_get_info.

Definition: amd-dbgapi.h:3093

amd_dbgapi_process_dispatch_list

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_dispatch_get_info

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dispatch_get_info(amd_dbgapi_dispatch_id_t dispatch_id, amd_dbgapi_dispatch_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54

Query information about a dispatch.

amd_dbgapi_dispatch_barrier_t

amd_dbgapi_dispatch_barrier_t

Dispatch barrier.

Definition: amd-dbgapi.h:3239

amd_dbgapi_dispatch_fence_scope_t

amd_dbgapi_dispatch_fence_scope_t

Dispatch memory fence scope.

Definition: amd-dbgapi.h:3258

AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE

@ AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE

Return the dispatch acquire fence.

Definition: amd-dbgapi.h:3129

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:3164

AMD_DBGAPI_DISPATCH_INFO_QUEUE

@ AMD_DBGAPI_DISPATCH_INFO_QUEUE

Return the queue to which this dispatch belongs.

Definition: amd-dbgapi.h:3098

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:3159

AMD_DBGAPI_DISPATCH_INFO_AGENT

@ AMD_DBGAPI_DISPATCH_INFO_AGENT

Return the agent to which this dispatch belongs.

Definition: amd-dbgapi.h:3103

AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS

@ AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS

Return the dispatch grid dimensionality.

Definition: amd-dbgapi.h:3139

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:3119

AMD_DBGAPI_DISPATCH_INFO_PROCESS

@ AMD_DBGAPI_DISPATCH_INFO_PROCESS

Return the process to which this dispatch belongs.

Definition: amd-dbgapi.h:3108

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:3149

AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE

@ AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE

Return the dispatch release fence.

Definition: amd-dbgapi.h:3134

AMD_DBGAPI_DISPATCH_INFO_BARRIER

@ AMD_DBGAPI_DISPATCH_INFO_BARRIER

Return the dispatch barrier setting.

Definition: amd-dbgapi.h:3124

AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE

@ AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE

Return the architecture of this dispatch.

Definition: amd-dbgapi.h:3113

AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS

@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS

Return the dispatch kernel descriptor address.

Definition: amd-dbgapi.h:3169

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:3154

AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES

@ AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES

Return the dispatch workgroup size (work-items) in the X, Y, and Z dimensions.

Definition: amd-dbgapi.h:3144

AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS

@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS

Return the dispatch completion event address.

Definition: amd-dbgapi.h:3184

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:3174

AMD_DBGAPI_DISPATCH_BARRIER_NONE

@ AMD_DBGAPI_DISPATCH_BARRIER_NONE

Dispatch has no barrier.

Definition: amd-dbgapi.h:3243

AMD_DBGAPI_DISPATCH_BARRIER_PRESENT

@ AMD_DBGAPI_DISPATCH_BARRIER_PRESENT

Dispatch has a barrier.

Definition: amd-dbgapi.h:3248

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE

There is no fence.

Definition: amd-dbgapi.h:3262

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT

There is a fence with agent memory scope.

Definition: amd-dbgapi.h:3266

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM

There is a fence with system memory scope.

Definition: amd-dbgapi.h:3270

amd_dbgapi_displaced_stepping_info_t

amd_dbgapi_displaced_stepping_info_t

Displaced stepping queries that are supported by amd_dbgapi_displaced_stepping_id_t.

Definition: amd-dbgapi.h:4355

amd_dbgapi_displaced_stepping_get_info

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_displaced_stepping_complete

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_displaced_stepping_start

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

@ AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS

Return the process to which this displaced stepping buffer belongs.

Definition: amd-dbgapi.h:4360

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:6980

amd_dbgapi_runtime_state_t

amd_dbgapi_runtime_state_t

Inferior's runtime state.

Definition: amd-dbgapi.h:6955

amd_dbgapi_event_processed

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_event_get_info

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

amd_dbgapi_event_kind_t

The event kinds.

Definition: amd-dbgapi.h:6802

amd_dbgapi_process_next_pending_event

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

@ AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD

Return the client thread of a AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME event.

Definition: amd-dbgapi.h:7006

AMD_DBGAPI_EVENT_INFO_KIND

@ AMD_DBGAPI_EVENT_INFO_KIND

Return the event kind.

Definition: amd-dbgapi.h:6990

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:7013

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:7001

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:6996

AMD_DBGAPI_EVENT_INFO_PROCESS

@ AMD_DBGAPI_EVENT_INFO_PROCESS

Return the process to which this event belongs.

Definition: amd-dbgapi.h:6985

AMD_DBGAPI_EVENT_INFO_QUEUE

@ AMD_DBGAPI_EVENT_INFO_QUEUE

Return the queue of a AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR event.

Definition: amd-dbgapi.h:7018

AMD_DBGAPI_RUNTIME_STATE_UNLOADED

@ AMD_DBGAPI_RUNTIME_STATE_UNLOADED

The inferior's runtime has been unloaded.

Definition: amd-dbgapi.h:6964

AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS

@ AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS

The inferior's runtime has been loaded and debugging is supported by the library.

Definition: amd-dbgapi.h:6960

AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION

@ 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:6970

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:6847

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:6825

AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR

@ 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:6909

AMD_DBGAPI_EVENT_KIND_WAVE_STOP

@ AMD_DBGAPI_EVENT_KIND_WAVE_STOP

A wave has stopped.

Definition: amd-dbgapi.h:6810

AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME

@ AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME

Request to resume a host breakpoint.

Definition: amd-dbgapi.h:6860

AMD_DBGAPI_EVENT_KIND_RUNTIME

@ AMD_DBGAPI_EVENT_KIND_RUNTIME

The runtime support in the inferior is enabled or disabled.

Definition: amd-dbgapi.h:6875

AMD_DBGAPI_EVENT_KIND_NONE

@ AMD_DBGAPI_EVENT_KIND_NONE

No event.

Definition: amd-dbgapi.h:6806

amd_dbgapi_finalize

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize(void) AMD_DBGAPI_VERSION_0_54

Finalize the library.

amd_dbgapi_initialize

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

amd_dbgapi_log_level_t

The logging levels supported.

Definition: amd-dbgapi.h:7114

amd_dbgapi_set_log_level

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

@ AMD_DBGAPI_LOG_LEVEL_NONE

Print no messages.

Definition: amd-dbgapi.h:7118

AMD_DBGAPI_LOG_LEVEL_VERBOSE

@ AMD_DBGAPI_LOG_LEVEL_VERBOSE

Print fatal error, warning, info, API tracing, and verbose messages.

Definition: amd-dbgapi.h:7139

AMD_DBGAPI_LOG_LEVEL_INFO

@ AMD_DBGAPI_LOG_LEVEL_INFO

Print fatal error, warning, and info messages.

Definition: amd-dbgapi.h:7131

AMD_DBGAPI_LOG_LEVEL_TRACE

@ AMD_DBGAPI_LOG_LEVEL_TRACE

Print fatal error, warning, info, and API tracing messages.

Definition: amd-dbgapi.h:7135

AMD_DBGAPI_LOG_LEVEL_WARNING

@ AMD_DBGAPI_LOG_LEVEL_WARNING

Print fatal error and warning messages.

Definition: amd-dbgapi.h:7127

AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR

@ AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR

Print fatal error messages.

Definition: amd-dbgapi.h:7123

amd_dbgapi_address_class_info_t

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:5702

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_54

Report the list of source language address classes supported by the architecture.

amd_dbgapi_lane_id_t

uint32_t amd_dbgapi_lane_id_t

A wave lane handle.

Definition: amd-dbgapi.h:5663

amd_dbgapi_set_alu_exceptions_precision

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_address_class_get_info

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

amd_dbgapi_alu_exceptions_precision_t

ALU exceptions reporting precision.

Definition: amd-dbgapi.h:6698

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:6092

amd_dbgapi_address_dependency

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_dependency(amd_dbgapi_address_space_id_t address_space_id, amd_dbgapi_segment_address_t segment_address, amd_dbgapi_segment_address_dependency_t *segment_address_dependency) AMD_DBGAPI_VERSION_0_64

Determine the dependency of a segment address value in a particular address space.

amd_dbgapi_address_space_get_info

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_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_54

Report the list of address spaces supported by the architecture.

amd_dbgapi_address_is_in_address_class

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

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:6223

amd_dbgapi_address_space_access_t

amd_dbgapi_address_space_access_t

Indication of how the address space is accessed.

Definition: amd-dbgapi.h:5892

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_54

Return the address space from an AMD GPU DWARF address space number for an architecture.

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_54

Return the architecture source language address class from a DWARF address class number for an archit...

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_54

Control precision of memory access reporting.

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:6299

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:5918

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_54

Read memory.

amd_dbgapi_convert_address_space

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_convert_address_space(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id, amd_dbgapi_address_space_id_t source_address_space_id, amd_dbgapi_segment_address_t source_segment_address, amd_dbgapi_address_space_id_t destination_address_space_id, amd_dbgapi_segment_address_t *destination_segment_address, amd_dbgapi_size_t *destination_contiguous_bytes) AMD_DBGAPI_VERSION_0_62

Convert a source segment address in the source address space into a destination segment address in th...

amd_dbgapi_memory_precision_t

amd_dbgapi_memory_precision_t

Memory access precision.

Definition: amd-dbgapi.h:6624

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_76

Write memory.

AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME

@ AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME

Return the source language address class name.

Definition: amd-dbgapi.h:5709

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:5718

AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF

@ AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF

Return the AMD GPU DWARF address class number for the address class' architecture.

Definition: amd-dbgapi.h:5723

AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_NONE

@ 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:6703

AMD_DBGAPI_ALU_EXCEPTIONS_PRECISION_PRECISE

@ 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:6709

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS

Reading or writing the segment address depends on the process.

Definition: amd-dbgapi.h:6247

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE

Reading or writing the segment address depends on the wavefront.

Definition: amd-dbgapi.h:6235

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP

Reading or writing the segment address depends on the workgroup.

Definition: amd-dbgapi.h:6239

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE

No dependence is available.

Definition: amd-dbgapi.h:6227

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE

Reading or writing the segment address depends on the lane.

Definition: amd-dbgapi.h:6231

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT

Reading or writing the segment address depends on the agent.

Definition: amd-dbgapi.h:6243

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:5907

AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT

@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT

The address space is read only.

Definition: amd-dbgapi.h:5902

AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL

@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL

The address space supports all accesses.

Definition: amd-dbgapi.h:5897

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:6304

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:6309

AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS

@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS

Return the address space access.

Definition: amd-dbgapi.h:5940

AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF

@ AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF

Return the AMD GPU DWARF address space number for the address space's architecture.

Definition: amd-dbgapi.h:5945

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:5930

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:5935

AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME

@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME

Return the address space name.

Definition: amd-dbgapi.h:5925

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:6629

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:6634

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_77

Query information about a process.

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_76

Set the progress required for a process.

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_76

Set the wave creation mode for a process.

amd_dbgapi_endianness_t

amd_dbgapi_endianness_t

Byte endianness encoding.

Definition: amd-dbgapi.h:1705

amd_dbgapi_wave_creation_t

amd_dbgapi_wave_creation_t

The kinds of wave creation supported by the hardware.

Definition: amd-dbgapi.h:2092

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:1678

amd_dbgapi_progress_t

amd_dbgapi_progress_t

The kinds of progress supported by the library.

Definition: amd-dbgapi.h:2015

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:1741

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_56

Attach to a process in order to provide debug control of the AMD GPUs it uses.

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_54

Detach from a process and no longer have debug control of the AMD GPU devices it uses.

AMD_DBGAPI_ENDIAN_LITTLE

@ AMD_DBGAPI_ENDIAN_LITTLE

Encoding is done using little endian.

Definition: amd-dbgapi.h:1710

AMD_DBGAPI_ENDIAN_BIG

@ AMD_DBGAPI_ENDIAN_BIG

Encoding is done using big endian.

Definition: amd-dbgapi.h:1707

AMD_DBGAPI_WAVE_CREATION_NORMAL

@ AMD_DBGAPI_WAVE_CREATION_NORMAL

Normal wave creation allows new waves to be created.

Definition: amd-dbgapi.h:2096

AMD_DBGAPI_WAVE_CREATION_STOP

@ AMD_DBGAPI_WAVE_CREATION_STOP

Stop wave creation prevents new waves from being created.

Definition: amd-dbgapi.h:2100

AMD_DBGAPI_PROGRESS_NO_FORWARD

@ AMD_DBGAPI_PROGRESS_NO_FORWARD

No forward progress is needed.

Definition: amd-dbgapi.h:2045

AMD_DBGAPI_PROGRESS_NORMAL

@ AMD_DBGAPI_PROGRESS_NORMAL

Normal progress is needed.

Definition: amd-dbgapi.h:2021

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:1752

AMD_DBGAPI_PROCESS_INFO_CORE_STATE

@ 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:1795

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:1764

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:1746

AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE

@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE

Return how watchpoints are shared between processes.

Definition: amd-dbgapi.h:1758

AMD_DBGAPI_PROCESS_INFO_OS_ID

@ AMD_DBGAPI_PROCESS_INFO_OS_ID

Native operating system process ID.

Definition: amd-dbgapi.h:1785

AMD_DBGAPI_PROCESS_INFO_PRECISE_ALU_EXCEPTIONS_SUPPORTED

@ 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:1771

amd_dbgapi_queue_state_t

amd_dbgapi_queue_state_t

Queue state.

Definition: amd-dbgapi.h:2809

amd_dbgapi_process_queue_list

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_queue_get_info

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_queue_packet_list

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

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:2835

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:2713

AMD_DBGAPI_QUEUE_STATE_VALID

@ AMD_DBGAPI_QUEUE_STATE_VALID

Queue is in a valid state.

Definition: amd-dbgapi.h:2813

AMD_DBGAPI_QUEUE_STATE_ERROR

@ AMD_DBGAPI_QUEUE_STATE_ERROR

Queue is in the queue error state.

Definition: amd-dbgapi.h:2827

AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION

@ AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION

A wave on the queue executed an illegal instruction.

Definition: amd-dbgapi.h:2873

AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED

@ AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED

A packet on the queue has an unsupported code.

Definition: amd-dbgapi.h:2907

AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_GROUP_SEGMENT_SIZE_INVALID

@ 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:2899

AMD_DBGAPI_EXCEPTION_WAVE_TRAP

@ AMD_DBGAPI_EXCEPTION_WAVE_TRAP

A wave on the queue executed an instruction that caused an exception.

Definition: amd-dbgapi.h:2853

AMD_DBGAPI_EXCEPTION_WAVE_ABORT

@ AMD_DBGAPI_EXCEPTION_WAVE_ABORT

A wave on the queue executed a trap instruction used to abort a dispatch.

Definition: amd-dbgapi.h:2843

AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR

@ AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR

There was an error preempting the queue.

Definition: amd-dbgapi.h:2928

AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID

@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID

A dispatch packet on the queue has an invalid workgroup size.

Definition: amd-dbgapi.h:2911

AMD_DBGAPI_EXCEPTION_WAVE_MATH_ERROR

@ 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:2869

AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE

@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE

A dispatch packet on the queue requires too many registers.

Definition: amd-dbgapi.h:2915

AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID

@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID

A dispatch packet on the queue has a NULL code address.

Definition: amd-dbgapi.h:2903

AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION

@ AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION

A wave on the queue had a memory violation.

Definition: amd-dbgapi.h:2879

AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID

@ AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID

A dispatch packet on the queue has an invalid dimension.

Definition: amd-dbgapi.h:2895

AMD_DBGAPI_EXCEPTION_WAVE_ADDRESS_ERROR

@ 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:2886

AMD_DBGAPI_EXCEPTION_NONE

@ AMD_DBGAPI_EXCEPTION_NONE

If none of the bits are set, then the queue is not in the error state.

Definition: amd-dbgapi.h:2839

AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED

@ AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED

A packet on the queue has an invalid vendor code.

Definition: amd-dbgapi.h:2919

AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE

@ AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE

Return the architecture of this queue.

Definition: amd-dbgapi.h:2728

AMD_DBGAPI_QUEUE_INFO_PROCESS

@ AMD_DBGAPI_QUEUE_INFO_PROCESS

Return the process to which this queue belongs.

Definition: amd-dbgapi.h:2723

AMD_DBGAPI_QUEUE_INFO_TYPE

@ AMD_DBGAPI_QUEUE_INFO_TYPE

Return the queue type.

Definition: amd-dbgapi.h:2733

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:2750

AMD_DBGAPI_QUEUE_INFO_STATE

@ AMD_DBGAPI_QUEUE_INFO_STATE

Return the queue state.

Definition: amd-dbgapi.h:2738

AMD_DBGAPI_QUEUE_INFO_AGENT

@ AMD_DBGAPI_QUEUE_INFO_AGENT

Return the agent to which this queue belongs.

Definition: amd-dbgapi.h:2718

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:2755

AMD_DBGAPI_QUEUE_INFO_ERROR_REASON

@ 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:2745

AMD_DBGAPI_QUEUE_INFO_OS_ID

@ AMD_DBGAPI_QUEUE_INFO_OS_ID

Native operating system queue ID.

Definition: amd-dbgapi.h:2760

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_54

Report the list of registers supported by the architecture.

amd_dbgapi_register_is_in_register_class

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_wave_register_exists

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

amd_dbgapi_register_properties_t

A bit mask on register properties.

Definition: amd-dbgapi.h:5003

amd_dbgapi_read_register

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_write_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_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_54

Report the list of register classes supported by the architecture.

amd_dbgapi_register_info_t

amd_dbgapi_register_info_t

Register queries that are supported by amd_dbgapi_register_get_info.

Definition: amd-dbgapi.h:5037

amd_dbgapi_architecture_register_class_get_info

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

amd_dbgapi_register_class_info_t

Register class queries that are supported by amd_dbgapi_architecture_register_class_get_info.

Definition: amd-dbgapi.h:4874

amd_dbgapi_wave_register_list

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_register_get_info

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

amd_dbgapi_register_exists_t

Indication of if a wave has a register.

Definition: amd-dbgapi.h:5183

amd_dbgapi_prefetch_register

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_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_54

Return a register handle from an AMD GPU DWARF register number for an architecture.

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:5370

AMD_DBGAPI_REGISTER_PROPERTY_INVALIDATE_VOLATILE

@ 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:5027

AMD_DBGAPI_REGISTER_PROPERTY_NONE

@ AMD_DBGAPI_REGISTER_PROPERTY_NONE

There are no properties.

Definition: amd-dbgapi.h:5007

AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS

@ AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS

At least one bit of the register value is readonly.

Definition: amd-dbgapi.h:5013

AMD_DBGAPI_REGISTER_PROPERTY_VOLATILE

@ 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:5020

AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE

@ AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE

Return the architecture to which this register belongs.

Definition: amd-dbgapi.h:5042

AMD_DBGAPI_REGISTER_INFO_NAME

@ AMD_DBGAPI_REGISTER_INFO_NAME

Return the register name.

Definition: amd-dbgapi.h:5049

AMD_DBGAPI_REGISTER_INFO_SIZE

@ AMD_DBGAPI_REGISTER_INFO_SIZE

Return the size of the register in bytes.

Definition: amd-dbgapi.h:5054

AMD_DBGAPI_REGISTER_INFO_PROPERTIES

@ AMD_DBGAPI_REGISTER_INFO_PROPERTIES

Return the register's properties.

Definition: amd-dbgapi.h:5129

AMD_DBGAPI_REGISTER_INFO_DWARF

@ AMD_DBGAPI_REGISTER_INFO_DWARF

Return the AMD GPU DWARF register number for the register's architecture.

Definition: amd-dbgapi.h:5124

AMD_DBGAPI_REGISTER_INFO_TYPE

@ AMD_DBGAPI_REGISTER_INFO_TYPE

Return the register type as a C style type string.

Definition: amd-dbgapi.h:5115

AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE

@ AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE

Return the architecture to which this register class belongs.

Definition: amd-dbgapi.h:4879

AMD_DBGAPI_REGISTER_CLASS_INFO_NAME

@ AMD_DBGAPI_REGISTER_CLASS_INFO_NAME

Return the register class name.

Definition: amd-dbgapi.h:4886

AMD_DBGAPI_REGISTER_ABSENT

@ AMD_DBGAPI_REGISTER_ABSENT

The wave does not have the register.

Definition: amd-dbgapi.h:5187

AMD_DBGAPI_REGISTER_PRESENT

@ AMD_DBGAPI_REGISTER_PRESENT

The wave has the register.

Definition: amd-dbgapi.h:5191

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:5374

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:5378

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_54

Query a textual description of a status code.

amd_dbgapi_status_t

amd_dbgapi_status_t

AMD debugger API status codes.

Definition: amd-dbgapi.h:774

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:945

AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID

The lane handle is invalid.

Definition: amd-dbgapi.h:953

AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID

The breakpoint handle is invalid.

Definition: amd-dbgapi.h:977

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:870

AMD_DBGAPI_STATUS_ERROR_PROCESS_ALREADY_FROZEN

@ AMD_DBGAPI_STATUS_ERROR_PROCESS_ALREADY_FROZEN

The process is already frozen.

Definition: amd-dbgapi.h:1010

AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID

The workgroup handle is invalid.

Definition: amd-dbgapi.h:998

AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE

@ AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE

No more watchpoints available.

Definition: amd-dbgapi.h:941

AMD_DBGAPI_STATUS_ERROR_PROCESS_FROZEN

@ AMD_DBGAPI_STATUS_ERROR_PROCESS_FROZEN

This operation is not allowed when the process is frozen.

Definition: amd-dbgapi.h:1006

AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID

The wave handle is invalid.

Definition: amd-dbgapi.h:899

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:965

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:866

AMD_DBGAPI_STATUS_ERROR_PROCESS_NOT_FROZEN

@ AMD_DBGAPI_STATUS_ERROR_PROCESS_NOT_FROZEN

This operation is not allowed when the process is not frozen.

Definition: amd-dbgapi.h:1014

AMD_DBGAPI_STATUS_SUCCESS

@ AMD_DBGAPI_STATUS_SUCCESS

The function has executed successfully.

Definition: amd-dbgapi.h:778

AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED

@ AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED

The operation is not supported.

Definition: amd-dbgapi.h:818

AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE

@ AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE

The wave has an active displaced stepping buffer.

Definition: amd-dbgapi.h:928

AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED

@ AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED

The library is already initialized.

Definition: amd-dbgapi.h:830

AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_NOT_AVAILABLE

@ 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:924

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:911

AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID

The agent handle is invalid.

Definition: amd-dbgapi.h:887

AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED

@ AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED

The library is not initialized.

Definition: amd-dbgapi.h:834

AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND

@ AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND

The symbol was not found.

Definition: amd-dbgapi.h:989

AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY

@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY

An invalid combination of arguments was given to the function.

Definition: amd-dbgapi.h:826

AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID

The watchpoint handle is invalid.

Definition: amd-dbgapi.h:937

AMD_DBGAPI_STATUS_ERROR_RESUME_DISPLACED_STEPPING

@ 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:933

AMD_DBGAPI_STATUS_ERROR_INCOMPATIBLE_PROCESS_STATE

@ AMD_DBGAPI_STATUS_ERROR_INCOMPATIBLE_PROCESS_STATE

The current process state is not compatible with the requested operation.

Definition: amd-dbgapi.h:1002

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_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID

The client process handle is invalid.

Definition: amd-dbgapi.h:985

AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID

The architecture handle is invalid.

Definition: amd-dbgapi.h:862

AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT

@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT

An invalid argument was given to the function.

Definition: amd-dbgapi.h:822

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:957

AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID

The event handle is invalid.

Definition: amd-dbgapi.h:973

AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED

@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED

The wave is not stopped.

Definition: amd-dbgapi.h:903

AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED

@ AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED

The wave is stopped.

Definition: amd-dbgapi.h:907

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:961

AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID

The process handle is invalid.

Definition: amd-dbgapi.h:878

AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE

@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE

The wave cannot be resumed.

Definition: amd-dbgapi.h:915

AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED

@ AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED

The operation is not currently implemented.

Definition: amd-dbgapi.h:810

AMD_DBGAPI_STATUS_ERROR_RESTRICTION

@ AMD_DBGAPI_STATUS_ERROR_RESTRICTION

There is a restriction error that prevents the operation to complete.

Definition: amd-dbgapi.h:854

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:969

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:874

AMD_DBGAPI_STATUS_FATAL

@ AMD_DBGAPI_STATUS_FATAL

A fatal error has occurred.

Definition: amd-dbgapi.h:804

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:919

AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK

@ AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK

A callback to the client reported an error.

Definition: amd-dbgapi.h:981

AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE

@ AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE

The requested information is not available.

Definition: amd-dbgapi.h:814

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:858

AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID

The queue handle is invalid.

Definition: amd-dbgapi.h:891

AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID

The register handle is invalid.

Definition: amd-dbgapi.h:949

AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID

The dispatch handle is invalid.

Definition: amd-dbgapi.h:895

AMD_DBGAPI_STATUS_ERROR_REGISTER_NOT_AVAILABLE

@ 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:994

AMD_DBGAPI_STATUS_ERROR

@ AMD_DBGAPI_STATUS_ERROR

A generic error has occurred.

Definition: amd-dbgapi.h:782

AMD_DBGAPI_VERSION_0_58

#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:560

AMD_DBGAPI_VERSION_0_56

#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:554

AMD_DBGAPI_VERSION_0_67

#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:578

AMD_DBGAPI_VERSION_0_62

#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:566

AMD_DBGAPI_VERSION_0_54

#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:548

AMD_DBGAPI_VERSION_0_76

#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:596

AMD_DBGAPI_VERSION_0_64

#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:572

AMD_DBGAPI_VERSION_0_77

#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:602

AMD_DBGAPI_VERSION_0_70

#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:590

AMD_DBGAPI_VERSION_0_68

#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:584

amd_dbgapi_get_version

void AMD_DBGAPI amd_dbgapi_get_version(uint32_t *major, uint32_t *minor, uint32_t *patch) AMD_DBGAPI_VERSION_0_54

Query the version of the installed library.

amd_dbgapi_get_build_name

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

amd_dbgapi_watchpoint_info_t

Watchpoint queries that are supported by amd_dbgapi_watchpoint_get_info.

Definition: amd-dbgapi.h:4606

amd_dbgapi_remove_watchpoint

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

amd_dbgapi_watchpoint_kind_t

Watchpoint memory access kinds.

Definition: amd-dbgapi.h:4700

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_VERSION_0_76

Set a hardware data watchpoint.

amd_dbgapi_watchpoint_get_info

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

amd_dbgapi_watchpoint_share_kind_t

The way watchpoints are shared between processes.

Definition: amd-dbgapi.h:4674

AMD_DBGAPI_WATCHPOINT_INFO_PROCESS

@ AMD_DBGAPI_WATCHPOINT_INFO_PROCESS

Return the process to which this watchpoint belongs.

Definition: amd-dbgapi.h:4611

AMD_DBGAPI_WATCHPOINT_INFO_SIZE

@ AMD_DBGAPI_WATCHPOINT_INFO_SIZE

The byte size of the created watchpoint.

Definition: amd-dbgapi.h:4621

AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS

@ AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS

The base address of the created watchpoint.

Definition: amd-dbgapi.h:4616

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:4709

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:4718

AMD_DBGAPI_WATCHPOINT_KIND_LOAD

@ AMD_DBGAPI_WATCHPOINT_KIND_LOAD

Read access by load instructions.

Definition: amd-dbgapi.h:4704

AMD_DBGAPI_WATCHPOINT_KIND_RMW

@ AMD_DBGAPI_WATCHPOINT_KIND_RMW

Read-modify-write access by atomic instructions.

Definition: amd-dbgapi.h:4713

AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED

@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED

The watchpoints are not shared across processes.

Definition: amd-dbgapi.h:4684

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:4690

AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED

@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED

Watchpoints are not supported.

Definition: amd-dbgapi.h:4678

amd_dbgapi_wave_resume

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_wave_state_t

amd_dbgapi_wave_state_t

The execution state of a wave.

Definition: amd-dbgapi.h:3702

amd_dbgapi_wave_stop

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_process_wave_list

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

amd_dbgapi_resume_mode_t

The mode in which to resuming the execution of a wave.

Definition: amd-dbgapi.h:4066

amd_dbgapi_wave_stop_reasons_t

amd_dbgapi_wave_stop_reasons_t

A bit mask of the reasons that a wave stopped.

Definition: amd-dbgapi.h:3734

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:3538

amd_dbgapi_wave_get_info

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_get_info(amd_dbgapi_wave_id_t wave_id, amd_dbgapi_wave_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64

Query information about a wave.

AMD_DBGAPI_WAVE_STATE_STOP

@ AMD_DBGAPI_WAVE_STATE_STOP

The wave is stopped.

Definition: amd-dbgapi.h:3724

AMD_DBGAPI_WAVE_STATE_SINGLE_STEP

@ AMD_DBGAPI_WAVE_STATE_SINGLE_STEP

The wave is running in single-step mode.

Definition: amd-dbgapi.h:3711

AMD_DBGAPI_WAVE_STATE_RUN

@ AMD_DBGAPI_WAVE_STATE_RUN

The wave is running.

Definition: amd-dbgapi.h:3706

AMD_DBGAPI_RESUME_MODE_SINGLE_STEP

@ AMD_DBGAPI_RESUME_MODE_SINGLE_STEP

Resume execution in in single step mode.

Definition: amd-dbgapi.h:4074

AMD_DBGAPI_RESUME_MODE_NORMAL

@ AMD_DBGAPI_RESUME_MODE_NORMAL

Resume normal execution.

Definition: amd-dbgapi.h:4070

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:3777

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:3757

AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION

@ AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION

The wave stopped due to a memory violation.

Definition: amd-dbgapi.h:3874

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:3761

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:3903

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:3832

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:3769

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:3916

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:3923

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:3848

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:3739

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:3745

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:3809

AMD_DBGAPI_WAVE_STOP_REASON_ADDRESS_ERROR

@ AMD_DBGAPI_WAVE_STOP_REASON_ADDRESS_ERROR

The wave stopped due to an aperture violation.

Definition: amd-dbgapi.h:3889

AMD_DBGAPI_WAVE_STOP_REASON_TRAP

@ 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:3858

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:3817

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:3793

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:3801

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:3785

AMD_DBGAPI_WAVE_INFO_ARCHITECTURE

@ AMD_DBGAPI_WAVE_INFO_ARCHITECTURE

Return the architecture of this wave.

Definition: amd-dbgapi.h:3603

AMD_DBGAPI_WAVE_INFO_DISPATCH

@ AMD_DBGAPI_WAVE_INFO_DISPATCH

Return the dispatch to which this wave belongs.

Definition: amd-dbgapi.h:3583

AMD_DBGAPI_WAVE_INFO_QUEUE

@ AMD_DBGAPI_WAVE_INFO_QUEUE

Return the queue to which this wave belongs.

Definition: amd-dbgapi.h:3588

AMD_DBGAPI_WAVE_INFO_EXEC_MASK

@ AMD_DBGAPI_WAVE_INFO_EXEC_MASK

Return the current execution mask of the wave.

Definition: amd-dbgapi.h:3617

AMD_DBGAPI_WAVE_INFO_WORKGROUP

@ AMD_DBGAPI_WAVE_INFO_WORKGROUP

Return the workgroup to which this wave belongs.

Definition: amd-dbgapi.h:3573

AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP

@ AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP

The wave's number in the workgroup.

Definition: amd-dbgapi.h:3640

AMD_DBGAPI_WAVE_INFO_STATE

@ AMD_DBGAPI_WAVE_INFO_STATE

Return the wave's state.

Definition: amd-dbgapi.h:3543

AMD_DBGAPI_WAVE_INFO_PROCESS

@ AMD_DBGAPI_WAVE_INFO_PROCESS

Return the process to which this wave belongs.

Definition: amd-dbgapi.h:3598

AMD_DBGAPI_WAVE_INFO_AGENT

@ AMD_DBGAPI_WAVE_INFO_AGENT

Return the agent to which this wave belongs.

Definition: amd-dbgapi.h:3593

AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD

@ AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD

The wave workgroup coordinate in the dispatch grid dimensions.

Definition: amd-dbgapi.h:3628

AMD_DBGAPI_WAVE_INFO_WATCHPOINTS

@ AMD_DBGAPI_WAVE_INFO_WATCHPOINTS

Return the watchpoint(s) the wave triggered.

Definition: amd-dbgapi.h:3563

AMD_DBGAPI_WAVE_INFO_LANE_COUNT

@ AMD_DBGAPI_WAVE_INFO_LANE_COUNT

The number of lanes supported by the wave.

Definition: amd-dbgapi.h:3645

AMD_DBGAPI_WAVE_INFO_PC

@ AMD_DBGAPI_WAVE_INFO_PC

Return the current program counter value of the wave.

Definition: amd-dbgapi.h:3609

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:3550

amd_dbgapi_process_workgroup_list

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_get_info

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_workgroup_get_info(amd_dbgapi_workgroup_id_t workgroup_id, amd_dbgapi_workgroup_info_t query, size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64

Query information about a workgroup.

amd_dbgapi_workgroup_info_t

amd_dbgapi_workgroup_info_t

Workgroup queries that are supported by amd_dbgapi_workgroup_get_info.

Definition: amd-dbgapi.h:3360

AMD_DBGAPI_WORKGROUP_INFO_QUEUE

@ AMD_DBGAPI_WORKGROUP_INFO_QUEUE

Return the queue to which this workgroup belongs.

Definition: amd-dbgapi.h:3375

AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE

@ AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE

Return the architecture of this workgroup.

Definition: amd-dbgapi.h:3390

AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD

@ AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD

The workgroup workgroup coordinate in the dispatch grid dimensions.

Definition: amd-dbgapi.h:3401

AMD_DBGAPI_WORKGROUP_INFO_DISPATCH

@ AMD_DBGAPI_WORKGROUP_INFO_DISPATCH

Return the dispatch to which this workgroup belongs.

Definition: amd-dbgapi.h:3370

AMD_DBGAPI_WORKGROUP_INFO_PROCESS

@ AMD_DBGAPI_WORKGROUP_INFO_PROCESS

Return the process to which this workgroup belongs.

Definition: amd-dbgapi.h:3385

AMD_DBGAPI_WORKGROUP_INFO_AGENT

@ AMD_DBGAPI_WORKGROUP_INFO_AGENT

Return the agent to which this workgroup belongs.

Definition: amd-dbgapi.h:3380

amd_dbgapi_address_class_id_t

Opaque source language address class handle.

Definition: amd-dbgapi.h:5684

amd_dbgapi_address_class_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:5685

amd_dbgapi_address_space_id_t

Opaque address space handle.

Definition: amd-dbgapi.h:5869

amd_dbgapi_address_space_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:5870

amd_dbgapi_agent_id_t

Opaque agent handle.

Definition: amd-dbgapi.h:2462

amd_dbgapi_agent_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2463

amd_dbgapi_architecture_id_t

Opaque architecture handle.

Definition: amd-dbgapi.h:1192

amd_dbgapi_architecture_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:1193

amd_dbgapi_breakpoint_id_t

Opaque breakpoint handle.

Definition: amd-dbgapi.h:7189

amd_dbgapi_breakpoint_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:7190

amd_dbgapi_callbacks_s

Callbacks that the client of the library must provide.

Definition: amd-dbgapi.h:7363

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:7505

amd_dbgapi_callbacks_s::insert_breakpoint

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:7470

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:7394

amd_dbgapi_callbacks_s::client_process_get_info

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:7430

amd_dbgapi_callbacks_s::xfer_global_memory

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:7545

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:7559

amd_dbgapi_code_object_id_t

Opaque code object handle.

Definition: amd-dbgapi.h:2261

amd_dbgapi_code_object_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2262

amd_dbgapi_core_state_data_t

AMDGPU corefile state data for a process.

Definition: amd-dbgapi.h:1717

amd_dbgapi_core_state_data_t::size

size_t size

Size, in bytes, of the buffer pointed by amd_dbgapi_core_state_data_t::data.

Definition: amd-dbgapi.h:1723

amd_dbgapi_core_state_data_t::endianness

amd_dbgapi_endianness_t endianness

Endianness encoding of the core state.

Definition: amd-dbgapi.h:1719

amd_dbgapi_core_state_data_t::data

const void * data

Pointer to the buffer containing the core state data.

Definition: amd-dbgapi.h:1731

amd_dbgapi_direct_call_register_pair_information_t

Instruction information for direct call instructions.

Definition: amd-dbgapi.h:5619

amd_dbgapi_direct_call_register_pair_information_t::target_address

amd_dbgapi_global_address_t target_address

Definition: amd-dbgapi.h:5620

amd_dbgapi_dispatch_id_t

Opaque dispatch handle.

Definition: amd-dbgapi.h:3076

amd_dbgapi_dispatch_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:3077

amd_dbgapi_displaced_stepping_id_t

Opaque displaced stepping handle.

Definition: amd-dbgapi.h:4337

amd_dbgapi_displaced_stepping_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4338

amd_dbgapi_event_id_t

Opaque event handle.

Definition: amd-dbgapi.h:6788

amd_dbgapi_event_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:6789

amd_dbgapi_process_id_t

Opaque process handle.

Definition: amd-dbgapi.h:1691

amd_dbgapi_process_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:1692

amd_dbgapi_queue_id_t

Opaque queue handle.

Definition: amd-dbgapi.h:2696

amd_dbgapi_queue_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2697

amd_dbgapi_register_class_id_t

Opaque register class handle.

Definition: amd-dbgapi.h:4856

amd_dbgapi_register_class_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4857

amd_dbgapi_register_id_t

Opaque register handle.

Definition: amd-dbgapi.h:4986

amd_dbgapi_register_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4987

amd_dbgapi_watchpoint_id_t

Opaque hardware data watchpoint handle.

Definition: amd-dbgapi.h:4589

amd_dbgapi_watchpoint_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4590

amd_dbgapi_watchpoint_list_t

A set of watchpoints.

Definition: amd-dbgapi.h:4728

amd_dbgapi_watchpoint_list_t::watchpoint_ids

amd_dbgapi_watchpoint_id_t * watchpoint_ids

Definition: amd-dbgapi.h:4730

amd_dbgapi_watchpoint_list_t::count

size_t count

Definition: amd-dbgapi.h:4729

amd_dbgapi_wave_id_t

Opaque wave handle.

Definition: amd-dbgapi.h:3521

amd_dbgapi_wave_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:3522

amd_dbgapi_workgroup_id_t

Opaque workgroup handle.

Definition: amd-dbgapi.h:3343

amd_dbgapi_workgroup_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:3344