src/plugins/nat/nat44-ei/nat44_ei.api

   1 /*
   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:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16 option version = "1.0.0";
  17 import "vnet/ip/ip_types.api";
  18 import "vnet/interface_types.api";
  19 import "plugins/nat/lib/nat_types.api";
  20
  21 enum nat44_ei_config_flags : u8
  22 {
  23   NAT44_EI_NONE = 0x00,
  24   NAT44_EI_STATIC_MAPPING_ONLY = 0x01,
  25   NAT44_EI_CONNECTION_TRACKING = 0x02,
  26   NAT44_EI_OUT2IN_DPO = 0x04,
  27   NAT44_EI_ADDR_ONLY_MAPPING = 0x08,
  28   NAT44_EI_IF_INSIDE = 0x10,
  29   NAT44_EI_IF_OUTSIDE = 0x20,
  30   NAT44_EI_STATIC_MAPPING = 0x40,
  31 };
  32
  33 /** \brief Enable/disable NAT44 plugin
  34     @param client_index - opaque cookie to identify the sender
  35     @param context - sender context, to match reply w/ request
  36     @param inside_vrf - inside vrf id
  37     @param outside_vrf - outside vrf id
  38     @param users - maximum number of users per thread
  39     @param user_memory - overwrite hash allocation parameter
  40     @param sessions - maximum number of sessions per thread
  41     @param session_memory - overwrite hash allocation parameter
  42     @param user_sessions - maximum number of sessions per user
  43     @param enable - true if enable, false if disable
  44     @param flags - flag NAT44_EI_IS_STATIC_MAPPING_ONLY,
  45                         NAT44_EI_IS_CONNECTION_TRACKING,
  46                         NAT44_EI_IS_OUT2IN_DPO
  47 */
  48 autoreply define nat44_ei_plugin_enable_disable {
  49   option in_progress;
  50   u32 client_index;
  51   u32 context;
  52   u32 inside_vrf;
  53   u32 outside_vrf;
  54   u32 users;
  55   u32 user_memory;
  56   u32 sessions;
  57   u32 session_memory;
  58   u32 user_sessions;
  59   bool enable;
  60   vl_api_nat44_ei_config_flags_t flags;
  61 };
  62
  63 /** \brief Show NAT44 plugin running config
  64     @param client_index - opaque cookie to identify the sender
  65     @param context - sender context, to match reply w/ request
  66 */
  67 define nat44_ei_show_running_config
  68 {
  69   option in_progress;
  70   u32 client_index;
  71   u32 context;
  72 };
  73
  74 /** \brief Show NAT44 plugin running config reply
  75     @param context - sender context, to match reply w/ request
  76     @param retval - return code for the request
  77     @param inside_vrf - default inside VRF id
  78     @param outside_vrf - outside VRF id
  79     @param users - maximum number of users per worker thread
  80     @param sessions - maximum number of sessions per worker thread
  81     @param user_sessions - maximum number of sessions per user
  82     @param user_buckets - number of user hash buckets
  83     @param translation_buckets - number of translation hash buckets
  84     @param flags - flag NAT44_EI_IS_STATIC_MAPPING_ONLY,
  85                         NAT44_EI_IS_CONNECTION_TRACKING,
  86                         NAT44_EI_IS_OUT2IN_DPO
  87 */
  88 define nat44_ei_show_running_config_reply
  89 {
  90   option in_progress;
  91   u32 context;
  92   i32 retval;
  93   u32 inside_vrf;
  94   u32 outside_vrf;
  95   u32 users;
  96   u32 sessions;
  97   u32 user_sessions;
  98   u32 user_buckets;
  99   u32 translation_buckets;
 100   bool forwarding_enabled;
 101   bool ipfix_logging_enabled;
 102   vl_api_nat_timeouts_t timeouts;
 103   vl_api_nat_log_level_t log_level;
 104   vl_api_nat44_ei_config_flags_t flags;
 105 };
 106
 107 /** \brief Set NAT44 logging level
 108     @param client_index - opaque cookie to identify the sender
 109     @param context - sender context, to match reply w/ request
 110     @param log_level - logging level
 111 */
 112 autoreply define nat44_ei_set_log_level {
 113   option deprecated;
 114   u32 client_index;
 115   u32 context;
 116   vl_api_nat_log_level_t log_level;
 117 };
 118
 119 /** \brief Set NAT workers
 120     @param client_index - opaque cookie to identify the sender
 121     @param context - sender context, to match reply w/ request
 122     @param worker_mask - NAT workers mask
 123 */
 124 autoreply define nat44_ei_set_workers {
 125   option in_progress;
 126   u32 client_index;
 127   u32 context;
 128   u64 worker_mask;
 129 };
 130
 131 /** \brief Dump NAT workers
 132     @param client_index - opaque cookie to identify the sender
 133     @param context - sender context, to match reply w/ request
 134 */
 135 define nat44_ei_worker_dump {
 136   option in_progress;
 137   u32 client_index;
 138   u32 context;
 139 };
 140
 141 /** \brief NAT workers details response
 142     @param context - sender context, to match reply w/ request
 143     @param worker_index - worker index
 144     @param lcore_id - lcore ID
 145     @param name - worker name
 146 */
 147 define nat44_ei_worker_details {
 148   option in_progress;
 149   u32 context;
 150   u32 worker_index;
 151   u32 lcore_id;
 152   string name[64];
 153 };
 154
 155 /** \brief Enable/disable NAT IPFIX logging
 156     @param client_index - opaque cookie to identify the sender
 157     @param context - sender context, to match reply w/ request
 158     @param domain_id - observation domain ID
 159     @param src_port - source port number
 160     @param enable - true if enable, false if disable
 161 */
 162 autoreply define nat44_ei_ipfix_enable_disable {
 163   option in_progress;
 164   u32 client_index;
 165   u32 context;
 166   u32 domain_id;
 167   u16 src_port;
 168   bool enable;
 169 };
 170
 171 /** \brief Set values of timeouts for NAT sessions (seconds)
 172     @param client_index - opaque cookie to identify the sender
 173     @param context - sender context, to match reply w/ request
 174     @param udp - UDP timeout (default 300sec)
 175     @param tcp_established - TCP established timeout (default 7440sec)
 176     @param tcp_transitory - TCP transitory timeout (default 240sec)
 177     @param icmp - ICMP timeout (default 60sec)
 178 */
 179 autoreply define nat44_ei_set_timeouts {
 180   option in_progress;
 181   u32 client_index;
 182   u32 context;
 183   u32 udp;
 184   u32 tcp_established;
 185   u32 tcp_transitory;
 186   u32 icmp;
 187 };
 188
 189 /** \brief Set address and port assignment algorithm
 190     @param client_index - opaque cookie to identify the sender
 191     @param context - sender context, to match reply w/ request
 192     @param alg - address and port assignment algorithm:
 193                  0 - default, 1 - MAP-E, 2 - port range
 194                  (see nat44_ei_addr_and_port_alloc_alg_t in nat.h)
 195     @param psid_offset - number of offset bits (valid only for MAP-E alg)
 196     @param psid_length - length of PSID (valid only for MAP-E alg)
 197     @param psid - Port Set Identifier (PSID) value (valid only for MAP-E alg)
 198     @param start_port - beginning of the port range
 199     @param end_port - end of the port range
 200 */
 201 autoreply define nat44_ei_set_addr_and_port_alloc_alg {
 202   option in_progress;
 203   u32 client_index;
 204   u32 context;
 205   u8 alg;
 206   u8 psid_offset;
 207   u8 psid_length;
 208   u16 psid;
 209   u16 start_port;
 210   u16 end_port;
 211 };
 212
 213 /** \brief Get address and port assignment algorithm
 214     @param client_index - opaque cookie to identify the sender
 215     @param context - sender context, to match reply w/ request
 216 */
 217 define nat44_ei_get_addr_and_port_alloc_alg {
 218   option deprecated;
 219   u32 client_index;
 220   u32 context;
 221 };
 222
 223 /** \brief Get address and port assignment algorithm reply
 224     @param context - sender context, to match reply w/ request
 225     @param retval - return code
 226     @param alg - address and port assignment algorithm:
 227                  0 - default, 1 - MAP-E, 2 - port range
 228                  (see nat44_ei_addr_and_port_alloc_alg_t in nat.h)
 229     @param psid_offset - number of offset bits (valid only for MAP-E alg)
 230     @param psid_length - length of PSID (valid only for MAP-E alg)
 231     @param psid - Port Set Identifier (PSID) value (valid only for MAP-E alg)
 232     @param start_port - beginning of the port range
 233     @param end_port - end of the port range
 234 */
 235 define nat44_ei_get_addr_and_port_alloc_alg_reply {
 236   option deprecated;
 237   u32 context;
 238   i32 retval;
 239   u8 alg;
 240   u8 psid_offset;
 241   u8 psid_length;
 242   u16 psid;
 243   u16 start_port;
 244   u16 end_port;
 245 };
 246
 247 /** \brief Set TCP MSS rewriting configuration
 248     @param client_index - opaque cookie to identify the sender
 249     @param context - sender context, to match reply w/ request
 250     @param mss_value - MSS value to be used for MSS rewriting
 251     @param enable - if true enable MSS rewriting feature else disable
 252 */
 253 autoreply define nat44_ei_set_mss_clamping {
 254   option in_progress;
 255   u32 client_index;
 256   u32 context;
 257   u16 mss_value;
 258   bool enable;
 259 };
 260
 261 /** \brief Get TCP MSS rewriting configuration
 262     @param client_index - opaque cookie to identify the sender
 263     @param context - sender context, to match reply w/ request
 264 */
 265 define nat44_ei_get_mss_clamping {
 266   option deprecated;
 267   u32 client_index;
 268   u32 context;
 269 };
 270
 271 /** \brief Get TCP MSS rewriting configuration reply
 272     @param context - sender context, to match reply w/ request
 273     @param retval - return code
 274     @param mss_value - MSS value to be used for MSS rewriting
 275     @param enable - if true enable MSS rewriting feature else disable
 276 */
 277 define nat44_ei_get_mss_clamping_reply {
 278   option deprecated;
 279   u32 context;
 280   i32 retval;
 281   u16 mss_value;
 282   bool enable;
 283 };
 284
 285 /** \brief Set HA listener (local settings)
 286     @param client_index - opaque cookie to identify the sender
 287     @param context - sender context, to match reply w/ request
 288     @param ip_address - local IP4 address
 289     @param port - local UDP port number
 290     @param path_mtu - path MTU between local and failover
 291 */
 292 autoreply define nat44_ei_ha_set_listener {
 293   option in_progress;
 294   u32 client_index;
 295   u32 context;
 296   vl_api_ip4_address_t ip_address;
 297   u16 port;
 298   u32 path_mtu;
 299 };
 300
 301 /** \brief Set HA failover (remote settings)
 302     @param client_index - opaque cookie to identify the sender
 303     @param context - sender context, to match reply w/ request
 304     @param ip_address - failover IP4 address
 305     @param port - failvoer UDP port number
 306     @param session_refresh_interval - number of seconds after which to send
 307                                       session counters refresh
 308 */
 309 autoreply define nat44_ei_ha_set_failover {
 310   option in_progress;
 311   u32 client_index;
 312   u32 context;
 313   vl_api_ip4_address_t ip_address;
 314   u16 port;
 315   u32 session_refresh_interval;
 316 };
 317
 318 /** \brief Get HA listener/local configuration
 319     @param client_index - opaque cookie to identify the sender
 320     @param context - sender context, to match reply w/ request
 321 */
 322 define nat44_ei_ha_get_listener {
 323   option deprecated;
 324   u32 client_index;
 325   u32 context;
 326 };
 327
 328 /** \brief Get HA listener/local configuration reply
 329     @param context - sender context, to match reply w/ request
 330     @param retval - return code
 331     @param ip_address - local IP4 address
 332     @param port - local UDP port number
 333     @param path_mtu - Path MTU between local and failover
 334 */
 335 define nat44_ei_ha_get_listener_reply {
 336   option deprecated;
 337   u32 context;
 338   i32 retval;
 339   vl_api_ip4_address_t ip_address;
 340   u16 port;
 341   u32 path_mtu;
 342 };
 343
 344 /** \brief Get HA failover/remote settings
 345     @param client_index - opaque cookie to identify the sender
 346     @param context - sender context, to match reply w/ request
 347 */
 348 define nat44_ei_ha_get_failover {
 349   option deprecated;
 350   u32 client_index;
 351   u32 context;
 352 };
 353
 354 /** \brief Get HA failover/remote settings reply
 355     @param context - sender context, to match reply w/ request
 356     @param retval - return code
 357     @param ip_address - failover IP4 address
 358     @param port - failvoer UDP port number
 359     @param session_refresh_interval - number of seconds after which to send
 360                                       session counters refresh
 361 */
 362 define nat44_ei_ha_get_failover_reply {
 363   option deprecated;
 364   u32 context;
 365   i32 retval;
 366   vl_api_ip4_address_t ip_address;
 367   u16 port;
 368   u32 session_refresh_interval;
 369 };
 370
 371 /** \brief Flush the current HA data (for testing)
 372     @param client_index - opaque cookie to identify the sender
 373     @param context - sender context, to match reply w/ request
 374 */
 375 autoreply define nat44_ei_ha_flush {
 376   option in_progress;
 377   u32 client_index;
 378   u32 context;
 379 };
 380
 381 /** \brief Resync HA (resend existing sessions to new failover)
 382     @param client_index - opaque cookie to identify the sender
 383     @param context - sender context, to match reply w/ request
 384     @param want_resync_event - resync completed event sent to the sender via
 385                                nat44_ei_ha_resync_completed_event API message if
 386                                non-zero
 387     @param pid - sender's pid
 388 */
 389 autoreply define nat44_ei_ha_resync
 390 {
 391   option in_progress;
 392   u32 client_index;
 393   u32 context;
 394   u8 want_resync_event;
 395   u32 pid;
 396 };
 397
 398 /** \brief Tell client about a HA resync completion event
 399     @param client_index - opaque cookie to identify the sender
 400     @param pid - client pid registered to receive notification
 401     @param missed_count - number of missed (not ACKed) messages
 402 */
 403 define nat44_ei_ha_resync_completed_event
 404 {
 405   option in_progress;
 406   u32 client_index;
 407   u32 pid;
 408   u32 missed_count;
 409 };
 410
 411 service {
 412   rpc nat44_ei_ha_resync returns nat44_ei_ha_resync_reply events nat44_ei_ha_resync_completed_event;
 413 };
 414
 415 /** \brief Del NAT44 user
 416     @param client_index - opaque cookie to identify the sender
 417     @param context - sender context, to match reply w/ request
 418     @param ip_address - IPv4 address
 419     @param fib_index - FIB index
 420 */
 421 autoreply define nat44_ei_del_user {
 422   option in_progress;
 423   u32 client_index;
 424   u32 context;
 425   vl_api_ip4_address_t ip_address;
 426   u32 fib_index;
 427 };
 428
 429 /** \brief Add/del NAT44 address range
 430     @param client_index - opaque cookie to identify the sender
 431     @param context - sender context, to match reply w/ request
 432     @param first_ip_address - first IPv4 address
 433     @param last_ip_address - last IPv4 address
 434     @param vrf_id - VRF id of tenant, ~0 means independent of VRF
 435     @param is_add - true if add, false if delete
 436
 437 */
 438 autoreply define nat44_ei_add_del_address_range {
 439   option in_progress;
 440   u32 client_index;
 441   u32 context;
 442   vl_api_ip4_address_t first_ip_address;
 443   vl_api_ip4_address_t last_ip_address;
 444   u32 vrf_id;
 445   bool is_add;
 446 };
 447
 448 /** \brief Dump NAT44 addresses
 449     @param client_index - opaque cookie to identify the sender
 450     @param context - sender context, to match reply w/ request
 451 */
 452 define nat44_ei_address_dump {
 453   option in_progress;
 454   u32 client_index;
 455   u32 context;
 456 };
 457
 458 /** \brief NAT44 address details response
 459     @param context - sender context, to match reply w/ request
 460     @param ip_address - IPv4 address
 461     @param vrf_id - VRF id of tenant, ~0 means independent of VRF
 462 */
 463 define nat44_ei_address_details {
 464   option in_progress;
 465   u32 context;
 466   vl_api_ip4_address_t ip_address;
 467   u32 vrf_id;
 468 };
 469
 470 /** \brief Enable/disable NAT44 feature on the interface
 471     @param client_index - opaque cookie to identify the sender
 472     @param context - sender context, to match reply w/ request
 473     @param is_add - true if add, false if delete
 474     @param flags - flag NAT_IS_INSIDE if interface is inside else
 475                    interface is outside
 476     @param sw_if_index - software index of the interface
 477 */
 478 autoreply define nat44_ei_interface_add_del_feature {
 479   option in_progress;
 480   u32 client_index;
 481   u32 context;
 482   bool is_add;
 483   vl_api_nat44_ei_config_flags_t flags;
 484   vl_api_interface_index_t sw_if_index;
 485 };
 486
 487 /** \brief Dump interfaces with NAT44 feature
 488     @param client_index - opaque cookie to identify the sender
 489     @param context - sender context, to match reply w/ request
 490 */
 491 define nat44_ei_interface_dump {
 492   option in_progress;
 493   u32 client_index;
 494   u32 context;
 495 };
 496
 497 /** \brief NAT44 interface details response
 498     @param context - sender context, to match reply w/ request
 499     @param sw_if_index - software index of the interface
 500     @param flags - flag NAT_IS_INSIDE if interface is inside,
 501                    flag NAT_IS_OUTSIDE if interface is outside
 502                    and if both flags are set the interface is
 503                    both inside and outside
 504 */
 505 define nat44_ei_interface_details {
 506   option in_progress;
 507   u32 context;
 508   vl_api_nat44_ei_config_flags_t flags;
 509   vl_api_interface_index_t sw_if_index;
 510 };
 511
 512 /** \brief Enable/disbale NAT44 as an interface output feature (postrouting
 513            in2out translation)
 514     @param client_index - opaque cookie to identify the sender
 515     @param context - sender context, to match reply w/ request
 516     @param is_add - true if add, false if delete
 517     @param flags - flag NAT_IS_INSIDE if interface is inside else
 518                    interface is outside
 519     @param sw_if_index - software index of the interface
 520 */
 521 autoreply define nat44_ei_interface_add_del_output_feature {
 522   option deprecated;
 523   u32 client_index;
 524   u32 context;
 525   bool is_add;
 526   vl_api_nat44_ei_config_flags_t flags;
 527   vl_api_interface_index_t sw_if_index;
 528 };
 529
 530 /** \brief Dump interfaces with NAT44 output feature
 531     @param client_index - opaque cookie to identify the sender
 532     @param context - sender context, to match reply w/ request
 533 */
 534 define nat44_ei_interface_output_feature_dump {
 535   option deprecated;
 536   u32 client_index;
 537   u32 context;
 538 };
 539
 540 /** \brief NAT44 interface with output feature details response
 541     @param context - sender context, to match reply w/ request
 542     @param flags - flag NAT_IS_INSIDE if interface is inside else
 543                    interface is outside
 544     @param sw_if_index - software index of the interface
 545 */
 546 define nat44_ei_interface_output_feature_details {
 547   option deprecated;
 548   u32 context;
 549   vl_api_nat44_ei_config_flags_t flags;
 550   vl_api_interface_index_t sw_if_index;
 551 };
 552
 553 /** \brief Add/delete NAT44 static mapping
 554     @param client_index - opaque cookie to identify the sender
 555     @param context - sender context, to match reply w/ request
 556     @param is_add - true if add, false if delete
 557     @param flags - flag NAT44_EI_IS_ADDR_ONLY if address only mapping
 558     @param local_ip_address - local IPv4 address
 559     @param external_ip_address - external IPv4 address
 560     @param protocol - IP protocol, used only if addr_only=0
 561     @param local_port - local port number, used only if addr_only=0
 562     @param external_port - external port number, used only if addr_only=0
 563     @param external_sw_if_index - external interface (if set
 564                                   external_ip_address is ignored, ~0 means not
 565                                   used)
 566     @param vfr_id - VRF ID
 567     @param tag - opaque string tag
 568 */
 569 autoreply define nat44_ei_add_del_static_mapping {
 570   option in_progress;
 571   u32 client_index;
 572   u32 context;
 573   bool is_add;
 574   vl_api_nat44_ei_config_flags_t flags;
 575   vl_api_ip4_address_t local_ip_address;
 576   vl_api_ip4_address_t external_ip_address;
 577   u8 protocol;
 578   u16 local_port;
 579   u16 external_port;
 580   vl_api_interface_index_t external_sw_if_index;
 581   u32 vrf_id;
 582   string tag[64];
 583 };
 584
 585 /** \brief Dump NAT44 static mappings
 586     @param client_index - opaque cookie to identify the sender
 587     @param context - sender context, to match reply w/ request
 588 */
 589 define nat44_ei_static_mapping_dump {
 590   option in_progress;
 591   u32 client_index;
 592   u32 context;
 593 };
 594
 595 /** \brief NAT44 static mapping details response
 596     @param context - sender context, to match reply w/ request
 597     @param flags - flag NAT44_EI_IS_ADDR_ONLY if address only mapping,
 598     @param local_ip_address - local IPv4 address
 599     @param external_ip_address - external IPv4 address
 600     @param protocol - IP protocol, valid only if no NAT_ADDR_ONLY flag
 601     @param local_port - local port number, valid only if no NAT_ADDR_ONLY flag
 602     @param external_port - external port number, valid only if no NAT_ADDR_ONLY flag
 603     @param external_sw_if_index - external interface
 604     @param vfr_id - VRF ID
 605     @param tag - opaque string tag
 606 */
 607 define nat44_ei_static_mapping_details {
 608   option in_progress;
 609   u32 context;
 610   vl_api_nat44_ei_config_flags_t flags;
 611   vl_api_ip4_address_t local_ip_address;
 612   vl_api_ip4_address_t external_ip_address;
 613   u8 protocol;
 614   u16 local_port;
 615   u16 external_port;
 616   vl_api_interface_index_t external_sw_if_index;
 617   u32 vrf_id;
 618   string tag[64];
 619 };
 620
 621 /** \brief Add/delete NAT44 identity mapping
 622     @param client_index - opaque cookie to identify the sender
 623     @param context - sender context, to match reply w/ request
 624     @param is_add - true if add, false if delete
 625     @param flags - flag NAT44_EI_IS_ADDR_ONLY if address only mapping
 626     @param ip_address - IPv4 address
 627     @param protocol - IP protocol
 628     @param port - port number
 629     @param sw_if_index - interface (if set ip_address is ignored, ~0 means not
 630                                     used)
 631     @param vfr_id - VRF ID (if ~0 use default VRF)
 632     @param tag - opaque string tag
 633 */
 634 autoreply define nat44_ei_add_del_identity_mapping {
 635   option deprecated;
 636   u32 client_index;
 637   u32 context;
 638   bool is_add;
 639   vl_api_nat44_ei_config_flags_t flags;
 640   vl_api_ip4_address_t ip_address;
 641   u8 protocol;
 642   u16 port;
 643   vl_api_interface_index_t sw_if_index;
 644   u32 vrf_id;
 645   string tag[64];
 646 };
 647
 648 /** \brief Dump NAT44 identity mappings
 649     @param client_index - opaque cookie to identify the sender
 650     @param context - sender context, to match reply w/ request
 651 */
 652 define nat44_ei_identity_mapping_dump {
 653   option deprecated;
 654   u32 client_index;
 655   u32 context;
 656 };
 657
 658 /** \brief NAT44 identity mapping details response
 659     @param context - sender context, to match reply w/ request
 660     @param flags - flag NAT44_EI_ADDR_ONLY if address only mapping
 661     @param ip_address - IPv4 address
 662     @param protocol - IP protocol
 663     @param port - port number
 664     @param sw_if_index - interface
 665     @param vfr_id - VRF ID
 666     @param tag - opaque string tag
 667 */
 668 define nat44_ei_identity_mapping_details {
 669   option deprecated;
 670   u32 context;
 671   vl_api_nat44_ei_config_flags_t flags;
 672   vl_api_ip4_address_t ip_address;
 673   u8 protocol;
 674   u16 port;
 675   vl_api_interface_index_t sw_if_index;
 676   u32 vrf_id;
 677   string tag[64];
 678 };
 679
 680 /** \brief Add/delete NAT44 pool address from specific interfce
 681     @param client_index - opaque cookie to identify the sender
 682     @param context - sender context, to match reply w/ request
 683     @param is_add - true if add, false if delete
 684     @param sw_if_index - software index of the interface
 685     @param flags - flag NAT_TWICE_NAT if NAT address range for external hosts
 686 */
 687 autoreply define nat44_ei_add_del_interface_addr {
 688   option deprecated;
 689   u32 client_index;
 690   u32 context;
 691   bool is_add;
 692   vl_api_interface_index_t sw_if_index;
 693   vl_api_nat44_ei_config_flags_t flags;
 694 };
 695
 696 /** \brief Dump NAT44 pool addresses interfaces
 697     @param client_index - opaque cookie to identify the sender
 698     @param context - sender context, to match reply w/ request
 699 */
 700 define nat44_ei_interface_addr_dump {
 701   option deprecated;
 702   u32 client_index;
 703   u32 context;
 704 };
 705
 706 /** \brief NAT44 pool addresses interfaces details response
 707     @param context - sender context, to match reply w/ request
 708     @param sw_if_index - software index of the interface
 709
 710 */
 711 define nat44_ei_interface_addr_details {
 712   option deprecated;
 713   u32 context;
 714   vl_api_interface_index_t sw_if_index;
 715 };
 716
 717 /** \brief Dump NAT44 users
 718     @param client_index - opaque cookie to identify the sender
 719     @param context - sender context, to match reply w/ request
 720 */
 721 define nat44_ei_user_dump {
 722   option in_progress;
 723   u32 client_index;
 724   u32 context;
 725 };
 726
 727 /** \brief NAT44 users response
 728     @param context - sender context, to match reply w/ request
 729     @vrf_id - VRF ID
 730     @param ip_address - IPv4 address
 731     @param nsessions - number of dynamic sessions
 732     @param nstaticsessions - number of static sessions
 733 */
 734 define nat44_ei_user_details {
 735   option in_progress;
 736   u32 context;
 737   u32 vrf_id;
 738   vl_api_ip4_address_t ip_address;
 739   u32 nsessions;
 740   u32 nstaticsessions;
 741 };
 742
 743 /** \brief NAT44 user's sessions
 744     @param client_index - opaque cookie to identify the sender
 745     @param context - sender context, to match reply w/ request
 746     @param ip_address - IPv4 address of the user to dump
 747     @param vrf_id - VRF_ID
 748 */
 749 define nat44_ei_user_session_dump {
 750   option in_progress;
 751   u32 client_index;
 752   u32 context;
 753   vl_api_ip4_address_t ip_address;
 754   u32 vrf_id;
 755 };
 756
 757 /** \brief NAT44 user's sessions response
 758     @param context - sender context, to match reply w/ request
 759     @param outside_ip_address - outside IPv4 address
 760     @param outside_port - outside port
 761     @param inside_ip_address - inside IPv4 address
 762     @param inside_port - inside port
 763     @param protocol - protocol
 764     @param flags - flag NAT_IS_STATIC if session is static
 765     @param last_heard - last heard timer
 766     @param total_bytes - count of bytes sent through session
 767     @param total_pkts - count of pakets sent through session
 768     @param ext_host_address - external host IPv4 address
 769     @param ext_host_port - external host port
 770 */
 771 define nat44_ei_user_session_details {
 772   option in_progress;
 773   u32 context;
 774   vl_api_ip4_address_t outside_ip_address;
 775   u16 outside_port;
 776   vl_api_ip4_address_t inside_ip_address;
 777   u16 inside_port;
 778   u16 protocol;
 779   vl_api_nat44_ei_config_flags_t flags;
 780   u64 last_heard;
 781   u64 total_bytes;
 782   u32 total_pkts;
 783   vl_api_ip4_address_t ext_host_address;
 784   u16 ext_host_port;
 785 };
 786
 787 /** \brief Delete NAT44 session
 788     @param client_index - opaque cookie to identify the sender
 789     @param context - sender context, to match reply w/ request
 790     @param ip_address - IPv4 address
 791     @param protocol - IP protocol
 792     @param port - port number
 793     @param vfr_id - VRF ID
 794     @param flags - flag NAT_IS_INSIDE if interface is inside or
 795                    interface is outside,
 796                    flag NAT_IS_EXT_HOST_VALID if external host address and
 797                    port are valid
 798     @param ext_host_address - external host IPv4 address
 799     @param ext_host_port - external host port
 800 */
 801 autoreply define nat44_ei_del_session {
 802   option in_progress;
 803   u32 client_index;
 804   u32 context;
 805   vl_api_ip4_address_t address;
 806   u8 protocol;
 807   u16 port;
 808   u32 vrf_id;
 809   vl_api_nat44_ei_config_flags_t flags;
 810   vl_api_ip4_address_t ext_host_address;
 811   u16 ext_host_port;
 812 };
 813
 814 /** \brief Enable/disable forwarding for NAT44
 815     Forward packets which don't match existing translation
 816     or static mapping instead of dropping them.
 817     @param client_index - opaque cookie to identify the sender
 818     @param context - sender context, to match reply w/ request
 819     @param enable - true for enable, false for disable
 820 */
 821 autoreply define nat44_ei_forwarding_enable_disable {
 822   option in_progress;
 823   u32 client_index;
 824   u32 context;
 825   bool enable;
 826 };
 827
 828 /** \brief Set NAT handoff frame queue options
 829     @param client_index - opaque cookie to identify the sender
 830     @param context - sender context, to match reply w/ request
 831     @param frame_queue_nelts - number of worker handoff frame queue elements
 832 */
 833 autoreply define nat44_ei_set_fq_options {
 834   option in_progress;
 835   u32 client_index;
 836   u32 context;
 837   u32 frame_queue_nelts;
 838 };
 839
 840 /** \brief Show NAT handoff frame queue options
 841     @param client_index - opaque cookie to identify the sender
 842     @param context - sender context, to match reply w/ request
 843 */
 844 define nat44_ei_show_fq_options
 845 {
 846   option in_progress;
 847   u32 client_index;
 848   u32 context;
 849 };
 850
 851 /** \brief Show NAT handoff frame queue options reply
 852     @param context - sender context, to match reply w/ request
 853     @param retval - return code for the request
 854     @param frame_queue_nelts - number of worker handoff frame queue elements
 855 */
 856 define nat44_ei_show_fq_options_reply
 857 {
 858   option in_progress;
 859   u32 context;
 860   i32 retval;
 861   u32 frame_queue_nelts;
 862 };