src/vnet/devices/af_packet/af_packet.api

   1 /*
   2  * Copyright (c) 2015-2016 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 = "2.0.0";
  17
  18 import "vnet/interface_types.api";
  19 import "vnet/ethernet/ethernet_types.api";
  20
  21 /** \brief Create host-interface
  22     @param client_index - opaque cookie to identify the sender
  23     @param context - sender context, to match reply w/ request
  24     @param hw_addr - interface MAC
  25     @param use_random_hw_addr - use random generated MAC
  26     @param host_if_name - interface name
  27 */
  28 define af_packet_create
  29 {
  30   u32 client_index;
  31   u32 context;
  32
  33   vl_api_mac_address_t hw_addr;
  34   bool use_random_hw_addr;
  35   string host_if_name[64];
  36 };
  37
  38 /** \brief Create host-interface response
  39     @param context - sender context, to match reply w/ request
  40     @param retval - return value for request
  41 */
  42 define af_packet_create_reply
  43 {
  44   u32 context;
  45   i32 retval;
  46   vl_api_interface_index_t sw_if_index;
  47 };
  48
  49 /** \brief Create host-interface
  50     @param client_index - opaque cookie to identify the sender
  51     @param context - sender context, to match reply w/ request
  52     @param hw_addr - interface MAC
  53     @param use_random_hw_addr - use random generated MAC
  54     @param host_if_name - interface name
  55     @param rx_frame_size - frame size for RX
  56     @param tx_frame_size - frame size for TX
  57     @param rx_frames_per_block - frames per block for RX
  58     @param tx_frames_per_block - frames per block for TX
  59     @param flags - flags for the af_packet interface creation
  60     @param num_rx_queues - number of rx queues
  61 */
  62 define af_packet_create_v2
  63 {
  64   u32 client_index;
  65   u32 context;
  66
  67   vl_api_mac_address_t hw_addr;
  68   bool use_random_hw_addr;
  69   string host_if_name[64];
  70   u32 rx_frame_size;
  71   u32 tx_frame_size;
  72   u32 rx_frames_per_block;
  73   u32 tx_frames_per_block;
  74   u32 flags;
  75   u16 num_rx_queues [default=1];
  76 };
  77
  78 /** \brief Create host-interface response
  79     @param context - sender context, to match reply w/ request
  80     @param retval - return value for request
  81 */
  82 define af_packet_create_v2_reply
  83 {
  84   u32 context;
  85   i32 retval;
  86   vl_api_interface_index_t sw_if_index;
  87 };
  88
  89 enum af_packet_mode {
  90   AF_PACKET_API_MODE_ETHERNET = 1, /* mode ethernet */
  91   AF_PACKET_API_MODE_IP = 2, /* mode ip */
  92 };
  93
  94 enum af_packet_flags {
  95   AF_PACKET_API_FLAG_QDISC_BYPASS = 1, /* enable the qdisc bypass */
  96   AF_PACKET_API_FLAG_CKSUM_GSO = 2, /* enable checksum/gso */
  97 };
  98
  99 /** \brief Create host-interface
 100     @param client_index - opaque cookie to identify the sender
 101     @param context - sender context, to match reply w/ request
 102     @param mode - 1 - Ethernet, 2 - IP
 103     @param hw_addr - interface MAC
 104     @param use_random_hw_addr - use random generated MAC
 105     @param host_if_name - interface name
 106     @param rx_frame_size - frame size for RX
 107     @param tx_frame_size - frame size for TX
 108     @param rx_frames_per_block - frames per block for RX
 109     @param tx_frames_per_block - frames per block for TX
 110     @param flags - flags for the af_packet interface creation
 111     @param num_rx_queues - number of rx queues
 112     @param num_tx_queues - number of tx queues
 113 */
 114 define af_packet_create_v3
 115 {
 116   u32 client_index;
 117   u32 context;
 118
 119   vl_api_af_packet_mode_t mode;
 120   vl_api_mac_address_t hw_addr;
 121   bool use_random_hw_addr;
 122   string host_if_name[64];
 123   u32 rx_frame_size;
 124   u32 tx_frame_size;
 125   u32 rx_frames_per_block;
 126   u32 tx_frames_per_block;
 127   vl_api_af_packet_flags_t flags;
 128   u16 num_rx_queues [default=1];
 129   u16 num_tx_queues [default=1];
 130 };
 131
 132 /** \brief Create host-interface response
 133     @param context - sender context, to match reply w/ request
 134     @param retval - return value for request
 135 */
 136 define af_packet_create_v3_reply
 137 {
 138   u32 context;
 139   i32 retval;
 140   vl_api_interface_index_t sw_if_index;
 141 };
 142
 143 /** \brief Delete host-interface
 144     @param client_index - opaque cookie to identify the sender
 145     @param context - sender context, to match reply w/ request
 146     @param host_if_name - interface name
 147 */
 148 autoreply define af_packet_delete
 149 {
 150   u32 client_index;
 151   u32 context;
 152
 153   string host_if_name[64];
 154 };
 155
 156 /** \brief Set l4 offload checksum calculation
 157     @param client_index - opaque cookie to identify the sender
 158     @param context - sender context, to match reply w/ request
 159 */
 160 autoreply define af_packet_set_l4_cksum_offload
 161 {
 162   u32 client_index;
 163   u32 context;
 164
 165   vl_api_interface_index_t sw_if_index;
 166   bool set;
 167 };
 168
 169 /** \brief Dump af_packet interfaces request */
 170 define af_packet_dump
 171 {
 172   u32 client_index;
 173   u32 context;
 174 };
 175
 176 /** \brief Reply for af_packet dump request
 177     @param sw_if_index - software index of af_packet interface
 178     @param host_if_name - interface name
 179 */
 180 define af_packet_details
 181 {
 182   u32 context;
 183   vl_api_interface_index_t sw_if_index;
 184   string host_if_name[64];
 185 };
 186
 187 /*
 188  * Local Variables:
 189  * eval: (c-set-style "gnu")
 190  * End:
 191  */