amd-dbgapi.h

Go to the documentation of this file.

/* Copyright (c) 2019-2021 Advanced Micro Devices, Inc.

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:

 The above copyright notice and this permission notice shall be included in
 all copies or substantial portions of the Software.

 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE. */

#ifndef AMD_DBGAPI_H
#define AMD_DBGAPI_H 1

/* Placeholder for calling convention and import/export macros */
#if !defined(AMD_DBGAPI_CALL)
#define AMD_DBGAPI_CALL
#endif /* !defined (AMD_DBGAPI_CALL) */

#if !defined(AMD_DBGAPI_EXPORT_DECORATOR)
#if defined(__GNUC__)
#define AMD_DBGAPI_EXPORT_DECORATOR __attribute__ ((visibility ("default")))
#elif defined(_MSC_VER)
#define AMD_DBGAPI_EXPORT_DECORATOR __declspec(dllexport)
#endif /* defined (_MSC_VER) */
#endif /* !defined (AMD_DBGAPI_EXPORT_DECORATOR) */

#if !defined(AMD_DBGAPI_IMPORT_DECORATOR)
#if defined(__GNUC__)
#define AMD_DBGAPI_IMPORT_DECORATOR
#elif defined(_MSC_VER)
#define AMD_DBGAPI_IMPORT_DECORATOR __declspec(dllimport)
#endif /* defined (_MSC_VER) */
#endif /* !defined (AMD_DBGAPI_IMPORT_DECORATOR) */

#define AMD_DBGAPI_EXPORT AMD_DBGAPI_EXPORT_DECORATOR AMD_DBGAPI_CALL
#define AMD_DBGAPI_IMPORT AMD_DBGAPI_IMPORT_DECORATOR AMD_DBGAPI_CALL

#if !defined(AMD_DBGAPI)
#if defined(AMD_DBGAPI_EXPORTS)
#define AMD_DBGAPI AMD_DBGAPI_EXPORT
#else /* !defined (AMD_DBGAPI_EXPORTS) */
#define AMD_DBGAPI AMD_DBGAPI_IMPORT
#endif /* !defined (AMD_DBGAPI_EXPORTS) */
#endif /* !defined (AMD_DBGAPI) */

