1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2021 Intel Corporation
5 #ifndef _IP_REASSEMBLY_H_
6 #define _IP_REASSEMBLY_H_
9 * IP Fragmentation and Reassembly
10 * Implementation of IP packet fragmentation and reassembly.
13 #include <rte_ip_frag.h>
16 IP_LAST_FRAG_IDX, /* index of last fragment */
17 IP_FIRST_FRAG_IDX, /* index of first fragment */
18 IP_MIN_FRAG_NUM, /* minimum number of fragments */
19 IP_MAX_FRAG_NUM = RTE_LIBRTE_IP_FRAG_MAX_FRAG,
20 /* maximum number of fragments per packet */
25 uint16_t ofs; /* offset into the packet */
26 uint16_t len; /* length of fragment */
27 struct rte_mbuf *mb; /* fragment mbuf */
31 * key: <src addr, dst_addr, id> to uniquely identify fragmented datagram.
35 /* src and dst address, only first 8 bytes used for IPv4 */
38 uint64_t id_key_len; /* combined for easy fetch */
41 uint32_t id; /* packet id */
42 uint32_t key_len; /* src/dst key length */
48 * Fragmented packet to reassemble.
49 * First two entries in the frags[] array are for the last and first fragments.
52 RTE_TAILQ_ENTRY(ip_frag_pkt) lru; /* LRU list */
53 struct ip_frag_key key; /* fragmentation key */
54 uint64_t start; /* creation timestamp */
55 uint32_t total_size; /* expected reassembled size */
56 uint32_t frag_size; /* size of fragments received */
57 uint32_t last_idx; /* index of next entry to fill */
58 struct ip_frag frags[IP_MAX_FRAG_NUM]; /* fragments */
59 } __rte_cache_aligned;
62 RTE_TAILQ_HEAD(ip_pkt_list, ip_frag_pkt);
64 /* fragmentation table statistics */
65 struct ip_frag_tbl_stat {
66 uint64_t find_num; /* total # of find/insert attempts. */
67 uint64_t add_num; /* # of add ops. */
68 uint64_t del_num; /* # of del ops. */
69 uint64_t reuse_num; /* # of reuse (del/add) ops. */
70 uint64_t fail_total; /* total # of add failures. */
71 uint64_t fail_nospace; /* # of 'no space' add failures. */
72 } __rte_cache_aligned;
74 /* fragmentation table */
75 struct rte_ip_frag_tbl {
76 uint64_t max_cycles; /* ttl for table entries. */
77 uint32_t entry_mask; /* hash value mask. */
78 uint32_t max_entries; /* max entries allowed. */
79 uint32_t use_entries; /* entries in use. */
80 uint32_t bucket_entries; /* hash associativity. */
81 uint32_t nb_entries; /* total size of the table. */
82 uint32_t nb_buckets; /* num of associativity lines. */
83 struct ip_frag_pkt *last; /* last used entry. */
84 struct ip_pkt_list lru; /* LRU list for table entries. */
85 struct ip_frag_tbl_stat stat; /* statistics counters. */
86 __extension__ struct ip_frag_pkt pkt[0]; /* hash table. */
89 #endif /* _IP_REASSEMBLY_H_ */