summaryrefslogtreecommitdiffstats
path: root/src/lib/asiolink/io_service_signal.h
blob: b078ce405a9cb451aaa1c9861dccf8759d439d87 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
// Copyright (C) 2020-2021 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

#ifndef IO_SERVICE_SIGNAL_H
#define IO_SERVICE_SIGNAL_H

#include <asiolink/io_service.h>

#include <boost/shared_ptr.hpp>

namespace isc {
namespace asiolink {

/// @brief Defines a handler function for an IOSignal.
typedef std::function<void(int signum)> IOSignalHandler;

class IOSignalSetImpl;

/// @brief Implements an asynchronous "signal" for IOService driven processing
///
/// This class allows a OS signal such as SIGHUP to propagated to an IOService
/// as a ready event with a callback using boost ASIO.
class IOSignalSet {
public:
    /// @brief Constructor.
    ///
    /// @param io_service IOService to which to send the signal.
    /// @param handler Handler to call when a signal is received.
    IOSignalSet(asiolink::IOServicePtr io_service, IOSignalHandler handler);

    /// @brief Destructor.
    ~IOSignalSet() = default;

    /// @brief Add a signal to the list of signals to handle.
    ///
    /// @param signum Signal number.
    /// @throw Unexpected on error.
    void add(int signum);

    /// @brief Remove a signal from the list of signals to handle.
    ///
    /// @param signum Signal number.
    /// @throw Unexpected on error.
    void remove(int signum);

private:
    /// @brief Pointer to the implementation.
    boost::shared_ptr<IOSignalSetImpl> impl_;
};

/// @brief Defines a pointer to an IOSignalSet.
typedef boost::shared_ptr<IOSignalSet> IOSignalSetPtr;

} // namespace asiolink
} // namespace isc

#endif // IO_SERVICE_SIGNAL_H