2 * Copyright (c) 2020 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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
16 #include <vnet/fib/fib_table.h>
18 #include <nat/lib/log.h>
19 #include <nat/lib/nat_inlines.h>
20 #include <nat/lib/ipfix_logging.h>
22 #include <nat/nat44-ei/nat44_ei.h>
23 #include <nat/nat44-ei/nat44_ei_ha.h>
25 #define NAT44_EI_EXPECTED_ARGUMENT "expected required argument(s)"
28 format_nat44_ei_session (u8 *s, va_list *args)
30 nat44_ei_main_per_thread_data_t *tnm =
31 va_arg (*args, nat44_ei_main_per_thread_data_t *);
32 nat44_ei_session_t *sess = va_arg (*args, nat44_ei_session_t *);
34 if (nat44_ei_is_unk_proto_session (sess))
37 format (s, " i2o %U proto %u fib %u\n", format_ip4_address,
38 &sess->in2out.addr, sess->in2out.port, sess->in2out.fib_index);
40 format (s, " o2i %U proto %u fib %u\n", format_ip4_address,
41 &sess->out2in.addr, sess->out2in.port, sess->out2in.fib_index);
45 s = format (s, " i2o %U proto %U port %d fib %d\n", format_ip4_address,
46 &sess->in2out.addr, format_nat_protocol, sess->nat_proto,
47 clib_net_to_host_u16 (sess->in2out.port),
48 sess->in2out.fib_index);
49 s = format (s, " o2i %U proto %U port %d fib %d\n", format_ip4_address,
50 &sess->out2in.addr, format_nat_protocol, sess->nat_proto,
51 clib_net_to_host_u16 (sess->out2in.port),
52 sess->out2in.fib_index);
55 s = format (s, " index %llu\n", sess - tnm->sessions);
56 s = format (s, " last heard %.2f\n", sess->last_heard);
57 s = format (s, " total pkts %d, total bytes %lld\n", sess->total_pkts,
59 if (nat44_ei_is_session_static (sess))
60 s = format (s, " static translation\n");
62 s = format (s, " dynamic translation\n");
68 format_nat44_ei_user (u8 *s, va_list *args)
70 nat44_ei_main_per_thread_data_t *tnm =
71 va_arg (*args, nat44_ei_main_per_thread_data_t *);
72 nat44_ei_user_t *u = va_arg (*args, nat44_ei_user_t *);
73 int verbose = va_arg (*args, int);
74 dlist_elt_t *head, *elt;
75 u32 elt_index, head_index;
77 nat44_ei_session_t *sess;
79 s = format (s, "%U: %d dynamic translations, %d static translations\n",
80 format_ip4_address, &u->addr, u->nsessions, u->nstaticsessions);
85 if (u->nsessions || u->nstaticsessions)
87 head_index = u->sessions_per_user_list_head_index;
88 head = pool_elt_at_index (tnm->list_pool, head_index);
90 elt_index = head->next;
91 elt = pool_elt_at_index (tnm->list_pool, elt_index);
92 session_index = elt->value;
94 while (session_index != ~0)
96 sess = pool_elt_at_index (tnm->sessions, session_index);
98 s = format (s, " %U\n", format_nat44_ei_session, tnm, sess);
100 elt_index = elt->next;
101 elt = pool_elt_at_index (tnm->list_pool, elt_index);
102 session_index = elt->value;
110 format_nat44_ei_static_mapping (u8 *s, va_list *args)
112 nat44_ei_static_mapping_t *m = va_arg (*args, nat44_ei_static_mapping_t *);
113 nat44_ei_lb_addr_port_t *local;
115 if (is_sm_identity_nat (m->flags))
117 if (is_sm_addr_only (m->flags))
118 s = format (s, "identity mapping %U", format_ip4_address,
121 s = format (s, "identity mapping %U %U:%d", format_nat_protocol,
122 m->proto, format_ip4_address, &m->local_addr,
123 clib_net_to_host_u16 (m->local_port));
125 pool_foreach (local, m->locals)
127 s = format (s, " vrf %d", local->vrf_id);
133 if (is_sm_addr_only (m->flags))
135 s = format (s, "local %U external %U vrf %d", format_ip4_address,
136 &m->local_addr, format_ip4_address, &m->external_addr,
141 s = format (s, "%U local %U:%d external %U:%d vrf %d",
142 format_nat_protocol, m->proto, format_ip4_address,
143 &m->local_addr, clib_net_to_host_u16 (m->local_port),
144 format_ip4_address, &m->external_addr,
145 clib_net_to_host_u16 (m->external_port), m->vrf_id);
151 format_nat44_ei_static_map_to_resolve (u8 *s, va_list *args)
153 nat44_ei_static_map_resolve_t *m =
154 va_arg (*args, nat44_ei_static_map_resolve_t *);
155 vnet_main_t *vnm = vnet_get_main ();
157 if (is_sm_addr_only (m->flags))
159 format (s, "local %U external %U vrf %d", format_ip4_address, &m->l_addr,
160 format_vnet_sw_if_index_name, vnm, m->sw_if_index, m->vrf_id);
162 s = format (s, "%U local %U:%d external %U:%d vrf %d", format_nat_protocol,
163 m->proto, format_ip4_address, &m->l_addr,
164 clib_net_to_host_u16 (m->l_port), format_vnet_sw_if_index_name,
165 vnm, m->sw_if_index, clib_net_to_host_u16 (m->e_port),
171 static clib_error_t *
172 nat44_ei_enable_disable_command_fn (vlib_main_t *vm, unformat_input_t *input,
173 vlib_cli_command_t *cmd)
175 nat44_ei_main_t *nm = &nat44_ei_main;
176 unformat_input_t _line_input, *line_input = &_line_input;
177 clib_error_t *error = 0;
179 nat44_ei_config_t c = { 0 };
180 u8 enable_set = 0, enable = 0, mode_set = 0;
182 if (!unformat_user (input, unformat_line_input, line_input))
183 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
185 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
187 if (!mode_set && unformat (line_input, "static-mapping-only"))
190 c.static_mapping_only = 1;
191 if (unformat (line_input, "connection-tracking"))
193 c.connection_tracking = 1;
196 else if (!mode_set && unformat (line_input, "out2in-dpo"))
201 else if (unformat (line_input, "inside-vrf %u", &c.inside_vrf))
203 else if (unformat (line_input, "outside-vrf %u", &c.outside_vrf))
205 else if (unformat (line_input, "users %u", &c.users))
207 else if (unformat (line_input, "sessions %u", &c.sessions))
209 else if (unformat (line_input, "user-sessions %u", &c.user_sessions))
211 else if (!enable_set)
214 if (unformat (line_input, "disable"))
216 else if (unformat (line_input, "enable"))
221 error = clib_error_return (0, "unknown input '%U'",
222 format_unformat_error, line_input);
229 error = clib_error_return (0, "expected enable | disable");
237 error = clib_error_return (0, "already enabled");
241 if (nat44_ei_plugin_enable (c) != 0)
242 error = clib_error_return (0, "enable failed");
248 error = clib_error_return (0, "already disabled");
252 if (nat44_ei_plugin_disable () != 0)
253 error = clib_error_return (0, "disable failed");
257 unformat_free (line_input);
261 static clib_error_t *
262 set_workers_command_fn (vlib_main_t *vm, unformat_input_t *input,
263 vlib_cli_command_t *cmd)
265 unformat_input_t _line_input, *line_input = &_line_input;
268 clib_error_t *error = 0;
270 if (!unformat_user (input, unformat_line_input, line_input))
271 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
273 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
275 if (unformat (line_input, "%U", unformat_bitmap_list, &bitmap))
279 error = clib_error_return (0, "unknown input '%U'",
280 format_unformat_error, line_input);
287 error = clib_error_return (0, "List of workers must be specified.");
291 rv = nat44_ei_set_workers (bitmap);
293 clib_bitmap_free (bitmap);
297 case VNET_API_ERROR_INVALID_WORKER:
298 error = clib_error_return (0, "Invalid worker(s).");
300 case VNET_API_ERROR_FEATURE_DISABLED:
302 clib_error_return (0, "Supported only if 2 or more workes available.");
309 unformat_free (line_input);
314 static clib_error_t *
315 nat_show_workers_command_fn (vlib_main_t *vm, unformat_input_t *input,
316 vlib_cli_command_t *cmd)
318 nat44_ei_main_t *nm = &nat44_ei_main;
321 if (nm->num_workers > 1)
323 vlib_cli_output (vm, "%d workers", vec_len (nm->workers));
324 vec_foreach (worker, nm->workers)
326 vlib_worker_thread_t *w =
327 vlib_worker_threads + *worker + nm->first_worker_index;
328 vlib_cli_output (vm, " %s", w->name);
335 static clib_error_t *
336 nat44_ei_set_log_level_command_fn (vlib_main_t *vm, unformat_input_t *input,
337 vlib_cli_command_t *cmd)
339 unformat_input_t _line_input, *line_input = &_line_input;
340 nat44_ei_main_t *nm = &nat44_ei_main;
341 u8 log_level = NAT_LOG_NONE;
342 clib_error_t *error = 0;
344 if (!unformat_user (input, unformat_line_input, line_input))
345 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
347 if (!unformat (line_input, "%d", &log_level))
349 error = clib_error_return (0, "unknown input '%U'",
350 format_unformat_error, line_input);
353 if (log_level > NAT_LOG_DEBUG)
355 error = clib_error_return (0, "unknown logging level '%d'", log_level);
358 nm->log_level = log_level;
361 unformat_free (line_input);
366 static clib_error_t *
367 nat44_ei_ipfix_logging_enable_disable_command_fn (vlib_main_t *vm,
368 unformat_input_t *input,
369 vlib_cli_command_t *cmd)
371 unformat_input_t _line_input, *line_input = &_line_input;
372 clib_error_t *error = 0;
374 u32 domain_id = 0, src_port = 0;
375 u8 enable_set = 0, enable = 0;
377 if (!unformat_user (input, unformat_line_input, line_input))
378 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
380 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
382 if (unformat (line_input, "domain %d", &domain_id))
384 else if (unformat (line_input, "src-port %d", &src_port))
386 else if (unformat (line_input, "disable"))
388 else if (!enable_set)
391 if (unformat (line_input, "disable"))
393 else if (unformat (line_input, "enable"))
398 error = clib_error_return (0, "unknown input '%U'",
399 format_unformat_error, line_input);
406 error = clib_error_return (0, "expected enable | disable");
410 if (nat_ipfix_logging_enable_disable (enable, domain_id, (u16) src_port))
412 error = clib_error_return (0, "ipfix logging enable failed");
417 unformat_free (line_input);
422 static clib_error_t *
423 nat44_ei_show_hash_command_fn (vlib_main_t *vm, unformat_input_t *input,
424 vlib_cli_command_t *cmd)
426 nat44_ei_main_t *nm = &nat44_ei_main;
427 nat44_ei_main_per_thread_data_t *tnm;
431 if (unformat (input, "detail"))
433 else if (unformat (input, "verbose"))
436 vlib_cli_output (vm, "%U", format_bihash_8_8, &nm->static_mapping_by_local,
438 vlib_cli_output (vm, "%U", format_bihash_8_8,
439 &nm->static_mapping_by_external, verbose);
440 vec_foreach_index (i, nm->per_thread_data)
442 tnm = vec_elt_at_index (nm->per_thread_data, i);
443 vlib_cli_output (vm, "-------- thread %d %s --------\n", i,
444 vlib_worker_threads[i].name);
446 vlib_cli_output (vm, "%U", format_bihash_8_8, &nm->in2out, verbose);
447 vlib_cli_output (vm, "%U", format_bihash_8_8, &nm->out2in, verbose);
448 vlib_cli_output (vm, "%U", format_bihash_8_8, &tnm->user_hash, verbose);
451 vlib_cli_output (vm, "-------- hash table parameters --------\n");
452 vlib_cli_output (vm, "translation buckets: %u", nm->translation_buckets);
453 vlib_cli_output (vm, "user buckets: %u", nm->user_buckets);
457 static clib_error_t *
458 nat44_ei_set_alloc_addr_and_port_alg_command_fn (vlib_main_t *vm,
459 unformat_input_t *input,
460 vlib_cli_command_t *cmd)
462 unformat_input_t _line_input, *line_input = &_line_input;
463 clib_error_t *error = 0;
464 u32 psid, psid_offset, psid_length, port_start, port_end;
466 if (!unformat_user (input, unformat_line_input, line_input))
467 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
469 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
471 if (unformat (line_input, "default"))
472 nat44_ei_set_alloc_default ();
473 else if (unformat (line_input,
474 "map-e psid %d psid-offset %d psid-len %d", &psid,
475 &psid_offset, &psid_length))
476 nat44_ei_set_alloc_mape ((u16) psid, (u16) psid_offset,
478 else if (unformat (line_input, "port-range %d - %d", &port_start,
481 if (port_end <= port_start)
483 error = clib_error_return (
484 0, "The end-port must be greater than start-port");
487 nat44_ei_set_alloc_range ((u16) port_start, (u16) port_end);
491 error = clib_error_return (0, "unknown input '%U'",
492 format_unformat_error, line_input);
498 unformat_free (line_input);
504 format_nat44_ei_addr_and_port_alloc_alg (u8 *s, va_list *args)
506 u32 i = va_arg (*args, u32);
512 case NAT44_EI_ADDR_AND_PORT_ALLOC_ALG_##N: \
515 foreach_nat44_ei_addr_and_port_alloc_alg
517 default : s = format (s, "unknown");
520 s = format (s, "%s", t);
524 static clib_error_t *
525 nat44_ei_show_alloc_addr_and_port_alg_command_fn (vlib_main_t *vm,
526 unformat_input_t *input,
527 vlib_cli_command_t *cmd)
529 nat44_ei_main_t *nm = &nat44_ei_main;
531 vlib_cli_output (vm, "NAT address and port: %U",
532 format_nat44_ei_addr_and_port_alloc_alg,
533 nm->addr_and_port_alloc_alg);
534 switch (nm->addr_and_port_alloc_alg)
536 case NAT44_EI_ADDR_AND_PORT_ALLOC_ALG_MAPE:
537 vlib_cli_output (vm, " psid %d psid-offset %d psid-len %d", nm->psid,
538 nm->psid_offset, nm->psid_length);
540 case NAT44_EI_ADDR_AND_PORT_ALLOC_ALG_RANGE:
541 vlib_cli_output (vm, " start-port %d end-port %d", nm->start_port,
551 static clib_error_t *
552 nat_set_mss_clamping_command_fn (vlib_main_t *vm, unformat_input_t *input,
553 vlib_cli_command_t *cmd)
555 unformat_input_t _line_input, *line_input = &_line_input;
556 nat44_ei_main_t *nm = &nat44_ei_main;
557 clib_error_t *error = 0;
560 if (!unformat_user (input, unformat_line_input, line_input))
561 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
563 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
565 if (unformat (line_input, "disable"))
566 nm->mss_clamping = 0;
567 else if (unformat (line_input, "%d", &mss))
568 nm->mss_clamping = (u16) mss;
571 error = clib_error_return (0, "unknown input '%U'",
572 format_unformat_error, line_input);
578 unformat_free (line_input);
583 static clib_error_t *
584 nat_show_mss_clamping_command_fn (vlib_main_t *vm, unformat_input_t *input,
585 vlib_cli_command_t *cmd)
587 nat44_ei_main_t *nm = &nat44_ei_main;
589 if (nm->mss_clamping)
590 vlib_cli_output (vm, "mss-clamping %d", nm->mss_clamping);
592 vlib_cli_output (vm, "mss-clamping disabled");
597 static clib_error_t *
598 nat_ha_failover_command_fn (vlib_main_t *vm, unformat_input_t *input,
599 vlib_cli_command_t *cmd)
601 unformat_input_t _line_input, *line_input = &_line_input;
603 u32 port, session_refresh_interval = 10;
605 clib_error_t *error = 0;
607 if (!unformat_user (input, unformat_line_input, line_input))
608 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
610 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
612 if (unformat (line_input, "%U:%u", unformat_ip4_address, &addr, &port))
614 else if (unformat (line_input, "refresh-interval %u",
615 &session_refresh_interval))
619 error = clib_error_return (0, "unknown input '%U'",
620 format_unformat_error, line_input);
625 rv = nat_ha_set_failover (vm, &addr, (u16) port, session_refresh_interval);
627 error = clib_error_return (0, "set HA failover failed");
630 unformat_free (line_input);
635 static clib_error_t *
636 nat_ha_listener_command_fn (vlib_main_t *vm, unformat_input_t *input,
637 vlib_cli_command_t *cmd)
639 unformat_input_t _line_input, *line_input = &_line_input;
641 u32 port, path_mtu = 512;
643 clib_error_t *error = 0;
645 if (!unformat_user (input, unformat_line_input, line_input))
646 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
648 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
650 if (unformat (line_input, "%U:%u", unformat_ip4_address, &addr, &port))
652 else if (unformat (line_input, "path-mtu %u", &path_mtu))
656 error = clib_error_return (0, "unknown input '%U'",
657 format_unformat_error, line_input);
662 rv = nat_ha_set_listener (vm, &addr, (u16) port, path_mtu);
664 error = clib_error_return (0, "set HA listener failed");
667 unformat_free (line_input);
672 static clib_error_t *
673 nat_show_ha_command_fn (vlib_main_t *vm, unformat_input_t *input,
674 vlib_cli_command_t *cmd)
678 u32 path_mtu, session_refresh_interval, resync_ack_missed;
681 nat_ha_get_listener (&addr, &port, &path_mtu);
684 vlib_cli_output (vm, "NAT HA disabled\n");
688 vlib_cli_output (vm, "LISTENER:\n");
689 vlib_cli_output (vm, " %U:%u path-mtu %u\n", format_ip4_address, &addr,
692 nat_ha_get_failover (&addr, &port, &session_refresh_interval);
693 vlib_cli_output (vm, "FAILOVER:\n");
695 vlib_cli_output (vm, " %U:%u refresh-interval %usec\n",
696 format_ip4_address, &addr, port,
697 session_refresh_interval);
699 vlib_cli_output (vm, " NA\n");
701 nat_ha_get_resync_status (&in_resync, &resync_ack_missed);
702 vlib_cli_output (vm, "RESYNC:\n");
704 vlib_cli_output (vm, " in progress\n");
706 vlib_cli_output (vm, " completed (%d ACK missed)\n", resync_ack_missed);
711 static clib_error_t *
712 nat_ha_flush_command_fn (vlib_main_t *vm, unformat_input_t *input,
713 vlib_cli_command_t *cmd)
719 static clib_error_t *
720 nat_ha_resync_command_fn (vlib_main_t *vm, unformat_input_t *input,
721 vlib_cli_command_t *cmd)
723 clib_error_t *error = 0;
725 if (nat_ha_resync (0, 0, 0))
726 error = clib_error_return (0, "NAT HA resync already running");
731 static clib_error_t *
732 add_address_command_fn (vlib_main_t *vm, unformat_input_t *input,
733 vlib_cli_command_t *cmd)
735 unformat_input_t _line_input, *line_input = &_line_input;
736 nat44_ei_main_t *nm = &nat44_ei_main;
737 ip4_address_t start_addr, end_addr, this_addr;
738 u32 start_host_order, end_host_order;
743 clib_error_t *error = 0;
745 if (!unformat_user (input, unformat_line_input, line_input))
746 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
748 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
750 if (unformat (line_input, "%U - %U", unformat_ip4_address, &start_addr,
751 unformat_ip4_address, &end_addr))
753 else if (unformat (line_input, "tenant-vrf %u", &vrf_id))
755 else if (unformat (line_input, "%U", unformat_ip4_address, &start_addr))
756 end_addr = start_addr;
757 else if (unformat (line_input, "del"))
761 error = clib_error_return (0, "unknown input '%U'",
762 format_unformat_error, line_input);
767 if (nm->static_mapping_only)
769 error = clib_error_return (0, "static mapping only mode");
773 start_host_order = clib_host_to_net_u32 (start_addr.as_u32);
774 end_host_order = clib_host_to_net_u32 (end_addr.as_u32);
776 if (end_host_order < start_host_order)
778 error = clib_error_return (0, "end address less than start address");
782 count = (end_host_order - start_host_order) + 1;
785 nat44_ei_log_info ("%U - %U, %d addresses...", format_ip4_address,
786 &start_addr, format_ip4_address, &end_addr, count);
788 this_addr = start_addr;
790 for (i = 0; i < count; i++)
793 rv = nat44_ei_add_address (&this_addr, vrf_id);
795 rv = nat44_ei_del_address (this_addr, 0);
799 case VNET_API_ERROR_VALUE_EXIST:
800 error = clib_error_return (0, "NAT address already in use.");
802 case VNET_API_ERROR_NO_SUCH_ENTRY:
803 error = clib_error_return (0, "NAT address not exist.");
805 case VNET_API_ERROR_UNSPECIFIED:
806 error = clib_error_return (0, "NAT address used in static mapping.");
808 case VNET_API_ERROR_FEATURE_DISABLED:
815 nat44_ei_add_del_address_dpo (this_addr, is_add);
817 increment_v4_address (&this_addr);
821 unformat_free (line_input);
826 static clib_error_t *
827 nat44_ei_show_addresses_command_fn (vlib_main_t *vm, unformat_input_t *input,
828 vlib_cli_command_t *cmd)
830 nat44_ei_main_t *nm = &nat44_ei_main;
831 nat44_ei_address_t *ap;
833 vlib_cli_output (vm, "NAT44 pool addresses:");
834 vec_foreach (ap, nm->addresses)
836 vlib_cli_output (vm, "%U", format_ip4_address, &ap->addr);
837 if (ap->fib_index != ~0)
839 vm, " tenant VRF: %u",
840 fib_table_get (ap->fib_index, FIB_PROTOCOL_IP4)->ft_table_id);
842 vlib_cli_output (vm, " tenant VRF independent");
843 #define _(N, i, n, s) \
844 vlib_cli_output (vm, " %d busy %s ports", ap->busy_##n##_ports, s);
851 static clib_error_t *
852 nat44_ei_feature_command_fn (vlib_main_t *vm, unformat_input_t *input,
853 vlib_cli_command_t *cmd)
855 unformat_input_t _line_input, *line_input = &_line_input;
856 vnet_main_t *vnm = vnet_get_main ();
857 clib_error_t *error = 0;
859 u32 *inside_sw_if_indices = 0;
860 u32 *outside_sw_if_indices = 0;
861 u8 is_output_feature = 0;
867 if (!unformat_user (input, unformat_line_input, line_input))
868 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
870 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
872 if (unformat (line_input, "in %U", unformat_vnet_sw_interface, vnm,
874 vec_add1 (inside_sw_if_indices, sw_if_index);
875 else if (unformat (line_input, "out %U", unformat_vnet_sw_interface, vnm,
877 vec_add1 (outside_sw_if_indices, sw_if_index);
878 else if (unformat (line_input, "output-feature"))
879 is_output_feature = 1;
880 else if (unformat (line_input, "del"))
884 error = clib_error_return (0, "unknown input '%U'",
885 format_unformat_error, line_input);
890 if (vec_len (inside_sw_if_indices))
892 for (i = 0; i < vec_len (inside_sw_if_indices); i++)
894 sw_if_index = inside_sw_if_indices[i];
895 if (is_output_feature)
897 if (nat44_ei_add_del_output_interface (sw_if_index, is_del))
899 error = clib_error_return (
900 0, "%s %U failed", is_del ? "del" : "add",
901 format_vnet_sw_if_index_name, vnm, sw_if_index);
907 if (nat44_ei_add_del_interface (sw_if_index, 1, is_del))
909 error = clib_error_return (
910 0, "%s %U failed", is_del ? "del" : "add",
911 format_vnet_sw_if_index_name, vnm, sw_if_index);
918 if (vec_len (outside_sw_if_indices))
920 for (i = 0; i < vec_len (outside_sw_if_indices); i++)
922 sw_if_index = outside_sw_if_indices[i];
923 if (is_output_feature)
925 if (nat44_ei_add_del_output_interface (sw_if_index, is_del))
927 error = clib_error_return (
928 0, "%s %U failed", is_del ? "del" : "add",
929 format_vnet_sw_if_index_name, vnm, sw_if_index);
935 if (nat44_ei_add_del_interface (sw_if_index, 0, is_del))
937 error = clib_error_return (
938 0, "%s %U failed", is_del ? "del" : "add",
939 format_vnet_sw_if_index_name, vnm, sw_if_index);
947 unformat_free (line_input);
948 vec_free (inside_sw_if_indices);
949 vec_free (outside_sw_if_indices);
954 static clib_error_t *
955 nat44_ei_show_interfaces_command_fn (vlib_main_t *vm, unformat_input_t *input,
956 vlib_cli_command_t *cmd)
958 nat44_ei_main_t *nm = &nat44_ei_main;
959 nat44_ei_interface_t *i;
960 vnet_main_t *vnm = vnet_get_main ();
962 vlib_cli_output (vm, "NAT44 interfaces:");
963 pool_foreach (i, nm->interfaces)
965 vlib_cli_output (vm, " %U %s", format_vnet_sw_if_index_name, vnm,
967 (nat44_ei_interface_is_inside (i) &&
968 nat44_ei_interface_is_outside (i)) ?
970 (nat44_ei_interface_is_inside (i) ? "in" : "out"));
973 pool_foreach (i, nm->output_feature_interfaces)
975 vlib_cli_output (vm, " %U output-feature %s",
976 format_vnet_sw_if_index_name, vnm, i->sw_if_index,
977 (nat44_ei_interface_is_inside (i) &&
978 nat44_ei_interface_is_outside (i)) ?
980 (nat44_ei_interface_is_inside (i) ? "in" : "out"));
986 static clib_error_t *
987 add_static_mapping_command_fn (vlib_main_t *vm, unformat_input_t *input,
988 vlib_cli_command_t *cmd)
990 unformat_input_t _line_input, *line_input = &_line_input;
991 vnet_main_t *vnm = vnet_get_main ();
992 clib_error_t *error = 0;
995 nat_protocol_t proto = NAT_PROTOCOL_OTHER;
996 ip4_address_t l_addr, e_addr, pool_addr = { 0 };
997 u32 l_port = 0, e_port = 0, vrf_id = ~0;
998 u8 l_port_set = 0, e_port_set = 0;
999 u32 sw_if_index = ~0, flags = 0;
1002 if (!unformat_user (input, unformat_line_input, line_input))
1003 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1005 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1007 if (unformat (line_input, "local %U %u", unformat_ip4_address, &l_addr,
1012 else if (unformat (line_input, "local %U", unformat_ip4_address,
1015 else if (unformat (line_input, "external %U %u", unformat_ip4_address,
1020 else if (unformat (line_input, "external %U", unformat_ip4_address,
1023 else if (unformat (line_input, "external %U %u",
1024 unformat_vnet_sw_interface, vnm, &sw_if_index,
1029 else if (unformat (line_input, "external %U", unformat_vnet_sw_interface,
1032 else if (unformat (line_input, "vrf %u", &vrf_id))
1034 else if (unformat (line_input, "%U", unformat_nat_protocol, &proto))
1036 else if (unformat (line_input, "del"))
1042 error = clib_error_return (0, "unknown input: '%U'",
1043 format_unformat_error, line_input);
1048 if (l_port_set != e_port_set)
1050 error = clib_error_return (0, "Either both ports are set or none.");
1056 flags |= NAT44_EI_SM_FLAG_ADDR_ONLY;
1060 l_port = clib_host_to_net_u16 (l_port);
1061 e_port = clib_host_to_net_u16 (e_port);
1067 nat44_ei_add_static_mapping (l_addr, e_addr, l_port, e_port, proto,
1068 vrf_id, sw_if_index, flags, pool_addr, 0);
1072 rv = nat44_ei_del_static_mapping (l_addr, e_addr, l_port, e_port, proto,
1073 vrf_id, sw_if_index, flags);
1078 case VNET_API_ERROR_INVALID_VALUE:
1079 error = clib_error_return (0, "External port already in use.");
1081 case VNET_API_ERROR_NO_SUCH_ENTRY:
1083 error = clib_error_return (0, "External address must be allocated.");
1085 error = clib_error_return (0, "Mapping not exist.");
1087 case VNET_API_ERROR_NO_SUCH_FIB:
1088 error = clib_error_return (0, "No such VRF id.");
1090 case VNET_API_ERROR_VALUE_EXIST:
1091 error = clib_error_return (0, "Mapping already exist.");
1093 case VNET_API_ERROR_FEATURE_DISABLED:
1100 unformat_free (line_input);
1105 static clib_error_t *
1106 add_identity_mapping_command_fn (vlib_main_t *vm, unformat_input_t *input,
1107 vlib_cli_command_t *cmd)
1109 unformat_input_t _line_input, *line_input = &_line_input;
1110 vnet_main_t *vnm = vnet_get_main ();
1111 clib_error_t *error = 0;
1113 int rv, is_add = 1, port_set = 0;
1114 u32 sw_if_index = ~0, port, flags, vrf_id = ~0;
1115 nat_protocol_t proto;
1118 flags = NAT44_EI_SM_FLAG_IDENTITY_NAT;
1120 if (!unformat_user (input, unformat_line_input, line_input))
1121 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1123 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1125 if (unformat (line_input, "%U", unformat_ip4_address, &addr))
1127 else if (unformat (line_input, "external %U", unformat_vnet_sw_interface,
1130 else if (unformat (line_input, "vrf %u", &vrf_id))
1132 else if (unformat (line_input, "%U %u", unformat_nat_protocol, &proto,
1137 else if (unformat (line_input, "del"))
1143 error = clib_error_return (0, "unknown input: '%U'",
1144 format_unformat_error, line_input);
1151 flags |= NAT44_EI_SM_FLAG_ADDR_ONLY;
1155 port = clib_host_to_net_u16 (port);
1161 rv = nat44_ei_add_static_mapping (addr, addr, port, port, proto, vrf_id,
1162 sw_if_index, flags, addr, 0);
1166 rv = nat44_ei_del_static_mapping (addr, addr, port, port, proto, vrf_id,
1167 sw_if_index, flags);
1172 case VNET_API_ERROR_INVALID_VALUE:
1173 error = clib_error_return (0, "External port already in use.");
1175 case VNET_API_ERROR_NO_SUCH_ENTRY:
1177 error = clib_error_return (0, "External address must be allocated.");
1179 error = clib_error_return (0, "Mapping not exist.");
1181 case VNET_API_ERROR_NO_SUCH_FIB:
1182 error = clib_error_return (0, "No such VRF id.");
1184 case VNET_API_ERROR_VALUE_EXIST:
1185 error = clib_error_return (0, "Mapping already exist.");
1192 unformat_free (line_input);
1197 static clib_error_t *
1198 nat44_ei_show_static_mappings_command_fn (vlib_main_t *vm,
1199 unformat_input_t *input,
1200 vlib_cli_command_t *cmd)
1202 nat44_ei_main_t *nm = &nat44_ei_main;
1203 nat44_ei_static_mapping_t *m;
1204 nat44_ei_static_map_resolve_t *rp;
1206 vlib_cli_output (vm, "NAT44 static mappings:");
1207 pool_foreach (m, nm->static_mappings)
1209 vlib_cli_output (vm, " %U", format_nat44_ei_static_mapping, m);
1211 vec_foreach (rp, nm->to_resolve)
1212 vlib_cli_output (vm, " %U", format_nat44_ei_static_map_to_resolve, rp);
1217 static clib_error_t *
1218 nat44_ei_add_interface_address_command_fn (vlib_main_t *vm,
1219 unformat_input_t *input,
1220 vlib_cli_command_t *cmd)
1222 unformat_input_t _line_input, *line_input = &_line_input;
1223 nat44_ei_main_t *nm = &nat44_ei_main;
1224 clib_error_t *error = 0;
1228 if (!unformat_user (input, unformat_line_input, line_input))
1229 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1231 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1233 if (unformat (line_input, "%U", unformat_vnet_sw_interface,
1234 nm->vnet_main, &sw_if_index))
1236 else if (unformat (line_input, "del"))
1242 error = clib_error_return (0, "unknown input '%U'",
1243 format_unformat_error, line_input);
1250 rv = nat44_ei_add_interface_address (sw_if_index);
1253 error = clib_error_return (0, "add address returned %d", rv);
1258 rv = nat44_ei_del_interface_address (sw_if_index);
1261 error = clib_error_return (0, "del address returned %d", rv);
1266 unformat_free (line_input);
1271 static clib_error_t *
1272 nat44_ei_show_interface_address_command_fn (vlib_main_t *vm,
1273 unformat_input_t *input,
1274 vlib_cli_command_t *cmd)
1276 nat44_ei_main_t *nm = &nat44_ei_main;
1277 vnet_main_t *vnm = vnet_get_main ();
1280 vlib_cli_output (vm, "NAT44 pool address interfaces:");
1281 vec_foreach (sw_if_index, nm->auto_add_sw_if_indices)
1283 vlib_cli_output (vm, " %U", format_vnet_sw_if_index_name, vnm,
1289 static clib_error_t *
1290 nat44_ei_show_sessions_command_fn (vlib_main_t *vm, unformat_input_t *input,
1291 vlib_cli_command_t *cmd)
1293 unformat_input_t _line_input, *line_input = &_line_input;
1294 clib_error_t *error = 0;
1295 ip4_address_t saddr;
1296 u8 filter_saddr = 0;
1298 nat44_ei_main_per_thread_data_t *tnm;
1299 nat44_ei_main_t *nm = &nat44_ei_main;
1304 if (!unformat_user (input, unformat_line_input, line_input))
1307 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1309 if (unformat (line_input, "detail"))
1311 else if (unformat (line_input, "filter saddr %U", unformat_ip4_address,
1316 error = clib_error_return (0, "unknown input '%U'",
1317 format_unformat_error, line_input);
1321 unformat_free (line_input);
1324 vlib_cli_output (vm, "NAT44 sessions:");
1326 vec_foreach_index (i, nm->per_thread_data)
1328 tnm = vec_elt_at_index (nm->per_thread_data, i);
1330 vlib_cli_output (vm, "-------- thread %d %s: %d sessions --------\n", i,
1331 vlib_worker_threads[i].name, pool_elts (tnm->sessions));
1334 pool_foreach (u, tnm->users)
1336 if (filter_saddr && saddr.as_u32 != u->addr.as_u32)
1338 vlib_cli_output (vm, " %U", format_nat44_ei_user, tnm, u, detail);
1344 static clib_error_t *
1345 nat44_ei_del_user_command_fn (vlib_main_t *vm, unformat_input_t *input,
1346 vlib_cli_command_t *cmd)
1348 unformat_input_t _line_input, *line_input = &_line_input;
1349 clib_error_t *error = 0;
1354 if (!unformat_user (input, unformat_line_input, line_input))
1355 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1357 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1359 if (unformat (line_input, "%U", unformat_ip4_address, &addr))
1361 else if (unformat (line_input, "fib %u", &fib_index))
1365 error = clib_error_return (0, "unknown input '%U'",
1366 format_unformat_error, line_input);
1371 rv = nat44_ei_user_del (&addr, fib_index);
1375 error = clib_error_return (0, "nat44_ei_user_del returned %d", rv);
1379 unformat_free (line_input);
1384 static clib_error_t *
1385 nat44_ei_clear_sessions_command_fn (vlib_main_t *vm, unformat_input_t *input,
1386 vlib_cli_command_t *cmd)
1388 clib_error_t *error = 0;
1389 nat44_ei_sessions_clear ();
1393 static clib_error_t *
1394 nat44_ei_del_session_command_fn (vlib_main_t *vm, unformat_input_t *input,
1395 vlib_cli_command_t *cmd)
1397 nat44_ei_main_t *nm = &nat44_ei_main;
1398 unformat_input_t _line_input, *line_input = &_line_input;
1399 u32 port = 0, vrf_id = nm->outside_vrf_id;
1400 clib_error_t *error = 0;
1401 nat_protocol_t proto;
1405 if (!unformat_user (input, unformat_line_input, line_input))
1406 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1408 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1410 if (unformat (line_input, "%U:%u %U", unformat_ip4_address, &addr, &port,
1411 unformat_nat_protocol, &proto))
1413 else if (unformat (line_input, "in"))
1416 vrf_id = nm->inside_vrf_id;
1418 else if (unformat (line_input, "out"))
1421 vrf_id = nm->outside_vrf_id;
1423 else if (unformat (line_input, "vrf %u", &vrf_id))
1427 error = clib_error_return (0, "unknown input '%U'",
1428 format_unformat_error, line_input);
1433 rv = nat44_ei_del_session (nm, &addr, clib_host_to_net_u16 (port), proto,
1442 error = clib_error_return (0, "nat44_ei_del_session returned %d", rv);
1447 unformat_free (line_input);
1452 static clib_error_t *
1453 nat44_ei_forwarding_set_command_fn (vlib_main_t *vm, unformat_input_t *input,
1454 vlib_cli_command_t *cmd)
1456 nat44_ei_main_t *nm = &nat44_ei_main;
1457 unformat_input_t _line_input, *line_input = &_line_input;
1458 clib_error_t *error = 0;
1460 u8 enable_set = 0, enable = 0;
1462 if (!unformat_user (input, unformat_line_input, line_input))
1463 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1465 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1470 if (unformat (line_input, "disable"))
1472 else if (unformat (line_input, "enable"))
1477 error = clib_error_return (0, "unknown input '%U'",
1478 format_unformat_error, line_input);
1484 error = clib_error_return (0, "expected enable | disable");
1486 nm->forwarding_enabled = enable;
1489 unformat_free (line_input);
1493 static clib_error_t *
1494 set_timeout_command_fn (vlib_main_t *vm, unformat_input_t *input,
1495 vlib_cli_command_t *cmd)
1497 nat44_ei_main_t *nm = &nat44_ei_main;
1498 unformat_input_t _line_input, *line_input = &_line_input;
1499 clib_error_t *error = 0;
1501 if (!unformat_user (input, unformat_line_input, line_input))
1502 return clib_error_return (0, NAT44_EI_EXPECTED_ARGUMENT);
1504 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1506 if (unformat (line_input, "udp %u", &nm->timeouts.udp))
1508 else if (unformat (line_input, "tcp-established %u",
1509 &nm->timeouts.tcp.established))
1511 else if (unformat (line_input, "tcp-transitory %u",
1512 &nm->timeouts.tcp.transitory))
1514 else if (unformat (line_input, "icmp %u", &nm->timeouts.icmp))
1516 else if (unformat (line_input, "reset"))
1517 nat_reset_timeouts (&nm->timeouts);
1520 error = clib_error_return (0, "unknown input '%U'",
1521 format_unformat_error, line_input);
1526 unformat_free (line_input);
1530 static clib_error_t *
1531 nat_show_timeouts_command_fn (vlib_main_t *vm, unformat_input_t *input,
1532 vlib_cli_command_t *cmd)
1534 nat44_ei_main_t *nm = &nat44_ei_main;
1536 vlib_cli_output (vm, "udp timeout: %dsec", nm->timeouts.udp);
1537 vlib_cli_output (vm, "tcp-established timeout: %dsec",
1538 nm->timeouts.tcp.established);
1539 vlib_cli_output (vm, "tcp-transitory timeout: %dsec",
1540 nm->timeouts.tcp.transitory);
1541 vlib_cli_output (vm, "icmp timeout: %dsec", nm->timeouts.icmp);
1548 * @cliexstart{nat44 ei}
1549 * Enable nat44 ei plugin
1550 * To enable nat44-ei, use:
1551 * vpp# nat44 ei enable
1552 * To disable nat44-ei, use:
1553 * vpp# nat44 ei disable
1554 * To enable nat44 ei static mapping only, use:
1555 * vpp# nat44 ei enable static-mapping
1556 * To enable nat44 ei static mapping with connection tracking, use:
1557 * vpp# nat44 ei enable static-mapping connection-tracking
1558 * To enable nat44 ei out2in dpo, use:
1559 * vpp# nat44 ei enable out2in-dpo
1560 * To set inside-vrf outside-vrf, use:
1561 * vpp# nat44 ei enable inside-vrf <id> outside-vrf <id>
1564 VLIB_CLI_COMMAND (nat44_ei_enable_disable_command, static) = {
1567 "nat44 ei <enable [sessions <max-number>] [users <max-number>] "
1568 "[static-mappig-only [connection-tracking]|out2in-dpo] [inside-vrf "
1569 "<vrf-id>] [outside-vrf <vrf-id>] [user-sessions <max-number>]>|disable",
1570 .function = nat44_ei_enable_disable_command_fn,
1575 * @cliexstart{set snat44 ei workers}
1576 * Set NAT workers if 2 or more workers available, use:
1577 * vpp# set snat44 ei workers 0-2,5
1580 VLIB_CLI_COMMAND (set_workers_command, static) = {
1581 .path = "set nat44 ei workers",
1582 .function = set_workers_command_fn,
1583 .short_help = "set nat44 ei workers <workers-list>",
1588 * @cliexstart{show nat44 ei workers}
1590 * vpp# show nat44 ei workers:
1596 VLIB_CLI_COMMAND (nat_show_workers_command, static) = {
1597 .path = "show nat44 ei workers",
1598 .short_help = "show nat44 ei workers",
1599 .function = nat_show_workers_command_fn,
1604 * @cliexstart{set nat44 ei timeout}
1605 * Set values of timeouts for NAT sessions (in seconds), use:
1606 * vpp# set nat44 ei timeout udp 120 tcp-established 7500 tcp-transitory 250
1608 * To reset default values use:
1609 * vpp# set nat44 ei timeout reset
1612 VLIB_CLI_COMMAND (set_timeout_command, static) = {
1613 .path = "set nat44 ei timeout",
1614 .function = set_timeout_command_fn,
1615 .short_help = "set nat44 ei timeout [udp <sec> | tcp-established <sec> "
1616 "tcp-transitory <sec> | icmp <sec> | reset]",
1621 * @cliexstart{show nat44 ei timeouts}
1622 * Show values of timeouts for NAT sessions.
1623 * vpp# show nat44 ei timeouts
1624 * udp timeout: 300sec
1625 * tcp-established timeout: 7440sec
1626 * tcp-transitory timeout: 240sec
1627 * icmp timeout: 60sec
1630 VLIB_CLI_COMMAND (nat_show_timeouts_command, static) = {
1631 .path = "show nat44 ei timeouts",
1632 .short_help = "show nat44 ei timeouts",
1633 .function = nat_show_timeouts_command_fn,
1638 * @cliexstart{nat44 ei set logging level}
1639 * To set NAT logging level use:
1640 * Set nat44 ei logging level
1643 VLIB_CLI_COMMAND (nat44_ei_set_log_level_command, static) = {
1644 .path = "nat44 ei set logging level",
1645 .function = nat44_ei_set_log_level_command_fn,
1646 .short_help = "nat44 ei set logging level <level>",
1651 * @cliexstart{snat44 ei ipfix logging}
1652 * To enable NAT IPFIX logging use:
1653 * vpp# nat44 ei ipfix logging
1654 * To set IPFIX exporter use:
1655 * vpp# set ipfix exporter collector 10.10.10.3 src 10.10.10.1
1658 VLIB_CLI_COMMAND (nat44_ei_ipfix_logging_enable_disable_command, static) = {
1659 .path = "nat44 ei ipfix logging",
1660 .function = nat44_ei_ipfix_logging_enable_disable_command_fn,
1661 .short_help = "nat44 ei ipfix logging <enable [domain <domain-id>] "
1662 "[src-port <port>]>|disable",
1667 * @cliexstart{nat44 ei addr-port-assignment-alg}
1668 * Set address and port assignment algorithm
1669 * For the MAP-E CE limit port choice based on PSID use:
1670 * vpp# nat44 ei addr-port-assignment-alg map-e psid 10 psid-offset 6 psid-len
1672 * For port range use:
1673 * vpp# nat44 ei addr-port-assignment-alg port-range <start-port> - <end-port>
1674 * To set standard (default) address and port assignment algorithm use:
1675 * vpp# nat44 ei addr-port-assignment-alg default
1678 VLIB_CLI_COMMAND (nat44_ei_set_alloc_addr_and_port_alg_command, static) = {
1679 .path = "nat44 ei addr-port-assignment-alg",
1680 .short_help = "nat44 ei addr-port-assignment-alg <alg-name> [<alg-params>]",
1681 .function = nat44_ei_set_alloc_addr_and_port_alg_command_fn,
1686 * @cliexstart{show nat44 ei addr-port-assignment-alg}
1687 * Show address and port assignment algorithm
1690 VLIB_CLI_COMMAND (nat44_ei_show_alloc_addr_and_port_alg_command, static) = {
1691 .path = "show nat44 ei addr-port-assignment-alg",
1692 .short_help = "show nat44 ei addr-port-assignment-alg",
1693 .function = nat44_ei_show_alloc_addr_and_port_alg_command_fn,
1698 * @cliexstart{nat44 ei mss-clamping}
1699 * Set TCP MSS rewriting configuration
1700 * To enable TCP MSS rewriting use:
1701 * vpp# nat44 ei mss-clamping 1452
1702 * To disbale TCP MSS rewriting use:
1703 * vpp# nat44 ei mss-clamping disable
1706 VLIB_CLI_COMMAND (nat_set_mss_clamping_command, static) = {
1707 .path = "nat44 ei mss-clamping",
1708 .short_help = "nat44 ei mss-clamping <mss-value>|disable",
1709 .function = nat_set_mss_clamping_command_fn,
1714 * @cliexstart{show nat44 ei mss-clamping}
1715 * Show TCP MSS rewriting configuration
1718 VLIB_CLI_COMMAND (nat_show_mss_clamping_command, static) = {
1719 .path = "show nat44 ei mss-clamping",
1720 .short_help = "show nat44 ei mss-clamping",
1721 .function = nat_show_mss_clamping_command_fn,
1726 * @cliexstart{nat44 ei ha failover}
1727 * Set HA failover (remote settings)
1730 VLIB_CLI_COMMAND (nat_ha_failover_command, static) = {
1731 .path = "nat44 ei ha failover",
1733 "nat44 ei ha failover <ip4-address>:<port> [refresh-interval <sec>]",
1734 .function = nat_ha_failover_command_fn,
1739 * @cliexstart{nat44 ei ha listener}
1740 * Set HA listener (local settings)
1743 VLIB_CLI_COMMAND (nat_ha_listener_command, static) = {
1744 .path = "nat44 ei ha listener",
1746 "nat44 ei ha listener <ip4-address>:<port> [path-mtu <path-mtu>]",
1747 .function = nat_ha_listener_command_fn,
1752 * @cliexstart{show nat44 ei ha}
1753 * Show HA configuration/status
1756 VLIB_CLI_COMMAND (nat_show_ha_command, static) = {
1757 .path = "show nat44 ei ha",
1758 .short_help = "show nat44 ei ha",
1759 .function = nat_show_ha_command_fn,
1764 * @cliexstart{nat44 ei ha flush}
1765 * Flush the current HA data (for testing)
1768 VLIB_CLI_COMMAND (nat_ha_flush_command, static) = {
1769 .path = "nat44 ei ha flush",
1770 .short_help = "nat44 ei ha flush",
1771 .function = nat_ha_flush_command_fn,
1776 * @cliexstart{nat44 ei ha resync}
1777 * Resync HA (resend existing sessions to new failover)
1780 VLIB_CLI_COMMAND (nat_ha_resync_command, static) = {
1781 .path = "nat44 ei ha resync",
1782 .short_help = "nat44 ei ha resync",
1783 .function = nat_ha_resync_command_fn,
1788 * @cliexstart{show nat44 ei hash tables}
1789 * Show NAT44 hash tables
1792 VLIB_CLI_COMMAND (nat44_ei_show_hash, static) = {
1793 .path = "show nat44 ei hash tables",
1794 .short_help = "show nat44 ei hash tables [detail|verbose]",
1795 .function = nat44_ei_show_hash_command_fn,
1800 * @cliexstart{nat44 ei add address}
1801 * Add/delete NAT44 pool address.
1802 * To add NAT44 pool address use:
1803 * vpp# nat44 ei add address 172.16.1.3
1804 * vpp# nat44 ei add address 172.16.2.2 - 172.16.2.24
1805 * To add NAT44 pool address for specific tenant (identified by VRF id) use:
1806 * vpp# nat44 ei add address 172.16.1.3 tenant-vrf 10
1809 VLIB_CLI_COMMAND (add_address_command, static) = {
1810 .path = "nat44 ei add address",
1811 .short_help = "nat44 ei add address <ip4-range-start> [- <ip4-range-end>] "
1812 "[tenant-vrf <vrf-id>] [del]",
1813 .function = add_address_command_fn,
1818 * @cliexstart{show nat44 ei addresses}
1819 * Show NAT44 pool addresses.
1820 * vpp# show nat44 ei addresses
1821 * NAT44 pool addresses:
1823 * tenant VRF independent
1834 VLIB_CLI_COMMAND (nat44_ei_show_addresses_command, static) = {
1835 .path = "show nat44 ei addresses",
1836 .short_help = "show nat44 ei addresses",
1837 .function = nat44_ei_show_addresses_command_fn,
1842 * @cliexstart{set interface nat44}
1843 * Enable/disable NAT44 feature on the interface.
1844 * To enable NAT44 feature with local network interface use:
1845 * vpp# set interface nat44 ei in GigabitEthernet0/8/0
1846 * To enable NAT44 feature with external network interface use:
1847 * vpp# set interface nat44 ei out GigabitEthernet0/a/0
1850 VLIB_CLI_COMMAND (set_interface_nat44_ei_command, static) = {
1851 .path = "set interface nat44 ei",
1852 .function = nat44_ei_feature_command_fn,
1854 "set interface nat44 ei in <intfc> out <intfc> [output-feature] "
1860 * @cliexstart{show nat44 ei interfaces}
1861 * Show interfaces with NAT44 feature.
1862 * vpp# show nat44 ei interfaces
1864 * GigabitEthernet0/8/0 in
1865 * GigabitEthernet0/a/0 out
1868 VLIB_CLI_COMMAND (nat44_ei_show_interfaces_command, static) = {
1869 .path = "show nat44 ei interfaces",
1870 .short_help = "show nat44 ei interfaces",
1871 .function = nat44_ei_show_interfaces_command_fn,
1876 * @cliexstart{nat44 ei add static mapping}
1877 * Static mapping allows hosts on the external network to initiate connection
1878 * to to the local network host.
1879 * To create static mapping between local host address 10.0.0.3 port 6303 and
1880 * external address 4.4.4.4 port 3606 for TCP protocol use:
1881 * vpp# nat44 ei add static mapping tcp local 10.0.0.3 6303 external 4.4.4.4
1883 * If not runnig "static mapping only" NAT plugin mode use before:
1884 * vpp# nat44 ei add address 4.4.4.4
1885 * To create address only static mapping between local and external address
1887 * vpp# nat44 ei add static mapping local 10.0.0.3 external 4.4.4.4
1888 * To create ICMP static mapping between local and external with ICMP echo
1889 * identifier 10 use:
1890 * vpp# nat44 ei add static mapping icmp local 10.0.0.3 10 external 4.4.4.4 10
1893 VLIB_CLI_COMMAND (add_static_mapping_command, static) = {
1894 .path = "nat44 ei add static mapping",
1895 .function = add_static_mapping_command_fn,
1896 .short_help = "nat44 ei add static mapping tcp|udp|icmp local <addr> "
1897 "[<port|icmp-echo-id>] "
1898 "external <addr> [<port|icmp-echo-id>] [vrf <table-id>] [del]",
1903 * @cliexstart{nat44 ei add identity mapping}
1904 * Identity mapping translate an IP address to itself.
1905 * To create identity mapping for address 10.0.0.3 port 6303 for TCP protocol
1907 * vpp# nat44 ei add identity mapping 10.0.0.3 tcp 6303
1908 * To create identity mapping for address 10.0.0.3 use:
1909 * vpp# nat44 ei add identity mapping 10.0.0.3
1910 * To create identity mapping for DHCP addressed interface use:
1911 * vpp# nat44 ei add identity mapping external GigabitEthernet0/a/0 tcp 3606
1914 VLIB_CLI_COMMAND (add_identity_mapping_command, static) = {
1915 .path = "nat44 ei add identity mapping",
1916 .function = add_identity_mapping_command_fn,
1918 "nat44 ei add identity mapping <ip4-addr>|external <interface> "
1919 "[<protocol> <port>] [vrf <table-id>] [del]",
1924 * @cliexstart{show nat44 ei static mappings}
1925 * Show NAT44 static mappings.
1926 * vpp# show nat44 ei static mappings
1927 * NAT44 static mappings:
1928 * local 10.0.0.3 external 4.4.4.4 vrf 0
1929 * tcp local 192.168.0.4:6303 external 4.4.4.3:3606 vrf 0
1930 * tcp vrf 0 external 1.2.3.4:80
1931 * local 10.100.10.10:8080 probability 80
1932 * local 10.100.10.20:8080 probability 20
1933 * tcp local 10.0.0.10:3603 external GigabitEthernet0/a/0:6306 vrf 10
1936 VLIB_CLI_COMMAND (nat44_ei_show_static_mappings_command, static) = {
1937 .path = "show nat44 ei static mappings",
1938 .short_help = "show nat44 ei static mappings",
1939 .function = nat44_ei_show_static_mappings_command_fn,
1944 * @cliexstart{nat44 ei add interface address}
1945 * Use NAT44 pool address from specific interfce
1946 * To add NAT44 pool address from specific interface use:
1947 * vpp# nat44 ei add interface address GigabitEthernet0/8/0
1950 VLIB_CLI_COMMAND (nat44_ei_add_interface_address_command, static) = {
1951 .path = "nat44 ei add interface address",
1952 .short_help = "nat44 ei add interface address <interface> [del]",
1953 .function = nat44_ei_add_interface_address_command_fn,
1958 * @cliexstart{show nat44 ei interface address}
1959 * Show NAT44 pool address interfaces
1960 * vpp# show nat44 ei interface address
1961 * NAT44 pool address interfaces:
1962 * GigabitEthernet0/a/0
1965 VLIB_CLI_COMMAND (nat44_ei_show_interface_address_command, static) = {
1966 .path = "show nat44 ei interface address",
1967 .short_help = "show nat44 ei interface address",
1968 .function = nat44_ei_show_interface_address_command_fn,
1973 * @cliexstart{show nat44 ei sessions}
1974 * Show NAT44 sessions.
1977 VLIB_CLI_COMMAND (nat44_ei_show_sessions_command, static) = {
1978 .path = "show nat44 ei sessions",
1979 .short_help = "show nat44 ei sessions [detail] [filter saddr <ip>]",
1980 .function = nat44_ei_show_sessions_command_fn,
1985 * @cliexstart{nat44 ei del user}
1986 * To delete all NAT44 user sessions:
1987 * vpp# nat44 ei del user 10.0.0.3
1990 VLIB_CLI_COMMAND (nat44_ei_del_user_command, static) = {
1991 .path = "nat44 ei del user",
1992 .short_help = "nat44 ei del user <addr> [fib <index>]",
1993 .function = nat44_ei_del_user_command_fn,
1998 * @cliexstart{clear nat44 ei sessions}
1999 * To clear all NAT44 sessions
2000 * vpp# clear nat44 ei sessions
2003 VLIB_CLI_COMMAND (nat44_ei_clear_sessions_command, static) = {
2004 .path = "clear nat44 ei sessions",
2005 .short_help = "clear nat44 ei sessions",
2006 .function = nat44_ei_clear_sessions_command_fn,
2011 * @cliexstart{nat44 ei del session}
2012 * To administratively delete NAT44 session by inside address and port use:
2013 * vpp# nat44 ei del session in 10.0.0.3:6303 tcp
2014 * To administratively delete NAT44 session by outside address and port use:
2015 * vpp# nat44 ei del session out 1.0.0.3:6033 udp
2018 VLIB_CLI_COMMAND (nat44_ei_del_session_command, static) = {
2019 .path = "nat44 ei del session",
2020 .short_help = "nat44 ei del session in|out <addr>:<port> tcp|udp|icmp [vrf "
2021 "<id>] [external-host <addr>:<port>]",
2022 .function = nat44_ei_del_session_command_fn,
2027 * @cliexstart{nat44 ei forwarding}
2028 * Enable or disable forwarding
2029 * Forward packets which don't match existing translation
2030 * or static mapping instead of dropping them.
2031 * To enable forwarding, use:
2032 * vpp# nat44 ei forwarding enable
2033 * To disable forwarding, use:
2034 * vpp# nat44 ei forwarding disable
2037 VLIB_CLI_COMMAND (nat44_ei_forwarding_set_command, static) = {
2038 .path = "nat44 ei forwarding",
2039 .short_help = "nat44 ei forwarding enable|disable",
2040 .function = nat44_ei_forwarding_set_command_fn,
2044 * fd.io coding-style-patch-verification: ON
2047 * eval: (c-set-style "gnu")