SignalFdWatcher.hpp

// SPDX-FileCopyrightText: 2025 Vincent Leroy
// SPDX-License-Identifier: MIT
//
// This file is part of dfx.
//
// Licensed under the MIT License. See the LICENSE file in the project root
// for full license information.
 
#pragma once
 
// Standard includes
#include <initializer_list>
#include <functional>
#include <sys/signalfd.h>
 
// Project includes
#include "Events.hpp"
#include "PollerFd.hpp"
#include <dfx-utilities/CopyMoveControl.hpp>
#include <dfx-utilities/EnumString.hpp>
#include <dfx-utilities/Flags.hpp>
 
namespace dfx::FdWatch
{
class Poller;

class SignalFdWatcher
{
public:
    enum class SigChldMode
    {
        Default    = 0x01, 
        NoChldStop = 0x02, 
        NoChldWait = 0x04, 
    };
    DECLARE_FLAGS(SigChldModes, SigChldMode);
 
public:
    using Callback = std::move_only_function<void (signalfd_siginfo const &)>;
 
public:
    SignalFdWatcher(Poller & poller,
                    std::initializer_list<int> signals,
                    Callback cb,
                    SigChldModes sigChldModes = SigChldMode::Default);
    DISABLE_COPY_AND_MOVE(SignalFdWatcher);
 
private:
    void _onSignalFdTriggered(EventTriggers events);
 
private:
    Callback _cb;
    PollerFd  _signalFd;
};
} // !namespace dfx::FdWatch
 
DECLARE_ENUM_STRING_FUNCTIONS(dfx::FdWatch::SignalFdWatcher::SigChldMode);
DECLARE_OPERATOR_FOR_FLAGS(dfx::FdWatch::SignalFdWatcher::SigChldModes)
DECLARE_STD_FORMATTER_FOR_FLAGS(dfx::FdWatch::SignalFdWatcher::SigChldModes);