src/vnet/classify/classify.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 = "1.0.0";
  17
  18 /** \brief Add/Delete classification table request
  19     @param client_index - opaque cookie to identify the sender
  20     @param context - sender context, to match reply w/ request
  21     @param is_add- if non-zero add the table, else delete it
  22     @param del_chain - if non-zero delete the whole chain of tables
  23     @param table_index - if add, reuturns index of the created table, else specifies the table to delete
  24     @param nbuckets - number of buckets when adding a table
  25     @param memory_size - memory size when adding a table
  26     @param match_n_vectors - number of match vectors
  27     @param next_table_index - index of next table
  28     @param miss_next_index - index of miss table
  29     @param current_data_flag - option to use current node's packet payload
  30             as the starting point from where packets are classified,
  31             This option is only valid for L2/L3 input ACL for now.
  32             0: by default, classify data from the buffer's start location
  33             1: classify packets from VPP node’s current data pointer
  34     @param current_data_offset - a signed value to shift the start location of
  35             the packet to be classified
  36             For example, if input IP ACL node is used, L2 header’s first byte
  37             can be accessible by configuring current_data_offset to -14
  38             if there is no vlan tag.
  39             This is valid only if current_data_flag is set to 1.
  40     @param mask[] - match mask
  41 */
  42 define classify_add_del_table
  43 {
  44   u32 client_index;
  45   u32 context;
  46   u8 is_add;
  47   u8 del_chain;
  48   u32 table_index;
  49   u32 nbuckets;
  50   u32 memory_size;
  51   u32 skip_n_vectors;
  52   u32 match_n_vectors;
  53   u32 next_table_index;
  54   u32 miss_next_index;
  55   u32 current_data_flag;
  56   i32 current_data_offset;
  57   u8 mask[0];
  58 };
  59
  60 /** \brief Add/Delete classification table response
  61     @param context - sender context, to match reply w/ request
  62     @param retval - return code for the table add/del requst
  63     @param new_table_index - for add, returned index of the new table
  64     @param skip_n_vectors - for add, returned value of skip_n_vectors in table
  65     @param match_n_vectors -for add, returned value of match_n_vectors in table
  66 */
  67 define classify_add_del_table_reply
  68 {
  69   u32 context;
  70   i32 retval;
  71   u32 new_table_index;
  72   u32 skip_n_vectors;
  73   u32 match_n_vectors;
  74 };
  75
  76 /** \brief Classify add / del session request
  77     @param client_index - opaque cookie to identify the sender
  78     @param context - sender context, to match reply w/ request
  79     @param is_add - add session if non-zero, else delete
  80     @param table_index - index of the table to add/del the session, required
  81     @param hit_next_index - for add, hit_next_index of new session, required
  82     @param opaque_index - for add, opaque_index of new session
  83     @param advance -for add, advance value for session
  84     @param action -
  85            0: no action (by default)
  86               metadata is not used.
  87            1: Classified IP packets will be looked up from the
  88               specified ipv4 fib table (configured by metadata as VRF id).
  89               Only valid for L3 input ACL node
  90            2: Classified IP packets will be looked up from the
  91               specified ipv6 fib table (configured by metadata as VRF id).
  92               Only valid for L3 input ACL node
  93            3: Classified packet will be steered to source routig policy
  94               of given index (in metadata).
  95               This is only valid for IPv6 packets redirected to a source
  96               routing node.
  97     @param metadata - valid only if action != 0
  98            VRF id if action is 1 or 2.
  99            sr policy index if action is 3.
 100     @param match[] - for add, match value for session, required
 101 */
 102 autoreply define classify_add_del_session
 103 {
 104   u32 client_index;
 105   u32 context;
 106   u8 is_add;
 107   u32 table_index;
 108   u32 hit_next_index;
 109   u32 opaque_index;
 110   i32 advance;
 111   u8 action;
 112   u32 metadata;
 113   u8 match[0];
 114 };
 115
 116 /** \brief Set/unset policer classify interface
 117     @param client_index - opaque cookie to identify the sender
 118     @param context - sender context, to match reply w/ request
 119     @param sw_if_index - interface to set/unset policer classify
 120     @param ip4_table_index - ip4 classify table index (~0 for skip)
 121     @param ip6_table_index - ip6 classify table index (~0 for skip)
 122     @param l2_table_index  -  l2 classify table index (~0 for skip)
 123     @param is_add - Set if non-zero, else unset
 124     Note: User is recommeneded to use just one valid table_index per call.
 125           (ip4_table_index, ip6_table_index, or l2_table_index)
 126 */
 127 autoreply define policer_classify_set_interface
 128 {
 129   u32 client_index;
 130   u32 context;
 131   u32 sw_if_index;
 132   u32 ip4_table_index;
 133   u32 ip6_table_index;
 134   u32 l2_table_index;
 135   u8 is_add;
 136 };
 137
 138 /** \brief Get list of policer classify interfaces and tables
 139     @param client_index - opaque cookie to identify the sender
 140     @param context - sender context, to match reply w/ request
 141     @param type - classify table type
 142 */
 143 define policer_classify_dump
 144 {
 145   u32 client_index;
 146   u32 context;
 147   u8 type;
 148 };
 149
 150 /** \brief Policer iclassify operational state response.
 151     @param context - sender context, to match reply w/ request
 152     @param sw_if_index - software interface index
 153     @param table_index - classify table index
 154 */
 155 define policer_classify_details
 156 {
 157   u32 context;
 158   u32 sw_if_index;
 159   u32 table_index;
 160 };
 161
 162 /** \brief Classify get table IDs request
 163     @param client_index - opaque cookie to identify the sender
 164     @param context - sender context, to match reply w/ request
 165 */
 166 define classify_table_ids
 167 {
 168   u32 client_index;
 169   u32 context;
 170 };
 171
 172 /** \brief Reply for classify get table IDs request
 173     @param context - sender context which was passed in the request
 174     @param count - number of ids returned in response
 175     @param ids - array of classify table ids
 176 */
 177 define classify_table_ids_reply
 178 {
 179   u32 context;
 180   i32 retval;
 181   u32 count;
 182   u32 ids[count];
 183 };
 184
 185 /** \brief Classify table ids by interface index request
 186     @param client_index - opaque cookie to identify the sender
 187     @param context - sender context, to match reply w/ request
 188     @param sw_if_index - index of the interface
 189 */
 190 define classify_table_by_interface
 191 {
 192   u32 client_index;
 193   u32 context;
 194   u32 sw_if_index;
 195 };
 196
 197 /** \brief Reply for classify table id by interface index request
 198     @param context - sender context which was passed in the request
 199     @param count - number of ids returned in response
 200     @param sw_if_index - index of the interface
 201     @param l2_table_id - l2 classify table index
 202     @param ip4_table_id - ip4 classify table index
 203     @param ip6_table_id - ip6 classify table index
 204 */
 205 define classify_table_by_interface_reply
 206 {
 207   u32 context;
 208   i32 retval;
 209   u32 sw_if_index;
 210   u32 l2_table_id;
 211   u32 ip4_table_id;
 212   u32 ip6_table_id;
 213 };
 214
 215 /** \brief Classify table info
 216     @param client_index - opaque cookie to identify the sender
 217     @param context - sender context, to match reply w/ request
 218     @param table_id - classify table index
 219 */
 220 define classify_table_info
 221 {
 222   u32 client_index;
 223   u32 context;
 224   u32 table_id;
 225 };
 226
 227 /** \brief Reply for classify table info request
 228     @param context - sender context which was passed in the request
 229     @param count - number of ids returned in response
 230     @param table_id - classify table index
 231     @param nbuckets - number of buckets when adding a table
 232     @param match_n_vectors - number of match vectors
 233     @param skip_n_vectors - number of skip_n_vectors
 234     @param active_sessions - number of sessions (active entries)
 235     @param next_table_index - index of next table
 236     @param miss_next_index - index of miss table
 237     @param mask[] - match mask
 238 */
 239 define classify_table_info_reply
 240 {
 241   u32 context;
 242   i32 retval;
 243   u32 table_id;
 244   u32 nbuckets;
 245   u32 match_n_vectors;
 246   u32 skip_n_vectors;
 247   u32 active_sessions;
 248   u32 next_table_index;
 249   u32 miss_next_index;
 250   u32 mask_length;
 251   u8 mask[mask_length];
 252 };
 253
 254 /** \brief Classify sessions dump request
 255     @param client_index - opaque cookie to identify the sender
 256     @param context - sender context, to match reply w/ request
 257     @param table_id - classify table index
 258 */
 259 define classify_session_dump
 260 {
 261   u32 client_index;
 262   u32 context;
 263   u32 table_id;
 264 };
 265
 266 /** \brief Reply for classify table session dump request
 267     @param context - sender context which was passed in the request
 268     @param count - number of ids returned in response
 269     @param table_id - classify table index
 270     @param hit_next_index - hit_next_index of session
 271     @param opaque_index - for add, opaque_index of session
 272     @param advance - advance value of session
 273     @param match[] - match value for session
 274 */
 275 define classify_session_details
 276 {
 277   u32 context;
 278   i32 retval;
 279   u32 table_id;
 280   u32 hit_next_index;
 281   i32 advance;
 282   u32 opaque_index;
 283   u32 match_length;
 284   u8 match[match_length];
 285 };
 286
 287 /** \brief Set/unset flow classify interface
 288     @param client_index - opaque cookie to identify the sender
 289     @param context - sender context, to match reply w/ request
 290     @param sw_if_index - interface to set/unset flow classify
 291     @param ip4_table_index - ip4 classify table index (~0 for skip)
 292     @param ip6_table_index - ip6 classify table index (~0 for skip)
 293     @param l2_table_index  -  l2 classify table index (~0 for skip)
 294     @param is_add - Set if non-zero, else unset
 295     Note: User is recommeneded to use just one valid table_index per call.
 296           (ip4_table_index, ip6_table_index, or l2_table_index)
 297 */
 298 autoreply define flow_classify_set_interface {
 299     u32 client_index;
 300     u32 context;
 301     u32 sw_if_index;
 302     u32 ip4_table_index;
 303     u32 ip6_table_index;
 304     u8  is_add;
 305 };
 306
 307 /** \brief Get list of flow classify interfaces and tables
 308     @param client_index - opaque cookie to identify the sender
 309     @param context - sender context, to match reply w/ request
 310     @param type - classify table type
 311 */
 312 define flow_classify_dump {
 313     u32 client_index;
 314     u32 context;
 315     u8 type;
 316 };
 317
 318 /** \brief Flow classify operational state response.
 319     @param context - sender context, to match reply w/ request
 320     @param sw_if_index - software interface index
 321     @param table_index - classify table index
 322 */
 323 define flow_classify_details {
 324     u32 context;
 325     u32 sw_if_index;
 326     u32 table_index;
 327 };
 328
 329 /** \brief Set/unset the classification table for an interface request
 330     @param client_index - opaque cookie to identify the sender
 331     @param context - sender context, to match reply w/ request
 332     @param is_ipv6 - ipv6 if non-zero, else ipv4
 333     @param sw_if_index - interface to associate with the table
 334     @param table_index - index of the table, if ~0 unset the table
 335 */
 336 autoreply define classify_set_interface_ip_table
 337 {
 338   u32 client_index;
 339   u32 context;
 340   u8 is_ipv6;
 341   u32 sw_if_index;
 342   u32 table_index;              /* ~0 => off */
 343 };
 344
 345 /** \brief Set/unset l2 classification tables for an interface request
 346     @param client_index - opaque cookie to identify the sender
 347     @param context - sender context, to match reply w/ request
 348     @param sw_if_index - interface to set/unset tables for
 349     @param ip4_table_index - ip4 index, use ~0 for all 3 indexes to unset
 350     @param ip6_table_index - ip6 index
 351     @param other_table_index - other index
 352 */
 353 autoreply define classify_set_interface_l2_tables
 354 {
 355   u32 client_index;
 356   u32 context;
 357   u32 sw_if_index;
 358   /* 3 x ~0 => off */
 359   u32 ip4_table_index;
 360   u32 ip6_table_index;
 361   u32 other_table_index;
 362   u8 is_input;
 363 };
 364
 365 /** \brief Set/unset input ACL interface
 366     @param client_index - opaque cookie to identify the sender
 367     @param context - sender context, to match reply w/ request
 368     @param sw_if_index - interface to set/unset input ACL
 369     @param ip4_table_index - ip4 classify table index (~0 for skip)
 370     @param ip6_table_index - ip6 classify table index (~0 for skip)
 371     @param l2_table_index  -  l2 classify table index (~0 for skip)
 372     @param is_add - Set input ACL if non-zero, else unset
 373     Note: User is recommeneded to use just one valid table_index per call.
 374           (ip4_table_index, ip6_table_index, or l2_table_index)
 375 */
 376 autoreply define input_acl_set_interface
 377 {
 378   u32 client_index;
 379   u32 context;
 380   u32 sw_if_index;
 381   u32 ip4_table_index;
 382   u32 ip6_table_index;
 383   u32 l2_table_index;
 384   u8 is_add;
 385 };
 386
 387 /** \brief Set/unset output ACL interface
 388     @param client_index - opaque cookie to identify the sender
 389     @param context - sender context, to match reply w/ request
 390     @param sw_if_index - interface to set/unset output ACL
 391     @param ip4_table_index - ip4 classify table index (~0 for skip)
 392     @param ip6_table_index - ip6 classify table index (~0 for skip)
 393     @param l2_table_index  -  l2 classify table index (~0 for skip)
 394     @param is_add - Set output ACL if non-zero, else unset
 395     Note: User is recommeneded to use just one valid table_index per call.
 396           (ip4_table_index, ip6_table_index, or l2_table_index)
 397 */
 398 autoreply define output_acl_set_interface
 399 {
 400   u32 client_index;
 401   u32 context;
 402   u32 sw_if_index;
 403   u32 ip4_table_index;
 404   u32 ip6_table_index;
 405   u32 l2_table_index;
 406   u8 is_add;
 407 };
 408
 409 /*
 410  * Local Variables:
 411  * eval: (c-set-style "gnu")
 412  * End:
 413  */
 414