ola::thread::SignalThread Class Reference

Detailed Description

Signals and threads don't play nicely together. Consider the following:

• thread1, acquires mutex M
• signal triggers
• thread1 runs the signal handler
• signal handler attempts to aqcuire mutex M
• deadlock...

The recommended way to deal with this is to run a separate thread, whose sole purpose is to wait for signals. See section 12.8 of APUE.

To avoid this we do the following:

• mask all signals that we define custom handlers for
• spawn a thread which uses sigwait() to capture signals

Inheritance diagram for ola::thread::SignalThread:

Public Types
typedef ola::Callback0< void >	SignalHandler

Public Member Functions
bool	InstallSignalHandler (int signal, SignalHandler *handler)
Public Member Functions inherited from ola::thread::Thread
virtual bool	Start ()
virtual bool	FastStart ()
virtual bool	Join (void *ptr=NULL)
bool	IsRunning ()
ThreadId	Id () const
void *	_InternalRun ()

Protected Member Functions
void *	Run ()

Additional Inherited Members
Static Public Member Functions inherited from ola::thread::Thread
static ThreadId	Self ()

Member Function Documentation

bool ola::thread::SignalThread::InstallSignalHandler	(	int	signal,
		SignalHandler *	handler
	)

Install a signal handler for the given signal. This can't be called once the thread has stared.

void * ola::thread::SignalThread::Run ( )

protectedvirtual

Entry point into the thread.

Implements ola::thread::Thread.

---

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

• include/ola/thread/SignalThread.h
• common/thread/SignalThread.cpp