fib: fib api updates - vpp - Vector Packet Processing

diff options

author	Neale Ranns <neale.ranns@cisco.com>	2018-05-01 05:17:55 -0700
committer	Ole Trøan <otroan@employees.org>	2019-06-18 13:31:39 +0000
commit	097fa66b986f06281f603767d321ab13ab6c88c3 (patch)
tree	ed052819615d08ee4bd0afbc34de7e64e4598105 /src/vnet/geneve
parent	39baa32186fd3e4b20d9f58afbbfe7b8daebed62 (diff)

fib: fib api updates

Enhance the route add/del APIs to take a set of paths rather than just one. Most unicast routing protocols calcualte all the available paths in one run of the algorithm so updating all the paths at once is beneficial for the client. two knobs control the behaviour: is_multipath - if set the the set of paths passed will be added to those that already exist, otherwise the set will replace them. is_add - add or remove the set is_add=0, is_multipath=1 and an empty set, results in deleting the route. It is also considerably faster to add multiple paths at once, than one at a time: vat# ip_add_del_route 1.1.1.1/32 count 100000 multipath via 10.10.10.11 100000 routes in .572240 secs, 174751.80 routes/sec vat# ip_add_del_route 1.1.1.1/32 count 100000 multipath via 10.10.10.12 100000 routes in .528383 secs, 189256.54 routes/sec vat# ip_add_del_route 1.1.1.1/32 count 100000 multipath via 10.10.10.13 100000 routes in .757131 secs, 132077.52 routes/sec vat# ip_add_del_route 1.1.1.1/32 count 100000 multipath via 10.10.10.14 100000 routes in .878317 secs, 113854.12 routes/sec vat# ip_route_add_del 1.1.1.1/32 count 100000 multipath via 10.10.10.11 via 10.10.10.12 via 10.10.10.13 via 10.10.10.14 100000 routes in .900212 secs, 111084.93 routes/sec Change-Id: I416b93f7684745099c1adb0b33edac58c9339c1a Signed-off-by: Neale Ranns <neale.ranns@cisco.com> Signed-off-by: Ole Troan <ot@cisco.com> Signed-off-by: Paul Vinciguerra <pvinci@vinciconsulting.com>

Diffstat (limited to 'src/vnet/geneve')

-rw-r--r--

src/vnet/geneve/geneve.c

1 files changed, 5 insertions, 7 deletions

