cosmos::SigSet Class Reference

A bit set of signal numbers for use in system calls. More...

#include <SigSet.hxx>

Classes
struct	fill_t

Public Member Functions
	SigSet ()
	Creates an empty signal set.
	SigSet (const fill_t)
	Creates a fully set signal set.
	SigSet (const std::initializer_list< Signal > &siglist)
	Creates a signal set with the given list of signals set.
void	clear ()
	Clears all signals in the set.
void	fill ()
	Sets all signals in the set.
bool	isSet (const Signal s) const
	Returns whether the given signal is set.
void	set (const Signal s)
	Sets the given signal in the set.
void	del (const Signal s)
	Removes the given signal from the set.
sigset_t *	raw ()
	Returns a pointer to the raw sigset_t data structure for use in API calls.
const sigset_t *	raw () const

Static Public Attributes
static constexpr fill_t	filled {}

Protected Attributes
sigset_t	m_set {}

Detailed Description

A bit set of signal numbers for use in system calls.

This type is needed to e.g. change a process's signal mask. It helps specifying a number of signals that should be operated on.

This data structure is surprisingly large (128 bytes), so copying it is best avoided.

Note

It is difficult to implement a proper operator== for SigSet, because the underlying data structure is supposed to be opaque on the one hand, and some kernel APIs don't seem to properly clear unused bits in returned sigsets e.g. in the oldaction return of sigaction().

Definition at line 25 of file SigSet.hxx.

Constructor & Destructor Documentation

SigSet() [1/3]

cosmos::SigSet::SigSet ( )

inline

Creates an empty signal set.

Definition at line 35 of file SigSet.hxx.

{}

SigSet() [2/3]

cosmos::SigSet::SigSet ( const fill_t )

inlineexplicit

Creates a fully set signal set.

Definition at line 37 of file SigSet.hxx.

{ fill(); }

SigSet() [3/3]

cosmos::SigSet::SigSet ( const std::initializer_list< Signal > & siglist )

inlineexplicit

Creates a signal set with the given list of signals set.

Definition at line 39 of file SigSet.hxx.

                                                                    {
                for (auto &sig: siglist) {
                        set(sig);
                }
        }

Member Function Documentation

clear()

void cosmos::SigSet::clear ( )

inline

Clears all signals in the set.

Definition at line 46 of file SigSet.hxx.

{ ::sigemptyset(&m_set); }

del()

void cosmos::SigSet::del ( const Signal s )

inline

Removes the given signal from the set.

Definition at line 55 of file SigSet.hxx.

{ ::sigdelset(&m_set, to_integral(s.raw())); }

fill()

void cosmos::SigSet::fill ( )

inline

Sets all signals in the set.

Definition at line 48 of file SigSet.hxx.

{ ::sigfillset(&m_set); }

isSet()

bool cosmos::SigSet::isSet ( const Signal s ) const

inline

Returns whether the given signal is set.

Definition at line 51 of file SigSet.hxx.

{ return ::sigismember(&m_set, to_integral(s.raw())); }

raw() [1/2]

sigset_t * cosmos::SigSet::raw ( )

inline

Returns a pointer to the raw sigset_t data structure for use in API calls.

Definition at line 58 of file SigSet.hxx.

{ return &m_set; }

raw() [2/2]

const sigset_t * cosmos::SigSet::raw ( ) const

inline

Definition at line 59 of file SigSet.hxx.

{ return &m_set; }

set()

void cosmos::SigSet::set ( const Signal s )

inline

Sets the given signal in the set.

Definition at line 53 of file SigSet.hxx.

{ ::sigaddset(&m_set, to_integral(s.raw())); }

Member Data Documentation

filled

fill_t cosmos::SigSet::filled {}

staticconstexpr

Definition at line 30 of file SigSet.hxx.

{};

m_set

sigset_t cosmos::SigSet::m_set {}

protected

Definition at line 63 of file SigSet.hxx.

{};

---

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

• include/proc/SigSet.hxx