#if defined(__cplusplus)
extern "C" {
#endif /* defined (__cplusplus) */

#if defined(__linux__)
#include <sys/types.h>
#endif /* __linux__ */

#include <stddef.h>
#include <stdint.h>

#define AMD_DBGAPI_VERSION_0_54

#define AMD_DBGAPI_VERSION_0_56

typedef struct amd_dbgapi_callbacks_s amd_dbgapi_callbacks_t;

typedef uint64_t amd_dbgapi_global_address_t;

typedef uint64_t amd_dbgapi_size_t;

typedef enum
{
  AMD_DBGAPI_CHANGED_NO = 0,
  AMD_DBGAPI_CHANGED_YES = 1
} amd_dbgapi_changed_t;

#if defined(__linux__)
typedef pid_t amd_dbgapi_os_process_id_t;
#endif /* __linux__ */

#if defined(__linux__)
typedef int amd_dbgapi_notifier_t;
#endif /* __linux__ */

#if defined(__linux__)
typedef uint64_t amd_dbgapi_os_agent_id_t;
#endif /* __linux__ */

#if defined(__linux__)
typedef uint64_t amd_dbgapi_os_queue_id_t;
#endif /* __linux__ */

#if defined(__linux__)
typedef uint64_t amd_dbgapi_os_queue_packet_id_t;
#endif /* __linux__ */

#if defined(__linux__)
typedef enum
{
  AMD_DBGAPI_OS_QUEUE_TYPE_UNKNOWN = 0,
  AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_MULTIPLE_PRODUCER = 1,
  AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_SINGLE_PRODUCER = 2,
  AMD_DBGAPI_OS_QUEUE_TYPE_HSA_KERNEL_DISPATCH_COOPERATIVE = 3,
  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_PM4 = 257,
  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA = 513,
  AMD_DBGAPI_OS_QUEUE_TYPE_AMD_SDMA_XGMI = 514
} amd_dbgapi_os_queue_type_t;
#endif /* __linux__ */

typedef enum
{
  AMD_DBGAPI_STATUS_SUCCESS = 0,
  AMD_DBGAPI_STATUS_ERROR = -1,
  AMD_DBGAPI_STATUS_FATAL = -2,
  AMD_DBGAPI_STATUS_ERROR_NOT_IMPLEMENTED = -3,
  AMD_DBGAPI_STATUS_ERROR_NOT_AVAILABLE = -4,
  AMD_DBGAPI_STATUS_ERROR_NOT_SUPPORTED = -5,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT = -6,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ARGUMENT_COMPATIBILITY = -7,
  AMD_DBGAPI_STATUS_ERROR_ALREADY_INITIALIZED = -8,
  AMD_DBGAPI_STATUS_ERROR_NOT_INITIALIZED = -9,
  AMD_DBGAPI_STATUS_ERROR_RESTRICTION = -10,
  AMD_DBGAPI_STATUS_ERROR_ALREADY_ATTACHED = -11,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ARCHITECTURE_ID = -12,
  AMD_DBGAPI_STATUS_ERROR_ILLEGAL_INSTRUCTION = -13,
  AMD_DBGAPI_STATUS_ERROR_INVALID_CODE_OBJECT_ID = -14,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ELF_AMDGPU_MACHINE = -15,
  AMD_DBGAPI_STATUS_ERROR_INVALID_PROCESS_ID = -16,
  AMD_DBGAPI_STATUS_ERROR_PROCESS_EXITED = -17,
  AMD_DBGAPI_STATUS_ERROR_INVALID_AGENT_ID = -18,
  AMD_DBGAPI_STATUS_ERROR_INVALID_QUEUE_ID = -19,
  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPATCH_ID = -20,
  AMD_DBGAPI_STATUS_ERROR_INVALID_WAVE_ID = -21,
  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_STOPPED = -22,
  AMD_DBGAPI_STATUS_ERROR_WAVE_STOPPED = -23,
  AMD_DBGAPI_STATUS_ERROR_WAVE_OUTSTANDING_STOP = -24,
  AMD_DBGAPI_STATUS_ERROR_WAVE_NOT_RESUMABLE = -25,
  AMD_DBGAPI_STATUS_ERROR_INVALID_DISPLACED_STEPPING_ID = -26,
  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_BUFFER_NOT_AVAILABLE = -27,
  AMD_DBGAPI_STATUS_ERROR_DISPLACED_STEPPING_ACTIVE = -28,
  AMD_DBGAPI_STATUS_ERROR_RESUME_DISPLACED_STEPPING = -29,
  AMD_DBGAPI_STATUS_ERROR_INVALID_WATCHPOINT_ID = -30,
  AMD_DBGAPI_STATUS_ERROR_NO_WATCHPOINT_AVAILABLE = -31,
  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_CLASS_ID = -32,
  AMD_DBGAPI_STATUS_ERROR_INVALID_REGISTER_ID = -33,
  AMD_DBGAPI_STATUS_ERROR_INVALID_LANE_ID = -34,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_CLASS_ID = -35,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_ID = -36,
  AMD_DBGAPI_STATUS_ERROR_MEMORY_ACCESS = -37,
  AMD_DBGAPI_STATUS_ERROR_INVALID_ADDRESS_SPACE_CONVERSION = -38,
  AMD_DBGAPI_STATUS_ERROR_INVALID_EVENT_ID = -39,
  AMD_DBGAPI_STATUS_ERROR_INVALID_BREAKPOINT_ID = -40,
  AMD_DBGAPI_STATUS_ERROR_CLIENT_CALLBACK = -41,
  AMD_DBGAPI_STATUS_ERROR_INVALID_CLIENT_PROCESS_ID = -42,
  AMD_DBGAPI_STATUS_ERROR_SYMBOL_NOT_FOUND = -43
} amd_dbgapi_status_t;

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;

#define AMD_DBGAPI_VERSION_MAJOR 0

#define AMD_DBGAPI_VERSION_MINOR 56

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

const char AMD_DBGAPI *
amd_dbgapi_get_build_name (void) AMD_DBGAPI_VERSION_0_54;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_initialize (
    amd_dbgapi_callbacks_t *callbacks) AMD_DBGAPI_VERSION_0_54;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_finalize (void)
    AMD_DBGAPI_VERSION_0_54;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_architecture_id_t;

#define AMD_DBGAPI_ARCHITECTURE_NONE ((amd_dbgapi_architecture_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_ARCHITECTURE_INFO_NAME = 1,
  AMD_DBGAPI_ARCHITECTURE_INFO_ELF_AMDGPU_MACHINE = 2,
  AMD_DBGAPI_ARCHITECTURE_INFO_LARGEST_INSTRUCTION_SIZE = 3,
  AMD_DBGAPI_ARCHITECTURE_INFO_MINIMUM_INSTRUCTION_ALIGNMENT = 4,
  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_SIZE = 5,
  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION = 6,
  AMD_DBGAPI_ARCHITECTURE_INFO_BREAKPOINT_INSTRUCTION_PC_ADJUST = 7,
  AMD_DBGAPI_ARCHITECTURE_INFO_PC_REGISTER = 8
} amd_dbgapi_architecture_info_t;

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;

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;

typedef struct amd_dbgapi_symbolizer_id_s *amd_dbgapi_symbolizer_id_t;

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;

typedef enum
{
  AMD_DBGAPI_INSTRUCTION_KIND_UNKNOWN = 0,
  AMD_DBGAPI_INSTRUCTION_KIND_SEQUENTIAL = 1,
  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH = 2,
  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_BRANCH_CONDITIONAL = 3,
  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_REGISTER_PAIR = 4,
  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_BRANCH_CONDITIONAL_REGISTER_PAIR = 5,
  AMD_DBGAPI_INSTRUCTION_KIND_DIRECT_CALL_REGISTER_PAIR = 6,
  AMD_DBGAPI_INSTRUCTION_KIND_INDIRECT_CALL_REGISTER_PAIRS = 7,
  AMD_DBGAPI_INSTRUCTION_KIND_TERMINATE = 8,
  AMD_DBGAPI_INSTRUCTION_KIND_TRAP = 9,
  AMD_DBGAPI_INSTRUCTION_KIND_HALT = 10,
  AMD_DBGAPI_INSTRUCTION_KIND_BARRIER = 11,
  AMD_DBGAPI_INSTRUCTION_KIND_SLEEP = 12,
  AMD_DBGAPI_INSTRUCTION_KIND_SPECIAL = 13
} amd_dbgapi_instruction_kind_t;

typedef enum
{
  AMD_DBGAPI_INSTRUCTION_PROPERTY_NONE = 0ULL,
  AMD_DBGAPI_INSTRUCTION_PROPERTY_RESERVED = (1ULL << 63)
} amd_dbgapi_instruction_properties_t;

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

typedef struct amd_dbgapi_client_process_s *amd_dbgapi_client_process_id_t;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_process_id_t;

#define AMD_DBGAPI_PROCESS_NONE ((amd_dbgapi_process_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_PROCESS_INFO_NOTIFIER = 1,
  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_COUNT = 2,
  AMD_DBGAPI_PROCESS_INFO_WATCHPOINT_SHARE = 3,
  AMD_DBGAPI_PROCESS_INFO_PRECISE_MEMORY_SUPPORTED = 4,
  AMD_DBGAPI_PROCESS_INFO_OS_ID = 5
} amd_dbgapi_process_info_t;

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;

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;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_process_detach (
    amd_dbgapi_process_id_t process_id) AMD_DBGAPI_VERSION_0_54;

typedef enum
{
  AMD_DBGAPI_PROGRESS_NORMAL = 0,
  AMD_DBGAPI_PROGRESS_NO_FORWARD = 1
} amd_dbgapi_progress_t;

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;

typedef enum
{
  AMD_DBGAPI_WAVE_CREATION_NORMAL = 0,
  AMD_DBGAPI_WAVE_CREATION_STOP = 1
} amd_dbgapi_wave_creation_t;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_code_object_id_t;

#define AMD_DBGAPI_CODE_OBJECT_NONE ((amd_dbgapi_code_object_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_CODE_OBJECT_INFO_PROCESS = 1,
  AMD_DBGAPI_CODE_OBJECT_INFO_URI_NAME = 2,
  AMD_DBGAPI_CODE_OBJECT_INFO_LOAD_ADDRESS = 3
} amd_dbgapi_code_object_info_t;

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;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_agent_id_t;

