pcl::UnixSignalException Class Reference

A UNIX synchronous signal handler that throws C++ exceptions. More...

#include <UnixSignalException.h>

+ Inheritance diagram for pcl::UnixSignalException:

Public Member Functions

 UnixSignalException (int signal, const IsoString &details=IsoString())
 UnixSignalException (const UnixSignalException &)=default
String Caption () const override
const IsoStringDetails () const
String FormatInfo () const override
String Message () const override
void Show () const override
int SignalNumber () const
- Public Member Functions inherited from pcl::Exception
 Exception ()=default
 Exception (const pcl::Exception &)=default
virtual ~Exception ()
virtual String ExceptionClass () const
PCL_FORCE_INLINE void ShowOnConsole () const

Static Public Member Functions

static void Initialize ()
- Static Public Member Functions inherited from pcl::Exception
static void DisableConsoleOutput (bool disable=true)
static void DisableGUIOutput (bool disable=true)
static void EnableConsoleOutput (bool=true)
static void EnableGUIOutput (bool=true)
static bool IsConsoleOutputEnabled ()
static bool IsGUIOutputEnabled ()

Detailed Description

This class can only be used on Linux, FreeBSD and macOS platforms. On Windows platforms, including this header file from compilable code raises a compilation error.

For this handler to work properly, all code that may raise synchronous signals (SIGSEGV and the like) must be compiled with GCC's '-fnon-call-exceptions' flag. Otherwise the exceptions will be thrown but terminate() will be called, which is the default critical signal management behavior.

To generate a backtrace report (see the UnixSignalException::Details() member function), the code must be compiled with the '-rdynamic' GCC flag, which instructs the linker to add all symbols to the dynamic symbol table. In addition, the generated binaries should not be stripped with the '-s' linker flag.

Definition at line 92 of file UnixSignalException.h.

Constructor & Destructor Documentation

◆ UnixSignalException() [1/2]

pcl::UnixSignalException::UnixSignalException ( int  signal,
const IsoString details = IsoString() 

Constructs a new UnixSignalException object with the specified signal number and optional backtrace details.

Definition at line 100 of file UnixSignalException.h.

◆ UnixSignalException() [2/2]

pcl::UnixSignalException::UnixSignalException ( const UnixSignalException )

Copy constructor.

Member Function Documentation

◆ Caption()

String pcl::UnixSignalException::Caption ( ) const

Returns the type of this exception, intended to be used as a caption for a message box. As reimplemented in this class, this member function returns the string "PCL Unix Signal Handler".

Reimplemented from pcl::Exception.

Definition at line 162 of file UnixSignalException.h.

◆ Details()

const IsoString& pcl::UnixSignalException::Details ( ) const

Returns the backtrace information associated with this exception.

The returned string will be empty if no backtrace data were available at the time this signal exception was generated. This happens when the code has not been compiled and linked with the appropriate options (see the -rdynamic compiler flag).

Definition at line 127 of file UnixSignalException.h.

◆ FormatInfo()

String pcl::UnixSignalException::FormatInfo ( ) const

Returns a formatted error message with information on this signal exception.

Reimplemented from pcl::Exception.

Definition at line 146 of file UnixSignalException.h.

◆ Initialize()

static void pcl::UnixSignalException::Initialize ( )

Initializes the UNIX synchronous signal handler. This static member function must be called before the calling process can raise any synchronous signal.

A module should never call this member function. It is invoked when appropriate by the PixInsight core application and internal PCL routines.

◆ Message()

String pcl::UnixSignalException::Message ( ) const

Returns an error or warning message corresponding to this signal exception. Typical messages are "segmentation violation", "bus error" and "floating point exception", returned by specific derived classes.

Reimplemented from pcl::Exception.

Definition at line 137 of file UnixSignalException.h.

◆ Show()

void pcl::UnixSignalException::Show ( ) const

Writes a formatted representation of this exception on the platform console. A plain text version of the same textual representation will also be written on stdout.

UNIX synchronous interrupts are never reported on interactive graphical interfaces, such as message boxes, irrespective of global platform settings or local settings defined through calls to EnableGUIOutput() and similar functions.

Reimplemented from pcl::Exception.

◆ SignalNumber()

int pcl::UnixSignalException::SignalNumber ( ) const

Returns the signal number associated with this object.

Definition at line 114 of file UnixSignalException.h.

The documentation for this class was generated from the following file: