TheRock/rocm-systems/projects/rocprofiler-sdk/source/lib/rocprofiler-sdk-attach/code_object_registration.h

// MIT License
//
// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
//
// 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.

#pragma once

#include <rocprofiler-sdk/defines.h>

#include <hsa/hsa.h>

#include <stdint.h>

ROCPROFILER_EXTERN_C_INIT

typedef enum
{
    ROCPROFILER_ATTACH_CODE_OBJECT_CREATED,
    ROCPROFILER_ATTACH_CODE_OBJECT_DESTROYED
} rocprofiler_attach_code_object_phase_t;

typedef void (*rocprof_attach_code_object_iterator_t)(hsa_executable_t, void*);
typedef void (*rocprofiler_attach_code_object_cb_t)(hsa_executable_t,
                                                    rocprofiler_attach_code_object_phase_t,
                                                    void*);

int
rocprofiler_attach_iterate_all_code_objects(rocprof_attach_code_object_iterator_t func,
                                            void* data) ROCPROFILER_API;

int
rocprofiler_attach_add_code_object_cb(rocprofiler_attach_code_object_cb_t cb,
                                      void*                               data) ROCPROFILER_API;

int
rocprofiler_attach_remove_code_object_cb(rocprofiler_attach_code_object_cb_t cb) ROCPROFILER_API;

int
rocprofiler_attach_lookup_memory_codeobj_data(hsa_loaded_code_object_t loaded_code_object,
                                              const void**             data_out,
                                              uint64_t*                size_out) ROCPROFILER_API;

ROCPROFILER_EXTERN_C_FINI