1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2 /* 3 * INET An implementation of the TCP/IP protocol suite for the LINUX 4 * operating system. INET is implemented using the BSD Socket 5 * interface as the means of communication with the user level. 6 * 7 * Definitions for the TCP protocol. 8 * 9 * Version: @(#)tcp.h 1.0.2 04/28/93 10 * 11 * Author: Fred N. van Kempen, <[email protected]> 12 * 13 * This program is free software; you can redistribute it and/or 14 * modify it under the terms of the GNU General Public License 15 * as published by the Free Software Foundation; either version 16 * 2 of the License, or (at your option) any later version. 17 */ 18 #ifndef _UAPI_LINUX_TCP_H 19 #define _UAPI_LINUX_TCP_H 20 21 #include <linux/types.h> 22 #include <asm/byteorder.h> 23 #include <linux/socket.h> 24 25 struct tcphdr { 26 __be16 source; 27 __be16 dest; 28 __be32 seq; 29 __be32 ack_seq; 30 #if defined(__LITTLE_ENDIAN_BITFIELD) 31 __u16 res1:4, 32 doff:4, 33 fin:1, 34 syn:1, 35 rst:1, 36 psh:1, 37 ack:1, 38 urg:1, 39 ece:1, 40 cwr:1; 41 #elif defined(__BIG_ENDIAN_BITFIELD) 42 __u16 doff:4, 43 res1:4, 44 cwr:1, 45 ece:1, 46 urg:1, 47 ack:1, 48 psh:1, 49 rst:1, 50 syn:1, 51 fin:1; 52 #else 53 #error "Adjust your <asm/byteorder.h> defines" 54 #endif 55 __be16 window; 56 __sum16 check; 57 __be16 urg_ptr; 58 }; 59 60 /* 61 * The union cast uses a gcc extension to avoid aliasing problems 62 * (union is compatible to any of its members) 63 * This means this part of the code is -fstrict-aliasing safe now. 64 */ 65 union tcp_word_hdr { 66 struct tcphdr hdr; 67 __be32 words[5]; 68 }; 69 70 #define tcp_flag_word(tp) (((union tcp_word_hdr *)(tp))->words[3]) 71 72 enum { 73 TCP_FLAG_CWR = __constant_cpu_to_be32(0x00800000), 74 TCP_FLAG_ECE = __constant_cpu_to_be32(0x00400000), 75 TCP_FLAG_URG = __constant_cpu_to_be32(0x00200000), 76 TCP_FLAG_ACK = __constant_cpu_to_be32(0x00100000), 77 TCP_FLAG_PSH = __constant_cpu_to_be32(0x00080000), 78 TCP_FLAG_RST = __constant_cpu_to_be32(0x00040000), 79 TCP_FLAG_SYN = __constant_cpu_to_be32(0x00020000), 80 TCP_FLAG_FIN = __constant_cpu_to_be32(0x00010000), 81 TCP_RESERVED_BITS = __constant_cpu_to_be32(0x0F000000), 82 TCP_DATA_OFFSET = __constant_cpu_to_be32(0xF0000000) 83 }; 84 85 /* 86 * TCP general constants 87 */ 88 #define TCP_MSS_DEFAULT 536U /* IPv4 (RFC1122, RFC2581) */ 89 #define TCP_MSS_DESIRED 1220U /* IPv6 (tunneled), EDNS0 (RFC3226) */ 90 91 /* TCP socket options */ 92 #define TCP_NODELAY 1 /* Turn off Nagle's algorithm. */ 93 #define TCP_MAXSEG 2 /* Limit MSS */ 94 #define TCP_CORK 3 /* Never send partially complete segments */ 95 #define TCP_KEEPIDLE 4 /* Start keeplives after this period */ 96 #define TCP_KEEPINTVL 5 /* Interval between keepalives */ 97 #define TCP_KEEPCNT 6 /* Number of keepalives before death */ 98 #define TCP_SYNCNT 7 /* Number of SYN retransmits */ 99 #define TCP_LINGER2 8 /* Life time of orphaned FIN-WAIT-2 state */ 100 #define TCP_DEFER_ACCEPT 9 /* Wake up listener only when data arrive */ 101 #define TCP_WINDOW_CLAMP 10 /* Bound advertised window */ 102 #define TCP_INFO 11 /* Information about this connection. */ 103 #define TCP_QUICKACK 12 /* Block/reenable quick acks */ 104 #define TCP_CONGESTION 13 /* Congestion control algorithm */ 105 #define TCP_MD5SIG 14 /* TCP MD5 Signature (RFC2385) */ 106 #define TCP_THIN_LINEAR_TIMEOUTS 16 /* Use linear timeouts for thin streams*/ 107 #define TCP_THIN_DUPACK 17 /* Fast retrans. after 1 dupack */ 108 #define TCP_USER_TIMEOUT 18 /* How long for loss retry before timeout */ 109 #define TCP_REPAIR 19 /* TCP sock is under repair right now */ 110 #define TCP_REPAIR_QUEUE 20 111 #define TCP_QUEUE_SEQ 21 112 #define TCP_REPAIR_OPTIONS 22 113 #define TCP_FASTOPEN 23 /* Enable FastOpen on listeners */ 114 #define TCP_TIMESTAMP 24 115 #define TCP_NOTSENT_LOWAT 25 /* limit number of unsent bytes in write queue */ 116 #define TCP_CC_INFO 26 /* Get Congestion Control (optional) info */ 117 #define TCP_SAVE_SYN 27 /* Record SYN headers for new connections */ 118 #define TCP_SAVED_SYN 28 /* Get SYN headers recorded for connection */ 119 #define TCP_REPAIR_WINDOW 29 /* Get/set window parameters */ 120 #define TCP_FASTOPEN_CONNECT 30 /* Attempt FastOpen with connect */ 121 #define TCP_ULP 31 /* Attach a ULP to a TCP connection */ 122 #define TCP_MD5SIG_EXT 32 /* TCP MD5 Signature with extensions */ 123 #define TCP_FASTOPEN_KEY 33 /* Set the key for Fast Open (cookie) */ 124 #define TCP_FASTOPEN_NO_COOKIE 34 /* Enable TFO without a TFO cookie */ 125 #define TCP_ZEROCOPY_RECEIVE 35 126 #define TCP_INQ 36 /* Notify bytes available to read as a cmsg on read */ 127 128 #define TCP_CM_INQ TCP_INQ 129 130 #define TCP_TX_DELAY 37 /* delay outgoing packets by XX usec */ 131 132 #define TCP_AO_ADD_KEY 38 /* Add/Set MKT */ 133 #define TCP_AO_DEL_KEY 39 /* Delete MKT */ 134 #define TCP_AO_INFO 40 /* Set/list TCP-AO per-socket options */ 135 #define TCP_AO_GET_KEYS 41 /* List MKT(s) */ 136 #define TCP_AO_REPAIR 42 /* Get/Set SNEs and ISNs */ 137 138 #define TCP_IS_MPTCP 43 /* Is MPTCP being used? */ 139 #define TCP_RTO_MAX_MS 44 /* max rto time in ms */ 140 141 #define TCP_REPAIR_ON 1 142 #define TCP_REPAIR_OFF 0 143 #define TCP_REPAIR_OFF_NO_WP -1 /* Turn off without window probes */ 144 145 struct tcp_repair_opt { 146 __u32 opt_code; 147 __u32 opt_val; 148 }; 149 150 struct tcp_repair_window { 151 __u32 snd_wl1; 152 __u32 snd_wnd; 153 __u32 max_window; 154 155 __u32 rcv_wnd; 156 __u32 rcv_wup; 157 }; 158 159 enum { 160 TCP_NO_QUEUE, 161 TCP_RECV_QUEUE, 162 TCP_SEND_QUEUE, 163 TCP_QUEUES_NR, 164 }; 165 166 /* why fastopen failed from client perspective */ 167 enum tcp_fastopen_client_fail { 168 TFO_STATUS_UNSPEC, /* catch-all */ 169 TFO_COOKIE_UNAVAILABLE, /* if not in TFO_CLIENT_NO_COOKIE mode */ 170 TFO_DATA_NOT_ACKED, /* SYN-ACK did not ack SYN data */ 171 TFO_SYN_RETRANSMITTED, /* SYN-ACK did not ack SYN data after timeout */ 172 }; 173 174 /* for TCP_INFO socket option */ 175 #define TCPI_OPT_TIMESTAMPS 1 176 #define TCPI_OPT_SACK 2 177 #define TCPI_OPT_WSCALE 4 178 #define TCPI_OPT_ECN 8 /* ECN was negociated at TCP session init */ 179 #define TCPI_OPT_ECN_SEEN 16 /* we received at least one packet with ECT */ 180 #define TCPI_OPT_SYN_DATA 32 /* SYN-ACK acked data in SYN sent or rcvd */ 181 #define TCPI_OPT_USEC_TS 64 /* usec timestamps */ 182 183 /* 184 * Sender's congestion state indicating normal or abnormal situations 185 * in the last round of packets sent. The state is driven by the ACK 186 * information and timer events. 187 */ 188 enum tcp_ca_state { 189 /* 190 * Nothing bad has been observed recently. 191 * No apparent reordering, packet loss, or ECN marks. 192 */ 193 TCP_CA_Open = 0, 194 #define TCPF_CA_Open (1<<TCP_CA_Open) 195 /* 196 * The sender enters disordered state when it has received DUPACKs or 197 * SACKs in the last round of packets sent. This could be due to packet 198 * loss or reordering but needs further information to confirm packets 199 * have been lost. 200 */ 201 TCP_CA_Disorder = 1, 202 #define TCPF_CA_Disorder (1<<TCP_CA_Disorder) 203 /* 204 * The sender enters Congestion Window Reduction (CWR) state when it 205 * has received ACKs with ECN-ECE marks, or has experienced congestion 206 * or packet discard on the sender host (e.g. qdisc). 207 */ 208 TCP_CA_CWR = 2, 209 #define TCPF_CA_CWR (1<<TCP_CA_CWR) 210 /* 211 * The sender is in fast recovery and retransmitting lost packets, 212 * typically triggered by ACK events. 213 */ 214 TCP_CA_Recovery = 3, 215 #define TCPF_CA_Recovery (1<<TCP_CA_Recovery) 216 /* 217 * The sender is in loss recovery triggered by retransmission timeout. 218 */ 219 TCP_CA_Loss = 4 220 #define TCPF_CA_Loss (1<<TCP_CA_Loss) 221 }; 222 223 struct tcp_info { 224 __u8 tcpi_state; 225 __u8 tcpi_ca_state; 226 __u8 tcpi_retransmits; 227 __u8 tcpi_probes; 228 __u8 tcpi_backoff; 229 __u8 tcpi_options; 230 __u8 tcpi_snd_wscale : 4, tcpi_rcv_wscale : 4; 231 __u8 tcpi_delivery_rate_app_limited:1, tcpi_fastopen_client_fail:2; 232 233 __u32 tcpi_rto; 234 __u32 tcpi_ato; 235 __u32 tcpi_snd_mss; 236 __u32 tcpi_rcv_mss; 237 238 __u32 tcpi_unacked; 239 __u32 tcpi_sacked; 240 __u32 tcpi_lost; 241 __u32 tcpi_retrans; 242 __u32 tcpi_fackets; 243 244 /* Times. */ 245 __u32 tcpi_last_data_sent; 246 __u32 tcpi_last_ack_sent; /* Not remembered, sorry. */ 247 __u32 tcpi_last_data_recv; 248 __u32 tcpi_last_ack_recv; 249 250 /* Metrics. */ 251 __u32 tcpi_pmtu; 252 __u32 tcpi_rcv_ssthresh; 253 __u32 tcpi_rtt; 254 __u32 tcpi_rttvar; 255 __u32 tcpi_snd_ssthresh; 256 __u32 tcpi_snd_cwnd; 257 __u32 tcpi_advmss; 258 __u32 tcpi_reordering; 259 260 __u32 tcpi_rcv_rtt; 261 __u32 tcpi_rcv_space; 262 263 __u32 tcpi_total_retrans; 264 265 __u64 tcpi_pacing_rate; 266 __u64 tcpi_max_pacing_rate; 267 __u64 tcpi_bytes_acked; /* RFC4898 tcpEStatsAppHCThruOctetsAcked */ 268 __u64 tcpi_bytes_received; /* RFC4898 tcpEStatsAppHCThruOctetsReceived */ 269 __u32 tcpi_segs_out; /* RFC4898 tcpEStatsPerfSegsOut */ 270 __u32 tcpi_segs_in; /* RFC4898 tcpEStatsPerfSegsIn */ 271 272 __u32 tcpi_notsent_bytes; 273 __u32 tcpi_min_rtt; 274 __u32 tcpi_data_segs_in; /* RFC4898 tcpEStatsDataSegsIn */ 275 __u32 tcpi_data_segs_out; /* RFC4898 tcpEStatsDataSegsOut */ 276 277 __u64 tcpi_delivery_rate; 278 279 __u64 tcpi_busy_time; /* Time (usec) busy sending data */ 280 __u64 tcpi_rwnd_limited; /* Time (usec) limited by receive window */ 281 __u64 tcpi_sndbuf_limited; /* Time (usec) limited by send buffer */ 282 283 __u32 tcpi_delivered; 284 __u32 tcpi_delivered_ce; 285 286 __u64 tcpi_bytes_sent; /* RFC4898 tcpEStatsPerfHCDataOctetsOut */ 287 __u64 tcpi_bytes_retrans; /* RFC4898 tcpEStatsPerfOctetsRetrans */ 288 __u32 tcpi_dsack_dups; /* RFC4898 tcpEStatsStackDSACKDups */ 289 __u32 tcpi_reord_seen; /* reordering events seen */ 290 291 __u32 tcpi_rcv_ooopack; /* Out-of-order packets received */ 292 293 __u32 tcpi_snd_wnd; /* peer's advertised receive window after 294 * scaling (bytes) 295 */ 296 __u32 tcpi_rcv_wnd; /* local advertised receive window after 297 * scaling (bytes) 298 */ 299 300 __u32 tcpi_rehash; /* PLB or timeout triggered rehash attempts */ 301 302 __u16 tcpi_total_rto; /* Total number of RTO timeouts, including 303 * SYN/SYN-ACK and recurring timeouts. 304 */ 305 __u16 tcpi_total_rto_recoveries; /* Total number of RTO 306 * recoveries, including any 307 * unfinished recovery. 308 */ 309 __u32 tcpi_total_rto_time; /* Total time spent in RTO recoveries 310 * in milliseconds, including any 311 * unfinished recovery. 312 */ 313 }; 314 315 /* netlink attributes types for SCM_TIMESTAMPING_OPT_STATS */ 316 enum { 317 TCP_NLA_PAD, 318 TCP_NLA_BUSY, /* Time (usec) busy sending data */ 319 TCP_NLA_RWND_LIMITED, /* Time (usec) limited by receive window */ 320 TCP_NLA_SNDBUF_LIMITED, /* Time (usec) limited by send buffer */ 321 TCP_NLA_DATA_SEGS_OUT, /* Data pkts sent including retransmission */ 322 TCP_NLA_TOTAL_RETRANS, /* Data pkts retransmitted */ 323 TCP_NLA_PACING_RATE, /* Pacing rate in bytes per second */ 324 TCP_NLA_DELIVERY_RATE, /* Delivery rate in bytes per second */ 325 TCP_NLA_SND_CWND, /* Sending congestion window */ 326 TCP_NLA_REORDERING, /* Reordering metric */ 327 TCP_NLA_MIN_RTT, /* minimum RTT */ 328 TCP_NLA_RECUR_RETRANS, /* Recurring retransmits for the current pkt */ 329 TCP_NLA_DELIVERY_RATE_APP_LMT, /* delivery rate application limited ? */ 330 TCP_NLA_SNDQ_SIZE, /* Data (bytes) pending in send queue */ 331 TCP_NLA_CA_STATE, /* ca_state of socket */ 332 TCP_NLA_SND_SSTHRESH, /* Slow start size threshold */ 333 TCP_NLA_DELIVERED, /* Data pkts delivered incl. out-of-order */ 334 TCP_NLA_DELIVERED_CE, /* Like above but only ones w/ CE marks */ 335 TCP_NLA_BYTES_SENT, /* Data bytes sent including retransmission */ 336 TCP_NLA_BYTES_RETRANS, /* Data bytes retransmitted */ 337 TCP_NLA_DSACK_DUPS, /* DSACK blocks received */ 338 TCP_NLA_REORD_SEEN, /* reordering events seen */ 339 TCP_NLA_SRTT, /* smoothed RTT in usecs */ 340 TCP_NLA_TIMEOUT_REHASH, /* Timeout-triggered rehash attempts */ 341 TCP_NLA_BYTES_NOTSENT, /* Bytes in write queue not yet sent */ 342 TCP_NLA_EDT, /* Earliest departure time (CLOCK_MONOTONIC) */ 343 TCP_NLA_TTL, /* TTL or hop limit of a packet received */ 344 TCP_NLA_REHASH, /* PLB and timeout triggered rehash attempts */ 345 }; 346 347 /* for TCP_MD5SIG socket option */ 348 #define TCP_MD5SIG_MAXKEYLEN 80 349 350 /* tcp_md5sig extension flags for TCP_MD5SIG_EXT */ 351 #define TCP_MD5SIG_FLAG_PREFIX 0x1 /* address prefix length */ 352 #define TCP_MD5SIG_FLAG_IFINDEX 0x2 /* ifindex set */ 353 354 struct tcp_md5sig { 355 struct __kernel_sockaddr_storage tcpm_addr; /* address associated */ 356 __u8 tcpm_flags; /* extension flags */ 357 __u8 tcpm_prefixlen; /* address prefix */ 358 __u16 tcpm_keylen; /* key length */ 359 int tcpm_ifindex; /* device index for scope */ 360 __u8 tcpm_key[TCP_MD5SIG_MAXKEYLEN]; /* key (binary) */ 361 }; 362 363 /* INET_DIAG_MD5SIG */ 364 struct tcp_diag_md5sig { 365 __u8 tcpm_family; 366 __u8 tcpm_prefixlen; 367 __u16 tcpm_keylen; 368 __be32 tcpm_addr[4]; 369 __u8 tcpm_key[TCP_MD5SIG_MAXKEYLEN]; 370 }; 371 372 #define TCP_AO_MAXKEYLEN 80 373 374 #define TCP_AO_KEYF_IFINDEX (1 << 0) /* L3 ifindex for VRF */ 375 #define TCP_AO_KEYF_EXCLUDE_OPT (1 << 1) /* "Indicates whether TCP 376 * options other than TCP-AO 377 * are included in the MAC 378 * calculation" 379 */ 380 381 struct tcp_ao_add { /* setsockopt(TCP_AO_ADD_KEY) */ 382 struct __kernel_sockaddr_storage addr; /* peer's address for the key */ 383 char alg_name[64]; /* crypto hash algorithm to use */ 384 __s32 ifindex; /* L3 dev index for VRF */ 385 __u32 set_current :1, /* set key as Current_key at once */ 386 set_rnext :1, /* request it from peer with RNext_key */ 387 reserved :30; /* must be 0 */ 388 __u16 reserved2; /* padding, must be 0 */ 389 __u8 prefix; /* peer's address prefix */ 390 __u8 sndid; /* SendID for outgoing segments */ 391 __u8 rcvid; /* RecvID to match for incoming seg */ 392 __u8 maclen; /* length of authentication code (hash) */ 393 __u8 keyflags; /* see TCP_AO_KEYF_ */ 394 __u8 keylen; /* length of ::key */ 395 __u8 key[TCP_AO_MAXKEYLEN]; 396 } __attribute__((aligned(8))); 397 398 struct tcp_ao_del { /* setsockopt(TCP_AO_DEL_KEY) */ 399 struct __kernel_sockaddr_storage addr; /* peer's address for the key */ 400 __s32 ifindex; /* L3 dev index for VRF */ 401 __u32 set_current :1, /* corresponding ::current_key */ 402 set_rnext :1, /* corresponding ::rnext */ 403 del_async :1, /* only valid for listen sockets */ 404 reserved :29; /* must be 0 */ 405 __u16 reserved2; /* padding, must be 0 */ 406 __u8 prefix; /* peer's address prefix */ 407 __u8 sndid; /* SendID for outgoing segments */ 408 __u8 rcvid; /* RecvID to match for incoming seg */ 409 __u8 current_key; /* KeyID to set as Current_key */ 410 __u8 rnext; /* KeyID to set as Rnext_key */ 411 __u8 keyflags; /* see TCP_AO_KEYF_ */ 412 } __attribute__((aligned(8))); 413 414 struct tcp_ao_info_opt { /* setsockopt(TCP_AO_INFO), getsockopt(TCP_AO_INFO) */ 415 /* Here 'in' is for setsockopt(), 'out' is for getsockopt() */ 416 __u32 set_current :1, /* in/out: corresponding ::current_key */ 417 set_rnext :1, /* in/out: corresponding ::rnext */ 418 ao_required :1, /* in/out: don't accept non-AO connects */ 419 set_counters :1, /* in: set/clear ::pkt_* counters */ 420 accept_icmps :1, /* in/out: accept incoming ICMPs */ 421 reserved :27; /* must be 0 */ 422 __u16 reserved2; /* padding, must be 0 */ 423 __u8 current_key; /* in/out: KeyID of Current_key */ 424 __u8 rnext; /* in/out: keyid of RNext_key */ 425 __u64 pkt_good; /* in/out: verified segments */ 426 __u64 pkt_bad; /* in/out: failed verification */ 427 __u64 pkt_key_not_found; /* in/out: could not find a key to verify */ 428 __u64 pkt_ao_required; /* in/out: segments missing TCP-AO sign */ 429 __u64 pkt_dropped_icmp; /* in/out: ICMPs that were ignored */ 430 } __attribute__((aligned(8))); 431 432 struct tcp_ao_getsockopt { /* getsockopt(TCP_AO_GET_KEYS) */ 433 struct __kernel_sockaddr_storage addr; /* in/out: dump keys for peer 434 * with this address/prefix 435 */ 436 char alg_name[64]; /* out: crypto hash algorithm */ 437 __u8 key[TCP_AO_MAXKEYLEN]; 438 __u32 nkeys; /* in: size of the userspace buffer 439 * @optval, measured in @optlen - the 440 * sizeof(struct tcp_ao_getsockopt) 441 * out: number of keys that matched 442 */ 443 __u16 is_current :1, /* in: match and dump Current_key, 444 * out: the dumped key is Current_key 445 */ 446 447 is_rnext :1, /* in: match and dump RNext_key, 448 * out: the dumped key is RNext_key 449 */ 450 get_all :1, /* in: dump all keys */ 451 reserved :13; /* padding, must be 0 */ 452 __u8 sndid; /* in/out: dump keys with SendID */ 453 __u8 rcvid; /* in/out: dump keys with RecvID */ 454 __u8 prefix; /* in/out: dump keys with address/prefix */ 455 __u8 maclen; /* out: key's length of authentication 456 * code (hash) 457 */ 458 __u8 keyflags; /* in/out: see TCP_AO_KEYF_ */ 459 __u8 keylen; /* out: length of ::key */ 460 __s32 ifindex; /* in/out: L3 dev index for VRF */ 461 __u64 pkt_good; /* out: verified segments */ 462 __u64 pkt_bad; /* out: segments that failed verification */ 463 } __attribute__((aligned(8))); 464 465 struct tcp_ao_repair { /* {s,g}etsockopt(TCP_AO_REPAIR) */ 466 __be32 snt_isn; 467 __be32 rcv_isn; 468 __u32 snd_sne; 469 __u32 rcv_sne; 470 } __attribute__((aligned(8))); 471 472 /* setsockopt(fd, IPPROTO_TCP, TCP_ZEROCOPY_RECEIVE, ...) */ 473 474 #define TCP_RECEIVE_ZEROCOPY_FLAG_TLB_CLEAN_HINT 0x1 475 struct tcp_zerocopy_receive { 476 __u64 address; /* in: address of mapping */ 477 __u32 length; /* in/out: number of bytes to map/mapped */ 478 __u32 recv_skip_hint; /* out: amount of bytes to skip */ 479 __u32 inq; /* out: amount of bytes in read queue */ 480 __s32 err; /* out: socket error */ 481 __u64 copybuf_address; /* in: copybuf address (small reads) */ 482 __s32 copybuf_len; /* in/out: copybuf bytes avail/used or error */ 483 __u32 flags; /* in: flags */ 484 __u64 msg_control; /* ancillary data */ 485 __u64 msg_controllen; 486 __u32 msg_flags; 487 __u32 reserved; /* set to 0 for now */ 488 }; 489 #endif /* _UAPI_LINUX_TCP_H */ 490