mirror of
https://github.com/zeromq/libzmq.git
synced 2025-02-22 23:11:03 +01:00

For historical reasons queue to transfer commands between threads was called 'signaler'. Given that it was used to pass commands rather than signals it was renamed to 'mailbox', see Erlang mailboxes. Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
85 lines
2.3 KiB
C++
85 lines
2.3 KiB
C++
/*
|
|
Copyright (c) 2007-2010 iMatix Corporation
|
|
|
|
This file is part of 0MQ.
|
|
|
|
0MQ is free software; you can redistribute it and/or modify it under
|
|
the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
0MQ 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.
|
|
|
|
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_IO_THREAD_HPP_INCLUDED__
|
|
#define __ZMQ_IO_THREAD_HPP_INCLUDED__
|
|
|
|
#include <vector>
|
|
|
|
#include "stdint.hpp"
|
|
#include "object.hpp"
|
|
#include "poller.hpp"
|
|
#include "i_poll_events.hpp"
|
|
#include "mailbox.hpp"
|
|
|
|
namespace zmq
|
|
{
|
|
|
|
// Generic part of the I/O thread. Polling-mechanism-specific features
|
|
// are implemented in separate "polling objects".
|
|
|
|
class io_thread_t : public object_t, public i_poll_events
|
|
{
|
|
public:
|
|
|
|
io_thread_t (class ctx_t *ctx_, uint32_t tid_);
|
|
|
|
// Clean-up. If the thread was started, it's neccessary to call 'stop'
|
|
// before invoking destructor. Otherwise the destructor would hang up.
|
|
~io_thread_t ();
|
|
|
|
// Launch the physical thread.
|
|
void start ();
|
|
|
|
// Ask underlying thread to stop.
|
|
void stop ();
|
|
|
|
// Returns mailbox associated with this I/O thread.
|
|
mailbox_t *get_mailbox ();
|
|
|
|
// i_poll_events implementation.
|
|
void in_event ();
|
|
void out_event ();
|
|
void timer_event (int id_);
|
|
|
|
// Used by io_objects to retrieve the assciated poller object.
|
|
poller_t *get_poller ();
|
|
|
|
// Command handlers.
|
|
void process_stop ();
|
|
|
|
// Returns load experienced by the I/O thread.
|
|
int get_load ();
|
|
|
|
private:
|
|
|
|
// I/O thread accesses incoming commands via this mailbox.
|
|
mailbox_t mailbox;
|
|
|
|
// Handle associated with mailbox' file descriptor.
|
|
poller_t::handle_t mailbox_handle;
|
|
|
|
// I/O multiplexing is performed using a poller object.
|
|
poller_t *poller;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|