arne
/
cryptopp
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Whitespace check-in

pull/795/head
Jeffrey Walton 2019-01-31 19:04:44 -05:00
parent dbc071f083
commit 7fe141c004
No known key found for this signature in database
GPG Key ID: B36AB348921B1838
1 changed files with 15 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
trap.h
View File

@ -106,22 +106,23 @@ NAMESPACE_BEGIN(CryptoPP)
#if (CRYPTOPP_DEBUG && defined(UNIX_SIGNALS_AVAILABLE)) || defined(CRYPTOPP_DOXYGEN_PROCESSING) #if (CRYPTOPP_DEBUG && defined(UNIX_SIGNALS_AVAILABLE)) || defined(CRYPTOPP_DOXYGEN_PROCESSING)
/// \brief Default SIGTRAP handler /// \brief Default SIGTRAP handler
/// \details DebugTrapHandler() can be used by a program to install an empty /// \details DebugTrapHandler() can be used by a program to install an empty
/// SIGTRAP handler. If present, the handler ensures there is a signal handler /// SIGTRAP handler. If present, the handler ensures there is a signal
/// in place for <tt>SIGTRAP</tt> raised by <tt>CRYPTOPP_ASSERT</tt>. If /// handler in place for <tt>SIGTRAP</tt> raised by
/// <tt>CRYPTOPP_ASSERT</tt> raises <tt>SIGTRAP</tt> <em>without</em> /// <tt>CRYPTOPP_ASSERT</tt>. If <tt>CRYPTOPP_ASSERT</tt> raises
/// a handler, then one of two things can occur. First, the OS might allow the /// <tt>SIGTRAP</tt> <em>without</em> a handler, then one of two things can
/// program to continue. Second, the OS might terminate the program. OS X allows /// occur. First, the OS might allow the program to continue. Second, the OS
/// the program to continue, while some Linuxes terminate the program. /// might terminate the program. OS X allows the program to continue, while
/// \details If DebugTrapHandler detects another handler in place, then it will not /// some Linuxes terminate the program.
/// install a handler. This ensures a debugger can gain control of the /// \details If DebugTrapHandler detects another handler in place, then it will
/// not install a handler. This ensures a debugger can gain control of the
/// <tt>SIGTRAP</tt> signal without contention. It also allows multiple /// <tt>SIGTRAP</tt> signal without contention. It also allows multiple
/// DebugTrapHandler to be created without contentious or unusual behavior. /// DebugTrapHandler to be created without contentious or unusual behavior.
/// Though multiple DebugTrapHandler can be created, a program should only create /// Though multiple DebugTrapHandler can be created, a program should only
/// one, if needed. /// create one, if needed.
/// \details A DebugTrapHandler is subject to C++ static initialization [dis]order. /// \details A DebugTrapHandler is subject to C++ static initialization
/// If you need to install a handler and it must be installed early, then /// [dis]order. If you need to install a handler and it must be installed
/// reference the code associated with <tt>CRYPTOPP_INIT_PRIORITY</tt> in /// early, then reference the code associated with
/// cryptlib.cpp and cpu.cpp. /// <tt>CRYPTOPP_INIT_PRIORITY</tt> in cryptlib.cpp and cpu.cpp.
/// \details If you want to ensure <tt>CRYPTOPP_ASSERT</tt> is inert, then /// \details If you want to ensure <tt>CRYPTOPP_ASSERT</tt> is inert, then
/// <em>do not</em> define <tt>CRYPTOPP_DEBUG</tt>, <tt>DEBUG</tt> or /// <em>do not</em> define <tt>CRYPTOPP_DEBUG</tt>, <tt>DEBUG</tt> or
/// <tt>_DEBUG</tt>. Avoiding the defines means <tt>CRYPTOPP_ASSERT</tt> /// <tt>_DEBUG</tt>. Avoiding the defines means <tt>CRYPTOPP_ASSERT</tt>