#define AMD_DBGAPI_AGENT_NONE ((amd_dbgapi_agent_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_AGENT_INFO_PROCESS = 1,
  AMD_DBGAPI_AGENT_INFO_NAME = 2,
  AMD_DBGAPI_AGENT_INFO_ARCHITECTURE = 3,
  AMD_DBGAPI_AGENT_INFO_STATE = 4,
  AMD_DBGAPI_AGENT_INFO_PCI_SLOT = 5,
  AMD_DBGAPI_AGENT_INFO_PCI_VENDOR_ID = 6,
  AMD_DBGAPI_AGENT_INFO_PCI_DEVICE_ID = 7,
  AMD_DBGAPI_AGENT_INFO_EXECUTION_UNIT_COUNT = 8,
  AMD_DBGAPI_AGENT_INFO_MAX_WAVES_PER_EXECUTION_UNIT = 9,
  AMD_DBGAPI_AGENT_INFO_OS_ID = 10
} amd_dbgapi_agent_info_t;

typedef enum
{
  AMD_DBGAPI_AGENT_STATE_SUPPORTED = 1,
  AMD_DBGAPI_AGENT_STATE_NOT_SUPPORTED = 2
} amd_dbgapi_agent_state_t;

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_56;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_queue_id_t;

#define AMD_DBGAPI_QUEUE_NONE ((amd_dbgapi_queue_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_QUEUE_INFO_AGENT = 1,
  AMD_DBGAPI_QUEUE_INFO_PROCESS = 2,
  AMD_DBGAPI_QUEUE_INFO_ARCHITECTURE = 3,
  AMD_DBGAPI_QUEUE_INFO_TYPE = 4,
  AMD_DBGAPI_QUEUE_INFO_STATE = 5,
  AMD_DBGAPI_QUEUE_INFO_ERROR_REASON = 6,
  AMD_DBGAPI_QUEUE_INFO_ADDRESS = 7,
  AMD_DBGAPI_QUEUE_INFO_SIZE = 8,
  AMD_DBGAPI_QUEUE_INFO_OS_ID = 9
} amd_dbgapi_queue_info_t;

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_56;

typedef enum
{
  AMD_DBGAPI_QUEUE_STATE_VALID = 1,
  AMD_DBGAPI_QUEUE_STATE_ERROR = 2
} amd_dbgapi_queue_state_t;

typedef enum
{
  AMD_DBGAPI_EXCEPTION_NONE = 0ULL,
  AMD_DBGAPI_EXCEPTION_WAVE_ABORT = (1ULL << 0),
  AMD_DBGAPI_EXCEPTION_WAVE_TRAP = (1ULL << 1),
  AMD_DBGAPI_EXCEPTION_WAVE_MATH_ERROR = (1ULL << 2),
  AMD_DBGAPI_EXCEPTION_WAVE_ILLEGAL_INSTRUCTION = (1ULL << 3),
  AMD_DBGAPI_EXCEPTION_WAVE_MEMORY_VIOLATION = (1ULL << 4),
  AMD_DBGAPI_EXCEPTION_WAVE_APERTURE_VIOLATION = (1ULL << 5),
  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_DIM_INVALID = (1ULL << 16),
  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_GROUP_SEGMENT_SIZE_INVALID = (1ULL << 17),
  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_CODE_INVALID = (1ULL << 18),
  AMD_DBGAPI_EXCEPTION_PACKET_UNSUPPORTED = (1ULL << 20),
  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_WORK_GROUP_SIZE_INVALID = (1ULL << 21),
  AMD_DBGAPI_EXCEPTION_PACKET_DISPATCH_REGISTER_COUNT_TOO_LARGE = (1ULL << 22),
  AMD_DBGAPI_EXCEPTION_PACKET_VENDOR_UNSUPPORTED = (1ULL << 23),
  AMD_DBGAPI_EXCEPTION_QUEUE_PREEMPTION_ERROR = (1ULL << 31),
  AMD_DBGAPI_EXCEPTION_RESERVED = (1ULL << 63)
} amd_dbgapi_exceptions_t;

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;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_dispatch_id_t;

