signaler.hpp 2.81 KB
Newer Older
1
/*
2
    Copyright (c) 2007-2016 Contributors as noted in the AUTHORS file
3

4
    This file is part of libzmq, the ZeroMQ core engine in C++.
5

6 7 8
    libzmq is free software; you can redistribute it and/or modify it under
    the terms of the GNU Lesser General Public License (LGPL) as published
    by the Free Software Foundation; either version 3 of the License, or
9 10
    (at your option) any later version.

11 12 13 14 15 16 17 18 19 20 21 22 23 24
    As a special exception, the Contributors give you permission to link
    this library with independent modules to produce an executable,
    regardless of the license terms of these independent modules, and to
    copy and distribute the resulting executable under terms of your choice,
    provided that you also meet, for each linked independent module, the
    terms and conditions of the license of that module. An independent
    module is a module which is not derived from or based on this library.
    If you modify this library, you must extend this exception to your
    version of the library.

    libzmq is distributed in the hope that it will be useful, but WITHOUT
    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
    License for more details.
25 26 27 28 29 30 31 32

    You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef __ZMQ_SIGNALER_HPP_INCLUDED__
#define __ZMQ_SIGNALER_HPP_INCLUDED__

33 34 35 36
#ifdef HAVE_FORK
#include <unistd.h>
#endif

37
#include "fd.hpp"
38
#include "macros.hpp"
39 40 41

namespace zmq
{
42 43 44 45
//  This is a cross-platform equivalent to signal_fd. However, as opposed
//  to signal_fd there can be at most one signal in the signaler at any
//  given moment. Attempt to send a signal before receiving the previous
//  one will result in undefined behaviour.
46

47 48 49 50 51
class signaler_t
{
  public:
    signaler_t ();
    ~signaler_t ();
52

53 54 55 56
    // Returns the socket/file descriptor
    // May return retired_fd if the signaler could not be initialized.
    fd_t get_fd () const;
    void send ();
57
    int wait (int timeout_) const;
58 59
    void recv ();
    int recv_failable ();
60

61
    bool valid () const;
62

63
#ifdef HAVE_FORK
64 65 66
    // close the file descriptors in a forked child process so that they
    // do not interfere with the context in the parent process.
    void forked ();
67 68
#endif

69 70 71 72
  private:
    //  Underlying write & read file descriptor
    //  Will be -1 if an error occurred during initialization, e.g. we
    //  exceeded the number of available handles
73 74
    fd_t _w;
    fd_t _r;
75

76
#ifdef HAVE_FORK
77 78 79 80 81
    // the process that created this context. Used to detect forking.
    pid_t pid;
    // idempotent close of file descriptors that is safe to use by destructor
    // and forked().
    void close_internal ();
82
#endif
83 84

    ZMQ_NON_COPYABLE_NOR_MOVABLE (signaler_t)
85
};
86 87 88
}

#endif