/* * Copyright (c) 2017 Cisco and/or its affiliates. * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** \file This file defines vpe control-plane API messages for the bonding device driver */ option version = "2.1.0"; import "vnet/interface_types.api"; import "vnet/ethernet/ethernet_types.api"; enum bond_mode { BOND_API_MODE_ROUND_ROBIN = 1, BOND_API_MODE_ACTIVE_BACKUP = 2, BOND_API_MODE_XOR = 3, BOND_API_MODE_BROADCAST = 4, BOND_API_MODE_LACP = 5, }; enum bond_lb_algo { BOND_API_LB_ALGO_L2 = 0, BOND_API_LB_ALGO_L34 = 1, BOND_API_LB_ALGO_L23 = 2, BOND_API_LB_ALGO_RR = 3, BOND_API_LB_ALGO_BC = 4, BOND_API_LB_ALGO_AB = 5, }; /** \brief Initialize a new bond interface with the given paramters @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param id - if non-~0, specifies a custom interface ID @param use_custom_mac - if set, mac_address is valid @param mac_address - mac addr to assign to the interface if use_custom_mac is set @param mode - mode, required (1=round-robin, 2=active-backup, 3=xor, 4=broadcast, 5=lacp) @param lb - load balance, optional (0=l2, 1=l34, 2=l23) valid for xor and lacp modes. Otherwise ignored @param numa_only - if numa_only is set, pkts will be transmitted by LAG members on local numa node only if have at least one, otherwise it works as usual. */ define bond_create { option deprecated; u32 client_index; u32 context; u32 id [default=0xFFFFFFFF]; bool use_custom_mac; vl_api_mac_address_t mac_address; vl_api_bond_mode_t mode; vl_api_bond_lb_algo_t lb; bool numa_only; }; /** \brief Reply for bond create reply @param context - returned sender context, to match reply w/ request @param retval - return code @param sw_if_index - software index allocated for the new tap interface */ define bond_create_reply { u32 context; i32 retval; vl_api_interface_index_t sw_if_index; }; /** \brief Initialize a new bond interface with the given paramters @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param mode - mode, required (1=round-robin, 2=active-backup, 3=xor, 4=broadcast, 5=lacp) @param lb - load balance, optional (0=l2, 1=l34, 2=l23) valid for xor and lacp modes. Otherwise ignored (default=l2) @param numa_only - if numa_only is set, pkts will be transmitted by LAG members on local numa node only if have at least one, otherwise it works as usual. @param enable_gso - enable gso support (default 0) @param use_custom_mac - if set, mac_address is valid @param mac_address - mac addr to assign to the interface if use_custom_mac is set @param id - if non-~0, specifies a custom interface ID (default=0xFFFFFFFF) */ define bond_create2 { u32 client_index; u32 context; vl_api_bond_mode_t mode; vl_api_bond_lb_algo_t lb; bool numa_only; bool enable_gso; bool use_custom_mac; vl_api_mac_address_t mac_address; u32 id [default=0xFFFFFFFF]; }; /** \brief Reply for bond create2 reply @param context - returned sender context, to match reply w/ request @param retval - return code @param sw_if_index - software index allocated for the new tap interface */ define bond_create2_reply { u32 context; i32 retval; vl_api_interface_index_t sw_if_index; }; /** \brief Delete bond interface @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - interface index of member interface */ autoreply define bond_delete { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief Initialize a new bond interface with the given paramters @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - slave sw_if_index @param bond_sw_if_index - bond sw_if_index @param is_passive - interface does not initiate the lacp protocol, remote must be active speaker @param is_long_timeout - 90 seconds vs default 3 seconds neighbor timeout */ define bond_enslave { option deprecated; u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; vl_api_interface_index_t bond_sw_if_index; bool is_passive; bool is_long_timeout; }; /** \brief Reply for bond enslave reply @param context - returned sender context, to match reply w/ request @param retval - return code */ define bond_enslave_reply { u32 context; i32 retval; }; /** \brief Initialize a new bond interface with the given paramters @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - member sw_if_index @param bond_sw_if_index - bond sw_if_index @param is_passive - interface does not initiate the lacp protocol, remote must be active speaker @param is_long_timeout - 90 seconds vs default 3 seconds neighbor timeout */ define bond_add_member { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; vl_api_interface_index_t bond_sw_if_index; bool is_passive; bool is_long_timeout; }; /** \brief Reply for bond add_member reply @param context - returned sender context, to match reply w/ request @param retval - return code */ define bond_add_member_reply { u32 context; i32 retval; }; /** \brief bond detach slave @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - interface index of member interface */ autoreply define bond_detach_slave { option deprecated; u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief bond detach member @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - interface index of member interface */ autoreply define bond_detach_member { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief Dump bond interfaces request */ define sw_interface_bond_dump { option deprecated; u32 client_index; u32 context; }; /** \brief Reply for bond dump request @param sw_if_index - software index of bond interface @param id - ID of interface @param interface_name - name of interface @param mode - bonding mode @param lb - load balance algo @param numa_only - enable local numa TX for lacp mode @param active_slaves - active member count @param slaves - config member count */ define sw_interface_bond_details { u32 context; vl_api_interface_index_t sw_if_index; u32 id; vl_api_bond_mode_t mode; vl_api_bond_lb_algo_t lb; bool numa_only; u32 active_slaves; u32 slaves; string interface_name[64]; }; /** \brief Dump bond interfaces request */ define sw_bond_interface_dump { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index [default=0xffffffff]; }; /** \brief Reply for bond dump request @param sw_if_index - software index of bond interface @param id - ID of interface @param mode - bonding mode @param lb - load balance algo @param numa_only - enable local numa TX for lacp mode @param active_members - active members count @param members - config member count @param interface_name - name of interface */ define sw_bond_interface_details { u32 context; vl_api_interface_index_t sw_if_index; u32 id; vl_api_bond_mode_t mode; vl_api_bond_lb_algo_t lb; bool numa_only; u32 active_members; u32 members; string interface_name[64]; }; /** \brief bond slave dump @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - interface index of bond interface */ define sw_interface_slave_dump { option deprecated; u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief Reply for slave dump request @param sw_if_index - software index of slave interface @param interface_name - name of interface @param is_passve - interface does not initiate the lacp protocol, remote must be active speaker @param is_long_timeout - 90 seconds vs default 3 seconds neighbor timeout @param is_local_numa - the slave interface is local numa @param weight - the weight for the slave interface (active-backup mode only) */ define sw_interface_slave_details { u32 context; vl_api_interface_index_t sw_if_index; string interface_name[64]; bool is_passive; bool is_long_timeout; bool is_local_numa; u32 weight; }; /** \brief bond member dump @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - interface index of bond interface */ define sw_member_interface_dump { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief Reply for member dump request @param sw_if_index - software index of member interface @param interface_name - name of interface @param is_passve - interface does not initiate the lacp protocol, remote must be active speaker @param is_long_timeout - 90 seconds vs default 3 seconds neighbor timeout @param is_local_numa - the member interface is local numa @param weight - the weight for the member interface (active-backup mode only) */ define sw_member_interface_details { u32 context; vl_api_interface_index_t sw_if_index; string interface_name[64]; bool is_passive; bool is_long_timeout; bool is_local_numa; u32 weight; }; /** \brief Interface set bond weight @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - member interface for which to set the weight @param weight - weight value to be set for the member interface */ autoreply define sw_interface_set_bond_weight { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; u32 weight; }; /* * Local Variables: * eval: (c-set-style "gnu") * End: */


context:
space:
mode: