aka_error.hh
No OneTemporary
Actions

Subscribers

None

File Metadata

Created: Wed, Nov 6, 09:34

aka_error.hh
View Options

	/**
	* @file aka_error.hh
	*
	* @author Nicolas Richart <nicolas.richart@epfl.ch>
	*
	* @date creation: Mon Jun 14 2010
	* @date last modification: Tue Jul 08 2014
	*
	* @brief error management and internal exceptions
	*
	* @section LICENSE
	*
	* Copyright (©) 2010-2012, 2014 EPFL (Ecole Polytechnique Fédérale de Lausanne)
	* Laboratory (LSMS - Laboratoire de Simulation en Mécanique des Solides)
	*
	* Akantu 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 3 of the License, or (at your option) any
	* later version.
	*
	* Akantu 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 Akantu. If not, see <http://www.gnu.org/licenses/>.
	*
	*/

	/* -------------------------------------------------------------------------- */
	#ifndef __AKANTU_ERROR_HH__
	#define __AKANTU_ERROR_HH__

	/* -------------------------------------------------------------------------- */
	#include <ostream>
	#include <sstream>

	/* -------------------------------------------------------------------------- */
	namespace akantu {

	/* -------------------------------------------------------------------------- */
	enum DebugLevel {
	dbl0 = 0,
	dblError = 0,
	dblAssert = 0,
	dbl1 = 1,
	dblException = 1,
	dblCritical = 1,
	dbl2 = 2,
	dblMajor = 2,
	dbl3 = 3,
	dblCall = 3,
	dblSecondary = 3,
	dblHead = 3,
	dbl4 = 4,
	dblWarning = 4,
	dbl5 = 5,
	dblInfo = 5,
	dbl6 = 6,
	dblIn = 6,
	dblOut = 6,
	dbl7 = 7,
	dbl8 = 8,
	dblTrace = 8,
	dbl9 = 9,
	dblAccessory = 9,
	dbl10 = 10,
	dblDebug = 42,
	dbl100 = 100,
	dblDump = 100,
	dblTest = 1337
	};

	/* -------------------------------------------------------------------------- */
	#define AKANTU_LOCATION "(" << __func__ << "(): " << __FILE__ << ":" << __LINE__ << ")"

	/* -------------------------------------------------------------------------- */
	namespace debug {
	void setDebugLevel(const DebugLevel & level);
	const DebugLevel & getDebugLevel();

	void initSignalHandler();
	std::string demangle(const char * symbol);
	std::string exec(std::string cmd);

	void printBacktrace(int sig);

	void exit(int status) __attribute__ ((noreturn));
	/* -------------------------------------------------------------------------- */
	/// exception class that can be thrown by akantu
	class Exception : public std::exception {
	/* ------------------------------------------------------------------------ */
	/* Constructors/Destructors */
	/* ------------------------------------------------------------------------ */
	public:

	//! full constructor
	Exception(std::string info, std::string file, unsigned int line) :
	_info(info), _file(file), _line(line) { }

	//! destructor
	virtual ~Exception() throw() {};

	/* ------------------------------------------------------------------------ */
	/* Methods */
	/* ------------------------------------------------------------------------ */
	public:
	virtual const char* what() const throw() {
	return _info.c_str();
	}

	virtual const char* info() const throw() {
	std::stringstream stream;
	stream << "akantu::Exception"
	<< " : " << _info
	<< " [" << _file << ":" << _line << "]";
	return stream.str().c_str();
	}

	/* ------------------------------------------------------------------------ */
	/* Class Members */
	/* ------------------------------------------------------------------------ */
	private:

	/// exception description and additionals
	std::string _info;

	/// file it is thrown from
	std::string _file;

	/// ligne it is thrown from
	unsigned int _line;
	};

	/// standard output stream operator
	inline std::ostream & operator <<(std::ostream & stream, const Exception & _this)
	{
	stream << _this.what();
	return stream;
	}


	/* -------------------------------------------------------------------------- */
	class Debugger {
	public:
	Debugger();
	virtual ~Debugger();

	void exit(int status) __attribute__ ((noreturn));

	void throwException(const std::string & info,
	const std::string & file,
	unsigned int line,
	__attribute__((unused)) bool silent,
	__attribute__((unused)) const std::string & location)
	const throw(akantu::debug::Exception) __attribute__ ((noreturn));

	void printMessage(const std::string & prefix,
	const DebugLevel & level,
	const std::string & info) const;

	void setOutStream(std::ostream & out) { cout = &out; }
	std::ostream & getOutStream() { return *cout; }

	public:
	void setParallelContext(int rank, int size);

	void setDebugLevel(const DebugLevel & level);
	const DebugLevel & getDebugLevel() const;

	void setLogFile(const std::string & filename);
	std::ostream & getOutputStream();

	inline bool testLevel(const DebugLevel & level) const {
	return (this->level >= (level));
	}

	void printBacktrace(bool on_off) {
	this->print_backtrace = on_off;
	}

	private:
	std::string parallel_context;
	std::ostream * cout;
	bool file_open;
	DebugLevel level;

	bool print_backtrace;
	};

	extern Debugger debugger;
	}

	/* -------------------------------------------------------------------------- */
	#define AKANTU_STRINGSTREAM_IN(_str, _sstr); \
	do { \
	std::stringstream _dbg_s_info; \
	_dbg_s_info << _sstr; \
	_str = _dbg_s_info.str(); \
	} while(0)

	/* -------------------------------------------------------------------------- */
	#define AKANTU_EXCEPTION(info) \
	AKANTU_EXCEPTION_(info, false)

	#define AKANTU_SILENT_EXCEPTION(info) \
	AKANTU_EXCEPTION_(info, true)

	#define AKANTU_EXCEPTION_(info, silent) \
	do { \
	std::stringstream _dbg_str; \
	_dbg_str << info; \
	std::stringstream _dbg_loc; _dbg_loc << AKANTU_LOCATION; \
	::akantu::debug::debugger.throwException(_dbg_str.str(), \
	__FILE__, \
	__LINE__, \
	silent, \
	_dbg_loc.str()); \
	} while(0)

	/* -------------------------------------------------------------------------- */
	#ifdef AKANTU_NDEBUG
	#define AKANTU_DEBUG_TEST(level) (false)
	#define AKANTU_DEBUG_LEVEL_IS_TEST() (false)
	#define AKANTU_DEBUG(level,info)
	#define AKANTU_DEBUG_(pref,level,info)
	#define AKANTU_DEBUG_IN()
	#define AKANTU_DEBUG_OUT()
	#define AKANTU_DEBUG_INFO(info)
	#define AKANTU_DEBUG_WARNING(info)
	#define AKANTU_DEBUG_TRACE(info)
	#define AKANTU_DEBUG_ASSERT(test,info)
	#define AKANTU_DEBUG_ERROR(info) AKANTU_EXCEPTION(info)
	#define AKANTU_DEBUG_TO_IMPLEMENT() ::akantu::debug::debugger.exit(EXIT_FAILURE)

	/* -------------------------------------------------------------------------- */
	#else
	#define AKANTU_DEBUG(level, info) \
	AKANTU_DEBUG_(" ",level, info)

	#define AKANTU_DEBUG_(pref, level, info) \
	do { \
	std::string _dbg_str; \
	AKANTU_STRINGSTREAM_IN(_dbg_str, info << " " << AKANTU_LOCATION); \
	::akantu::debug::debugger.printMessage(pref, level, _dbg_str); \
	} while(0)

	#define AKANTU_DEBUG_TEST(level) \
	(::akantu::debug::debugger.testLevel(level))

	#define AKANTU_DEBUG_LEVEL_IS_TEST() \
	(::akantu::debug::debugger.testLevel(dblTest))

	#define AKANTU_DEBUG_IN() \
	AKANTU_DEBUG_("==>", ::akantu::dblIn, __func__ << "()")

	#define AKANTU_DEBUG_OUT() \
	AKANTU_DEBUG_("<==", ::akantu::dblOut, __func__ << "()")

	#define AKANTU_DEBUG_INFO(info) \
	AKANTU_DEBUG_("---", ::akantu::dblInfo, info)

	#define AKANTU_DEBUG_WARNING(info) \
	AKANTU_DEBUG_("/!\\", ::akantu::dblWarning, info)

	#define AKANTU_DEBUG_TRACE(info) \
	AKANTU_DEBUG_(">>>", ::akantu::dblTrace, info)

	#define AKANTU_DEBUG_ASSERT(test,info) \
	do { \
	if (!(test)) { \
	AKANTU_DEBUG_("!!! ", ::akantu::dblAssert, "assert [" << #test << "] " \
	<< info); \
	::akantu::debug::debugger.exit(EXIT_FAILURE); \
	} \
	} while(0)

	#define AKANTU_DEBUG_ERROR(info) \
	do { \
	AKANTU_DEBUG_("!!! ", ::akantu::dblError, info); \
	::akantu::debug::debugger.exit(EXIT_FAILURE); \
	} while(0)


	#define AKANTU_DEBUG_TO_IMPLEMENT() \
	AKANTU_DEBUG_ERROR(__func__ << " : not implemented yet !")
	#endif // AKANTU_NDEBUG

	/* -------------------------------------------------------------------------- */

	}

	#endif /* __AKANTU_ERROR_HH__ */

aka_error.hhNo OneTemporaryActions

File Metadata

aka_error.hhView Options

Event Timeline

aka_error.hh
No OneTemporary
Actions

aka_error.hh
View Options