DPDK
21.08.0
|
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#include <rte_compat.h>
#include "rte_swx_port.h"
#include "rte_swx_table.h"
#include "rte_swx_extern.h"
Go to the source code of this file.
Data Structures | |
struct | rte_swx_field_params |
struct | rte_swx_match_field_params |
struct | rte_swx_pipeline_table_params |
struct | rte_swx_pipeline_selector_params |
Macros | |
#define | RTE_SWX_NAME_SIZE 64 |
#define | RTE_SWX_INSTRUCTION_SIZE 256 |
#define | RTE_SWX_INSTRUCTION_TOKENS_MAX 16 |
Functions | |
__rte_experimental int | rte_swx_pipeline_config (struct rte_swx_pipeline **p, int numa_node) |
__rte_experimental int | rte_swx_pipeline_port_in_type_register (struct rte_swx_pipeline *p, const char *name, struct rte_swx_port_in_ops *ops) |
__rte_experimental int | rte_swx_pipeline_port_in_config (struct rte_swx_pipeline *p, uint32_t port_id, const char *port_type_name, void *args) |
__rte_experimental int | rte_swx_pipeline_port_out_type_register (struct rte_swx_pipeline *p, const char *name, struct rte_swx_port_out_ops *ops) |
__rte_experimental int | rte_swx_pipeline_port_out_config (struct rte_swx_pipeline *p, uint32_t port_id, const char *port_type_name, void *args) |
__rte_experimental int | rte_swx_pipeline_extern_type_register (struct rte_swx_pipeline *p, const char *name, const char *mailbox_struct_type_name, rte_swx_extern_type_constructor_t constructor, rte_swx_extern_type_destructor_t destructor) |
__rte_experimental int | rte_swx_pipeline_extern_type_member_func_register (struct rte_swx_pipeline *p, const char *extern_type_name, const char *name, rte_swx_extern_type_member_func_t member_func) |
__rte_experimental int | rte_swx_pipeline_extern_object_config (struct rte_swx_pipeline *p, const char *extern_type_name, const char *name, const char *args) |
__rte_experimental int | rte_swx_pipeline_extern_func_register (struct rte_swx_pipeline *p, const char *name, const char *mailbox_struct_type_name, rte_swx_extern_func_t func) |
__rte_experimental int | rte_swx_pipeline_struct_type_register (struct rte_swx_pipeline *p, const char *name, struct rte_swx_field_params *fields, uint32_t n_fields) |
__rte_experimental int | rte_swx_pipeline_packet_header_register (struct rte_swx_pipeline *p, const char *name, const char *struct_type_name) |
__rte_experimental int | rte_swx_pipeline_packet_metadata_register (struct rte_swx_pipeline *p, const char *struct_type_name) |
__rte_experimental int | rte_swx_pipeline_action_config (struct rte_swx_pipeline *p, const char *name, const char *args_struct_type_name, const char **instructions, uint32_t n_instructions) |
__rte_experimental int | rte_swx_pipeline_table_type_register (struct rte_swx_pipeline *p, const char *name, enum rte_swx_table_match_type match_type, struct rte_swx_table_ops *ops) |
__rte_experimental int | rte_swx_pipeline_table_config (struct rte_swx_pipeline *p, const char *name, struct rte_swx_pipeline_table_params *params, const char *recommended_table_type_name, const char *args, uint32_t size) |
__rte_experimental int | rte_swx_pipeline_selector_config (struct rte_swx_pipeline *p, const char *name, struct rte_swx_pipeline_selector_params *params) |
__rte_experimental int | rte_swx_pipeline_regarray_config (struct rte_swx_pipeline *p, const char *name, uint32_t size, uint64_t init_val) |
__rte_experimental int | rte_swx_pipeline_metarray_config (struct rte_swx_pipeline *p, const char *name, uint32_t size) |
__rte_experimental int | rte_swx_pipeline_instructions_config (struct rte_swx_pipeline *p, const char **instructions, uint32_t n_instructions) |
__rte_experimental int | rte_swx_pipeline_build (struct rte_swx_pipeline *p) |
__rte_experimental int | rte_swx_pipeline_build_from_spec (struct rte_swx_pipeline *p, FILE *spec, uint32_t *err_line, const char **err_msg) |
__rte_experimental void | rte_swx_pipeline_run (struct rte_swx_pipeline *p, uint32_t n_instructions) |
__rte_experimental void | rte_swx_pipeline_flush (struct rte_swx_pipeline *p) |
__rte_experimental void | rte_swx_pipeline_free (struct rte_swx_pipeline *p) |
RTE SWX Pipeline
Definition in file rte_swx_pipeline.h.
#define RTE_SWX_NAME_SIZE 64 |
Name size.
Definition at line 28 of file rte_swx_pipeline.h.
#define RTE_SWX_INSTRUCTION_SIZE 256 |
Instruction size.
Definition at line 33 of file rte_swx_pipeline.h.
#define RTE_SWX_INSTRUCTION_TOKENS_MAX 16 |
Instruction tokens.
Definition at line 38 of file rte_swx_pipeline.h.
__rte_experimental int rte_swx_pipeline_config | ( | struct rte_swx_pipeline ** | p, |
int | numa_node | ||
) |
Pipeline configure
[out] | p | Pipeline handle. Must point to valid memory. Contains valid pipeline handle when the function returns successfully. |
[in] | numa_node | Non-Uniform Memory Access (NUMA) node. |
__rte_experimental int rte_swx_pipeline_port_in_type_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
struct rte_swx_port_in_ops * | ops | ||
) |
Pipeline input port type register
[in] | p | Pipeline handle. |
[in] | name | Input port type name. |
[in] | ops | Input port type operations. |
__rte_experimental int rte_swx_pipeline_port_in_config | ( | struct rte_swx_pipeline * | p, |
uint32_t | port_id, | ||
const char * | port_type_name, | ||
void * | args | ||
) |
Pipeline input port configure
[in] | p | Pipeline handle. |
[in] | port_id | Input port ID. |
[in] | port_type_name | Existing input port type name. |
[in] | args | Input port creation arguments. |
__rte_experimental int rte_swx_pipeline_port_out_type_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
struct rte_swx_port_out_ops * | ops | ||
) |
Pipeline output port type register
[in] | p | Pipeline handle. |
[in] | name | Output port type name. |
[in] | ops | Output port type operations. |
__rte_experimental int rte_swx_pipeline_port_out_config | ( | struct rte_swx_pipeline * | p, |
uint32_t | port_id, | ||
const char * | port_type_name, | ||
void * | args | ||
) |
Pipeline output port configure
[in] | p | Pipeline handle. |
[in] | port_id | Output port ID. |
[in] | port_type_name | Existing output port type name. |
[in] | args | Output port creation arguments. |
__rte_experimental int rte_swx_pipeline_extern_type_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
const char * | mailbox_struct_type_name, | ||
rte_swx_extern_type_constructor_t | constructor, | ||
rte_swx_extern_type_destructor_t | destructor | ||
) |
Pipeline extern type register
[in] | p | Pipeline handle. |
[in] | name | Extern type name. |
[in] | mailbox_struct_type_name | Name of existing struct type used to define the mailbox size and layout for the extern objects that are instances of this type. Each extern object gets its own mailbox, which is used to pass the input arguments to the member functions and retrieve the output results. |
[in] | constructor | Function used to create the extern objects that are instances of this type. |
[in] | destructor | Function used to free the extern objects that are instances of this type. |
__rte_experimental int rte_swx_pipeline_extern_type_member_func_register | ( | struct rte_swx_pipeline * | p, |
const char * | extern_type_name, | ||
const char * | name, | ||
rte_swx_extern_type_member_func_t | member_func | ||
) |
Pipeline extern type member function register
[in] | p | Pipeline handle. |
[in] | extern_type_name | Existing extern type name. |
[in] | name | Name for the new member function to be added to the extern type. |
[in] | member_func | The new member function. |
__rte_experimental int rte_swx_pipeline_extern_object_config | ( | struct rte_swx_pipeline * | p, |
const char * | extern_type_name, | ||
const char * | name, | ||
const char * | args | ||
) |
Pipeline extern object configure
Instantiate a given extern type to create new extern object.
[in] | p | Pipeline handle. |
[in] | extern_type_name | Existing extern type name. |
[in] | name | Name for the new object instantiating the extern type. |
[in] | args | Extern object constructor arguments. |
__rte_experimental int rte_swx_pipeline_extern_func_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
const char * | mailbox_struct_type_name, | ||
rte_swx_extern_func_t | func | ||
) |
Pipeline extern function register
[in] | p | Pipeline handle. |
[in] | name | Extern function name. |
[in] | mailbox_struct_type_name | Name of existing struct type used to define the mailbox size and layout for this extern function. The mailbox is used to pass the input arguments to the extern function and retrieve the output results. |
[in] | func | The extern function. |
__rte_experimental int rte_swx_pipeline_struct_type_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
struct rte_swx_field_params * | fields, | ||
uint32_t | n_fields | ||
) |
Pipeline struct type register
Structs are used extensively in many part of the pipeline to define the size and layout of a specific memory piece such as: headers, meta-data, action data stored in a table entry, mailboxes for extern objects and functions. Similar to C language structs, they are a well defined sequence of fields, with each field having a unique name and a constant size.
[in] | p | Pipeline handle. |
[in] | name | Struct type name. |
[in] | fields | The sequence of struct fields. |
[in] | n_fields | The number of struct fields. |
__rte_experimental int rte_swx_pipeline_packet_header_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
const char * | struct_type_name | ||
) |
Pipeline packet header register
[in] | p | Pipeline handle. |
[in] | name | Header name. |
[in] | struct_type_name | The struct type instantiated by this packet header. |
__rte_experimental int rte_swx_pipeline_packet_metadata_register | ( | struct rte_swx_pipeline * | p, |
const char * | struct_type_name | ||
) |
Pipeline packet meta-data register
[in] | p | Pipeline handle. |
[in] | struct_type_name | The struct type instantiated by the packet meta-data. |
__rte_experimental int rte_swx_pipeline_action_config | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
const char * | args_struct_type_name, | ||
const char ** | instructions, | ||
uint32_t | n_instructions | ||
) |
Instruction operands:
+-----+---------------------------+------------------+-----+-----+
| | Description | Format | DST | SRC |
+-----+---------------------------+------------------+-----+-----+
| hdr | Header | h.header | | |
+-----+---------------------------+------------------+-----+-----+
| act | Action | ACTION | | |
+-----+---------------------------+------------------+-----+-----+
| tbl | Table | TABLE | | |
+-----+---------------------------+------------------+-----+-----+
| H | Header field | h.header.field | YES | YES |
+-----+---------------------------+------------------+-----+-----+
| M | Meta-data field | m.field | YES | YES |
+-----+---------------------------+------------------+-----+-----+
| E | Extern obj mailbox field | e.ext_obj.field | YES | YES |
+-----+---------------------------+------------------+-----+-----+
| F | Extern func mailbox field | f.ext_func.field | YES | YES |
+-----+---------------------------+------------------+-----+-----+
| T | Table action data field | t.header.field | NO | YES |
+-----+---------------------------+------------------+-----+-----+
| I | Immediate value (64-bit) | h.header.field | NO | YES |
+-----+---------------------------+------------------+-----+-----+
Instruction set:
+------------+----------------------+-------------------+------+--------+
| Instr. | Instruction | Instruction | 1st | 2nd |
| Name | Description | Format | opnd.| opnd. |
+------------+----------------------+-------------------+------+--------+
| rx | Receive one pkt | rx m.port_in | M | |
+------------+----------------------+-------------------+------+--------+
| tx | Transmit one pkt | tx m.port_out | M | |
+------------+----------------------+-------------------+------+--------+
| extract | Extract one hdr | extract h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| emit | Emit one hdr | emit h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| validate | Validate one hdr | validate h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| invalidate | Invalidate one hdr | invalidate h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| mov | dst = src | mov dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| add | dst += src | add dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| sub | dst -= src | add dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| ckadd | Checksum add: dst = | add dst src | HMEF | HMEFTI |
| | dst '+ src[0:1] '+ | | | or hdr |
| | src[2:3] '+ ... | | | |
+------------+----------------------+-------------------+------+--------+
| cksub | Checksum subtract: | add dst src | HMEF | HMEFTI |
| | dst = dst '- src | | | |
+------------+----------------------+-------------------+------+--------+
| and | dst &= src | and dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| or | dst |= src | or dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| xor | dst ^= src | xor dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| shl | dst <<= src | shl dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| shr | dst >>= src | shr dst src | HMEF | HMEFTI |
+------------+----------------------+-------------------+------+--------+
| table | Table lookup | table TABLE | tbl | |
+------------+----------------------+-------------------+------+--------+
| extern | Ext obj member func | extern e.obj.mfunc| ext | |
| | call or ext func call| extern f.func | | |
+------------+----------------------+-------------------+------+--------+
| jmp | Unconditional jump | jmp LABEL | | |
+------------+----------------------+-------------------+------+--------+
| jmpv | Jump if hdr is valid | jmpv LABEL h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| jmpnv | Jump if hdr is inval | jmpnv LABEL h.hdr | hdr | |
+------------+----------------------+-------------------+------+--------+
| jmph | Jump if tbl lkp hit | jmph LABEL | | |
+------------+----------------------+-------------------+------+--------+
| jmpnh | Jump if tbl lkp miss | jmpnh LABEL | | |
+------------+----------------------+-------------------+------+--------+
| jmpa | Jump if action run | jmpa LABEL ACTION | act | |
+------------+----------------------+-------------------+------+--------+
| jmpna | Jump if act not run | jmpna LABEL ACTION| act | |
+------------+----------------------+-------------------+------+--------+
| jmpeq | Jump if (a == b) | jmpeq LABEL a b | HMEFT| HMEFTI |
+------------+----------------------+-------------------+------+--------+
| jmpneq | Jump if (a != b) | jmpneq LABEL a b | HMEFT| HMEFTI |
+------------+----------------------+-------------------+------+--------+
| jmplt | Jump if (a < b) | jmplt LABEL a b | HMEFT| HMEFTI |
+------------+----------------------+-------------------+------+--------+
| jmpgt | Jump if (a > b) | jmpgt LABEL a b | HMEFT| HMEFTI |
+------------+----------------------+-------------------+------+--------+
| return | Return from action | return | | |
+------------+----------------------+-------------------+------+--------+
At initialization time, the pipeline and action instructions (including the symbolic name operands) are translated to internal data structures that are used at run-time. Pipeline action configure
[in] | p | Pipeline handle. |
[in] | name | Action name. |
[in] | args_struct_type_name | The struct type instantiated by the action data. The action data represent the action arguments that are stored in the table entry together with the action ID. Set to NULL when the action does not have any arguments. |
[in] | instructions | Action instructions. |
[in] | n_instructions | Number of action instructions. |
__rte_experimental int rte_swx_pipeline_table_type_register | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
enum rte_swx_table_match_type | match_type, | ||
struct rte_swx_table_ops * | ops | ||
) |
Pipeline table type register
[in] | p | Pipeline handle. |
[in] | name | Table type name. |
[in] | match_type | Match type implemented by the new table type. |
[in] | ops | Table type operations. |
__rte_experimental int rte_swx_pipeline_table_config | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
struct rte_swx_pipeline_table_params * | params, | ||
const char * | recommended_table_type_name, | ||
const char * | args, | ||
uint32_t | size | ||
) |
Pipeline table configure
[out] | p | Pipeline handle. |
[in] | name | Table name. |
[in] | params | Table parameters. |
[in] | recommended_table_type_name | Recommended table type. Typically set to NULL. Useful as guidance when there are multiple table types registered for the match type of the table, as determined from the table match fields specification. Silently ignored if the recommended table type does not exist or it serves a different match type. |
[in] | args | Table creation arguments. |
[in] | size | Guideline on maximum number of table entries. |
__rte_experimental int rte_swx_pipeline_selector_config | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
struct rte_swx_pipeline_selector_params * | params | ||
) |
Pipeline selector table configure
[out] | p | Pipeline handle. |
[in] | name | Selector table name. |
[in] | params | Selector table parameters. |
__rte_experimental int rte_swx_pipeline_regarray_config | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
uint32_t | size, | ||
uint64_t | init_val | ||
) |
Pipeline register array configure
[in] | p | Pipeline handle. |
[in] | name | Register array name. |
[in] | size | Number of registers in the array. Each register is 64-bit in size. |
[in] | init_val | Initial value for every register in the array. The recommended value is 0. |
__rte_experimental int rte_swx_pipeline_metarray_config | ( | struct rte_swx_pipeline * | p, |
const char * | name, | ||
uint32_t | size | ||
) |
Pipeline meter array configure
[in] | p | Pipeline handle. |
[in] | name | Meter array name. |
[in] | size | Number of meters in the array. Each meter in the array implements the Two Rate Three Color Marker (trTCM) algorithm, as specified by RFC 2698. |
__rte_experimental int rte_swx_pipeline_instructions_config | ( | struct rte_swx_pipeline * | p, |
const char ** | instructions, | ||
uint32_t | n_instructions | ||
) |
Pipeline instructions configure
[in] | p | Pipeline handle. |
[in] | instructions | Pipeline instructions. |
[in] | n_instructions | Number of pipeline instructions. |
__rte_experimental int rte_swx_pipeline_build | ( | struct rte_swx_pipeline * | p | ) |
Pipeline build
Once called, the pipeline build operation marks the end of pipeline configuration. At this point, all the internal data structures needed to run the pipeline are built.
[in] | p | Pipeline handle. |
__rte_experimental int rte_swx_pipeline_build_from_spec | ( | struct rte_swx_pipeline * | p, |
FILE * | spec, | ||
uint32_t * | err_line, | ||
const char ** | err_msg | ||
) |
Pipeline build from specification file
[in] | p | Pipeline handle. |
[in] | spec | Pipeline specification file. |
[out] | err_line | In case of error and non-NULL, the line number within the spec file where the error occurred. The first line number in the file is 1. |
[out] | err_msg | In case of error and non-NULL, the error message. |
__rte_experimental void rte_swx_pipeline_run | ( | struct rte_swx_pipeline * | p, |
uint32_t | n_instructions | ||
) |
Pipeline run
[in] | p | Pipeline handle. |
[in] | n_instructions | Number of instructions to execute. |
__rte_experimental void rte_swx_pipeline_flush | ( | struct rte_swx_pipeline * | p | ) |
Pipeline flush
Flush all output ports of the pipeline.
[in] | p | Pipeline handle. |
__rte_experimental void rte_swx_pipeline_free | ( | struct rte_swx_pipeline * | p | ) |
Pipeline free
[in] | p | Pipeline handle. |