/* Hey Emacs use -*- mode: C -*- */ /* * Copyright (c) 2018 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. */ option version = "3.2.2"; import "vnet/interface_types.api"; import "vnet/ethernet/ethernet_types.api"; import "vnet/ip/ip_types.api"; service { rpc want_interface_events returns want_interface_events_reply events sw_interface_event; }; /** \brief Set flags on the interface @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - index of the interface to set flags on @param flags - interface_status flags (only IF_STATUS_API_FLAG_ADMIN_UP used in config) */ autoreply define sw_interface_set_flags { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; vl_api_if_status_flags_t flags; }; /** \brief Set interface physical MTU @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - index of the interface to set MTU on @param mtu - MTU */ autoreply define hw_interface_set_mtu { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; u16 mtu; }; /** \brief Set interface L3 MTU */ autoreply define sw_interface_set_mtu { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; u32 mtu[4]; /* vl_api_mtu_proto_t 0 - L3, 1 - IP4, 2 - IP6, 3 - MPLS */ }; /** \brief Set IP4 directed broadcast The directed broadcast enabled a packet sent to the interface's subnet address will be broadcast on the interface @param sw_if_index @param enable */ autoreply define sw_interface_set_ip_directed_broadcast { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; bool enable; }; /** \brief Interface Event generated by want_interface_events @param client_index - opaque cookie to identify the sender @param pid - client pid registered to receive notification @param sw_if_index - index of the interface of the event @param flags - interface_status flags @param deleted - interface was deleted */ define sw_interface_event { u32 client_index; u32 pid; vl_api_interface_index_t sw_if_index; vl_api_if_status_flags_t flags; bool deleted; }; /** \brief Register for interface events @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param enable_disable - 1 => register for events, 0 => cancel registration @param pid - sender's pid */ autoreply define want_interface_events { u32 client_index; u32 context; u32 enable_disable; u32 pid; }; /** \brief Interface details structure (fix this) @param sw_if_index - index of the interface @param sup_sw_if_index - index of parent interface if any, else same as sw_if_index @param l2_address - the interface's l2 address @param flags - interface_status flags @param type - interface type @param link_duplex - 1 if half duplex, 2 if full duplex @param link_speed - value in kbps @param link_MTU - max. transmission unit @param sub_id - A number 0-N to uniquely identify this subif on super if @param sub_number_of_tags - Number of tags (0 - 2) @param sub_outer_vlan_id @param sub_inner_vlan_id @param sub_if_flags - sub interface flags @param vtr_op - vlan tag rewrite operation @param vtr_push_dot1q @param vtr_tag1 @param vtr_tag2 @param pbb_outer_tag - translate pbb s-tag @param pbb_b_dmac[6] - B-tag remote mac address @param pbb_b_smac[6] - B-tag local mac address @param pbb_b_vlanid - B-tag vlanid @param pbb_i_sid - I-tag service id @param interface_name - name of the interface @param interface_dev_type - device type of the interface @param tag - an ascii tag */ define sw_interface_details { u32 context; vl_api_interface_index_t sw_if_index; /* index of sup interface (e.g. hw interface). equal to sw_if_index for super hw interface. */ u32 sup_sw_if_index; /* Layer 2 address, if applicable */ vl_api_mac_address_t l2_address; vl_api_if_status_flags_t flags; vl_api_if_type_t type; /* 1 = half duplex, 2 = full duplex */ vl_api_link_duplex_t link_duplex; /* link speed in kbps */ u32 link_speed; /* MTU */ u16 link_mtu; /* Per protocol MTUs */ u32 mtu[4]; /* vl_api_mtu_proto_t 0 - L3, 1 - IP4, 2 - IP6, 3 - MPLS */ /* Subinterface ID. A number 0-N to uniquely identify this subinterface under the super interface */ u32 sub_id; /* Number of tags 0-2 */ u8 sub_number_of_tags; u16 sub
""" debug utilities """

import os
import pexpect
import sys

gdb_path = '/usr/bin/gdb'


def spawn_gdb(binary_path, core_path):
    if os.path.isfile(gdb_path) and os.access(gdb_path, os.X_OK):
        # automatically attach gdb
        gdb_cmdline = "%s %s %s" % (gdb_path, binary_path, core_path)
        gdb = pexpect.spawn(gdb_cmdline)
        gdb.interact()
        try:
            gdb.terminate(True)
        except:
            pass
        if gdb.isalive():
            raise Exception("GDB refused to die...")
    else:
        sys.stderr.write("Debugger '%s' does not exist or is not "
                         "an executable..\n" % gdb_path)
ne-zero @param is_specified - if non-0, a specific user_instance is being requested @param user_instance - requested instance, ~0 => dynamically allocate */ define create_loopback_instance { u32 client_index; u32 context; vl_api_mac_address_t mac_address; bool is_specified; u32 user_instance; }; /** \brief Create loopback interface instance response @param context - sender context, to match reply w/ request @param sw_if_index - sw index of the interface that was created @param retval - return code for the request */ define create_loopback_instance_reply { u32 context; i32 retval; vl_api_interface_index_t sw_if_index; }; /** \brief Delete loopback interface request @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - sw index of the interface that was created */ autoreply define delete_loopback { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; }; /** \brief Enable or disable detailed interface stats @param client_index - opaque cookie to identify the sender @param context - sender context, to match reply w/ request @param sw_if_index - The interface to collect detail stats on. ~0 implies all interfaces. @param enable_disable - set to 1 to enable, 0 to disable detailed stats */ autoreply define collect_detailed_interface_stats { u32 client_index; u32 context; vl_api_interface_index_t sw_if_index; bool enable_disable; }; /* * Local Variables: * eval: (c-set-style "gnu") * End: */