| 1 | /* $Id: tcp_var.h 96407 2022-08-22 17:43:14Z vboxsync $ */
|
|---|
| 2 | /** @file
|
|---|
| 3 | * NAT - TCP (declarations).
|
|---|
| 4 | */
|
|---|
| 5 |
|
|---|
| 6 | /*
|
|---|
| 7 | * Copyright (C) 2006-2022 Oracle and/or its affiliates.
|
|---|
| 8 | *
|
|---|
| 9 | * This file is part of VirtualBox base platform packages, as
|
|---|
| 10 | * available from https://www.virtualbox.org.
|
|---|
| 11 | *
|
|---|
| 12 | * This program is free software; you can redistribute it and/or
|
|---|
| 13 | * modify it under the terms of the GNU General Public License
|
|---|
| 14 | * as published by the Free Software Foundation, in version 3 of the
|
|---|
| 15 | * License.
|
|---|
| 16 | *
|
|---|
| 17 | * This program is distributed in the hope that it will be useful, but
|
|---|
| 18 | * WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 19 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|---|
| 20 | * General Public License for more details.
|
|---|
| 21 | *
|
|---|
| 22 | * You should have received a copy of the GNU General Public License
|
|---|
| 23 | * along with this program; if not, see <https://www.gnu.org/licenses>.
|
|---|
| 24 | *
|
|---|
| 25 | * SPDX-License-Identifier: GPL-3.0-only
|
|---|
| 26 | */
|
|---|
| 27 |
|
|---|
| 28 | /*
|
|---|
| 29 | * This code is based on:
|
|---|
| 30 | *
|
|---|
| 31 | * Copyright (c) 1982, 1986, 1993, 1994
|
|---|
| 32 | * The Regents of the University of California. All rights reserved.
|
|---|
| 33 | *
|
|---|
| 34 | * Redistribution and use in source and binary forms, with or without
|
|---|
| 35 | * modification, are permitted provided that the following conditions
|
|---|
| 36 | * are met:
|
|---|
| 37 | * 1. Redistributions of source code must retain the above copyright
|
|---|
| 38 | * notice, this list of conditions and the following disclaimer.
|
|---|
| 39 | * 2. Redistributions in binary form must reproduce the above copyright
|
|---|
| 40 | * notice, this list of conditions and the following disclaimer in the
|
|---|
| 41 | * documentation and/or other materials provided with the distribution.
|
|---|
| 42 | * 3. Neither the name of the University nor the names of its contributors
|
|---|
| 43 | * may be used to endorse or promote products derived from this software
|
|---|
| 44 | * without specific prior written permission.
|
|---|
| 45 | *
|
|---|
| 46 | * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|---|
| 47 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|---|
| 48 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|---|
| 49 | * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|---|
| 50 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|---|
| 51 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|---|
| 52 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|---|
| 53 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|---|
| 54 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|---|
| 55 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|---|
| 56 | * SUCH DAMAGE.
|
|---|
| 57 | *
|
|---|
| 58 | * @(#)tcp_var.h 8.3 (Berkeley) 4/10/94
|
|---|
| 59 | * tcp_var.h,v 1.3 1994/08/21 05:27:39 paul Exp
|
|---|
| 60 | */
|
|---|
| 61 |
|
|---|
| 62 | #ifndef _TCP_VAR_H_
|
|---|
| 63 | #define _TCP_VAR_H_
|
|---|
| 64 |
|
|---|
| 65 | #include "queue.h"
|
|---|
| 66 | #include "tcpip.h"
|
|---|
| 67 | #include "tcp_timer.h"
|
|---|
| 68 |
|
|---|
| 69 | /* TCP segment queue entry */
|
|---|
| 70 | struct tseg_qent
|
|---|
| 71 | {
|
|---|
| 72 | LIST_ENTRY(tseg_qent) tqe_q;
|
|---|
| 73 | int tqe_len; /* TCP segment data length */
|
|---|
| 74 | struct tcphdr *tqe_th; /* a pointer to tcp header */
|
|---|
| 75 | struct mbuf *tqe_m; /* mbuf contains packet */
|
|---|
| 76 | };
|
|---|
| 77 | LIST_HEAD(tsegqe_head, tseg_qent);
|
|---|
| 78 |
|
|---|
| 79 | /*
|
|---|
| 80 | * Tcp control block, one per tcp; fields:
|
|---|
| 81 | */
|
|---|
| 82 | struct tcpcb
|
|---|
| 83 | {
|
|---|
| 84 | LIST_ENTRY(tcpcb) t_list;
|
|---|
| 85 | struct tsegqe_head t_segq; /* segment reassembly queue */
|
|---|
| 86 | int t_segqlen; /* segment reassembly queue length */
|
|---|
| 87 | int16_t t_state; /* state of this connection */
|
|---|
| 88 | int16_t t_timer[TCPT_NTIMERS]; /* tcp timers */
|
|---|
| 89 | int16_t t_rxtshift; /* log(2) of rexmt exp. backoff */
|
|---|
| 90 | int16_t t_rxtcur; /* current retransmit value */
|
|---|
| 91 | int16_t t_dupacks; /* consecutive dup acks recd */
|
|---|
| 92 | uint16_t t_maxseg; /* maximum segment size */
|
|---|
| 93 | char t_force; /* 1 if forcing out a byte */
|
|---|
| 94 | uint16_t t_flags;
|
|---|
| 95 | #define TF_ACKNOW 0x0001 /* ack peer immediately */
|
|---|
| 96 | #define TF_DELACK 0x0002 /* ack, but try to delay it */
|
|---|
| 97 | #define TF_NODELAY 0x0004 /* don't delay packets to coalesce */
|
|---|
| 98 | #define TF_NOOPT 0x0008 /* don't use tcp options */
|
|---|
| 99 | #define TF_SENTFIN 0x0010 /* have sent FIN */
|
|---|
| 100 | #define TF_REQ_SCALE 0x0020 /* have/will request window scaling */
|
|---|
| 101 | #define TF_RCVD_SCALE 0x0040 /* other side has requested scaling */
|
|---|
| 102 | #define TF_REQ_TSTMP 0x0080 /* have/will request timestamps */
|
|---|
| 103 | #define TF_RCVD_TSTMP 0x0100 /* a timestamp was received in SYN */
|
|---|
| 104 | #define TF_SACK_PERMIT 0x0200 /* other side said I could SACK */
|
|---|
| 105 |
|
|---|
| 106 | /* Make it static for now */
|
|---|
| 107 | /* struct tcpiphdr *t_template; / * skeletal packet for transmit */
|
|---|
| 108 | struct tcpiphdr t_template;
|
|---|
| 109 |
|
|---|
| 110 | struct socket *t_socket; /* back pointer to socket */
|
|---|
| 111 | /*
|
|---|
| 112 | * The following fields are used as in the protocol specification.
|
|---|
| 113 | * See RFC783, Dec. 1981, page 21.
|
|---|
| 114 | */
|
|---|
| 115 | /* send sequence variables */
|
|---|
| 116 | tcp_seq snd_una; /* send unacknowledged */
|
|---|
| 117 | tcp_seq snd_nxt; /* send next */
|
|---|
| 118 | tcp_seq snd_up; /* send urgent pointer */
|
|---|
| 119 | tcp_seq snd_wl1; /* window update seg seq number */
|
|---|
| 120 | tcp_seq snd_wl2; /* window update seg ack number */
|
|---|
| 121 | tcp_seq iss; /* initial send sequence number */
|
|---|
| 122 | uint32_t snd_wnd; /* send window */
|
|---|
| 123 | /* receive sequence variables */
|
|---|
| 124 | uint32_t rcv_wnd; /* receive window */
|
|---|
| 125 | tcp_seq rcv_nxt; /* receive next */
|
|---|
| 126 | tcp_seq rcv_up; /* receive urgent pointer */
|
|---|
| 127 | tcp_seq irs; /* initial receive sequence number */
|
|---|
| 128 | /*
|
|---|
| 129 | * Additional variables for this implementation.
|
|---|
| 130 | */
|
|---|
| 131 | /* receive variables */
|
|---|
| 132 | tcp_seq rcv_adv; /* advertised window */
|
|---|
| 133 | /* retransmit variables */
|
|---|
| 134 | tcp_seq snd_max; /* highest sequence number sent;
|
|---|
| 135 | * used to recognize retransmits
|
|---|
| 136 | */
|
|---|
| 137 | /* congestion control (for slow start, source quench, retransmit after loss) */
|
|---|
| 138 | uint32_t snd_cwnd; /* congestion-controlled window */
|
|---|
| 139 | uint32_t snd_ssthresh; /* snd_cwnd size threshold for
|
|---|
| 140 | * for slow start exponential to
|
|---|
| 141 | * linear switch
|
|---|
| 142 | */
|
|---|
| 143 | /*
|
|---|
| 144 | * transmit timing stuff. See below for scale of srtt and rttvar.
|
|---|
| 145 | * "Variance" is actually smoothed difference.
|
|---|
| 146 | */
|
|---|
| 147 | int16_t t_idle; /* inactivity time */
|
|---|
| 148 | int16_t t_rtt; /* round trip time */
|
|---|
| 149 | tcp_seq t_rtseq; /* sequence number being timed */
|
|---|
| 150 | int16_t t_srtt; /* smoothed round-trip time */
|
|---|
| 151 | int16_t t_rttvar; /* variance in round-trip time */
|
|---|
| 152 | uint16_t t_rttmin; /* minimum rtt allowed */
|
|---|
| 153 | uint32_t max_sndwnd; /* largest window peer has offered */
|
|---|
| 154 |
|
|---|
| 155 | /* out-of-band data */
|
|---|
| 156 | char t_oobflags; /* have some */
|
|---|
| 157 | char t_iobc; /* input character */
|
|---|
| 158 | #define TCPOOB_HAVEDATA 0x01
|
|---|
| 159 | #define TCPOOB_HADDATA 0x02
|
|---|
| 160 | short t_softerror; /* possible error not yet reported */
|
|---|
| 161 |
|
|---|
| 162 | /* RFC 1323 variables */
|
|---|
| 163 | uint8_t snd_scale; /* window scaling for send window */
|
|---|
| 164 | uint8_t rcv_scale; /* window scaling for recv window */
|
|---|
| 165 | uint8_t request_r_scale; /* pending window scaling */
|
|---|
| 166 | uint8_t requested_s_scale;
|
|---|
| 167 | uint32_t ts_recent; /* timestamp echo data */
|
|---|
| 168 | uint32_t ts_recent_age; /* when last updated */
|
|---|
| 169 | tcp_seq last_ack_sent;
|
|---|
| 170 | };
|
|---|
| 171 |
|
|---|
| 172 | LIST_HEAD(tcpcbhead, tcpcb);
|
|---|
| 173 |
|
|---|
| 174 | #define sototcpcb(so) ((so)->so_tcpcb)
|
|---|
| 175 |
|
|---|
| 176 | /*
|
|---|
| 177 | * The smoothed round-trip time and estimated variance
|
|---|
| 178 | * are stored as fixed point numbers scaled by the values below.
|
|---|
| 179 | * For convenience, these scales are also used in smoothing the average
|
|---|
| 180 | * (smoothed = (1/scale)sample + ((scale-1)/scale)smoothed).
|
|---|
| 181 | * With these scales, srtt has 3 bits to the right of the binary point,
|
|---|
| 182 | * and thus an "ALPHA" of 0.875. rttvar has 2 bits to the right of the
|
|---|
| 183 | * binary point, and is smoothed with an ALPHA of 0.75.
|
|---|
| 184 | */
|
|---|
| 185 | #define TCP_RTT_SCALE 8 /* multiplier for srtt; 3 bits frac. */
|
|---|
| 186 | #define TCP_RTT_SHIFT 3 /* shift for srtt; 3 bits frac. */
|
|---|
| 187 | #define TCP_RTTVAR_SCALE 4 /* multiplier for rttvar; 2 bits */
|
|---|
| 188 | #define TCP_RTTVAR_SHIFT 2 /* multiplier for rttvar; 2 bits */
|
|---|
| 189 |
|
|---|
| 190 | /*
|
|---|
| 191 | * The initial retransmission should happen at rtt + 4 * rttvar.
|
|---|
| 192 | * Because of the way we do the smoothing, srtt and rttvar
|
|---|
| 193 | * will each average +1/2 tick of bias. When we compute
|
|---|
| 194 | * the retransmit timer, we want 1/2 tick of rounding and
|
|---|
| 195 | * 1 extra tick because of +-1/2 tick uncertainty in the
|
|---|
| 196 | * firing of the timer. The bias will give us exactly the
|
|---|
| 197 | * 1.5 tick we need. But, because the bias is
|
|---|
| 198 | * statistical, we have to test that we don't drop below
|
|---|
| 199 | * the minimum feasible timer (which is 2 ticks).
|
|---|
| 200 | * This macro assumes that the value of TCP_RTTVAR_SCALE
|
|---|
| 201 | * is the same as the multiplier for rttvar.
|
|---|
| 202 | */
|
|---|
| 203 | #define TCP_REXMTVAL(tp) \
|
|---|
| 204 | (((tp)->t_srtt >> TCP_RTT_SHIFT) + (tp)->t_rttvar)
|
|---|
| 205 |
|
|---|
| 206 | /*
|
|---|
| 207 | * TCP statistics.
|
|---|
| 208 | * Many of these should be kept per connection,
|
|---|
| 209 | * but that's inconvenient at the moment.
|
|---|
| 210 | */
|
|---|
| 211 | struct tcpstat_t
|
|---|
| 212 | {
|
|---|
| 213 | u_long tcps_connattempt; /* connections initiated */
|
|---|
| 214 | u_long tcps_accepts; /* connections accepted */
|
|---|
| 215 | u_long tcps_connects; /* connections established */
|
|---|
| 216 | u_long tcps_drops; /* connections dropped */
|
|---|
| 217 | u_long tcps_conndrops; /* embryonic connections dropped */
|
|---|
| 218 | u_long tcps_closed; /* conn. closed (includes drops) */
|
|---|
| 219 | u_long tcps_segstimed; /* segs where we tried to get rtt */
|
|---|
| 220 | u_long tcps_rttupdated; /* times we succeeded */
|
|---|
| 221 | u_long tcps_delack; /* delayed acks sent */
|
|---|
| 222 | u_long tcps_timeoutdrop; /* conn. dropped in rxmt timeout */
|
|---|
| 223 | u_long tcps_rexmttimeo; /* retransmit timeouts */
|
|---|
| 224 | u_long tcps_persisttimeo; /* persist timeouts */
|
|---|
| 225 | u_long tcps_keeptimeo; /* keepalive timeouts */
|
|---|
| 226 | u_long tcps_keepprobe; /* keepalive probes sent */
|
|---|
| 227 | u_long tcps_keepdrops; /* connections dropped in keepalive */
|
|---|
| 228 |
|
|---|
| 229 | u_long tcps_sndtotal; /* total packets sent */
|
|---|
| 230 | u_long tcps_sndpack; /* data packets sent */
|
|---|
| 231 | u_long tcps_sndbyte; /* data bytes sent */
|
|---|
| 232 | u_long tcps_sndrexmitpack; /* data packets retransmitted */
|
|---|
| 233 | u_long tcps_sndrexmitbyte; /* data bytes retransmitted */
|
|---|
| 234 | u_long tcps_sndacks; /* ack-only packets sent */
|
|---|
| 235 | u_long tcps_sndprobe; /* window probes sent */
|
|---|
| 236 | u_long tcps_sndurg; /* packets sent with URG only */
|
|---|
| 237 | u_long tcps_sndwinup; /* window update-only packets sent */
|
|---|
| 238 | u_long tcps_sndctrl; /* control (SYN|FIN|RST) packets sent */
|
|---|
| 239 |
|
|---|
| 240 | u_long tcps_rcvtotal; /* total packets received */
|
|---|
| 241 | u_long tcps_rcvpack; /* packets received in sequence */
|
|---|
| 242 | u_long tcps_rcvbyte; /* bytes received in sequence */
|
|---|
| 243 | u_long tcps_rcvbadsum; /* packets received with ccksum errs */
|
|---|
| 244 | u_long tcps_rcvbadoff; /* packets received with bad offset */
|
|---|
| 245 | /* u_long tcps_rcvshort; */ /* packets received too short */
|
|---|
| 246 | u_long tcps_rcvduppack; /* duplicate-only packets received */
|
|---|
| 247 | u_long tcps_rcvdupbyte; /* duplicate-only bytes received */
|
|---|
| 248 | u_long tcps_rcvpartduppack; /* packets with some duplicate data */
|
|---|
| 249 | u_long tcps_rcvpartdupbyte; /* dup. bytes in part-dup. packets */
|
|---|
| 250 | u_long tcps_rcvoopack; /* out-of-order packets received */
|
|---|
| 251 | u_long tcps_rcvoobyte; /* out-of-order bytes received */
|
|---|
| 252 | u_long tcps_rcvpackafterwin; /* packets with data after window */
|
|---|
| 253 | u_long tcps_rcvbyteafterwin; /* bytes rcvd after window */
|
|---|
| 254 | u_long tcps_rcvafterclose; /* packets rcvd after "close" */
|
|---|
| 255 | u_long tcps_rcvwinprobe; /* rcvd window probe packets */
|
|---|
| 256 | u_long tcps_rcvdupack; /* rcvd duplicate acks */
|
|---|
| 257 | u_long tcps_rcvacktoomuch; /* rcvd acks for unsent data */
|
|---|
| 258 | u_long tcps_rcvackpack; /* rcvd ack packets */
|
|---|
| 259 | u_long tcps_rcvackbyte; /* bytes acked by rcvd acks */
|
|---|
| 260 | u_long tcps_rcvwinupd; /* rcvd window update packets */
|
|---|
| 261 | /* u_long tcps_pawsdrop; */ /* segments dropped due to PAWS */
|
|---|
| 262 | u_long tcps_predack; /* times hdr predict ok for acks */
|
|---|
| 263 | u_long tcps_preddat; /* times hdr predict ok for data pkts */
|
|---|
| 264 | u_long tcps_socachemiss; /* tcp_last_so misses */
|
|---|
| 265 | u_long tcps_didnuttin; /* Times tcp_output didn't do anything XXX */
|
|---|
| 266 | u_long tcps_rcvmemdrop;
|
|---|
| 267 | };
|
|---|
| 268 |
|
|---|
| 269 | #endif
|
|---|