#define AMD_DBGAPI_DISPATCH_NONE ((amd_dbgapi_dispatch_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_DISPATCH_INFO_QUEUE = 1,
  AMD_DBGAPI_DISPATCH_INFO_AGENT = 2,
  AMD_DBGAPI_DISPATCH_INFO_PROCESS = 3,
  AMD_DBGAPI_DISPATCH_INFO_ARCHITECTURE = 4,
  AMD_DBGAPI_DISPATCH_INFO_OS_QUEUE_PACKET_ID = 5,
  AMD_DBGAPI_DISPATCH_INFO_BARRIER = 6,
  AMD_DBGAPI_DISPATCH_INFO_ACQUIRE_FENCE = 7,
  AMD_DBGAPI_DISPATCH_INFO_RELEASE_FENCE = 8,
  AMD_DBGAPI_DISPATCH_INFO_GRID_DIMENSIONS = 9,
  AMD_DBGAPI_DISPATCH_INFO_WORK_GROUP_SIZES = 10,
  AMD_DBGAPI_DISPATCH_INFO_GRID_SIZES = 11,
  AMD_DBGAPI_DISPATCH_INFO_PRIVATE_SEGMENT_SIZE = 12,
  AMD_DBGAPI_DISPATCH_INFO_GROUP_SEGMENT_SIZE = 13,
  AMD_DBGAPI_DISPATCH_INFO_KERNEL_ARGUMENT_SEGMENT_ADDRESS = 14,
  AMD_DBGAPI_DISPATCH_INFO_KERNEL_DESCRIPTOR_ADDRESS = 15,
  AMD_DBGAPI_DISPATCH_INFO_KERNEL_CODE_ENTRY_ADDRESS = 16,
  AMD_DBGAPI_DISPATCH_INFO_KERNEL_COMPLETION_ADDRESS = 17
} amd_dbgapi_dispatch_info_t;

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;

typedef enum
{
  AMD_DBGAPI_DISPATCH_BARRIER_NONE = 0,
  AMD_DBGAPI_DISPATCH_BARRIER_PRESENT = 1
} amd_dbgapi_dispatch_barrier_t;

typedef enum
{
  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_NONE = 0,
  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_AGENT = 1,
  AMD_DBGAPI_DISPATCH_FENCE_SCOPE_SYSTEM = 2
} amd_dbgapi_dispatch_fence_scope_t;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_wave_id_t;

#define AMD_DBGAPI_WAVE_NONE ((amd_dbgapi_wave_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_WAVE_INFO_STATE = 1,
  AMD_DBGAPI_WAVE_INFO_STOP_REASON = 2,
  AMD_DBGAPI_WAVE_INFO_WATCHPOINTS = 3,
  AMD_DBGAPI_WAVE_INFO_DISPATCH = 4,
  AMD_DBGAPI_WAVE_INFO_QUEUE = 5,
  AMD_DBGAPI_WAVE_INFO_AGENT = 6,
  AMD_DBGAPI_WAVE_INFO_PROCESS = 7,
  AMD_DBGAPI_WAVE_INFO_ARCHITECTURE = 8,
  AMD_DBGAPI_WAVE_INFO_PC = 9,
  AMD_DBGAPI_WAVE_INFO_EXEC_MASK = 10,
  AMD_DBGAPI_WAVE_INFO_WORK_GROUP_COORD = 11,
  AMD_DBGAPI_WAVE_INFO_WAVE_NUMBER_IN_WORK_GROUP = 12,
  AMD_DBGAPI_WAVE_INFO_LANE_COUNT = 13
} amd_dbgapi_wave_info_t;

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

typedef enum
{
  AMD_DBGAPI_WAVE_STATE_RUN = 1,
  AMD_DBGAPI_WAVE_STATE_SINGLE_STEP = 2,
  AMD_DBGAPI_WAVE_STATE_STOP = 3
} amd_dbgapi_wave_state_t;

typedef enum
{
  AMD_DBGAPI_WAVE_STOP_REASON_NONE = 0ULL,
  AMD_DBGAPI_WAVE_STOP_REASON_BREAKPOINT = (1ULL << 0),
  AMD_DBGAPI_WAVE_STOP_REASON_WATCHPOINT = (1ULL << 1),
  AMD_DBGAPI_WAVE_STOP_REASON_SINGLE_STEP = (1ULL << 2),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_INPUT_DENORMAL = (1ULL << 3),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_DIVIDE_BY_0 = (1ULL << 4),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_OVERFLOW = (1ULL << 5),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_UNDERFLOW = (1ULL << 6),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_INEXACT = (1ULL << 7),
  AMD_DBGAPI_WAVE_STOP_REASON_FP_INVALID_OPERATION = (1ULL << 8),
  AMD_DBGAPI_WAVE_STOP_REASON_INT_DIVIDE_BY_0 = (1ULL << 9),
  AMD_DBGAPI_WAVE_STOP_REASON_DEBUG_TRAP = (1ULL << 10),
  AMD_DBGAPI_WAVE_STOP_REASON_ASSERT_TRAP = (1ULL << 11),
  AMD_DBGAPI_WAVE_STOP_REASON_TRAP = (1ULL << 12),
  AMD_DBGAPI_WAVE_STOP_REASON_MEMORY_VIOLATION = (1ULL << 13),
  AMD_DBGAPI_WAVE_STOP_REASON_APERTURE_VIOLATION = (1ULL << 14),
  AMD_DBGAPI_WAVE_STOP_REASON_ILLEGAL_INSTRUCTION = (1ULL << 15),
  AMD_DBGAPI_WAVE_STOP_REASON_ECC_ERROR = (1ULL << 16),
  AMD_DBGAPI_WAVE_STOP_REASON_FATAL_HALT = (1ULL << 17),
  AMD_DBGAPI_WAVE_STOP_REASON_RESERVED = (1ULL << 63)
} amd_dbgapi_wave_stop_reasons_t;

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;

amd_dbgapi_status_t AMD_DBGAPI
amd_dbgapi_wave_stop (amd_dbgapi_wave_id_t wave_id) AMD_DBGAPI_VERSION_0_54;

typedef enum
{
  AMD_DBGAPI_RESUME_MODE_NORMAL = 0,
  AMD_DBGAPI_RESUME_MODE_SINGLE_STEP = 1
} amd_dbgapi_resume_mode_t;

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

typedef struct
{
  uint64_t handle;
} amd_dbgapi_displaced_stepping_id_t;

#define AMD_DBGAPI_DISPLACED_STEPPING_NONE                                    \
  (amd_dbgapi_displaced_stepping_id_t{ 0 })

typedef enum
{
  AMD_DBGAPI_DISPLACED_STEPPING_INFO_PROCESS = 1
} amd_dbgapi_displaced_stepping_info_t;

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;

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;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_watchpoint_id_t;

#define AMD_DBGAPI_WATCHPOINT_NONE ((amd_dbgapi_watchpoint_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_WATCHPOINT_INFO_PROCESS = 1
} amd_dbgapi_watchpoint_info_t;

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;

typedef enum
{
  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSUPPORTED = 0,
  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_UNSHARED = 1,
  AMD_DBGAPI_WATCHPOINT_SHARE_KIND_SHARED = 2
} amd_dbgapi_watchpoint_share_kind_t;

typedef enum
{
  AMD_DBGAPI_WATCHPOINT_KIND_LOAD = 1,
  AMD_DBGAPI_WATCHPOINT_KIND_STORE_AND_RMW = 2,
  AMD_DBGAPI_WATCHPOINT_KIND_RMW = 3,
  AMD_DBGAPI_WATCHPOINT_KIND_ALL = 4
} amd_dbgapi_watchpoint_kind_t;

typedef struct
{
  size_t count;
  amd_dbgapi_watchpoint_id_t *watchpoint_ids;
} amd_dbgapi_watchpoint_list_t;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_set_watchpoint (
    amd_dbgapi_process_id_t process_id, amd_dbgapi_global_address_t address,
    amd_dbgapi_size_t size, amd_dbgapi_watchpoint_kind_t kind,
    amd_dbgapi_watchpoint_id_t *watchpoint_id,
    amd_dbgapi_global_address_t *watchpoint_address,
    amd_dbgapi_size_t *watchpoint_size) AMD_DBGAPI_VERSION_0_54;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_remove_watchpoint (
    amd_dbgapi_process_id_t process_id,
    amd_dbgapi_watchpoint_id_t watchpoint_id) AMD_DBGAPI_VERSION_0_54;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_register_class_id_t;

#define AMD_DBGAPI_REGISTER_CLASS_NONE ((amd_dbgapi_register_class_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_REGISTER_CLASS_INFO_ARCHITECTURE = 1,
  AMD_DBGAPI_REGISTER_CLASS_INFO_NAME = 2
} amd_dbgapi_register_class_info_t;

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;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_register_id_t;

