blob: f9757e547303e5086110c9d7df03e29d493fa181 [file] [log] [blame]
Willy Tarreau56e9c5e2012-07-06 09:47:57 +02001/*
2 * include/types/connection.h
3 * This file describes the connection struct and associated constants.
4 *
Willy Tarreaubaf5b9b2014-01-23 15:26:18 +01005 * Copyright (C) 2000-2014 Willy Tarreau - w@1wt.eu
Willy Tarreau56e9c5e2012-07-06 09:47:57 +02006 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation, version 2.1
10 * exclusively.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22#ifndef _TYPES_CONNECTION_H
23#define _TYPES_CONNECTION_H
24
25#include <stdlib.h>
26#include <sys/socket.h>
27
28#include <common/config.h>
Willy Tarreau2386be62017-09-21 19:40:52 +020029#include <common/ist.h>
Willy Tarreau56e9c5e2012-07-06 09:47:57 +020030
Willy Tarreaud1d54542012-09-12 22:58:11 +020031#include <types/listener.h>
Willy Tarreau3fdb3662012-11-12 00:42:33 +010032#include <types/obj_type.h>
Willy Tarreauef9a3602012-12-08 22:29:20 +010033#include <types/port_range.h>
Willy Tarreaud1d54542012-09-12 22:58:11 +020034#include <types/protocol.h>
35
Willy Tarreaud2629f22016-08-10 18:57:38 +020036#include <netinet/in_systm.h>
Bertrand Jacquin93b227d2016-06-04 15:11:10 +010037#include <netinet/ip.h>
38#include <netinet/ip6.h>
Bertrand Jacquin93b227d2016-06-04 15:11:10 +010039
Willy Tarreau56e9c5e2012-07-06 09:47:57 +020040/* referenced below */
Willy Tarreauc5788912012-08-24 18:12:41 +020041struct connection;
Olivier Houcharde2b40b92017-09-13 18:30:23 +020042struct conn_stream;
Willy Tarreauc5788912012-08-24 18:12:41 +020043struct buffer;
Willy Tarreaud84dab72016-12-22 21:13:18 +010044struct server;
Willy Tarreauc5788912012-08-24 18:12:41 +020045struct pipe;
Willy Tarreau56e9c5e2012-07-06 09:47:57 +020046
Willy Tarreau585744b2017-08-24 14:31:19 +020047
48/* A connection handle is how we differenciate two connections on the lower
49 * layers. It usually is a file descriptor but can be a connection id.
50 */
51union conn_handle {
52 int fd; /* file descriptor, for regular sockets */
53};
54
Olivier Houcharde2b40b92017-09-13 18:30:23 +020055/* conn_stream flags */
56enum {
57 CS_FL_NONE = 0x00000000, /* Just for initialization purposes */
58 CS_FL_DATA_RD_ENA = 0x00000001, /* receiving data is allowed */
59 CS_FL_DATA_WR_ENA = 0x00000002, /* sending data is desired */
60
Willy Tarreau79dadb52017-10-05 15:06:07 +020061 CS_FL_SHRD = 0x00000010, /* read shut, draining extra data */
62 CS_FL_SHRR = 0x00000020, /* read shut, resetting extra data */
63 CS_FL_SHR = CS_FL_SHRD | CS_FL_SHRR, /* read shut status */
64
65 CS_FL_SHWN = 0x00000040, /* write shut, verbose mode */
66 CS_FL_SHWS = 0x00000080, /* write shut, silent mode */
67 CS_FL_SHW = CS_FL_SHWN | CS_FL_SHWS, /* write shut status */
68
69
Olivier Houcharde2b40b92017-09-13 18:30:23 +020070 CS_FL_ERROR = 0x00000100, /* a fatal error was reported */
Willy Tarreau3c8294b2017-12-10 21:13:25 +010071 CS_FL_RCV_MORE = 0x00000200, /* more bytes to receive but not enough room */
Olivier Houcharde2b40b92017-09-13 18:30:23 +020072 CS_FL_EOS = 0x00001000, /* End of stream */
Olivier Houchard6fa63d92017-11-27 18:41:32 +010073 CS_FL_WAIT_FOR_HS = 0x00010000, /* This stream is waiting for handhskae */
Olivier Houcharde2b40b92017-09-13 18:30:23 +020074};
Willy Tarreau585744b2017-08-24 14:31:19 +020075
Willy Tarreau79dadb52017-10-05 15:06:07 +020076/* cs_shutr() modes */
77enum cs_shr_mode {
78 CS_SHR_DRAIN = 0, /* read shutdown, drain any extra stuff */
79 CS_SHR_RESET = 1, /* read shutdown, reset any extra stuff */
80};
81
82/* cs_shutw() modes */
83enum cs_shw_mode {
84 CS_SHW_NORMAL = 0, /* regular write shutdown */
85 CS_SHW_SILENT = 1, /* imminent close, don't notify peer */
86};
87
Willy Tarreaubaf5b9b2014-01-23 15:26:18 +010088/* For each direction, we have a CO_FL_{SOCK,DATA}_<DIR>_ENA flag, which
89 * indicates if read or write is desired in that direction for the respective
90 * layers. The current status corresponding to the current layer being used is
91 * remembered in the CO_FL_CURR_<DIR>_ENA flag. The need to poll (ie receipt of
92 * EAGAIN) is remembered at the file descriptor level so that even when the
93 * activity is stopped and restarted, we still remember whether it was needed
94 * to poll before attempting the I/O.
Willy Tarreaue9dfa792012-09-01 17:26:16 +020095 *
Willy Tarreaubaf5b9b2014-01-23 15:26:18 +010096 * The CO_FL_CURR_<DIR>_ENA flag is set from the FD status in
97 * conn_refresh_polling_flags(). The FD state is updated according to these
98 * flags in conn_cond_update_polling().
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +020099 */
100
Willy Tarreau900bc932012-07-06 09:52:14 +0200101/* flags for use in connection->flags */
102enum {
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200103 CO_FL_NONE = 0x00000000, /* Just for initialization purposes */
Willy Tarreauc76ae332012-07-12 15:32:13 +0200104
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200105 /* Do not change these values without updating conn_*_poll_changes() ! */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100106 CO_FL_SOCK_RD_ENA = 0x00000001, /* receiving handshakes is allowed */
Olivier Houchard1a0545f2017-09-13 18:30:23 +0200107 CO_FL_XPRT_RD_ENA = 0x00000002, /* receiving data is allowed */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200108 CO_FL_CURR_RD_ENA = 0x00000004, /* receiving is currently allowed */
Willy Tarreau310987a2014-01-22 19:46:33 +0100109 /* unused : 0x00000008 */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100110
111 CO_FL_SOCK_WR_ENA = 0x00000010, /* sending handshakes is desired */
Olivier Houchard1a0545f2017-09-13 18:30:23 +0200112 CO_FL_XPRT_WR_ENA = 0x00000020, /* sending data is desired */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100113 CO_FL_CURR_WR_ENA = 0x00000040, /* sending is currently desired */
Willy Tarreau310987a2014-01-22 19:46:33 +0100114 /* unused : 0x00000080 */
Willy Tarreauc76ae332012-07-12 15:32:13 +0200115
Willy Tarreauf79c8172013-10-21 16:30:56 +0200116 /* These flags indicate whether the Control and Transport layers are initialized */
117 CO_FL_CTRL_READY = 0x00000100, /* FD was registered, fd_delete() needed */
118 CO_FL_XPRT_READY = 0x00000200, /* xprt_init() done, xprt_close() needed */
119
Willy Tarreau916e12d2017-10-25 09:22:43 +0200120 CO_FL_WILL_UPDATE = 0x00000400, /* the conn handler will take care of updating the polling */
Willy Tarreau2686dca2017-04-26 16:25:12 +0200121
122 /* This flag is used by data layers to indicate they had to stop
123 * receiving data because a buffer was full. The connection handler
124 * clears it before first calling the I/O and data callbacks.
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200125 */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200126 CO_FL_WAIT_ROOM = 0x00000800, /* data sink is full */
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200127
Willy Tarreau986a9d22012-08-30 21:11:38 +0200128 /* These flags are used to report whether the from/to addresses are set or not */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200129 CO_FL_ADDR_FROM_SET = 0x00001000, /* addr.from is set */
130 CO_FL_ADDR_TO_SET = 0x00002000, /* addr.to is set */
131
Olivier Houchardc2aae742017-09-22 18:26:28 +0200132 CO_FL_EARLY_SSL_HS = 0x00004000, /* We have early data pending, don't start SSL handshake yet */
133 CO_FL_EARLY_DATA = 0x00008000, /* At least some of the data are early data */
Willy Tarreaubbae3f02017-08-30 09:59:52 +0200134 /* unused : 0x00010000 */
135 /* unused : 0x00020000 */
Willy Tarreau2ba44652012-08-20 17:30:32 +0200136
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200137 /* flags used to remember what shutdown have been performed/reported */
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200138 CO_FL_SOCK_RD_SH = 0x00040000, /* SOCK layer was notified about shutr/read0 */
139 CO_FL_SOCK_WR_SH = 0x00080000, /* SOCK layer asked for shutw */
140
Willy Tarreau3c0cc492017-03-19 07:54:28 +0100141 /* flags used to report connection errors or other closing conditions */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200142 CO_FL_ERROR = 0x00100000, /* a fatal error was reported */
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200143 CO_FL_NOTIFY_DONE = 0x001C0000, /* any xprt shut/error flags above needs to be reported */
Willy Tarreau82967bf2017-09-20 17:46:46 +0200144 CO_FL_NOTIFY_DATA = 0x001C0000, /* any shut/error flags above needs to be reported */
Willy Tarreau3c0cc492017-03-19 07:54:28 +0100145
146 /* flags used to report connection status updates */
147 CO_FL_CONNECTED = 0x00200000, /* L4+L6 now ready ; extra handshakes may or may not exist */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200148 CO_FL_WAIT_L4_CONN = 0x00400000, /* waiting for L4 to be connected */
149 CO_FL_WAIT_L6_CONN = 0x00800000, /* waiting for L6 to be connected (eg: SSL) */
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200150
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200151 /*** All the flags below are used for connection handshakes. Any new
152 * handshake should be added after this point, and CO_FL_HANDSHAKE
153 * should be updated.
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200154 */
Willy Tarreau57cd3e42013-10-24 22:01:26 +0200155 CO_FL_SEND_PROXY = 0x01000000, /* send a valid PROXY protocol header */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200156 CO_FL_SSL_WAIT_HS = 0x02000000, /* wait for an SSL handshake to complete */
Willy Tarreau5f1504f2012-10-04 23:55:57 +0200157 CO_FL_ACCEPT_PROXY = 0x04000000, /* receive a valid PROXY protocol header */
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100158 CO_FL_ACCEPT_CIP = 0x08000000, /* receive a valid NetScaler Client IP header */
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200159
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200160 /* below we have all handshake flags grouped into one */
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100161 CO_FL_HANDSHAKE = CO_FL_SEND_PROXY | CO_FL_SSL_WAIT_HS | CO_FL_ACCEPT_PROXY | CO_FL_ACCEPT_CIP,
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200162
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200163 /* when any of these flags is set, polling is defined by socket-layer
164 * operations, as opposed to data-layer. Transport is explicitly not
165 * mentionned here to avoid any confusion, since it can be the same
166 * as DATA or SOCK on some implementations.
167 */
168 CO_FL_POLL_SOCK = CO_FL_HANDSHAKE | CO_FL_WAIT_L4_CONN | CO_FL_WAIT_L6_CONN,
Willy Tarreau1e954912012-10-12 17:50:05 +0200169
Willy Tarreau387ebf82015-08-04 19:24:13 +0200170 /* This connection may not be shared between clients */
171 CO_FL_PRIVATE = 0x10000000,
172
Emeric Brun4f603012017-01-05 15:11:44 +0100173 /* This flag is used to know that a PROXY protocol header was sent by the client */
174 CO_FL_RCVD_PROXY = 0x20000000,
175
176 /* unused : 0x40000000 */
Willy Tarreauf79c8172013-10-21 16:30:56 +0200177
Willy Tarreau1e954912012-10-12 17:50:05 +0200178 /* This last flag indicates that the transport layer is used (for instance
179 * by logs) and must not be cleared yet. The last call to conn_xprt_close()
180 * must be done after clearing this flag.
181 */
182 CO_FL_XPRT_TRACKED = 0x80000000,
Willy Tarreau900bc932012-07-06 09:52:14 +0200183};
184
Willy Tarreau14cba4b2012-11-30 17:33:05 +0100185
186/* possible connection error codes */
187enum {
188 CO_ER_NONE, /* no error */
Willy Tarreau45b34e82014-01-24 16:06:50 +0100189
190 CO_ER_CONF_FDLIM, /* reached process' configured FD limitation */
191 CO_ER_PROC_FDLIM, /* reached process' FD limitation */
192 CO_ER_SYS_FDLIM, /* reached system's FD limitation */
193 CO_ER_SYS_MEMLIM, /* reached system buffers limitation */
194 CO_ER_NOPROTO, /* protocol not supported */
195 CO_ER_SOCK_ERR, /* other socket error */
196
197 CO_ER_PORT_RANGE, /* source port range exhausted */
198 CO_ER_CANT_BIND, /* can't bind to source address */
199 CO_ER_FREE_PORTS, /* no more free ports on the system */
200 CO_ER_ADDR_INUSE, /* local address already in use */
201
Willy Tarreau8e3bf692012-12-03 15:41:18 +0100202 CO_ER_PRX_EMPTY, /* nothing received in PROXY protocol header */
203 CO_ER_PRX_ABORT, /* client abort during PROXY protocol header */
Willy Tarreau0af29122012-12-03 15:35:00 +0100204 CO_ER_PRX_TIMEOUT, /* timeout while waiting for a PROXY header */
Willy Tarreau8e3bf692012-12-03 15:41:18 +0100205 CO_ER_PRX_TRUNCATED, /* truncated PROXY protocol header */
206 CO_ER_PRX_NOT_HDR, /* not a PROXY protocol header */
207 CO_ER_PRX_BAD_HDR, /* bad PROXY protocol header */
208 CO_ER_PRX_BAD_PROTO, /* unsupported protocol in PROXY header */
209
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100210 CO_ER_CIP_EMPTY, /* nothing received in NetScaler Client IP header */
211 CO_ER_CIP_ABORT, /* client abort during NetScaler Client IP header */
212 CO_ER_CIP_TIMEOUT, /* timeout while waiting for a NetScaler Client IP header */
213 CO_ER_CIP_TRUNCATED, /* truncated NetScaler Client IP header */
214 CO_ER_CIP_BAD_MAGIC, /* bad magic number in NetScaler Client IP header */
215 CO_ER_CIP_BAD_PROTO, /* unsupported protocol in NetScaler Client IP header */
216
Willy Tarreau20879a02012-12-03 16:32:10 +0100217 CO_ER_SSL_EMPTY, /* client closed during SSL handshake */
218 CO_ER_SSL_ABORT, /* client abort during SSL handshake */
Willy Tarreau0af29122012-12-03 15:35:00 +0100219 CO_ER_SSL_TIMEOUT, /* timeout during SSL handshake */
Willy Tarreau20879a02012-12-03 16:32:10 +0100220 CO_ER_SSL_TOO_MANY, /* too many SSL connections */
221 CO_ER_SSL_NO_MEM, /* no more memory to allocate an SSL connection */
222 CO_ER_SSL_RENEG, /* forbidden client renegociation */
223 CO_ER_SSL_CA_FAIL, /* client cert verification failed in the CA chain */
224 CO_ER_SSL_CRT_FAIL, /* client cert verification failed on the certificate */
Willy Tarreau71d058c2017-07-26 20:09:56 +0200225 CO_ER_SSL_MISMATCH, /* Server presented an SSL certificate different from the configured one */
226 CO_ER_SSL_MISMATCH_SNI, /* Server presented an SSL certificate different from the expected one */
Willy Tarreau20879a02012-12-03 16:32:10 +0100227 CO_ER_SSL_HANDSHAKE, /* SSL error during handshake */
Willy Tarreaub3966372014-04-25 18:54:29 +0200228 CO_ER_SSL_HANDSHAKE_HB, /* SSL error during handshake with heartbeat present */
Willy Tarreauf51c6982014-04-25 20:02:39 +0200229 CO_ER_SSL_KILLED_HB, /* Stopped a TLSv1 heartbeat attack (CVE-2014-0160) */
230 CO_ER_SSL_NO_TARGET, /* unknown target (not client nor server) */
Olivier Houchard522eea72017-11-03 16:27:47 +0100231 CO_ER_SSL_EARLY_FAILED, /* Server refused early data */
Willy Tarreau14cba4b2012-11-30 17:33:05 +0100232};
233
Willy Tarreauef9a3602012-12-08 22:29:20 +0100234/* source address settings for outgoing connections */
235enum {
236 /* Tproxy exclusive values from 0 to 7 */
237 CO_SRC_TPROXY_ADDR = 0x0001, /* bind to this non-local address when connecting */
238 CO_SRC_TPROXY_CIP = 0x0002, /* bind to the client's IP address when connecting */
239 CO_SRC_TPROXY_CLI = 0x0003, /* bind to the client's IP+port when connecting */
240 CO_SRC_TPROXY_DYN = 0x0004, /* bind to a dynamically computed non-local address */
241 CO_SRC_TPROXY_MASK = 0x0007, /* bind to a non-local address when connecting */
242
243 CO_SRC_BIND = 0x0008, /* bind to a specific source address when connecting */
244};
245
Willy Tarreau1049b1f2014-02-02 01:51:17 +0100246/* flags that can be passed to xprt->snd_buf() */
247enum {
248 CO_SFL_MSG_MORE = 0x0001, /* More data to come afterwards */
Willy Tarreau7bed9452014-02-02 02:00:24 +0100249 CO_SFL_STREAMER = 0x0002, /* Producer is continuously streaming data */
Willy Tarreau1049b1f2014-02-02 01:51:17 +0100250};
Willy Tarreauef9a3602012-12-08 22:29:20 +0100251
Willy Tarreau13e14102016-12-22 20:25:26 +0100252/* known transport layers (for ease of lookup) */
253enum {
254 XPRT_RAW = 0,
255 XPRT_SSL = 1,
256 XPRT_ENTRIES /* must be last one */
257};
258
Willy Tarreau28f1cb92017-12-20 16:14:44 +0100259/* MUX-specific flags */
260enum {
261 MX_FL_NONE = 0x00000000,
262 MX_FL_CLEAN_ABRT = 0x00000001, /* abort is clearly reported as an error */
263};
264
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200265/* xprt_ops describes transport-layer operations for a connection. They
266 * generally run over a socket-based control layer, but not always. Some
267 * of them are used for data transfer with the upper layer (rcv_*, snd_*)
268 * and the other ones are used to setup and release the transport layer.
Willy Tarreauc5788912012-08-24 18:12:41 +0200269 */
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200270struct xprt_ops {
Willy Tarreauc5788912012-08-24 18:12:41 +0200271 int (*rcv_buf)(struct connection *conn, struct buffer *buf, int count); /* recv callback */
Willy Tarreau787db9a2018-06-14 18:31:46 +0200272 size_t (*snd_buf)(struct connection *conn, const struct buffer *buf, size_t count, int flags); /* send callback */
Willy Tarreauc5788912012-08-24 18:12:41 +0200273 int (*rcv_pipe)(struct connection *conn, struct pipe *pipe, unsigned int count); /* recv-to-pipe callback */
274 int (*snd_pipe)(struct connection *conn, struct pipe *pipe); /* send-to-pipe callback */
275 void (*shutr)(struct connection *, int); /* shutr function */
276 void (*shutw)(struct connection *, int); /* shutw function */
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200277 void (*close)(struct connection *); /* close the transport layer */
278 int (*init)(struct connection *conn); /* initialize the transport layer */
Willy Tarreau5aacf782016-12-22 17:19:24 +0100279 int (*prepare_bind_conf)(struct bind_conf *conf); /* prepare a whole bind_conf */
Willy Tarreaufa983d32016-12-22 17:30:20 +0100280 void (*destroy_bind_conf)(struct bind_conf *conf); /* destroy a whole bind_conf */
Willy Tarreaud84dab72016-12-22 21:13:18 +0100281 int (*prepare_srv)(struct server *srv); /* prepare a server context */
282 void (*destroy_srv)(struct server *srv); /* destroy a server context */
Willy Tarreaua9c17412016-12-04 18:42:09 +0100283 int (*get_alpn)(const struct connection *conn, const char **str, int *len); /* get application layer name */
Willy Tarreau8e0bb0a2016-11-24 16:58:12 +0100284 char name[8]; /* transport layer name, zero-terminated */
Willy Tarreauc5788912012-08-24 18:12:41 +0200285};
286
Willy Tarreau53a47662017-08-28 10:53:00 +0200287/* mux_ops describes the mux operations, which are to be performed at the
288 * connection level after data are exchanged with the transport layer in order
289 * to propagate them to streams. The <init> function will automatically be
290 * called once the mux is instanciated by the connection's owner at the end
291 * of a transport handshake, when it is about to transfer data and the data
292 * layer is not ready yet.
293 */
294struct mux_ops {
295 int (*init)(struct connection *conn); /* early initialization */
296 void (*recv)(struct connection *conn); /* mux-layer recv callback */
297 void (*send)(struct connection *conn); /* mux-layer send callback */
298 int (*wake)(struct connection *conn); /* mux-layer callback to report activity, mandatory */
Olivier Houchard8e614722017-09-13 18:30:23 +0200299 void (*update_poll)(struct conn_stream *cs); /* commit cs flags to mux/conn */
300 int (*rcv_buf)(struct conn_stream *cs, struct buffer *buf, int count); /* Called from the upper layer to get data */
Willy Tarreaudeccd112018-06-14 18:38:55 +0200301 size_t (*snd_buf)(struct conn_stream *cs, const struct buffer *buf, size_t count, int flags); /* Called from the upper layer to send data */
Olivier Houchard8e614722017-09-13 18:30:23 +0200302 int (*rcv_pipe)(struct conn_stream *cs, struct pipe *pipe, unsigned int count); /* recv-to-pipe callback */
303 int (*snd_pipe)(struct conn_stream *cs, struct pipe *pipe); /* send-to-pipe callback */
Willy Tarreauecdb3fe2017-10-05 15:25:48 +0200304 void (*shutr)(struct conn_stream *cs, enum cs_shr_mode); /* shutr function */
305 void (*shutw)(struct conn_stream *cs, enum cs_shw_mode); /* shutw function */
Olivier Houchard8e614722017-09-13 18:30:23 +0200306
Olivier Houchard8e614722017-09-13 18:30:23 +0200307 struct conn_stream *(*attach)(struct connection *); /* Create and attach a conn_stream to an outgoing connection */
308 void (*detach)(struct conn_stream *); /* Detach a conn_stream from an outgoing connection, when the request is done */
Willy Tarreaub011d8f2018-03-30 14:41:19 +0200309 void (*show_fd)(struct chunk *, struct connection *); /* append some data about connection into chunk for "show fd" */
Willy Tarreau28f1cb92017-12-20 16:14:44 +0100310 unsigned int flags; /* some flags characterizing the mux's capabilities (MX_FL_*) */
Willy Tarreau53a47662017-08-28 10:53:00 +0200311 char name[8]; /* mux layer name, zero-terminated */
312};
313
Willy Tarreau74beec32012-10-03 00:41:04 +0200314/* data_cb describes the data layer's recv and send callbacks which are called
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200315 * when I/O activity was detected after the transport layer is ready. These
316 * callbacks are supposed to make use of the xprt_ops above to exchange data
Willy Tarreau4aa36832012-10-02 20:07:22 +0200317 * from/to buffers and pipes. The <wake> callback is used to report activity
318 * at the transport layer, which can be a connection opening/close, or any
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200319 * data movement. It may abort a connection by returning < 0.
Willy Tarreauc5788912012-08-24 18:12:41 +0200320 */
Willy Tarreau74beec32012-10-03 00:41:04 +0200321struct data_cb {
Olivier Houchard9aaf7782017-09-13 18:30:23 +0200322 void (*recv)(struct conn_stream *cs); /* data-layer recv callback */
323 void (*send)(struct conn_stream *cs); /* data-layer send callback */
324 int (*wake)(struct conn_stream *cs); /* data-layer callback to report activity */
Willy Tarreau8e0bb0a2016-11-24 16:58:12 +0100325 char name[8]; /* data layer name, zero-terminated */
Willy Tarreauc5788912012-08-24 18:12:41 +0200326};
327
David Carlier3015a2e2016-07-04 22:51:33 +0100328struct my_tcphdr {
David Carlier327298c2016-11-20 10:42:38 +0000329 uint16_t source;
330 uint16_t dest;
David Carlier3015a2e2016-07-04 22:51:33 +0100331};
332
Willy Tarreauef9a3602012-12-08 22:29:20 +0100333/* a connection source profile defines all the parameters needed to properly
334 * bind an outgoing connection for a server or proxy.
335 */
336
337struct conn_src {
338 unsigned int opts; /* CO_SRC_* */
339 int iface_len; /* bind interface name length */
340 char *iface_name; /* bind interface name or NULL */
341 struct port_range *sport_range; /* optional per-server TCP source ports */
342 struct sockaddr_storage source_addr; /* the address to which we want to bind for connect() */
Willy Tarreau29fbe512015-08-20 19:35:14 +0200343#if defined(CONFIG_HAP_TRANSPARENT)
Willy Tarreauef9a3602012-12-08 22:29:20 +0100344 struct sockaddr_storage tproxy_addr; /* non-local address we want to bind to for connect() */
345 char *bind_hdr_name; /* bind to this header name if defined */
346 int bind_hdr_len; /* length of the name of the header above */
347 int bind_hdr_occ; /* occurrence number of header above: >0 = from first, <0 = from end, 0=disabled */
348#endif
349};
350
Olivier Houcharde2b40b92017-09-13 18:30:23 +0200351/*
352 * This structure describes the elements of a connection relevant to a stream
353 */
354struct conn_stream {
355 enum obj_type obj_type; /* differentiates connection from applet context */
356 struct connection *conn; /* xprt-level connection */
357 unsigned int flags; /* CS_FL_* */
358 void *data; /* pointer to upper layer's entity (eg: stream interface) */
359 const struct data_cb *data_cb; /* data layer callbacks. Must be set before xprt->init() */
360 void *ctx; /* mux-specific context */
361};
362
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200363/* This structure describes a connection with its methods and data.
364 * A connection may be performed to proxy or server via a local or remote
365 * socket, and can also be made to an internal applet. It can support
Willy Tarreau51c21842013-09-29 09:06:42 +0200366 * several transport schemes (raw, ssl, ...). It can support several
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200367 * connection control schemes, generally a protocol for socket-oriented
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200368 * connections, but other methods for applets. The xprt_done_cb() callback
369 * is called once the transport layer initialization is done (success or
370 * failure). It may return < 0 to report an error and require an abort of the
371 * connection being instanciated. It must be removed once done.
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200372 */
373struct connection {
Willy Tarreau51c21842013-09-29 09:06:42 +0200374 enum obj_type obj_type; /* differentiates connection from applet context */
Willy Tarreauad5281c2013-12-06 21:09:57 +0100375 unsigned char err_code; /* CO_ER_* */
376 signed short send_proxy_ofs; /* <0 = offset to (re)send from the end, >0 = send all */
Willy Tarreaub8020ce2013-10-24 21:10:08 +0200377 unsigned int flags; /* CO_FL_* */
Willy Tarreauc5788912012-08-24 18:12:41 +0200378 const struct protocol *ctrl; /* operations at the socket layer */
Willy Tarreau378e0412012-10-13 14:33:58 +0200379 const struct xprt_ops *xprt; /* operations at the transport layer */
Willy Tarreau53a47662017-08-28 10:53:00 +0200380 const struct mux_ops *mux; /* mux layer opreations. Must be set before xprt->init() */
Willy Tarreau378e0412012-10-13 14:33:58 +0200381 void *xprt_ctx; /* general purpose pointer, initialized to NULL */
Willy Tarreau53a47662017-08-28 10:53:00 +0200382 void *mux_ctx; /* mux-specific context, initialized to NULL */
Olivier Houchard9aaf7782017-09-13 18:30:23 +0200383 void *owner; /* pointer to the owner session for incoming connections, or NULL */
Willy Tarreaub8020ce2013-10-24 21:10:08 +0200384 int xprt_st; /* transport layer state, initialized to zero */
Willy Tarreau53a47662017-08-28 10:53:00 +0200385 int tmp_early_data; /* 1st byte of early data, if any */
Olivier Houchard90084a12017-11-23 18:21:29 +0100386 int sent_early_data; /* Amount of early data we sent so far */
Willy Tarreau585744b2017-08-24 14:31:19 +0200387 union conn_handle handle; /* connection handle at the socket layer */
Willy Tarreau3fdb3662012-11-12 00:42:33 +0100388 enum obj_type *target; /* the target to connect to (server, proxy, applet, ...) */
Willy Tarreaud75d40e2015-08-04 17:25:58 +0200389 struct list list; /* attach point to various connection lists (idle, ...) */
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200390 int (*xprt_done_cb)(struct connection *conn); /* callback to notify of end of handshake */
Willy Tarreau436d3332017-10-08 11:16:46 +0200391 void (*destroy_cb)(struct connection *conn); /* callback to notify of imminent death of the connection */
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100392 const struct netns_entry *proxy_netns;
Willy Tarreau986a9d22012-08-30 21:11:38 +0200393 struct {
394 struct sockaddr_storage from; /* client address, or address to spoof when connecting to the server */
Willy Tarreaucd379952012-09-27 22:14:33 +0200395 struct sockaddr_storage to; /* address reached by the client, or address to connect to */
Willy Tarreau986a9d22012-08-30 21:11:38 +0200396 } addr; /* addresses of the remote side, client for producer and server for consumer */
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200397};
398
Willy Tarreau2386be62017-09-21 19:40:52 +0200399/* ALPN token registration */
400enum alpn_proxy_mode {
401 ALPN_MODE_NONE = 0,
402 ALPN_MODE_TCP = 1 << 0, // must not be changed!
403 ALPN_MODE_HTTP = 1 << 1, // must not be changed!
404 ALPN_MODE_ANY = ALPN_MODE_TCP | ALPN_MODE_HTTP,
405};
406
407struct alpn_mux_list {
408 const struct ist token; /* token name and length. Empty is catch-all */
409 enum alpn_proxy_mode mode;
410 const struct mux_ops *mux;
411 struct list list;
412};
413
David Safb76832014-05-08 23:42:08 -0400414/* proxy protocol v2 definitions */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200415#define PP2_SIGNATURE "\x0D\x0A\x0D\x0A\x00\x0D\x0A\x51\x55\x49\x54\x0A"
416#define PP2_SIGNATURE_LEN 12
417#define PP2_HEADER_LEN 16
David Safb76832014-05-08 23:42:08 -0400418
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200419/* ver_cmd byte */
420#define PP2_CMD_LOCAL 0x00
421#define PP2_CMD_PROXY 0x01
422#define PP2_CMD_MASK 0x0F
David Safb76832014-05-08 23:42:08 -0400423
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200424#define PP2_VERSION 0x20
425#define PP2_VERSION_MASK 0xF0
426
427/* fam byte */
428#define PP2_TRANS_UNSPEC 0x00
429#define PP2_TRANS_STREAM 0x01
430#define PP2_TRANS_DGRAM 0x02
431#define PP2_TRANS_MASK 0x0F
432
433#define PP2_FAM_UNSPEC 0x00
434#define PP2_FAM_INET 0x10
435#define PP2_FAM_INET6 0x20
436#define PP2_FAM_UNIX 0x30
437#define PP2_FAM_MASK 0xF0
438
439#define PP2_ADDR_LEN_UNSPEC (0)
440#define PP2_ADDR_LEN_INET (4 + 4 + 2 + 2)
441#define PP2_ADDR_LEN_INET6 (16 + 16 + 2 + 2)
442#define PP2_ADDR_LEN_UNIX (108 + 108)
443
444#define PP2_HDR_LEN_UNSPEC (PP2_HEADER_LEN + PP2_ADDR_LEN_UNSPEC)
445#define PP2_HDR_LEN_INET (PP2_HEADER_LEN + PP2_ADDR_LEN_INET)
446#define PP2_HDR_LEN_INET6 (PP2_HEADER_LEN + PP2_ADDR_LEN_INET6)
447#define PP2_HDR_LEN_UNIX (PP2_HEADER_LEN + PP2_ADDR_LEN_UNIX)
David Safb76832014-05-08 23:42:08 -0400448
449struct proxy_hdr_v2 {
450 uint8_t sig[12]; /* hex 0D 0A 0D 0A 00 0D 0A 51 55 49 54 0A */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200451 uint8_t ver_cmd; /* protocol version and command */
David Safb76832014-05-08 23:42:08 -0400452 uint8_t fam; /* protocol family and transport */
453 uint16_t len; /* number of following bytes part of the header */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200454 union {
455 struct { /* for TCP/UDP over IPv4, len = 12 */
456 uint32_t src_addr;
457 uint32_t dst_addr;
458 uint16_t src_port;
459 uint16_t dst_port;
460 } ip4;
461 struct { /* for TCP/UDP over IPv6, len = 36 */
462 uint8_t src_addr[16];
463 uint8_t dst_addr[16];
464 uint16_t src_port;
465 uint16_t dst_port;
466 } ip6;
467 struct { /* for AF_UNIX sockets, len = 216 */
468 uint8_t src_addr[108];
469 uint8_t dst_addr[108];
470 } unx;
471 } addr;
David Safb76832014-05-08 23:42:08 -0400472};
473
Emmanuel Hocdet58118b42017-10-13 12:15:28 +0200474#define PP2_TYPE_ALPN 0x01
475#define PP2_TYPE_AUTHORITY 0x02
476#define PP2_TYPE_CRC32C 0x03
477#define PP2_TYPE_NOOP 0x04
478#define PP2_TYPE_SSL 0x20
479#define PP2_SUBTYPE_SSL_VERSION 0x21
480#define PP2_SUBTYPE_SSL_CN 0x22
481#define PP2_SUBTYPE_SSL_CIPHER 0x23
482#define PP2_SUBTYPE_SSL_SIG_ALG 0x24
483#define PP2_SUBTYPE_SSL_KEY_ALG 0x25
484#define PP2_TYPE_NETNS 0x30
David Safb76832014-05-08 23:42:08 -0400485
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100486#define TLV_HEADER_SIZE 3
David Safb76832014-05-08 23:42:08 -0400487struct tlv {
488 uint8_t type;
489 uint8_t length_hi;
490 uint8_t length_lo;
491 uint8_t value[0];
492}__attribute__((packed));
493
494struct tlv_ssl {
495 struct tlv tlv;
496 uint8_t client;
497 uint32_t verify;
498 uint8_t sub_tlv[0];
499}__attribute__((packed));
500
Dave McCowan328fb582014-07-30 10:39:13 -0400501#define PP2_CLIENT_SSL 0x01
502#define PP2_CLIENT_CERT_CONN 0x02
503#define PP2_CLIENT_CERT_SESS 0x04
David Safb76832014-05-08 23:42:08 -0400504
Olivier Houchardf886e342017-04-05 22:24:59 +0200505
506/*
507 * Linux seems to be able to send 253 fds per sendmsg(), not sure
508 * about the other OSes.
509 */
510/* Max number of file descriptors we send in one sendmsg() */
511#define MAX_SEND_FD 253
512
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200513#endif /* _TYPES_CONNECTION_H */
514
515/*
516 * Local variables:
517 * c-indent-level: 8
518 * c-basic-offset: 8
519 * End:
520 */