177 lines
5.5 KiB
C++
177 lines
5.5 KiB
C++
/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
|
|
/*
|
|
* Copyright (c) 2006 INRIA
|
|
* All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License version 2 as
|
|
* published by the Free Software Foundation;
|
|
*
|
|
* This program 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
* Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
|
|
*/
|
|
#ifndef DEBUG_H
|
|
#define DEBUG_H
|
|
|
|
#include <string>
|
|
#include <iostream>
|
|
|
|
/**
|
|
* \defgroup debugging
|
|
* \brief Debugging functions and macros
|
|
*
|
|
* The ns3 debugging support provides a few simple macros
|
|
* for debugging and sending out messages to the user. There
|
|
* two classes of functionality:
|
|
* - ASSERT functionality: macros which are used to verify
|
|
* at runtime that a certain condition is true. If it is
|
|
* not true, the program halts. These checks are built
|
|
* into the program only in debugging builds. They are
|
|
* removed in optimized builds.
|
|
*
|
|
* - DEBUG functionality: macros which allow developers to
|
|
* send information out on screen only in debugging builds.
|
|
* All debug messages are disabled by default. To enable
|
|
* selected debug messages, use the ns3::DebugComponentEnable
|
|
* function. Alternatively, you can use the NS3_DEBUG
|
|
* environment variable to define a ';'-separated list of
|
|
* messages to enable. For example, NS3_DEBUG=a;b;c;DAFD;GH
|
|
* would enable the components 'a', 'b', 'c', 'DAFD', and, 'GH'.
|
|
*/
|
|
|
|
namespace ns3 {
|
|
|
|
/**
|
|
* \param name a debug component name
|
|
* \ingroup debugging
|
|
*
|
|
* Enable the debugging output associated with that debug component.
|
|
* The debugging output can be later disabled with a call
|
|
* to ns3::DebugComponentDisable.
|
|
*/
|
|
void DebugComponentEnable (char const *name);
|
|
/**
|
|
* \param name a debug component name
|
|
* \ingroup debugging
|
|
*
|
|
* Disable the debugging output associated with that debug component.
|
|
* The debugging output can be later re-enabled with a call
|
|
* to ns3::DebugComponentEnable.
|
|
*/
|
|
void DebugComponentDisable (char const *name);
|
|
/**
|
|
* \ingroup debugging
|
|
* Print the list of debugging messages available.
|
|
*/
|
|
void DebugComponentPrintList (void);
|
|
|
|
class DebugComponent {
|
|
public:
|
|
DebugComponent (std::string name);
|
|
bool IsEnabled (void);
|
|
void Enable (void);
|
|
void Disable (void);
|
|
private:
|
|
bool m_isEnabled;
|
|
};
|
|
|
|
/**
|
|
* \ingroup debugging
|
|
*
|
|
* When an NS3_ASSERT cannot verify its condition,
|
|
* this function is called. This is where you should
|
|
* be able to put a breakpoint with a debugger if
|
|
* you want to catch assertions before the program
|
|
* halts.
|
|
*/
|
|
void AssertBreakpoint (void);
|
|
|
|
}; // namespace ns3
|
|
|
|
|
|
#ifdef NS3_DEBUG_ENABLE
|
|
|
|
/**
|
|
* \ingroup debugging
|
|
* \param name a string
|
|
*
|
|
* Define a Debug component with a specific name. This macro
|
|
* should be used at the top of every file in which you want
|
|
* to use the NS3_DEBUG macro. This macro defines a new
|
|
* "debug component" which can be later selectively enabled
|
|
* or disabled with the ns3::DebugComponentEnable and
|
|
* ns3::DebugComponentDisable functions or with the NS3_DEBUG
|
|
* environment variable.
|
|
*/
|
|
#define NS3_DEBUG_COMPONENT_DEFINE(name) \
|
|
static ns3::DebugComponent g_debug = ns3::DebugComponent (name);
|
|
|
|
/**
|
|
* \ingroup debugging
|
|
* \param msg message to output
|
|
*
|
|
* Generate debugging output in the "debug component" of the
|
|
* current file. i.e., every call to NS3_DEBUG from within
|
|
* a file implicitely generates out within the component
|
|
* defined with the NS3_DEBUG_COMPONENT_DEFINE macro in the
|
|
* same file.
|
|
*/
|
|
#define NS3_DEBUG(msg) \
|
|
if (g_debug.IsEnabled ()) \
|
|
{ \
|
|
std::cout << msg << std::endl; \
|
|
}
|
|
|
|
/**
|
|
* \ingroup debugging
|
|
* \param condition condition to verifiy.
|
|
*
|
|
* At runtime, in debugging builds, if this condition is not
|
|
* true, the program prints the source file, line number and
|
|
* unverified condition and halts in the ns3::AssertBreakpoint
|
|
* function.
|
|
*/
|
|
#define NS3_ASSERT(condition) \
|
|
if (!(condition)) \
|
|
{ \
|
|
std::cout << "assert failed. file=" << __FILE__ << \
|
|
", line=" << __LINE__ << ", cond=\""#condition << \
|
|
"\"" << std::endl; \
|
|
ns3::AssertBreakpoint (); \
|
|
}
|
|
|
|
/**
|
|
* \ingroup debugging
|
|
* \param condition condition to verifiy.
|
|
* \param message message to output
|
|
*
|
|
* At runtime, in debugging builds, if this condition is not
|
|
* true, the program prints the message to output and
|
|
* halts in the ns3::AssertBreakpoint function.
|
|
*/
|
|
#define NS3_ASSERT_MSG(condition, message) \
|
|
if (!(condition)) \
|
|
{ \
|
|
std::cout << message << std::endl; \
|
|
ns3::AssertBreakpoint (); \
|
|
}
|
|
|
|
#else /* NS3_DEBUG_ENABLE */
|
|
|
|
#define NS3_DEBUG_COMPONENT_DEFINE(name)
|
|
#define NS3_DEBUG(x)
|
|
#define NS3_ASSERT(cond)
|
|
#define NS3_ASSERT_MSG(cond,msg)
|
|
|
|
#endif /* NS3_DEBUG_ENABLE */
|
|
|
|
#endif /* DEBUG_H */
|