#define AMD_DBGAPI_REGISTER_NONE ((amd_dbgapi_register_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_REGISTER_PROPERTY_NONE = 0ULL,
  AMD_DBGAPI_REGISTER_PROPERTY_READONLY_BITS = (1ULL << 0),
  AMD_DBGAPI_REGISTER_PROPERTY_VOLATILE = (1ULL << 1),
  AMD_DBGAPI_REGISTER_PROPERTY_INVALIDATE_VOLATILE = (1ULL << 2),
  AMD_DBGAPI_REGISTER_PROPERTY_RESERVED = (1ULL << 63)
} amd_dbgapi_register_properties_t;

typedef enum
{
  AMD_DBGAPI_REGISTER_INFO_ARCHITECTURE = 1,
  AMD_DBGAPI_REGISTER_INFO_NAME = 2,
  AMD_DBGAPI_REGISTER_INFO_SIZE = 3,
  AMD_DBGAPI_REGISTER_INFO_TYPE = 4,
  AMD_DBGAPI_REGISTER_INFO_DWARF = 5,
  AMD_DBGAPI_REGISTER_INFO_PROPERTIES = 6
} amd_dbgapi_register_info_t;

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_56;

typedef enum
{
  AMD_DBGAPI_REGISTER_ABSENT = 0,
  AMD_DBGAPI_REGISTER_PRESENT = 1
} amd_dbgapi_register_exists_t;

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;

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;

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;

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;

typedef enum
{
  AMD_DBGAPI_REGISTER_CLASS_STATE_NOT_MEMBER = 0,
  AMD_DBGAPI_REGISTER_CLASS_STATE_MEMBER = 1
} amd_dbgapi_register_class_state_t;

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;

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

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

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

typedef struct
{
  amd_dbgapi_global_address_t target_address;
  amd_dbgapi_register_id_t saved_return_address_register[2];
} amd_dbgapi_direct_call_register_pair_information_t;

typedef uint32_t amd_dbgapi_lane_id_t;

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

typedef struct
{
  uint64_t handle;
} amd_dbgapi_address_class_id_t;

#define AMD_DBGAPI_ADDRESS_CLASS_NONE ((amd_dbgapi_address_class_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_ADDRESS_CLASS_INFO_ARCHITECTURE = 1,
  AMD_DBGAPI_ADDRESS_CLASS_INFO_NAME = 2,
  AMD_DBGAPI_ADDRESS_CLASS_INFO_ADDRESS_SPACE = 3,
  AMD_DBGAPI_ADDRESS_CLASS_INFO_DWARF = 4
} amd_dbgapi_address_class_info_t;

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

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;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_address_space_id_t;

#define AMD_DBGAPI_ADDRESS_SPACE_NONE ((amd_dbgapi_address_space_id_t){ 0 })

#define AMD_DBGAPI_ADDRESS_SPACE_GLOBAL ((amd_dbgapi_address_space_id_t){ 1 })

typedef enum
{
  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_ALL = 1,
  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_PROGRAM_CONSTANT = 2,
  AMD_DBGAPI_ADDRESS_SPACE_ACCESS_DISPATCH_CONSTANT = 3
} amd_dbgapi_address_space_access_t;

typedef enum
{
  AMD_DBGAPI_ADDRESS_SPACE_INFO_ARCHITECTURE = 1,
  AMD_DBGAPI_ADDRESS_SPACE_INFO_NAME = 2,
  AMD_DBGAPI_ADDRESS_SPACE_INFO_ADDRESS_SIZE = 3,
  AMD_DBGAPI_ADDRESS_SPACE_INFO_NULL_ADDRESS = 4,
  AMD_DBGAPI_ADDRESS_SPACE_INFO_ACCESS = 5,
  AMD_DBGAPI_ADDRESS_SPACE_INFO_DWARF = 6
} amd_dbgapi_address_space_info_t;

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

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;

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;

typedef enum
{
  AMD_DBGAPI_ADDRESS_SPACE_ALIAS_NONE = 0,
  AMD_DBGAPI_ADDRESS_SPACE_ALIAS_MAY = 1
} amd_dbgapi_address_space_alias_t;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_address_spaces_may_alias (
    amd_dbgapi_address_space_id_t address_space_id1,
    amd_dbgapi_address_space_id_t address_space_id2,
    amd_dbgapi_address_space_alias_t *address_space_alias)
    AMD_DBGAPI_VERSION_0_54;

typedef uint64_t amd_dbgapi_segment_address_t;

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_VERSION_0_54;

