DPDK
19.02.0
|
#include <stddef.h>
#include <stdint.h>
#include <rte_arp.h>
#include <rte_common.h>
#include <rte_ether.h>
#include <rte_eth_ctrl.h>
#include <rte_icmp.h>
#include <rte_ip.h>
#include <rte_sctp.h>
#include <rte_tcp.h>
#include <rte_udp.h>
#include <rte_byteorder.h>
#include <rte_esp.h>
Go to the source code of this file.
Functions | |
int | rte_flow_validate (uint16_t port_id, const struct rte_flow_attr *attr, const struct rte_flow_item pattern[], const struct rte_flow_action actions[], struct rte_flow_error *error) |
struct rte_flow * | rte_flow_create (uint16_t port_id, const struct rte_flow_attr *attr, const struct rte_flow_item pattern[], const struct rte_flow_action actions[], struct rte_flow_error *error) |
int | rte_flow_destroy (uint16_t port_id, struct rte_flow *flow, struct rte_flow_error *error) |
int | rte_flow_flush (uint16_t port_id, struct rte_flow_error *error) |
int | rte_flow_query (uint16_t port_id, struct rte_flow *flow, const struct rte_flow_action *action, void *data, struct rte_flow_error *error) |
int | rte_flow_isolate (uint16_t port_id, int set, struct rte_flow_error *error) |
int | rte_flow_error_set (struct rte_flow_error *error, int code, enum rte_flow_error_type type, const void *cause, const char *message) |
__rte_deprecated size_t | rte_flow_copy (struct rte_flow_desc *fd, size_t len, const struct rte_flow_attr *attr, const struct rte_flow_item *items, const struct rte_flow_action *actions) |
__rte_experimental int | rte_flow_conv (enum rte_flow_conv_op op, void *dst, size_t size, const void *src, struct rte_flow_error *error) |
RTE generic flow API
This interface provides the ability to program packet matching and associated actions in hardware through flow rules.
Definition in file rte_flow.h.
enum rte_flow_item_type |
Matching pattern item types.
Pattern items fall in two categories:
See the description of individual types for more information. Those marked with [META] fall into the second category.
RTE_FLOW_ITEM_TYPE_END |
[META] End marker for item lists. Prevents further processing of items, thereby ending the pattern. No associated specification structure. |
RTE_FLOW_ITEM_TYPE_VOID |
[META] Used as a placeholder for convenience. It is ignored and simply discarded by PMDs. No associated specification structure. |
RTE_FLOW_ITEM_TYPE_INVERT |
[META] Inverted matching, i.e. process packets that do not match the pattern. No associated specification structure. |
RTE_FLOW_ITEM_TYPE_ANY |
Matches any protocol in place of the current layer, a single ANY may also stand for several protocol layers. See struct rte_flow_item_any. |
RTE_FLOW_ITEM_TYPE_PF |
[META] Matches traffic originating from (ingress) or going to (egress) the physical function of the current device. No associated specification structure. |
RTE_FLOW_ITEM_TYPE_VF |
[META] Matches traffic originating from (ingress) or going to (egress) a given virtual function of the current device. See struct rte_flow_item_vf. |
RTE_FLOW_ITEM_TYPE_PHY_PORT |
[META] Matches traffic originating from (ingress) or going to (egress) a physical port of the underlying device. See struct rte_flow_item_phy_port. |
RTE_FLOW_ITEM_TYPE_PORT_ID |
[META] Matches traffic originating from (ingress) or going to (egress) a given DPDK port ID. See struct rte_flow_item_port_id. |
RTE_FLOW_ITEM_TYPE_RAW |
Matches a byte string of a given length at a given offset. See struct rte_flow_item_raw. |
RTE_FLOW_ITEM_TYPE_ETH |
Matches an Ethernet header. See struct rte_flow_item_eth. |
RTE_FLOW_ITEM_TYPE_VLAN |
Matches an 802.1Q/ad VLAN tag. See struct rte_flow_item_vlan. |
RTE_FLOW_ITEM_TYPE_IPV4 |
Matches an IPv4 header. See struct rte_flow_item_ipv4. |
RTE_FLOW_ITEM_TYPE_IPV6 |
Matches an IPv6 header. See struct rte_flow_item_ipv6. |
RTE_FLOW_ITEM_TYPE_ICMP |
Matches an ICMP header. See struct rte_flow_item_icmp. |
RTE_FLOW_ITEM_TYPE_UDP |
Matches a UDP header. See struct rte_flow_item_udp. |
RTE_FLOW_ITEM_TYPE_TCP |
Matches a TCP header. See struct rte_flow_item_tcp. |
RTE_FLOW_ITEM_TYPE_SCTP |
Matches a SCTP header. See struct rte_flow_item_sctp. |
RTE_FLOW_ITEM_TYPE_VXLAN |
Matches a VXLAN header. See struct rte_flow_item_vxlan. |
RTE_FLOW_ITEM_TYPE_E_TAG |
Matches a E_TAG header. See struct rte_flow_item_e_tag. |
RTE_FLOW_ITEM_TYPE_NVGRE |
Matches a NVGRE header. See struct rte_flow_item_nvgre. |
RTE_FLOW_ITEM_TYPE_MPLS |
Matches a MPLS header. See struct rte_flow_item_mpls. |
RTE_FLOW_ITEM_TYPE_GRE |
Matches a GRE header. See struct rte_flow_item_gre. |
RTE_FLOW_ITEM_TYPE_FUZZY |
[META] Fuzzy pattern match, expect faster than default. This is for device that support fuzzy matching option. Usually a fuzzy matching is fast but the cost is accuracy. See struct rte_flow_item_fuzzy. |
RTE_FLOW_ITEM_TYPE_GTP |
Matches a GTP header. Configure flow for GTP packets. See struct rte_flow_item_gtp. |
RTE_FLOW_ITEM_TYPE_GTPC |
Matches a GTP header. Configure flow for GTP-C packets. See struct rte_flow_item_gtp. |
RTE_FLOW_ITEM_TYPE_GTPU |
Matches a GTP header. Configure flow for GTP-U packets. See struct rte_flow_item_gtp. |
RTE_FLOW_ITEM_TYPE_ESP |
Matches a ESP header. See struct rte_flow_item_esp. |
RTE_FLOW_ITEM_TYPE_GENEVE |
Matches a GENEVE header. See struct rte_flow_item_geneve. |
RTE_FLOW_ITEM_TYPE_VXLAN_GPE |
Matches a VXLAN-GPE header. See struct rte_flow_item_vxlan_gpe. |
RTE_FLOW_ITEM_TYPE_ARP_ETH_IPV4 |
Matches an ARP header for Ethernet/IPv4. See struct rte_flow_item_arp_eth_ipv4. |
RTE_FLOW_ITEM_TYPE_IPV6_EXT |
Matches the presence of any IPv6 extension header. See struct rte_flow_item_ipv6_ext. |
RTE_FLOW_ITEM_TYPE_ICMP6 |
Matches any ICMPv6 header. See struct rte_flow_item_icmp6. |
RTE_FLOW_ITEM_TYPE_ICMP6_ND_NS |
Matches an ICMPv6 neighbor discovery solicitation. See struct rte_flow_item_icmp6_nd_ns. |
RTE_FLOW_ITEM_TYPE_ICMP6_ND_NA |
Matches an ICMPv6 neighbor discovery advertisement. See struct rte_flow_item_icmp6_nd_na. |
RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT |
Matches the presence of any ICMPv6 neighbor discovery option. See struct rte_flow_item_icmp6_nd_opt. |
RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT_SLA_ETH |
Matches an ICMPv6 neighbor discovery source Ethernet link-layer address option. See struct rte_flow_item_icmp6_nd_opt_sla_eth. |
RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT_TLA_ETH |
Matches an ICMPv6 neighbor discovery target Ethernet link-layer address option. See struct rte_flow_item_icmp6_nd_opt_tla_eth. |
RTE_FLOW_ITEM_TYPE_MARK |
Matches specified mark field. See struct rte_flow_item_mark. |
RTE_FLOW_ITEM_TYPE_META |
[META] Matches a metadata value specified in mbuf metadata field. See struct rte_flow_item_meta. |
Definition at line 116 of file rte_flow.h.
enum rte_flow_action_type |
Action types.
Each possible action is represented by a type. Some have associated configuration structures. Several actions combined in a list can be assigned to a flow rule and are performed in order.
They fall in three categories:
Flow rules being terminating by default, not specifying any action of the fate kind results in undefined behavior. This applies to both ingress and egress.
PASSTHRU, when supported, makes a flow rule non-terminating.
RTE_FLOW_ACTION_TYPE_END |
End marker for action lists. Prevents further processing of actions, thereby ending the list. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_VOID |
Used as a placeholder for convenience. It is ignored and simply discarded by PMDs. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_PASSTHRU |
Leaves traffic up for additional processing by subsequent flow rules; makes a flow rule non-terminating. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_JUMP |
RTE_FLOW_ACTION_TYPE_JUMP Redirects packets to a group on the current device. See struct rte_flow_action_jump. |
RTE_FLOW_ACTION_TYPE_MARK |
Attaches an integer value to packets and sets PKT_RX_FDIR and PKT_RX_FDIR_ID mbuf flags. See struct rte_flow_action_mark. |
RTE_FLOW_ACTION_TYPE_FLAG |
Flags packets. Similar to MARK without a specific value; only sets the PKT_RX_FDIR mbuf flag. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_QUEUE |
Assigns packets to a given queue index. See struct rte_flow_action_queue. |
RTE_FLOW_ACTION_TYPE_DROP |
Drops packets. PASSTHRU overrides this action if both are specified. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_COUNT |
Enables counters for this flow rule. These counters can be retrieved and reset through rte_flow_query(), see struct rte_flow_query_count. See struct rte_flow_action_count. |
RTE_FLOW_ACTION_TYPE_RSS |
Similar to QUEUE, except RSS is additionally performed on packets to spread them among several queues according to the provided parameters. See struct rte_flow_action_rss. |
RTE_FLOW_ACTION_TYPE_PF |
Directs matching traffic to the physical function (PF) of the current device. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_VF |
Directs matching traffic to a given virtual function of the current device. See struct rte_flow_action_vf. |
RTE_FLOW_ACTION_TYPE_PHY_PORT |
Directs packets to a given physical port index of the underlying device. See struct rte_flow_action_phy_port. |
RTE_FLOW_ACTION_TYPE_PORT_ID |
Directs matching traffic to a given DPDK port ID. See struct rte_flow_action_port_id. |
RTE_FLOW_ACTION_TYPE_METER |
Traffic metering and policing (MTR). See struct rte_flow_action_meter. See file rte_mtr.h for MTR object configuration. |
RTE_FLOW_ACTION_TYPE_SECURITY |
Redirects packets to security engine of current device for security processing as specified by security session. See struct rte_flow_action_security. |
RTE_FLOW_ACTION_TYPE_OF_SET_MPLS_TTL |
Implements OFPAT_SET_MPLS_TTL ("MPLS TTL") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_set_mpls_ttl. |
RTE_FLOW_ACTION_TYPE_OF_DEC_MPLS_TTL |
Implements OFPAT_DEC_MPLS_TTL ("decrement MPLS TTL") as defined by the OpenFlow Switch Specification. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_OF_SET_NW_TTL |
Implements OFPAT_SET_NW_TTL ("IP TTL") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_set_nw_ttl. |
RTE_FLOW_ACTION_TYPE_OF_DEC_NW_TTL |
Implements OFPAT_DEC_NW_TTL ("decrement IP TTL") as defined by the OpenFlow Switch Specification. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_OF_COPY_TTL_OUT |
Implements OFPAT_COPY_TTL_OUT ("copy TTL "outwards" – from next-to-outermost to outermost") as defined by the OpenFlow Switch Specification. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_OF_COPY_TTL_IN |
Implements OFPAT_COPY_TTL_IN ("copy TTL "inwards" – from outermost to next-to-outermost") as defined by the OpenFlow Switch Specification. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_OF_POP_VLAN |
Implements OFPAT_POP_VLAN ("pop the outer VLAN tag") as defined by the OpenFlow Switch Specification. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_OF_PUSH_VLAN |
Implements OFPAT_PUSH_VLAN ("push a new VLAN tag") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_push_vlan. |
RTE_FLOW_ACTION_TYPE_OF_SET_VLAN_VID |
Implements OFPAT_SET_VLAN_VID ("set the 802.1q VLAN id") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_set_vlan_vid. |
RTE_FLOW_ACTION_TYPE_OF_SET_VLAN_PCP |
Implements OFPAT_SET_LAN_PCP ("set the 802.1q priority") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_set_vlan_pcp. |
RTE_FLOW_ACTION_TYPE_OF_POP_MPLS |
Implements OFPAT_POP_MPLS ("pop the outer MPLS tag") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_pop_mpls. |
RTE_FLOW_ACTION_TYPE_OF_PUSH_MPLS |
Implements OFPAT_PUSH_MPLS ("push a new MPLS tag") as defined by the OpenFlow Switch Specification. See struct rte_flow_action_of_push_mpls. |
RTE_FLOW_ACTION_TYPE_VXLAN_ENCAP |
Encapsulate flow in VXLAN tunnel as defined in rte_flow_action_vxlan_encap action structure. See struct rte_flow_action_vxlan_encap. |
RTE_FLOW_ACTION_TYPE_VXLAN_DECAP |
Decapsulate outer most VXLAN tunnel from matched flow. If flow pattern does not define a valid VXLAN tunnel (as specified by RFC7348) then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. |
RTE_FLOW_ACTION_TYPE_NVGRE_ENCAP |
Encapsulate flow in NVGRE tunnel defined in the rte_flow_action_nvgre_encap action structure. See struct rte_flow_action_nvgre_encap. |
RTE_FLOW_ACTION_TYPE_NVGRE_DECAP |
Decapsulate outer most NVGRE tunnel from matched flow. If flow pattern does not define a valid NVGRE tunnel (as specified by RFC7637) then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. |
RTE_FLOW_ACTION_TYPE_RAW_ENCAP |
Add outer header whose template is provided in its data buffer See struct rte_flow_action_raw_encap. |
RTE_FLOW_ACTION_TYPE_RAW_DECAP |
Remove outer header whose template is provided in its data buffer. See struct rte_flow_action_raw_decap |
RTE_FLOW_ACTION_TYPE_SET_IPV4_SRC |
Modify IPv4 source address in the outermost IPv4 header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV4, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_ipv4. |
RTE_FLOW_ACTION_TYPE_SET_IPV4_DST |
Modify IPv4 destination address in the outermost IPv4 header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV4, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_ipv4. |
RTE_FLOW_ACTION_TYPE_SET_IPV6_SRC |
Modify IPv6 source address in the outermost IPv6 header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV6, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_ipv6. |
RTE_FLOW_ACTION_TYPE_SET_IPV6_DST |
Modify IPv6 destination address in the outermost IPv6 header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV6, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_ipv6. |
RTE_FLOW_ACTION_TYPE_SET_TP_SRC |
Modify source port number in the outermost TCP/UDP header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_TCP or RTE_FLOW_ITEM_TYPE_UDP, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_tp. |
RTE_FLOW_ACTION_TYPE_SET_TP_DST |
Modify destination port number in the outermost TCP/UDP header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_TCP or RTE_FLOW_ITEM_TYPE_UDP, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_tp. |
RTE_FLOW_ACTION_TYPE_MAC_SWAP |
Swap the source and destination MAC addresses in the outermost Ethernet header. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_ETH, then the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_DEC_TTL |
Decrease TTL value directly No associated configuration structure. |
RTE_FLOW_ACTION_TYPE_SET_TTL |
Set TTL value See struct rte_flow_action_set_ttl |
RTE_FLOW_ACTION_TYPE_SET_MAC_SRC |
Set source MAC address from matched flow. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_ETH, the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_mac. |
RTE_FLOW_ACTION_TYPE_SET_MAC_DST |
Set destination MAC address from matched flow. If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_ETH, the PMD should return a RTE_FLOW_ERROR_TYPE_ACTION error. See struct rte_flow_action_set_mac. |
Definition at line 1270 of file rte_flow.h.
enum rte_flow_error_type |
Verbose error types.
Most of them provide the type of the object referenced by struct rte_flow_error.cause.
Definition at line 2151 of file rte_flow.h.
enum rte_flow_conv_op |
Conversion operations for flow API objects.
RTE_FLOW_CONV_OP_NONE |
No operation to perform. rte_flow_conv() simply returns 0. |
RTE_FLOW_CONV_OP_ATTR |
Convert attributes structure. This is a basic copy of an attributes structure.
|
RTE_FLOW_CONV_OP_ITEM |
Convert a single item. Duplicates
|
RTE_FLOW_CONV_OP_ACTION |
Convert a single action. Duplicates
|
RTE_FLOW_CONV_OP_PATTERN |
Convert an entire pattern. Duplicates all pattern items at once with the same constraints as RTE_FLOW_CONV_OP_ITEM.
|
RTE_FLOW_CONV_OP_ACTIONS |
Convert a list of actions. Duplicates the entire list of actions at once with the same constraints as RTE_FLOW_CONV_OP_ACTION.
|
RTE_FLOW_CONV_OP_RULE |
Convert a complete flow rule description. Comprises attributes, pattern and actions together at once with the usual constraints.
|
RTE_FLOW_CONV_OP_ITEM_NAME |
Convert item type to its name string. Writes a NUL-terminated string to
|
RTE_FLOW_CONV_OP_ACTION_NAME |
Convert action type to its name string. Writes a NUL-terminated string to
|
RTE_FLOW_CONV_OP_ITEM_NAME_PTR |
Convert item type to pointer to item name. Retrieves item name pointer from its type. The string itself is not copied; instead, a unique pointer to an internal static constant storage is written to
|
RTE_FLOW_CONV_OP_ACTION_NAME_PTR |
Convert action type to pointer to action name. Retrieves action name pointer from its type. The string itself is not copied; instead, a unique pointer to an internal static constant storage is written to
|
Definition at line 2217 of file rte_flow.h.
int rte_flow_validate | ( | uint16_t | port_id, |
const struct rte_flow_attr * | attr, | ||
const struct rte_flow_item | pattern[], | ||
const struct rte_flow_action | actions[], | ||
struct rte_flow_error * | error | ||
) |
Check whether a flow rule can be created on a given port.
The flow rule is validated for correctness and whether it could be accepted by the device given sufficient resources. The rule is checked against the current device mode and queue configuration. The flow rule may also optionally be validated against existing flow rules and device resources. This function has no effect on the target device.
The returned value is guaranteed to remain valid only as long as no successful calls to rte_flow_create() or rte_flow_destroy() are made in the meantime and no device parameter affecting flow rules in any way are modified, due to possible collisions or resource limitations (although in such cases EINVAL should not be returned).
port_id | Port identifier of Ethernet device. | |
[in] | attr | Flow rule attributes. |
[in] | pattern | Pattern specification (list terminated by the END pattern item). |
[in] | actions | Associated actions (list terminated by the END action). |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
-ENOSYS: underlying device does not support this functionality.
-EIO: underlying device is removed.
-EINVAL: unknown or invalid rule specification.
-ENOTSUP: valid but unsupported rule specification (e.g. partial bit-masks are unsupported).
-EEXIST: collision with an existing rule. Only returned if device supports flow rule collision checking and there was a flow rule collision. Not receiving this return code is no guarantee that creating the rule will not fail due to a collision.
-ENOMEM: not enough memory to execute the function, or if the device supports resource validation, resource limitation on the device.
-EBUSY: action cannot be performed due to busy device resources, may succeed if the affected queues or even the entire port are in a stopped state (see rte_eth_dev_rx_queue_stop() and rte_eth_dev_stop()).
|
read |
Create a flow rule on a given port.
port_id | Port identifier of Ethernet device. | |
[in] | attr | Flow rule attributes. |
[in] | pattern | Pattern specification (list terminated by the END pattern item). |
[in] | actions | Associated actions (list terminated by the END action). |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
int rte_flow_destroy | ( | uint16_t | port_id, |
struct rte_flow * | flow, | ||
struct rte_flow_error * | error | ||
) |
Destroy a flow rule on a given port.
Failure to destroy a flow rule handle may occur when other flow rules depend on it, and destroying it would result in an inconsistent state.
This function is only guaranteed to succeed if handles are destroyed in reverse order of their creation.
port_id | Port identifier of Ethernet device. | |
flow | Flow rule handle to destroy. | |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
int rte_flow_flush | ( | uint16_t | port_id, |
struct rte_flow_error * | error | ||
) |
Destroy all flow rules associated with a port.
In the unlikely event of failure, handles are still considered destroyed and no longer valid but the port must be assumed to be in an inconsistent state.
port_id | Port identifier of Ethernet device. | |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
int rte_flow_query | ( | uint16_t | port_id, |
struct rte_flow * | flow, | ||
const struct rte_flow_action * | action, | ||
void * | data, | ||
struct rte_flow_error * | error | ||
) |
Query an existing flow rule.
This function allows retrieving flow-specific data such as counters. Data is gathered by special actions which must be present in the flow rule definition.
port_id | Port identifier of Ethernet device. | |
flow | Flow rule handle to query. | |
action | Action definition as defined in original flow rule. | |
[in,out] | data | Pointer to storage for the associated query data type. |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
int rte_flow_isolate | ( | uint16_t | port_id, |
int | set, | ||
struct rte_flow_error * | error | ||
) |
Restrict ingress traffic to the defined flow rules.
Isolated mode guarantees that all ingress traffic comes from defined flow rules only (current and future).
Besides making ingress more deterministic, it allows PMDs to safely reuse resources otherwise assigned to handle the remaining traffic, such as global RSS configuration settings, VLAN filters, MAC address entries, legacy filter API rules and so on in order to expand the set of possible flow rule types.
Calling this function as soon as possible after device initialization, ideally before the first call to rte_eth_dev_configure(), is recommended to avoid possible failures due to conflicting settings.
Once effective, leaving isolated mode may not be possible depending on PMD implementation.
Additionally, the following functionality has no effect on the underlying port and may return errors such as ENOTSUP ("not supported"):
port_id | Port identifier of Ethernet device. | |
set | Nonzero to enter isolated mode, attempt to leave it otherwise. | |
[out] | error | Perform verbose error reporting if not NULL. PMDs initialize this structure in case of error only. |
int rte_flow_error_set | ( | struct rte_flow_error * | error, |
int | code, | ||
enum rte_flow_error_type | type, | ||
const void * | cause, | ||
const char * | message | ||
) |
Initialize flow error structure.
[out] | error | Pointer to flow error structure (may be NULL). |
code | Related error code (rte_errno). | |
type | Cause field and error types. | |
cause | Object responsible for the error. | |
message | Human-readable error message. |
__rte_deprecated size_t rte_flow_copy | ( | struct rte_flow_desc * | fd, |
size_t | len, | ||
const struct rte_flow_attr * | attr, | ||
const struct rte_flow_item * | items, | ||
const struct rte_flow_action * | actions | ||
) |
This interface is kept for compatibility with older applications but is implemented as a wrapper to rte_flow_conv(). It is deprecated due to its lack of flexibility and reliance on a type unusable with C++ programs (struct rte_flow_desc).
[in] | fd | Flow rule description. |
[in] | len | Total size of allocated data for the flow description. |
[in] | attr | Flow rule attributes. |
[in] | items | Pattern specification (list terminated by the END pattern item). |
[in] | actions | Associated actions (list terminated by the END action). |
__rte_experimental int rte_flow_conv | ( | enum rte_flow_conv_op | op, |
void * | dst, | ||
size_t | size, | ||
const void * | src, | ||
struct rte_flow_error * | error | ||
) |
Flow object conversion helper.
This function performs conversion of various flow API objects to a pre-allocated destination buffer. See enum rte_flow_conv_op for possible operations and details about each of them.
Since destination buffer must be large enough, it works in a manner reminiscent of snprintf():
size
is 0, dst
may be a NULL pointer, otherwise dst
must be non-NULL.src
to dst
according to op
regardless of the size
parameter.size
bytes can be written to dst
, output is truncated and may be inconsistent when the returned value is larger than that.dst
contents are unspecified.op | Operation to perform, related to the object type of dst . | |
[out] | dst | Destination buffer address. Must be suitably aligned by the caller. |
size | Destination buffer size in bytes. | |
[in] | src | Source object to copy. Depending on op , its type may differ from that of dst . |
[out] | error | Perform verbose error reporting if not NULL. Initialized in case of error only. |
src
to dst
on success, a negative errno value otherwise and rte_errno is set.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ANY.
Definition at line 444 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_VF.
Definition at line 473 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_PHY_PORT.
Definition at line 504 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_PORT_ID.
Definition at line 530 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_RAW.
Definition at line 565 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ETH.
Definition at line 595 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_VLAN.
Definition at line 618 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_IPV4.
Definition at line 637 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_IPV6.
Definition at line 659 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP.
Definition at line 682 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_UDP.
Definition at line 701 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_TCP.
Definition at line 720 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_SCTP.
Definition at line 739 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_VXLAN.
Definition at line 761 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_E_TAG.
Definition at line 789 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_NVGRE.
Definition at line 814 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_MPLS.
Definition at line 834 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_GRE.
Definition at line 855 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_FUZZY.
Definition at line 883 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_GTP.
Definition at line 908 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ESP.
Definition at line 924 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_GENEVE.
Definition at line 949 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_VXLAN_GPE.
Definition at line 969 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ARP_ETH_IPV4.
Definition at line 994 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_IPV6_EXT.
Definition at line 1019 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6.
Definition at line 1037 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6_ND_NS.
Definition at line 1059 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6_ND_NA.
Definition at line 1086 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT.
Definition at line 1112 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT_SLA_ETH.
Definition at line 1137 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_ICMP6_ND_OPT_TLA_ETH.
Definition at line 1162 of file rte_flow.h.
|
static |
Default mask for RTE_FLOW_ITEM_TYPE_META.
Definition at line 1178 of file rte_flow.h.