libmesh_logging.h

Go to the documentation of this file.

// The libMesh Finite Element Library.
// Copyright (C) 2002-2024 Benjamin S. Kirk, John W. Peterson, Roy H. Stogner

// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.

// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.

// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA



#ifndef LIBMESH_LIBMESH_LOGGING_H
#define LIBMESH_LIBMESH_LOGGING_H


// The library configuration options
#include "libmesh/libmesh_common.h"

#include "libmesh/perf_log.h"

// Two-level macro substitution trick, used to construct a unique
// variable name for a given line.
#define TOKENPASTE(x, y) x ## y
#define TOKENPASTE2(x, y) TOKENPASTE(x, y)

namespace libMesh
{


// Forward declaration, required when included
// in perf_log.{C,h} because the preceding
// #include "libmesh/perf_log.h" is ineffective.
// Multiple inclusion avoidance problem...
// LIBMESH_PERF_LOG_H already #define'd, but the
// class has not been declared yet!.
class PerfLog;

extern PerfLog perflog;


struct PerfItem
{
  PerfItem(const char * label,
           const char * header,
           bool enabled=true,
           PerfLog * my_perflog=&perflog) :
    _label(label),
    _header(header),
    _enabled(enabled),
    _perflog(*my_perflog)
  {
    if (_enabled)
      _perflog.fast_push(label, header);
  }

  ~PerfItem()
  {
    if (_enabled)
      _perflog.fast_pop(_label, _header);
  }

private:
  const char * _label;
  const char * _header;
  bool _enabled;
  PerfLog & _perflog;
};



} // namespace libMesh



// Macros for performance logging.  This allows us
// to add performance monitors to the code without
// impacting performance when performance logging
// is disabled.
#ifdef LIBMESH_ENABLE_PERFORMANCE_LOGGING

#  define START_LOG(a,b)   { libMesh::perflog.push(a,b); }
#  define STOP_LOG(a,b)    { libMesh::perflog.pop(a,b); }
#  define LOG_SCOPE(a,b)   libMesh::PerfItem TOKENPASTE2(perf_item_, __LINE__)(a,b);
#  define LOG_SCOPE_IF(a,b,enabled)   libMesh::PerfItem TOKENPASTE2(perf_item_, __LINE__)(a,b,enabled);
#  define LOG_SCOPE_WITH(a,b,logger)   libMesh::PerfItem TOKENPASTE2(perf_item_, __LINE__)(a,b,true,&logger);

#else

#  define START_LOG(a,b)   {}
#  define STOP_LOG(a,b)    {}
#  define PALIBMESH_USE_LOG(a,b)   {}
#  define RESTART_LOG(a,b) {}
#  define LOG_SCOPE(a,b)   {}
#  define LOG_SCOPE_IF(a,b,enabled) {}
#  define LOG_SCOPE_WITH(a,b,logger) {}

#endif

// If performance logging is disabled, the LOG_SCOPE(a,b) will be a no-op.
#define LOG_CALL(a,b,X)   \
  do {                    \
    LOG_SCOPE(a,b);       \
    X;                    \
  } while (0)




#endif // LIBMESH_LIBMESH_LOGGING_H