typedef enum
{
  AMD_DBGAPI_ADDRESS_CLASS_STATE_NOT_MEMBER = 0,
  AMD_DBGAPI_ADDRESS_CLASS_STATE_MEMBER = 1
} amd_dbgapi_address_class_state_t;

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;

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;

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;

typedef enum
{
  AMD_DBGAPI_MEMORY_PRECISION_NONE = 0,
  AMD_DBGAPI_MEMORY_PRECISION_PRECISE = 1
} amd_dbgapi_memory_precision_t;

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;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_event_id_t;

#define AMD_DBGAPI_EVENT_NONE ((amd_dbgapi_event_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_EVENT_KIND_NONE = 0,
  AMD_DBGAPI_EVENT_KIND_WAVE_STOP = 1,
  AMD_DBGAPI_EVENT_KIND_WAVE_COMMAND_TERMINATED = 2,
  AMD_DBGAPI_EVENT_KIND_CODE_OBJECT_LIST_UPDATED = 3,
  AMD_DBGAPI_EVENT_KIND_BREAKPOINT_RESUME = 4,
  AMD_DBGAPI_EVENT_KIND_RUNTIME = 5,
  AMD_DBGAPI_EVENT_KIND_QUEUE_ERROR = 6
} amd_dbgapi_event_kind_t;

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;

typedef enum
{
  AMD_DBGAPI_RUNTIME_STATE_LOADED_SUCCESS = 1,
  AMD_DBGAPI_RUNTIME_STATE_UNLOADED = 2,
  AMD_DBGAPI_RUNTIME_STATE_LOADED_ERROR_RESTRICTION = 3
} amd_dbgapi_runtime_state_t;

typedef enum
{
  AMD_DBGAPI_EVENT_INFO_PROCESS = 1,
  AMD_DBGAPI_EVENT_INFO_KIND = 2,
  AMD_DBGAPI_EVENT_INFO_WAVE = 3,
  AMD_DBGAPI_EVENT_INFO_BREAKPOINT = 4,
  AMD_DBGAPI_EVENT_INFO_CLIENT_THREAD = 5,
  AMD_DBGAPI_EVENT_INFO_RUNTIME_STATE = 6,
  AMD_DBGAPI_EVENT_INFO_QUEUE = 7
} amd_dbgapi_event_info_t;

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;

amd_dbgapi_status_t AMD_DBGAPI amd_dbgapi_event_processed (
    amd_dbgapi_event_id_t event_id) AMD_DBGAPI_VERSION_0_54;

typedef enum
{
  AMD_DBGAPI_LOG_LEVEL_NONE = 0,
  AMD_DBGAPI_LOG_LEVEL_FATAL_ERROR = 1,
  AMD_DBGAPI_LOG_LEVEL_WARNING = 2,
  AMD_DBGAPI_LOG_LEVEL_INFO = 3,
  AMD_DBGAPI_LOG_LEVEL_TRACE = 4,
  AMD_DBGAPI_LOG_LEVEL_VERBOSE = 5
} amd_dbgapi_log_level_t;

void AMD_DBGAPI amd_dbgapi_set_log_level (amd_dbgapi_log_level_t level)
    AMD_DBGAPI_VERSION_0_54;

typedef struct
{
  uint64_t handle;
} amd_dbgapi_breakpoint_id_t;

#define AMD_DBGAPI_BREAKPOINT_NONE ((amd_dbgapi_breakpoint_id_t){ 0 })

typedef enum
{
  AMD_DBGAPI_BREAKPOINT_INFO_PROCESS = 1
} amd_dbgapi_breakpoint_info_t;

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;

typedef enum
{
  AMD_DBGAPI_BREAKPOINT_ACTION_RESUME = 1,
  AMD_DBGAPI_BREAKPOINT_ACTION_HALT = 2
} amd_dbgapi_breakpoint_action_t;

typedef struct amd_dbgapi_client_thread_s *amd_dbgapi_client_thread_id_t;

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;

struct amd_dbgapi_callbacks_s
{

  void *(*allocate_memory) (size_t byte_size);

  void (*deallocate_memory) (void *data);

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

  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);

  amd_dbgapi_status_t (*remove_breakpoint) (
      amd_dbgapi_client_process_id_t client_process_id,
      amd_dbgapi_breakpoint_id_t breakpoint_id);

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

#if defined(__cplusplus)
} /* extern "C" */
#endif /* defined (__cplusplus) */

#endif /* amd-dbgapi.h */