resources/libraries/python/Routing.py

   1 # Copyright (c) 2016 Cisco and/or its affiliates.
   2 # Licensed under the Apache License, Version 2.0 (the "License");
   3 # you may not use this file except in compliance with the License.
   4 # You may obtain a copy of the License at:
   5 #
   6 #     http://www.apache.org/licenses/LICENSE-2.0
   7 #
   8 # Unless required by applicable law or agreed to in writing, software
   9 # distributed under the License is distributed on an "AS IS" BASIS,
  10 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  11 # See the License for the specific language governing permissions and
  12 # limitations under the License.
  13
  14 """Routing utilities library."""
  15
  16 from resources.libraries.python.VatExecutor import VatTerminal
  17 from resources.libraries.python.topology import Topology
  18
  19
  20 class Routing(object):
  21     """Routing utilities."""
  22
  23     @staticmethod
  24     def vpp_route_add(node, network, prefix_len, gateway=None, interface=None,
  25                       use_sw_index=True, resolve_attempts=10):
  26         """Add route to the VPP node.
  27
  28         :param node: Node to add route on.
  29         :param network: Route destination network address.
  30         :param prefix_len: Route destination network prefix length.
  31         :param gateway: Route gateway address.
  32         :param interface: Route interface.
  33         :param use_sw_index: Use sw_if_index in VAT command.
  34         :param resolve_attempts: Resolve attempts IP route add parameter.
  35         If None, then is not used.
  36         :type node: dict
  37         :type network: str
  38         :type prefix_len: int
  39         :type gateway: str
  40         :type interface: str
  41         :type use_sw_index: bool
  42         :type resolve_attempts: int
  43         """
  44         if use_sw_index:
  45             int_cmd = ('sw_if_index {}'.
  46                        format(Topology.get_interface_sw_index(node, interface)))
  47         else:
  48             int_cmd = interface
  49
  50         rap = 'resolve-attempts {}'.format(resolve_attempts) \
  51             if resolve_attempts else ''
  52
  53         via = 'via {}'.format(gateway) if gateway else ''
  54
  55         with VatTerminal(node) as vat:
  56             vat.vat_terminal_exec_cmd_from_template('add_route.vat',
  57                                                     network=network,
  58                                                     prefix_length=prefix_len,
  59                                                     via=via,
  60                                                     interface=int_cmd,
  61                                                     resolve_attempts=rap)
  62
  63     @staticmethod
  64     def add_fib_table(node, network, prefix_len, fib_id, place):
  65         """Create new FIB table according to ID.
  66
  67         :param node: Node to add FIB on.
  68         :param network: IP address to add to the FIB table.
  69         :param prefix_len: IP address prefix length.
  70         :param fib_id: FIB table ID.
  71         :param place: Possible variants are local, drop.
  72         :type node: dict
  73         :type network: str
  74         :type prefix_len: int
  75         :type fib_id: int
  76         :type place: str
  77         """
  78         with VatTerminal(node) as vat:
  79             vat.vat_terminal_exec_cmd_from_template('add_fib_table.vat',
  80                                                     network=network,
  81                                                     prefix_length=prefix_len,
  82                                                     fib_number=fib_id,
  83                                                     where=place)