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 libzmq is free software; you can redistribute it and/or modify it under
7 the terms of the GNU Lesser General Public License (LGPL) as published
8 by the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
10
11 As a special exception, the Contributors give you permission to link
12 this library with independent modules to produce an executable,
13 regardless of the license terms of these independent modules, and to
14 copy and distribute the resulting executable under terms of your choice,
15 provided that you also meet, for each linked independent module, the
16 terms and conditions of the license of that module. An independent
17 module is a module which is not derived from or based on this library.
18 If you modify this library, you must extend this exception to your
19 version of the library.
20
21 libzmq is distributed in the hope that it will be useful, but WITHOUT
22 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
23 FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
24 License for more details.
25
26 You should have received a copy of the GNU Lesser General Public License
27 along with this program. If not, see <http://www.gnu.org/licenses/>.
28*/
29
30#ifndef __ZMQ_TCP_HPP_INCLUDED__
31#define __ZMQ_TCP_HPP_INCLUDED__
32
33#include "fd.hpp"
34
35namespace zmq
36{
37class tcp_address_t;
38struct options_t;
39
40// Tunes the supplied TCP socket for the best latency.
41int tune_tcp_socket (fd_t s_);
42
43// Sets the socket send buffer size.
44int set_tcp_send_buffer (fd_t sockfd_, int bufsize_);
45
46// Sets the socket receive buffer size.
47int set_tcp_receive_buffer (fd_t sockfd_, int bufsize_);
48
49// Tunes TCP keep-alives
50int tune_tcp_keepalives (fd_t s_,
51 int keepalive_,
52 int keepalive_cnt_,
53 int keepalive_idle_,
54 int keepalive_intvl_);
55
56// Tunes TCP max retransmit timeout
57int tune_tcp_maxrt (fd_t sockfd_, int timeout_);
58
59// Writes data to the socket. Returns the number of bytes actually
60// written (even zero is to be considered to be a success). In case
61// of error or orderly shutdown by the other peer -1 is returned.
62int tcp_write (fd_t s_, const void *data_, size_t size_);
63
64// Reads data from the socket (up to 'size' bytes).
65// Returns the number of bytes actually read or -1 on error.
66// Zero indicates the peer has closed the connection.
67int tcp_read (fd_t s_, void *data_, size_t size_);
68
69void tcp_tune_loopback_fast_path (const fd_t socket_);
70
71// Resolves the given address_ string, opens a socket and sets socket options
72// according to the passed options_. On success, returns the socket
73// descriptor and assigns the resolved address to out_tcp_addr_. In case of
74// an error, retired_fd is returned, and the value of out_tcp_addr_ is undefined.
75// errno is set to an error code describing the cause of the error.
76fd_t tcp_open_socket (const char *address_,
77 const options_t &options_,
78 bool local_,
79 bool fallback_to_ipv4_,
80 tcp_address_t *out_tcp_addr_);
81}
82
83#endif
84