quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T > Class Template Reference

Install a global signal continuation decider. More...

#include "signal_guard.hpp"

Inheritance diagram for quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >:

Public Member Functions
template<class U , typename std::enable_if<(std::is_constructible< T, U >::value), bool >::type = true, typename = decltype( std::declval<U>()((raised_signal_info *) 0) )>
	signal_guard_global_decider (signalc_set guarded, U &&f, bool callfirst)
	Constructs an instance.
	~signal_guard_global_decider ()=default
	signal_guard_global_decider (const signal_guard_global_decider &)=delete
	signal_guard_global_decider (signal_guard_global_decider &&o) noexcept=default
signal_guard_global_decider &	operator= (const signal_guard_global_decider &)=delete
signal_guard_global_decider &	operator= (signal_guard_global_decider &&o) noexcept

Detailed Description

template<class T>
class quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >

Install a global signal continuation decider.

This is threadsafe with respect to concurrent instantiations of this type, but not reentrant i.e. modifying the global signal continuation decider registry whilst inside a global signal continuation decider is racy. Callable is called after all thread local handling is exhausted. Note that what you can safely do in the decider callable is extremely limited, only async signal safe functions may be called.

A signal_guard_install is always instanced for every global decider, and creating and destroying these is NOT async signal safe i.e. create and destroy these ONLY outside a signal handler.

On POSIX only, a global signal continuation decider is ALWAYS installed for signalc::timer_expire (SIGALRM) in order to implement signal_guard_watchdog. Be aware that if any signal_guard_watchdog exist and their expiry times indicate that they have expired, the SIGALRM will be consumed. You may wish to install further global signal continuation deciders using callfirst = true if you wish to be called before any signal_guard_watchdog processing. Note also that if no signal_guard_watchdog expiry times have expired, then the default action for SIGALRM is taken.

Constructor & Destructor Documentation

signal_guard_global_decider() [1/3]

template<class T >

template<class U , typename std::enable_if<(std::is_constructible< T, U >::value), bool >::type = true, typename = decltype( std::declval<U>()((raised_signal_info *) 0) )>

quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::signal_guard_global_decider ( signalc_set  guarded, U &&  f, bool  callfirst  )

inline

Constructs an instance.

Parameters

guarded	The signal set for which this decider ought to be called.
f	A callable with prototype bool(raised_signal_info *), which must return true if execution is to resume, false if the next decider function should be called. Note that on Windows only, signalc::interrupt and signalc::process_terminate call f from some other kernel thread, and the return value is always treated as false.
callfirst	True if this decider should be called before any other. Otherwise call order is in the order of addition.

        : detail::signal_guard_global_decider_impl(guarded, callfirst)
        , _f(static_cast<U &&>(f))
    {
    }

~signal_guard_global_decider()

template<class T >

quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::~signal_guard_global_decider ( )

default

signal_guard_global_decider() [2/3]

template<class T >

quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::signal_guard_global_decider ( const signal_guard_global_decider< T > &  )

delete

signal_guard_global_decider() [3/3]

template<class T >

quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::signal_guard_global_decider ( signal_guard_global_decider< T > &&  o )

defaultnoexcept

Member Function Documentation

operator=() [1/2]

template<class T >

signal_guard_global_decider & quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::operator= ( const signal_guard_global_decider< T > &  )

delete

operator=() [2/2]

template<class T >

signal_guard_global_decider & quickcpplib::_xxx::signal_guard::signal_guard_global_decider< T >::operator= ( signal_guard_global_decider< T > &&  o )

inlinenoexcept

    {
      this->~signal_guard_global_decider();
      new(this) signal_guard_global_decider(static_cast<signal_guard_global_decider &&>(o));
      return *this;
    }

---

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

• include/quickcpplib/signal_guard.hpp