src/plugins/quic/quic.h

   1 /*
   2  * Copyright (c) 2019 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16 #ifndef __included_quic_h__
  17 #define __included_quic_h__
  18
  19 #include <vnet/session/application_interface.h>
  20
  21 #include <vppinfra/lock.h>
  22 #include <vppinfra/tw_timer_1t_3w_1024sl_ov.h>
  23 #include <vppinfra/bihash_16_8.h>
  24
  25 #include <quicly.h>
  26
  27 /* QUIC log levels
  28  * 1 - errors
  29  * 2 - connection/stream events
  30  * 3 - packet events
  31  * 4 - timer events
  32  **/
  33
  34 #define QUIC_DEBUG               0
  35 #define QUIC_TSTAMP_RESOLUTION  0.001   /* QUIC tick resolution (1ms) */
  36 #define QUIC_TIMER_HANDLE_INVALID ((u32) ~0)
  37 #define QUIC_SESSION_INVALID ((u32) ~0 - 1)
  38 #define QUIC_MAX_PACKET_SIZE 1280
  39
  40 #define QUIC_INT_MAX  0x3FFFFFFFFFFFFFFF
  41 #define QUIC_DEFAULT_FIFO_SIZE (64 << 10)
  42 #define QUIC_SEND_PACKET_VEC_SIZE 16
  43
  44 #define QUIC_SEND_MAX_BATCH_PACKETS 16
  45 #define QUIC_RCV_MAX_BATCH_PACKETS 16
  46 #define QUIC_DEFAULT_CONN_TIMEOUT (30 * 1000)   /* 30 seconds */
  47
  48 /* Taken from quicly.c */
  49 #define QUICLY_QUIC_BIT 0x40
  50
  51 #define QUICLY_PACKET_TYPE_INITIAL (QUICLY_LONG_HEADER_BIT | QUICLY_QUIC_BIT | 0)
  52 #define QUICLY_PACKET_TYPE_0RTT (QUICLY_LONG_HEADER_BIT | QUICLY_QUIC_BIT | 0x10)
  53 #define QUICLY_PACKET_TYPE_HANDSHAKE (QUICLY_LONG_HEADER_BIT | QUICLY_QUIC_BIT | 0x20)
  54 #define QUICLY_PACKET_TYPE_RETRY (QUICLY_LONG_HEADER_BIT | QUICLY_QUIC_BIT | 0x30)
  55 #define QUICLY_PACKET_TYPE_BITMASK 0xf0
  56
  57 /* error codes */
  58 #define QUIC_ERROR_FULL_FIFO 0xff10
  59 #define QUIC_APP_ERROR_CLOSE_NOTIFY QUICLY_ERROR_FROM_APPLICATION_ERROR_CODE(0)
  60 #define QUIC_APP_ALLOCATION_ERROR QUICLY_ERROR_FROM_APPLICATION_ERROR_CODE(0x1)
  61 #define QUIC_APP_ACCEPT_NOTIFY_ERROR QUICLY_ERROR_FROM_APPLICATION_ERROR_CODE(0x2)
  62 #define QUIC_APP_CONNECT_NOTIFY_ERROR QUICLY_ERROR_FROM_APPLICATION_ERROR_CODE(0x3)
  63
  64 #if QUIC_DEBUG
  65 #define QUIC_DBG(_lvl, _fmt, _args...)   \
  66   if (_lvl <= QUIC_DEBUG)                \
  67     clib_warning (_fmt, ##_args)
  68 #else
  69 #define QUIC_DBG(_lvl, _fmt, _args...)
  70 #endif
  71
  72 #define QUIC_ERR(_fmt, _args...)                \
  73   do {                                          \
  74     clib_warning ("QUIC-ERR: " _fmt, ##_args);  \
  75   } while (0)
  76
  77 extern vlib_node_registration_t quic_input_node;
  78
  79 typedef enum
  80 {
  81 #define quic_error(n,s) QUIC_ERROR_##n,
  82 #include <plugins/quic/quic_error.def>
  83 #undef quic_error
  84   QUIC_N_ERROR,
  85 } quic_error_t;
  86
  87 typedef enum quic_ctx_conn_state_
  88 {
  89   QUIC_CONN_STATE_OPENED,
  90   QUIC_CONN_STATE_HANDSHAKE,
  91   QUIC_CONN_STATE_READY,
  92   QUIC_CONN_STATE_PASSIVE_CLOSING,
  93   QUIC_CONN_STATE_PASSIVE_CLOSING_APP_CLOSED,
  94   QUIC_CONN_STATE_PASSIVE_CLOSING_QUIC_CLOSED,
  95   QUIC_CONN_STATE_ACTIVE_CLOSING,
  96 } quic_ctx_conn_state_t;
  97
  98 typedef enum quic_packet_type_
  99 {
 100   QUIC_PACKET_TYPE_NONE,
 101   QUIC_PACKET_TYPE_RECEIVE,
 102   QUIC_PACKET_TYPE_MIGRATE,
 103   QUIC_PACKET_TYPE_ACCEPT,
 104   QUIC_PACKET_TYPE_RESET,
 105   QUIC_PACKET_TYPE_DROP,
 106 } quic_packet_type_t;
 107
 108 typedef enum quic_ctx_flags_
 109 {
 110   QUIC_F_IS_STREAM = (1 << 0),
 111   QUIC_F_IS_LISTENER = (1 << 1),
 112 } quic_ctx_flags_t;
 113
 114 /* This structure is used to implement the concept of VPP connection for QUIC.
 115  * We create one per connection and one per stream. */
 116 typedef struct quic_ctx_
 117 {
 118   union
 119   {
 120     transport_connection_t connection;
 121     struct
 122     {         /** QUIC ctx case */
 123       quicly_conn_t *conn;
 124       u32 listener_ctx_id;
 125       u32 client_opaque;
 126       u8 *srv_hostname;
 127       u8 conn_state;
 128       u8 udp_is_ip4;
 129       u8 _qctx_end_marker;      /* Leave this at the end */
 130     };
 131     struct
 132     {         /** STREAM ctx case */
 133       quicly_stream_t *stream;
 134       u32 quic_connection_ctx_id;
 135       u8 _sctx_end_marker;      /* Leave this at the end */
 136     };
 137   };
 138   session_handle_t udp_session_handle;
 139   u32 timer_handle;
 140   u32 parent_app_wrk_id;
 141   u32 parent_app_id;
 142   u32 ckpair_index;
 143   quicly_context_t *quicly_ctx;
 144   u8 flags;
 145 } quic_ctx_t;
 146
 147 /* Make sure our custom fields don't overlap with the fields we use in
 148    .connection
 149 */
 150 STATIC_ASSERT (offsetof (quic_ctx_t, _qctx_end_marker) <=
 151                TRANSPORT_CONN_ID_LEN,
 152                "connection data must be less than TRANSPORT_CONN_ID_LEN bytes");
 153 STATIC_ASSERT (offsetof (quic_ctx_t, _sctx_end_marker) <=
 154                TRANSPORT_CONN_ID_LEN,
 155                "connection data must be less than TRANSPORT_CONN_ID_LEN bytes");
 156
 157 /* single-entry session cache */
 158 typedef struct quic_session_cache_
 159 {
 160   ptls_encrypt_ticket_t super;
 161   uint8_t id[32];
 162   ptls_iovec_t data;
 163 } quic_session_cache_t;
 164
 165 typedef struct quic_stream_data_
 166 {
 167   u32 ctx_id;
 168   u32 thread_index;
 169   u32 app_rx_data_len;          /**< bytes received, to be read by external app */
 170 } quic_stream_data_t;
 171
 172 typedef struct quic_worker_ctx_
 173 {
 174   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
 175   int64_t time_now;                                /**< worker time */
 176   tw_timer_wheel_1t_3w_1024sl_ov_t timer_wheel;    /**< worker timer wheel */
 177 } quic_worker_ctx_t;
 178
 179 typedef struct quic_rx_packet_ctx_
 180 {
 181   quicly_decoded_packet_t packet;
 182   u8 data[QUIC_MAX_PACKET_SIZE];
 183   u32 ctx_index;
 184   u32 thread_index;
 185   union
 186   {
 187     struct sockaddr sa;
 188     struct sockaddr_in6 sa6;
 189   };
 190   socklen_t salen;
 191   u8 ptype;
 192   session_dgram_hdr_t ph;
 193 } quic_rx_packet_ctx_t;
 194
 195 typedef struct quicly_ctx_data_
 196 {
 197   quicly_context_t quicly_ctx;
 198   char cid_key[17];
 199   ptls_context_t ptls_ctx;
 200 } quicly_ctx_data_t;
 201
 202 typedef struct quic_main_
 203 {
 204   u32 app_index;
 205   quic_ctx_t **ctx_pool;
 206   quic_worker_ctx_t *wrk_ctx;
 207   clib_bihash_16_8_t connection_hash;   /**< quic connection id -> conn handle */
 208   f64 tstamp_ticks_per_clock;
 209
 210   ptls_cipher_suite_t ***quic_ciphers;  /**< available ciphers by crypto engine */
 211   uword *available_crypto_engines;      /**< Bitmap for registered engines */
 212   u8 default_crypto_engine;             /**< Used if you do connect with CRYPTO_ENGINE_NONE (0) */
 213
 214   ptls_handshake_properties_t hs_properties;
 215   quicly_cid_plaintext_t next_cid;
 216   quic_session_cache_t session_cache;
 217
 218   u32 udp_fifo_size;
 219   u32 udp_fifo_prealloc;
 220   u32 connection_timeout;
 221 } quic_main_t;
 222
 223 #endif /* __included_quic_h__ */
 224
 225 /*
 226  * fd.io coding-style-patch-verification: ON
 227  *
 228  * Local Variables:
 229  * eval: (c-set-style "gnu")
 230  * End:
 231  */