/** \file
\brief Exception public header */
-#ifndef HH_Exception_
-#define HH_Exception_ 1
+#ifndef HH_SENF_Utils_Exception_
+#define HH_SENF_Utils_Exception_ 1
// Custom includes
#include <exception>
// ...
}
catch (senf::ExceptionMixin & e) {
- e << boost::format("\ncall id 0x%04x@%s") % id % address;
+ e << boost::format("\n" "call id 0x%04x@%s") % id % address;
}
\endcode
the GNU-libc.
To apply these features (extensibility, backtrace) to a non-senf exception, the non-senf
- exception can be wrapped and rethrown.
+ exception can be wrapped and re-thrown.
\code
void foo() {
try {
SENF_WRAP_EXC(std::bad_cast)
SENF_WRAP_EXC(somelib::FooException)
}
- \endcode The re-thrown exception can then be caught as <tt>std::bad_cast</tt> or as
- senf::ExceptionMixin as needed. It is safe, to wrap an exception twice (the macro will detect
- this case).
+ \endcode
+ The re-thrown exception can then be caught as <tt>std::bad_cast</tt> or as senf::ExceptionMixin
+ as needed. It is safe, to wrap an exception twice (the macro will detect this case).
\code
bar() {
try {
foo();
}
catch (senf::ExceptionMixin & ex) {
- ex << "\nadd this info";
+ ex << "\n" "add this info";
}
}
catch (std::bad_cast const & ex) {
\todo Link against libcwd to add file-name/line-number information to the backtrace and remove
the dependency on -rdynamic
+ \todo Or better, use addr2line to obtain that information when showing the backtrace when
+ catched within Daemon (<tt>addr2line -fsiCe argv[0]</tt>)
+ \todo Add signal handlers for the bad signals which writes a backtrace to stderr and
+ terminates. This should probably write out a raw backtrace without de-mangling or
+ line-numbers since we don't want to mess with dynamic memory when the heap might be
+ corrupted ... Another handler for e.g. SIGUSR2 is nice to show a debug backtrace on demand
*/
namespace senf {
the exception description:
\code
// Standard usage: Take \c errno from environment
- SENF_THROW_SYSTEM_EXCEPTION()
+ SENF_THROW_SYSTEM_EXCEPTION("::open()")
<< " while opening configuration file: " << filename;
// You may however explicitly specify the errno value
# define SENF_EXC_DEBUGINFO
# endif
-# define SENF_THROW_SYSTEM_EXCEPTION(desc) throw SystemException(desc SENF_EXC_DEBUGINFO)
+# define SENF_THROW_SYSTEM_EXCEPTION(desc) throw senf::SystemException(desc SENF_EXC_DEBUGINFO)
}
// compile-command: "scons -u test"
// comment-column: 40
// End:
+