2.110. vpp_papi_provider module¶
-
class
vpp_papi_provider.
BRIDGE_FLAGS
¶ -
ARP_TERM
= 16¶
-
FLOOD
= 4¶
-
FWD
= 2¶
-
LEARN
= 1¶
-
NONE
= 0¶
-
UU_FLOOD
= 8¶
-
-
class
vpp_papi_provider.
L2_VTR_OP
¶ -
L2_DISABLED
= 0¶
-
L2_POP_1
= 3¶
-
L2_POP_2
= 4¶
-
L2_PUSH_1
= 1¶
-
L2_PUSH_2
= 2¶
-
L2_TRANSLATE_1_1
= 5¶
-
L2_TRANSLATE_1_2
= 6¶
-
L2_TRANSLATE_2_1
= 7¶
-
L2_TRANSLATE_2_2
= 8¶
-
-
exception
vpp_papi_provider.
UnexpectedApiReturnValueError
¶ Bases:
exceptions.Exception
exception raised when the API return value is unexpected
-
class
vpp_papi_provider.
VppPapiProvider
(name, shm_prefix, test_class, read_timeout)¶ Bases:
object
VPP-api provider using vpp-papi
@property hook: hook object providing before and after api/cli hooks
-
abf_itf_attach_add_del
(is_add, attach)¶
-
abf_itf_attach_dump
()¶
-
abf_policy_add_del
(is_add, policy)¶
-
abf_policy_dump
()¶
-
acl_add_replace
(acl_index, r, tag='', expected_retval=0)¶ Add/replace an ACL :param int acl_index: ACL index to replace, 2^32-1 to create new ACL. :param acl_rule r: ACL rules array. :param str tag: symbolic tag (description) for this ACL. :param int count: number of rules.
-
acl_del
(acl_index, expected_retval=0)¶ Parameters: acl_index – Returns:
-
acl_dump
(acl_index, expected_retval=0)¶
-
acl_interface_add_del
(sw_if_index, acl_index, is_add=1)¶ Add/Delete ACL to/from interface
Parameters: - sw_if_index –
- acl_index –
- is_add – (Default value = 1)
-
acl_interface_list_dump
(sw_if_index=4294967295, expected_retval=0)¶
-
acl_interface_set_acl_list
(sw_if_index, n_input, acls, expected_retval=0)¶
-
acl_interface_set_etype_whitelist
(sw_if_index, n_input, whitelist, expected_retval=0)¶
-
add_node_next
(node_name, next_name)¶ Set the next node for a given node request
Parameters: - node_name –
- next_name –
-
api
(api_fn, api_args, expected_retval=0)¶ Call API function and check it’s return value. Call the appropriate hooks before and after the API call
Parameters: - api_fn – API function to call
- api_args – tuple of API function arguments
- expected_retval – Expected return value (Default value = 0)
Returns: reply from the API
-
app_namespace_add
(namespace_id, ip4_fib_id=0, ip6_fib_id=0, sw_if_index=4294967295, secret=0)¶
-
bd_ip_mac_add_del
(bd_id, mac, ip, is_ipv6=0, is_add=1)¶
-
bfd_auth_del_key
(conf_key_id)¶
-
bfd_auth_keys_dump
()¶
-
bfd_auth_set_key
(conf_key_id, auth_type, key)¶
-
bfd_udp_add
(sw_if_index, desired_min_tx, required_min_rx, detect_mult, local_addr, peer_addr, is_ipv6=0, bfd_key_id=None, conf_key_id=None)¶
-
bfd_udp_auth_activate
(sw_if_index, local_addr, peer_addr, is_ipv6=0, bfd_key_id=None, conf_key_id=None, is_delayed=False)¶
-
bfd_udp_auth_deactivate
(sw_if_index, local_addr, peer_addr, is_ipv6=0, is_delayed=False)¶
-
bfd_udp_del
(sw_if_index, local_addr, peer_addr, is_ipv6=0)¶
-
bfd_udp_del_echo_source
()¶
-
bfd_udp_get_echo_source
()¶
-
bfd_udp_mod
(sw_if_index, desired_min_tx, required_min_rx, detect_mult, local_addr, peer_addr, is_ipv6=0)¶
-
bfd_udp_session_dump
()¶
-
bfd_udp_session_set_flags
(admin_up_down, sw_if_index, local_addr, peer_addr, is_ipv6=0)¶
-
bfd_udp_set_echo_source
(sw_if_index)¶
-
bier_disp_entry_add_del
(bdti, bp, payload_proto, next_hop_afi, next_hop, next_hop_tbl_id=0, next_hop_rpf_id=-1, next_hop_is_ip4=1, is_add=1)¶ BIER Route add/del
-
bier_disp_entry_dump
(bdti)¶
-
bier_disp_table_add_del
(bdti, is_add=1)¶ BIER Disposition Table add/del
-
bier_disp_table_dump
()¶
-
bier_imp_add
(bti, src, ibytes, is_add=1)¶ BIER Imposition Add
-
bier_imp_del
(bi_index)¶ BIER Imposition del
-
bier_imp_dump
()¶
-
bier_route_add_del
(bti, bp, paths, is_add=1, is_replace=0)¶ BIER Route add/del
-
bier_route_dump
(bti)¶
-
bier_table_add_del
(bti, mpls_label, is_add=1)¶ BIER Table add/del
-
bier_table_dump
()¶
-
bond_create
(mode, lb, use_custom_mac, mac_address='')¶ Parameters: - mode – mode
- lb – load balance
- use_custom_mac – use custom mac
- mac_address – mac address
-
bond_delete
(sw_if_index)¶ Parameters: sw_if_index – interface the operation is applied to
-
bond_detach_slave
(sw_if_index)¶ Parameters: sw_if_index – slave interface the operation is applied to
-
bond_enslave
(sw_if_index, bond_sw_if_index, is_passive, is_long_timeout)¶ Parameters: - sw_if_index – slave sw_if_index
- bond_sw_if_index – bond sw_if_index
- is_passive – is passive lacp speaker
- is_long_time – 90 seconds timeout instead of 3 seconds timeout
-
bridge_domain_add_del
(bd_id, flood=1, uu_flood=1, forward=1, learn=1, arp_term=0, is_add=1)¶ Create/delete bridge domain.
Parameters: - bd_id (int) – Bridge domain index.
- flood (int) – Enable/disable bcast/mcast flooding in the BD. (Default value = 1)
- uu_flood (int) – Enable/disable unknown unicast flood in the BD. (Default value = 1)
- forward (int) – Enable/disable forwarding on all interfaces in the BD. (Default value = 1)
- learn (int) – Enable/disable learning on all interfaces in the BD. (Default value = 1)
- arp_term (int) – Enable/disable arp termination in the BD. (Default value = 1)
- is_add (int) – Add or delete flag. (Default value = 1)
-
bridge_domain_dump
(bd_id=0)¶ Parameters: bd_id (int) – Bridge domain ID. (Default value = 0 => dump of all existing bridge domains returned) Returns: Dictionary of bridge domain(s) data.
-
bridge_flags
(bd_id, is_set, feature_bitmap)¶ Enable/disable required feature of the bridge domain with defined ID.
Parameters: - bd_id (int) – Bridge domain ID.
- is_set (int) – Set to 1 to enable, set to 0 to disable the feature.
- flags (int) – Bitmap value of the feature to be set: - learn (1 << 0), - forward (1 << 1), - flood (1 << 2), - uu-flood (1 << 3) or - arp-term (1 << 4).
-
classify_add_del_session
(is_add, table_index, match, opaque_index=4294967295, hit_next_index=4294967295, advance=0, action=0, metadata=0)¶ Parameters: - is_add –
- table_index –
- match –
- opaque_index – (Default value = 0xFFFFFFFF)
- hit_next_index – (Default value = 0xFFFFFFFF)
- advance – (Default value = 0)
- action – (Default value = 0)
- metadata – (Default value = 0)
-
classify_add_del_table
(is_add, mask, match_n_vectors=1, table_index=4294967295, nbuckets=2, memory_size=2097152, skip_n_vectors=0, next_table_index=4294967295, miss_next_index=4294967295, current_data_flag=0, current_data_offset=0)¶ Parameters: - is_add –
- mask –
- match_n_vectors – (Default value = 1)
- table_index – (Default value = 0xFFFFFFFF)
- nbuckets – (Default value = 2)
- memory_size – (Default value = 2097152)
- skip_n_vectors – (Default value = 0)
- next_table_index – (Default value = 0xFFFFFFFF)
- miss_next_index – (Default value = 0xFFFFFFFF)
- current_data_flag – (Default value = 0)
- current_data_offset – (Default value = 0)
-
cli
(cli)¶ Execute a CLI, calling the before/after hooks appropriately.
Parameters: cli – CLI to execute Returns: CLI output
-
collect_events
()¶ Collect all events from the internal queue and clear the queue.
-
connect
()¶ Connect the API to VPP
-
control_ping
()¶
-
create_loopback
(mac='')¶ Parameters: mac – (Optional)
-
create_p2pethernet_subif
(sw_if_index, remote_mac, subif_id)¶ Create p2p ethernet subinterface
Parameters: - sw_if_index – main (parent) interface
- remote_mac – client (remote) mac address
-
create_subif
(sw_if_index, sub_id, outer_vlan, inner_vlan, no_tags=0, one_tag=0, two_tags=0, dot1ad=0, exact_match=0, default_sub=0, outer_vlan_id_any=0, inner_vlan_id_any=0)¶ Create subinterface from vpe.api: set dot1ad = 0 for dot1q, set dot1ad = 1 for dot1ad
Parameters: - sub_id – param inner_vlan:
- sw_if_index –
- outer_vlan –
- inner_vlan –
- no_tags – (Default value = 0)
- one_tag – (Default value = 0)
- two_tags – (Default value = 0)
- dot1ad – (Default value = 0)
- exact_match – (Default value = 0)
- default_sub – (Default value = 0)
- outer_vlan_id_any – (Default value = 0)
- inner_vlan_id_any – (Default value = 0)
-
create_vhost_user_if
(is_server, sock_filename, renumber, disable_mrg_rxbuf, disable_indirect_desc, custom_dev_instance, use_custom_mac, mac_address, tag='')¶ Parameters: - is_server – is server
- sock_filename – socket name
- renumber – renumber
- disable_mrg_rxbuf – disable mergable rx buffers
- disable_indirect_desc – disable indirect descriptors
- custom_dev_instance – custom dev instance
- use_custom_mac – use custom mac
- mac_address – mac address
- tag – tag (default ‘’)
-
create_vlan_subif
(sw_if_index, vlan)¶ Parameters: - vlan –
- sw_if_index –
-
delete_loopback
(sw_if_index)¶
-
delete_p2pethernet_subif
(sw_if_index, remote_mac)¶ Delete p2p ethernet subinterface
Parameters: - sw_if_index – main (parent) interface
- remote_mac – client (remote) mac address
-
delete_subif
(sw_if_index)¶ Delete subinterface
Parameters: sw_if_index –
-
delete_vhost_user_if
(sw_if_index)¶ Parameters: sw_if_index – interface the operation is applied to
-
dhcp6_client_enable_disable
(sw_if_index, prefix_group='', enable=1)¶
-
dhcp6_clients_enable_disable
(enable=1)¶
-
dhcp6_pd_client_enable_disable
(sw_if_index, prefix_group='', enable=1)¶
-
dhcp6_pd_send_client_message
(msg_type, sw_if_index, T1, T2, prefixes, server_index=4294967295, irt=0, mrt=0, mrc=1, mrd=0, stop=0)¶
-
dhcp6_send_client_message
(msg_type, sw_if_index, T1, T2, addresses, server_index=4294967295, irt=0, mrt=0, mrc=1, mrd=0, stop=0)¶
-
dhcp_client
(sw_if_index, hostname, client_id='', is_add=1, set_broadcast_flag=1, want_dhcp_events=0)¶
-
dhcp_client_dump
()¶
-
dhcp_proxy_config
(dhcp_server, dhcp_src_address, rx_table_id=0, server_table_id=0, is_add=1, is_ipv6=0)¶
-
dhcp_proxy_set_vss
(table_id, vss_type=255, vpn_ascii_id='', oui=0, vpn_index=0, is_add=1, is_ip6=0)¶
-
disconnect
()¶ Disconnect the API from VPP
-
dslite_add_del_pool_addr_range
(start_addr, end_addr, is_add=1)¶ Add/del address range to DS-Lite pool
Parameters: - start_addr – First IP address
- end_addr – Last IP address
- is_add – 1 if add, 0 if delete (Default value = 1)
-
dslite_set_aftr_addr
(ip6, ip4)¶ Set DS-Lite AFTR addresses
Parameters: - ip4 – IPv4 address
- ip6 – IPv6 address
-
dslite_set_b4_addr
(ip6, ip4)¶ Set DS-Lite B4 IPv6 address
Parameters: - ip4 – IPv4 address
- ip6 – IPv6 address
-
expect_negative_api_retval
()¶ Expect API failure
-
expect_zero_api_retval
()¶ Expect API success
-
gbp_contract_add_del
(is_add, src_epg, dst_epg, acl_index)¶ GBP contract Add/Del
-
gbp_contract_dump
()¶ GBP contract Dump
-
gbp_endpoint_add
(sw_if_index, ips, mac, epg)¶ GBP endpoint Add
-
gbp_endpoint_del
(handle)¶ GBP endpoint Del
-
gbp_endpoint_dump
()¶ GBP endpoint Dump
-
gbp_endpoint_group_add_del
(is_add, epg, bd, ip4_rd, ip6_rd, uplink_sw_if_index)¶ GBP endpoint group Add/Del
-
gbp_endpoint_group_dump
()¶ GBP endpoint group Dump
-
gbp_recirc_add_del
(is_add, sw_if_index, epg, is_ext)¶ GBP recirc Add/Del
-
gbp_recirc_dump
()¶ GBP recirc Dump
-
gbp_subnet_add_del
(is_add, table_id, is_internal, prefix, sw_if_index=4294967295, epg_id=65535, is_ip6=False)¶ GBP Subnet Add/Del
-
gbp_subnet_dump
()¶ GBP Subnet Dump
-
geneve_add_del_tunnel
(local_addr, remote_addr, mcast_sw_if_index=4294967295, is_add=1, is_ipv6=0, encap_vrf_id=0, decap_next_index=4294967295, vni=0)¶ Parameters: - remote_addr –
- local_addr –
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- encap_vrf_id – (Default value = 0)
- decap_next_index – (Default value = 0xFFFFFFFF)
- mcast_sw_if_index – (Default value = 0xFFFFFFFF)
- vni – (Default value = 0)
-
gre_tunnel_add_del
(src_address, dst_address, outer_fib_id=0, tunnel_type=0, instance=4294967295, session_id=0, is_add=1, is_ip6=0)¶ Add a GRE tunnel
Parameters: - src_address –
- dst_address –
- outer_fib_id – (Default value = 0)
- tunnel_type – (Default value = 0)
- instance – (Default value = 0xFFFFFFFF)
- session_id – (Defalt value = 0)
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
-
gtpu_add_del_tunnel
(src_addr, dst_addr, is_add=1, is_ipv6=0, mcast_sw_if_index=4294967295, encap_vrf_id=0, decap_next_index=4294967295, teid=0)¶ Parameters: - is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- src_addr –
- dst_addr –
- mcast_sw_if_index – (Default value = 0xFFFFFFFF)
- encap_vrf_id – (Default value = 0)
- decap_next_index – (Default value = 0xFFFFFFFF)
- teid – (Default value = 0)
-
igmp_clear_interface
(sw_if_index)¶ Remove all (S,G)s from specified interface doesn’t send IGMP report!
-
igmp_dump
(sw_if_index=None)¶ Dump all (S,G) interface configurations
-
igmp_enable_disable
(sw_if_index, enable, host)¶ Enable/disable IGMP on a given interface
-
igmp_listen
(filter, sw_if_index, saddrs, gaddr)¶ Listen for new (S,G) on specified interface
Parameters: - enable – add/del
- sw_if_index – interface sw index
- saddr – source ip4 addr
- gaddr – group ip4 addr
-
input_acl_set_interface
(is_add, sw_if_index, ip4_table_index=4294967295, ip6_table_index=4294967295, l2_table_index=4294967295)¶ Parameters: - is_add –
- sw_if_index –
- ip4_table_index – (Default value = 0xFFFFFFFF)
- ip6_table_index – (Default value = 0xFFFFFFFF)
- l2_table_index – (Default value = 0xFFFFFFFF)
-
ip6_add_del_address_using_prefix
(sw_if_index, address, prefix_length, prefix_group, is_add=1)¶
-
ip6_fib_dump
()¶
-
ip6_mfib_dump
()¶
-
ip6_nd_address_autoconfig
(sw_if_index, enable, install_default_routes)¶
-
ip6_nd_proxy
(address, sw_if_index, is_del=0)¶
-
ip6_sw_interface_enable_disable
(sw_if_index, enable)¶ Enable/Disable An interface for IPv6
-
ip6_sw_interface_ra_config
(sw_if_index, no, suppress, send_unicast)¶
-
ip6_sw_interface_ra_prefix
(sw_if_index, address, address_length, use_default=0, no_advertise=0, off_link=0, no_autoconfig=0, no_onlink=0, is_no=0, val_lifetime=4294967295, pref_lifetime=4294967295)¶
-
ip6nd_send_router_solicitation
(sw_if_index, irt=1, mrt=120, mrc=0, mrd=0)¶
-
ip_add_del_route
(dst_address, dst_address_length, next_hop_address, next_hop_sw_if_index=4294967295, table_id=0, next_hop_table_id=0, next_hop_weight=1, next_hop_n_out_labels=0, next_hop_out_label_stack=[], next_hop_via_label=1048576, next_hop_id=4294967295, is_resolve_host=0, is_resolve_attached=0, classify_table_index=4294967295, is_add=1, is_drop=0, is_unreach=0, is_prohibit=0, is_ipv6=0, is_local=0, is_classify=0, is_multipath=0, is_dvr=0, is_udp_encap=0, is_source_lookup=0)¶ Parameters: - dst_address_length –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- dst_address –
- next_hop_address –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- vrf_id – (Default value = 0)
- lookup_in_vrf – (Default value = 0)
- classify_table_index – (Default value = 0xFFFFFFFF)
- is_add – (Default value = 1)
- is_drop – (Default value = 0)
- is_ipv6 – (Default value = 0)
- is_local – (Default value = 0)
- is_classify – (Default value = 0)
- is_multipath – (Default value = 0)
- is_resolve_host – (Default value = 0)
- is_resolve_attached – (Default value = 0)
- is_dvr – (Default value = 0)
- is_source_lookup – (Default value = 0)
- next_hop_weight – (Default value = 1)
-
ip_dump
(is_ipv6=0)¶ Return IP dump.
Parameters: is_ipv6 (int) – 1 for IPv6 neighbor, 0 for IPv4. (Default = 0)
-
ip_fib_dump
()¶
-
ip_mfib_dump
()¶
-
ip_mroute_add_del
(src_address, grp_address, grp_address_length, e_flags, next_hop_afi, next_hop_sw_if_index, next_hop_address, i_flags, bier_imp=0, rpf_id=0, table_id=0, is_add=1, is_ipv6=0, is_local=0)¶ IP Multicast Route add/del
-
ip_neighbor_add_del
(sw_if_index, mac_address, dst_address, is_add=1, is_ipv6=0, is_static=0, is_no_adj_fib=0)¶ Add neighbor MAC to IPv4 or IPv6 address.
Parameters: - sw_if_index –
- mac_address –
- dst_address –
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- is_static – (Default value = 0)
- is_no_adj_fib – (Default value = 0)
-
ip_neighbor_dump
(sw_if_index, is_ipv6=0)¶ Return IP neighbor dump.
Parameters: - sw_if_index –
- is_ipv6 (int) – 1 for IPv6 neighbor, 0 for IPv4. (Default = 0)
-
ip_punt_police
(policer_index, is_ip6=0, is_add=1)¶
-
ip_punt_redirect
(rx_sw_if_index, tx_sw_if_index, nh, is_ip6=0, is_add=1)¶
-
ip_reassembly_enable_disable
(sw_if_index, enable_ip4=False, enable_ip6=False)¶ Enable/disable IP reassembly
-
ip_reassembly_get
(is_ip6=0)¶ Get IP reassembly parameters
-
ip_reassembly_set
(timeout_ms, max_reassemblies, expire_walk_interval_ms, is_ip6=0)¶ Set IP reassembly parameters
-
ip_table_add_del
(table_id, is_add=1, is_ipv6=0)¶ :param table_id :param is_add: (Default value = 1) :param is_ipv6: (Default value = 0)
-
ip_unnumbered_dump
(sw_if_index=4294967295)¶
-
ipip_6rd_add_tunnel
(ip6_table_id, ip6_prefix, ip6_prefix_len, ip4_table_id, ip4_prefix, ip4_prefix_len, ip4_src, security_check)¶ 6RD tunnel Add
-
ipip_6rd_del_tunnel
(sw_if_index)¶ 6RD tunnel Delete
-
ipip_add_tunnel
(src_address, dst_address, is_ipv6=1, instance=4294967295, table_id=0, tc_tos=0)¶ IPIP tunnel Add/Del
-
ipip_del_tunnel
(sw_if_index)¶ IPIP tunnel Delete
-
ipsec_interface_add_del_spd
(spd_id, sw_if_index, is_add=1)¶ IPSEC interface SPD add/del - Wrapper to associate/disassociate SPD to interface in VPP Sample CLI : ‘set interface ipsec spd GigabitEthernet0/6/0 1’
:param spd_id - SPD ID to associate with the interface . mandatory :param sw_if_index - Interface Index which needs to ipsec association mandatory :param is_add - add(1) or del(0) association with interface (Default 1 - add) . optional :returns: reply from the API
-
ipsec_sad_add_del_entry
(sad_id, spi, integrity_algorithm, integrity_key, crypto_algorithm, crypto_key, protocol, tunnel_src_address='', tunnel_dst_address='', is_tunnel=1, is_tunnel_ipv6=0, is_add=1, udp_encap=0)¶ IPSEC SA add/del :param sad_id: security association ID :param spi: security param index of the SA in decimal :param integrity_algorithm: :param integrity_key: :param crypto_algorithm: :param crypto_key: :param protocol: AH(0) or ESP(1) protocol :param tunnel_src_address: tunnel mode outer src address :param tunnel_dst_address: tunnel mode outer dst address :param is_add: :param is_tunnel: :** reference /vpp/src/vnet/ipsec/ipsec.h file for enum values of
crypto and ipsec algorithms
-
ipsec_spd_add_del
(spd_id, is_add=1)¶ SPD add/del - Wrapper to add or del ipsec SPD Sample CLI : ‘ipsec spd add 1’
:param spd_id - SPD ID to be created in the vpp . mandatory :param is_add - create (1) or delete(0) SPD (Default 1 - add) .
optionalReturns: reply from the API
-
ipsec_spd_add_del_entry
(spd_id, sa_id, local_address_start, local_address_stop, remote_address_start, remote_address_stop, local_port_start=0, local_port_stop=65535, remote_port_start=0, remote_port_stop=65535, protocol=0, policy=0, priority=100, is_outbound=1, is_add=1, is_ipv6=0, is_ip_any=0)¶ - IPSEC policy SPD add/del -
- Wrapper to configure ipsec SPD policy entries in VPP
Parameters: - spd_id – SPD ID for the policy
- local_address_start – local-ip-range start address
:param local_address_stop : local-ip-range stop address :param remote_address_start: remote-ip-range start address :param remote_address_stop : remote-ip-range stop address :param local_port_start: (Default value = 0) :param local_port_stop: (Default value = 65535) :param remote_port_start: (Default value = 0) :param remote_port_stop: (Default value = 65535) :param protocol: Any(0), AH(51) & ESP(50) protocol (Default value = 0) :param sa_id: Security Association ID for mapping it to SPD :param policy: bypass(0), discard(1), resolve(2) or protect(3) action
(Default value = 0)Parameters: - priority – value for the spd action (Default value = 100)
- is_outbound – flag for inbound(0) or outbound(1) (Default value = 1)
- is_add – (Default value = 1)
-
ipsec_tunnel_if_add_del
(local_ip, remote_ip, local_spi, remote_spi, crypto_alg, local_crypto_key, remote_crypto_key, integ_alg, local_integ_key, remote_integ_key, is_add=1, esn=0, anti_replay=1, renumber=0, show_instance=0)¶
-
l2fib_add_del
(mac, bd_id, sw_if_index, is_add=1, static_mac=0, filter_mac=0, bvi_mac=0)¶ Create/delete L2 FIB entry.
Parameters: - mac (str) – MAC address to create FIB entry for.
- bd_id (int) – Bridge domain index.
- sw_if_index (int) – Software interface index of the interface.
- is_add (int) – Add or delete flag. (Default value = 1)
- static_mac (int) – Set to 1 to create static MAC entry. (Default value = 0)
- filter_mac (int) – Set to 1 to drop packet that’s source or destination MAC address contains defined MAC address. (Default value = 0)
- bvi_mac (int) – Set to 1 to create entry that points to BVI interface. (Default value = 0)
-
l2fib_flush_all
()¶ Flush all L2 FIB.
-
l2fib_flush_bd
(bd_id)¶ Flush L2 FIB entries for bd_id.
Parameters: sw_if_index (int) – Bridge Domain id.
-
l2fib_flush_int
(sw_if_index)¶ Flush L2 FIB entries for sw_if_index.
Parameters: sw_if_index (int) – Software interface index of the interface.
-
lisp_adjacencies_get
(vni=0)¶
-
lisp_adjacency
(leid, reid, leid_len, reid_len, eid_type, is_add=1, vni=0)¶
-
lisp_eid_table_dump
(eid_set=0, prefix_length=0, vni=0, eid_type=0, eid=None, filter_opt=0)¶
-
lisp_enable_disable
(is_enabled)¶
-
lisp_local_mapping
(ls_name, eid_type, eid, prefix_len, vni=0, key_id=0, key='', is_add=1)¶
-
lisp_locator
(ls_name, sw_if_index, priority=1, weight=1, is_add=1)¶
-
lisp_locator_dump
(is_index_set, ls_name=None, ls_index=0)¶
-
lisp_locator_set
(ls_name, is_add=1)¶
-
lisp_locator_set_dump
()¶
-
lisp_remote_mapping
(eid_type, eid, eid_prefix_len=0, vni=0, rlocs=[], rlocs_num=0, is_src_dst=0, is_add=1)¶
-
macip_acl_add
(rules, tag='')¶ Add MACIP acl
Parameters: - rules – list of rules for given acl
- tag – acl tag
-
macip_acl_add_replace
(rules, acl_index=4294967295, tag='')¶ Add MACIP acl
Parameters: - rules – list of rules for given acl
- tag – acl tag
-
macip_acl_del
(acl_index)¶ Parameters: acl_index – Returns:
-
macip_acl_dump
(acl_index=4294967295)¶ Return MACIP acl dump
-
macip_acl_interface_add_del
(sw_if_index, acl_index, is_add=1)¶ Add MACIP acl to interface
Parameters: - sw_if_index –
- acl_index –
- is_add – (Default value = 1)
-
macip_acl_interface_get
()¶ Return interface acls dump
-
map_add_domain
(ip6_prefix, ip6_prefix_len, ip6_src, ip6_src_prefix_len, ip4_prefix, ip4_prefix_len, ea_bits_len=0, psid_offset=0, psid_length=0, is_translation=0, is_rfc6052=0, mtu=1280)¶
-
memif_create
(role, mode, rx_queues=None, tx_queues=None, _id=None, socket_id=None, secret=None, ring_size=None, buffer_size=None, hw_addr=None)¶
-
memif_delete
(sw_if_index)¶
-
memif_dump
()¶
-
memif_socket_filename_add_del
(is_add, socket_id, socket_filename)¶
-
memif_socket_filename_dump
()¶
-
mfib_signal_dump
()¶
-
mpls_fib_dump
()¶
-
mpls_ip_bind_unbind
(label, dst_address, dst_address_length, table_id=0, ip_table_id=0, is_ip4=1, is_bind=1)¶
-
mpls_route_add_del
(label, eos, next_hop_proto, next_hop_address, next_hop_sw_if_index=4294967295, table_id=0, next_hop_table_id=0, next_hop_weight=1, next_hop_n_out_labels=0, next_hop_out_label_stack=[], next_hop_via_label=1048576, is_resolve_host=0, is_resolve_attached=0, is_interface_rx=0, is_rpf_id=0, is_multicast=0, is_add=1, is_drop=0, is_multipath=0, classify_table_index=4294967295, is_classify=0)¶ Parameters: - dst_address_length –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- dst_address –
- next_hop_address –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- vrf_id – (Default value = 0)
- lookup_in_vrf – (Default value = 0)
- classify_table_index – (Default value = 0xFFFFFFFF)
- is_add – (Default value = 1)
- is_drop – (Default value = 0)
- is_ipv6 – (Default value = 0)
- is_local – (Default value = 0)
- is_classify – (Default value = 0)
- is_multipath – (Default value = 0)
- is_multicast – (Default value = 0)
- is_resolve_host – (Default value = 0)
- is_resolve_attached – (Default value = 0)
- next_hop_weight – (Default value = 1)
-
mpls_table_add_del
(table_id, is_add=1)¶ :param table_id :param is_add: (Default value = 1)
-
mpls_tunnel_add_del
(tun_sw_if_index, next_hop_proto_is_ip4, next_hop_address, next_hop_sw_if_index=4294967295, next_hop_table_id=0, next_hop_weight=1, next_hop_n_out_labels=0, next_hop_out_label_stack=[], next_hop_via_label=1048576, is_add=1, l2_only=0, is_multicast=0)¶ Parameters: - dst_address_length –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- dst_address –
- next_hop_address –
- next_hop_sw_if_index – (Default value = 0xFFFFFFFF)
- vrf_id – (Default value = 0)
- lookup_in_vrf – (Default value = 0)
- classify_table_index – (Default value = 0xFFFFFFFF)
- is_add – (Default value = 1)
- is_drop – (Default value = 0)
- is_ipv6 – (Default value = 0)
- is_local – (Default value = 0)
- is_classify – (Default value = 0)
- is_multipath – (Default value = 0)
- is_resolve_host – (Default value = 0)
- is_resolve_attached – (Default value = 0)
- next_hop_weight – (Default value = 1)
- is_multicast – (Default value = 0)
-
mpls_tunnel_dump
(sw_if_index=4294967295)¶
-
nat44_add_del_address_range
(first_ip_address, last_ip_address, is_add=1, vrf_id=4294967295, twice_nat=0)¶ Add/del NAT44 address range
Parameters: - first_ip_address – First IP address
- last_ip_address – Last IP address
- vrf_id – VRF id for the address range
- twice_nat – twice NAT address for extenal hosts
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_add_del_identity_mapping
(ip='0', sw_if_index=4294967295, port=0, addr_only=1, vrf_id=0, protocol=0, tag='', is_add=1)¶ Add/delete NAT44 identity mapping
Parameters: - ip – IP address (Default value = 0)
- sw_if_index – Interface instead of IP address
- port – Port number (Default value = 0)
- addr_only – 1 if address only mapping, 0 if address and port
- vrf_id – VRF ID
- protocol – IP protocol (Default value = 0)
- tag – Opaque string tag
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_add_del_lb_static_mapping
(external_addr, external_port, protocol, twice_nat=0, self_twice_nat=0, out2in_only=0, tag='', affinity=0, local_num=0, locals=[], is_add=1)¶ Add/delete NAT44 load balancing static mapping
Parameters: - twice_nat – 1 if translate external host address and port
- tag – Opaque string tag
- affinity – if 0 disabled, otherwise client IP affinity timeout
:param is_add - 1 if add, 0 if delete
-
nat44_add_del_static_mapping
(local_ip, external_ip=0, external_sw_if_index=4294967295, local_port=0, external_port=0, addr_only=1, vrf_id=0, protocol=0, twice_nat=0, self_twice_nat=0, out2in_only=0, tag='', is_add=1)¶ Add/delete NAT44 static mapping
Parameters: - local_ip – Local IP address
- external_ip – External IP address
- external_sw_if_index – External interface instead of IP address
- local_port – Local port number (Default value = 0)
- external_port – External port number (Default value = 0)
- addr_only – 1 if address only mapping, 0 if address and port
- vrf_id – VRF ID
- protocol – IP protocol (Default value = 0)
- twice_nat – 1 if translate external host address and port
- self_twice_nat – 1 if translate external host address and port whenever external host address equals local address of internal host
- out2in_only – if 1 rule is matching only out2in direction
- tag – Opaque string tag
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_add_interface_addr
(sw_if_index, twice_nat=0, is_add=1)¶ Add/del NAT44 address from interface
Parameters: - sw_if_index – Software index of the interface
- twice_nat – twice NAT address for extenal hosts
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_address_dump
()¶ Dump NAT44 addresses :return: Dictionary of NAT44 addresses
-
nat44_del_session
(addr, port, protocol, vrf_id=0, is_in=1, ext_host_address=None, ext_host_port=0)¶ Delete NAT44 session
Parameters: - addr – IPv4 address
- por – port number
- protocol – IP protocol number
- vrf_id – VRF ID
- is_in – 1 if inside network addres and port pari, 0 if outside
- ext_host_address – external host IPv4 address
- ext_host_port – external host port
-
nat44_forwarding_enable_disable
(enable)¶ Enable/disable forwarding for NAT44
Parameters: enable – 1 for enable, 0 for disable
-
nat44_identity_mapping_dump
()¶ Dump NAT44 identity mappings :return: Dictionary of NAT44 identity mappings
-
nat44_interface_add_del_feature
(sw_if_index, is_inside=1, is_add=1)¶ Enable/disable NAT44 feature on the interface
Parameters: - sw_if_index – Software index of the interface
- is_inside – 1 if inside, 0 if outside (Default value = 1)
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_interface_add_del_output_feature
(sw_if_index, is_inside=1, is_add=1)¶ Enable/disable NAT44 output feature on the interface
Parameters: - sw_if_index – Software index of the interface
- is_inside – 1 if inside, 0 if outside (Default value = 1)
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat44_interface_addr_dump
()¶ Dump NAT44 addresses interfaces :return: Dictionary of NAT44 addresses interfaces
-
nat44_interface_dump
()¶ Dump interfaces with NAT44 feature :return: Dictionary of interfaces with NAT44 feature
-
nat44_interface_output_feature_dump
()¶ Dump interfaces with NAT44 output feature :return: Dictionary of interfaces with NAT44 output feature
-
nat44_lb_static_mapping_dump
()¶ Dump NAT44 load balancing static mappings
Returns: Dictionary of NAT44 load balancing static mapping
-
nat44_static_mapping_dump
()¶ Dump NAT44 static mappings :return: Dictionary of NAT44 static mappings
-
nat44_user_dump
()¶ Dump NAT44 users
Returns: Dictionary of NAT44 users
-
nat44_user_session_dump
(ip_address, vrf_id)¶ Dump NAT44 user’s sessions
Parameters: - ip_address – ip adress of the user to be dumped
- cpu_index – cpu_index on which the user is
- vrf_id – VRF ID
Returns: Dictionary of S-NAT sessions
-
nat64_add_del_interface
(sw_if_index, is_inside=1, is_add=1)¶ Enable/disable NAT64 feature on the interface :param sw_if_index: Index of the interface :param is_inside: 1 if inside, 0 if outside (Default value = 1) :param is_add: 1 if add, 0 if delete (Default value = 1)
-
nat64_add_del_pool_addr_range
(start_addr, end_addr, vrf_id=4294967295, is_add=1)¶ Add/del address range to NAT64 pool
Parameters: - start_addr – First IP address
- end_addr – Last IP address
- vrf_id – VRF id for the address range
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat64_add_del_prefix
(prefix, plen, vrf_id=0, is_add=1)¶ Add/del NAT64 prefix
Parameters: - prefix – NAT64 prefix
- plen – NAT64 prefix length
- vrf_id – VRF id of tenant (Default 0)
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat64_add_del_static_bib
(in_ip, out_ip, in_port, out_port, protocol, vrf_id=0, is_add=1)¶ Add/delete S-NAT static BIB entry
Parameters: - in_ip – Inside IPv6 address
- out_ip – Outside IPv4 address
- in_port – Inside port number
- out_port – Outside port number
- protocol – IP protocol
- vrf_id – VRF ID (Default value = 0)
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat64_add_interface_addr
(sw_if_index, is_add=1)¶ Add/del NAT64 address from interface
Parameters: - sw_if_index – Software index of the interface
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat64_bib_dump
(protocol=255)¶ Dump NAT64 BIB
Parameters: protocol – IP protocol (Default value = 255, all BIBs) Returns: Dictionary of NAT64 BIB entries
-
nat64_get_timeouts
()¶ Get values of timeouts for NAT64
Returns: Timeouts for NAT64 (in seconds)
-
nat64_interface_dump
()¶ Dump interfaces with NAT64 feature :return: Dictionary of interfaces with NAT64 feature
-
nat64_pool_addr_dump
()¶ Dump NAT64 pool addresses :return: Dictionary of NAT64 pool addresses
-
nat64_prefix_dump
()¶ Dump NAT64 prefix
Returns: Dictionary of NAT64 prefixes
-
nat64_set_timeouts
(udp=300, icmp=60, tcp_trans=240, tcp_est=7440, tcp_incoming_syn=6)¶ Set values of timeouts for NAT64 (in seconds)
Parameters: - udpi – UDP timeout (Default value = 300)
- icmp – ICMP timeout (Default value = 60)
- tcp_trans – TCP transitory timeout (Default value = 240)
- tcp_est – TCP established timeout (Default value = 7440)
- tcp_incoming_syn – TCP incoming SYN timeout (Default value = 6)
-
nat64_st_dump
(protocol=255)¶ Dump NAT64 session table
Parameters: protocol – IP protocol (Default value = 255, all STs) Returns: Dictionary of NAT64 sesstion table entries
-
nat66_add_del_interface
(sw_if_index, is_inside=1, is_add=1)¶ Enable/disable NAT66 feature on the interface :param sw_if_index: Index of the interface :param is_inside: 1 if inside, 0 if outside (Default value = 1) :param is_add: 1 if add, 0 if delete (Default value = 1)
-
nat66_add_del_static_mapping
(in_ip, out_ip, vrf_id=0, is_add=1)¶ Add/delete NAT66 static mapping
Parameters: - in_ip – Inside IPv6 address
- out_ip – Outside IPv6 address
- vrf_id – VRF ID (Default value = 0)
- is_add – 1 if add, 0 if delete (Default value = 1)
-
nat66_interface_dump
()¶ Dump interfaces with NAT66 feature :return: Dictionary of interfaces with NAT66 feature
-
nat66_static_mapping_dump
()¶ Dump NAT66 static mappings :return: Dictionary of NAT66 static mappings
-
nat_det_add_del_map
(in_addr, in_plen, out_addr, out_plen, is_add=1)¶ Add/delete deterministic NAT mapping
:param is_add - 1 if add, 0 if delete :param in_addr - inside IP address :param in_plen - inside IP address prefix length :param out_addr - outside IP address :param out_plen - outside IP address prefix length
-
nat_det_close_session_in
(in_addr, in_port, ext_addr, ext_port)¶ Close deterministic NAT session using inside address and port
:param in_addr - inside IP address :param in_port - inside port :param ext_addr - external host IP address :param ext_port - external host port
-
nat_det_close_session_out
(out_addr, out_port, ext_addr, ext_port)¶ Close deterministic NAT session using outside address and port
:param out_addr - outside IP address :param out_port - outside port :param ext_addr - external host IP address :param ext_port - external host port
-
nat_det_forward
(in_addr)¶ Get outside address and port range from inside address
:param in_addr - inside IP address
-
nat_det_map_dump
()¶ Dump deterministic NAT mappings
Returns: Dictionary of deterministic NAT mappings
-
nat_det_reverse
(out_addr, out_port)¶ Get inside address from outside address and port
:param out_addr - outside IP address :param out_port - outside port
-
nat_det_session_dump
(user_addr)¶ Dump deterministic NAT sessions belonging to a user
:param user_addr - inside IP address of the user :return: Dictionary of deterministic NAT sessions
-
nat_get_addr_and_port_alloc_alg
()¶ Get address and port assignment algorithm
-
nat_get_mss_clamping
()¶ Get TCP MSS rewriting configuration
-
nat_get_reass
()¶ Get NAT virtual fragmentation reassembly configuration
Returns: NAT virtual fragmentation reassembly configuration
-
nat_get_timeouts
()¶ Get values of timeouts for NAT sessions
Returns: Timeouts for NAT sessions (in seconds)
-
nat_ipfix
(domain_id=1, src_port=4739, enable=1)¶ Enable/disable NAT IPFIX logging
Parameters: - domain_id – Observation domain ID (Default value = 1)
- src_port – Source port number (Default value = 4739)
- enable – 1 if enable, 0 if disable (Default value = 1)
-
nat_reass_dump
()¶ Dump NAT virtual fragmentation reassemblies
Returns: Dictionary of NAT virtual fragmentation reassemblies
-
nat_set_addr_and_port_alloc_alg
(alg=0, psid_offset=0, psid_length=0, psid=0, start_port=0, end_port=0)¶ Set address and port assignment algorithm
Parameters: - alg – algorithm: 0 - default, 1 - MAP-E, 2 - port range
- psid_offset – number of offset bits (valid only for MAP-E alg)
- psid_length – length of PSID (valid only for MAP-E alg)
- psid – Port Set Identifier value (valid only for MAP-E alg)
- start_port – beginning of the port range
- end_port – end of the port range
-
nat_set_mss_clamping
(enable=0, mss_value=1500)¶ Set TCP MSS rewriting configuration
Parameters: - enable – disable(0)/enable(1) MSS rewriting feature
- mss_value – MSS value to be used for MSS rewriting
-
nat_set_reass
(timeout=2, max_reass=1024, max_frag=5, drop_frag=0, is_ip6=0)¶ Set NAT virtual fragmentation reassembly
Parameters: - timeout – reassembly timeout (Default 2sec)
- max_reass – maximum concurrent reassemblies (Default 1024)
- max_frag – maximum fragmets per reassembly (Default 5)
- drop_frag – if 0 translate fragments, otherwise drop fragments
- is_ip6 – 1 if IPv6, 0 if IPv4
-
nat_set_timeouts
(udp=300, tcp_established=7440, tcp_transitory=240, icmp=60)¶ Set values of timeouts for NAT sessions (in seconds)
:param udp - UDP timeout (Default value = 300) :param tcp_established - TCP established timeout (Default value = 7440) :param tcp_transitory - TCP transitory timeout (Default value = 240) :param icmp - ICMP timeout (Default value = 60)
-
nat_show_config
()¶ Show NAT plugin config :return: NAT plugin config parameters
-
output_acl_set_interface
(is_add, sw_if_index, ip4_table_index=4294967295, ip6_table_index=4294967295, l2_table_index=4294967295)¶ Parameters: - is_add –
- sw_if_index –
- ip4_table_index – (Default value = 0xFFFFFFFF)
- ip6_table_index – (Default value = 0xFFFFFFFF)
- l2_table_index – (Default value = 0xFFFFFFFF)
-
pg_create_interface
(pg_index)¶ Parameters: pg_index –
-
pipe_create
(is_specified, user_instance)¶
-
pipe_delete
(parent_sw_if_index)¶
-
pipe_dump
()¶
-
policer_add_del
(name, cir, eir, cb, eb, is_add=1, rate_type=0, round_type=0, ptype=0, color_aware=0, conform_action_type=1, conform_dscp=0, exceed_action_type=0, exceed_dscp=0, violate_action_type=0, violate_dscp=0)¶
-
ppcli
(cli)¶ Helper method to print CLI command in case of info logging level.
Parameters: cli – CLI to execute Returns: CLI output
-
pppoe_add_del_session
(client_ip, client_mac, session_id=0, is_add=1, is_ipv6=0, decap_vrf_id=0)¶ Parameters: - is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- client_ip –
- session_id – (Default value = 0)
- client_mac –
- decap_vrf_id – (Default value = 0)
-
proxy_arp_add_del
(low_address, hi_address, vrf_id=0, is_add=1)¶ Config Proxy Arp Range.
Parameters: - low_address – Start address in the rnage to Proxy for
- hi_address – End address in the rnage to Proxy for
- vrf_id – The VRF/table in which to proxy
-
proxy_arp_intfc_enable_disable
(sw_if_index, is_enable=1)¶ Enable/Disable an interface for proxy ARP requests
Parameters: - sw_if_index – Interface
- enable_disable – Enable/Disable
-
punt_socket_register
(l4_port, pathname, header_version=1, is_ip4=1, l4_protocol=17)¶ Punt to socket
-
qos_egress_map_delete
(id)¶ QOS egress map delete
-
qos_egress_map_update
(id, outputs)¶ QOS egress map update
-
qos_mark_enable_disable
(sw_if_index, output_source, map_id, enable)¶ QOS Mark Enable/Disable
-
qos_record_enable_disable
(sw_if_index, input_source, enable)¶ IP QoS recording Enble/Disable
-
register_hook
(hook)¶ Replace hook registration with new hook
Parameters: hook –
-
reset_fib
(vrf_id, is_ipv6=0)¶ Reset VRF (remove all routes etc.) request.
Parameters: - vrf_id (int) – ID of the FIB table / VRF to reset.
- is_ipv6 (int) – 1 for IPv6 neighbor, 0 for IPv4. (Default = 0)
-
reset_vrf
(vrf_id, is_ipv6=0)¶ Reset VRF (remove all routes etc.) request.
Parameters: - vrf_id (int) – ID of the FIB table / VRF to reset.
- is_ipv6 (int) – 1 for IPv6 neighbor, 0 for IPv4. (Default = 0)
-
session_enable_disable
(is_enabled)¶
-
set_ip_flow_hash
(table_id, src=1, dst=1, sport=1, dport=1, proto=1, reverse=0, is_ip6=0)¶
-
set_ipfix_exporter
(collector_address, src_address, path_mtu, template_interval, vrf_id=0, collector_port=4739, udp_checksum=0)¶
-
show_version
()¶
-
sr_localsid_add_del
(localsid, behavior, nh_addr4, nh_addr6, is_del=0, end_psp=0, sw_if_index=4294967295, vlan_index=0, fib_table=0)¶ Add/del IPv6 SR local-SID.
Parameters: - localsid –
- behavior – END=1; END.X=2; END.DX2=4; END.DX6=5;
- behavior – END.DX4=6; END.DT6=7; END.DT4=8
- nh_addr4 –
- nh_addr6 –
- is_del – (Default value = 0)
- end_psp – (Default value = 0)
- sw_if_index – (Default value = 0xFFFFFFFF)
- vlan_index – (Default value = 0)
- fib_table – (Default value = 0)
-
sr_mpls_policy_add
(bsid, weight, type, segments)¶
-
sr_mpls_policy_del
(bsid)¶
-
sr_policy_add
(bsid_addr, weight=1, is_encap=1, type=0, fib_table=0, n_segments=0, segments=[])¶ Parameters: - bsid_addr – bindingSID of the SR Policy
- weight – weight of the sid list. optional. (default: 1)
- is_encap – (bool) whether SR policy should Encap or SRH insert (default: Encap)
- type – type/behavior of the SR policy. (default or spray) (default: default)
- fib_table – VRF where to install the FIB entry for the BSID (default: 0)
- n_segments – number of segments (default: 0)
- segments – a vector of IPv6 address composing the segment list (default: [])
-
sr_policy_del
(bsid_addr, sr_policy_index=0)¶ Parameters: - bsid – bindingSID of the SR Policy
- sr_policy_index – index of the sr policy (default: 0)
-
sr_steering_add_del
(is_del, bsid_addr, sr_policy_index, table_id, prefix_addr, mask_width, sw_if_index, traffic_type)¶ Steer traffic L2 and L3 traffic through a given SR policy
Parameters: - is_del – delete or add
- bsid_addr – bindingSID of the SR Policy (alt to sr_policy_index)
- sr_policy – is the index of the SR Policy (alt to bsid)
- table_id – is the VRF where to install the FIB entry for the BSID
- prefix_addr – is the IPv4/v6 address for L3 traffic type
- mask_width – is the mask for L3 traffic type
- sw_if_index – is the incoming interface for L2 traffic
- traffic_type – type of traffic (IPv4: 4, IPv6: 6, L2: 2)
-
svs_dump
()¶
-
svs_enable_disable
(af, table_id, sw_if_index, is_enable=1)¶
-
svs_route_add_del
(table_id, prefix, src_table_id, is_add=1)¶
-
svs_table_add_del
(af, table_id, is_add=1)¶
-
sw_interface_add_del_address
(sw_if_index, addr, addr_len, is_ipv6=0, is_add=1, del_all=0)¶ Parameters: - addr – param is_ipv6: (Default value = 0)
- sw_if_index –
- addr_len –
- is_ipv6 – (Default value = 0)
- is_add – (Default value = 1)
- del_all – (Default value = 0)
-
sw_interface_bond_dump
()¶
-
sw_interface_dump
(filter=None)¶ Parameters: filter – (Default value = None)
-
sw_interface_enable_disable_mpls
(sw_if_index, is_enable=1)¶ Enable/Disable MPLS on the interface :param sw_if_index: :param is_enable: (Default value = 1)
-
sw_interface_ra_suppress
(sw_if_index, suppress=1)¶
-
sw_interface_set_flags
(sw_if_index, admin_up_down)¶ Parameters: - admin_up_down –
- sw_if_index –
-
sw_interface_set_ip_directed_broadcast
(sw_if_index, enable=1)¶ IP Directed broadcast :param sw_if_index - interface the operation is applied to
-
sw_interface_set_l2_bridge
(sw_if_index, bd_id, shg=0, port_type=0, enable=1)¶ Add/remove interface to/from bridge domain.
Parameters: - sw_if_index (int) – Software interface index of the interface.
- bd_id (int) – Bridge domain index.
- shg (int) – Split-horizon group index. (Default value = 0)
- bvi (int) – Set interface as a bridge group virtual interface. (Default value = 0)
- enable (int) – Add or remove interface. (Default value = 1)
-
sw_interface_set_l2_emulation
(sw_if_index, enable=1)¶ L2 Emulation :param sw_if_index - interface the operation is applied to
-
sw_interface_set_l2_tag_rewrite
(sw_if_index, vtr_oper, push=0, tag1=0, tag2=0)¶ L2 interface vlan tag rewrite configure request :param client_index - opaque cookie to identify the sender :param context - sender context, to match reply w/ request :param sw_if_index - interface the operation is applied to :param vtr_op - Choose from l2_vtr_op_t enum values :param push_dot1q - first pushed flag dot1q id set, else dot1ad :param tag1 - Needed for any push or translate vtr op :param tag2 - Needed for any push 2 or translate x-2 vtr ops
-
sw_interface_set_l2_xconnect
(rx_sw_if_index, tx_sw_if_index, enable)¶ Create or delete unidirectional cross-connect from Tx interface to Rx interface.
Parameters: - rx_sw_if_index (int) – Software interface index of Rx interface.
- tx_sw_if_index (int) – Software interface index of Tx interface.
- enable (int) – Create cross-connect if equal to 1, delete cross-connect if equal to 0.
-
sw_interface_set_mac_address
(sw_if_index, mac)¶
-
sw_interface_set_mtu
(sw_if_index, mtu=[0, 0, 0, 0])¶ Parameters: - sw_if_index –
- mtu –
-
sw_interface_set_promiscuous
(sw_if_index, enable)¶ Parameters: - sw_if_index –
- enable –
-
sw_interface_set_table
(sw_if_index, is_ipv6, table_id)¶ Set the IPvX Table-id for the Interface
Parameters: - sw_if_index –
- is_ipv6 –
- table_id –
-
sw_interface_set_unnumbered
(sw_if_index, ip_sw_if_index, is_add=1)¶ Set the Interface to be unnumbered
Parameters: is_add – (Default value = 1) :param sw_if_index - interface That will be unnumbered :param ip_sw_if_index - interface with an IP addres
-
sw_interface_slave_dump
(sw_if_index)¶ Parameters: sw_if_index – bond sw_if_index
-
sw_interface_span_enable_disable
(sw_if_index_from, sw_if_index_to, state=1, is_l2=0)¶ Parameters: - sw_if_index_from –
- sw_if_index_to –
- state –
- is_l2 –
-
sw_interface_vhost_user_dump
()¶
-
udp_encap_add
(src_ip, dst_ip, src_port, dst_port, table_id=0)¶ Add a GRE tunnel :param src_ip: :param dst_ip: :param src_port: :param dst_port: :param outer_fib_id: (Default value = 0)
-
udp_encap_del
(id)¶
-
udp_encap_dump
()¶
-
vxlan_add_del_tunnel
(src_addr, dst_addr, mcast_sw_if_index=4294967295, is_add=1, is_ipv6=0, encap_vrf_id=0, decap_next_index=4294967295, vni=0, instance=4294967295)¶ Parameters: - dst_addr –
- src_addr –
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- encap_vrf_id – (Default value = 0)
- decap_next_index – (Default value = 0xFFFFFFFF)
- mcast_sw_if_index – (Default value = 0xFFFFFFFF)
- vni – (Default value = 0)
- instance – (Default value = 0xFFFFFFFF)
-
vxlan_gbp_tunnel_add_del
(src, dst, mcast_sw_if_index=4294967295, is_add=1, is_ipv6=0, encap_table_id=0, decap_next_index=4294967295, vni=0, instance=4294967295)¶ Parameters: - dst_addr –
- src_addr –
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- encap_table_id – (Default value = 0)
- decap_next_index – (Default value = 0xFFFFFFFF)
- mcast_sw_if_index – (Default value = 0xFFFFFFFF)
- vni – (Default value = 0)
- instance – (Default value = 0xFFFFFFFF)
-
vxlan_gbp_tunnel_dump
(sw_if_index=4294967295)¶
-
vxlan_gpe_add_del_tunnel
(src_addr, dst_addr, mcast_sw_if_index=4294967295, is_add=1, is_ipv6=0, encap_vrf_id=0, decap_vrf_id=0, protocol=3, vni=0)¶ Parameters: - local –
- remote –
- is_add – (Default value = 1)
- is_ipv6 – (Default value = 0)
- encap_vrf_id – (Default value = 0)
- decap_vrf_id – (Default value = 0)
- mcast_sw_if_index – (Default value = 0xFFFFFFFF)
- protocol – (Default value = 3)
- vni – (Default value = 0)
-
wait_for_event
(timeout, name=None)¶ Wait for and return next event.
-
want_bfd_events
(enable_disable=1)¶
-
want_dhcp6_pd_reply_events
(enable_disable=1)¶
-
want_dhcp6_reply_events
(enable_disable=1)¶
-
want_igmp_events
(enable=1)¶
-
want_interface_events
(enable_disable=1)¶
-
want_ip4_arp_events
(enable_disable=1, address=0)¶
-
want_ip6_nd_events
(enable_disable=1, address=0)¶
-
want_ip6_ra_events
(enable_disable=1)¶
-
want_macs_learn_events
(enable_disable=1, scan_delay=0, max_macs_in_event=0, learn_limit=0)¶
-
want_udp_encap_stats
(enable=1)¶
-