[dpdk-dev,v3,4/4] ethdev: add VLAN and MPLS pop push action in flow API
Checks
Commit Message
Add couple Openflow frienldy VLAN/MPLS push/pop actions.
RTE_FLOW_ACTION_VLAN_POP - pop a VLAN header.
RTE_FLOW_ACTION_VLAN_PUSH - push a VLAN header.
RTE_FLOW_ACTION_MPLS_POP - pop a MPLS header.
RTE_FLOW_ACTION_MPLS_PUSH - push a MPLS header.
Signed-off-by: Qi Zhang <qi.z.zhang@intel.com>
---
app/test-pmd/cmdline_flow.c | 82 +++++++++++++++++++++++++++++
doc/guides/prog_guide/rte_flow.rst | 69 ++++++++++++++++++++++++
doc/guides/testpmd_app_ug/testpmd_funcs.rst | 14 +++++
lib/librte_ether/rte_flow.h | 71 +++++++++++++++++++++++++
4 files changed, 236 insertions(+)
Comments
Monday, April 16, 2018 9:11 AM, Qi Zhang:
> Subject: [dpdk-dev] [PATCH v3 4/4] ethdev: add VLAN and MPLS pop push
> action in flow API
>
> Add couple Openflow frienldy VLAN/MPLS push/pop actions.
>
> RTE_FLOW_ACTION_VLAN_POP - pop a VLAN header.
> RTE_FLOW_ACTION_VLAN_PUSH - push a VLAN header.
> RTE_FLOW_ACTION_MPLS_POP - pop a MPLS header.
> RTE_FLOW_ACTION_MPLS_PUSH - push a MPLS header.
>
> Signed-off-by: Qi Zhang <qi.z.zhang@intel.com>
> ---
> /**
> @@ -1501,6 +1536,42 @@ struct rte_flow_action_ip_ttl_dec { };
>
> /**
> + * RTE_FLOW_ACTION_TYPE_VLAN_PUSH,
> + *
> + * Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8
> + * should be used. The value of VLAN ID and VLAN priority for the new
> + * header is copied from an exist outermost VLAN header in the packet,
> + * they will be set to 0 if no such VLAN header exist.
> + */
> +struct rte_flow_action_vlan_push {
> + rte_be16_t ether_type; /**< Ethertype for vlan tag. */ };
> +
I may have missed this also in the previous discussions.
But why limit the VLAN ID and prio to 0 if not exists?
Why not to enable the application to define the full VLAN header it wants to push? The default, if application hasn't specified any, can be what you suggest.
> +/**
> + * RTE_FLOW_ACTION_TYPE_MPLS_POP,
> + *
> + * Pop the outer-most MPLS header from the packet, Ethertype is
> + * required for the resulting packet if it is not the last MPLS
> + * header be popped, Ethertype must be 0x8847 or 0x8848.
> + */
> +struct rte_flow_action_mpls_pop {
> + rte_be16_t ether_type; /**< Ethertype for MPLS header */ };
> +
> +/**
> + * RTE_FLOW_ACTION_TYPE_MPLS_PUSH,
> + *
> + * Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848
> + * should be used. The value of MPLS label and traffic class are copied
> + * from exist outermost MPLS header, and TTL is copied from exist
> +outermost
I guess those are derived from OF spec.
> + * MPLS or IP header, they will be set to 0, if exist packet does not
> + * contain required header.
> + */
> +struct rte_flow_action_mpls_push {
> + rte_be16_t ether_type; /**< Ethertype for MPLS header */ };
> +
Same question as above - why not let the user to specify its MPLS header and have what you suggest as default behavior?
> +/**
> * Definition of a single action.
> *
> * A list of actions is terminated by a END action.
> --
> 2.13.6
On Mon, Apr 16, 2018 at 02:10:42PM +0800, Qi Zhang wrote:
> Add couple Openflow frienldy VLAN/MPLS push/pop actions.
Openflow => OpenFlow
frienldy => friendly
>
> RTE_FLOW_ACTION_VLAN_POP - pop a VLAN header.
> RTE_FLOW_ACTION_VLAN_PUSH - push a VLAN header.
> RTE_FLOW_ACTION_MPLS_POP - pop a MPLS header.
> RTE_FLOW_ACTION_MPLS_PUSH - push a MPLS header.
>
> Signed-off-by: Qi Zhang <qi.z.zhang@intel.com>
Same fundamental comment as for the previous patch ("ethdev: add TTL change
actions in flow API"), "OF" must be part of the name of these new actions,
e.g.:
RTE_FLOW_ACTION_OF_VLAN_POP
More below.
> ---
> app/test-pmd/cmdline_flow.c | 82 +++++++++++++++++++++++++++++
> doc/guides/prog_guide/rte_flow.rst | 69 ++++++++++++++++++++++++
> doc/guides/testpmd_app_ug/testpmd_funcs.rst | 14 +++++
> lib/librte_ether/rte_flow.h | 71 +++++++++++++++++++++++++
> 4 files changed, 236 insertions(+)
>
> diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c
> index 417cbecc9..736d79bef 100644
> --- a/app/test-pmd/cmdline_flow.c
> +++ b/app/test-pmd/cmdline_flow.c
> @@ -201,6 +201,13 @@ enum index {
> ACTION_IP_TTL_DEC_LVL,
> ACTION_TTL_COPY_OUT,
> ACTION_TTL_COPY_IN,
> + ACTION_VLAN_POP,
> + ACTION_VLAN_PUSH,
> + ACTION_VLAN_PUSH_TYPE,
> + ACTION_MPLS_POP,
> + ACTION_MPLS_POP_TYPE,
> + ACTION_MPLS_PUSH,
> + ACTION_MPLS_PUSH_TYPE,
> };
>
> /** Size of pattern[] field in struct rte_flow_item_raw. */
> @@ -678,6 +685,10 @@ static const enum index next_action[] = {
> ACTION_IP_TTL_DEC,
> ACTION_TTL_COPY_OUT,
> ACTION_TTL_COPY_IN,
> + ACTION_VLAN_POP,
> + ACTION_VLAN_PUSH,
> + ACTION_MPLS_POP,
> + ACTION_MPLS_PUSH,
> ZERO,
> };
>
> @@ -728,6 +739,21 @@ static const enum index action_ip_ttl_dec[] = {
> ZERO,
> };
>
> +static const enum index action_vlan_push[] = {
> + ACTION_VLAN_PUSH_TYPE,
> + ZERO,
> +};
> +
> +static const enum index action_mpls_pop[] = {
> + ACTION_MPLS_POP_TYPE,
> + ZERO,
> +};
> +
> +static const enum index action_mpls_push[] = {
> + ACTION_MPLS_PUSH_TYPE,
> + ZERO,
> +};
> +
> static int parse_init(struct context *, const struct token *,
> const char *, unsigned int,
> void *, unsigned int);
> @@ -1921,6 +1947,62 @@ static const struct token token_list[] = {
> .next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> .call = parse_vc,
> },
> +
> + [ACTION_VLAN_POP] = {
> + .name = "vlan_pop",
vlan_pop => of_vlan_pop
> + .help = "pop the outermost VLAN header.",
These help strings shouldn't be terminated with a "." for consistency.
> + .priv = PRIV_ACTION(DROP, 0),
DROP => OF_VLAN_POP
> + .next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> + .call = parse_vc,
> + },
> + [ACTION_VLAN_PUSH] = {
> + .name = "vlan_push",
vlan_push => of_vlan_push
> + .help = "push new VLAN header onto the packet",
> + .priv = PRIV_ACTION(VLAN_PUSH,
> + sizeof(struct rte_flow_action_vlan_push)),
> + .next = NEXT(action_vlan_push),
> + .call = parse_vc,
> + },
> + [ACTION_VLAN_PUSH_TYPE] = {
> + .name = "type",
> + .help = "Ethertype of VLAN header",
> + .next = NEXT(action_vlan_push, NEXT_ENTRY(UNSIGNED)),
Ethertype => EtherType (here and everywhere else, this is the official name
for that field)
> + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_vlan_push,
> + ether_type)),
> + .call = parse_vc,
> + },
> + [ACTION_MPLS_POP] = {
> + .name = "mpls_pop",
mpls_pop => of_mpls_pop
> + .help = "pop the outermost MPLS header",
> + .priv = PRIV_ACTION(MPLS_POP,
> + sizeof(struct rte_flow_action_mpls_pop)),
> + .next = NEXT(action_mpls_pop),
> + .call = parse_vc,
> + },
> + [ACTION_MPLS_POP_TYPE] = {
> + .name = "type",
> + .help = "Ethertype of MPLS header",
> + .next = NEXT(action_mpls_pop, NEXT_ENTRY(UNSIGNED)),
> + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_mpls_pop,
> + ether_type)),
> + .call = parse_vc,
> + },
> + [ACTION_MPLS_PUSH] = {
> + .name = "mpls_push",
mpls_push => of_mpls_push
> + .help = "push new MPLS header onto the packet",
> + .priv = PRIV_ACTION(MPLS_PUSH,
> + sizeof(struct rte_flow_action_mpls_push)),
> + .next = NEXT(action_mpls_push),
> + .call = parse_vc,
> + },
> + [ACTION_MPLS_PUSH_TYPE] = {
> + .name = "type",
> + .help = "Ethertype of MPLS header",
> + .next = NEXT(action_mpls_push, NEXT_ENTRY(UNSIGNED)),
> + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_mpls_push,
> + ether_type)),
> + .call = parse_vc,
> + },
> };
>
> /** Remove and return last entry from argument stack. */
> diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst
> index 65f2d4a16..a009f1aac 100644
> --- a/doc/guides/prog_guide/rte_flow.rst
> +++ b/doc/guides/prog_guide/rte_flow.rst
> @@ -1684,6 +1684,75 @@ required MPLS or IP headers.
> | no properties |
> +---------------+
>
> +Action: ``ACTION_VLAN_POP``
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> +Pop the outer-most VLAN header from the packet.
> +
> +.. _table_rte_flow_action_vlan_pop:
> +
> +.. table:: VLAN_POP
> +
> + +---------------+
> + | Field |
> + +===============+
> + | no properties |
> + +---------------+
Missing reference to OF specification etc.
> +
> +Action: ``ACTION_VLAN_PUSH``
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> +Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8 should
> +be used. The value of VLAN ID and VLAN priority for the new header is copied
> +from an exist VLAN header in the packet, they will be set to 0 if no such
> +VLAN header exist.
> +
> +.. _table_rte_flow_action_vlan_push:
> +
> +.. table:: VLAN_PUSH
> +
> + +----------------+------------------------+
> + | Field | Value |
> + +================+========================+
> + | ``ether_type`` | Ethertype for VLAN tag |
> + +----------------+------------------------+
Beside the missing reference to OF specification, I think this patch should
also provide a "VLAN action change" action, otherwise what's the point of
pushing a VLAN header without the ability to pick a VID?
(see ofp_action_vlan_vid).
> +
> +Action: ``ACTION_MPLS_POP``
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> +Pop the outer-most MPLS header from the packet, Ethertype is required for
> +the resulting packet if it is not the last MPLS header be popped, Ethertype
> +must be 0x8847 or 0x8848.
> +
> +.. _table_rte_flow_action_mpls_pop:
> +
> +.. table:: MPLS_POP
> +
> + +----------------+---------------------------+
> + | Field | Value |
> + +================+===========================+
> + | ``ether_type`` | Ethertype for MPLS header |
> + +----------------+---------------------------+
Name this field "ethertype" (without "_") like its OF counterpart.
> +
> +Action: ``ACTION_MPLS_PUSH``
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> +Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848 should
> +be used. The value of MPLS label and traffic class is copied from exist
> +outermost MPLS header, and TTL is copied from exist outermost MPLS or IP
> +header, they will be set to 0 if exist packet does not contain required
> +header.
> +
> +.. _table_rte_flow_action_mpls_push:
> +
> +.. table:: MPLS_PUSH
> +
> + +----------------+---------------------------+
> + | Field | Value |
> + +================+===========================+
> + | ``ether_type`` | Ethertype for MPLS header |
> + +----------------+---------------------------+
Ditto.
> +
> Negative types
> ~~~~~~~~~~~~~~
>
> diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> index d2fe6637b..c06f2f0b0 100644
> --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> @@ -3461,6 +3461,20 @@ This section lists supported actions and their attributes, if any.
>
> - ``ttl_copy_in``: copy TTL inwards.
>
> +- ``vlan_pop``: pop the outermost VLAN header.
> +
> +- ``vlan_push``: push new VLAN header onto the packet.
> +
> + - ``type``: Ethertype of the VLAN header.
> +
> +- ``mpls_pop``: pop the outermost MPLS header.
> +
> + - ``type``: Ethertype of the MPLS header.
> +
> +- ``mpls_push``: push new MPLS header onto the packet.
> +
> + - ``type``: Ethertype of the MPLS header.
> +
> Destroying flow rules
> ~~~~~~~~~~~~~~~~~~~~~
>
> diff --git a/lib/librte_ether/rte_flow.h b/lib/librte_ether/rte_flow.h
> index ab181cd83..c5b30363e 100644
> --- a/lib/librte_ether/rte_flow.h
> +++ b/lib/librte_ether/rte_flow.h
> @@ -1285,6 +1285,41 @@ enum rte_flow_action_type {
> * packets that contain required protocol headers.
> */
> RTE_FLOW_ACTION_TYPE_TTL_COPY_IN,
> +
> + /**
> + * Pop the outer-most VLAN header from the packet.
As for other actions without one, please add:
No associated configuration structure.
> + */
> + RTE_FLOW_ACTION_TYPE_VLAN_POP,
> +
> + /**
> + * Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8
> + * should be used. The value of VLAN ID and VLAN priority for the new
> + * header is copied from an exist VLAN header in the packet, they will
> + * be set to 0 if no such VLAN header exist.
> + *
> + * See struct rte_flow_action_vlan_push.
> + */
> + RTE_FLOW_ACTION_TYPE_VLAN_PUSH,
> +
> + /**
> + * Pop the outer-most MPLS header from the packet, Ethertype is
> + * required for the resulting packet if it is not the last MPLS
> + * header be popped, Ethertype must be 0x8847 or 0x8848.
> + *
> + * See struct rte_flow_action_mpls_pop.
> + */
> + RTE_FLOW_ACTION_TYPE_MPLS_POP,
> +
> + /**
> + * Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848
> + * should be used. The value of MPLS label and traffic class is copied
> + * from exist outermost MPLS header, and TTL is copied from exist
> + * outermost MPLS or IP header, they will be set to 0 if exist packet
> + * does not contain required header.
> + *
> + * See struct rte_flow_action_mpls_push.
> + */
> + RTE_FLOW_ACTION_TYPE_MPLS_PUSH,
> };
>
> /**
> @@ -1501,6 +1536,42 @@ struct rte_flow_action_ip_ttl_dec {
> };
>
> /**
> + * RTE_FLOW_ACTION_TYPE_VLAN_PUSH,
> + *
> + * Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8
> + * should be used. The value of VLAN ID and VLAN priority for the new
> + * header is copied from an exist outermost VLAN header in the packet,
> + * they will be set to 0 if no such VLAN header exist.
> + */
> +struct rte_flow_action_vlan_push {
> + rte_be16_t ether_type; /**< Ethertype for vlan tag. */
> +};
> +
> +/**
> + * RTE_FLOW_ACTION_TYPE_MPLS_POP,
> + *
> + * Pop the outer-most MPLS header from the packet, Ethertype is
> + * required for the resulting packet if it is not the last MPLS
> + * header be popped, Ethertype must be 0x8847 or 0x8848.
> + */
> +struct rte_flow_action_mpls_pop {
> + rte_be16_t ether_type; /**< Ethertype for MPLS header */
> +};
> +
> +/**
> + * RTE_FLOW_ACTION_TYPE_MPLS_PUSH,
> + *
> + * Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848
> + * should be used. The value of MPLS label and traffic class are copied
> + * from exist outermost MPLS header, and TTL is copied from exist outermost
> + * MPLS or IP header, they will be set to 0, if exist packet does not
> + * contain required header.
> + */
> +struct rte_flow_action_mpls_push {
> + rte_be16_t ether_type; /**< Ethertype for MPLS header */
> +};
> +
> +/**
> * Definition of a single action.
> *
> * A list of actions is terminated by a END action.
> --
> 2.13.6
>
@@ -201,6 +201,13 @@ enum index {
ACTION_IP_TTL_DEC_LVL,
ACTION_TTL_COPY_OUT,
ACTION_TTL_COPY_IN,
+ ACTION_VLAN_POP,
+ ACTION_VLAN_PUSH,
+ ACTION_VLAN_PUSH_TYPE,
+ ACTION_MPLS_POP,
+ ACTION_MPLS_POP_TYPE,
+ ACTION_MPLS_PUSH,
+ ACTION_MPLS_PUSH_TYPE,
};
/** Size of pattern[] field in struct rte_flow_item_raw. */
@@ -678,6 +685,10 @@ static const enum index next_action[] = {
ACTION_IP_TTL_DEC,
ACTION_TTL_COPY_OUT,
ACTION_TTL_COPY_IN,
+ ACTION_VLAN_POP,
+ ACTION_VLAN_PUSH,
+ ACTION_MPLS_POP,
+ ACTION_MPLS_PUSH,
ZERO,
};
@@ -728,6 +739,21 @@ static const enum index action_ip_ttl_dec[] = {
ZERO,
};
+static const enum index action_vlan_push[] = {
+ ACTION_VLAN_PUSH_TYPE,
+ ZERO,
+};
+
+static const enum index action_mpls_pop[] = {
+ ACTION_MPLS_POP_TYPE,
+ ZERO,
+};
+
+static const enum index action_mpls_push[] = {
+ ACTION_MPLS_PUSH_TYPE,
+ ZERO,
+};
+
static int parse_init(struct context *, const struct token *,
const char *, unsigned int,
void *, unsigned int);
@@ -1921,6 +1947,62 @@ static const struct token token_list[] = {
.next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
.call = parse_vc,
},
+
+ [ACTION_VLAN_POP] = {
+ .name = "vlan_pop",
+ .help = "pop the outermost VLAN header.",
+ .priv = PRIV_ACTION(DROP, 0),
+ .next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
+ .call = parse_vc,
+ },
+ [ACTION_VLAN_PUSH] = {
+ .name = "vlan_push",
+ .help = "push new VLAN header onto the packet",
+ .priv = PRIV_ACTION(VLAN_PUSH,
+ sizeof(struct rte_flow_action_vlan_push)),
+ .next = NEXT(action_vlan_push),
+ .call = parse_vc,
+ },
+ [ACTION_VLAN_PUSH_TYPE] = {
+ .name = "type",
+ .help = "Ethertype of VLAN header",
+ .next = NEXT(action_vlan_push, NEXT_ENTRY(UNSIGNED)),
+ .args = ARGS(ARGS_ENTRY(struct rte_flow_action_vlan_push,
+ ether_type)),
+ .call = parse_vc,
+ },
+ [ACTION_MPLS_POP] = {
+ .name = "mpls_pop",
+ .help = "pop the outermost MPLS header",
+ .priv = PRIV_ACTION(MPLS_POP,
+ sizeof(struct rte_flow_action_mpls_pop)),
+ .next = NEXT(action_mpls_pop),
+ .call = parse_vc,
+ },
+ [ACTION_MPLS_POP_TYPE] = {
+ .name = "type",
+ .help = "Ethertype of MPLS header",
+ .next = NEXT(action_mpls_pop, NEXT_ENTRY(UNSIGNED)),
+ .args = ARGS(ARGS_ENTRY(struct rte_flow_action_mpls_pop,
+ ether_type)),
+ .call = parse_vc,
+ },
+ [ACTION_MPLS_PUSH] = {
+ .name = "mpls_push",
+ .help = "push new MPLS header onto the packet",
+ .priv = PRIV_ACTION(MPLS_PUSH,
+ sizeof(struct rte_flow_action_mpls_push)),
+ .next = NEXT(action_mpls_push),
+ .call = parse_vc,
+ },
+ [ACTION_MPLS_PUSH_TYPE] = {
+ .name = "type",
+ .help = "Ethertype of MPLS header",
+ .next = NEXT(action_mpls_push, NEXT_ENTRY(UNSIGNED)),
+ .args = ARGS(ARGS_ENTRY(struct rte_flow_action_mpls_push,
+ ether_type)),
+ .call = parse_vc,
+ },
};
/** Remove and return last entry from argument stack. */
@@ -1684,6 +1684,75 @@ required MPLS or IP headers.
| no properties |
+---------------+
+Action: ``ACTION_VLAN_POP``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pop the outer-most VLAN header from the packet.
+
+.. _table_rte_flow_action_vlan_pop:
+
+.. table:: VLAN_POP
+
+ +---------------+
+ | Field |
+ +===============+
+ | no properties |
+ +---------------+
+
+Action: ``ACTION_VLAN_PUSH``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8 should
+be used. The value of VLAN ID and VLAN priority for the new header is copied
+from an exist VLAN header in the packet, they will be set to 0 if no such
+VLAN header exist.
+
+.. _table_rte_flow_action_vlan_push:
+
+.. table:: VLAN_PUSH
+
+ +----------------+------------------------+
+ | Field | Value |
+ +================+========================+
+ | ``ether_type`` | Ethertype for VLAN tag |
+ +----------------+------------------------+
+
+Action: ``ACTION_MPLS_POP``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pop the outer-most MPLS header from the packet, Ethertype is required for
+the resulting packet if it is not the last MPLS header be popped, Ethertype
+must be 0x8847 or 0x8848.
+
+.. _table_rte_flow_action_mpls_pop:
+
+.. table:: MPLS_POP
+
+ +----------------+---------------------------+
+ | Field | Value |
+ +================+===========================+
+ | ``ether_type`` | Ethertype for MPLS header |
+ +----------------+---------------------------+
+
+Action: ``ACTION_MPLS_PUSH``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848 should
+be used. The value of MPLS label and traffic class is copied from exist
+outermost MPLS header, and TTL is copied from exist outermost MPLS or IP
+header, they will be set to 0 if exist packet does not contain required
+header.
+
+.. _table_rte_flow_action_mpls_push:
+
+.. table:: MPLS_PUSH
+
+ +----------------+---------------------------+
+ | Field | Value |
+ +================+===========================+
+ | ``ether_type`` | Ethertype for MPLS header |
+ +----------------+---------------------------+
+
Negative types
~~~~~~~~~~~~~~
@@ -3461,6 +3461,20 @@ This section lists supported actions and their attributes, if any.
- ``ttl_copy_in``: copy TTL inwards.
+- ``vlan_pop``: pop the outermost VLAN header.
+
+- ``vlan_push``: push new VLAN header onto the packet.
+
+ - ``type``: Ethertype of the VLAN header.
+
+- ``mpls_pop``: pop the outermost MPLS header.
+
+ - ``type``: Ethertype of the MPLS header.
+
+- ``mpls_push``: push new MPLS header onto the packet.
+
+ - ``type``: Ethertype of the MPLS header.
+
Destroying flow rules
~~~~~~~~~~~~~~~~~~~~~
@@ -1285,6 +1285,41 @@ enum rte_flow_action_type {
* packets that contain required protocol headers.
*/
RTE_FLOW_ACTION_TYPE_TTL_COPY_IN,
+
+ /**
+ * Pop the outer-most VLAN header from the packet.
+ */
+ RTE_FLOW_ACTION_TYPE_VLAN_POP,
+
+ /**
+ * Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8
+ * should be used. The value of VLAN ID and VLAN priority for the new
+ * header is copied from an exist VLAN header in the packet, they will
+ * be set to 0 if no such VLAN header exist.
+ *
+ * See struct rte_flow_action_vlan_push.
+ */
+ RTE_FLOW_ACTION_TYPE_VLAN_PUSH,
+
+ /**
+ * Pop the outer-most MPLS header from the packet, Ethertype is
+ * required for the resulting packet if it is not the last MPLS
+ * header be popped, Ethertype must be 0x8847 or 0x8848.
+ *
+ * See struct rte_flow_action_mpls_pop.
+ */
+ RTE_FLOW_ACTION_TYPE_MPLS_POP,
+
+ /**
+ * Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848
+ * should be used. The value of MPLS label and traffic class is copied
+ * from exist outermost MPLS header, and TTL is copied from exist
+ * outermost MPLS or IP header, they will be set to 0 if exist packet
+ * does not contain required header.
+ *
+ * See struct rte_flow_action_mpls_push.
+ */
+ RTE_FLOW_ACTION_TYPE_MPLS_PUSH,
};
/**
@@ -1501,6 +1536,42 @@ struct rte_flow_action_ip_ttl_dec {
};
/**
+ * RTE_FLOW_ACTION_TYPE_VLAN_PUSH,
+ *
+ * Push a new VLAN header onto the packet, Ethertype 0x8100 or 0x88a8
+ * should be used. The value of VLAN ID and VLAN priority for the new
+ * header is copied from an exist outermost VLAN header in the packet,
+ * they will be set to 0 if no such VLAN header exist.
+ */
+struct rte_flow_action_vlan_push {
+ rte_be16_t ether_type; /**< Ethertype for vlan tag. */
+};
+
+/**
+ * RTE_FLOW_ACTION_TYPE_MPLS_POP,
+ *
+ * Pop the outer-most MPLS header from the packet, Ethertype is
+ * required for the resulting packet if it is not the last MPLS
+ * header be popped, Ethertype must be 0x8847 or 0x8848.
+ */
+struct rte_flow_action_mpls_pop {
+ rte_be16_t ether_type; /**< Ethertype for MPLS header */
+};
+
+/**
+ * RTE_FLOW_ACTION_TYPE_MPLS_PUSH,
+ *
+ * Push a new MPLS header onto the packet, Ethertype 0x8847 or 0x8848
+ * should be used. The value of MPLS label and traffic class are copied
+ * from exist outermost MPLS header, and TTL is copied from exist outermost
+ * MPLS or IP header, they will be set to 0, if exist packet does not
+ * contain required header.
+ */
+struct rte_flow_action_mpls_push {
+ rte_be16_t ether_type; /**< Ethertype for MPLS header */
+};
+
+/**
* Definition of a single action.
*
* A list of actions is terminated by a END action.