/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-rocdbgapi-docs/checkouts/latest/include/amd-dbgapi.h Source File

• include

amd-dbgapi.h

Go to the documentation of this file.

1 /* Copyright (c) 2019-2022 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 

407 #ifndef AMD_DBGAPI_H

408 #define AMD_DBGAPI_H 1

409 

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

411 #if !defined(AMD_DBGAPI_CALL)

412 #define AMD_DBGAPI_CALL

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

414 

415 #if !defined(AMD_DBGAPI_EXPORT_DECORATOR)

416 #if defined(__GNUC__)

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

418 #elif defined(_MSC_VER)

419 #define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)

420 #endif /* defined (_MSC_VER) */

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

422 

423 #if !defined(AMD_DBGAPI_IMPORT_DECORATOR)

424 #if defined(__GNUC__)

425 #define AMD_DBGAPI_IMPORT_DECORATOR

426 #elif defined(_MSC_VER)

427 #define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)

428 #endif /* defined (_MSC_VER) */

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

430 

431 #define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL

432 #define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL

433 

434 #if !defined(AMD_DBGAPI)

435 #if defined(AMD_DBGAPI_EXPORTS)

436 #define AMD_DBGAPI AMD_DBGAPI_EXPORT

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

438 #define AMD_DBGAPI AMD_DBGAPI_IMPORT

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

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

441 

442 #if __cplusplus >= 201103L

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

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

445 #elif __STDC_VERSION__ >= 199901L

446 /* c99 allows compound literals. */

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

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

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

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

451 

452 #if defined(__cplusplus)

