signaler.hpp 2.95 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 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
#include "fd.hpp"

namespace zmq
{

    //  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.

    class signaler_t
    {
    public:

        signaler_t ();
        ~signaler_t ();

Martin Hurton's avatar
Martin Hurton committed
54
        fd_t get_fd () const;
55 56 57
        void send ();
        int wait (int timeout_);
        void recv ();
58
        int recv_failable ();
59 60 61 62

#ifdef HAVE_FORK
        // close the file descriptors in a forked child process so that they
        // do not interfere with the context in the parent process.
Martin Hurton's avatar
Martin Hurton committed
63
        void forked ();
64 65
#endif

66 67
    private:

68
        //  Creates a pair of file descriptors that will be used
69 70 71
        //  to pass the signals.
        static int make_fdpair (fd_t *r_, fd_t *w_);

Pieter Hintjens's avatar
Pieter Hintjens committed
72 73
        //  Underlying write & read file descriptor
        //  Will be -1 if we exceeded number of available handles
74 75 76 77 78 79
        fd_t w;
        fd_t r;

        //  Disable copying of signaler_t object.
        signaler_t (const signaler_t&);
        const signaler_t &operator = (const signaler_t&);
80 81 82 83 84 85

#ifdef HAVE_FORK
        // 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().
Martin Hurton's avatar
Martin Hurton committed
86
        void close_internal ();
87
#endif
88 89 90 91
    };
}

#endif