2 * snat.c - simple nat plugin
4 * Copyright (c) 2016 Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
18 #include <vnet/vnet.h>
19 #include <vnet/ip/ip.h>
20 #include <vnet/ip/ip4.h>
21 #include <vnet/plugin/plugin.h>
23 #include <nat/nat_ipfix_logging.h>
24 #include <nat/nat_det.h>
25 #include <nat/nat64.h>
26 #include <vnet/fib/fib_table.h>
27 #include <vnet/fib/ip4_fib.h>
29 #include <vpp/app/version.h>
31 snat_main_t snat_main;
34 /* Hook up input features */
35 VNET_FEATURE_INIT (ip4_snat_in2out, static) = {
36 .arc_name = "ip4-unicast",
37 .node_name = "nat44-in2out",
38 .runs_before = VNET_FEATURES ("nat44-out2in"),
40 VNET_FEATURE_INIT (ip4_snat_out2in, static) = {
41 .arc_name = "ip4-unicast",
42 .node_name = "nat44-out2in",
43 .runs_before = VNET_FEATURES ("ip4-lookup"),
45 VNET_FEATURE_INIT (ip4_snat_det_in2out, static) = {
46 .arc_name = "ip4-unicast",
47 .node_name = "nat44-det-in2out",
48 .runs_before = VNET_FEATURES ("nat44-det-out2in"),
50 VNET_FEATURE_INIT (ip4_snat_det_out2in, static) = {
51 .arc_name = "ip4-unicast",
52 .node_name = "nat44-det-out2in",
53 .runs_before = VNET_FEATURES ("ip4-lookup"),
55 VNET_FEATURE_INIT (ip4_snat_in2out_worker_handoff, static) = {
56 .arc_name = "ip4-unicast",
57 .node_name = "nat44-in2out-worker-handoff",
58 .runs_before = VNET_FEATURES ("nat44-out2in-worker-handoff"),
60 VNET_FEATURE_INIT (ip4_snat_out2in_worker_handoff, static) = {
61 .arc_name = "ip4-unicast",
62 .node_name = "nat44-out2in-worker-handoff",
63 .runs_before = VNET_FEATURES ("ip4-lookup"),
65 VNET_FEATURE_INIT (ip4_snat_in2out_fast, static) = {
66 .arc_name = "ip4-unicast",
67 .node_name = "nat44-in2out-fast",
68 .runs_before = VNET_FEATURES ("nat44-out2in-fast"),
70 VNET_FEATURE_INIT (ip4_snat_out2in_fast, static) = {
71 .arc_name = "ip4-unicast",
72 .node_name = "nat44-out2in-fast",
73 .runs_before = VNET_FEATURES ("ip4-lookup"),
75 VNET_FEATURE_INIT (ip4_snat_hairpin_dst, static) = {
76 .arc_name = "ip4-unicast",
77 .node_name = "nat44-hairpin-dst",
78 .runs_before = VNET_FEATURES ("ip4-lookup"),
81 /* Hook up output features */
82 VNET_FEATURE_INIT (ip4_snat_in2out_output, static) = {
83 .arc_name = "ip4-output",
84 .node_name = "nat44-in2out-output",
85 .runs_before = VNET_FEATURES ("interface-output"),
87 VNET_FEATURE_INIT (ip4_snat_in2out_output_worker_handoff, static) = {
88 .arc_name = "ip4-output",
89 .node_name = "nat44-in2out-output-worker-handoff",
90 .runs_before = VNET_FEATURES ("interface-output"),
92 VNET_FEATURE_INIT (ip4_snat_hairpin_src, static) = {
93 .arc_name = "ip4-output",
94 .node_name = "nat44-hairpin-src",
95 .runs_before = VNET_FEATURES ("interface-output"),
100 VLIB_PLUGIN_REGISTER () = {
101 .version = VPP_BUILD_VER,
102 .description = "Network Address Translation",
107 * @brief Add/del NAT address to FIB.
109 * Add the external NAT address to the FIB as receive entries. This ensures
110 * that VPP will reply to ARP for this address and we don't need to enable
111 * proxy ARP on the outside interface.
113 * @param addr IPv4 address.
114 * @param plen address prefix length
115 * @param sw_if_index Interface.
116 * @param is_add If 0 delete, otherwise add.
119 snat_add_del_addr_to_fib (ip4_address_t * addr, u8 p_len, u32 sw_if_index,
122 fib_prefix_t prefix = {
124 .fp_proto = FIB_PROTOCOL_IP4,
126 .ip4.as_u32 = addr->as_u32,
129 u32 fib_index = ip4_fib_table_get_index_for_sw_if_index(sw_if_index);
132 fib_table_entry_update_one_path(fib_index,
134 FIB_SOURCE_PLUGIN_HI,
135 (FIB_ENTRY_FLAG_CONNECTED |
136 FIB_ENTRY_FLAG_LOCAL |
137 FIB_ENTRY_FLAG_EXCLUSIVE),
144 FIB_ROUTE_PATH_FLAG_NONE);
146 fib_table_entry_delete(fib_index,
148 FIB_SOURCE_PLUGIN_HI);
151 void snat_add_address (snat_main_t *sm, ip4_address_t *addr, u32 vrf_id)
155 vlib_thread_main_t *tm = vlib_get_thread_main ();
160 /* Check if address already exists */
161 vec_foreach (ap, sm->addresses)
163 if (ap->addr.as_u32 == addr->as_u32)
167 vec_add2 (sm->addresses, ap, 1);
171 fib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4, vrf_id,
172 FIB_SOURCE_PLUGIN_HI);
175 #define _(N, i, n, s) \
176 clib_bitmap_alloc (ap->busy_##n##_port_bitmap, 65535); \
177 ap->busy_##n##_ports = 0; \
178 vec_validate_init_empty (ap->busy_##n##_ports_per_thread, tm->n_vlib_mains - 1, 0);
179 foreach_snat_protocol
182 /* Add external address to FIB */
183 pool_foreach (i, sm->interfaces,
188 snat_add_del_addr_to_fib(addr, 32, i->sw_if_index, 1);
191 pool_foreach (i, sm->output_feature_interfaces,
196 snat_add_del_addr_to_fib(addr, 32, i->sw_if_index, 1);
201 static int is_snat_address_used_in_static_mapping (snat_main_t *sm,
204 snat_static_mapping_t *m;
205 pool_foreach (m, sm->static_mappings,
207 if (m->external_addr.as_u32 == addr.as_u32)
214 void increment_v4_address (ip4_address_t * a)
218 v = clib_net_to_host_u32(a->as_u32) + 1;
219 a->as_u32 = clib_host_to_net_u32(v);
223 snat_add_static_mapping_when_resolved (snat_main_t * sm,
224 ip4_address_t l_addr,
229 snat_protocol_t proto,
233 snat_static_map_resolve_t *rp;
235 vec_add2 (sm->to_resolve, rp, 1);
236 rp->l_addr.as_u32 = l_addr.as_u32;
238 rp->sw_if_index = sw_if_index;
242 rp->addr_only = addr_only;
247 * @brief Add static mapping.
249 * Create static mapping between local addr+port and external addr+port.
251 * @param l_addr Local IPv4 address.
252 * @param e_addr External IPv4 address.
253 * @param l_port Local port number.
254 * @param e_port External port number.
255 * @param vrf_id VRF ID.
256 * @param addr_only If 0 address port and pair mapping, otherwise address only.
257 * @param sw_if_index External port instead of specific IP address.
258 * @param is_add If 0 delete static mapping, otherwise add.
262 int snat_add_static_mapping(ip4_address_t l_addr, ip4_address_t e_addr,
263 u16 l_port, u16 e_port, u32 vrf_id, int addr_only,
264 u32 sw_if_index, snat_protocol_t proto, int is_add)
266 snat_main_t * sm = &snat_main;
267 snat_static_mapping_t *m;
268 snat_session_key_t m_key;
269 clib_bihash_kv_8_8_t kv, value;
270 snat_address_t *a = 0;
273 snat_interface_t *interface;
276 /* If the external address is a specific interface address */
277 if (sw_if_index != ~0)
279 ip4_address_t * first_int_addr;
281 /* Might be already set... */
282 first_int_addr = ip4_interface_first_address
283 (sm->ip4_main, sw_if_index, 0 /* just want the address*/);
285 /* DHCP resolution required? */
286 if (first_int_addr == 0)
288 snat_add_static_mapping_when_resolved
289 (sm, l_addr, l_port, sw_if_index, e_port, vrf_id, proto,
294 e_addr.as_u32 = first_int_addr->as_u32;
298 m_key.port = addr_only ? 0 : e_port;
299 m_key.protocol = addr_only ? 0 : proto;
300 m_key.fib_index = sm->outside_fib_index;
301 kv.key = m_key.as_u64;
302 if (clib_bihash_search_8_8 (&sm->static_mapping_by_external, &kv, &value))
305 m = pool_elt_at_index (sm->static_mappings, value.value);
310 return VNET_API_ERROR_VALUE_EXIST;
312 /* Convert VRF id to FIB index */
315 p = hash_get (sm->ip4_main->fib_index_by_table_id, vrf_id);
317 return VNET_API_ERROR_NO_SUCH_FIB;
320 /* If not specified use inside VRF id from SNAT plugin startup config */
323 fib_index = sm->inside_fib_index;
324 vrf_id = sm->inside_vrf_id;
327 /* Find external address in allocated addresses and reserve port for
328 address and port pair mapping when dynamic translations enabled */
329 if (!addr_only && !(sm->static_mapping_only))
331 for (i = 0; i < vec_len (sm->addresses); i++)
333 if (sm->addresses[i].addr.as_u32 == e_addr.as_u32)
335 a = sm->addresses + i;
336 /* External port must be unused */
339 #define _(N, j, n, s) \
340 case SNAT_PROTOCOL_##N: \
341 if (clib_bitmap_get_no_check (a->busy_##n##_port_bitmap, e_port)) \
342 return VNET_API_ERROR_INVALID_VALUE; \
343 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, e_port, 1); \
346 a->busy_##n##_ports++; \
347 a->busy_##n##_ports_per_thread[(e_port - 1024) / sm->port_per_thread]++; \
350 foreach_snat_protocol
353 clib_warning("unknown_protocol");
354 return VNET_API_ERROR_INVALID_VALUE_2;
359 /* External address must be allocated */
361 return VNET_API_ERROR_NO_SUCH_ENTRY;
364 pool_get (sm->static_mappings, m);
365 memset (m, 0, sizeof (*m));
366 m->local_addr = l_addr;
367 m->external_addr = e_addr;
368 m->addr_only = addr_only;
370 m->fib_index = fib_index;
373 m->local_port = l_port;
374 m->external_port = e_port;
378 m_key.addr = m->local_addr;
379 m_key.port = m->local_port;
380 m_key.protocol = m->proto;
381 m_key.fib_index = m->fib_index;
382 kv.key = m_key.as_u64;
383 kv.value = m - sm->static_mappings;
384 clib_bihash_add_del_8_8(&sm->static_mapping_by_local, &kv, 1);
386 m_key.addr = m->external_addr;
387 m_key.port = m->external_port;
388 m_key.fib_index = sm->outside_fib_index;
389 kv.key = m_key.as_u64;
390 kv.value = m - sm->static_mappings;
391 clib_bihash_add_del_8_8(&sm->static_mapping_by_external, &kv, 1);
396 .src_address = m->local_addr,
398 m->worker_index = sm->worker_in2out_cb (&ip, m->fib_index);
404 return VNET_API_ERROR_NO_SUCH_ENTRY;
406 /* Free external address port */
407 if (!addr_only && !(sm->static_mapping_only))
409 for (i = 0; i < vec_len (sm->addresses); i++)
411 if (sm->addresses[i].addr.as_u32 == e_addr.as_u32)
413 a = sm->addresses + i;
416 #define _(N, j, n, s) \
417 case SNAT_PROTOCOL_##N: \
418 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, e_port, 0); \
421 a->busy_##n##_ports--; \
422 a->busy_##n##_ports_per_thread[(e_port - 1024) / sm->port_per_thread]--; \
425 foreach_snat_protocol
428 clib_warning("unknown_protocol");
429 return VNET_API_ERROR_INVALID_VALUE_2;
436 m_key.addr = m->local_addr;
437 m_key.port = m->local_port;
438 m_key.protocol = m->proto;
439 m_key.fib_index = m->fib_index;
440 kv.key = m_key.as_u64;
441 clib_bihash_add_del_8_8(&sm->static_mapping_by_local, &kv, 0);
443 m_key.addr = m->external_addr;
444 m_key.port = m->external_port;
445 m_key.fib_index = sm->outside_fib_index;
446 kv.key = m_key.as_u64;
447 clib_bihash_add_del_8_8(&sm->static_mapping_by_external, &kv, 0);
449 /* Delete session(s) for static mapping if exist */
450 if (!(sm->static_mapping_only) ||
451 (sm->static_mapping_only && sm->static_mapping_connection_tracking))
453 snat_user_key_t u_key;
455 dlist_elt_t * head, * elt;
456 u32 elt_index, head_index, del_elt_index;
460 snat_main_per_thread_data_t *tsm;
462 u_key.addr = m->local_addr;
463 u_key.fib_index = m->fib_index;
464 kv.key = u_key.as_u64;
466 tsm = vec_elt_at_index (sm->per_thread_data, m->worker_index);
468 tsm = vec_elt_at_index (sm->per_thread_data, sm->num_workers);
469 if (!clib_bihash_search_8_8 (&tsm->user_hash, &kv, &value))
471 user_index = value.value;
472 u = pool_elt_at_index (tsm->users, user_index);
473 if (u->nstaticsessions)
475 head_index = u->sessions_per_user_list_head_index;
476 head = pool_elt_at_index (tsm->list_pool, head_index);
477 elt_index = head->next;
478 elt = pool_elt_at_index (tsm->list_pool, elt_index);
479 ses_index = elt->value;
480 while (ses_index != ~0)
482 s = pool_elt_at_index (tsm->sessions, ses_index);
483 del_elt_index = elt_index;
484 elt_index = elt->next;
485 elt = pool_elt_at_index (tsm->list_pool, elt_index);
486 ses_index = elt->value;
490 if ((s->out2in.addr.as_u32 != e_addr.as_u32) &&
491 (clib_net_to_host_u16 (s->out2in.port) != e_port))
495 if (snat_is_unk_proto_session (s))
497 clib_bihash_kv_16_8_t up_kv;
498 nat_ed_ses_key_t up_key;
499 up_key.l_addr = s->in2out.addr;
500 up_key.r_addr = s->ext_host_addr;
501 up_key.fib_index = s->in2out.fib_index;
502 up_key.proto = s->in2out.port;
505 up_kv.key[0] = up_key.as_u64[0];
506 up_kv.key[1] = up_key.as_u64[1];
507 if (clib_bihash_add_del_16_8 (&sm->in2out_ed,
509 clib_warning ("in2out key del failed");
511 up_key.l_addr = s->out2in.addr;
512 up_key.fib_index = s->out2in.fib_index;
513 up_kv.key[0] = up_key.as_u64[0];
514 up_kv.key[1] = up_key.as_u64[1];
515 if (clib_bihash_add_del_16_8 (&sm->out2in_ed,
517 clib_warning ("out2in key del failed");
522 snat_ipfix_logging_nat44_ses_delete(s->in2out.addr.as_u32,
523 s->out2in.addr.as_u32,
527 s->in2out.fib_index);
529 value.key = s->in2out.as_u64;
530 if (clib_bihash_add_del_8_8 (&tsm->in2out, &value, 0))
531 clib_warning ("in2out key del failed");
532 value.key = s->out2in.as_u64;
533 if (clib_bihash_add_del_8_8 (&tsm->out2in, &value, 0))
534 clib_warning ("out2in key del failed");
536 pool_put (tsm->sessions, s);
538 clib_dlist_remove (tsm->list_pool, del_elt_index);
539 pool_put_index (tsm->list_pool, del_elt_index);
540 u->nstaticsessions--;
547 pool_put (tsm->users, u);
548 clib_bihash_add_del_8_8 (&tsm->user_hash, &kv, 0);
554 /* Delete static mapping from pool */
555 pool_put (sm->static_mappings, m);
561 /* Add/delete external address to FIB */
562 pool_foreach (interface, sm->interfaces,
564 if (interface->is_inside)
567 snat_add_del_addr_to_fib(&e_addr, 32, interface->sw_if_index, is_add);
570 pool_foreach (interface, sm->output_feature_interfaces,
572 if (interface->is_inside)
575 snat_add_del_addr_to_fib(&e_addr, 32, interface->sw_if_index, is_add);
582 int nat44_add_del_lb_static_mapping (ip4_address_t e_addr, u16 e_port,
583 snat_protocol_t proto, u32 vrf_id,
584 nat44_lb_addr_port_t *locals, u8 is_add)
586 snat_main_t * sm = &snat_main;
587 snat_static_mapping_t *m;
588 snat_session_key_t m_key;
589 clib_bihash_kv_8_8_t kv, value;
591 snat_address_t *a = 0;
593 nat44_lb_addr_port_t *local;
594 u32 worker_index = 0;
595 snat_main_per_thread_data_t *tsm;
599 m_key.protocol = proto;
600 m_key.fib_index = sm->outside_fib_index;
601 kv.key = m_key.as_u64;
602 if (clib_bihash_search_8_8 (&sm->static_mapping_by_external, &kv, &value))
605 m = pool_elt_at_index (sm->static_mappings, value.value);
610 return VNET_API_ERROR_VALUE_EXIST;
612 if (vec_len (locals) < 2)
613 return VNET_API_ERROR_INVALID_VALUE;
615 fib_index = fib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4,
617 FIB_SOURCE_PLUGIN_HI);
619 /* Find external address in allocated addresses and reserve port for
620 address and port pair mapping when dynamic translations enabled */
621 if (!sm->static_mapping_only)
623 for (i = 0; i < vec_len (sm->addresses); i++)
625 if (sm->addresses[i].addr.as_u32 == e_addr.as_u32)
627 a = sm->addresses + i;
628 /* External port must be unused */
631 #define _(N, j, n, s) \
632 case SNAT_PROTOCOL_##N: \
633 if (clib_bitmap_get_no_check (a->busy_##n##_port_bitmap, e_port)) \
634 return VNET_API_ERROR_INVALID_VALUE; \
635 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, e_port, 1); \
638 a->busy_##n##_ports++; \
639 a->busy_##n##_ports_per_thread[(e_port - 1024) / sm->port_per_thread]++; \
642 foreach_snat_protocol
645 clib_warning("unknown_protocol");
646 return VNET_API_ERROR_INVALID_VALUE_2;
651 /* External address must be allocated */
653 return VNET_API_ERROR_NO_SUCH_ENTRY;
656 pool_get (sm->static_mappings, m);
657 memset (m, 0, sizeof (*m));
658 m->external_addr = e_addr;
661 m->fib_index = fib_index;
662 m->external_port = e_port;
665 m_key.addr = m->external_addr;
666 m_key.port = m->external_port;
667 m_key.protocol = m->proto;
668 m_key.fib_index = sm->outside_fib_index;
669 kv.key = m_key.as_u64;
670 kv.value = m - sm->static_mappings;
671 if (clib_bihash_add_del_8_8(&sm->static_mapping_by_external, &kv, 1))
673 clib_warning ("static_mapping_by_external key add failed");
674 return VNET_API_ERROR_UNSPECIFIED;
680 worker_index = sm->first_worker_index +
681 sm->workers[sm->next_worker++ % vec_len (sm->workers)];
682 tsm = vec_elt_at_index (sm->per_thread_data, worker_index);
683 m->worker_index = worker_index;
686 tsm = vec_elt_at_index (sm->per_thread_data, sm->num_workers);
688 m_key.port = clib_host_to_net_u16 (m->external_port);
689 kv.key = m_key.as_u64;
691 if (clib_bihash_add_del_8_8(&tsm->out2in, &kv, 1))
693 clib_warning ("static_mapping_by_local key add failed");
694 return VNET_API_ERROR_UNSPECIFIED;
697 m_key.fib_index = m->fib_index;
698 for (i = 0; i < vec_len (locals); i++)
700 m_key.addr = locals[i].addr;
701 m_key.port = locals[i].port;
702 kv.key = m_key.as_u64;
703 kv.value = m - sm->static_mappings;
704 clib_bihash_add_del_8_8(&sm->static_mapping_by_local, &kv, 1);
705 locals[i].prefix = (i == 0) ? locals[i].probability :\
706 (locals[i - 1].prefix + locals[i].probability);
707 vec_add1 (m->locals, locals[i]);
709 m_key.port = clib_host_to_net_u16 (locals[i].port);
710 kv.key = m_key.as_u64;
712 if (clib_bihash_add_del_8_8(&tsm->in2out, &kv, 1))
714 clib_warning ("in2out key add failed");
715 return VNET_API_ERROR_UNSPECIFIED;
722 return VNET_API_ERROR_NO_SUCH_ENTRY;
724 fib_table_unlock (m->fib_index, FIB_PROTOCOL_IP4, FIB_SOURCE_PLUGIN_HI);
726 /* Free external address port */
727 if (!sm->static_mapping_only)
729 for (i = 0; i < vec_len (sm->addresses); i++)
731 if (sm->addresses[i].addr.as_u32 == e_addr.as_u32)
733 a = sm->addresses + i;
736 #define _(N, j, n, s) \
737 case SNAT_PROTOCOL_##N: \
738 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, e_port, 0); \
741 a->busy_##n##_ports--; \
742 a->busy_##n##_ports_per_thread[(e_port - 1024) / sm->port_per_thread]--; \
745 foreach_snat_protocol
748 clib_warning("unknown_protocol");
749 return VNET_API_ERROR_INVALID_VALUE_2;
756 tsm = vec_elt_at_index (sm->per_thread_data, m->worker_index);
757 m_key.addr = m->external_addr;
758 m_key.port = m->external_port;
759 m_key.protocol = m->proto;
760 m_key.fib_index = sm->outside_fib_index;
761 kv.key = m_key.as_u64;
762 if (clib_bihash_add_del_8_8(&sm->static_mapping_by_external, &kv, 0))
764 clib_warning ("static_mapping_by_external key del failed");
765 return VNET_API_ERROR_UNSPECIFIED;
768 m_key.port = clib_host_to_net_u16 (m->external_port);
769 kv.key = m_key.as_u64;
770 if (clib_bihash_add_del_8_8(&tsm->out2in, &kv, 0))
772 clib_warning ("outi2in key del failed");
773 return VNET_API_ERROR_UNSPECIFIED;
776 vec_foreach (local, m->locals)
778 m_key.addr = local->addr;
779 m_key.port = local->port;
780 m_key.fib_index = m->fib_index;
781 kv.key = m_key.as_u64;
782 if (clib_bihash_add_del_8_8(&sm->static_mapping_by_local, &kv, 0))
784 clib_warning ("static_mapping_by_local key del failed");
785 return VNET_API_ERROR_UNSPECIFIED;
788 m_key.port = clib_host_to_net_u16 (local->port);
789 kv.key = m_key.as_u64;
790 if (clib_bihash_add_del_8_8(&tsm->in2out, &kv, 0))
792 clib_warning ("in2out key del failed");
793 return VNET_API_ERROR_UNSPECIFIED;
798 pool_put (sm->static_mappings, m);
804 int snat_del_address (snat_main_t *sm, ip4_address_t addr, u8 delete_sm)
806 snat_address_t *a = 0;
808 u32 *ses_to_be_removed = 0, *ses_index;
809 clib_bihash_kv_8_8_t kv, value;
810 snat_user_key_t user_key;
812 snat_main_per_thread_data_t *tsm;
813 snat_static_mapping_t *m;
814 snat_interface_t *interface;
817 /* Find SNAT address */
818 for (i=0; i < vec_len (sm->addresses); i++)
820 if (sm->addresses[i].addr.as_u32 == addr.as_u32)
822 a = sm->addresses + i;
827 return VNET_API_ERROR_NO_SUCH_ENTRY;
831 pool_foreach (m, sm->static_mappings,
833 if (m->external_addr.as_u32 == addr.as_u32)
834 (void) snat_add_static_mapping (m->local_addr, m->external_addr,
835 m->local_port, m->external_port,
836 m->vrf_id, m->addr_only, ~0,
842 /* Check if address is used in some static mapping */
843 if (is_snat_address_used_in_static_mapping(sm, addr))
845 clib_warning ("address used in static mapping");
846 return VNET_API_ERROR_UNSPECIFIED;
850 if (a->fib_index != ~0)
851 fib_table_unlock(a->fib_index, FIB_PROTOCOL_IP4,
852 FIB_SOURCE_PLUGIN_HI);
854 /* Delete sessions using address */
855 if (a->busy_tcp_ports || a->busy_udp_ports || a->busy_icmp_ports)
857 vec_foreach (tsm, sm->per_thread_data)
859 pool_foreach (ses, tsm->sessions, ({
860 if (ses->out2in.addr.as_u32 == addr.as_u32)
862 if (snat_is_unk_proto_session (ses))
864 clib_bihash_kv_16_8_t up_kv;
865 nat_ed_ses_key_t up_key;
866 up_key.l_addr = ses->in2out.addr;
867 up_key.r_addr = ses->ext_host_addr;
868 up_key.fib_index = ses->in2out.fib_index;
869 up_key.proto = ses->in2out.port;
872 up_kv.key[0] = up_key.as_u64[0];
873 up_kv.key[1] = up_key.as_u64[1];
874 if (clib_bihash_add_del_16_8 (&sm->in2out_ed,
876 clib_warning ("in2out key del failed");
878 up_key.l_addr = ses->out2in.addr;
879 up_key.fib_index = ses->out2in.fib_index;
880 up_kv.key[0] = up_key.as_u64[0];
881 up_kv.key[1] = up_key.as_u64[1];
882 if (clib_bihash_add_del_16_8 (&sm->out2in_ed,
884 clib_warning ("out2in key del failed");
889 snat_ipfix_logging_nat44_ses_delete(ses->in2out.addr.as_u32,
890 ses->out2in.addr.as_u32,
891 ses->in2out.protocol,
894 ses->in2out.fib_index);
895 kv.key = ses->in2out.as_u64;
896 clib_bihash_add_del_8_8 (&tsm->in2out, &kv, 0);
897 kv.key = ses->out2in.as_u64;
898 clib_bihash_add_del_8_8 (&tsm->out2in, &kv, 0);
900 vec_add1 (ses_to_be_removed, ses - tsm->sessions);
901 clib_dlist_remove (tsm->list_pool, ses->per_user_index);
902 user_key.addr = ses->in2out.addr;
903 user_key.fib_index = ses->in2out.fib_index;
904 kv.key = user_key.as_u64;
905 if (!clib_bihash_search_8_8 (&tsm->user_hash, &kv, &value))
907 u = pool_elt_at_index (tsm->users, value.value);
913 vec_foreach (ses_index, ses_to_be_removed)
914 pool_put_index (tsm->sessions, ses_index[0]);
916 vec_free (ses_to_be_removed);
920 vec_del1 (sm->addresses, i);
922 /* Delete external address from FIB */
923 pool_foreach (interface, sm->interfaces,
925 if (interface->is_inside)
928 snat_add_del_addr_to_fib(&addr, 32, interface->sw_if_index, 0);
931 pool_foreach (interface, sm->output_feature_interfaces,
933 if (interface->is_inside)
936 snat_add_del_addr_to_fib(&addr, 32, interface->sw_if_index, 0);
943 int snat_interface_add_del (u32 sw_if_index, u8 is_inside, int is_del)
945 snat_main_t *sm = &snat_main;
947 const char * feature_name;
949 snat_static_mapping_t * m;
952 if (sm->static_mapping_only && !(sm->static_mapping_connection_tracking))
953 feature_name = is_inside ? "nat44-in2out-fast" : "nat44-out2in-fast";
956 if (sm->num_workers > 1 && !sm->deterministic)
957 feature_name = is_inside ? "nat44-in2out-worker-handoff" : "nat44-out2in-worker-handoff";
958 else if (sm->deterministic)
959 feature_name = is_inside ? "nat44-det-in2out" : "nat44-det-out2in";
961 feature_name = is_inside ? "nat44-in2out" : "nat44-out2in";
964 vnet_feature_enable_disable ("ip4-unicast", feature_name, sw_if_index,
967 if (sm->fq_in2out_index == ~0 && !sm->deterministic && sm->num_workers > 1)
968 sm->fq_in2out_index = vlib_frame_queue_main_init (sm->in2out_node_index, 0);
970 if (sm->fq_out2in_index == ~0 && !sm->deterministic && sm->num_workers > 1)
971 sm->fq_out2in_index = vlib_frame_queue_main_init (sm->out2in_node_index, 0);
973 pool_foreach (i, sm->interfaces,
975 if (i->sw_if_index == sw_if_index)
978 pool_put (sm->interfaces, i);
980 return VNET_API_ERROR_VALUE_EXIST;
987 return VNET_API_ERROR_NO_SUCH_ENTRY;
989 pool_get (sm->interfaces, i);
990 i->sw_if_index = sw_if_index;
991 i->is_inside = is_inside;
993 /* Add/delete external addresses to FIB */
998 vec_foreach (ap, sm->addresses)
999 snat_add_del_addr_to_fib(&ap->addr, 32, sw_if_index, !is_del);
1001 pool_foreach (m, sm->static_mappings,
1003 if (!(m->addr_only))
1006 snat_add_del_addr_to_fib(&m->external_addr, 32, sw_if_index, !is_del);
1009 pool_foreach (dm, sm->det_maps,
1011 snat_add_del_addr_to_fib(&dm->out_addr, dm->out_plen, sw_if_index, !is_del);
1017 int snat_interface_add_del_output_feature (u32 sw_if_index,
1021 snat_main_t *sm = &snat_main;
1022 snat_interface_t *i;
1023 snat_address_t * ap;
1024 snat_static_mapping_t * m;
1026 if (sm->deterministic ||
1027 (sm->static_mapping_only && !(sm->static_mapping_connection_tracking)))
1028 return VNET_API_ERROR_UNSUPPORTED;
1032 vnet_feature_enable_disable ("ip4-unicast", "nat44-hairpin-dst",
1033 sw_if_index, !is_del, 0, 0);
1034 vnet_feature_enable_disable ("ip4-output", "nat44-hairpin-src",
1035 sw_if_index, !is_del, 0, 0);
1039 if (sm->num_workers > 1)
1041 vnet_feature_enable_disable ("ip4-unicast", "nat44-out2in-worker-handoff",
1042 sw_if_index, !is_del, 0, 0);
1043 vnet_feature_enable_disable ("ip4-output",
1044 "nat44-in2out-output-worker-handoff",
1045 sw_if_index, !is_del, 0, 0);
1049 vnet_feature_enable_disable ("ip4-unicast", "nat44-out2in", sw_if_index,
1051 vnet_feature_enable_disable ("ip4-output", "nat44-in2out-output",
1052 sw_if_index, !is_del, 0, 0);
1056 if (sm->fq_in2out_output_index == ~0 && sm->num_workers > 1)
1057 sm->fq_in2out_output_index =
1058 vlib_frame_queue_main_init (sm->in2out_output_node_index, 0);
1060 if (sm->fq_out2in_index == ~0 && sm->num_workers > 1)
1061 sm->fq_out2in_index = vlib_frame_queue_main_init (sm->out2in_node_index, 0);
1063 pool_foreach (i, sm->output_feature_interfaces,
1065 if (i->sw_if_index == sw_if_index)
1068 pool_put (sm->output_feature_interfaces, i);
1070 return VNET_API_ERROR_VALUE_EXIST;
1077 return VNET_API_ERROR_NO_SUCH_ENTRY;
1079 pool_get (sm->output_feature_interfaces, i);
1080 i->sw_if_index = sw_if_index;
1081 i->is_inside = is_inside;
1083 /* Add/delete external addresses to FIB */
1088 vec_foreach (ap, sm->addresses)
1089 snat_add_del_addr_to_fib(&ap->addr, 32, sw_if_index, !is_del);
1091 pool_foreach (m, sm->static_mappings,
1093 if (!(m->addr_only))
1096 snat_add_del_addr_to_fib(&m->external_addr, 32, sw_if_index, !is_del);
1102 int snat_set_workers (uword * bitmap)
1104 snat_main_t *sm = &snat_main;
1107 if (sm->num_workers < 2)
1108 return VNET_API_ERROR_FEATURE_DISABLED;
1110 if (clib_bitmap_last_set (bitmap) >= sm->num_workers)
1111 return VNET_API_ERROR_INVALID_WORKER;
1113 vec_free (sm->workers);
1114 clib_bitmap_foreach (i, bitmap,
1116 vec_add1(sm->workers, i);
1117 sm->per_thread_data[i].snat_thread_index = j;
1121 sm->port_per_thread = (0xffff - 1024) / _vec_len (sm->workers);
1122 sm->num_snat_thread = _vec_len (sm->workers);
1129 snat_ip4_add_del_interface_address_cb (ip4_main_t * im,
1132 ip4_address_t * address,
1134 u32 if_address_index,
1137 static clib_error_t * snat_init (vlib_main_t * vm)
1139 snat_main_t * sm = &snat_main;
1140 clib_error_t * error = 0;
1141 ip4_main_t * im = &ip4_main;
1142 ip_lookup_main_t * lm = &im->lookup_main;
1144 vlib_thread_registration_t *tr;
1145 vlib_thread_main_t *tm = vlib_get_thread_main ();
1148 ip4_add_del_interface_address_callback_t cb4;
1151 sm->vnet_main = vnet_get_main();
1153 sm->ip4_lookup_main = lm;
1154 sm->api_main = &api_main;
1155 sm->first_worker_index = 0;
1156 sm->next_worker = 0;
1157 sm->num_workers = 0;
1158 sm->num_snat_thread = 1;
1160 sm->port_per_thread = 0xffff - 1024;
1161 sm->fq_in2out_index = ~0;
1162 sm->fq_out2in_index = ~0;
1163 sm->udp_timeout = SNAT_UDP_TIMEOUT;
1164 sm->tcp_established_timeout = SNAT_TCP_ESTABLISHED_TIMEOUT;
1165 sm->tcp_transitory_timeout = SNAT_TCP_TRANSITORY_TIMEOUT;
1166 sm->icmp_timeout = SNAT_ICMP_TIMEOUT;
1168 p = hash_get_mem (tm->thread_registrations_by_name, "workers");
1171 tr = (vlib_thread_registration_t *) p[0];
1174 sm->num_workers = tr->count;
1175 sm->first_worker_index = tr->first_index;
1179 vec_validate (sm->per_thread_data, tm->n_vlib_mains - 1);
1181 /* Use all available workers by default */
1182 if (sm->num_workers > 1)
1184 for (i=0; i < sm->num_workers; i++)
1185 bitmap = clib_bitmap_set (bitmap, i, 1);
1186 snat_set_workers(bitmap);
1187 clib_bitmap_free (bitmap);
1191 sm->per_thread_data[0].snat_thread_index = 0;
1194 error = snat_api_init(vm, sm);
1198 /* Set up the interface address add/del callback */
1199 cb4.function = snat_ip4_add_del_interface_address_cb;
1200 cb4.function_opaque = 0;
1202 vec_add1 (im->add_del_interface_address_callbacks, cb4);
1204 /* Init IPFIX logging */
1205 snat_ipfix_logging_init(vm);
1207 error = nat64_init(vm);
1212 VLIB_INIT_FUNCTION (snat_init);
1214 void snat_free_outside_address_and_port (snat_main_t * sm,
1216 snat_session_key_t * k,
1220 u16 port_host_byte_order = clib_net_to_host_u16 (k->port);
1222 ASSERT (address_index < vec_len (sm->addresses));
1224 a = sm->addresses + address_index;
1226 switch (k->protocol)
1228 #define _(N, i, n, s) \
1229 case SNAT_PROTOCOL_##N: \
1230 ASSERT (clib_bitmap_get_no_check (a->busy_##n##_port_bitmap, \
1231 port_host_byte_order) == 1); \
1232 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, \
1233 port_host_byte_order, 0); \
1234 a->busy_##n##_ports--; \
1235 a->busy_##n##_ports_per_thread[thread_index]--; \
1237 foreach_snat_protocol
1240 clib_warning("unknown_protocol");
1246 * @brief Match NAT44 static mapping.
1248 * @param sm NAT main.
1249 * @param match Address and port to match.
1250 * @param mapping External or local address and port of the matched mapping.
1251 * @param by_external If 0 match by local address otherwise match by external
1253 * @param is_addr_only If matched mapping is address only
1255 * @returns 0 if match found otherwise 1.
1257 int snat_static_mapping_match (snat_main_t * sm,
1258 snat_session_key_t match,
1259 snat_session_key_t * mapping,
1263 clib_bihash_kv_8_8_t kv, value;
1264 snat_static_mapping_t *m;
1265 snat_session_key_t m_key;
1266 clib_bihash_8_8_t *mapping_hash = &sm->static_mapping_by_local;
1267 u32 rand, lo = 0, hi, mid;
1270 mapping_hash = &sm->static_mapping_by_external;
1272 m_key.addr = match.addr;
1273 m_key.port = clib_net_to_host_u16 (match.port);
1274 m_key.protocol = match.protocol;
1275 m_key.fib_index = match.fib_index;
1277 kv.key = m_key.as_u64;
1279 if (clib_bihash_search_8_8 (mapping_hash, &kv, &value))
1281 /* Try address only mapping */
1284 kv.key = m_key.as_u64;
1285 if (clib_bihash_search_8_8 (mapping_hash, &kv, &value))
1289 m = pool_elt_at_index (sm->static_mappings, value.value);
1293 if (vec_len (m->locals))
1295 hi = vec_len (m->locals) - 1;
1296 rand = 1 + (random_u32 (&sm->random_seed) % m->locals[hi].prefix);
1299 mid = ((hi - lo) >> 1) + lo;
1300 (rand > m->locals[mid].prefix) ? (lo = mid + 1) : (hi = mid);
1302 if (!(m->locals[lo].prefix >= rand))
1304 mapping->addr = m->locals[lo].addr;
1305 mapping->port = clib_host_to_net_u16 (m->locals[lo].port);
1309 mapping->addr = m->local_addr;
1310 /* Address only mapping doesn't change port */
1311 mapping->port = m->addr_only ? match.port
1312 : clib_host_to_net_u16 (m->local_port);
1314 mapping->fib_index = m->fib_index;
1315 mapping->protocol = m->proto;
1319 mapping->addr = m->external_addr;
1320 /* Address only mapping doesn't change port */
1321 mapping->port = m->addr_only ? match.port
1322 : clib_host_to_net_u16 (m->external_port);
1323 mapping->fib_index = sm->outside_fib_index;
1326 if (PREDICT_FALSE(is_addr_only != 0))
1327 *is_addr_only = m->addr_only;
1332 static_always_inline u16
1333 snat_random_port (snat_main_t * sm, u16 min, u16 max)
1335 return min + random_u32 (&sm->random_seed) /
1336 (random_u32_max() / (max - min + 1) + 1);
1339 int snat_alloc_outside_address_and_port (snat_main_t * sm,
1342 snat_session_key_t * k,
1343 u32 * address_indexp)
1349 for (i = 0; i < vec_len (sm->addresses); i++)
1351 a = sm->addresses + i;
1352 if (sm->vrf_mode && a->fib_index != ~0 && a->fib_index != fib_index)
1354 switch (k->protocol)
1356 #define _(N, j, n, s) \
1357 case SNAT_PROTOCOL_##N: \
1358 if (a->busy_##n##_ports_per_thread[thread_index] < sm->port_per_thread) \
1362 portnum = (sm->port_per_thread * \
1363 sm->per_thread_data[thread_index].snat_thread_index) + \
1364 snat_random_port(sm, 1, sm->port_per_thread) + 1024; \
1365 if (clib_bitmap_get_no_check (a->busy_##n##_port_bitmap, portnum)) \
1367 clib_bitmap_set_no_check (a->busy_##n##_port_bitmap, portnum, 1); \
1368 a->busy_##n##_ports_per_thread[thread_index]++; \
1369 a->busy_##n##_ports++; \
1370 k->addr = a->addr; \
1371 k->port = clib_host_to_net_u16(portnum); \
1372 *address_indexp = i; \
1377 foreach_snat_protocol
1380 clib_warning("unknown protocol");
1385 /* Totally out of translations to use... */
1386 snat_ipfix_logging_addresses_exhausted(0);
1391 static clib_error_t *
1392 add_address_command_fn (vlib_main_t * vm,
1393 unformat_input_t * input,
1394 vlib_cli_command_t * cmd)
1396 unformat_input_t _line_input, *line_input = &_line_input;
1397 snat_main_t * sm = &snat_main;
1398 ip4_address_t start_addr, end_addr, this_addr;
1399 u32 start_host_order, end_host_order;
1404 clib_error_t *error = 0;
1406 /* Get a line of input. */
1407 if (!unformat_user (input, unformat_line_input, line_input))
1410 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1412 if (unformat (line_input, "%U - %U",
1413 unformat_ip4_address, &start_addr,
1414 unformat_ip4_address, &end_addr))
1416 else if (unformat (line_input, "tenant-vrf %u", &vrf_id))
1418 else if (unformat (line_input, "%U", unformat_ip4_address, &start_addr))
1419 end_addr = start_addr;
1420 else if (unformat (line_input, "del"))
1424 error = clib_error_return (0, "unknown input '%U'",
1425 format_unformat_error, line_input);
1430 if (sm->static_mapping_only)
1432 error = clib_error_return (0, "static mapping only mode");
1436 start_host_order = clib_host_to_net_u32 (start_addr.as_u32);
1437 end_host_order = clib_host_to_net_u32 (end_addr.as_u32);
1439 if (end_host_order < start_host_order)
1441 error = clib_error_return (0, "end address less than start address");
1445 count = (end_host_order - start_host_order) + 1;
1448 clib_warning ("%U - %U, %d addresses...",
1449 format_ip4_address, &start_addr,
1450 format_ip4_address, &end_addr,
1453 this_addr = start_addr;
1455 for (i = 0; i < count; i++)
1458 snat_add_address (sm, &this_addr, vrf_id);
1460 rv = snat_del_address (sm, this_addr, 0);
1464 case VNET_API_ERROR_NO_SUCH_ENTRY:
1465 error = clib_error_return (0, "S-NAT address not exist.");
1467 case VNET_API_ERROR_UNSPECIFIED:
1468 error = clib_error_return (0, "S-NAT address used in static mapping.");
1474 increment_v4_address (&this_addr);
1478 unformat_free (line_input);
1483 VLIB_CLI_COMMAND (add_address_command, static) = {
1484 .path = "nat44 add address",
1485 .short_help = "nat44 add address <ip4-range-start> [- <ip4-range-end>] "
1486 "[tenant-vrf <vrf-id>] [del]",
1487 .function = add_address_command_fn,
1490 static clib_error_t *
1491 snat_feature_command_fn (vlib_main_t * vm,
1492 unformat_input_t * input,
1493 vlib_cli_command_t * cmd)
1495 unformat_input_t _line_input, *line_input = &_line_input;
1496 vnet_main_t * vnm = vnet_get_main();
1497 clib_error_t * error = 0;
1499 u32 * inside_sw_if_indices = 0;
1500 u32 * outside_sw_if_indices = 0;
1501 u8 is_output_feature = 0;
1507 /* Get a line of input. */
1508 if (!unformat_user (input, unformat_line_input, line_input))
1511 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1513 if (unformat (line_input, "in %U", unformat_vnet_sw_interface,
1515 vec_add1 (inside_sw_if_indices, sw_if_index);
1516 else if (unformat (line_input, "out %U", unformat_vnet_sw_interface,
1518 vec_add1 (outside_sw_if_indices, sw_if_index);
1519 else if (unformat (line_input, "output-feature"))
1520 is_output_feature = 1;
1521 else if (unformat (line_input, "del"))
1525 error = clib_error_return (0, "unknown input '%U'",
1526 format_unformat_error, line_input);
1531 if (vec_len (inside_sw_if_indices))
1533 for (i = 0; i < vec_len(inside_sw_if_indices); i++)
1535 sw_if_index = inside_sw_if_indices[i];
1536 if (is_output_feature)
1538 if (snat_interface_add_del_output_feature (sw_if_index, 1, is_del))
1540 error = clib_error_return (0, "%s %U failed",
1541 is_del ? "del" : "add",
1542 format_vnet_sw_interface_name, vnm,
1543 vnet_get_sw_interface (vnm,
1550 if (snat_interface_add_del (sw_if_index, 1, is_del))
1552 error = clib_error_return (0, "%s %U failed",
1553 is_del ? "del" : "add",
1554 format_vnet_sw_interface_name, vnm,
1555 vnet_get_sw_interface (vnm,
1563 if (vec_len (outside_sw_if_indices))
1565 for (i = 0; i < vec_len(outside_sw_if_indices); i++)
1567 sw_if_index = outside_sw_if_indices[i];
1568 if (is_output_feature)
1570 if (snat_interface_add_del_output_feature (sw_if_index, 0, is_del))
1572 error = clib_error_return (0, "%s %U failed",
1573 is_del ? "del" : "add",
1574 format_vnet_sw_interface_name, vnm,
1575 vnet_get_sw_interface (vnm,
1582 if (snat_interface_add_del (sw_if_index, 0, is_del))
1584 error = clib_error_return (0, "%s %U failed",
1585 is_del ? "del" : "add",
1586 format_vnet_sw_interface_name, vnm,
1587 vnet_get_sw_interface (vnm,
1596 unformat_free (line_input);
1597 vec_free (inside_sw_if_indices);
1598 vec_free (outside_sw_if_indices);
1603 VLIB_CLI_COMMAND (set_interface_snat_command, static) = {
1604 .path = "set interface nat44",
1605 .function = snat_feature_command_fn,
1606 .short_help = "set interface nat44 in <intfc> out <intfc> [output-feature] "
1611 unformat_snat_protocol (unformat_input_t * input, va_list * args)
1613 u32 *r = va_arg (*args, u32 *);
1616 #define _(N, i, n, s) else if (unformat (input, s)) *r = SNAT_PROTOCOL_##N;
1617 foreach_snat_protocol
1625 format_snat_protocol (u8 * s, va_list * args)
1627 u32 i = va_arg (*args, u32);
1632 #define _(N, j, n, str) case SNAT_PROTOCOL_##N: t = (u8 *) str; break;
1633 foreach_snat_protocol
1636 s = format (s, "unknown");
1639 s = format (s, "%s", t);
1643 static clib_error_t *
1644 add_static_mapping_command_fn (vlib_main_t * vm,
1645 unformat_input_t * input,
1646 vlib_cli_command_t * cmd)
1648 unformat_input_t _line_input, *line_input = &_line_input;
1649 clib_error_t * error = 0;
1650 ip4_address_t l_addr, e_addr;
1651 u32 l_port = 0, e_port = 0, vrf_id = ~0;
1654 u32 sw_if_index = ~0;
1655 vnet_main_t * vnm = vnet_get_main();
1657 snat_protocol_t proto;
1660 /* Get a line of input. */
1661 if (!unformat_user (input, unformat_line_input, line_input))
1664 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1666 if (unformat (line_input, "local %U %u", unformat_ip4_address, &l_addr,
1669 else if (unformat (line_input, "local %U", unformat_ip4_address, &l_addr))
1671 else if (unformat (line_input, "external %U %u", unformat_ip4_address,
1674 else if (unformat (line_input, "external %U", unformat_ip4_address,
1677 else if (unformat (line_input, "external %U %u",
1678 unformat_vnet_sw_interface, vnm, &sw_if_index,
1682 else if (unformat (line_input, "external %U",
1683 unformat_vnet_sw_interface, vnm, &sw_if_index))
1685 else if (unformat (line_input, "vrf %u", &vrf_id))
1687 else if (unformat (line_input, "%U", unformat_snat_protocol, &proto))
1689 else if (unformat (line_input, "del"))
1693 error = clib_error_return (0, "unknown input: '%U'",
1694 format_unformat_error, line_input);
1699 if (!addr_only && !proto_set)
1701 error = clib_error_return (0, "missing protocol");
1705 rv = snat_add_static_mapping(l_addr, e_addr, (u16) l_port, (u16) e_port,
1706 vrf_id, addr_only, sw_if_index, proto, is_add);
1710 case VNET_API_ERROR_INVALID_VALUE:
1711 error = clib_error_return (0, "External port already in use.");
1713 case VNET_API_ERROR_NO_SUCH_ENTRY:
1715 error = clib_error_return (0, "External addres must be allocated.");
1717 error = clib_error_return (0, "Mapping not exist.");
1719 case VNET_API_ERROR_NO_SUCH_FIB:
1720 error = clib_error_return (0, "No such VRF id.");
1722 case VNET_API_ERROR_VALUE_EXIST:
1723 error = clib_error_return (0, "Mapping already exist.");
1730 unformat_free (line_input);
1737 * @cliexstart{snat add static mapping}
1738 * Static mapping allows hosts on the external network to initiate connection
1739 * to to the local network host.
1740 * To create static mapping between local host address 10.0.0.3 port 6303 and
1741 * external address 4.4.4.4 port 3606 for TCP protocol use:
1742 * vpp# nat44 add static mapping tcp local 10.0.0.3 6303 external 4.4.4.4 3606
1743 * If not runnig "static mapping only" NAT plugin mode use before:
1744 * vpp# nat44 add address 4.4.4.4
1745 * To create static mapping between local and external address use:
1746 * vpp# nat44 add static mapping local 10.0.0.3 external 4.4.4.4
1749 VLIB_CLI_COMMAND (add_static_mapping_command, static) = {
1750 .path = "nat44 add static mapping",
1751 .function = add_static_mapping_command_fn,
1753 "nat44 add static mapping tcp|udp|icmp local <addr> [<port>] external <addr> [<port>] [vrf <table-id>] [del]",
1756 static clib_error_t *
1757 add_lb_static_mapping_command_fn (vlib_main_t * vm,
1758 unformat_input_t * input,
1759 vlib_cli_command_t * cmd)
1761 unformat_input_t _line_input, *line_input = &_line_input;
1762 clib_error_t * error = 0;
1763 ip4_address_t l_addr, e_addr;
1764 u32 l_port = 0, e_port = 0, vrf_id = 0, probability = 0;
1767 snat_protocol_t proto;
1769 nat44_lb_addr_port_t *locals = 0, local;
1771 /* Get a line of input. */
1772 if (!unformat_user (input, unformat_line_input, line_input))
1775 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1777 if (unformat (line_input, "local %U:%u probability %u",
1778 unformat_ip4_address, &l_addr, &l_port, &probability))
1780 memset (&local, 0, sizeof (local));
1781 local.addr = l_addr;
1782 local.port = (u16) l_port;
1783 local.probability = (u8) probability;
1784 vec_add1 (locals, local);
1786 else if (unformat (line_input, "external %U:%u", unformat_ip4_address,
1789 else if (unformat (line_input, "vrf %u", &vrf_id))
1791 else if (unformat (line_input, "protocol %U", unformat_snat_protocol,
1794 else if (unformat (line_input, "del"))
1798 error = clib_error_return (0, "unknown input: '%U'",
1799 format_unformat_error, line_input);
1804 if (vec_len (locals) < 2)
1806 error = clib_error_return (0, "at least two local must be set");
1812 error = clib_error_return (0, "missing protocol");
1816 rv = nat44_add_del_lb_static_mapping (e_addr, (u16) e_port, proto, vrf_id,
1821 case VNET_API_ERROR_INVALID_VALUE:
1822 error = clib_error_return (0, "External port already in use.");
1824 case VNET_API_ERROR_NO_SUCH_ENTRY:
1826 error = clib_error_return (0, "External addres must be allocated.");
1828 error = clib_error_return (0, "Mapping not exist.");
1830 case VNET_API_ERROR_VALUE_EXIST:
1831 error = clib_error_return (0, "Mapping already exist.");
1838 unformat_free (line_input);
1844 VLIB_CLI_COMMAND (add_lb_static_mapping_command, static) = {
1845 .path = "nat44 add load-balancing static mapping",
1846 .function = add_lb_static_mapping_command_fn,
1848 "nat44 add load-balancing static mapping protocol tcp|udp external <addr>:<port> local <addr>:<port> probability <n> [vrf <table-id>] [del]",
1851 static clib_error_t *
1852 set_workers_command_fn (vlib_main_t * vm,
1853 unformat_input_t * input,
1854 vlib_cli_command_t * cmd)
1856 unformat_input_t _line_input, *line_input = &_line_input;
1859 clib_error_t *error = 0;
1861 /* Get a line of input. */
1862 if (!unformat_user (input, unformat_line_input, line_input))
1865 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1867 if (unformat (line_input, "%U", unformat_bitmap_list, &bitmap))
1871 error = clib_error_return (0, "unknown input '%U'",
1872 format_unformat_error, line_input);
1879 error = clib_error_return (0, "List of workers must be specified.");
1883 rv = snat_set_workers(bitmap);
1885 clib_bitmap_free (bitmap);
1889 case VNET_API_ERROR_INVALID_WORKER:
1890 error = clib_error_return (0, "Invalid worker(s).");
1892 case VNET_API_ERROR_FEATURE_DISABLED:
1893 error = clib_error_return (0,
1894 "Supported only if 2 or more workes available.");
1901 unformat_free (line_input);
1908 * @cliexstart{set snat workers}
1909 * Set NAT workers if 2 or more workers available, use:
1910 * vpp# set snat workers 0-2,5
1913 VLIB_CLI_COMMAND (set_workers_command, static) = {
1914 .path = "set nat workers",
1915 .function = set_workers_command_fn,
1917 "set nat workers <workers-list>",
1920 static clib_error_t *
1921 snat_ipfix_logging_enable_disable_command_fn (vlib_main_t * vm,
1922 unformat_input_t * input,
1923 vlib_cli_command_t * cmd)
1925 unformat_input_t _line_input, *line_input = &_line_input;
1930 clib_error_t *error = 0;
1932 /* Get a line of input. */
1933 if (!unformat_user (input, unformat_line_input, line_input))
1936 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1938 if (unformat (line_input, "domain %d", &domain_id))
1940 else if (unformat (line_input, "src-port %d", &src_port))
1942 else if (unformat (line_input, "disable"))
1946 error = clib_error_return (0, "unknown input '%U'",
1947 format_unformat_error, line_input);
1952 rv = snat_ipfix_logging_enable_disable (enable, domain_id, (u16) src_port);
1956 error = clib_error_return (0, "ipfix logging enable failed");
1961 unformat_free (line_input);
1968 * @cliexstart{snat ipfix logging}
1969 * To enable NAT IPFIX logging use:
1970 * vpp# nat ipfix logging
1971 * To set IPFIX exporter use:
1972 * vpp# set ipfix exporter collector 10.10.10.3 src 10.10.10.1
1975 VLIB_CLI_COMMAND (snat_ipfix_logging_enable_disable_command, static) = {
1976 .path = "nat ipfix logging",
1977 .function = snat_ipfix_logging_enable_disable_command_fn,
1978 .short_help = "nat ipfix logging [domain <domain-id>] [src-port <port>] [disable]",
1982 snat_get_worker_in2out_cb (ip4_header_t * ip0, u32 rx_fib_index0)
1984 snat_main_t *sm = &snat_main;
1985 u32 next_worker_index = 0;
1988 next_worker_index = sm->first_worker_index;
1989 hash = ip0->src_address.as_u32 + (ip0->src_address.as_u32 >> 8) +
1990 (ip0->src_address.as_u32 >> 16) + (ip0->src_address.as_u32 >>24);
1992 if (PREDICT_TRUE (is_pow2 (_vec_len (sm->workers))))
1993 next_worker_index += sm->workers[hash & (_vec_len (sm->workers) - 1)];
1995 next_worker_index += sm->workers[hash % _vec_len (sm->workers)];
1997 return next_worker_index;
2001 snat_get_worker_out2in_cb (ip4_header_t * ip0, u32 rx_fib_index0)
2003 snat_main_t *sm = &snat_main;
2006 snat_session_key_t m_key;
2007 clib_bihash_kv_8_8_t kv, value;
2008 snat_static_mapping_t *m;
2009 nat_ed_ses_key_t key;
2010 clib_bihash_kv_16_8_t s_kv, s_value;
2011 snat_main_per_thread_data_t *tsm;
2016 /* first try static mappings without port */
2017 if (PREDICT_FALSE (pool_elts (sm->static_mappings)))
2019 m_key.addr = ip0->dst_address;
2022 m_key.fib_index = rx_fib_index0;
2023 kv.key = m_key.as_u64;
2024 if (!clib_bihash_search_8_8 (&sm->static_mapping_by_external, &kv, &value))
2026 m = pool_elt_at_index (sm->static_mappings, value.value);
2027 return m->worker_index;
2031 proto = ip_proto_to_snat_proto (ip0->protocol);
2032 udp = ip4_next_header (ip0);
2033 port = udp->dst_port;
2035 /* unknown protocol */
2036 if (PREDICT_FALSE (proto == ~0))
2038 key.l_addr = ip0->dst_address;
2039 key.r_addr = ip0->src_address;
2040 key.fib_index = rx_fib_index0;
2041 key.proto = ip0->protocol;
2044 s_kv.key[0] = key.as_u64[0];
2045 s_kv.key[1] = key.as_u64[1];
2047 if (!clib_bihash_search_16_8 (&sm->out2in_ed, &s_kv, &s_value))
2049 for (i = 0; i < _vec_len (sm->per_thread_data); i++)
2051 tsm = vec_elt_at_index (sm->per_thread_data, i);
2052 if (!pool_is_free_index(tsm->sessions, s_value.value))
2054 s = pool_elt_at_index (tsm->sessions, s_value.value);
2055 if (s->out2in.addr.as_u32 == ip0->dst_address.as_u32 &&
2056 s->out2in.port == ip0->protocol &&
2057 snat_is_unk_proto_session (s))
2063 /* if no session use current thread */
2064 return vlib_get_thread_index ();
2067 if (PREDICT_FALSE (ip0->protocol == IP_PROTOCOL_ICMP))
2069 icmp46_header_t * icmp = (icmp46_header_t *) udp;
2070 icmp_echo_header_t *echo = (icmp_echo_header_t *)(icmp + 1);
2071 if (!icmp_is_error_message (icmp))
2072 port = echo->identifier;
2075 ip4_header_t *inner_ip = (ip4_header_t *)(echo + 1);
2076 proto = ip_proto_to_snat_proto (inner_ip->protocol);
2077 void *l4_header = ip4_next_header (inner_ip);
2080 case SNAT_PROTOCOL_ICMP:
2081 icmp = (icmp46_header_t*)l4_header;
2082 echo = (icmp_echo_header_t *)(icmp + 1);
2083 port = echo->identifier;
2085 case SNAT_PROTOCOL_UDP:
2086 case SNAT_PROTOCOL_TCP:
2087 port = ((tcp_udp_header_t*)l4_header)->src_port;
2090 return vlib_get_thread_index ();
2095 /* try static mappings with port */
2096 if (PREDICT_FALSE (pool_elts (sm->static_mappings)))
2098 m_key.addr = ip0->dst_address;
2099 m_key.port = clib_net_to_host_u16 (port);
2100 m_key.protocol = proto;
2101 m_key.fib_index = rx_fib_index0;
2102 kv.key = m_key.as_u64;
2103 if (!clib_bihash_search_8_8 (&sm->static_mapping_by_external, &kv, &value))
2105 m = pool_elt_at_index (sm->static_mappings, value.value);
2106 return m->worker_index;
2110 /* worker by outside port */
2111 return (u32) ((clib_net_to_host_u16 (port) - 1024) / sm->port_per_thread);
2114 static clib_error_t *
2115 snat_config (vlib_main_t * vm, unformat_input_t * input)
2117 snat_main_t * sm = &snat_main;
2118 u32 translation_buckets = 1024;
2119 u32 translation_memory_size = 128<<20;
2120 u32 user_buckets = 128;
2121 u32 user_memory_size = 64<<20;
2122 u32 max_translations_per_user = 100;
2123 u32 outside_vrf_id = 0;
2124 u32 inside_vrf_id = 0;
2125 u32 static_mapping_buckets = 1024;
2126 u32 static_mapping_memory_size = 64<<20;
2127 u8 static_mapping_only = 0;
2128 u8 static_mapping_connection_tracking = 0;
2129 snat_main_per_thread_data_t *tsm;
2131 sm->deterministic = 0;
2133 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
2135 if (unformat (input, "translation hash buckets %d", &translation_buckets))
2137 else if (unformat (input, "translation hash memory %d",
2138 &translation_memory_size));
2139 else if (unformat (input, "user hash buckets %d", &user_buckets))
2141 else if (unformat (input, "user hash memory %d",
2144 else if (unformat (input, "max translations per user %d",
2145 &max_translations_per_user))
2147 else if (unformat (input, "outside VRF id %d",
2150 else if (unformat (input, "inside VRF id %d",
2153 else if (unformat (input, "static mapping only"))
2155 static_mapping_only = 1;
2156 if (unformat (input, "connection tracking"))
2157 static_mapping_connection_tracking = 1;
2159 else if (unformat (input, "deterministic"))
2160 sm->deterministic = 1;
2162 return clib_error_return (0, "unknown input '%U'",
2163 format_unformat_error, input);
2166 /* for show commands, etc. */
2167 sm->translation_buckets = translation_buckets;
2168 sm->translation_memory_size = translation_memory_size;
2169 /* do not exceed load factor 10 */
2170 sm->max_translations = 10 * translation_buckets;
2171 sm->user_buckets = user_buckets;
2172 sm->user_memory_size = user_memory_size;
2173 sm->max_translations_per_user = max_translations_per_user;
2174 sm->outside_vrf_id = outside_vrf_id;
2175 sm->outside_fib_index = fib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4,
2177 FIB_SOURCE_PLUGIN_HI);
2178 sm->inside_vrf_id = inside_vrf_id;
2179 sm->inside_fib_index = fib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4,
2181 FIB_SOURCE_PLUGIN_HI);
2182 sm->static_mapping_only = static_mapping_only;
2183 sm->static_mapping_connection_tracking = static_mapping_connection_tracking;
2185 if (sm->deterministic)
2187 sm->in2out_node_index = snat_det_in2out_node.index;
2188 sm->in2out_output_node_index = ~0;
2189 sm->out2in_node_index = snat_det_out2in_node.index;
2190 sm->icmp_match_in2out_cb = icmp_match_in2out_det;
2191 sm->icmp_match_out2in_cb = icmp_match_out2in_det;
2195 sm->worker_in2out_cb = snat_get_worker_in2out_cb;
2196 sm->worker_out2in_cb = snat_get_worker_out2in_cb;
2197 sm->in2out_node_index = snat_in2out_node.index;
2198 sm->in2out_output_node_index = snat_in2out_output_node.index;
2199 sm->out2in_node_index = snat_out2in_node.index;
2200 if (!static_mapping_only ||
2201 (static_mapping_only && static_mapping_connection_tracking))
2203 sm->icmp_match_in2out_cb = icmp_match_in2out_slow;
2204 sm->icmp_match_out2in_cb = icmp_match_out2in_slow;
2206 vec_foreach (tsm, sm->per_thread_data)
2208 clib_bihash_init_8_8 (&tsm->in2out, "in2out", translation_buckets,
2209 translation_memory_size);
2211 clib_bihash_init_8_8 (&tsm->out2in, "out2in", translation_buckets,
2212 translation_memory_size);
2214 clib_bihash_init_8_8 (&tsm->user_hash, "users", user_buckets,
2218 clib_bihash_init_16_8 (&sm->in2out_ed, "in2out-ed",
2219 translation_buckets, translation_memory_size);
2221 clib_bihash_init_16_8 (&sm->out2in_ed, "out2in-ed",
2222 translation_buckets, translation_memory_size);
2226 sm->icmp_match_in2out_cb = icmp_match_in2out_fast;
2227 sm->icmp_match_out2in_cb = icmp_match_out2in_fast;
2229 clib_bihash_init_8_8 (&sm->static_mapping_by_local,
2230 "static_mapping_by_local", static_mapping_buckets,
2231 static_mapping_memory_size);
2233 clib_bihash_init_8_8 (&sm->static_mapping_by_external,
2234 "static_mapping_by_external", static_mapping_buckets,
2235 static_mapping_memory_size);
2241 VLIB_CONFIG_FUNCTION (snat_config, "nat");
2243 u8 * format_snat_session_state (u8 * s, va_list * args)
2245 u32 i = va_arg (*args, u32);
2250 #define _(v, N, str) case SNAT_SESSION_##N: t = (u8 *) str; break;
2251 foreach_snat_session_state
2254 t = format (t, "unknown");
2256 s = format (s, "%s", t);
2260 u8 * format_snat_key (u8 * s, va_list * args)
2262 snat_session_key_t * key = va_arg (*args, snat_session_key_t *);
2264 s = format (s, "%U proto %U port %d fib %d",
2265 format_ip4_address, &key->addr,
2266 format_snat_protocol, key->protocol,
2267 clib_net_to_host_u16 (key->port), key->fib_index);
2271 u8 * format_snat_session (u8 * s, va_list * args)
2273 snat_main_t * sm __attribute__((unused)) = va_arg (*args, snat_main_t *);
2274 snat_session_t * sess = va_arg (*args, snat_session_t *);
2276 if (snat_is_unk_proto_session (sess))
2278 s = format (s, " i2o %U proto %u fib %u\n",
2279 format_ip4_address, &sess->in2out.addr, sess->in2out.port,
2280 sess->in2out.fib_index);
2281 s = format (s, " o2i %U proto %u fib %u\n",
2282 format_ip4_address, &sess->out2in.addr, sess->out2in.port,
2283 sess->out2in.fib_index);
2287 s = format (s, " i2o %U\n", format_snat_key, &sess->in2out);
2288 s = format (s, " o2i %U\n", format_snat_key, &sess->out2in);
2290 if (sess->ext_host_addr.as_u32)
2291 s = format (s, " external host %U\n",
2292 format_ip4_address, &sess->ext_host_addr);
2293 s = format (s, " last heard %.2f\n", sess->last_heard);
2294 s = format (s, " total pkts %d, total bytes %lld\n",
2295 sess->total_pkts, sess->total_bytes);
2296 if (snat_is_session_static (sess))
2297 s = format (s, " static translation\n");
2299 s = format (s, " dynamic translation\n");
2300 if (sess->flags & SNAT_SESSION_FLAG_LOAD_BALANCING)
2301 s = format (s, " load-balancing\n");
2306 u8 * format_snat_user (u8 * s, va_list * args)
2308 snat_main_per_thread_data_t * sm = va_arg (*args, snat_main_per_thread_data_t *);
2309 snat_user_t * u = va_arg (*args, snat_user_t *);
2310 int verbose = va_arg (*args, int);
2311 dlist_elt_t * head, * elt;
2312 u32 elt_index, head_index;
2314 snat_session_t * sess;
2316 s = format (s, "%U: %d dynamic translations, %d static translations\n",
2317 format_ip4_address, &u->addr, u->nsessions, u->nstaticsessions);
2322 if (u->nsessions || u->nstaticsessions)
2324 head_index = u->sessions_per_user_list_head_index;
2325 head = pool_elt_at_index (sm->list_pool, head_index);
2327 elt_index = head->next;
2328 elt = pool_elt_at_index (sm->list_pool, elt_index);
2329 session_index = elt->value;
2331 while (session_index != ~0)
2333 sess = pool_elt_at_index (sm->sessions, session_index);
2335 s = format (s, " %U\n", format_snat_session, sm, sess);
2337 elt_index = elt->next;
2338 elt = pool_elt_at_index (sm->list_pool, elt_index);
2339 session_index = elt->value;
2346 u8 * format_snat_static_mapping (u8 * s, va_list * args)
2348 snat_static_mapping_t *m = va_arg (*args, snat_static_mapping_t *);
2349 nat44_lb_addr_port_t *local;
2352 s = format (s, "local %U external %U vrf %d",
2353 format_ip4_address, &m->local_addr,
2354 format_ip4_address, &m->external_addr,
2358 if (vec_len (m->locals))
2360 s = format (s, "%U vrf %d external %U:%d",
2361 format_snat_protocol, m->proto,
2363 format_ip4_address, &m->external_addr, m->external_port);
2364 vec_foreach (local, m->locals)
2365 s = format (s, "\n local %U:%d probability %d\%",
2366 format_ip4_address, &local->addr, local->port,
2367 local->probability);
2370 s = format (s, "%U local %U:%d external %U:%d vrf %d",
2371 format_snat_protocol, m->proto,
2372 format_ip4_address, &m->local_addr, m->local_port,
2373 format_ip4_address, &m->external_addr, m->external_port,
2379 u8 * format_snat_static_map_to_resolve (u8 * s, va_list * args)
2381 snat_static_map_resolve_t *m = va_arg (*args, snat_static_map_resolve_t *);
2382 vnet_main_t *vnm = vnet_get_main();
2385 s = format (s, "local %U external %U vrf %d",
2386 format_ip4_address, &m->l_addr,
2387 format_vnet_sw_interface_name, vnm,
2388 vnet_get_sw_interface (vnm, m->sw_if_index),
2391 s = format (s, "%U local %U:%d external %U:%d vrf %d",
2392 format_snat_protocol, m->proto,
2393 format_ip4_address, &m->l_addr, m->l_port,
2394 format_vnet_sw_interface_name, vnm,
2395 vnet_get_sw_interface (vnm, m->sw_if_index), m->e_port,
2401 u8 * format_det_map_ses (u8 * s, va_list * args)
2403 snat_det_map_t * det_map = va_arg (*args, snat_det_map_t *);
2404 ip4_address_t in_addr, out_addr;
2405 u32 in_offset, out_offset;
2406 snat_det_session_t * ses = va_arg (*args, snat_det_session_t *);
2407 u32 * i = va_arg (*args, u32 *);
2409 u32 user_index = *i / SNAT_DET_SES_PER_USER;
2410 in_addr.as_u32 = clib_host_to_net_u32 (
2411 clib_net_to_host_u32(det_map->in_addr.as_u32) + user_index);
2412 in_offset = clib_net_to_host_u32(in_addr.as_u32) -
2413 clib_net_to_host_u32(det_map->in_addr.as_u32);
2414 out_offset = in_offset / det_map->sharing_ratio;
2415 out_addr.as_u32 = clib_host_to_net_u32(
2416 clib_net_to_host_u32(det_map->out_addr.as_u32) + out_offset);
2417 s = format (s, "in %U:%d out %U:%d external host %U:%d state: %U expire: %d\n",
2418 format_ip4_address, &in_addr,
2419 clib_net_to_host_u16 (ses->in_port),
2420 format_ip4_address, &out_addr,
2421 clib_net_to_host_u16 (ses->out.out_port),
2422 format_ip4_address, &ses->out.ext_host_addr,
2423 clib_net_to_host_u16 (ses->out.ext_host_port),
2424 format_snat_session_state, ses->state,
2430 static clib_error_t *
2431 show_snat_command_fn (vlib_main_t * vm,
2432 unformat_input_t * input,
2433 vlib_cli_command_t * cmd)
2436 snat_main_t * sm = &snat_main;
2438 snat_static_mapping_t *m;
2439 snat_interface_t *i;
2440 snat_address_t * ap;
2441 vnet_main_t *vnm = vnet_get_main();
2442 snat_main_per_thread_data_t *tsm;
2443 u32 users_num = 0, sessions_num = 0, *worker, *sw_if_index;
2445 snat_static_map_resolve_t *rp;
2446 snat_det_map_t * dm;
2447 snat_det_session_t * ses;
2449 if (unformat (input, "detail"))
2451 else if (unformat (input, "verbose"))
2454 if (sm->static_mapping_only)
2456 if (sm->static_mapping_connection_tracking)
2457 vlib_cli_output (vm, "NAT plugin mode: static mapping only connection "
2460 vlib_cli_output (vm, "NAT plugin mode: static mapping only");
2462 else if (sm->deterministic)
2464 vlib_cli_output (vm, "NAT plugin mode: deterministic mapping");
2468 vlib_cli_output (vm, "NAT plugin mode: dynamic translations enabled");
2473 pool_foreach (i, sm->interfaces,
2475 vlib_cli_output (vm, "%U %s", format_vnet_sw_interface_name, vnm,
2476 vnet_get_sw_interface (vnm, i->sw_if_index),
2477 i->is_inside ? "in" : "out");
2480 pool_foreach (i, sm->output_feature_interfaces,
2482 vlib_cli_output (vm, "%U output-feature %s",
2483 format_vnet_sw_interface_name, vnm,
2484 vnet_get_sw_interface (vnm, i->sw_if_index),
2485 i->is_inside ? "in" : "out");
2488 if (vec_len (sm->auto_add_sw_if_indices))
2490 vlib_cli_output (vm, "NAT44 pool addresses interfaces:");
2491 vec_foreach (sw_if_index, sm->auto_add_sw_if_indices)
2493 vlib_cli_output (vm, "%U", format_vnet_sw_interface_name, vnm,
2494 vnet_get_sw_interface (vnm, *sw_if_index));
2498 vec_foreach (ap, sm->addresses)
2500 vlib_cli_output (vm, "%U", format_ip4_address, &ap->addr);
2501 if (ap->fib_index != ~0)
2502 vlib_cli_output (vm, " tenant VRF: %u",
2503 ip4_fib_get(ap->fib_index)->table_id);
2505 vlib_cli_output (vm, " tenant VRF independent");
2506 #define _(N, i, n, s) \
2507 vlib_cli_output (vm, " %d busy %s ports", ap->busy_##n##_ports, s);
2508 foreach_snat_protocol
2513 if (sm->num_workers > 1)
2515 vlib_cli_output (vm, "%d workers", vec_len (sm->workers));
2518 vec_foreach (worker, sm->workers)
2520 vlib_worker_thread_t *w =
2521 vlib_worker_threads + *worker + sm->first_worker_index;
2522 vlib_cli_output (vm, " %s", w->name);
2527 if (sm->deterministic)
2529 vlib_cli_output (vm, "udp timeout: %dsec", sm->udp_timeout);
2530 vlib_cli_output (vm, "tcp-established timeout: %dsec",
2531 sm->tcp_established_timeout);
2532 vlib_cli_output (vm, "tcp-transitory timeout: %dsec",
2533 sm->tcp_transitory_timeout);
2534 vlib_cli_output (vm, "icmp timeout: %dsec", sm->icmp_timeout);
2535 vlib_cli_output (vm, "%d deterministic mappings",
2536 pool_elts (sm->det_maps));
2539 pool_foreach (dm, sm->det_maps,
2541 vlib_cli_output (vm, "in %U/%d out %U/%d\n",
2542 format_ip4_address, &dm->in_addr, dm->in_plen,
2543 format_ip4_address, &dm->out_addr, dm->out_plen);
2544 vlib_cli_output (vm, " outside address sharing ratio: %d\n",
2546 vlib_cli_output (vm, " number of ports per inside host: %d\n",
2547 dm->ports_per_host);
2548 vlib_cli_output (vm, " sessions number: %d\n", dm->ses_num);
2551 vec_foreach_index (j, dm->sessions)
2553 ses = vec_elt_at_index (dm->sessions, j);
2555 vlib_cli_output (vm, " %U", format_det_map_ses, dm, ses,
2564 if (sm->static_mapping_only && !(sm->static_mapping_connection_tracking))
2566 vlib_cli_output (vm, "%d static mappings",
2567 pool_elts (sm->static_mappings));
2571 pool_foreach (m, sm->static_mappings,
2573 vlib_cli_output (vm, "%U", format_snat_static_mapping, m);
2579 vec_foreach (tsm, sm->per_thread_data)
2581 users_num += pool_elts (tsm->users);
2582 sessions_num += pool_elts (tsm->sessions);
2585 vlib_cli_output (vm, "%d users, %d outside addresses, %d active sessions,"
2586 " %d static mappings",
2588 vec_len (sm->addresses),
2590 pool_elts (sm->static_mappings));
2594 vlib_cli_output (vm, "%U", format_bihash_16_8, &sm->in2out_ed,
2596 vlib_cli_output (vm, "%U", format_bihash_16_8, &sm->out2in_ed,
2598 vec_foreach_index (j, sm->per_thread_data)
2600 tsm = vec_elt_at_index (sm->per_thread_data, j);
2602 if (pool_elts (tsm->users) == 0)
2605 vlib_worker_thread_t *w = vlib_worker_threads + j;
2606 vlib_cli_output (vm, "Thread %d (%s at lcore %u):", j, w->name,
2608 vlib_cli_output (vm, " %U", format_bihash_8_8, &tsm->in2out,
2610 vlib_cli_output (vm, " %U", format_bihash_8_8, &tsm->out2in,
2612 vlib_cli_output (vm, " %d list pool elements",
2613 pool_elts (tsm->list_pool));
2615 pool_foreach (u, tsm->users,
2617 vlib_cli_output (vm, " %U", format_snat_user, tsm, u,
2622 if (pool_elts (sm->static_mappings))
2624 vlib_cli_output (vm, "static mappings:");
2625 pool_foreach (m, sm->static_mappings,
2627 vlib_cli_output (vm, "%U", format_snat_static_mapping, m);
2629 for (j = 0; j < vec_len (sm->to_resolve); j++)
2631 rp = sm->to_resolve + j;
2632 vlib_cli_output (vm, "%U",
2633 format_snat_static_map_to_resolve, rp);
2642 VLIB_CLI_COMMAND (show_snat_command, static) = {
2643 .path = "show nat44",
2644 .short_help = "show nat44",
2645 .function = show_snat_command_fn,
2650 snat_ip4_add_del_interface_address_cb (ip4_main_t * im,
2653 ip4_address_t * address,
2655 u32 if_address_index,
2658 snat_main_t *sm = &snat_main;
2659 snat_static_map_resolve_t *rp;
2660 u32 *indices_to_delete = 0;
2664 for (i = 0; i < vec_len(sm->auto_add_sw_if_indices); i++)
2666 if (sw_if_index == sm->auto_add_sw_if_indices[i])
2670 /* Don't trip over lease renewal, static config */
2671 for (j = 0; j < vec_len(sm->addresses); j++)
2672 if (sm->addresses[j].addr.as_u32 == address->as_u32)
2675 snat_add_address (sm, address, ~0);
2676 /* Scan static map resolution vector */
2677 for (j = 0; j < vec_len (sm->to_resolve); j++)
2679 rp = sm->to_resolve + j;
2680 /* On this interface? */
2681 if (rp->sw_if_index == sw_if_index)
2683 /* Add the static mapping */
2684 rv = snat_add_static_mapping (rp->l_addr,
2690 ~0 /* sw_if_index */,
2694 clib_warning ("snat_add_static_mapping returned %d",
2696 vec_add1 (indices_to_delete, j);
2699 /* If we resolved any of the outstanding static mappings */
2700 if (vec_len(indices_to_delete))
2703 for (j = vec_len(indices_to_delete)-1; j >= 0; j--)
2704 vec_delete(sm->to_resolve, 1, j);
2705 vec_free(indices_to_delete);
2711 (void) snat_del_address(sm, address[0], 1);
2719 int snat_add_interface_address (snat_main_t *sm, u32 sw_if_index, int is_del)
2721 ip4_main_t * ip4_main = sm->ip4_main;
2722 ip4_address_t * first_int_addr;
2723 snat_static_map_resolve_t *rp;
2724 u32 *indices_to_delete = 0;
2727 first_int_addr = ip4_interface_first_address (ip4_main, sw_if_index,
2728 0 /* just want the address*/);
2730 for (i = 0; i < vec_len(sm->auto_add_sw_if_indices); i++)
2732 if (sm->auto_add_sw_if_indices[i] == sw_if_index)
2736 /* if have address remove it */
2738 (void) snat_del_address (sm, first_int_addr[0], 1);
2741 for (j = 0; j < vec_len (sm->to_resolve); j++)
2743 rp = sm->to_resolve + j;
2744 if (rp->sw_if_index == sw_if_index)
2745 vec_add1 (indices_to_delete, j);
2747 if (vec_len(indices_to_delete))
2749 for (j = vec_len(indices_to_delete)-1; j >= 0; j--)
2750 vec_del1(sm->to_resolve, j);
2751 vec_free(indices_to_delete);
2754 vec_del1(sm->auto_add_sw_if_indices, i);
2757 return VNET_API_ERROR_VALUE_EXIST;
2764 return VNET_API_ERROR_NO_SUCH_ENTRY;
2766 /* add to the auto-address list */
2767 vec_add1(sm->auto_add_sw_if_indices, sw_if_index);
2769 /* If the address is already bound - or static - add it now */
2771 snat_add_address (sm, first_int_addr, ~0);
2776 static clib_error_t *
2777 snat_add_interface_address_command_fn (vlib_main_t * vm,
2778 unformat_input_t * input,
2779 vlib_cli_command_t * cmd)
2781 snat_main_t *sm = &snat_main;
2782 unformat_input_t _line_input, *line_input = &_line_input;
2786 clib_error_t *error = 0;
2788 /* Get a line of input. */
2789 if (!unformat_user (input, unformat_line_input, line_input))
2792 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2794 if (unformat (line_input, "%U", unformat_vnet_sw_interface,
2795 sm->vnet_main, &sw_if_index))
2797 else if (unformat (line_input, "del"))
2801 error = clib_error_return (0, "unknown input '%U'",
2802 format_unformat_error, line_input);
2807 rv = snat_add_interface_address (sm, sw_if_index, is_del);
2815 error = clib_error_return (0, "snat_add_interface_address returned %d",
2821 unformat_free (line_input);
2826 VLIB_CLI_COMMAND (snat_add_interface_address_command, static) = {
2827 .path = "nat44 add interface address",
2828 .short_help = "nat44 add interface address <interface> [del]",
2829 .function = snat_add_interface_address_command_fn,
2832 static clib_error_t *
2833 snat_det_map_command_fn (vlib_main_t * vm,
2834 unformat_input_t * input,
2835 vlib_cli_command_t * cmd)
2837 snat_main_t *sm = &snat_main;
2838 unformat_input_t _line_input, *line_input = &_line_input;
2839 ip4_address_t in_addr, out_addr;
2840 u32 in_plen, out_plen;
2842 clib_error_t *error = 0;
2844 /* Get a line of input. */
2845 if (!unformat_user (input, unformat_line_input, line_input))
2848 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2850 if (unformat (line_input, "in %U/%u", unformat_ip4_address, &in_addr, &in_plen))
2852 else if (unformat (line_input, "out %U/%u", unformat_ip4_address, &out_addr, &out_plen))
2854 else if (unformat (line_input, "del"))
2858 error = clib_error_return (0, "unknown input '%U'",
2859 format_unformat_error, line_input);
2864 unformat_free (line_input);
2866 rv = snat_det_add_map(sm, &in_addr, (u8) in_plen, &out_addr, (u8)out_plen,
2871 error = clib_error_return (0, "snat_det_add_map return %d", rv);
2876 unformat_free (line_input);
2883 * @cliexstart{snat deterministic add}
2884 * Create bijective mapping of inside address to outside address and port range
2885 * pairs, with the purpose of enabling deterministic NAT to reduce logging in
2887 * To create deterministic mapping between inside network 10.0.0.0/18 and
2888 * outside network 1.1.1.0/30 use:
2889 * # vpp# nat44 deterministic add in 10.0.0.0/18 out 1.1.1.0/30
2892 VLIB_CLI_COMMAND (snat_det_map_command, static) = {
2893 .path = "nat44 deterministic add",
2894 .short_help = "nat44 deterministic add in <addr>/<plen> out <addr>/<plen> [del]",
2895 .function = snat_det_map_command_fn,
2898 static clib_error_t *
2899 snat_det_forward_command_fn (vlib_main_t * vm,
2900 unformat_input_t * input,
2901 vlib_cli_command_t * cmd)
2903 snat_main_t *sm = &snat_main;
2904 unformat_input_t _line_input, *line_input = &_line_input;
2905 ip4_address_t in_addr, out_addr;
2907 snat_det_map_t * dm;
2908 clib_error_t *error = 0;
2910 /* Get a line of input. */
2911 if (!unformat_user (input, unformat_line_input, line_input))
2914 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2916 if (unformat (line_input, "%U", unformat_ip4_address, &in_addr))
2920 error = clib_error_return (0, "unknown input '%U'",
2921 format_unformat_error, line_input);
2926 unformat_free (line_input);
2928 dm = snat_det_map_by_user(sm, &in_addr);
2930 vlib_cli_output (vm, "no match");
2933 snat_det_forward (dm, &in_addr, &out_addr, &lo_port);
2934 vlib_cli_output (vm, "%U:<%d-%d>", format_ip4_address, &out_addr,
2935 lo_port, lo_port + dm->ports_per_host - 1);
2939 unformat_free (line_input);
2946 * @cliexstart{snat deterministic forward}
2947 * Return outside address and port range from inside address for deterministic
2949 * To obtain outside address and port of inside host use:
2950 * vpp# nat44 deterministic forward 10.0.0.2
2951 * 1.1.1.0:<1054-1068>
2954 VLIB_CLI_COMMAND (snat_det_forward_command, static) = {
2955 .path = "nat44 deterministic forward",
2956 .short_help = "nat44 deterministic forward <addr>",
2957 .function = snat_det_forward_command_fn,
2960 static clib_error_t *
2961 snat_det_reverse_command_fn (vlib_main_t * vm,
2962 unformat_input_t * input,
2963 vlib_cli_command_t * cmd)
2965 snat_main_t *sm = &snat_main;
2966 unformat_input_t _line_input, *line_input = &_line_input;
2967 ip4_address_t in_addr, out_addr;
2969 snat_det_map_t * dm;
2970 clib_error_t *error = 0;
2972 /* Get a line of input. */
2973 if (!unformat_user (input, unformat_line_input, line_input))
2976 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2978 if (unformat (line_input, "%U:%d", unformat_ip4_address, &out_addr, &out_port))
2982 error = clib_error_return (0, "unknown input '%U'",
2983 format_unformat_error, line_input);
2987 unformat_free (line_input);
2989 if (out_port < 1024 || out_port > 65535)
2991 error = clib_error_return (0, "wrong port, must be <1024-65535>");
2995 dm = snat_det_map_by_out(sm, &out_addr);
2997 vlib_cli_output (vm, "no match");
3000 snat_det_reverse (dm, &out_addr, (u16) out_port, &in_addr);
3001 vlib_cli_output (vm, "%U", format_ip4_address, &in_addr);
3005 unformat_free (line_input);
3012 * @cliexstart{snat deterministic reverse}
3013 * Return inside address from outside address and port for deterministic NAT.
3014 * To obtain inside host address from outside address and port use:
3015 * #vpp nat44 deterministic reverse 1.1.1.1:1276
3019 VLIB_CLI_COMMAND (snat_det_reverse_command, static) = {
3020 .path = "nat44 deterministic reverse",
3021 .short_help = "nat44 deterministic reverse <addr>:<port>",
3022 .function = snat_det_reverse_command_fn,
3025 static clib_error_t *
3026 set_timeout_command_fn (vlib_main_t * vm,
3027 unformat_input_t * input,
3028 vlib_cli_command_t * cmd)
3030 snat_main_t *sm = &snat_main;
3031 unformat_input_t _line_input, *line_input = &_line_input;
3032 clib_error_t *error = 0;
3034 /* Get a line of input. */
3035 if (!unformat_user (input, unformat_line_input, line_input))
3038 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
3040 if (unformat (line_input, "udp %u", &sm->udp_timeout))
3042 else if (unformat (line_input, "tcp-established %u",
3043 &sm->tcp_established_timeout))
3045 else if (unformat (line_input, "tcp-transitory %u",
3046 &sm->tcp_transitory_timeout))
3048 else if (unformat (line_input, "icmp %u", &sm->icmp_timeout))
3050 else if (unformat (line_input, "reset"))
3052 sm->udp_timeout = SNAT_UDP_TIMEOUT;
3053 sm->tcp_established_timeout = SNAT_TCP_ESTABLISHED_TIMEOUT;
3054 sm->tcp_transitory_timeout = SNAT_TCP_TRANSITORY_TIMEOUT;
3055 sm->icmp_timeout = SNAT_ICMP_TIMEOUT;
3059 error = clib_error_return (0, "unknown input '%U'",
3060 format_unformat_error, line_input);
3065 unformat_free (line_input);
3068 unformat_free (line_input);
3075 * @cliexstart{set snat deterministic timeout}
3076 * Set values of timeouts for deterministic NAT (in seconds), use:
3077 * vpp# set nat44 deterministic timeout udp 120 tcp-established 7500
3078 * tcp-transitory 250 icmp 90
3079 * To reset default values use:
3080 * vpp# set nat44 deterministic timeout reset
3083 VLIB_CLI_COMMAND (set_timeout_command, static) = {
3084 .path = "set nat44 deterministic timeout",
3085 .function = set_timeout_command_fn,
3087 "set nat44 deterministic timeout [udp <sec> | tcp-established <sec> "
3088 "tcp-transitory <sec> | icmp <sec> | reset]",
3091 static clib_error_t *
3092 snat_det_close_session_out_fn (vlib_main_t *vm,
3093 unformat_input_t * input,
3094 vlib_cli_command_t * cmd)
3096 snat_main_t *sm = &snat_main;
3097 unformat_input_t _line_input, *line_input = &_line_input;
3098 ip4_address_t out_addr, ext_addr, in_addr;
3099 u32 out_port, ext_port;
3100 snat_det_map_t * dm;
3101 snat_det_session_t * ses;
3102 snat_det_out_key_t key;
3103 clib_error_t *error = 0;
3105 /* Get a line of input. */
3106 if (!unformat_user (input, unformat_line_input, line_input))
3109 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
3111 if (unformat (line_input, "%U:%d %U:%d",
3112 unformat_ip4_address, &out_addr, &out_port,
3113 unformat_ip4_address, &ext_addr, &ext_port))
3117 error = clib_error_return (0, "unknown input '%U'",
3118 format_unformat_error, line_input);
3123 unformat_free (line_input);
3125 dm = snat_det_map_by_out(sm, &out_addr);
3127 vlib_cli_output (vm, "no match");
3130 snat_det_reverse(dm, &ext_addr, (u16)out_port, &in_addr);
3131 key.ext_host_addr = out_addr;
3132 key.ext_host_port = ntohs((u16)ext_port);
3133 key.out_port = ntohs((u16)out_port);
3134 ses = snat_det_get_ses_by_out(dm, &out_addr, key.as_u64);
3136 vlib_cli_output (vm, "no match");
3138 snat_det_ses_close(dm, ses);
3142 unformat_free (line_input);
3149 * @cliexstart{snat deterministic close session out}
3150 * Close session using outside ip address and port
3151 * and external ip address and port, use:
3152 * vpp# nat44 deterministic close session out 1.1.1.1:1276 2.2.2.2:2387
3155 VLIB_CLI_COMMAND (snat_det_close_sesion_out_command, static) = {
3156 .path = "nat44 deterministic close session out",
3157 .short_help = "nat44 deterministic close session out "
3158 "<out_addr>:<out_port> <ext_addr>:<ext_port>",
3159 .function = snat_det_close_session_out_fn,
3162 static clib_error_t *
3163 snat_det_close_session_in_fn (vlib_main_t *vm,
3164 unformat_input_t * input,
3165 vlib_cli_command_t * cmd)
3167 snat_main_t *sm = &snat_main;
3168 unformat_input_t _line_input, *line_input = &_line_input;
3169 ip4_address_t in_addr, ext_addr;
3170 u32 in_port, ext_port;
3171 snat_det_map_t * dm;
3172 snat_det_session_t * ses;
3173 snat_det_out_key_t key;
3174 clib_error_t *error = 0;
3176 /* Get a line of input. */
3177 if (!unformat_user (input, unformat_line_input, line_input))
3180 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
3182 if (unformat (line_input, "%U:%d %U:%d",
3183 unformat_ip4_address, &in_addr, &in_port,
3184 unformat_ip4_address, &ext_addr, &ext_port))
3188 error = clib_error_return (0, "unknown input '%U'",
3189 format_unformat_error, line_input);
3194 unformat_free (line_input);
3196 dm = snat_det_map_by_user (sm, &in_addr);
3198 vlib_cli_output (vm, "no match");
3201 key.ext_host_addr = ext_addr;
3202 key.ext_host_port = ntohs ((u16)ext_port);
3203 ses = snat_det_find_ses_by_in (dm, &in_addr, ntohs((u16)in_port), key);
3205 vlib_cli_output (vm, "no match");
3207 snat_det_ses_close(dm, ses);
3211 unformat_free(line_input);
3218 * @cliexstart{snat deterministic close_session_in}
3219 * Close session using inside ip address and port
3220 * and external ip address and port, use:
3221 * vpp# nat44 deterministic close session in 3.3.3.3:3487 2.2.2.2:2387
3224 VLIB_CLI_COMMAND (snat_det_close_session_in_command, static) = {
3225 .path = "nat44 deterministic close session in",
3226 .short_help = "nat44 deterministic close session in "
3227 "<in_addr>:<in_port> <ext_addr>:<ext_port>",
3228 .function = snat_det_close_session_in_fn,