453 extern "C" {

454 #endif /* defined (__cplusplus) */

455 

456 #if defined(__linux__)

457 #include <sys/types.h>

458 #endif /* __linux__ */

459 

460 #include <stddef.h>

461 #include <stdint.h>

462 

482 #define AMD_DBGAPI_VERSION_0_54

483 

488 #define AMD_DBGAPI_VERSION_0_56

489 

494 #define AMD_DBGAPI_VERSION_0_58

495 

500 #define AMD_DBGAPI_VERSION_0_62

501 

506 #define AMD_DBGAPI_VERSION_0_64

507 

512 #define AMD_DBGAPI_VERSION_0_67

513 

518 #define AMD_DBGAPI_VERSION_0_68

519 

526 typedef struct amd_dbgapi_callbacks_s amd_dbgapi_callbacks_t;

527 

550 typedef uint64_t amd_dbgapi_global_address_t;

551 

555 typedef uint64_t amd_dbgapi_size_t;

556 

560 typedef enum

561 {

565  AMD_DBGAPI_CHANGED_NO = 0,

569  AMD_DBGAPI_CHANGED_YES = 1

570 } amd_dbgapi_changed_t;

571 

579 #if defined(__linux__)

580 typedef pid_t amd_dbgapi_os_process_id_t;

581 #endif /* __linux__ */

582 

607 #if defined(__linux__)

608 typedef int amd_dbgapi_notifier_t;

609 #endif /* __linux__ */

610 

618 #if defined(__linux__)

619 typedef uint64_t amd_dbgapi_os_agent_id_t;

620 #endif /* __linux__ */

621 

628 #if defined(__linux__)

629 typedef uint64_t amd_dbgapi_os_queue_id_t;

630 #endif /* __linux__ */

631 

640 #if defined(__linux__)

641 typedef uint64_t amd_dbgapi_os_queue_packet_id_t;

642 #endif /* __linux__ */

643 

651 #if defined(__linux__)

652 typedef enum

653 {

657  AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN = 0,

661  AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL = 1,

665  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4 = 257,

669  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA = 513,

673  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI = 514

674 } amd_dbgapi_os_queue_type_t;

675 #endif /* __linux__ */

676 

689 typedef enum

690 {

694  AMD_DBGAPI_STATUS_SUCCESS = 0,

698  AMD_DBGAPI_STATUS_ERROR = -1,

720  AMD_DBGAPI_STATUS_FATAL = -2,

726  AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED = -3,

730  AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE = -4,

734  AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED = -5,

738  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT = -6,

742  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY = -7,

746  AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED = -8,

750  AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED = -9,

766  AMD_DBGAPI_STATUS_ERROR_RESTRICTION = -10,

770  AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED = -11,

774  AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID = -12,

778  AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION = -13,

782  AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID = -14,

786  AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE = -15,

790  AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID = -16,

795  AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED = -17,

799  AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID = -18,

803  AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID = -19,

807  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID = -20,

811  AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID = -21,

815  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED = -22,

819  AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED = -23,

823  AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP = -24,

827  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE = -25,

831  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID = -26,

836  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_NOT_AVAILABLE = -27,

840  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE = -28,

845  AMD_DBGAPI_STATUS_ERROR_RESUME_DISPLACED_STEPPING = -29,

849  AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID = -30,

853  AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE = -31,

857  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID = -32,

861  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID = -33,

865  AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID = -34,

869  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID = -35,

873  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID = -36,

877  AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS = -37,

881  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION = -38,

885  AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID = -39,

889  AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID = -40,

893  AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK = -41,

897  AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID = -42,

901  AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND = -43,

906  AMD_DBGAPI_STATUS_ERROR_REGISTER_NOT_AVAILABLE = -44,

910  AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID = -45,

911 } amd_dbgapi_status_t;

912 

929 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_status_string (

930  amd_dbgapi_status_t status,

931  const char **status_string) AMD_DBGAPI_VERSION_0_54;

932 

956 #define AMD_DBGAPI_VERSION_MAJOR 0

957 

962 #define AMD_DBGAPI_VERSION_MINOR 68

963 

977 void AMD_DBGAPI amd_dbgapi_get_version (

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

979 

988 const char AMD_DBGAPI *

989 amd_dbgapi_get_build_name (void) AMD_DBGAPI_VERSION_0_54;

990 

1036 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize (

1037  amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_54;

1038 

1063 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize (void)

1064  AMD_DBGAPI_VERSION_0_54;

1065 

1087 typedef struct

1088 {

1089  uint64_t handle;

1090 } amd_dbgapi_architecture_id_t;

1091 

1095 #define AMD_DBGAPI_ARCHITECTURE_NONE \

1096  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_architecture_id_t, 0)

1097 

1105 typedef enum

1106 {

1113  AMD_DBGAPI_ARCHITECTURE_INFO_NAME = 1,

1121  AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE = 2,

1126  AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE = 3,

1132  AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT = 4,

1137  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE = 5,

1145  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION = 6,

1151  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_PC_ADJUST = 7,

1156  AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER = 8

1157 } amd_dbgapi_architecture_info_t;

1158 

1197 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_get_info (

1198  amd_dbgapi_architecture_id_t architecture_id,

1199  amd_dbgapi_architecture_info_t query, size_t value_size,

1200  void *value) AMD_DBGAPI_VERSION_0_54;

1201 

1230 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_get_architecture (

1231  uint32_t elf_amdgpu_machine,

1232  amd_dbgapi_architecture_id_t *architecture_id) AMD_DBGAPI_VERSION_0_54;

1233 

1240 typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;

1241 

1335 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_disassemble_instruction (

1336  amd_dbgapi_architecture_id_t architecture_id,

1337  amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,

1338  const void *memory, char **instruction_text,

1339  amd_dbgapi_symbolizer_id_t symbolizer_id,

1340  amd_dbgapi_status_t (*symbolizer) (

1341  amd_dbgapi_symbolizer_id_t symbolizer_id,

1342  amd_dbgapi_global_address_t address,

1343  char **symbol_text)) AMD_DBGAPI_VERSION_0_54;

1344 

1348 typedef enum

1349 {

1354  AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN = 0,

1360  AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL = 1,

1366  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH = 2,

1373  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL = 3,

1381  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_REGISTER_PAIR = 4,

1391  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_CONDITIONAL_REGISTER_PAIR = 5,

1402  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_CALL_REGISTER_PAIR = 6,

1412  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_CALL_REGISTER_PAIRS = 7,

1417  AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE = 8,

1431  AMD_DBGAPI_INSTRUCTION_KIND_TRAP = 9,

1436  AMD_DBGAPI_INSTRUCTION_KIND_HALT = 10,

1443  AMD_DBGAPI_INSTRUCTION_KIND_BARRIER = 11,

1449  AMD_DBGAPI_INSTRUCTION_KIND_SLEEP = 12,

1458  AMD_DBGAPI_INSTRUCTION_KIND_SPECIAL = 13

1459 } amd_dbgapi_instruction_kind_t;

1460 

1464 typedef enum

1465 {

1469  AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE = 0

1470 } amd_dbgapi_instruction_properties_t;

1471 

1546 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_classify_instruction (

1547  amd_dbgapi_architecture_id_t architecture_id,

1548  amd_dbgapi_global_address_t address, amd_dbgapi_size_t *size,

1549  const void *memory, amd_dbgapi_instruction_kind_t *instruction_kind,

1550  amd_dbgapi_instruction_properties_t *instruction_properties,

1551  void **instruction_information) AMD_DBGAPI_VERSION_0_58;

1552 

1574 typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;

1575 

1586 typedef struct

1587 {

1588  uint64_t handle;

1589 } amd_dbgapi_process_id_t;

1590 

1594 #define AMD_DBGAPI_PROCESS_NONE \

1595  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_process_id_t, 0)

1596 

1603 typedef enum

1604 {

1609  AMD_DBGAPI_PROCESS_INFO_NOTIFIER = 1,

1615  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT = 2,

1621  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE = 3,

1627  AMD_DBGAPI_PROCESS_INFO_PRECISE_MEMORY_SUPPORTED = 4,

1637  AMD_DBGAPI_PROCESS_INFO_OS_ID = 5

1638 } amd_dbgapi_process_info_t;

1639 

1682 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_get_info (

1683  amd_dbgapi_process_id_t process_id, amd_dbgapi_process_info_t query,

1684  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_56;

1685 

1775 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_attach (

1776  amd_dbgapi_client_process_id_t client_process_id,

1777  amd_dbgapi_process_id_t *process_id) AMD_DBGAPI_VERSION_0_56;

1778 

1823 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_detach (

1824  amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_54;

1825 

1840 typedef enum

1841 {

1847  AMD_DBGAPI_PROGRESS_NORMAL = 0,

1871  AMD_DBGAPI_PROGRESS_NO_FORWARD = 1

1872 } amd_dbgapi_progress_t;

1873 

1898 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_progress (

1899  amd_dbgapi_process_id_t process_id,

1900  amd_dbgapi_progress_t progress) AMD_DBGAPI_VERSION_0_54;

1901 

1913 typedef enum

1914 {

1918  AMD_DBGAPI_WAVE_CREATION_NORMAL = 0,

1922  AMD_DBGAPI_WAVE_CREATION_STOP = 1

1923 } amd_dbgapi_wave_creation_t;

1924 

1949 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_set_wave_creation (

1950  amd_dbgapi_process_id_t process_id,

1951  amd_dbgapi_wave_creation_t creation) AMD_DBGAPI_VERSION_0_54;

1952 

1979 typedef struct

1980 {

1981  uint64_t handle;

1982 } amd_dbgapi_code_object_id_t;

1983 

1987 #define AMD_DBGAPI_CODE_OBJECT_NONE \

1988  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_code_object_id_t, 0)

1989 

1996 typedef enum

1997 {

2002  AMD_DBGAPI_CODE_OBJECT_INFO_PROCESS = 1,

2058  AMD_DBGAPI_CODE_OBJECT_INFO_URI_NAME = 2,

2064  AMD_DBGAPI_CODE_OBJECT_INFO_LOAD_ADDRESS = 3

2065 } amd_dbgapi_code_object_info_t;

2066 

2105 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_code_object_get_info (

2106  amd_dbgapi_code_object_id_t code_object_id,

2107  amd_dbgapi_code_object_info_t query, size_t value_size,

2108  void *value) AMD_DBGAPI_VERSION_0_54;

2109 

2159 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_code_object_list (

2160  amd_dbgapi_process_id_t process_id, size_t *code_object_count,

2161  amd_dbgapi_code_object_id_t **code_objects,

2162  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2163 

2180 typedef struct

2181 {

2182  uint64_t handle;

2183 } amd_dbgapi_agent_id_t;

2184 

2188 #define AMD_DBGAPI_AGENT_NONE \

2189  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_agent_id_t, 0)

2190 

2197 typedef enum

2198 {

2203  AMD_DBGAPI_AGENT_INFO_PROCESS = 1,

2209  AMD_DBGAPI_AGENT_INFO_NAME = 2,

2219  AMD_DBGAPI_AGENT_INFO_ARCHITECTURE = 3,

2224  AMD_DBGAPI_AGENT_INFO_STATE = 4,

2228  AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN = 5,

2234  AMD_DBGAPI_AGENT_INFO_PCI_SLOT = 6,

2238  AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID = 7,

2242  AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID = 8,

2247  AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT = 9,

2252  AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT = 10,

2257  AMD_DBGAPI_AGENT_INFO_OS_ID = 11

2258 } amd_dbgapi_agent_info_t;

2259 

2263 typedef enum

2264 {

2268  AMD_DBGAPI_AGENT_STATE_SUPPORTED = 1,

2289  AMD_DBGAPI_AGENT_STATE_NOT_SUPPORTED = 2

2290 } amd_dbgapi_agent_state_t;

2291 

2334 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_agent_get_info (

2335  amd_dbgapi_agent_id_t agent_id, amd_dbgapi_agent_info_t query,

2336  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_67;

2337 

2389 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_agent_list (

2390  amd_dbgapi_process_id_t process_id, size_t *agent_count,

2391  amd_dbgapi_agent_id_t **agents,

2392  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2393 

2412 typedef struct

2413 {

2414  uint64_t handle;

2415 } amd_dbgapi_queue_id_t;

2416 

2420 #define AMD_DBGAPI_QUEUE_NONE \

2421  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_queue_id_t, 0)

2422 

2429 typedef enum

2430 {

2435  AMD_DBGAPI_QUEUE_INFO_AGENT = 1,

2440  AMD_DBGAPI_QUEUE_INFO_PROCESS = 2,

2445  AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE = 3,

2450  AMD_DBGAPI_QUEUE_INFO_TYPE = 4,

2455  AMD_DBGAPI_QUEUE_INFO_STATE = 5,

2462  AMD_DBGAPI_QUEUE_INFO_ERROR_REASON = 6,

2467  AMD_DBGAPI_QUEUE_INFO_ADDRESS = 7,

2472  AMD_DBGAPI_QUEUE_INFO_SIZE = 8,

2477  AMD_DBGAPI_QUEUE_INFO_OS_ID = 9

2478 } amd_dbgapi_queue_info_t;

2479 

2518 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_get_info (

2519  amd_dbgapi_queue_id_t queue_id, amd_dbgapi_queue_info_t query,

2520  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_68;

2521 

2525 typedef enum

2526 {

2530  AMD_DBGAPI_QUEUE_STATE_VALID = 1,

2544  AMD_DBGAPI_QUEUE_STATE_ERROR = 2

2545 } amd_dbgapi_queue_state_t;

2546 

2551 typedef enum

2552 {

2556  AMD_DBGAPI_EXCEPTION_NONE = 0,

2560  AMD_DBGAPI_EXCEPTION_WAVE_ABORT = (1 << 0),

2570  AMD_DBGAPI_EXCEPTION_WAVE_TRAP = (1 << 1),

2586  AMD_DBGAPI_EXCEPTION_WAVE_MATH_ERROR = (1 << 2),

2590  AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION = (1 << 3),

2596  AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION = (1 << 4),

2601  AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION = (1 << 5),

2605  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID = (1 << 16),

2609  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_GROUP_SEGMENT_SIZE_INVALID = (1 << 17),

2613  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID = (1 << 18),

2617  AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED = (1 << 20),

2621  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORKGROUP_SIZE_INVALID = (1 << 21),

2625  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE = (1 << 22),

2629  AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED = (1 << 23),

2638  AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR = (1 << 31)

2639 } amd_dbgapi_exceptions_t;

2640 

2693 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_queue_list (

2694  amd_dbgapi_process_id_t process_id, size_t *queue_count,

2695  amd_dbgapi_queue_id_t **queues,

2696  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

2697 

2761 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_queue_packet_list (

2762  amd_dbgapi_queue_id_t queue_id,

2763  amd_dbgapi_os_queue_packet_id_t *read_packet_id,

2764  amd_dbgapi_os_queue_packet_id_t *write_packet_id,

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

2766 

2785 typedef struct

2786 {

2787  uint64_t handle;

2788 } amd_dbgapi_dispatch_id_t;

2789 

2793 #define AMD_DBGAPI_DISPATCH_NONE \

2794  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_dispatch_id_t, 0)

2795 

2802 typedef enum

2803 {

2808  AMD_DBGAPI_DISPATCH_INFO_QUEUE = 1,

2813  AMD_DBGAPI_DISPATCH_INFO_AGENT = 2,

2818  AMD_DBGAPI_DISPATCH_INFO_PROCESS = 3,

2823  AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE = 4,

2829  AMD_DBGAPI_DISPATCH_INFO_OS_QUEUE_PACKET_ID = 5,

2834  AMD_DBGAPI_DISPATCH_INFO_BARRIER = 6,

2839  AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE = 7,

2844  AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE = 8,

2849  AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS = 9,

2854  AMD_DBGAPI_DISPATCH_INFO_WORKGROUP_SIZES = 10,

2859  AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES = 11,

2864  AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE = 12,

2869  AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE = 13,

2874  AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS = 14,

2879  AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS = 15,

2884  AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS = 16,

2894  AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS = 17

2895 } amd_dbgapi_dispatch_info_t;

2896 

2938 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dispatch_get_info (

2939  amd_dbgapi_dispatch_id_t dispatch_id, amd_dbgapi_dispatch_info_t query,

2940  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;

2941 

2948 typedef enum

2949 {

2953  AMD_DBGAPI_DISPATCH_BARRIER_NONE = 0,

2958  AMD_DBGAPI_DISPATCH_BARRIER_PRESENT = 1

2959 } amd_dbgapi_dispatch_barrier_t;

2960 

2967 typedef enum

2968 {

2972  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE = 0,

2976  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT = 1,

2980  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM = 2

2981 } amd_dbgapi_dispatch_fence_scope_t;

2982 

3031 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_dispatch_list (

3032  amd_dbgapi_process_id_t process_id, size_t *dispatch_count,

3033  amd_dbgapi_dispatch_id_t **dispatches,

3034  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

3035 

3052 typedef struct

3053 {

3054  uint64_t handle;

3055 } amd_dbgapi_workgroup_id_t;

3056 

3060 #define AMD_DBGAPI_WORKGROUP_NONE \

3061  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_workgroup_id_t, 0)

3062 

3069 typedef enum

3070 {

3080  AMD_DBGAPI_WORKGROUP_INFO_DISPATCH = 1,

3085  AMD_DBGAPI_WORKGROUP_INFO_QUEUE = 2,

3090  AMD_DBGAPI_WORKGROUP_INFO_AGENT = 3,

3095  AMD_DBGAPI_WORKGROUP_INFO_PROCESS = 4,

3100  AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE = 5,

3111  AMD_DBGAPI_WORKGROUP_INFO_WORKGROUP_COORD = 6

3112 } amd_dbgapi_workgroup_info_t;

3113 

3156 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_workgroup_get_info (

3157  amd_dbgapi_workgroup_id_t workgroup_id, amd_dbgapi_workgroup_info_t query,

3158  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;

3159 

3209 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_workgroup_list (

3210  amd_dbgapi_process_id_t process_id, size_t *workgroup_count,

3211  amd_dbgapi_workgroup_id_t **workgroups,

3212  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_64;

3213 

3230 typedef struct

3231 {

3232  uint64_t handle;

3233 } amd_dbgapi_wave_id_t;

3234 

3238 #define AMD_DBGAPI_WAVE_NONE \

3239  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_wave_id_t, 0)

3240 

3247 typedef enum

3248 {

3253  AMD_DBGAPI_WAVE_INFO_STATE = 1,

3260  AMD_DBGAPI_WAVE_INFO_STOP_REASON = 2,

3273  AMD_DBGAPI_WAVE_INFO_WATCHPOINTS = 3,

3283  AMD_DBGAPI_WAVE_INFO_WORKGROUP = 4,

3293  AMD_DBGAPI_WAVE_INFO_DISPATCH = 5,

3298  AMD_DBGAPI_WAVE_INFO_QUEUE = 6,

3303  AMD_DBGAPI_WAVE_INFO_AGENT = 7,

3308  AMD_DBGAPI_WAVE_INFO_PROCESS = 8,

3313  AMD_DBGAPI_WAVE_INFO_ARCHITECTURE = 9,

3319  AMD_DBGAPI_WAVE_INFO_PC = 10,

3327  AMD_DBGAPI_WAVE_INFO_EXEC_MASK = 11,

3338  AMD_DBGAPI_WAVE_INFO_WORKGROUP_COORD = 12,

3350  AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORKGROUP = 13,

3355  AMD_DBGAPI_WAVE_INFO_LANE_COUNT = 14

3356 } amd_dbgapi_wave_info_t;

3357 

3404 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_get_info (

3405  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_wave_info_t query,

3406  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_64;

3407 

3411 typedef enum

3412 {

3416  AMD_DBGAPI_WAVE_STATE_RUN = 1,

3421  AMD_DBGAPI_WAVE_STATE_SINGLE_STEP = 2,

3434  AMD_DBGAPI_WAVE_STATE_STOP = 3

3435 } amd_dbgapi_wave_state_t;

3436 

3443 typedef enum

3444 {

3449  AMD_DBGAPI_WAVE_STOP_REASON_NONE = 0,

3455  AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT = (1 << 0),

3467  AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT = (1 << 1),

3471  AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP = (1 << 2),

3479  AMD_DBGAPI_WAVE_STOP_REASON_FP_INPUT_DENORMAL = (1 << 3),

3487  AMD_DBGAPI_WAVE_STOP_REASON_FP_DIVIDE_BY_0 = (1 << 4),

3495  AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW = (1 << 5),

3503  AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW = (1 << 6),

3511  AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT = (1 << 7),

3519  AMD_DBGAPI_WAVE_STOP_REASON_FP_INVALID_OPERATION = (1 << 8),

3527  AMD_DBGAPI_WAVE_STOP_REASON_INT_DIVIDE_BY_0 = (1 << 9),

3542  AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP = (1 << 10),

3558  AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP = (1 << 11),

3568  AMD_DBGAPI_WAVE_STOP_REASON_TRAP = (1 << 12),

3584  AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION = (1 << 13),

3599  AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION = (1 << 14),

3608  AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION = (1 << 15),

3621  AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR = (1 << 16),

3628  AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT = (1 << 17)

3629 } amd_dbgapi_wave_stop_reasons_t;

3630 

3678 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_wave_list (

3679  amd_dbgapi_process_id_t process_id, size_t *wave_count,

3680  amd_dbgapi_wave_id_t **waves,

3681  amd_dbgapi_changed_t *changed) AMD_DBGAPI_VERSION_0_54;

3682 

3760 amd_dbgapi_status_t AMD_DBGAPI

3761 amd_dbgapi_wave_stop (amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_54;

3762 

3766 typedef enum

3767 {

3771  AMD_DBGAPI_RESUME_MODE_NORMAL = 0,

3775  AMD_DBGAPI_RESUME_MODE_SINGLE_STEP = 1

3776 } amd_dbgapi_resume_mode_t;

3777 

3929 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_resume (

3930  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_resume_mode_t resume_mode,

3931  amd_dbgapi_exceptions_t exceptions) AMD_DBGAPI_VERSION_0_58;

3932 

4034 typedef struct

4035 {

4036  uint64_t handle;

4037 } amd_dbgapi_displaced_stepping_id_t;

4038 

4042 #define AMD_DBGAPI_DISPLACED_STEPPING_NONE \

4043  (amd_dbgapi_displaced_stepping_id_t{ 0 })

4044 

4052 typedef enum

4053 {

4058  AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS = 1

4059 } amd_dbgapi_displaced_stepping_info_t;

4060 

4100 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_get_info (

4101  amd_dbgapi_displaced_stepping_id_t displaced_stepping_id,

4102  amd_dbgapi_displaced_stepping_info_t query, size_t value_size,

4103  void *value) AMD_DBGAPI_VERSION_0_54;

4104 

4186 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_start (

4187  amd_dbgapi_wave_id_t wave_id, const void *saved_instruction_bytes,

4188  amd_dbgapi_displaced_stepping_id_t *displaced_stepping)

4189  AMD_DBGAPI_VERSION_0_54;

4190 

4241 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_displaced_stepping_complete (

4242  amd_dbgapi_wave_id_t wave_id,

4243  amd_dbgapi_displaced_stepping_id_t displaced_stepping)

4244  AMD_DBGAPI_VERSION_0_54;

4245 

4279 typedef struct

4280 {

4281  uint64_t handle;

4282 } amd_dbgapi_watchpoint_id_t;

4283 

4287 #define AMD_DBGAPI_WATCHPOINT_NONE \

4288  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_watchpoint_id_t, 0)

4289 

4296 typedef enum

4297 {

4302  AMD_DBGAPI_WATCHPOINT_INFO_PROCESS = 1,

4307  AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS = 2,

4312  AMD_DBGAPI_WATCHPOINT_INFO_SIZE = 3

4313 } amd_dbgapi_watchpoint_info_t;

4314 

4353 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_watchpoint_get_info (

4354  amd_dbgapi_watchpoint_id_t watchpoint_id,

4355  amd_dbgapi_watchpoint_info_t query, size_t value_size,

4356  void *value) AMD_DBGAPI_VERSION_0_54;

4357 

4364 typedef enum

4365 {

4369  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED = 0,

4375  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED = 1,

4381  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED = 2

4382 } amd_dbgapi_watchpoint_share_kind_t;

4383 

4390 typedef enum

4391 {

4395  AMD_DBGAPI_WATCHPOINT_KIND_LOAD = 1,

4400  AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW = 2,

4404  AMD_DBGAPI_WATCHPOINT_KIND_RMW = 3,

4409  AMD_DBGAPI_WATCHPOINT_KIND_ALL = 4

4410 } amd_dbgapi_watchpoint_kind_t;

4411 

4418 typedef struct

4419 {

4420  size_t count;

4421  amd_dbgapi_watchpoint_id_t *watchpoint_ids;

4422 } amd_dbgapi_watchpoint_list_t;

4423 

4491 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_watchpoint (

4492  amd_dbgapi_process_id_t process_id, amd_dbgapi_global_address_t address,

4493  amd_dbgapi_size_t size, amd_dbgapi_watchpoint_kind_t kind,

4494  amd_dbgapi_watchpoint_id_t *watchpoint_id) AMD_DBGAPI_VERSION_0_62;

4495 

4515 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint (

4516  amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_67;

4517 

4539 typedef struct

4540 {

4541  uint64_t handle;

4542 } amd_dbgapi_register_class_id_t;

4543 

4547 #define AMD_DBGAPI_REGISTER_CLASS_NONE \

4548  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_class_id_t, 0)

4549 

4557 typedef enum

4558 {

4563  AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE = 1,

4570  AMD_DBGAPI_REGISTER_CLASS_INFO_NAME = 2

4571 } amd_dbgapi_register_class_info_t;

4572 

4611 amd_dbgapi_status_t AMD_DBGAPI

4612 amd_dbgapi_architecture_register_class_get_info (

4613  amd_dbgapi_register_class_id_t register_class_id,

4614  amd_dbgapi_register_class_info_t query, size_t value_size,

4615  void *value) AMD_DBGAPI_VERSION_0_54;

4616 

4657 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_class_list (

4658  amd_dbgapi_architecture_id_t architecture_id, size_t *register_class_count,

4659  amd_dbgapi_register_class_id_t **register_classes) AMD_DBGAPI_VERSION_0_54;

4660 

4669 typedef struct

4670 {

4671  uint64_t handle;

4672 } amd_dbgapi_register_id_t;

4673 

4677 #define AMD_DBGAPI_REGISTER_NONE \

4678  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_register_id_t, 0)

4679 

4686 typedef enum

4687 {

4691  AMD_DBGAPI_REGISTER_PROPERTY_NONE = 0,

4697  AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS = (1 << 0),

4704  AMD_DBGAPI_REGISTER_PROPERTY_VOLATILE = (1 << 1),

4711  AMD_DBGAPI_REGISTER_PROPERTY_INVALIDATE_VOLATILE = (1 << 2)

4712 } amd_dbgapi_register_properties_t;

4713 

4720 typedef enum

4721 {

4726  AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE = 1,

4733  AMD_DBGAPI_REGISTER_INFO_NAME = 2,

4738  AMD_DBGAPI_REGISTER_INFO_SIZE = 3,

4799  AMD_DBGAPI_REGISTER_INFO_TYPE = 4,

4804  AMD_DBGAPI_REGISTER_INFO_DWARF = 5,

4809  AMD_DBGAPI_REGISTER_INFO_PROPERTIES = 6

4810 } amd_dbgapi_register_info_t;

4811 

4851 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_get_info (

4852  amd_dbgapi_register_id_t register_id, amd_dbgapi_register_info_t query,

4853  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_58;

4854 

4858 typedef enum

4859 {

4863  AMD_DBGAPI_REGISTER_ABSENT = 0,

4867  AMD_DBGAPI_REGISTER_PRESENT = 1

4868 } amd_dbgapi_register_exists_t;

4869 

4903 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_exists (

4904  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

4905  amd_dbgapi_register_exists_t *exists) AMD_DBGAPI_VERSION_0_54;

4906 

4951 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_register_list (

4952  amd_dbgapi_architecture_id_t architecture_id, size_t *register_count,

4953  amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54;

4954 

4998 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_wave_register_list (

4999  amd_dbgapi_wave_id_t wave_id, size_t *register_count,

5000  amd_dbgapi_register_id_t **registers) AMD_DBGAPI_VERSION_0_54;

5001 

5038 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_dwarf_register_to_register (

5039  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_register,

5040  amd_dbgapi_register_id_t *register_id) AMD_DBGAPI_VERSION_0_54;

5041 

5045 typedef enum

5046 {

5050  AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER = 0,

5054  AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER = 1

5055 } amd_dbgapi_register_class_state_t;

5056 

5094 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_register_is_in_register_class (

5095  amd_dbgapi_register_class_id_t register_class_id,

5096  amd_dbgapi_register_id_t register_id,

5097  amd_dbgapi_register_class_state_t *register_class_state)

5098  AMD_DBGAPI_VERSION_0_54;

5099 

5156 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_register (

5157  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5158  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,

5159  void *value) AMD_DBGAPI_VERSION_0_62;

5160 

5222 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_register (

5223  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5224  amd_dbgapi_size_t offset, amd_dbgapi_size_t value_size,

5225  const void *value) AMD_DBGAPI_VERSION_0_62;

5226 

5280 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_prefetch_register (

5281  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_register_id_t register_id,

5282  amd_dbgapi_size_t register_count) AMD_DBGAPI_VERSION_0_62;

5283 

5291 typedef struct

5292 {

5293  amd_dbgapi_global_address_t target_address;

5294  amd_dbgapi_register_id_t saved_return_address_register[2];

5295 } amd_dbgapi_direct_call_register_pair_information_t;

5296 

5336 typedef uint32_t amd_dbgapi_lane_id_t;

5337 

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

5342 

5356 typedef struct

5357 {

5358  uint64_t handle;

5359 } amd_dbgapi_address_class_id_t;

5360 

5364 #define AMD_DBGAPI_ADDRESS_CLASS_NONE \

5365  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_class_id_t, 0)

5366 

5374 typedef enum

5375 {

5382  AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME = 1,

5391  AMD_DBGAPI_ADDRESS_CLASS_INFO_ADDRESS_SPACE = 2,

5396  AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF = 3

5397 } amd_dbgapi_address_class_info_t;

5398 

5438 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_class_get_info (

5439  amd_dbgapi_address_class_id_t address_class_id,

5440  amd_dbgapi_address_class_info_t query, size_t value_size,

5441  void *value) AMD_DBGAPI_VERSION_0_62;

5442 

5484 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_class_list (

5485  amd_dbgapi_architecture_id_t architecture_id, size_t *address_class_count,

5486  amd_dbgapi_address_class_id_t **address_classes) AMD_DBGAPI_VERSION_0_54;

5487 

5525 amd_dbgapi_status_t AMD_DBGAPI

5526 amd_dbgapi_dwarf_address_class_to_address_class (

5527  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_class,

5528  amd_dbgapi_address_class_id_t *address_class_id) AMD_DBGAPI_VERSION_0_54;

5529 

5541 typedef struct

5542 {

5543  uint64_t handle;

5544 } amd_dbgapi_address_space_id_t;

5545 

5549 #define AMD_DBGAPI_ADDRESS_SPACE_NONE \

5550  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 0)

5551 

5558 #define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL \

5559  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_address_space_id_t, 1)

5560 

5564 typedef enum

5565 {

5570  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL = 1,

5575  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT = 2,

5580  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT = 3

5581 } amd_dbgapi_address_space_access_t;

5582 

5590 typedef enum

5591 {

5598  AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME = 1,

5603  AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE = 2,

5608  AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS = 3,

5613  AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS = 4,

5618  AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF = 5

5619 } amd_dbgapi_address_space_info_t;

5620 

5659 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_space_get_info (

5660  amd_dbgapi_address_space_id_t address_space_id,

5661  amd_dbgapi_address_space_info_t query, size_t value_size,

5662  void *value) AMD_DBGAPI_VERSION_0_62;

5663 

5702 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_architecture_address_space_list (

5703  amd_dbgapi_architecture_id_t architecture_id, size_t *address_space_count,

5704  amd_dbgapi_address_space_id_t **address_spaces) AMD_DBGAPI_VERSION_0_54;

5705 

5744 amd_dbgapi_status_t AMD_DBGAPI

5745 amd_dbgapi_dwarf_address_space_to_address_space (

5746  amd_dbgapi_architecture_id_t architecture_id, uint64_t dwarf_address_space,

5747  amd_dbgapi_address_space_id_t *address_space_id) AMD_DBGAPI_VERSION_0_54;

5748 

5765 typedef uint64_t amd_dbgapi_segment_address_t;

5766 

5881 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_convert_address_space (

5882  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id,

5883  amd_dbgapi_address_space_id_t source_address_space_id,

5884  amd_dbgapi_segment_address_t source_segment_address,

5885  amd_dbgapi_address_space_id_t destination_address_space_id,

5886  amd_dbgapi_segment_address_t *destination_segment_address,

5887  amd_dbgapi_size_t *destination_contiguous_bytes)

5888  AMD_DBGAPI_VERSION_0_62;

5889 

5895 typedef enum

5896 {

5900  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE = 0,

5904  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_LANE = 1,

5908  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WAVE = 2,

5912  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_WORKGROUP = 3,

5916  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_AGENT = 4,

5920  AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_PROCESS = 5

5921 } amd_dbgapi_segment_address_dependency_t;

5922 

5961 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_dependency (

5962  amd_dbgapi_address_space_id_t address_space_id,

5963  amd_dbgapi_segment_address_t segment_address,

5964  amd_dbgapi_segment_address_dependency_t *segment_address_dependency)

5965  AMD_DBGAPI_VERSION_0_64;

5966 

5971 typedef enum

5972 {

5977  AMD_DBGAPI_ADDRESS_CLASS_STATE_NOT_MEMBER = 0,

5982  AMD_DBGAPI_ADDRESS_CLASS_STATE_MEMBER = 1

5983 } amd_dbgapi_address_class_state_t;

5984 

6056 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_is_in_address_class (

6057  amd_dbgapi_wave_id_t wave_id, amd_dbgapi_lane_id_t lane_id,

6058  amd_dbgapi_address_space_id_t address_space_id,

6059  amd_dbgapi_segment_address_t segment_address,

6060  amd_dbgapi_address_class_id_t address_class_id,

6061  amd_dbgapi_address_class_state_t *address_class_state)

6062  AMD_DBGAPI_VERSION_0_54;

6063 

6162 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_read_memory (

6163  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,

6164  amd_dbgapi_lane_id_t lane_id,

6165  amd_dbgapi_address_space_id_t address_space_id,

6166  amd_dbgapi_segment_address_t segment_address,

6167  amd_dbgapi_size_t *value_size, void *value) AMD_DBGAPI_VERSION_0_54;

6168 

6267 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_write_memory (

6268  amd_dbgapi_process_id_t process_id, amd_dbgapi_wave_id_t wave_id,

6269  amd_dbgapi_lane_id_t lane_id,

6270  amd_dbgapi_address_space_id_t address_space_id,

6271  amd_dbgapi_segment_address_t segment_address,

6272  amd_dbgapi_size_t *value_size, const void *value) AMD_DBGAPI_VERSION_0_54;

6273 

6292 typedef enum

6293 {

6298  AMD_DBGAPI_MEMORY_PRECISION_NONE = 0,

6303  AMD_DBGAPI_MEMORY_PRECISION_PRECISE = 1

6304 } amd_dbgapi_memory_precision_t;

6305 

6344 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_memory_precision (

6345  amd_dbgapi_process_id_t process_id,

6346  amd_dbgapi_memory_precision_t memory_precision) AMD_DBGAPI_VERSION_0_54;

6347 

6379 typedef struct

6380 {

6381  uint64_t handle;

6382 } amd_dbgapi_event_id_t;

6383 

6387 #define AMD_DBGAPI_EVENT_NONE \

6388  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_event_id_t, 0)

6389 

6393 typedef enum

6394 {

6398  AMD_DBGAPI_EVENT_KIND_NONE = 0,

6402  AMD_DBGAPI_EVENT_KIND_WAVE_STOP = 1,

6417  AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED = 2,

6439  AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED = 3,

6452  AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME = 4,

6467  AMD_DBGAPI_EVENT_KIND_RUNTIME = 5,

6501  AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR = 6

6502 } amd_dbgapi_event_kind_t;

6503 

6539 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_next_pending_event (

6540  amd_dbgapi_process_id_t process_id, amd_dbgapi_event_id_t *event_id,

6541  amd_dbgapi_event_kind_t *kind) AMD_DBGAPI_VERSION_0_54;

6542 

6546 typedef enum

6547 {

6552  AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS = 1,

6556  AMD_DBGAPI_RUNTIME_STATE_UNLOADED = 2,

6562  AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION = 3

6563 } amd_dbgapi_runtime_state_t;

6564 

6571 typedef enum

6572 {

6577  AMD_DBGAPI_EVENT_INFO_PROCESS = 1,

6582  AMD_DBGAPI_EVENT_INFO_KIND = 2,

6588  AMD_DBGAPI_EVENT_INFO_WAVE = 3,

6593  AMD_DBGAPI_EVENT_INFO_BREAKPOINT = 4,

6598  AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD = 5,

6605  AMD_DBGAPI_EVENT_INFO_RUNTIME_STATE = 6,

6610  AMD_DBGAPI_EVENT_INFO_QUEUE = 7

6611 } amd_dbgapi_event_info_t;

6612 

6652 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_get_info (

6653  amd_dbgapi_event_id_t event_id, amd_dbgapi_event_info_t query,

6654  size_t value_size, void *value) AMD_DBGAPI_VERSION_0_54;

6655 

6681 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_processed (

6682  amd_dbgapi_event_id_t event_id) AMD_DBGAPI_VERSION_0_54;

6683 

6705 typedef enum

6706 {

6710  AMD_DBGAPI_LOG_LEVEL_NONE = 0,

6715  AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR = 1,

6719  AMD_DBGAPI_LOG_LEVEL_WARNING = 2,

6723  AMD_DBGAPI_LOG_LEVEL_INFO = 3,

6727  AMD_DBGAPI_LOG_LEVEL_TRACE = 4,

6731  AMD_DBGAPI_LOG_LEVEL_VERBOSE = 5

6732 } amd_dbgapi_log_level_t;

6733 

6752 void AMD_DBGAPI amd_dbgapi_set_log_level (amd_dbgapi_log_level_t level)

6753  AMD_DBGAPI_VERSION_0_54;

6754 

6780 typedef struct

6781 {

6782  uint64_t handle;

6783 } amd_dbgapi_breakpoint_id_t;

6784 

6788 #define AMD_DBGAPI_BREAKPOINT_NONE \

6789  AMD_DBGAPI_HANDLE_LITERAL (amd_dbgapi_breakpoint_id_t, 0)

6790 

6797 typedef enum

6798 {

6803  AMD_DBGAPI_BREAKPOINT_INFO_PROCESS = 1

6804 } amd_dbgapi_breakpoint_info_t;

6805 

6844 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_breakpoint_get_info (

6845  amd_dbgapi_breakpoint_id_t breakpoint_id,

6846  amd_dbgapi_breakpoint_info_t query, size_t value_size,

6847  void *value) AMD_DBGAPI_VERSION_0_54;

6848 

6852 typedef enum

6853 {

6857  AMD_DBGAPI_BREAKPOINT_ACTION_RESUME = 1,

6861  AMD_DBGAPI_BREAKPOINT_ACTION_HALT = 2

6862 } amd_dbgapi_breakpoint_action_t;

6863 

6873 typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;

6874 

6912 amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_report_breakpoint_hit (

6913  amd_dbgapi_breakpoint_id_t breakpoint_id,

6914  amd_dbgapi_client_thread_id_t client_thread_id,

6915  amd_dbgapi_breakpoint_action_t *breakpoint_action) AMD_DBGAPI_VERSION_0_54;

6916 

6923 struct amd_dbgapi_callbacks_s

6924 {

6925 

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

6938 

6955  void (*deallocate_memory) (void *data);

6956 

6984  amd_dbgapi_status_t (*get_os_pid) (

6985  amd_dbgapi_client_process_id_t client_process_id,

6986  amd_dbgapi_os_process_id_t *os_pid);

6987 

7023  amd_dbgapi_status_t (*insert_breakpoint) (

7024  amd_dbgapi_client_process_id_t client_process_id,

7025  amd_dbgapi_global_address_t address,

7026  amd_dbgapi_breakpoint_id_t breakpoint_id);

7027 

7058  amd_dbgapi_status_t (*remove_breakpoint) (

7059  amd_dbgapi_client_process_id_t client_process_id,

7060  amd_dbgapi_breakpoint_id_t breakpoint_id);

7061 

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

7071 };

7072 

7075 #if defined(__cplusplus)

7076 } /* extern "C" */

7077 #endif /* defined (__cplusplus) */

7078 

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

AMD_DBGAPI

#define AMD_DBGAPI

Definition: amd-dbgapi.h:438

amd_dbgapi_agent_state_t

amd_dbgapi_agent_state_t

Agent state.

Definition: amd-dbgapi.h:2264

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

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

AMD_DBGAPI_AGENT_STATE_SUPPORTED

@ AMD_DBGAPI_AGENT_STATE_SUPPORTED

Agent supports debugging.

Definition: amd-dbgapi.h:2268

AMD_DBGAPI_AGENT_INFO_STATE

@ AMD_DBGAPI_AGENT_INFO_STATE

Return the agent state.

Definition: amd-dbgapi.h:2224

AMD_DBGAPI_AGENT_INFO_OS_ID

@ AMD_DBGAPI_AGENT_INFO_OS_ID

Native operating system agent ID.

Definition: amd-dbgapi.h:2257

AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID

@ AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID

PCI device ID of the agent.

Definition: amd-dbgapi.h:2242

AMD_DBGAPI_AGENT_INFO_PROCESS

@ AMD_DBGAPI_AGENT_INFO_PROCESS

Return the process to which this agent belongs.

Definition: amd-dbgapi.h:2203

AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID

@ AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID

PCI vendor ID of the agent.

Definition: amd-dbgapi.h:2238

AMD_DBGAPI_AGENT_INFO_NAME

@ AMD_DBGAPI_AGENT_INFO_NAME

Agent name.

Definition: amd-dbgapi.h:2209

AMD_DBGAPI_AGENT_INFO_ARCHITECTURE

@ AMD_DBGAPI_AGENT_INFO_ARCHITECTURE

Return the architecture of this agent.

Definition: amd-dbgapi.h:2219

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

AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN

@ AMD_DBGAPI_AGENT_INFO_PCI_DOMAIN

PCI domain the agent is in.

Definition: amd-dbgapi.h:2228

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

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

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

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

amd_dbgapi_instruction_kind_t

amd_dbgapi_instruction_kind_t

The kinds of instruction classifications.

Definition: amd-dbgapi.h:1349

amd_dbgapi_instruction_properties_t

amd_dbgapi_instruction_properties_t

A bit mask of the properties of an instruction.

Definition: amd-dbgapi.h:1465

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

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

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

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

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

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

AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION

@ AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION

Return the breakpoint instruction for the architecture.

Definition: amd-dbgapi.h:1145

AMD_DBGAPI_ARCHITECTURE_INFO_NAME

@ AMD_DBGAPI_ARCHITECTURE_INFO_NAME

Return the architecture name.

Definition: amd-dbgapi.h:1113

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

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

AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL

@ AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL

The instruction executes sequentially.

Definition: amd-dbgapi.h:1360

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

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

AMD_DBGAPI_INSTRUCTION_KIND_HALT

@ AMD_DBGAPI_INSTRUCTION_KIND_HALT

The instruction unconditionally halts the wave.

Definition: amd-dbgapi.h:1436

AMD_DBGAPI_INSTRUCTION_KIND_TRAP

@ AMD_DBGAPI_INSTRUCTION_KIND_TRAP

The instruction enters the trap handler.

Definition: amd-dbgapi.h:1431

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

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

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

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

AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE

@ AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE

The instruction terminates the wave execution.

Definition: amd-dbgapi.h:1417

AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN

@ AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN

The instruction classification is unknown.

Definition: amd-dbgapi.h:1354

AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH

@ AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH

The instruction unconditionally branches to a literal address.

Definition: amd-dbgapi.h:1366

AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE

@ AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE

The instruction has no properties.

Definition: amd-dbgapi.h:1469

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

amd_dbgapi_os_queue_id_t

uint64_t amd_dbgapi_os_queue_id_t

Native operating system queue ID.

Definition: amd-dbgapi.h:629

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

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

amd_dbgapi_os_agent_id_t

uint64_t amd_dbgapi_os_agent_id_t

Native operating system agent ID.

Definition: amd-dbgapi.h:619

amd_dbgapi_os_queue_type_t

amd_dbgapi_os_queue_type_t

Native operating system queue type.

Definition: amd-dbgapi.h:653

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

amd_dbgapi_os_process_id_t

pid_t amd_dbgapi_os_process_id_t

Native operating system process ID.

Definition: amd-dbgapi.h:580

amd_dbgapi_changed_t

amd_dbgapi_changed_t

Indication of if a value has changed.

Definition: amd-dbgapi.h:561

AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN

@ AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN

Unknown queue type.

Definition: amd-dbgapi.h:657

AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA

@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA

Queue supports the AMD SDMA protocol.

Definition: amd-dbgapi.h:669

AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4

@ AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4

Queue supports the AMD PM4 protocol.

Definition: amd-dbgapi.h:665

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

AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL

@ AMD_DBGAPI_OS_QUEUE_TYPE_HSA_AQL

Queue supports the HSA AQL protocol.

Definition: amd-dbgapi.h:661

AMD_DBGAPI_CHANGED_YES

@ AMD_DBGAPI_CHANGED_YES

The value has changed.

Definition: amd-dbgapi.h:569

AMD_DBGAPI_CHANGED_NO

@ AMD_DBGAPI_CHANGED_NO

The value has not changed.

Definition: amd-dbgapi.h:565

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

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

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

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

AMD_DBGAPI_BREAKPOINT_ACTION_RESUME

@ AMD_DBGAPI_BREAKPOINT_ACTION_RESUME

Resume execution.

Definition: amd-dbgapi.h:6857

AMD_DBGAPI_BREAKPOINT_ACTION_HALT

@ AMD_DBGAPI_BREAKPOINT_ACTION_HALT

Leave execution halted.

Definition: amd-dbgapi.h:6861

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

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

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

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

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

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

amd_dbgapi_dispatch_fence_scope_t

amd_dbgapi_dispatch_fence_scope_t

Dispatch memory fence scope.

Definition: amd-dbgapi.h:2968

AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE

@ AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE

Return the dispatch acquire fence.

Definition: amd-dbgapi.h:2839

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

AMD_DBGAPI_DISPATCH_INFO_QUEUE

@ AMD_DBGAPI_DISPATCH_INFO_QUEUE

Return the queue to which this dispatch belongs.

Definition: amd-dbgapi.h:2808

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

AMD_DBGAPI_DISPATCH_INFO_AGENT

@ AMD_DBGAPI_DISPATCH_INFO_AGENT

Return the agent to which this dispatch belongs.

Definition: amd-dbgapi.h:2813

AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS

@ AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS

Return the dispatch grid dimensionality.

Definition: amd-dbgapi.h:2849

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

AMD_DBGAPI_DISPATCH_INFO_PROCESS

@ AMD_DBGAPI_DISPATCH_INFO_PROCESS

Return the process to which this dispatch belongs.

Definition: amd-dbgapi.h:2818

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

AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE

@ AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE

Return the dispatch release fence.

Definition: amd-dbgapi.h:2844

AMD_DBGAPI_DISPATCH_INFO_BARRIER

@ AMD_DBGAPI_DISPATCH_INFO_BARRIER

Return the dispatch barrier setting.

Definition: amd-dbgapi.h:2834

AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE

@ AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE

Return the architecture of this dispatch.

Definition: amd-dbgapi.h:2823

AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS

@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS

Return the dispatch kernel descriptor address.

Definition: amd-dbgapi.h:2879

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

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

AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS

@ AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS

Return the dispatch completion event address.

Definition: amd-dbgapi.h:2894

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

AMD_DBGAPI_DISPATCH_BARRIER_NONE

@ AMD_DBGAPI_DISPATCH_BARRIER_NONE

Dispatch has no barrier.

Definition: amd-dbgapi.h:2953

AMD_DBGAPI_DISPATCH_BARRIER_PRESENT

@ AMD_DBGAPI_DISPATCH_BARRIER_PRESENT

Dispatch has a barrier.

Definition: amd-dbgapi.h:2958

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE

There is no fence.

Definition: amd-dbgapi.h:2972

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT

There is a fence with agent memory scope.

Definition: amd-dbgapi.h:2976

AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM

@ AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM

There is a fence with system memory scope.

Definition: amd-dbgapi.h:2980

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

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

Associate an active displaced stepping buffer with a wave.

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_54

Complete a displaced stepping buffer for 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:4058

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

amd_dbgapi_runtime_state_t

amd_dbgapi_runtime_state_t

Inferior's runtime state.

Definition: amd-dbgapi.h:6547

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

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

AMD_DBGAPI_EVENT_INFO_KIND

@ AMD_DBGAPI_EVENT_INFO_KIND

Return the event kind.

Definition: amd-dbgapi.h:6582

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

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

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

AMD_DBGAPI_EVENT_INFO_PROCESS

@ AMD_DBGAPI_EVENT_INFO_PROCESS

Return the process to which this event belongs.

Definition: amd-dbgapi.h:6577

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

AMD_DBGAPI_RUNTIME_STATE_UNLOADED

@ AMD_DBGAPI_RUNTIME_STATE_UNLOADED

The inferior's runtime has been unloaded.

Definition: amd-dbgapi.h:6556

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

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

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

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

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

AMD_DBGAPI_EVENT_KIND_WAVE_STOP

@ AMD_DBGAPI_EVENT_KIND_WAVE_STOP

A wave has stopped.

Definition: amd-dbgapi.h:6402

AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME

@ AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME

Request to resume a host breakpoint.

Definition: amd-dbgapi.h:6452

AMD_DBGAPI_EVENT_KIND_RUNTIME

@ AMD_DBGAPI_EVENT_KIND_RUNTIME

The runtime support in the inferior is enabled or disabled.

Definition: amd-dbgapi.h:6467

AMD_DBGAPI_EVENT_KIND_NONE

@ AMD_DBGAPI_EVENT_KIND_NONE

No event.

Definition: amd-dbgapi.h:6398

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_54

Initialize the library.

amd_dbgapi_log_level_t

amd_dbgapi_log_level_t

The logging levels supported.

Definition: amd-dbgapi.h:6706

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

AMD_DBGAPI_LOG_LEVEL_VERBOSE

@ AMD_DBGAPI_LOG_LEVEL_VERBOSE

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

Definition: amd-dbgapi.h:6731

AMD_DBGAPI_LOG_LEVEL_INFO

@ AMD_DBGAPI_LOG_LEVEL_INFO

Print fatal error, warning, and info messages.

Definition: amd-dbgapi.h:6723

AMD_DBGAPI_LOG_LEVEL_TRACE

@ AMD_DBGAPI_LOG_LEVEL_TRACE

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

Definition: amd-dbgapi.h:6727

AMD_DBGAPI_LOG_LEVEL_WARNING

@ AMD_DBGAPI_LOG_LEVEL_WARNING

Print fatal error and warning messages.

Definition: amd-dbgapi.h:6719

AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR

@ AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR

Print fatal error messages.

Definition: amd-dbgapi.h:6715

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

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

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_54

Write memory.

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_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:5765

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

amd_dbgapi_address_space_access_t

amd_dbgapi_address_space_access_t

Indication of how the address space is accessed.

Definition: amd-dbgapi.h:5565

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

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

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

AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME

@ AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME

Return the source language address class name.

Definition: amd-dbgapi.h:5382

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

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

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

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

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

AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE

@ AMD_DBGAPI_SEGMENT_ADDRESS_DEPENDENCE_NONE

No dependence is available.

Definition: amd-dbgapi.h:5900

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

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

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

AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT

@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT

The address space is read only.

Definition: amd-dbgapi.h:5575

AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL

@ AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL

The address space supports all accesses.

Definition: amd-dbgapi.h:5570

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

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

AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS

@ AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS

Return the address space access.

Definition: amd-dbgapi.h:5613

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

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

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

AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME

@ AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME

Return the address space name.

Definition: amd-dbgapi.h:5598

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

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

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_54

Set the progress required for a process.

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_56

Query information about 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_54

Set the wave creation mode for a process.

amd_dbgapi_wave_creation_t

amd_dbgapi_wave_creation_t

The kinds of wave creation supported by the hardware.

Definition: amd-dbgapi.h:1914

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

amd_dbgapi_progress_t

amd_dbgapi_progress_t

The kinds of progress supported by the library.

Definition: amd-dbgapi.h:1841

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

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_WAVE_CREATION_NORMAL

@ AMD_DBGAPI_WAVE_CREATION_NORMAL

Normal wave creation allows new waves to be created.

Definition: amd-dbgapi.h:1918

AMD_DBGAPI_WAVE_CREATION_STOP

@ AMD_DBGAPI_WAVE_CREATION_STOP

Stop wave creation prevents new waves from being created.

Definition: amd-dbgapi.h:1922

AMD_DBGAPI_PROGRESS_NO_FORWARD

@ AMD_DBGAPI_PROGRESS_NO_FORWARD

No forward progress is needed.

Definition: amd-dbgapi.h:1871

AMD_DBGAPI_PROGRESS_NORMAL

@ AMD_DBGAPI_PROGRESS_NORMAL

Normal progress is needed.

Definition: amd-dbgapi.h:1847

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

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

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

AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE

@ AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE

Return how watchpoints are shared between processes.

Definition: amd-dbgapi.h:1621

AMD_DBGAPI_PROCESS_INFO_OS_ID

@ AMD_DBGAPI_PROCESS_INFO_OS_ID

Native operating system process ID.

Definition: amd-dbgapi.h:1637

amd_dbgapi_queue_state_t

amd_dbgapi_queue_state_t

Queue state.

Definition: amd-dbgapi.h:2526

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

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

AMD_DBGAPI_QUEUE_STATE_VALID

@ AMD_DBGAPI_QUEUE_STATE_VALID

Queue is in a valid state.

Definition: amd-dbgapi.h:2530

AMD_DBGAPI_QUEUE_STATE_ERROR

@ AMD_DBGAPI_QUEUE_STATE_ERROR

Queue is in the queue error state.

Definition: amd-dbgapi.h:2544

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

AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED

@ AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED

A packet on the queue has an unsupported code.

Definition: amd-dbgapi.h:2617

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

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

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

AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR

@ AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR

There was an error preempting the queue.

Definition: amd-dbgapi.h:2638

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

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

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

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

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

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

AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION

@ AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION

A wave on the queue had an aperture violation.

Definition: amd-dbgapi.h:2601

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

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

AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE

@ AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE

Return the architecture of this queue.

Definition: amd-dbgapi.h:2445

AMD_DBGAPI_QUEUE_INFO_PROCESS

@ AMD_DBGAPI_QUEUE_INFO_PROCESS

Return the process to which this queue belongs.

Definition: amd-dbgapi.h:2440

AMD_DBGAPI_QUEUE_INFO_TYPE

@ AMD_DBGAPI_QUEUE_INFO_TYPE

Return the queue type.

Definition: amd-dbgapi.h:2450

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

AMD_DBGAPI_QUEUE_INFO_STATE

@ AMD_DBGAPI_QUEUE_INFO_STATE

Return the queue state.

Definition: amd-dbgapi.h:2455

AMD_DBGAPI_QUEUE_INFO_AGENT

@ AMD_DBGAPI_QUEUE_INFO_AGENT

Return the agent to which this queue belongs.

Definition: amd-dbgapi.h:2435

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

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

AMD_DBGAPI_QUEUE_INFO_OS_ID

@ AMD_DBGAPI_QUEUE_INFO_OS_ID

Native operating system queue ID.

Definition: amd-dbgapi.h:2477

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

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

Write a register.

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

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

Query information about a register.

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

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_exists_t

amd_dbgapi_register_exists_t

Indication of if a wave has a register.

Definition: amd-dbgapi.h:4859

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

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

AMD_DBGAPI_REGISTER_PROPERTY_NONE

@ AMD_DBGAPI_REGISTER_PROPERTY_NONE

There are no properties.

Definition: amd-dbgapi.h:4691

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

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

AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE

@ AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE

Return the architecture to which this register belongs.

Definition: amd-dbgapi.h:4726

AMD_DBGAPI_REGISTER_INFO_NAME

@ AMD_DBGAPI_REGISTER_INFO_NAME

Return the register name.

Definition: amd-dbgapi.h:4733

AMD_DBGAPI_REGISTER_INFO_SIZE

@ AMD_DBGAPI_REGISTER_INFO_SIZE

Return the size of the register in bytes.

Definition: amd-dbgapi.h:4738

AMD_DBGAPI_REGISTER_INFO_PROPERTIES

@ AMD_DBGAPI_REGISTER_INFO_PROPERTIES

Return the register's properties.

Definition: amd-dbgapi.h:4809

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

AMD_DBGAPI_REGISTER_INFO_TYPE

@ AMD_DBGAPI_REGISTER_INFO_TYPE

Return the register type as a C style type string.

Definition: amd-dbgapi.h:4799

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

AMD_DBGAPI_REGISTER_CLASS_INFO_NAME

@ AMD_DBGAPI_REGISTER_CLASS_INFO_NAME

Return the register class name.

Definition: amd-dbgapi.h:4570

AMD_DBGAPI_REGISTER_ABSENT

@ AMD_DBGAPI_REGISTER_ABSENT

The wave does not have the register.

Definition: amd-dbgapi.h:4863

AMD_DBGAPI_REGISTER_PRESENT

@ AMD_DBGAPI_REGISTER_PRESENT

The wave has the register.

Definition: amd-dbgapi.h:4867

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

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

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

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

AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID

The lane handle is invalid.

Definition: amd-dbgapi.h:865

AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID

The breakpoint handle is invalid.

Definition: amd-dbgapi.h:889

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

AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WORKGROUP_ID

The workgroup handle is invalid.

Definition: amd-dbgapi.h:910

AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE

@ AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE

No more watchpoints available.

Definition: amd-dbgapi.h:853

AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID

The wave handle is invalid.

Definition: amd-dbgapi.h:811

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

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

AMD_DBGAPI_STATUS_SUCCESS

@ AMD_DBGAPI_STATUS_SUCCESS

The function has executed successfully.

Definition: amd-dbgapi.h:694

AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED

@ AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED

The operation is not supported.

Definition: amd-dbgapi.h:734

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

AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED

@ AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED

The library is already initialized.

Definition: amd-dbgapi.h:746

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

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

AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID

The agent handle is invalid.

Definition: amd-dbgapi.h:799

AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED

@ AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED

The library is not initialized.

Definition: amd-dbgapi.h:750

AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND

@ AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND

The symbol was not found.

Definition: amd-dbgapi.h:901

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

AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID

The watchpoint handle is invalid.

Definition: amd-dbgapi.h:849

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

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

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

AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID

The architecture handle is invalid.

Definition: amd-dbgapi.h:774

AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT

@ AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT

An invalid argument was given to the function.

Definition: amd-dbgapi.h:738

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

AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID

The event handle is invalid.

Definition: amd-dbgapi.h:885

AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED

@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED

The wave is not stopped.

Definition: amd-dbgapi.h:815

AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED

@ AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED

The wave is stopped.

Definition: amd-dbgapi.h:819

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

AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID

The process handle is invalid.

Definition: amd-dbgapi.h:790

AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE

@ AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE

The wave cannot be resumed.

Definition: amd-dbgapi.h:827

AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED

@ AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED

The operation is not currently implemented.

Definition: amd-dbgapi.h:726

AMD_DBGAPI_STATUS_ERROR_RESTRICTION

@ AMD_DBGAPI_STATUS_ERROR_RESTRICTION

There is a restriction error that prevents debugging the process.

Definition: amd-dbgapi.h:766

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

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

AMD_DBGAPI_STATUS_FATAL

@ AMD_DBGAPI_STATUS_FATAL

A fatal error has occurred.

Definition: amd-dbgapi.h:720

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

AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK

@ AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK

A callback to the client reported an error.

Definition: amd-dbgapi.h:893

AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE

@ AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE

The requested information is not available.

Definition: amd-dbgapi.h:730

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

AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID

The queue handle is invalid.

Definition: amd-dbgapi.h:803

AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID

The register handle is invalid.

Definition: amd-dbgapi.h:861

AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID

@ AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID

The dispatch handle is invalid.

Definition: amd-dbgapi.h:807

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

AMD_DBGAPI_STATUS_ERROR

@ AMD_DBGAPI_STATUS_ERROR

A generic error has occurred.

Definition: amd-dbgapi.h:698

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 "AM...

Definition: amd-dbgapi.h:494

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 "AM...

Definition: amd-dbgapi.h:488

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 "AM...

Definition: amd-dbgapi.h:512

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 "AM...

Definition: amd-dbgapi.h:500

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 "AM...

Definition: amd-dbgapi.h:482

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 "AM...

Definition: amd-dbgapi.h:506

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 "AM...

Definition: amd-dbgapi.h:518

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

Set a hardware data watchpoint.

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

amd_dbgapi_watchpoint_kind_t

amd_dbgapi_watchpoint_kind_t

Watchpoint memory access kinds.

Definition: amd-dbgapi.h:4391

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_67

Remove a hardware data watchpoint previously set by amd_dbgapi_set_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:4365

AMD_DBGAPI_WATCHPOINT_INFO_PROCESS

@ AMD_DBGAPI_WATCHPOINT_INFO_PROCESS

Return the process to which this watchpoint belongs.

Definition: amd-dbgapi.h:4302

AMD_DBGAPI_WATCHPOINT_INFO_SIZE

@ AMD_DBGAPI_WATCHPOINT_INFO_SIZE

The byte size of the created watchpoint.

Definition: amd-dbgapi.h:4312

AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS

@ AMD_DBGAPI_WATCHPOINT_INFO_ADDRESS

The base address of the created watchpoint.

Definition: amd-dbgapi.h:4307

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

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

AMD_DBGAPI_WATCHPOINT_KIND_LOAD

@ AMD_DBGAPI_WATCHPOINT_KIND_LOAD

Read access by load instructions.

Definition: amd-dbgapi.h:4395

AMD_DBGAPI_WATCHPOINT_KIND_RMW

@ AMD_DBGAPI_WATCHPOINT_KIND_RMW

Read-modify-write access by atomic instructions.

Definition: amd-dbgapi.h:4404

AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED

@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED

The watchpoints are not shared across processes.

Definition: amd-dbgapi.h:4375

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

AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED

@ AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED

Watchpoints are not supported.

Definition: amd-dbgapi.h:4369

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_58

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

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

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_54

Request a wave to stop executing.

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

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

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

AMD_DBGAPI_WAVE_STATE_SINGLE_STEP

@ AMD_DBGAPI_WAVE_STATE_SINGLE_STEP

The wave is running in single-step mode.

Definition: amd-dbgapi.h:3421

AMD_DBGAPI_WAVE_STATE_RUN

@ AMD_DBGAPI_WAVE_STATE_RUN

The wave is running.

Definition: amd-dbgapi.h:3416

AMD_DBGAPI_RESUME_MODE_SINGLE_STEP

@ AMD_DBGAPI_RESUME_MODE_SINGLE_STEP

Resume execution in in single step mode.

Definition: amd-dbgapi.h:3775

AMD_DBGAPI_RESUME_MODE_NORMAL

@ AMD_DBGAPI_RESUME_MODE_NORMAL

Resume normal execution.

Definition: amd-dbgapi.h:3771

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION

@ AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION

The wave stopped due to an aperture violation.

Definition: amd-dbgapi.h:3599

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

AMD_DBGAPI_WAVE_INFO_ARCHITECTURE

@ AMD_DBGAPI_WAVE_INFO_ARCHITECTURE

Return the architecture of this wave.

Definition: amd-dbgapi.h:3313

AMD_DBGAPI_WAVE_INFO_DISPATCH

@ AMD_DBGAPI_WAVE_INFO_DISPATCH

Return the dispatch to which this wave belongs.

Definition: amd-dbgapi.h:3293

AMD_DBGAPI_WAVE_INFO_QUEUE

@ AMD_DBGAPI_WAVE_INFO_QUEUE

Return the queue to which this wave belongs.

Definition: amd-dbgapi.h:3298

AMD_DBGAPI_WAVE_INFO_EXEC_MASK

@ AMD_DBGAPI_WAVE_INFO_EXEC_MASK

Return the current execution mask of the wave.

Definition: amd-dbgapi.h:3327

AMD_DBGAPI_WAVE_INFO_WORKGROUP

@ AMD_DBGAPI_WAVE_INFO_WORKGROUP

Return the workgroup to which this wave belongs.

Definition: amd-dbgapi.h:3283

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

AMD_DBGAPI_WAVE_INFO_STATE

@ AMD_DBGAPI_WAVE_INFO_STATE

Return the wave's state.

Definition: amd-dbgapi.h:3253

AMD_DBGAPI_WAVE_INFO_PROCESS

@ AMD_DBGAPI_WAVE_INFO_PROCESS

Return the process to which this wave belongs.

Definition: amd-dbgapi.h:3308

AMD_DBGAPI_WAVE_INFO_AGENT

@ AMD_DBGAPI_WAVE_INFO_AGENT

Return the agent to which this wave belongs.

Definition: amd-dbgapi.h:3303

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

AMD_DBGAPI_WAVE_INFO_WATCHPOINTS

@ AMD_DBGAPI_WAVE_INFO_WATCHPOINTS

Return the watchpoint(s) the wave triggered.

Definition: amd-dbgapi.h:3273

AMD_DBGAPI_WAVE_INFO_LANE_COUNT

@ AMD_DBGAPI_WAVE_INFO_LANE_COUNT

The number of lanes supported by the wave.

Definition: amd-dbgapi.h:3355

AMD_DBGAPI_WAVE_INFO_PC

@ AMD_DBGAPI_WAVE_INFO_PC

Return the current program counter value of the wave.

Definition: amd-dbgapi.h:3319

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

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

AMD_DBGAPI_WORKGROUP_INFO_QUEUE

@ AMD_DBGAPI_WORKGROUP_INFO_QUEUE

Return the queue to which this workgroup belongs.

Definition: amd-dbgapi.h:3085

AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE

@ AMD_DBGAPI_WORKGROUP_INFO_ARCHITECTURE

Return the architecture of this workgroup.

Definition: amd-dbgapi.h:3100

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

AMD_DBGAPI_WORKGROUP_INFO_DISPATCH

@ AMD_DBGAPI_WORKGROUP_INFO_DISPATCH

Return the dispatch to which this workgroup belongs.

Definition: amd-dbgapi.h:3080

AMD_DBGAPI_WORKGROUP_INFO_PROCESS

@ AMD_DBGAPI_WORKGROUP_INFO_PROCESS

Return the process to which this workgroup belongs.

Definition: amd-dbgapi.h:3095

AMD_DBGAPI_WORKGROUP_INFO_AGENT

@ AMD_DBGAPI_WORKGROUP_INFO_AGENT

Return the agent to which this workgroup belongs.

Definition: amd-dbgapi.h:3090

amd_dbgapi_address_class_id_t

Opaque source language address class handle.

Definition: amd-dbgapi.h:5357

amd_dbgapi_address_class_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:5358

amd_dbgapi_address_space_id_t

Opaque address space handle.

Definition: amd-dbgapi.h:5542

amd_dbgapi_address_space_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:5543

amd_dbgapi_agent_id_t

Opaque agent handle.

Definition: amd-dbgapi.h:2181

amd_dbgapi_agent_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2182

amd_dbgapi_architecture_id_t

Opaque architecture handle.

Definition: amd-dbgapi.h:1088

amd_dbgapi_architecture_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:1089

amd_dbgapi_breakpoint_id_t

Opaque breakpoint handle.

Definition: amd-dbgapi.h:6781

amd_dbgapi_breakpoint_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:6782

amd_dbgapi_callbacks_s

Callbacks that the client of the library must provide.

Definition: amd-dbgapi.h:6924

amd_dbgapi_callbacks_s::get_os_pid

amd_dbgapi_status_t(* get_os_pid)(amd_dbgapi_client_process_id_t client_process_id, amd_dbgapi_os_process_id_t *os_pid)

Return the native operating system process handle for the process identified by the client process ha...

Definition: amd-dbgapi.h:6984

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

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

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

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

amd_dbgapi_code_object_id_t

Opaque code object handle.

Definition: amd-dbgapi.h:1980

amd_dbgapi_code_object_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:1981

amd_dbgapi_direct_call_register_pair_information_t

Instruction information for direct call instructions.

Definition: amd-dbgapi.h:5292

amd_dbgapi_direct_call_register_pair_information_t::target_address

amd_dbgapi_global_address_t target_address

Definition: amd-dbgapi.h:5293

amd_dbgapi_dispatch_id_t

Opaque dispatch handle.

Definition: amd-dbgapi.h:2786

amd_dbgapi_dispatch_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2787

amd_dbgapi_displaced_stepping_id_t

Opaque displaced stepping handle.

Definition: amd-dbgapi.h:4035

amd_dbgapi_displaced_stepping_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4036

amd_dbgapi_event_id_t

Opaque event handle.

Definition: amd-dbgapi.h:6380

amd_dbgapi_event_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:6381

amd_dbgapi_process_id_t

Opaque process handle.

Definition: amd-dbgapi.h:1587

amd_dbgapi_process_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:1588

amd_dbgapi_queue_id_t

Opaque queue handle.

Definition: amd-dbgapi.h:2413

amd_dbgapi_queue_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:2414

amd_dbgapi_register_class_id_t

Opaque register class handle.

Definition: amd-dbgapi.h:4540

amd_dbgapi_register_class_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4541

amd_dbgapi_register_id_t

Opaque register handle.

Definition: amd-dbgapi.h:4670

amd_dbgapi_register_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4671

amd_dbgapi_watchpoint_id_t

Opaque hardware data watchpoint handle.

Definition: amd-dbgapi.h:4280

amd_dbgapi_watchpoint_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:4281

amd_dbgapi_watchpoint_list_t

A set of watchpoints.

Definition: amd-dbgapi.h:4419

amd_dbgapi_watchpoint_list_t::watchpoint_ids

amd_dbgapi_watchpoint_id_t * watchpoint_ids

Definition: amd-dbgapi.h:4421

amd_dbgapi_watchpoint_list_t::count

size_t count

Definition: amd-dbgapi.h:4420

amd_dbgapi_wave_id_t

Opaque wave handle.

Definition: amd-dbgapi.h:3231

amd_dbgapi_wave_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:3232

amd_dbgapi_workgroup_id_t

Opaque workgroup handle.

Definition: amd-dbgapi.h:3053

amd_dbgapi_workgroup_id_t::handle

uint64_t handle

Definition: amd-dbgapi.h:3054