blob: 4bcac6079bffa61c9c6bef7eb83e7694164cce84 [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 */
73};
Willy Tarreau585744b2017-08-24 14:31:19 +020074
Willy Tarreau79dadb52017-10-05 15:06:07 +020075/* cs_shutr() modes */
76enum cs_shr_mode {
77 CS_SHR_DRAIN = 0, /* read shutdown, drain any extra stuff */
78 CS_SHR_RESET = 1, /* read shutdown, reset any extra stuff */
79};
80
81/* cs_shutw() modes */
82enum cs_shw_mode {
83 CS_SHW_NORMAL = 0, /* regular write shutdown */
84 CS_SHW_SILENT = 1, /* imminent close, don't notify peer */
85};
86
Willy Tarreaubaf5b9b2014-01-23 15:26:18 +010087/* For each direction, we have a CO_FL_{SOCK,DATA}_<DIR>_ENA flag, which
88 * indicates if read or write is desired in that direction for the respective
89 * layers. The current status corresponding to the current layer being used is
90 * remembered in the CO_FL_CURR_<DIR>_ENA flag. The need to poll (ie receipt of
91 * EAGAIN) is remembered at the file descriptor level so that even when the
92 * activity is stopped and restarted, we still remember whether it was needed
93 * to poll before attempting the I/O.
Willy Tarreaue9dfa792012-09-01 17:26:16 +020094 *
Willy Tarreaubaf5b9b2014-01-23 15:26:18 +010095 * The CO_FL_CURR_<DIR>_ENA flag is set from the FD status in
96 * conn_refresh_polling_flags(). The FD state is updated according to these
97 * flags in conn_cond_update_polling().
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +020098 */
99
Willy Tarreau900bc932012-07-06 09:52:14 +0200100/* flags for use in connection->flags */
101enum {
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200102 CO_FL_NONE = 0x00000000, /* Just for initialization purposes */
Willy Tarreauc76ae332012-07-12 15:32:13 +0200103
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200104 /* Do not change these values without updating conn_*_poll_changes() ! */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100105 CO_FL_SOCK_RD_ENA = 0x00000001, /* receiving handshakes is allowed */
Olivier Houchard1a0545f2017-09-13 18:30:23 +0200106 CO_FL_XPRT_RD_ENA = 0x00000002, /* receiving data is allowed */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200107 CO_FL_CURR_RD_ENA = 0x00000004, /* receiving is currently allowed */
Willy Tarreau310987a2014-01-22 19:46:33 +0100108 /* unused : 0x00000008 */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100109
110 CO_FL_SOCK_WR_ENA = 0x00000010, /* sending handshakes is desired */
Olivier Houchard1a0545f2017-09-13 18:30:23 +0200111 CO_FL_XPRT_WR_ENA = 0x00000020, /* sending data is desired */
Willy Tarreauc8dd77f2012-11-05 17:52:26 +0100112 CO_FL_CURR_WR_ENA = 0x00000040, /* sending is currently desired */
Willy Tarreau310987a2014-01-22 19:46:33 +0100113 /* unused : 0x00000080 */
Willy Tarreauc76ae332012-07-12 15:32:13 +0200114
Willy Tarreauf79c8172013-10-21 16:30:56 +0200115 /* These flags indicate whether the Control and Transport layers are initialized */
116 CO_FL_CTRL_READY = 0x00000100, /* FD was registered, fd_delete() needed */
117 CO_FL_XPRT_READY = 0x00000200, /* xprt_init() done, xprt_close() needed */
118
Willy Tarreau916e12d2017-10-25 09:22:43 +0200119 CO_FL_WILL_UPDATE = 0x00000400, /* the conn handler will take care of updating the polling */
Willy Tarreau2686dca2017-04-26 16:25:12 +0200120
121 /* This flag is used by data layers to indicate they had to stop
122 * receiving data because a buffer was full. The connection handler
123 * clears it before first calling the I/O and data callbacks.
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200124 */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200125 CO_FL_WAIT_ROOM = 0x00000800, /* data sink is full */
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200126
Willy Tarreau986a9d22012-08-30 21:11:38 +0200127 /* These flags are used to report whether the from/to addresses are set or not */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200128 CO_FL_ADDR_FROM_SET = 0x00001000, /* addr.from is set */
129 CO_FL_ADDR_TO_SET = 0x00002000, /* addr.to is set */
130
Olivier Houchardc2aae742017-09-22 18:26:28 +0200131 CO_FL_EARLY_SSL_HS = 0x00004000, /* We have early data pending, don't start SSL handshake yet */
132 CO_FL_EARLY_DATA = 0x00008000, /* At least some of the data are early data */
Willy Tarreaubbae3f02017-08-30 09:59:52 +0200133 /* unused : 0x00010000 */
134 /* unused : 0x00020000 */
Willy Tarreau2ba44652012-08-20 17:30:32 +0200135
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200136 /* flags used to remember what shutdown have been performed/reported */
Willy Tarreaub5e2cbd2012-08-17 11:55:04 +0200137 CO_FL_SOCK_RD_SH = 0x00040000, /* SOCK layer was notified about shutr/read0 */
138 CO_FL_SOCK_WR_SH = 0x00080000, /* SOCK layer asked for shutw */
139
Willy Tarreau3c0cc492017-03-19 07:54:28 +0100140 /* flags used to report connection errors or other closing conditions */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200141 CO_FL_ERROR = 0x00100000, /* a fatal error was reported */
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200142 CO_FL_NOTIFY_DONE = 0x001C0000, /* any xprt shut/error flags above needs to be reported */
Willy Tarreau82967bf2017-09-20 17:46:46 +0200143 CO_FL_NOTIFY_DATA = 0x001C0000, /* any shut/error flags above needs to be reported */
Willy Tarreau3c0cc492017-03-19 07:54:28 +0100144
145 /* flags used to report connection status updates */
146 CO_FL_CONNECTED = 0x00200000, /* L4+L6 now ready ; extra handshakes may or may not exist */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200147 CO_FL_WAIT_L4_CONN = 0x00400000, /* waiting for L4 to be connected */
148 CO_FL_WAIT_L6_CONN = 0x00800000, /* waiting for L6 to be connected (eg: SSL) */
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200149
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200150 /*** All the flags below are used for connection handshakes. Any new
151 * handshake should be added after this point, and CO_FL_HANDSHAKE
152 * should be updated.
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200153 */
Willy Tarreau57cd3e42013-10-24 22:01:26 +0200154 CO_FL_SEND_PROXY = 0x01000000, /* send a valid PROXY protocol header */
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200155 CO_FL_SSL_WAIT_HS = 0x02000000, /* wait for an SSL handshake to complete */
Willy Tarreau5f1504f2012-10-04 23:55:57 +0200156 CO_FL_ACCEPT_PROXY = 0x04000000, /* receive a valid PROXY protocol header */
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100157 CO_FL_ACCEPT_CIP = 0x08000000, /* receive a valid NetScaler Client IP header */
Willy Tarreaue9dfa792012-09-01 17:26:16 +0200158
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200159 /* below we have all handshake flags grouped into one */
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100160 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 +0200161
Willy Tarreauf3a6d7e2012-10-03 20:00:18 +0200162 /* when any of these flags is set, polling is defined by socket-layer
163 * operations, as opposed to data-layer. Transport is explicitly not
164 * mentionned here to avoid any confusion, since it can be the same
165 * as DATA or SOCK on some implementations.
166 */
167 CO_FL_POLL_SOCK = CO_FL_HANDSHAKE | CO_FL_WAIT_L4_CONN | CO_FL_WAIT_L6_CONN,
Willy Tarreau1e954912012-10-12 17:50:05 +0200168
Willy Tarreau387ebf82015-08-04 19:24:13 +0200169 /* This connection may not be shared between clients */
170 CO_FL_PRIVATE = 0x10000000,
171
Emeric Brun4f603012017-01-05 15:11:44 +0100172 /* This flag is used to know that a PROXY protocol header was sent by the client */
173 CO_FL_RCVD_PROXY = 0x20000000,
174
175 /* unused : 0x40000000 */
Willy Tarreauf79c8172013-10-21 16:30:56 +0200176
Willy Tarreau1e954912012-10-12 17:50:05 +0200177 /* This last flag indicates that the transport layer is used (for instance
178 * by logs) and must not be cleared yet. The last call to conn_xprt_close()
179 * must be done after clearing this flag.
180 */
181 CO_FL_XPRT_TRACKED = 0x80000000,
Willy Tarreau900bc932012-07-06 09:52:14 +0200182};
183
Willy Tarreau14cba4b2012-11-30 17:33:05 +0100184
185/* possible connection error codes */
186enum {
187 CO_ER_NONE, /* no error */
Willy Tarreau45b34e82014-01-24 16:06:50 +0100188
189 CO_ER_CONF_FDLIM, /* reached process' configured FD limitation */
190 CO_ER_PROC_FDLIM, /* reached process' FD limitation */
191 CO_ER_SYS_FDLIM, /* reached system's FD limitation */
192 CO_ER_SYS_MEMLIM, /* reached system buffers limitation */
193 CO_ER_NOPROTO, /* protocol not supported */
194 CO_ER_SOCK_ERR, /* other socket error */
195
196 CO_ER_PORT_RANGE, /* source port range exhausted */
197 CO_ER_CANT_BIND, /* can't bind to source address */
198 CO_ER_FREE_PORTS, /* no more free ports on the system */
199 CO_ER_ADDR_INUSE, /* local address already in use */
200
Willy Tarreau8e3bf692012-12-03 15:41:18 +0100201 CO_ER_PRX_EMPTY, /* nothing received in PROXY protocol header */
202 CO_ER_PRX_ABORT, /* client abort during PROXY protocol header */
Willy Tarreau0af29122012-12-03 15:35:00 +0100203 CO_ER_PRX_TIMEOUT, /* timeout while waiting for a PROXY header */
Willy Tarreau8e3bf692012-12-03 15:41:18 +0100204 CO_ER_PRX_TRUNCATED, /* truncated PROXY protocol header */
205 CO_ER_PRX_NOT_HDR, /* not a PROXY protocol header */
206 CO_ER_PRX_BAD_HDR, /* bad PROXY protocol header */
207 CO_ER_PRX_BAD_PROTO, /* unsupported protocol in PROXY header */
208
Bertrand Jacquin93b227d2016-06-04 15:11:10 +0100209 CO_ER_CIP_EMPTY, /* nothing received in NetScaler Client IP header */
210 CO_ER_CIP_ABORT, /* client abort during NetScaler Client IP header */
211 CO_ER_CIP_TIMEOUT, /* timeout while waiting for a NetScaler Client IP header */
212 CO_ER_CIP_TRUNCATED, /* truncated NetScaler Client IP header */
213 CO_ER_CIP_BAD_MAGIC, /* bad magic number in NetScaler Client IP header */
214 CO_ER_CIP_BAD_PROTO, /* unsupported protocol in NetScaler Client IP header */
215
Willy Tarreau20879a02012-12-03 16:32:10 +0100216 CO_ER_SSL_EMPTY, /* client closed during SSL handshake */
217 CO_ER_SSL_ABORT, /* client abort during SSL handshake */
Willy Tarreau0af29122012-12-03 15:35:00 +0100218 CO_ER_SSL_TIMEOUT, /* timeout during SSL handshake */
Willy Tarreau20879a02012-12-03 16:32:10 +0100219 CO_ER_SSL_TOO_MANY, /* too many SSL connections */
220 CO_ER_SSL_NO_MEM, /* no more memory to allocate an SSL connection */
221 CO_ER_SSL_RENEG, /* forbidden client renegociation */
222 CO_ER_SSL_CA_FAIL, /* client cert verification failed in the CA chain */
223 CO_ER_SSL_CRT_FAIL, /* client cert verification failed on the certificate */
Willy Tarreau71d058c2017-07-26 20:09:56 +0200224 CO_ER_SSL_MISMATCH, /* Server presented an SSL certificate different from the configured one */
225 CO_ER_SSL_MISMATCH_SNI, /* Server presented an SSL certificate different from the expected one */
Willy Tarreau20879a02012-12-03 16:32:10 +0100226 CO_ER_SSL_HANDSHAKE, /* SSL error during handshake */
Willy Tarreaub3966372014-04-25 18:54:29 +0200227 CO_ER_SSL_HANDSHAKE_HB, /* SSL error during handshake with heartbeat present */
Willy Tarreauf51c6982014-04-25 20:02:39 +0200228 CO_ER_SSL_KILLED_HB, /* Stopped a TLSv1 heartbeat attack (CVE-2014-0160) */
229 CO_ER_SSL_NO_TARGET, /* unknown target (not client nor server) */
Olivier Houchard522eea72017-11-03 16:27:47 +0100230 CO_ER_SSL_EARLY_FAILED, /* Server refused early data */
Willy Tarreau14cba4b2012-11-30 17:33:05 +0100231};
232
Willy Tarreauef9a3602012-12-08 22:29:20 +0100233/* source address settings for outgoing connections */
234enum {
235 /* Tproxy exclusive values from 0 to 7 */
236 CO_SRC_TPROXY_ADDR = 0x0001, /* bind to this non-local address when connecting */
237 CO_SRC_TPROXY_CIP = 0x0002, /* bind to the client's IP address when connecting */
238 CO_SRC_TPROXY_CLI = 0x0003, /* bind to the client's IP+port when connecting */
239 CO_SRC_TPROXY_DYN = 0x0004, /* bind to a dynamically computed non-local address */
240 CO_SRC_TPROXY_MASK = 0x0007, /* bind to a non-local address when connecting */
241
242 CO_SRC_BIND = 0x0008, /* bind to a specific source address when connecting */
243};
244
Willy Tarreau1049b1f2014-02-02 01:51:17 +0100245/* flags that can be passed to xprt->snd_buf() */
246enum {
247 CO_SFL_MSG_MORE = 0x0001, /* More data to come afterwards */
Willy Tarreau7bed9452014-02-02 02:00:24 +0100248 CO_SFL_STREAMER = 0x0002, /* Producer is continuously streaming data */
Willy Tarreau1049b1f2014-02-02 01:51:17 +0100249};
Willy Tarreauef9a3602012-12-08 22:29:20 +0100250
Willy Tarreau13e14102016-12-22 20:25:26 +0100251/* known transport layers (for ease of lookup) */
252enum {
253 XPRT_RAW = 0,
254 XPRT_SSL = 1,
255 XPRT_ENTRIES /* must be last one */
256};
257
Willy Tarreau28f1cb92017-12-20 16:14:44 +0100258/* MUX-specific flags */
259enum {
260 MX_FL_NONE = 0x00000000,
261 MX_FL_CLEAN_ABRT = 0x00000001, /* abort is clearly reported as an error */
262};
263
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200264/* xprt_ops describes transport-layer operations for a connection. They
265 * generally run over a socket-based control layer, but not always. Some
266 * of them are used for data transfer with the upper layer (rcv_*, snd_*)
267 * and the other ones are used to setup and release the transport layer.
Willy Tarreauc5788912012-08-24 18:12:41 +0200268 */
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200269struct xprt_ops {
Willy Tarreauc5788912012-08-24 18:12:41 +0200270 int (*rcv_buf)(struct connection *conn, struct buffer *buf, int count); /* recv callback */
271 int (*snd_buf)(struct connection *conn, struct buffer *buf, int flags); /* send callback */
272 int (*rcv_pipe)(struct connection *conn, struct pipe *pipe, unsigned int count); /* recv-to-pipe callback */
273 int (*snd_pipe)(struct connection *conn, struct pipe *pipe); /* send-to-pipe callback */
274 void (*shutr)(struct connection *, int); /* shutr function */
275 void (*shutw)(struct connection *, int); /* shutw function */
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200276 void (*close)(struct connection *); /* close the transport layer */
277 int (*init)(struct connection *conn); /* initialize the transport layer */
Willy Tarreau5aacf782016-12-22 17:19:24 +0100278 int (*prepare_bind_conf)(struct bind_conf *conf); /* prepare a whole bind_conf */
Willy Tarreaufa983d32016-12-22 17:30:20 +0100279 void (*destroy_bind_conf)(struct bind_conf *conf); /* destroy a whole bind_conf */
Willy Tarreaud84dab72016-12-22 21:13:18 +0100280 int (*prepare_srv)(struct server *srv); /* prepare a server context */
281 void (*destroy_srv)(struct server *srv); /* destroy a server context */
Willy Tarreaua9c17412016-12-04 18:42:09 +0100282 int (*get_alpn)(const struct connection *conn, const char **str, int *len); /* get application layer name */
Willy Tarreau8e0bb0a2016-11-24 16:58:12 +0100283 char name[8]; /* transport layer name, zero-terminated */
Willy Tarreauc5788912012-08-24 18:12:41 +0200284};
285
Willy Tarreau53a47662017-08-28 10:53:00 +0200286/* mux_ops describes the mux operations, which are to be performed at the
287 * connection level after data are exchanged with the transport layer in order
288 * to propagate them to streams. The <init> function will automatically be
289 * called once the mux is instanciated by the connection's owner at the end
290 * of a transport handshake, when it is about to transfer data and the data
291 * layer is not ready yet.
292 */
293struct mux_ops {
294 int (*init)(struct connection *conn); /* early initialization */
295 void (*recv)(struct connection *conn); /* mux-layer recv callback */
296 void (*send)(struct connection *conn); /* mux-layer send callback */
297 int (*wake)(struct connection *conn); /* mux-layer callback to report activity, mandatory */
Olivier Houchard8e614722017-09-13 18:30:23 +0200298 void (*update_poll)(struct conn_stream *cs); /* commit cs flags to mux/conn */
299 int (*rcv_buf)(struct conn_stream *cs, struct buffer *buf, int count); /* Called from the upper layer to get data */
300 int (*snd_buf)(struct conn_stream *cs, struct buffer *buf, int flags); /* Called from the upper layer to send data */
301 int (*rcv_pipe)(struct conn_stream *cs, struct pipe *pipe, unsigned int count); /* recv-to-pipe callback */
302 int (*snd_pipe)(struct conn_stream *cs, struct pipe *pipe); /* send-to-pipe callback */
Willy Tarreauecdb3fe2017-10-05 15:25:48 +0200303 void (*shutr)(struct conn_stream *cs, enum cs_shr_mode); /* shutr function */
304 void (*shutw)(struct conn_stream *cs, enum cs_shw_mode); /* shutw function */
Olivier Houchard8e614722017-09-13 18:30:23 +0200305
Olivier Houchard8e614722017-09-13 18:30:23 +0200306 struct conn_stream *(*attach)(struct connection *); /* Create and attach a conn_stream to an outgoing connection */
307 void (*detach)(struct conn_stream *); /* Detach a conn_stream from an outgoing connection, when the request is done */
Willy Tarreau28f1cb92017-12-20 16:14:44 +0100308 unsigned int flags; /* some flags characterizing the mux's capabilities (MX_FL_*) */
Willy Tarreau53a47662017-08-28 10:53:00 +0200309 char name[8]; /* mux layer name, zero-terminated */
310};
311
Willy Tarreau74beec32012-10-03 00:41:04 +0200312/* data_cb describes the data layer's recv and send callbacks which are called
Willy Tarreauf7bc57c2012-10-03 00:19:48 +0200313 * when I/O activity was detected after the transport layer is ready. These
314 * callbacks are supposed to make use of the xprt_ops above to exchange data
Willy Tarreau4aa36832012-10-02 20:07:22 +0200315 * from/to buffers and pipes. The <wake> callback is used to report activity
316 * at the transport layer, which can be a connection opening/close, or any
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200317 * data movement. It may abort a connection by returning < 0.
Willy Tarreauc5788912012-08-24 18:12:41 +0200318 */
Willy Tarreau74beec32012-10-03 00:41:04 +0200319struct data_cb {
Olivier Houchard9aaf7782017-09-13 18:30:23 +0200320 void (*recv)(struct conn_stream *cs); /* data-layer recv callback */
321 void (*send)(struct conn_stream *cs); /* data-layer send callback */
322 int (*wake)(struct conn_stream *cs); /* data-layer callback to report activity */
Willy Tarreau8e0bb0a2016-11-24 16:58:12 +0100323 char name[8]; /* data layer name, zero-terminated */
Willy Tarreauc5788912012-08-24 18:12:41 +0200324};
325
David Carlier3015a2e2016-07-04 22:51:33 +0100326struct my_tcphdr {
David Carlier327298c2016-11-20 10:42:38 +0000327 uint16_t source;
328 uint16_t dest;
David Carlier3015a2e2016-07-04 22:51:33 +0100329};
330
Willy Tarreauef9a3602012-12-08 22:29:20 +0100331/* a connection source profile defines all the parameters needed to properly
332 * bind an outgoing connection for a server or proxy.
333 */
334
335struct conn_src {
336 unsigned int opts; /* CO_SRC_* */
337 int iface_len; /* bind interface name length */
338 char *iface_name; /* bind interface name or NULL */
339 struct port_range *sport_range; /* optional per-server TCP source ports */
340 struct sockaddr_storage source_addr; /* the address to which we want to bind for connect() */
Willy Tarreau29fbe512015-08-20 19:35:14 +0200341#if defined(CONFIG_HAP_TRANSPARENT)
Willy Tarreauef9a3602012-12-08 22:29:20 +0100342 struct sockaddr_storage tproxy_addr; /* non-local address we want to bind to for connect() */
343 char *bind_hdr_name; /* bind to this header name if defined */
344 int bind_hdr_len; /* length of the name of the header above */
345 int bind_hdr_occ; /* occurrence number of header above: >0 = from first, <0 = from end, 0=disabled */
346#endif
347};
348
Olivier Houcharde2b40b92017-09-13 18:30:23 +0200349/*
350 * This structure describes the elements of a connection relevant to a stream
351 */
352struct conn_stream {
353 enum obj_type obj_type; /* differentiates connection from applet context */
354 struct connection *conn; /* xprt-level connection */
355 unsigned int flags; /* CS_FL_* */
356 void *data; /* pointer to upper layer's entity (eg: stream interface) */
357 const struct data_cb *data_cb; /* data layer callbacks. Must be set before xprt->init() */
358 void *ctx; /* mux-specific context */
359};
360
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200361/* This structure describes a connection with its methods and data.
362 * A connection may be performed to proxy or server via a local or remote
363 * socket, and can also be made to an internal applet. It can support
Willy Tarreau51c21842013-09-29 09:06:42 +0200364 * several transport schemes (raw, ssl, ...). It can support several
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200365 * connection control schemes, generally a protocol for socket-oriented
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200366 * connections, but other methods for applets. The xprt_done_cb() callback
367 * is called once the transport layer initialization is done (success or
368 * failure). It may return < 0 to report an error and require an abort of the
369 * connection being instanciated. It must be removed once done.
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200370 */
371struct connection {
Willy Tarreau51c21842013-09-29 09:06:42 +0200372 enum obj_type obj_type; /* differentiates connection from applet context */
Willy Tarreauad5281c2013-12-06 21:09:57 +0100373 unsigned char err_code; /* CO_ER_* */
374 signed short send_proxy_ofs; /* <0 = offset to (re)send from the end, >0 = send all */
Willy Tarreaub8020ce2013-10-24 21:10:08 +0200375 unsigned int flags; /* CO_FL_* */
Willy Tarreauc5788912012-08-24 18:12:41 +0200376 const struct protocol *ctrl; /* operations at the socket layer */
Willy Tarreau378e0412012-10-13 14:33:58 +0200377 const struct xprt_ops *xprt; /* operations at the transport layer */
Willy Tarreau53a47662017-08-28 10:53:00 +0200378 const struct mux_ops *mux; /* mux layer opreations. Must be set before xprt->init() */
Willy Tarreau378e0412012-10-13 14:33:58 +0200379 void *xprt_ctx; /* general purpose pointer, initialized to NULL */
Willy Tarreau53a47662017-08-28 10:53:00 +0200380 void *mux_ctx; /* mux-specific context, initialized to NULL */
Olivier Houchard9aaf7782017-09-13 18:30:23 +0200381 void *owner; /* pointer to the owner session for incoming connections, or NULL */
Willy Tarreaub8020ce2013-10-24 21:10:08 +0200382 int xprt_st; /* transport layer state, initialized to zero */
Willy Tarreau53a47662017-08-28 10:53:00 +0200383 int tmp_early_data; /* 1st byte of early data, if any */
Olivier Houchard90084a12017-11-23 18:21:29 +0100384 int sent_early_data; /* Amount of early data we sent so far */
Willy Tarreau585744b2017-08-24 14:31:19 +0200385 union conn_handle handle; /* connection handle at the socket layer */
Willy Tarreau3fdb3662012-11-12 00:42:33 +0100386 enum obj_type *target; /* the target to connect to (server, proxy, applet, ...) */
Willy Tarreaud75d40e2015-08-04 17:25:58 +0200387 struct list list; /* attach point to various connection lists (idle, ...) */
Willy Tarreau8e3c6ce2017-08-28 15:46:01 +0200388 int (*xprt_done_cb)(struct connection *conn); /* callback to notify of end of handshake */
Willy Tarreau436d3332017-10-08 11:16:46 +0200389 void (*destroy_cb)(struct connection *conn); /* callback to notify of imminent death of the connection */
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100390 const struct netns_entry *proxy_netns;
Willy Tarreau986a9d22012-08-30 21:11:38 +0200391 struct {
392 struct sockaddr_storage from; /* client address, or address to spoof when connecting to the server */
Willy Tarreaucd379952012-09-27 22:14:33 +0200393 struct sockaddr_storage to; /* address reached by the client, or address to connect to */
Willy Tarreau986a9d22012-08-30 21:11:38 +0200394 } addr; /* addresses of the remote side, client for producer and server for consumer */
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200395};
396
Willy Tarreau2386be62017-09-21 19:40:52 +0200397/* ALPN token registration */
398enum alpn_proxy_mode {
399 ALPN_MODE_NONE = 0,
400 ALPN_MODE_TCP = 1 << 0, // must not be changed!
401 ALPN_MODE_HTTP = 1 << 1, // must not be changed!
402 ALPN_MODE_ANY = ALPN_MODE_TCP | ALPN_MODE_HTTP,
403};
404
405struct alpn_mux_list {
406 const struct ist token; /* token name and length. Empty is catch-all */
407 enum alpn_proxy_mode mode;
408 const struct mux_ops *mux;
409 struct list list;
410};
411
David Safb76832014-05-08 23:42:08 -0400412/* proxy protocol v2 definitions */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200413#define PP2_SIGNATURE "\x0D\x0A\x0D\x0A\x00\x0D\x0A\x51\x55\x49\x54\x0A"
414#define PP2_SIGNATURE_LEN 12
415#define PP2_HEADER_LEN 16
David Safb76832014-05-08 23:42:08 -0400416
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200417/* ver_cmd byte */
418#define PP2_CMD_LOCAL 0x00
419#define PP2_CMD_PROXY 0x01
420#define PP2_CMD_MASK 0x0F
David Safb76832014-05-08 23:42:08 -0400421
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200422#define PP2_VERSION 0x20
423#define PP2_VERSION_MASK 0xF0
424
425/* fam byte */
426#define PP2_TRANS_UNSPEC 0x00
427#define PP2_TRANS_STREAM 0x01
428#define PP2_TRANS_DGRAM 0x02
429#define PP2_TRANS_MASK 0x0F
430
431#define PP2_FAM_UNSPEC 0x00
432#define PP2_FAM_INET 0x10
433#define PP2_FAM_INET6 0x20
434#define PP2_FAM_UNIX 0x30
435#define PP2_FAM_MASK 0xF0
436
437#define PP2_ADDR_LEN_UNSPEC (0)
438#define PP2_ADDR_LEN_INET (4 + 4 + 2 + 2)
439#define PP2_ADDR_LEN_INET6 (16 + 16 + 2 + 2)
440#define PP2_ADDR_LEN_UNIX (108 + 108)
441
442#define PP2_HDR_LEN_UNSPEC (PP2_HEADER_LEN + PP2_ADDR_LEN_UNSPEC)
443#define PP2_HDR_LEN_INET (PP2_HEADER_LEN + PP2_ADDR_LEN_INET)
444#define PP2_HDR_LEN_INET6 (PP2_HEADER_LEN + PP2_ADDR_LEN_INET6)
445#define PP2_HDR_LEN_UNIX (PP2_HEADER_LEN + PP2_ADDR_LEN_UNIX)
David Safb76832014-05-08 23:42:08 -0400446
447struct proxy_hdr_v2 {
448 uint8_t sig[12]; /* hex 0D 0A 0D 0A 00 0D 0A 51 55 49 54 0A */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200449 uint8_t ver_cmd; /* protocol version and command */
David Safb76832014-05-08 23:42:08 -0400450 uint8_t fam; /* protocol family and transport */
451 uint16_t len; /* number of following bytes part of the header */
Willy Tarreau8fccfa22014-06-14 08:28:06 +0200452 union {
453 struct { /* for TCP/UDP over IPv4, len = 12 */
454 uint32_t src_addr;
455 uint32_t dst_addr;
456 uint16_t src_port;
457 uint16_t dst_port;
458 } ip4;
459 struct { /* for TCP/UDP over IPv6, len = 36 */
460 uint8_t src_addr[16];
461 uint8_t dst_addr[16];
462 uint16_t src_port;
463 uint16_t dst_port;
464 } ip6;
465 struct { /* for AF_UNIX sockets, len = 216 */
466 uint8_t src_addr[108];
467 uint8_t dst_addr[108];
468 } unx;
469 } addr;
David Safb76832014-05-08 23:42:08 -0400470};
471
Emmanuel Hocdet58118b42017-10-13 12:15:28 +0200472#define PP2_TYPE_ALPN 0x01
473#define PP2_TYPE_AUTHORITY 0x02
474#define PP2_TYPE_CRC32C 0x03
475#define PP2_TYPE_NOOP 0x04
476#define PP2_TYPE_SSL 0x20
477#define PP2_SUBTYPE_SSL_VERSION 0x21
478#define PP2_SUBTYPE_SSL_CN 0x22
479#define PP2_SUBTYPE_SSL_CIPHER 0x23
480#define PP2_SUBTYPE_SSL_SIG_ALG 0x24
481#define PP2_SUBTYPE_SSL_KEY_ALG 0x25
482#define PP2_TYPE_NETNS 0x30
David Safb76832014-05-08 23:42:08 -0400483
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100484#define TLV_HEADER_SIZE 3
David Safb76832014-05-08 23:42:08 -0400485struct tlv {
486 uint8_t type;
487 uint8_t length_hi;
488 uint8_t length_lo;
489 uint8_t value[0];
490}__attribute__((packed));
491
492struct tlv_ssl {
493 struct tlv tlv;
494 uint8_t client;
495 uint32_t verify;
496 uint8_t sub_tlv[0];
497}__attribute__((packed));
498
Dave McCowan328fb582014-07-30 10:39:13 -0400499#define PP2_CLIENT_SSL 0x01
500#define PP2_CLIENT_CERT_CONN 0x02
501#define PP2_CLIENT_CERT_SESS 0x04
David Safb76832014-05-08 23:42:08 -0400502
Olivier Houchardf886e342017-04-05 22:24:59 +0200503
504/*
505 * Linux seems to be able to send 253 fds per sendmsg(), not sure
506 * about the other OSes.
507 */
508/* Max number of file descriptors we send in one sendmsg() */
509#define MAX_SEND_FD 253
510
Willy Tarreau56e9c5e2012-07-06 09:47:57 +0200511#endif /* _TYPES_CONNECTION_H */
512
513/*
514 * Local variables:
515 * c-indent-level: 8
516 * c-basic-offset: 8
517 * End:
518 */