MemoryTracer.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2026 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* MemoryTracer.h                                              (C) 2000-2026 */
/*                                                                           */
/* Utilities for tracing memory accesses between the accelerator and the     */
/* host.                                                                     */
/*---------------------------------------------------------------------------*/
#ifndef ARCCORE_COMMON_ACCELERATOR_INTERNAL_MEMORYTRACER_H
#define ARCCORE_COMMON_ACCELERATOR_INTERNAL_MEMORYTRACER_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arccore/common/accelerator/CommonAcceleratorGlobal.h"
 
#include <tuple>
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane::Accelerator::Impl
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCCORE_COMMON_EXPORT MemoryTracer
{
 public:
 
  static void notifyMemoryAllocation(Span<const std::byte> bytes, const String& name, const String& stack_trace, Int64 timestamp);
  static void notifyMemoryFree(void* ptr, const String& name, const String& stack_trace, Int64 timestamp);
  static std::pair<String, String> findMemory(const void* ptr);
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCCORE_COMMON_EXPORT MemoryTracerWrapper
{
 public:
 
  MemoryTracerWrapper();
 
 public:
 
  bool isActive() const { return m_trace_level > 0; }
  void traceDeallocate(const AllocatedMemoryInfo& mem_info, const MemoryAllocationArgs& args);
  void traceAllocate(void* p, size_t new_size, MemoryAllocationArgs args);
  void setTraceLevel(Int32 v) { m_trace_level = v; }
 
 private:
 
  Int32 m_trace_level = 0;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // namespace Arcane::Accelerator::Impl
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif