2013-06-27 20:47:34 +02:00
|
|
|
/*
|
2014-01-02 12:00:57 +01:00
|
|
|
Copyright (c) 2007-2014 Contributors as noted in the AUTHORS file
|
2013-06-27 20:47:34 +02:00
|
|
|
|
|
|
|
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_STREAM_HPP_INCLUDED__
|
|
|
|
#define __ZMQ_STREAM_HPP_INCLUDED__
|
|
|
|
|
|
|
|
#include <map>
|
|
|
|
|
|
|
|
#include "router.hpp"
|
|
|
|
|
|
|
|
namespace zmq
|
|
|
|
{
|
|
|
|
|
|
|
|
class ctx_t;
|
|
|
|
class pipe_t;
|
|
|
|
|
2013-06-28 09:08:54 +02:00
|
|
|
class stream_t :
|
2013-06-27 20:47:34 +02:00
|
|
|
public socket_base_t
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
|
|
|
|
stream_t (zmq::ctx_t *parent_, uint32_t tid_, int sid);
|
|
|
|
~stream_t ();
|
|
|
|
|
2014-01-08 18:25:31 +01:00
|
|
|
// Overrides of functions from socket_base_t.
|
2013-08-31 15:53:47 +02:00
|
|
|
void xattach_pipe (zmq::pipe_t *pipe_, bool subscribe_to_all_);
|
2013-06-27 20:47:34 +02:00
|
|
|
int xsend (zmq::msg_t *msg_);
|
|
|
|
int xrecv (zmq::msg_t *msg_);
|
|
|
|
bool xhas_in ();
|
|
|
|
bool xhas_out ();
|
|
|
|
void xread_activated (zmq::pipe_t *pipe_);
|
|
|
|
void xwrite_activated (zmq::pipe_t *pipe_);
|
|
|
|
void xpipe_terminated (zmq::pipe_t *pipe_);
|
Both STREAM and ROUTER sockets suffer from a naming problem on outbound connections. While these connections can be created, they can't be immediately used. Traffic must be received before it can be sent. This prevents practical, minimal usage of STREAM or ROUTER as a true N fan in/out socket.
This change simply provides the user with a socket option that sets a user defined name of the next outbound connection:
zmq_setsockopt(routerSock,ZMQ_NEXT_IDENTITY,"myname",6);
if(0 > zmq_connect(routerSock,"tcp://127.0.0.1:1234")) return 1;
ret = zmq_send(routerSock,"myname",6,ZMQ_SNDMORE);
zmq_send(routerSock,b.mem,b.used,0);
In this example, the socket is immediately given the name "myname", and is capable of immediately sending traffic.
This approach is more effective in three ways:
1) It prevents all sorts of malicious peer naming attacks that can cause undefined behavior in existing ROUTER connections. (Two connections are made that both transmit the same name to the ROUTER, the ROUTER behavior is undefined)
2) It allows immediate control of connections made to external parties for STREAM sockets. Something that is not possible right now. Before an outbound connection had no name for STREAM or ROUTER sockets because outbound connections cannot be sent to without first receiving traffic.
3) It is simpler and more general than expecting two ROUTER sockets to handshake on assigned connection names. Plus it allows inline sending to new connections on ROUTER.
2014-01-17 23:34:39 +01:00
|
|
|
int xsetsockopt (int option_, const void *optval_, size_t optvallen_);
|
2013-06-27 20:47:34 +02:00
|
|
|
private:
|
2013-06-28 09:08:54 +02:00
|
|
|
// Generate peer's id and update lookup map
|
|
|
|
void identify_peer (pipe_t *pipe_);
|
2013-06-27 20:47:34 +02:00
|
|
|
|
|
|
|
// Fair queueing object for inbound pipes.
|
|
|
|
fq_t fq;
|
|
|
|
|
|
|
|
// True iff there is a message held in the pre-fetch buffer.
|
|
|
|
bool prefetched;
|
|
|
|
|
|
|
|
// If true, the receiver got the message part with
|
|
|
|
// the peer's identity.
|
|
|
|
bool identity_sent;
|
|
|
|
|
|
|
|
// Holds the prefetched identity.
|
|
|
|
msg_t prefetched_id;
|
|
|
|
|
|
|
|
// Holds the prefetched message.
|
|
|
|
msg_t prefetched_msg;
|
|
|
|
|
|
|
|
struct outpipe_t
|
|
|
|
{
|
|
|
|
zmq::pipe_t *pipe;
|
|
|
|
bool active;
|
|
|
|
};
|
|
|
|
|
|
|
|
// Outbound pipes indexed by the peer IDs.
|
|
|
|
typedef std::map <blob_t, outpipe_t> outpipes_t;
|
|
|
|
outpipes_t outpipes;
|
|
|
|
|
|
|
|
// The pipe we are currently writing to.
|
|
|
|
zmq::pipe_t *current_out;
|
|
|
|
|
|
|
|
// If true, more outgoing message parts are expected.
|
|
|
|
bool more_out;
|
|
|
|
|
|
|
|
// Peer ID are generated. It's a simple increment and wrap-over
|
|
|
|
// algorithm. This value is the next ID to use (if not used already).
|
|
|
|
uint32_t next_peer_id;
|
|
|
|
|
|
|
|
stream_t (const stream_t&);
|
|
|
|
const stream_t &operator = (const stream_t&);
|
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif
|