FD.io VPP  v18.04-17-g3a0d853
Vector Packet Processing
ip.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 /*
16  * ip/ip.h: ip generic (4 or 6) main
17  *
18  * Copyright (c) 2008 Eliot Dresselhaus
19  *
20  * Permission is hereby granted, free of charge, to any person obtaining
21  * a copy of this software and associated documentation files (the
22  * "Software"), to deal in the Software without restriction, including
23  * without limitation the rights to use, copy, modify, merge, publish,
24  * distribute, sublicense, and/or sell copies of the Software, and to
25  * permit persons to whom the Software is furnished to do so, subject to
26  * the following conditions:
27  *
28  * The above copyright notice and this permission notice shall be
29  * included in all copies or substantial portions of the Software.
30  *
31  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38  */
39 
40 #ifndef included_ip_main_h
41 #define included_ip_main_h
42 
43 #include <vppinfra/hash.h>
44 #include <vppinfra/heap.h> /* adjacency heap */
45 #include <vppinfra/ptclosure.h>
46 
47 #include <vnet/vnet.h>
48 
49 #include <vnet/ip/format.h>
50 #include <vnet/ip/ip_packet.h>
51 #include <vnet/ip/lookup.h>
52 
53 #include <vnet/tcp/tcp_packet.h>
54 #include <vnet/udp/udp_packet.h>
55 #include <vnet/ip/icmp46_packet.h>
56 
57 #include <vnet/ip/ip4.h>
58 #include <vnet/ip/ip4_error.h>
59 #include <vnet/ip/ip4_packet.h>
60 #include <vnet/ip/icmp4.h>
61 
62 #include <vnet/ip/ip6.h>
63 #include <vnet/ip/ip6_packet.h>
64 #include <vnet/ip/ip6_error.h>
65 #include <vnet/ip/icmp6.h>
67 
68 #define u8_ptr_add(ptr, index) (((u8 *)ptr) + index)
69 #define u16_net_add(u, val) clib_host_to_net_u16(clib_net_to_host_u16(u) + (val))
70 
71 /* Per protocol info. */
72 typedef struct
73 {
74  /* Protocol name (also used as hash key). */
75  u8 *name;
76 
77  /* Protocol number. */
79 
80  /* Format function for this IP protocol. */
82 
83  /* Parser for header. */
85 
86  /* Parser for per-protocol matches. */
88 
89  /* Parser for packet generator edits for this protocol. */
92 
93 /* Per TCP/UDP port info. */
94 typedef struct
95 {
96  /* Port name (used as hash key). */
97  u8 *name;
98 
99  /* UDP/TCP port number in network byte order. */
101 
102  /* Port specific format function. */
104 
105  /* Parser for packet generator edits for this protocol. */
108 
109 typedef struct
110 {
111  /* Per IP protocol info. */
113 
114  /* Protocol info index hashed by 8 bit IP protocol. */
116 
117  /* Hash table mapping IP protocol name (see protocols.def)
118  to protocol number. */
120 
121  /* Per TCP/UDP port info. */
123 
124  /* Hash table from network-byte-order port to port info index. */
126 
127  /* Hash table mapping TCP/UDP name to port info index. */
129 } ip_main_t;
130 
131 extern ip_main_t ip_main;
132 
134 
135 static inline ip_protocol_info_t *
137 {
138  uword *p;
139 
140  p = hash_get (im->protocol_info_by_protocol, protocol);
141  return p ? vec_elt_at_index (im->protocol_infos, p[0]) : 0;
142 }
143 
144 static inline tcp_udp_port_info_t *
146 {
147  uword *p;
148 
149  p = hash_get (im->port_info_by_port, port);
150  return p ? vec_elt_at_index (im->port_infos, p[0]) : 0;
151 }
152 
155  vlib_buffer_t * first_buffer,
156  u32 first_buffer_offset,
157  u32 n_bytes_to_checksum, ip_csum_t sum)
158 {
159  vlib_buffer_t *b = first_buffer;
160  u32 n_bytes_left = n_bytes_to_checksum;
161  ASSERT (b->current_length >= first_buffer_offset);
162  void *h;
163  u32 n;
164 
165  n = clib_min (n_bytes_left, b->current_length);
166  h = vlib_buffer_get_current (b) + first_buffer_offset;
167  sum = ip_incremental_checksum (sum, h, n);
168  if (PREDICT_FALSE (b->flags & VLIB_BUFFER_NEXT_PRESENT))
169  {
170  while (1)
171  {
172  n_bytes_left -= n;
173  if (n_bytes_left == 0)
174  break;
175  b = vlib_get_buffer (vm, b->next_buffer);
176  n = clib_min (n_bytes_left, b->current_length);
177  h = vlib_buffer_get_current (b);
178  sum = ip_incremental_checksum (sum, h, n);
179  }
180  }
181 
182  return sum;
183 }
184 
185 void ip_del_all_interface_addresses (vlib_main_t * vm, u32 sw_if_index);
186 
189 
190 void ip_table_create (fib_protocol_t fproto, u32 table_id, u8 is_api,
191  const u8 * name);
192 
193 void ip_table_delete (fib_protocol_t fproto, u32 table_id, u8 is_api);
194 
195 int ip_table_bind (fib_protocol_t fproto, u32 sw_if_index,
196  u32 table_id, u8 is_api);
197 
198 u8 ip_is_zero (ip46_address_t * ip46_address, u8 is_ip4);
199 u8 ip_is_local_host (ip46_address_t * ip46_address, u8 is_ip4);
200 u8 ip4_is_local_host (ip4_address_t * ip4_address);
201 u8 ip6_is_local_host (ip6_address_t * ip6_address);
202 u8 ip_is_local (u32 fib_index, ip46_address_t * ip46_address, u8 is_ip4);
203 u8 ip_interface_has_address (u32 sw_if_index, ip46_address_t * ip, u8 is_ip4);
204 void ip_copy (ip46_address_t * dst, ip46_address_t * src, u8 is_ip4);
205 void ip_set (ip46_address_t * dst, void *src, u8 is_ip4);
206 void *ip_interface_get_first_ip (u32 sw_if_index, u8 is_ip4);
207 void ip4_address_normalize (ip4_address_t * ip4, u8 preflen);
208 void ip6_address_normalize (ip6_address_t * ip6, u8 preflen);
209 void ip4_preflen_to_mask (u8 pref_len, ip4_address_t * ip);
212  ip4_address_t * res);
214  ip6_address_t * res);
215 void ip6_preflen_to_mask (u8 pref_len, ip6_address_t * mask);
217 
218 #endif /* included_ip_main_h */
219 
220 /*
221  * fd.io coding-style-patch-verification: ON
222  *
223  * Local Variables:
224  * eval: (c-set-style "gnu")
225  * End:
226  */
uword * protocol_info_by_name
Definition: ip.h:119
uword * protocol_info_by_protocol
Definition: ip.h:115
static ip_csum_t ip_incremental_checksum_buffer(vlib_main_t *vm, vlib_buffer_t *first_buffer, u32 first_buffer_offset, u32 n_bytes_to_checksum, ip_csum_t sum)
Definition: ip.h:154
uword( unformat_function_t)(unformat_input_t *input, va_list *args)
Definition: format.h:231
u32 ip4_mask_to_preflen(ip4_address_t *mask)
Definition: ip.c:205
u8 ip6_is_local_host(ip6_address_t *ip6_address)
Definition: ip.c:45
void ip_table_create(fib_protocol_t fproto, u32 table_id, u8 is_api, const u8 *name)
Definition: ip_api.c:1137
#define clib_min(x, y)
Definition: clib.h:340
void ip6_address_normalize(ip6_address_t *ip6, u8 preflen)
Definition: ip.c:176
void * ip_interface_get_first_ip(u32 sw_if_index, u8 is_ip4)
Definition: ip.c:133
void ip_set(ip46_address_t *dst, void *src, u8 is_ip4)
Definition: ip.c:90
void ip6_preflen_to_mask(u8 pref_len, ip6_address_t *mask)
Definition: ip.c:222
Definitions for all things IP (v4|v6) unicast and multicast lookup related.
uword * port_info_by_name
Definition: ip.h:128
u8 ip_is_local(u32 fib_index, ip46_address_t *ip46_address, u8 is_ip4)
Checks that an ip is local to the requested fib.
Definition: ip.c:55
u8 ip_interface_has_address(u32 sw_if_index, ip46_address_t *ip, u8 is_ip4)
Definition: ip.c:99
uword ip_csum_t
Definition: ip_packet.h:90
Definition: ip.h:109
u8 *( format_function_t)(u8 *s, va_list *args)
Definition: format.h:48
enum fib_protocol_t_ fib_protocol_t
Protocol Type.
ip_protocol_t protocol
Definition: ip.h:78
void ip6_prefix_max_address_host_order(ip6_address_t *ip, u8 plen, ip6_address_t *res)
Definition: ip.c:243
void ip4_address_normalize(ip4_address_t *ip4, u8 preflen)
Definition: ip.c:166
unformat_function_t * unformat_pg_edit
Definition: ip.h:90
ip_csum_t ip_incremental_checksum(ip_csum_t sum, void *_data, uword n_bytes)
Definition: ip_checksum.c:43
#define always_inline
Definition: clib.h:92
#define vec_elt_at_index(v, i)
Get vector value at index i checking that i is in bounds.
uword * port_info_by_port
Definition: ip.h:125
#define hash_get(h, key)
Definition: hash.h:248
static ip_protocol_info_t * ip_get_protocol_info(ip_main_t *im, u32 protocol)
Definition: ip.h:136
u16 current_length
Nbytes between current data and the end of this buffer.
Definition: buffer.h:108
format_function_t * format_header
Definition: ip.h:81
static void * vlib_buffer_get_current(vlib_buffer_t *b)
Get pointer to current data to process.
Definition: buffer.h:209
void ip_copy(ip46_address_t *dst, ip46_address_t *src, u8 is_ip4)
Definition: ip.c:81
u8 ip4_is_local_host(ip4_address_t *ip4_address)
Definition: ip.c:39
u32 ip6_mask_to_preflen(ip6_address_t *mask)
Definition: ip.c:266
#define PREDICT_FALSE(x)
Definition: clib.h:105
enum ip_protocol ip_protocol_t
void ip_del_all_interface_addresses(vlib_main_t *vm, u32 sw_if_index)
Definition: ip46_cli.c:82
int ip_table_bind(fib_protocol_t fproto, u32 sw_if_index, u32 table_id, u8 is_api)
vlib_node_registration_t ip4_inacl_node
(constructor) VLIB_REGISTER_NODE (ip4_inacl_node)
ip_protocol_info_t * protocol_infos
Definition: ip.h:112
clib_error_t * ip_main_init(vlib_main_t *vm)
Definition: ip_init.c:45
vlib_node_registration_t ip6_inacl_node
(constructor) VLIB_REGISTER_NODE (ip6_inacl_node)
ip_main_t ip_main
Definition: ip_init.c:42
void ip_table_delete(fib_protocol_t fproto, u32 table_id, u8 is_api)
Definition: ip_api.c:699
static tcp_udp_port_info_t * ip_get_tcp_udp_port_info(ip_main_t *im, u32 port)
Definition: ip.h:145
#define ASSERT(truth)
unsigned int u32
Definition: types.h:88
unformat_function_t * unformat_pg_edit
Definition: ip.h:106
u32 next_buffer
Next buffer for this linked-list of buffers.
Definition: buffer.h:126
unformat_function_t * unformat_header
Definition: ip.h:84
format_function_t * format_header
Definition: ip.h:103
unformat_function_t * unformat_match
Definition: ip.h:87
u64 uword
Definition: types.h:112
struct _vlib_node_registration vlib_node_registration_t
void ip4_prefix_max_address_host_order(ip4_address_t *ip, u8 plen, ip4_address_t *res)
Definition: ip.c:213
unsigned short u16
Definition: types.h:57
unsigned char u8
Definition: types.h:56
void ip4_preflen_to_mask(u8 pref_len, ip4_address_t *ip)
Definition: ip.c:196
u8 ip_is_zero(ip46_address_t *ip46_address, u8 is_ip4)
Definition: ip.c:20
u8 * name
Definition: ip.h:75
tcp_udp_port_info_t * port_infos
Definition: ip.h:122
u8 ip_is_local_host(ip46_address_t *ip46_address, u8 is_ip4)
Definition: ip.c:29
u32 flags
buffer flags: VLIB_BUFFER_FREE_LIST_INDEX_MASK: bits used to store free list index, VLIB_BUFFER_IS_TRACED: trace this buffer.
Definition: buffer.h:111
static vlib_buffer_t * vlib_get_buffer(vlib_main_t *vm, u32 buffer_index)
Translate buffer index into buffer pointer.
Definition: buffer_funcs.h:57