1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
|
/*
* Copyright (c) 2016-2019 Cisco and/or its affiliates.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef _vnet_tcp_h_
#define _vnet_tcp_h_
#include <vnet/vnet.h>
#include <vnet/ip/ip.h>
#include <vnet/tcp/tcp_packet.h>
#include <vnet/tcp/tcp_timer.h>
#include <vnet/session/transport.h>
#include <vnet/session/session.h>
#include <vnet/tcp/tcp_debug.h>
#define TCP_TICK 0.001 /**< TCP tick period (s) */
#define THZ (u32) (1/TCP_TICK) /**< TCP tick frequency */
#define TCP_TSTAMP_RESOLUTION TCP_TICK /**< Time stamp resolution */
#define TCP_PAWS_IDLE 24 * 24 * 60 * 60 * THZ /**< 24 days */
#define TCP_FIB_RECHECK_PERIOD 1 * THZ /**< Recheck every 1s */
#define TCP_MAX_OPTION_SPACE 40
#define TCP_CC_DATA_SZ 24
#define TCP_MAX_GSO_SZ 65536
#define TCP_DUPACK_THRESHOLD 3
#define TCP_IW_N_SEGMENTS 10
#define TCP_ALWAYS_ACK 1 /**< On/off delayed acks */
#define TCP_USE_SACKS 1 /**< Disable only for testing */
/** TCP FSM state definitions as per RFC793. */
#define foreach_tcp_fsm_state \
_(CLOSED, "CLOSED") \
_(LISTEN, "LISTEN") \
_(SYN_SENT, "SYN_SENT") \
_(SYN_RCVD, "SYN_RCVD") \
_(ESTABLISHED, "ESTABLISHED") \
_(CLOSE_WAIT, "CLOSE_WAIT") \
_(FIN_WAIT_1, "FIN_WAIT_1") \
_(LAST_ACK, "LAST_ACK") \
_(CLOSING, "CLOSING") \
_(FIN_WAIT_2, "FIN_WAIT_2") \
_(TIME_WAIT, "TIME_WAIT")
typedef enum _tcp_state
{
#define _(sym, str) TCP_STATE_##sym,
foreach_tcp_fsm_state
#undef _
TCP_N_STATES
} tcp_state_t;
format_function_t format_tcp_state;
format_function_t format_tcp_flags;
format_function_t format_tcp_sacks;
format_function_t format_tcp_rcv_sacks;
/** TCP timers */
#define foreach_tcp_timer \
_(RETRANSMIT, "RETRANSMIT") \
_(DELACK, "DELAYED ACK") \
_(PERSIST, "PERSIST") \
_(WAITCLOSE, "WAIT CLOSE") \
_(RETRANSMIT_SYN, "RETRANSMIT SYN") \
typedef enum _tcp_timers
{
#define _(sym, str) TCP_TIMER_##sym,
foreach_tcp_timer
#undef _
TCP_N_TIMERS
} tcp_timers_e;
typedef void (timer_expiration_handler) (u32 index);
extern timer_expiration_handler tcp_timer_delack_handler;
extern timer_expiration_handler tcp_timer_retransmit_handler;
extern timer_expiration_handler tcp_timer_persist_handler;
extern timer_expiration_handler tcp_timer_retransmit_syn_handler;
#define TCP_TIMER_HANDLE_INVALID ((u32) ~0)
#define TCP_TIMER_TICK 0.1 /**< Timer tick in seconds */
#define TCP_TO_TIMER_TICK TCP_TICK*10 /**< Factor for converting
ticks to timer ticks */
#define TCP_RTO_MAX 60 * THZ /* Min max RTO (60s) as per RFC6298 */
#define TCP_RTO_MIN 0.2 * THZ /* Min RTO (200ms) - lower than standard */
#define TCP_RTT_MAX 30 * THZ /* 30s (probably too much) */
#define TCP_RTO_SYN_RETRIES 3 /* SYN retries without doubling RTO */
#define TCP_RTO_INIT 1 * THZ /* Initial retransmit timer */
#define TCP_RTO_BOFF_MAX 8 /* Max number of retries before reset */
#define TCP_ESTABLISH_TIME (60 * THZ) /* Connection establish timeout */
/** TCP connection flags */
#define foreach_tcp_connection_flag \
_(SNDACK, "Send ACK") \
_(FINSNT, "FIN sent") \
_(RECOVERY, "Recovery") \
_(FAST_RECOVERY, "Fast Recovery") \
_(DCNT_PENDING, "Disconnect pending") \
_(HALF_OPEN_DONE, "Half-open completed") \
_(FINPNDG, "FIN pending") \
_(FRXT_PENDING, "Fast-retransmit pending") \
_(FRXT_FIRST, "Fast-retransmit first again") \
_(DEQ_PENDING, "Pending dequeue acked") \
_(PSH_PENDING, "PSH pending") \
_(FINRCVD, "FIN received") \
_(RATE_SAMPLE, "Conn does rate sampling") \
_(TRACK_BURST, "Track burst") \
_(ZERO_RWND_SENT, "Zero RWND sent") \
typedef enum _tcp_connection_flag_bits
{
#define _(sym, str) TCP_CONN_##sym##_BIT,
foreach_tcp_connection_flag
#undef _
TCP_CONN_N_FLAG_BITS
} tcp_connection_flag_bits_e;
typedef enum _tcp_connection_flag
{
#define _(sym, str) TCP_CONN_##sym = 1 << TCP_CONN_##sym##_BIT,
foreach_tcp_connection_flag
#undef _
TCP_CONN_N_FLAGS
} tcp_connection_flags_e;
#define TCP_SCOREBOARD_TRACE (0)
#define TCP_MAX_SACK_BLOCKS 256 /**< Max number of SACK blocks stored */
#define TCP_INVALID_SACK_HOLE_INDEX ((u32)~0)
typedef struct _scoreboard_trace_elt
{
u32 start;
u32 end;
u32 ack;
u32 snd_una_max;
u32 group;
} scoreboard_trace_elt_t;
typedef struct _sack_scoreboard_hole
{
u32 next; /**< Index for next entry in linked list */
u32 prev; /**< Index for previous entry in linked list */
u32 start; /**< Start sequence number */
u32 end; /**< End sequence number */
u8 is_lost; /**< Mark hole as lost */
} sack_scoreboard_hole_t;
typedef struct _sack_scoreboard
{
sack_scoreboard_hole_t *holes; /**< Pool of holes */
u32 head; /**< Index of first entry */
u32 tail; /**< Index of last entry */
u32 sacked_bytes; /**< Number of bytes sacked in sb */
u32 last_sacked_bytes; /**< Number of bytes last sacked */
u32 last_bytes_delivered; /**< Sack bytes delivered to app */
u32 high_sacked; /**< Highest byte sacked (fack) */
u32 high_rxt; /**< Highest retransmitted sequence */
u32 rescue_rxt; /**< Rescue sequence number */
u32 lost_bytes; /**< Bytes lost as per RFC6675 */
u32 last_lost_bytes; /**< Number of bytes last lost */
u32 cur_rxt_hole; /**< Retransmitting from this hole */
u8 is_reneging;
#if TCP_SCOREBOARD_TRACE
scoreboard_trace_elt_t *trace;
#endif
} sack_scoreboard_t;
#if TCP_SCOREBOARD_TRACE
#define tcp_scoreboard_trace_add(_tc, _ack) \
{ \
static u64 _group = 0; \
sack_scoreboard_t *_sb = &_tc->sack_sb; \
sack_block_t *_sack, *_sacks; \
scoreboard_trace_elt_t *_elt; \
int i; \
_group++; \
_sacks = _tc->rcv_opts.sacks; \
for (i = 0; i < vec_len (_sacks); i++) \
{ \
_sack = &_sacks[i]; \
vec_add2 (_sb->trace, _elt, 1); \
_elt->start = _sack->start; \
_elt->end = _sack->end; \
_elt->ack = _elt->end == _ack ? _ack : 0; \
_elt->snd_una_max = _elt->end == _ack ? _tc->snd_una_max : 0; \
_elt->group = _group; \
} \
}
#else
#define tcp_scoreboard_trace_add(_tc, _ack)
#endif
sack_scoreboard_hole_t *scoreboard_next_rxt_hole (sack_scoreboard_t * sb,
sack_scoreboard_hole_t *
start, u8 have_sent_1_smss,
u8 * can_rescue,
u8 * snd_limited);
sack_scoreboard_hole_t *scoreboard_get_hole (sack_scoreboard_t * sb,
u32 index);
sack_scoreboard_hole_t *scoreboard_next_hole (sack_scoreboard_t * sb,
sack_scoreboard_hole_t * hole);
sack_scoreboard_hole_t *scoreboard_prev_hole (sack_scoreboard_t * sb,
sack_scoreboard_hole_t * hole);
sack_scoreboard_hole_t *scoreboard_first_hole (sack_scoreboard_t * sb);
sack_scoreboard_hole_t *scoreboard_last_hole (sack_scoreboard_t * sb);
void scoreboard_clear (sack_scoreboard_t * sb);
void scoreboard_init (sack_scoreboard_t * sb);
u8 *format_tcp_scoreboard (u8 * s, va_list * args);
#define TCP_BTS_INVALID_INDEX ((u32)~0)
typedef enum tcp_bts_flags_
{
TCP_BTS_IS_RXT = 1,
TCP_BTS_IS_APP_LIMITED = 1 << 1,
} __clib_packed tcp_bts_flags_t;
typedef struct tcp_bt_sample_
{
u32 next; /**< Next sample index in list */
u32 prev; /**< Previous sample index in list */
u32 min_seq; /**< Min seq number in sample */
u32 max_seq; /**< Max seq number. Set for rxt samples */
u64 delivered; /**< Total delivered bytes for sample */
f64 delivered_time; /**< Delivered time when sample taken */
f64 tx_time; /**< Transmit time for the burst */
f64 first_tx_time; /**< Connection first tx time at tx */
tcp_bts_flags_t flags; /**< Sample flag */
} tcp_bt_sample_t;
typedef struct tcp_rate_sample_
{
u64 prior_delivered; /**< Delivered of sample used for rate, i.e.,
total bytes delivered at prior_time */
f64 prior_time; /**< Delivered time of sample used for rate */
f64 interval_time; /**< Time to ack the bytes delivered */
f64 rtt_time; /**< RTT for sample */
u32 delivered; /**< Bytes delivered in interval_time */
u32 acked_and_sacked; /**< Bytes acked + sacked now */
u32 lost; /**< Bytes lost now */
tcp_bts_flags_t flags; /**< Rate sample flags from bt sample */
} tcp_rate_sample_t;
typedef struct tcp_byte_tracker_
{
tcp_bt_sample_t *samples; /**< Pool of samples */
rb_tree_t sample_lookup; /**< Rbtree for sample lookup by min_seq */
u32 head; /**< Head of samples linked list */
u32 tail; /**< Tail of samples linked list */
u32 last_ooo; /**< Cached last ooo sample */
} tcp_byte_tracker_t;
typedef enum _tcp_cc_algorithm_type
{
TCP_CC_NEWRENO,
TCP_CC_CUBIC,
TCP_CC_LAST = TCP_CC_CUBIC
} tcp_cc_algorithm_type_e;
typedef struct _tcp_cc_algorithm tcp_cc_algorithm_t;
typedef enum _tcp_cc_ack_t
{
TCP_CC_ACK,
TCP_CC_DUPACK,
TCP_CC_PARTIALACK
} tcp_cc_ack_t;
typedef enum tcp_cc_event_
{
TCP_CC_EVT_START_TX,
} tcp_cc_event_t;
/*
* As per RFC4898 tcpEStatsStackSoftErrors
*/
typedef struct tcp_errors_
{
u32 below_data_wnd; /**< All data in seg is below snd_una */
u32 above_data_wnd; /**< Some data in segment is above snd_wnd */
u32 below_ack_wnd; /**< Acks for data below snd_una */
u32 above_ack_wnd; /**< Acks for data not sent */
} tcp_errors_t;
typedef struct _tcp_connection
{
CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
transport_connection_t connection; /**< Common transport data. First! */
u8 state; /**< TCP state as per tcp_state_t */
u8 is_tso; /** is connection could use tso */
u16 flags; /**< Connection flags (see tcp_conn_flags_e) */
u32 timers[TCP_N_TIMERS]; /**< Timer handles into timer wheel */
u64 segs_in; /** RFC4022/4898 tcpHCInSegs/tcpEStatsPerfSegsIn */
u64 bytes_in; /** RFC4898 tcpEStatsPerfHCDataOctetsIn */
u64 segs_out; /** RFC4898 tcpEStatsPerfSegsOut */
u64 bytes_out; /** RFC4898 tcpEStatsPerfHCDataOctetsOut */
/** Send sequence variables RFC793 */
u32 snd_una; /**< oldest unacknowledged sequence number */
u32 snd_una_max; /**< newest unacknowledged sequence number + 1*/
u32 snd_wnd; /**< send window */
u32 snd_wl1; /**< seq number used for last snd.wnd update */
u32 snd_wl2; /**< ack number used for last snd.wnd update */
u32 snd_nxt; /**< next seq number to be sent */
u16 snd_mss; /**< Effective send max seg (data) size */
u64 data_segs_in; /** RFC4898 tcpEStatsPerfDataSegsIn */
u64 data_segs_out; /** RFC4898 tcpEStatsPerfDataSegsOut */
/** Receive sequence variables RFC793 */
u32 rcv_nxt; /**< next sequence number expected */
u32 rcv_wnd; /**< receive window we expect */
u32 rcv_las; /**< rcv_nxt at last ack sent/rcv_wnd update */
u32 iss; /**< initial sent sequence */
u32 irs; /**< initial remote sequence */
/* Options */
u8 snd_opts_len; /**< Tx options len */
u8 rcv_wscale; /**< Window scale to advertise to peer */
u8 snd_wscale; /**< Window scale to use when sending */
u32 tsval_recent; /**< Last timestamp received */
u32 tsval_recent_age; /**< When last updated tstamp_recent*/
tcp_options_t snd_opts; /**< Tx options for connection */
tcp_options_t rcv_opts; /**< Rx options for connection */
sack_block_t *snd_sacks; /**< Vector of SACKs to send. XXX Fixed size? */
u8 snd_sack_pos; /**< Position in vec of first block to send */
sack_block_t *snd_sacks_fl; /**< Vector for building new list */
sack_scoreboard_t sack_sb; /**< SACK "scoreboard" that tracks holes */
u16 rcv_dupacks; /**< Number of recent DUPACKs received */
u32 dupacks_in; /**< RFC4898 tcpEStatsStackDupAcksIn*/
u8 pending_dupacks; /**< Number of DUPACKs to be sent */
u32 dupacks_out; /**< RFC4898 tcpEStatsPathDupAcksOut */
/* Congestion control */
u32 cwnd; /**< Congestion window */
u32 cwnd_acc_bytes; /**< Bytes accumulated for cwnd increment */
u32 ssthresh; /**< Slow-start threshold */
u32 prev_ssthresh; /**< ssthresh before congestion */
u32 prev_cwnd; /**< ssthresh before congestion */
u32 bytes_acked; /**< Bytes acknowledged by current segment */
u32 burst_acked; /**< Bytes acknowledged in current burst */
u32 snd_rxt_bytes; /**< Retransmitted bytes */
u32 snd_rxt_ts; /**< Timestamp when first packet is retransmitted */
u32 tsecr_last_ack; /**< Timestamp echoed to us in last healthy ACK */
u32 snd_congestion; /**< snd_una_max when congestion is detected */
u32 tx_fifo_size; /**< Tx fifo size. Used to constrain cwnd */
tcp_cc_algorithm_t *cc_algo; /**< Congestion control algorithm */
u8 cc_data[TCP_CC_DATA_SZ]; /**< Congestion control algo private data */
u32 fr_occurences; /**< fast-retransmit occurrences RFC4898
tcpEStatsStackFastRetran */
u32 tr_occurences; /**< timer-retransmit occurrences */
u64 bytes_retrans; /**< RFC4898 tcpEStatsPerfOctetsRetrans */
u64 segs_retrans; /**< RFC4898 tcpEStatsPerfSegsRetrans*/
/* RTT and RTO */
u32 rto; /**< Retransmission timeout */
u32 rto_boff; /**< Index for RTO backoff */
u32 srtt; /**< Smoothed RTT */
u32 rttvar; /**< Smoothed mean RTT difference. Approximates variance */
u32 rtt_seq; /**< Sequence number for tracked ACK */
f64 rtt_ts; /**< Timestamp for tracked ACK */
f64 mrtt_us; /**< High precision mrtt from tracked acks */
u32 psh_seq; /**< Add psh header for seg that includes this */
u32 next_node_index; /**< Can be used to control next node in output */
u32 next_node_opaque; /**< Opaque to pass to next node */
u32 limited_transmit; /**< snd_nxt when limited transmit starts */
u32 sw_if_index; /**< Interface for the connection */
/* Delivery rate estimation */
u64 delivered; /**< Total bytes delivered to peer */
u64 app_limited; /**< Delivered when app-limited detected */
f64 delivered_time; /**< Time last bytes were acked */
f64 first_tx_time; /**< Send time for recently delivered/sent */
tcp_byte_tracker_t *bt; /**< Tx byte tracker */
tcp_errors_t errors; /**< Soft connection errors */
f64 start_ts; /**< Timestamp when connection initialized */
u32 last_fib_check; /**< Last time we checked fib route for peer */
u16 mss; /**< Our max seg size that includes options */
u32 timestamp_delta; /**< Offset for timestamp */
} tcp_connection_t;
/* *INDENT-OFF* */
struct _tcp_cc_algorithm
{
const char *name;
uword (*unformat_cfg) (unformat_input_t * input);
void (*init) (tcp_connection_t * tc);
void (*cleanup) (tcp_connection_t * tc);
void (*rcv_ack) (tcp_connection_t * tc, tcp_rate_sample_t *rs);
void (*rcv_cong_ack) (tcp_connection_t * tc, tcp_cc_ack_t ack,
tcp_rate_sample_t *rs);
void (*congestion) (tcp_connection_t * tc);
void (*loss) (tcp_connection_t * tc);
void (*recovered) (tcp_connection_t * tc);
void (*undo_recovery) (tcp_connection_t * tc);
void (*event) (tcp_connection_t *tc, tcp_cc_event_t evt);
u64 (*get_pacing_rate) (tcp_connection_t *tc);
};
/* *INDENT-ON* */
#define tcp_fastrecovery_on(tc) (tc)->flags |= TCP_CONN_FAST_RECOVERY
#define tcp_fastrecovery_off(tc) (tc)->flags &= ~TCP_CONN_FAST_RECOVERY
#define tcp_recovery_on(tc) (tc)->flags |= TCP_CONN_RECOVERY
#define tcp_recovery_off(tc) (tc)->flags &= ~TCP_CONN_RECOVERY
#define tcp_in_fastrecovery(tc) ((tc)->flags & TCP_CONN_FAST_RECOVERY)
#define tcp_in_recovery(tc) ((tc)->flags & (TCP_CONN_RECOVERY))
#define tcp_in_slowstart(tc) (tc->cwnd < tc->ssthresh)
#define tcp_disconnect_pending(tc) ((tc)->flags & TCP_CONN_DCNT_PENDING)
#define tcp_disconnect_pending_on(tc) ((tc)->flags |= TCP_CONN_DCNT_PENDING)
#define tcp_disconnect_pending_off(tc) ((tc)->flags &= ~TCP_CONN_DCNT_PENDING)
#define tcp_fastrecovery_first(tc) ((tc)->flags & TCP_CONN_FRXT_FIRST)
#define tcp_fastrecovery_first_on(tc) ((tc)->flags |= TCP_CONN_FRXT_FIRST)
#define tcp_fastrecovery_first_off(tc) ((tc)->flags &= ~TCP_CONN_FRXT_FIRST)
#define tcp_in_cong_recovery(tc) ((tc)->flags & \
(TCP_CONN_FAST_RECOVERY | TCP_CONN_RECOVERY))
always_inline void
tcp_cong_recovery_off (tcp_connection_t * tc)
{
tc->flags &= ~(TCP_CONN_FAST_RECOVERY | TCP_CONN_RECOVERY);
tcp_fastrecovery_first_off (tc);
}
#define tcp_zero_rwnd_sent(tc) ((tc)->flags & TCP_CONN_ZERO_RWND_SENT)
#define tcp_zero_rwnd_sent_on(tc) (tc)->flags |= TCP_CONN_ZERO_RWND_SENT
#define tcp_zero_rwnd_sent_off(tc) (tc)->flags &= ~TCP_CONN_ZERO_RWND_SENT
typedef enum _tcp_error
{
#define tcp_error(n,s) TCP_ERROR_##n,
#include <vnet/tcp/tcp_error.def>
#undef tcp_error
TCP_N_ERROR,
} tcp_error_t;
typedef struct _tcp_lookup_dispatch
{
u8 next, error;
} tcp_lookup_dispatch_t;
typedef struct tcp_worker_ctx_
{
CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
/** worker time */
u32 time_now;
/** worker timer wheel */
tw_timer_wheel_16t_2w_512sl_t timer_wheel;
/** tx buffer free list */
u32 *tx_buffers;
/** tx frames for tcp 4/6 output nodes */
vlib_frame_t *tx_frames[2];
/** tx frames for ip 4/6 lookup nodes */
vlib_frame_t *ip_lookup_tx_frames[2];
/** vector of pending ack dequeues */
u32 *pending_deq_acked;
/** vector of pending disconnect notifications */
u32 *pending_disconnects;
/** convenience pointer to this thread's vlib main */
vlib_main_t *vm;
CLIB_CACHE_LINE_ALIGN_MARK (cacheline1);
/** cached 'on the wire' options for bursts */
u8 cached_opts[40];
} tcp_worker_ctx_t;
typedef struct tcp_iss_seed_
{
u64 first;
u64 second;
} tcp_iss_seed_t;
typedef struct tcp_configuration_
{
/** Max rx fifo size for a session (in bytes). It is used in to compute the
* rfc 7323 window scaling factor */
u32 max_rx_fifo;
/** Min rx fifo for a session (in bytes) */
u32 min_rx_fifo;
/** Default MTU to be used when establishing connections */
u16 default_mtu;
/** Initial CWND multiplier, which multiplies MSS to determine initial CWND.
* Set 0 to determine the initial CWND by another way */
u16 initial_cwnd_multiplier;
/** Enable tx pacing for new connections */
u8 enable_tx_pacing;
/** Default congestion control algorithm type */
tcp_cc_algorithm_type_e cc_algo;
/** Min rwnd, as number of snd_mss segments, for update ack to be sent after
* a zero rwnd advertisement */
u32 rwnd_min_update_ack;
/** Delayed ack time (disabled) */
u16 delack_time;
/** Timer ticks to wait for close from app */
u16 closewait_time;
/** Timer ticks to wait in time-wait. Also known as 2MSL */
u16 timewait_time;
/** Timer ticks to wait in fin-wait1 to send fin and rcv fin-ack */
u16 finwait1_time;
/** Timer ticks to wait in last ack for ack */
u16 lastack_time;
/** Timer ticks to wait in fin-wait2 for fin */
u16 finwait2_time;
/** Timer ticks to wait in closing for fin ack */
u16 closing_time;
/** Timer ticks to wait before cleaning up the connection */
u16 cleanup_time;
/** Number of preallocated connections */
u32 preallocated_connections;
/** Number of preallocated half-open connections */
u32 preallocated_half_open_connections;
/** Vectors of src addresses. Optional unless one needs > 63K active-opens */
ip4_address_t *ip4_src_addrs;
ip6_address_t *ip6_src_addrs;
/** Fault-injection. Debug only */
f64 buffer_fail_fraction;
} tcp_configuration_t;
typedef struct _tcp_main
{
/* Per-worker thread tcp connection pools */
tcp_connection_t **connections;
/* Pool of listeners. */
tcp_connection_t *listener_pool;
/** Dispatch table by state and flags */
tcp_lookup_dispatch_t dispatch_table[TCP_N_STATES][64];
u8 log2_tstamp_clocks_per_tick;
f64 tstamp_ticks_per_clock;
/** per-worker context */
tcp_worker_ctx_t *wrk_ctx;
/** Pool of half-open connections on which we've sent a SYN */
tcp_connection_t *half_open_connections;
clib_spinlock_t half_open_lock;
/** vlib buffer size */
u32 bytes_per_buffer;
/** Seed used to generate random iss */
tcp_iss_seed_t iss_seed;
/** Congestion control algorithms registered */
tcp_cc_algorithm_t *cc_algos;
/** Hash table of cc algorithms by name */
uword *cc_algo_by_name;
/** Last cc algo registered */
tcp_cc_algorithm_type_e cc_last_type;
/** Flag that indicates if stack is on or off */
u8 is_enabled;
/** Flag that indicates if v4 punting is enabled */
u8 punt_unknown4;
/** Flag that indicates if v6 punting is enabled */
u8 punt_unknown6;
/** Rotor for v4 source addresses */
u32 last_v4_addr_rotor;
/** Rotor for v6 source addresses */
u32 last_v6_addr_rotor;
/** Protocol configuration */
tcp_configuration_t cfg;
} tcp_main_t;
extern tcp_main_t tcp_main;
extern vlib_node_registration_t tcp4_input_node;
extern vlib_node_registration_t tcp6_input_node;
extern vlib_node_registration_t tcp4_output_node;
extern vlib_node_registration_t tcp6_output_node;
extern vlib_node_registration_t tcp4_established_node;
extern vlib_node_registration_t tcp6_established_node;
extern vlib_node_registration_t tcp4_syn_sent_node;
extern vlib_node_registration_t tcp6_syn_sent_node;
extern vlib_node_registration_t tcp4_rcv_process_node;
extern vlib_node_registration_t tcp6_rcv_process_node;
extern vlib_node_registration_t tcp4_listen_node;
extern vlib_node_registration_t tcp6_listen_node;
#define tcp_cfg tcp_main.cfg
#define tcp_node_index(node_id, is_ip4) \
((is_ip4) ? tcp4_##node_id##_node.index : tcp6_##node_id##_node.index)
always_inline tcp_main_t *
vnet_get_tcp_main ()
{
return &tcp_main;
}
always_inline tcp_worker_ctx_t *
tcp_get_worker (u32 thread_index)
{
return &tcp_main.wrk_ctx[thread_index];
}
always_inline tcp_header_t *
tcp_buffer_hdr (vlib_buffer_t * b)
{
ASSERT ((signed) b->current_data >= (signed) -VLIB_BUFFER_PRE_DATA_SIZE);
return (tcp_header_t *) (b->data + b->current_data
+ vnet_buffer (b)->tcp.hdr_offset);
}
#if (VLIB_BUFFER_TRACE_TRAJECTORY)
#define tcp_trajectory_add_start(b, start) \
{ \
(*vlib_buffer_trace_trajectory_cb) (b, start); \
}
#else
#define tcp_trajectory_add_start(b, start)
#endif
clib_error_t *vnet_tcp_enable_disable (vlib_main_t * vm, u8 is_en);
void tcp_punt_unknown (vlib_main_t * vm, u8 is_ip4, u8 is_add);
always_inline tcp_connection_t *
tcp_connection_get (u32 conn_index, u32 thread_index)
{
if (PREDICT_FALSE
(pool_is_free_index (tcp_main.connections[thread_index], conn_index)))
return 0;
return pool_elt_at_index (tcp_main.connections[thread_index], conn_index);
}
always_inline tcp_connection_t *
tcp_connection_get_if_valid (u32 conn_index, u32 thread_index)
{
if (tcp_main.connections[thread_index] == 0)
return 0;
if (pool_is_free_index (tcp_main.
}
# Release Notes {#release_notes}
* @subpage release_notes_1804
* @subpage release_notes_18012
* @subpage release_notes_18011
* @subpage release_notes_1801
* @subpage release_notes_1710
* @subpage release_notes_1707
* @subpage release_notes_1704
* @subpage release_notes_17011
* @subpage release_notes_1701
* @subpage release_notes_1609
* @subpage release_notes_1606
@page release_notes_1807 Release notes for VPP 18.07
More than 533 commits since the 18.04 release.
## Features
### Infrastructure
- DPDK 18.02.1
- Complete rework of the dpdk-input node
- Display rx/tx burst function name in "show hardware detail"
- Improve buffer alloc perfomance
- This is ~50% improvement in buffer alloc performance. For a 256 buffer allocation, it was ~10 clocks/buffer, now is < 5 clocks.
- Add per-numa page allocation info to 'show memory'
- Vectorized bihash_{48,40,24,16}_8 key compare
- bihash_48_8 case:
- Scalar code: 6 clocks
- SSE4.2 code: 3 clocks
- AVX2 code: 2.27 clocks
- AVX512 code: 1.5 clocks
- Pollable Stats
- Stats are now available to a client in a shared memory segment and
in the form of a directory, allowing very high performance polling
of stats without directly querying VPP.
### VNET & Plugins
- IGMP improvements
- Enable/Disable an interface for IGMP
- improve logging
- refactor common code
- no orphaned timers
- IGMP state changes in main thread only
- Large groups split over multiple state-change reports
- SSM range configuration API.
- more tests
- IP: vectorized IP checksum
- VXLAN : HW offload RX flow
- Rework kube-proxy into LB plugin and add NATA66
- NAT:
- Code refactor
- Syslog
- Multiple outside interfaces
- Endpoint dependent filtering and mapping
- ACL:
- Tuple Merge algorithm cleanup and integration
- Processing pipeline optimizations
- Refactoring
- Experimental AVF driver
### Host stack
- Session: performance improvements, add support for connectionless transports, datagram reception and transmission
- TCP: congestion control improvements and overall fixes
- UDP: datagram mode
- TLS async support
## Known issues
For the full list of issues please refer to fd.io [JIRA](https://jira.fd.io).
## Issues fixed
For the full list of fixed issues please refer to:
- fd.io [JIRA](https://jira.fd.io)
- git [commit log](https://git.fd.io/vpp/log/?h=stable/1807)
## API changes
Description of results:
* _Definition changed_: indicates that the API file was modified between releases.
* _Only in image_: indicates the API is new for this release.
* _Only in file_: indicates the API has been removed in this release.
Message Name Result
abf_itf_attach_add_del definition changed
abf_itf_attach_details only in image
abf_itf_attach_dump only in image
abf_plugin_get_version definition changed
abf_policy_add_del definition changed
abf_policy_details only in image
abf_policy_dump only in image
af_packet_details only in image
af_packet_dump only in image
avf_create definition changed
avf_delete definition changed
bind_sock_reply definition changed
bind_uri_reply definition changed
dhcp6_client_enable_disable definition changed
dhcp6_clients_enable_disable definition changed
dhcp6_duid_ll_set definition changed
dhcp6_pd_client_enable_disable definition changed
dhcp6_pd_reply_event only in image
dhcp6_pd_send_client_message definition changed
dhcp6_reply_event only in image
dhcp6_send_client_message definition changed
dhcp_client_config definition changed
dhcp_client_details only in image
dhcp_client_dump only in image
dhcp_compl_event definition changed
dslite_address_details only in image
dslite_address_dump only in image
gbp_endpoint_group_add_del definition changed
gbp_endpoint_group_details only in image
gbp_endpoint_group_dump only in image
gbp_recirc_add_del definition changed
gbp_recirc_details only in image
gbp_recirc_dump only in image
gbp_subnet_add_del definition changed
gbp_subnet_details only in image
gbp_subnet_dump only in image
hw_interface_set_mtu definition changed
igmp_details definition changed
igmp_dump definition changed
igmp_enable_disable definition changed
igmp_event definition changed
igmp_group_prefix_details only in image
igmp_group_prefix_dump only in image
igmp_group_prefix_set definition changed
igmp_listen definition changed
ikev2_profile_set_auth definition changed
ikev2_profile_set_id definition changed
ip6_add_del_address_using_prefix definition changed
ip_mroute_add_del definition changed
ip_probe_neighbor definition changed
ip_scan_neighbor_enable_disable definition changed
ip_unnumbered_details only in image
ip_unnumbered_dump only in image
ipip_6rd_add_tunnel definition changed
ipip_add_tunnel definition changed
ipip_tunnel_details definition changed
ipsec_sa_details definition changed
ipsec_sad_add_del_entry definition changed
ipsec_tunnel_if_add_del definition changed
kp_add_del_pod definition changed
kp_add_del_vip definition changed
kp_conf definition changed
lb_add_del_vip definition changed
mactime_add_del definition changed
mactime_enable definition changed
memclnt_create definition changed
memclnt_create_reply definition changed
memfd_segment_create definition changed
nat44_add_del_lb_static_mapping definition changed
nat44_add_del_static_mapping definition changed
nat44_del_session definition changed
nat44_lb_static_mapping_details definition changed
nat44_static_mapping_details definition changed
nat44_user_session_details definition changed
pipe_create definition changed
pipe_delete definition changed
pipe_details only in image
pipe_dump only in image
pot_profile_activate definition changed
pot_profile_add definition changed
pot_profile_del definition changed
proxy_arp_add_del definition changed
proxy_arp_details only in image
proxy_arp_dump only in image
proxy_arp_intfc_details only in image
proxy_arp_intfc_dump only in image
sock_init_shm_reply definition changed
sockclnt_create definition changed
sockclnt_create_reply definition changed
sr_localsid_add_del definition changed
sr_localsids_details definition changed
sr_policies_details only in image
sr_policies_dump only in image
sr_policy_add definition changed
sr_policy_del definition changed
sr_policy_mod definition changed
sr_steering_pol_details only in image
sr_steering_pol_dump only in image
sw_interface_details definition changed
sw_interface_set_mtu definition changed
tap_create_v2 definition changed
vnet_bier_neighbor_counters only in image
vnet_get_summary_stats_reply definition changed
vxlan_offload_rx definition changed
want_bier_neighbor_stats definition changed
want_dhcp6_pd_reply_events definition changed
want_dhcp6_reply_events definition changed
Found 107 api message signature differences
### Patches that changed API definitions
| @c src/plugins/ioam/lib-pot/pot.api ||
| ------- | ------- |
| [e9fcf23](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e9fcf23) | Fix some build warnings about "Old Style VLA" |
| @c src/plugins/gbp/gbp.api ||
| ------- | ------- |
| [25b0494](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=25b0494) | GBP V2 |
| @c src/plugins/map/map.api ||
| ------- | ------- |
| [381e9a9](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=381e9a9) | MAP: Move MAP-E/T to a plugin. |
| @c src/plugins/igmp/igmp.api ||
| ------- | ------- |
| [947ea62](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=947ea62) | IGMP improvements |
| @c src/plugins/lb/lb.api ||
| ------- | ------- |
| [d92a0b5](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d92a0b5) | Rework kube-proxy into LB plugin |
| @c src/plugins/nat/nat.api ||
| ------- | ------- |
| [70a26ac](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=70a26ac) | NAT44: nat44_del_session and nat44_user_session_details API update (VPP-1271) |
| [ebdf190](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=ebdf190) | NAT44: TCP connection close detection (VPP-1266) |
| [1e5c07d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=1e5c07d) | Add special Twice-NAT feature (VPP-1221) |
| [16aa7f8](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=16aa7f8) | DSLite: Implement new API call DSLITE_ADDRESS_DUMP. |
| @c src/plugins/avf/avf.api ||
| ------- | ------- |
| [258a189](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=258a189) | avf: api fix |
| [6c9b964](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=6c9b964) | avf: binary API and configurable RX/TX queue size |
| @c src/plugins/mactime/mactime.api ||
| ------- | ------- |
| [7055e26](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7055e26) | Driver level time-based src mac filter |
| @c src/plugins/abf/abf.api ||
| ------- | ------- |
| [669d07d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=669d07d) | ACL based forwarding |
| @c src/vlibmemory/memclnt.api ||
| ------- | ------- |
| [dab732a](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=dab732a) | VPP-1335 vapi crash when memclnt_keepalive received |
| [7895872](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7895872) | Remove the historical memfd api segment bootstrap |
| @c src/vpp/stats/stats.api ||
| ------- | ------- |
| [a21a367](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=a21a367) | VPP-1324 SIGSEGV vl_msg_api_handler_with_vm_node() |
| [586479a](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=586479a) | BIER neighbor stats |
| [e906aac](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e906aac) | STATS: Separate socket for fd exchange. |
| [048a4e5](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=048a4e5) | export counters in a memfd segment |
| @c src/vnet/interface.api ||
| ------- | ------- |
| [d723161](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d723161) | MTU: Software interface / Per-protocol MTU support |
| [fe7d4a2](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=fe7d4a2) | Revert "MTU: Setting of MTU on software interface (instead of hardware interface)" |
| [70083ee](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=70083ee) | MTU: Setting of MTU on software interface (instead of hardware interface) |
| @c src/vnet/ipfix-export/ipfix_export.api ||
| ------- | ------- |
| [a9855ef](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=a9855ef) | Flow: Rename IPFIX exporter. |
| @c src/vnet/dhcp/dhcp6_pd_client_cp.api ||
| ------- | ------- |
| [81119e8](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=81119e8) | Implement DHCPv6 PD client (VPP-718, VPP-1050) |
| @c src/vnet/dhcp/dhcp.api ||
| ------- | ------- |
| [dd3b8f7](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=dd3b8f7) | Implement DHCPv6 IA NA client (VPP-1094) |
| [d9778c2](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d9778c2) | Update DHCPv6 DUID code and fix coverity warnings |
| [81119e8](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=81119e8) | Implement DHCPv6 PD client (VPP-718, VPP-1050) |
| [daff178](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=daff178) | DHCP Client Dump |
| @c src/vnet/dhcp/dhcp6_ia_na_client_cp.api ||
| ------- | ------- |
| [dd3b8f7](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=dd3b8f7) | Implement DHCPv6 IA NA client (VPP-1094) |
| @c src/vnet/ip/ip.api ||
| ------- | ------- |
| [947ea62](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=947ea62) | IGMP improvements |
| [7eaaf74](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7eaaf74) | proxy_arp: remove unused is_add |
| [0053de6](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=0053de6) | ARP proxy dumps |
| [9e2f915](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=9e2f915) | IP unnumbered dump |
| [7f358b3](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7f358b3) | Periodic scan and probe of IP neighbors to maintain neighbor pools |
| [e821ab1](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e821ab1) | IP mcast: allow unicast address as a next-hop |
| [c7b4304](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=c7b4304) | Implement ip_probe_neighbor API |
| @c src/vnet/ip/ip_types.api ||
| ------- | ------- |
| [947ea62](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=947ea62) | IGMP improvements |
| [2c2feab](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=2c2feab) | VPPAPIGEN: Add union and enum support and IP4/IP6 address type. |
| @c src/vnet/devices/af_packet/af_packet.api ||
| ------- | ------- |
| [04e0bb2](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=04e0bb2) | af_packet: Add support for dump interfaces |
| @c src/vnet/devices/tap/tapv2.api ||
| ------- | ------- |
| [d600ffe](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d600ffe) | Update tapv2 documentation |
| [0b06111](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=0b06111) | VPP-1305: Add support for tags |
| @c src/vnet/devices/pipe/pipe.api ||
| ------- | ------- |
| [ee8b973](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=ee8b973) | VOM: support for pipes |
| [17ff3c1](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=17ff3c1) | Pipes |
| @c src/vnet/ipip/ipip.api ||
| ------- | ------- |
| [d57f636](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d57f636) | VPP-1277: IPIP - Copy TOS/TC from inner packet to outer. |
| @c src/vnet/session/session.api ||
| ------- | ------- |
| [7fb0fe1](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7fb0fe1) | udp/session: refactor to support dgram mode |
| @c src/vnet/ipsec/ipsec.api ||
| ------- | ------- |
| [4b089f2](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=4b089f2) | ipsec: support UDP encap/decap for NAT traversal |
| [e9fcf23](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e9fcf23) | Fix some build warnings about "Old Style VLA" |
| [8e1039a](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=8e1039a) | Allow an IPsec tunnel interface to be renumbered |
| @c src/vnet/vxlan/vxlan.api ||
| ------- | ------- |
| [af86a48](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=af86a48) | vxlan:offload RX flow |
| @c src/vnet/srv6/sr.api ||
| ------- | ------- |
| [3337bd2](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=3337bd2) | Fixed bugs in SRv6 API |
| [e9fcf23](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e9fcf23) | Fix some build warnings about "Old Style VLA" |
@page release_notes_1804 Release notes for VPP 18.04
More than 570 commits since the 18.01 release.
## Features
### Infrastructure
- DPDK 18.02.1
- ARM aarch64 integrated into CI
### VNET & Plugins
- ERSPAN
- L3DSR load balancing support
- VPC bonding / LACP
- IPv4/IPv6 packet reassembly
- IPv6 link-local support
- Asymmetrical static NAT
- 464XLAT for NAT44
- MAP-T CE support
- Intel Adaptive Virtual Function native device driver plugin
- Marvell device plugin
- SRv6 static, dynamic and masquerading proxy plugins
- MPLS Uniform mode
- IGMP plugin
- IPIP tunnel support (IPv4/IPv6 over IPv4/IPv6)
- IPv6 Router Discovery mechanism
### VLIB
- ARM-optimized library variations for key functions
- Better handling of physmem on non-NUMA kernels
### Host stack
- TLS support via OpenSSL or mbedtls software engines
- Session layer can utilize both shm and memfd (secure) FIFO segments
- STCP
- VCL logging / tracing
### API framework
- New API definition compiler (vppapigen)
- Memory (shm) and socket APIs refactored
- API handlers refactored to make them transport (shared memory or socket)
agnostic
- Improved support for bootstrapping of the shm API with memfd segments
over the socket API
### Packaging
- SELinux for RPM builds
- Debuginfo RPMs
- ARM aarch64 for Ubuntu
## Known issues
For the full list of issues please refer to fd.io [JIRA](https://jira.fd.io).
## Issues fixed
For the full list of fixed issues please refer to:
- fd.io [JIRA](https://jira.fd.io)
- git [commit log](https://git.fd.io/vpp/log/?h=stable/1804)
## API changes
Description of results:
* _Definition changed_: indicates that the API file was modified between releases.
* _Only in image_: indicates the API is new for this release.
* _Only in file_: indicates the API has been removed in this release.
Message Name | Results
------------------------------------------------------------ | ----------------
accept_session | definition changed
accept_session_reply | definition changed
acl_add_replace | definition changed
acl_add_replace_reply | definition changed
acl_del | definition changed
acl_del_reply | definition changed
acl_details | definition changed
acl_dump | definition changed
acl_interface_add_del | definition changed
acl_interface_add_del_reply | definition changed
acl_interface_etype_whitelist_details | only in image
acl_interface_etype_whitelist_dump | only in image
acl_interface_list_details | definition changed
acl_interface_list_dump | definition changed
acl_interface_set_acl_list | definition changed
acl_interface_set_acl_list_reply | definition changed
acl_interface_set_etype_whitelist | definition changed
acl_plugin_control_ping | definition changed
acl_plugin_control_ping_reply | definition changed
acl_plugin_get_version | definition changed
acl_plugin_get_version_reply | definition changed
add_node_next | definition changed
add_node_next_reply | definition changed
af_packet_create | definition changed
af_packet_create_reply | definition changed
af_packet_delete | definition changed
af_packet_delete_reply | definition changed
af_packet_set_l4_cksum_offload | definition changed
af_packet_set_l4_cksum_offload_reply | definition changed
api_versions | definition changed
api_versions_reply | definition changed
app_namespace_add_del | definition changed
app_namespace_add_del_reply | definition changed
application_attach | definition changed
application_attach_reply | definition changed
application_detach | definition changed
application_detach_reply | definition changed
application_tls_cert_add | definition changed
application_tls_key_add | definition changed
bd_ip_mac_add_del | definition changed
bd_ip_mac_add_del_reply | definition changed
bfd_auth_del_key | definition changed
bfd_auth_del_key_reply | definition changed
bfd_auth_keys_details | definition changed
bfd_auth_keys_dump | definition changed
bfd_auth_set_key | definition changed
bfd_auth_set_key_reply | definition changed
bfd_udp_add | definition changed
bfd_udp_add_reply | definition changed
bfd_udp_auth_activate | definition changed
bfd_udp_auth_activate_reply | definition changed
bfd_udp_auth_deactivate | definition changed
bfd_udp_auth_deactivate_reply | definition changed
bfd_udp_del | definition changed
bfd_udp_del_echo_source | definition changed
bfd_udp_del_echo_source_reply | definition changed
bfd_udp_del_reply | definition changed
bfd_udp_mod | definition changed
bfd_udp_mod_reply | definition changed
bfd_udp_session_details | definition changed
bfd_udp_session_dump | definition changed
bfd_udp_session_set_flags | definition changed
bfd_udp_session_set_flags_reply | definition changed
bfd_udp_set_echo_source | definition changed
bfd_udp_set_echo_source_reply | definition changed
bier_disp_entry_add_del | definition changed
bier_disp_entry_add_del_reply | definition changed
bier_disp_entry_details | definition changed
bier_disp_entry_dump | definition changed
bier_disp_table_add_del | definition changed
bier_disp_table_add_del_reply | definition changed
bier_disp_table_details | definition changed
bier_disp_table_dump | definition changed
bier_imp_add | definition changed
bier_imp_add_reply | definition changed
bier_imp_del | definition changed
bier_imp_del_reply | definition changed
bier_imp_details | definition changed
bier_imp_dump | definition changed
bier_route_add_del | definition changed
bier_route_add_del_reply | definition changed
bier_route_details | definition changed
bier_route_dump | definition changed
bier_table_add_del | definition changed
bier_table_add_del_reply | definition changed
bier_table_details | definition changed
bier_table_dump | definition changed
bind_sock | definition changed
bind_sock_reply | definition changed
bind_uri | definition changed
bind_uri_reply | definition changed
bond_create | definition changed
bond_delete | definition changed
bond_detach_slave | definition changed
bond_enslave | definition changed
bridge_domain_add_del | definition changed
bridge_domain_add_del_reply | definition changed
bridge_domain_details | definition changed
bridge_domain_dump | definition changed
bridge_domain_set_mac_age | definition changed
bridge_domain_set_mac_age_reply | definition changed
bridge_flags | definition changed
bridge_flags_reply | definition changed
cdp_enable | definition changed
classify_add_del_session | definition changed
classify_add_del_session_reply | definition changed
classify_add_del_table | definition changed
classify_add_del_table_reply | definition changed
classify_session_details | definition changed
classify_session_dump | definition changed
classify_set_interface_ip_table | definition changed
classify_set_interface_ip_table_reply | definition changed
classify_set_interface_l2_tables | definition changed
classify_set_interface_l2_tables_reply | definition changed
classify_table_by_interface | definition changed
classify_table_by_interface_reply | definition changed
classify_table_ids | definition changed
classify_table_ids_reply | definition changed
classify_table_info | definition changed
classify_table_info_reply | definition changed
cli | definition changed
cli_inband | definition changed
cli_inband_reply | definition changed
cli_reply | definition changed
collect_detailed_interface_stats | definition changed
connect_session | definition changed
connect_session_reply | definition changed
connect_sock | definition changed
connect_sock_reply | definition changed
connect_uri | definition changed
connect_uri_reply | definition changed
control_ping | definition changed
control_ping_reply | definition changed
cop_interface_enable_disable | definition changed
cop_interface_enable_disable_reply | definition changed
cop_whitelist_enable_disable | definition changed
cop_whitelist_enable_disable_reply | definition changed
create_loopback | definition changed
create_loopback_instance | definition changed
create_loopback_instance_reply | definition changed
create_loopback_reply | definition changed
create_subif | definition changed
create_subif_reply | definition changed
create_vhost_user_if | definition changed
create_vhost_user_if_reply | definition changed
create_vlan_subif | definition changed
create_vlan_subif_reply | definition changed
delete_loopback | definition changed
delete_loopback_reply | definition changed
delete_subif | definition changed
delete_subif_reply | definition changed
delete_vhost_user_if | definition changed
delete_vhost_user_if_reply | definition changed
dhcp_client_config | definition changed
dhcp_client_config_reply | definition changed
dhcp_compl_event | definition changed
dhcp_proxy_config | definition changed
dhcp_proxy_config_reply | definition changed
dhcp_proxy_details | definition changed
dhcp_proxy_dump | definition changed
dhcp_proxy_set_vss | definition changed
dhcp_proxy_set_vss_reply | definition changed
disconnect_session | definition changed
disconnect_session_reply | definition changed
dns_enable_disable | definition changed
dns_enable_disable_reply | definition changed
dns_name_server_add_del | definition changed
dns_name_server_add_del_reply | definition changed
dns_resolve_ip | definition changed
dns_resolve_ip_reply | definition changed
dns_resolve_name | definition changed
dns_resolve_name_reply | definition changed
dslite_add_del_pool_addr_range | definition changed
dslite_add_del_pool_addr_range_reply | definition changed
dslite_get_aftr_addr | definition changed
dslite_get_b4_addr | definition changed
dslite_set_aftr_addr | definition changed
dslite_set_aftr_addr_reply | definition changed
dslite_set_b4_addr | definition changed
feature_enable_disable | definition changed
feature_enable_disable_reply | definition changed
flow_classify_details | definition changed
flow_classify_dump | definition changed
flow_classify_set_interface | definition changed
flow_classify_set_interface_reply | definition changed
flowprobe_params | definition changed
flowprobe_params_reply | definition changed
flowprobe_tx_interface_add_del | definition changed
flowprobe_tx_interface_add_del_reply | definition changed
gbp_contract_add_del | definition changed
gbp_contract_details | only in image
gbp_contract_dump | only in image
gbp_endpoint_add_del | definition changed
gbp_endpoint_details | only in image
gbp_endpoint_dump | only in image
geneve_add_del_tunnel | definition changed
geneve_add_del_tunnel_reply | definition changed
geneve_tunnel_details | definition changed
geneve_tunnel_dump | definition changed
get_first_msg_id | definition changed
get_first_msg_id_reply | definition changed
get_next_index | definition changed
get_next_index_reply | definition changed
get_node_graph | definition changed
get_node_graph_reply | definition changed
get_node_index | definition changed
get_node_index_reply | definition changed
gpe_add_del_fwd_entry | definition changed
gpe_add_del_fwd_entry_reply | definition changed
gpe_add_del_iface | definition changed
gpe_add_del_iface_reply | definition changed
gpe_add_del_native_fwd_rpath | definition changed
gpe_add_del_native_fwd_rpath_reply | definition changed
gpe_enable_disable | definition changed
gpe_enable_disable_reply | definition changed
gpe_fwd_entries_get | definition changed
gpe_fwd_entries_get_reply | definition changed
gpe_fwd_entry_path_details | definition changed
gpe_fwd_entry_path_dump | definition changed
gpe_fwd_entry_vnis_get | definition changed
gpe_fwd_entry_vnis_get_reply | definition changed
gpe_get_encap_mode | definition changed
gpe_get_encap_mode_reply | definition changed
gpe_native_fwd_rpaths_get | definition changed
gpe_native_fwd_rpaths_get_reply | definition changed
gpe_set_encap_mode | definition changed
gpe_set_encap_mode_reply | definition changed
gre_add_del_tunnel | definition changed
gre_add_del_tunnel_reply | definition changed
gre_tunnel_details | definition changed
gre_tunnel_dump | definition changed
gtpu_add_del_tunnel | definition changed
gtpu_add_del_tunnel_reply | definition changed
gtpu_tunnel_details | definition changed
gtpu_tunnel_dump | definition changed
igmp_clear_interface | definition changed
igmp_details | only in image
igmp_dump | only in image
igmp_enable_disable | definition changed
igmp_event | only in image
igmp_listen | definition changed
ikev2_initiate_del_child_sa | definition changed
ikev2_initiate_del_child_sa_reply | definition changed
ikev2_initiate_del_ike_sa | definition changed
ikev2_initiate_del_ike_sa_reply | definition changed
ikev2_initiate_rekey_child_sa | definition changed
ikev2_initiate_rekey_child_sa_reply | definition changed
ikev2_initiate_sa_init | definition changed
ikev2_initiate_sa_init_reply | definition changed
ikev2_profile_add_del | definition changed
ikev2_profile_add_del_reply | definition changed
ikev2_profile_set_auth | definition changed
ikev2_profile_set_auth_reply | definition changed
ikev2_profile_set_id | definition changed
ikev2_profile_set_id_reply | definition changed
ikev2_profile_set_ts | definition changed
ikev2_profile_set_ts_reply | definition changed
ikev2_set_esp_transforms | definition changed
ikev2_set_esp_transforms_reply | definition changed
ikev2_set_ike_transforms | definition changed
ikev2_set_ike_transforms_reply | definition changed
ikev2_set_local_key | definition changed
ikev2_set_local_key_reply | definition changed
ikev2_set_responder | definition changed
ikev2_set_responder_reply | definition changed
ikev2_set_sa_lifetime | definition changed
ikev2_set_sa_lifetime_reply | definition changed
input_acl_set_interface | definition changed
input_acl_set_interface_reply | definition changed
interface_name_renumber | definition changed
interface_name_renumber_reply | definition changed
ioam_cache_ip6_enable_disable | definition changed
ioam_cache_ip6_enable_disable_reply | definition changed
ioam_disable | definition changed
ioam_disable_reply | definition changed
ioam_enable | definition changed
ioam_enable_reply | definition changed
ioam_export_ip6_enable_disable | definition changed
ioam_export_ip6_enable_disable_reply | definition changed
ip4_arp_event | definition changed
ip6_fib_details | definition changed
ip6_fib_dump | definition changed
ip6_mfib_details | definition changed
ip6_mfib_dump | definition changed
ip6_nd_address_autoconfig | definition changed
ip6_nd_event | definition changed
ip6_ra_event | only in image
ip6nd_proxy_add_del | definition changed
ip6nd_proxy_add_del_reply | definition changed
ip6nd_proxy_details | definition changed
ip6nd_proxy_dump | definition changed
ip6nd_send_router_solicitation | definition changed
ip_add_del_route | definition changed
ip_add_del_route_reply | definition changed
ip_address_details | definition changed
ip_address_dump | definition changed
ip_container_proxy_add_del | definition changed
ip_container_proxy_add_del_reply | definition changed
ip_details | definition changed
ip_dump | definition changed
ip_fib_details | definition changed
ip_fib_dump | definition changed
ip_mfib_details | definition changed
ip_mfib_dump | definition changed
ip_mroute_add_del | definition changed
ip_mroute_add_del_reply | definition changed
ip_neighbor_add_del | definition changed
ip_neighbor_add_del_reply | definition changed
ip_neighbor_details | definition changed
ip_neighbor_dump | definition changed
ip_punt_police | definition changed
ip_punt_police_reply | definition changed
ip_punt_redirect | definition changed
ip_punt_redirect_reply | definition changed
ip_reassembly_enable_disable | definition changed
ip_reassembly_get | definition changed
ip_reassembly_set | definition changed
ip_source_and_port_range_check_add_del | definition changed
ip_source_and_port_range_check_add_del_reply | definition changed
ip_source_and_port_range_check_interface_add_del | definition changed
ip_source_and_port_range_check_interface_add_del_reply | definition changed
ip_table_add_del | definition changed
ip_table_add_del_reply | definition changed
ipfix_classify_stream_details | definition changed
ipfix_classify_stream_dump | definition changed
ipfix_classify_table_add_del | definition changed
ipfix_classify_table_add_del_reply | definition changed
ipfix_classify_table_details | definition changed
ipfix_classify_table_dump | definition changed
ipfix_exporter_details | definition changed
ipfix_exporter_dump | definition changed
ipip_6rd_add_tunnel | definition changed
ipip_6rd_del_tunnel | definition changed
ipip_add_tunnel | definition changed
ipip_del_tunnel | definition changed
ipip_tunnel_details | only in image
ipip_tunnel_dump | only in image
ipsec_gre_add_del_tunnel | definition changed
ipsec_gre_add_del_tunnel_reply | definition changed
ipsec_gre_tunnel_details | definition changed
ipsec_gre_tunnel_dump | definition changed
ipsec_interface_add_del_spd | definition changed
ipsec_interface_add_del_spd_reply | definition changed
ipsec_sa_details | definition changed
ipsec_sa_dump | definition changed
ipsec_sa_set_key | definition changed
ipsec_sa_set_key_reply | definition changed
ipsec_sad_add_del_entry | definition changed
ipsec_sad_add_del_entry_reply | definition changed
ipsec_spd_add_del | definition changed
ipsec_spd_add_del_entry | definition changed
ipsec_spd_add_del_entry_reply | definition changed
ipsec_spd_add_del_reply | definition changed
ipsec_spd_details | definition changed
ipsec_spd_dump | definition changed
ipsec_tunnel_if_add_del | definition changed
ipsec_tunnel_if_add_del_reply | definition changed
ipsec_tunnel_if_set_key | definition changed
ipsec_tunnel_if_set_key_reply | definition changed
ipsec_tunnel_if_set_sa | definition changed
ipsec_tunnel_if_set_sa_reply | definition changed
kp_add_del_pod | definition changed
kp_add_del_pod_reply | definition changed
kp_add_del_vip | definition changed
kp_add_del_vip_reply | definition changed
kp_conf | definition changed
kp_conf_reply | definition changed
l2_emulation | definition changed
l2_emulation_reply | definition changed
l2_fib_clear_table | definition changed
l2_fib_clear_table_reply | definition changed
l2_fib_table_details | definition changed
l2_fib_table_dump | definition changed
l2_flags | definition changed
l2_flags_reply | definition changed
l2_interface_efp_filter | definition changed
l2_interface_efp_filter_reply | definition changed
l2_interface_pbb_tag_rewrite | definition changed
l2_interface_pbb_tag_rewrite_reply | definition changed
l2_interface_vlan_tag_rewrite | definition changed
l2_interface_vlan_tag_rewrite_reply | definition changed
l2_macs_event | definition changed
l2_patch_add_del | definition changed
l2_patch_add_del_reply | definition changed
l2_xconnect_details | definition changed
l2_xconnect_dump | definition changed
l2fib_add_del | definition changed
l2fib_add_del_reply | definition changed
l2fib_flush_all | definition changed
l2fib_flush_all_reply | definition changed
l2fib_flush_bd | definition changed
l2fib_flush_bd_reply | definition changed
l2fib_flush_int | definition changed
l2fib_flush_int_reply | definition changed
l2tpv3_create_tunnel | definition changed
l2tpv3_create_tunnel_reply | definition changed
l2tpv3_interface_enable_disable | definition changed
l2tpv3_interface_enable_disable_reply | definition changed
l2tpv3_set_lookup_key | definition changed
l2tpv3_set_lookup_key_reply | definition changed
l2tpv3_set_tunnel_cookies | definition changed
l2tpv3_set_tunnel_cookies_reply | definition changed
lb_add_del_as | definition changed
lb_add_del_as_reply | definition changed
lb_add_del_vip | definition changed
lb_add_del_vip_reply | definition changed
lb_conf | definition changed
lb_conf_reply | definition changed
lisp_add_del_adjacency | definition changed
lisp_add_del_adjacency_reply | definition changed
lisp_add_del_local_eid | definition changed
lisp_add_del_local_eid_reply | definition changed
lisp_add_del_locator | definition changed
lisp_add_del_locator_reply | definition changed
lisp_add_del_locator_set | definition changed
lisp_add_del_locator_set_reply | definition changed
lisp_add_del_map_request_itr_rlocs | definition changed
lisp_add_del_map_request_itr_rlocs_reply | definition changed
lisp_add_del_map_resolver | definition changed
lisp_add_del_map_resolver_reply | definition changed
lisp_add_del_map_server | definition changed
lisp_add_del_map_server_reply | definition changed
lisp_add_del_remote_mapping | definition changed
lisp_add_del_remote_mapping_reply | definition changed
lisp_adjacencies_get | definition changed
lisp_adjacencies_get_reply | definition changed
lisp_eid_table_add_del_map | definition changed
lisp_eid_table_add_del_map_reply | definition changed
lisp_eid_table_details | definition changed
lisp_eid_table_dump | definition changed
lisp_eid_table_map_details | definition changed
lisp_eid_table_map_dump | definition changed
lisp_eid_table_vni_details | definition changed
lisp_eid_table_vni_dump | definition changed
lisp_enable_disable | definition changed
lisp_enable_disable_reply | definition changed
lisp_get_map_request_itr_rlocs | definition changed
lisp_get_map_request_itr_rlocs_reply | definition changed
lisp_locator_details | definition changed
lisp_locator_dump | definition changed
lisp_locator_set_details | definition changed
lisp_locator_set_dump | definition changed
lisp_map_register_enable_disable | definition changed
lisp_map_register_enable_disable_reply | definition changed
lisp_map_request_mode | definition changed
lisp_map_request_mode_reply | definition changed
lisp_map_resolver_details | definition changed
lisp_map_resolver_dump | definition changed
lisp_map_server_details | definition changed
lisp_map_server_dump | definition changed
lisp_pitr_set_locator_set | definition changed
lisp_pitr_set_locator_set_reply | definition changed
lisp_rloc_probe_enable_disable | definition changed
lisp_rloc_probe_enable_disable_reply | definition changed
lisp_use_petr | definition changed
lisp_use_petr_reply | definition changed
lldp_config | definition changed
lldp_config_reply | definition changed
macip_acl_add | definition changed
macip_acl_add_replace | definition changed
macip_acl_add_replace_reply | definition changed
macip_acl_add_reply | definition changed
macip_acl_del | definition changed
macip_acl_del_reply | definition changed
macip_acl_details | definition changed
macip_acl_dump | definition changed
macip_acl_interface_add_del | definition changed
macip_acl_interface_add_del_reply | definition changed
macip_acl_interface_get | definition changed
macip_acl_interface_get_reply | definition changed
macip_acl_interface_list_details | definition changed
macip_acl_interface_list_dump | definition changed
map_add_del_rule | definition changed
map_add_del_rule_reply | definition changed
map_add_domain | definition changed
map_add_domain_reply | definition changed
map_another_segment | definition changed
map_another_segment_reply | definition changed
map_del_domain | definition changed
map_del_domain_reply | definition changed
map_domain_details | definition changed
map_domain_dump | definition changed
map_rule_details | definition changed
map_rule_dump | definition changed
map_summary_stats | definition changed
map_summary_stats_reply | definition changed
memclnt_create | definition changed
memclnt_create_reply | definition changed
memclnt_delete | definition changed
memclnt_delete_reply | definition changed
memclnt_keepalive | definition changed
memclnt_keepalive_reply | definition changed
memclnt_read_timeout | definition changed
memclnt_rx_thread_suspend
|