Re: [dpdk-dev] [PATCH] app/testpmd: support multiple raw encap/decap

[Jack Min <jackmin@mellanox.com>]

Hey,

Anyone has any comments on this patch?

-Jack

On Mon, 19-09-16, 17:21, Xiaoyu Min wrote:
> In some scenarios, the raw_encap/raw_decap actions could be multiple in
> one single flow (e,g. hirepin flow):
> 
>   ... actions raw_decap / raw_encap / raw_decap / raw_encap / ...
> 
> This requires the testpmd supports multiple raw_encap/raw_decap data
> settings as well.
> 
> With the multiple raw_encap/raw_decap settings, the testpmd commands –
> set raw_encap / set raw_decap will become:
> 
>   set raw_encap <index> <item pattern>
>   set raw_decap <index> <item pattern>
> 
> And the actions – raw_encap/raw_decap also could optionally choose which
> global raw_encap/raw_decap confs to be used by index:
> 
>   ... actions raw_decap index 1 / raw_encap index 2 / ...
> 
> If there is no `index` specified, the default index is 0:
> 
>   set raw_encap <item pattern>
>   ... actions raw_decap / raw_encap / ...
> 
> which will use raw_encap index 0.
> 
> In addition to the set raw_encap/raw_decap commands,
> 
>   show <raw_encap/raw_decap> <index>
>   show <raw_encap/raw_decap> all
> 
> are also introduced into in order to check which index is set and to
> what.
> 
> Signed-off-by: Xiaoyu Min <jackmin@mellanox.com>
> ---
>  app/test-pmd/cmdline.c                      |   2 +
>  app/test-pmd/cmdline_flow.c                 | 310 ++++++++++++++++++--
>  app/test-pmd/testpmd.h                      |   2 +
>  doc/guides/testpmd_app_ug/testpmd_funcs.rst |  57 +++-
>  4 files changed, 331 insertions(+), 40 deletions(-)
> 
> diff --git a/app/test-pmd/cmdline.c b/app/test-pmd/cmdline.c
> index b6bc34b4d2..9a7aae8b0e 100644
> --- a/app/test-pmd/cmdline.c
> +++ b/app/test-pmd/cmdline.c
> @@ -19017,6 +19017,8 @@ cmdline_parse_ctx_t main_ctx[] = {
>  	(cmdline_parse_inst_t *)&cmd_config_tx_metadata_specific,
>  	(cmdline_parse_inst_t *)&cmd_show_tx_metadata,
>  	(cmdline_parse_inst_t *)&cmd_set_raw,
> +	(cmdline_parse_inst_t *)&cmd_show_set_raw,
> +	(cmdline_parse_inst_t *)&cmd_show_set_raw_all,
>  	NULL,
>  };
>  
> diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c
> index 495871394e..f5a1178d9d 100644
> --- a/app/test-pmd/cmdline_flow.c
> +++ b/app/test-pmd/cmdline_flow.c
> @@ -19,7 +19,10 @@
>  #include <rte_byteorder.h>
>  #include <cmdline_parse.h>
>  #include <cmdline_parse_etheraddr.h>
> +#include <cmdline_parse_string.h>
> +#include <cmdline_parse_num.h>
>  #include <rte_flow.h>
> +#include <rte_hexdump.h>
>  
>  #include "testpmd.h"
>  
> @@ -51,6 +54,7 @@ enum index {
>  	/* Sub-leve commands. */
>  	SET_RAW_ENCAP,
>  	SET_RAW_DECAP,
> +	SET_RAW_INDEX,
>  
>  	/* Top-level command. */
>  	FLOW,
> @@ -297,6 +301,10 @@ enum index {
>  	ACTION_DEC_TCP_ACK_VALUE,
>  	ACTION_RAW_ENCAP,
>  	ACTION_RAW_DECAP,
> +	ACTION_RAW_ENCAP_INDEX,
> +	ACTION_RAW_ENCAP_INDEX_VALUE,
> +	ACTION_RAW_DECAP_INDEX,
> +	ACTION_RAW_DECAP_INDEX_VALUE,
>  };
>  
>  /** Maximum size for pattern in struct rte_flow_item_raw. */
> @@ -320,6 +328,7 @@ struct action_rss_data {
>  #define ACTION_VXLAN_ENCAP_ITEMS_NUM 6
>  
>  #define ACTION_RAW_ENCAP_MAX_DATA 128
> +#define RAW_ENCAP_CONFS_MAX_NUM 8
>  
>  /** Storage for struct rte_flow_action_raw_encap. */
>  struct raw_encap_conf {
> @@ -328,7 +337,7 @@ struct raw_encap_conf {
>  	size_t size;
>  };
>  
> -struct raw_encap_conf raw_encap_conf = {.size = 0};
> +struct raw_encap_conf raw_encap_confs[RAW_ENCAP_CONFS_MAX_NUM];
>  
>  /** Storage for struct rte_flow_action_raw_decap. */
>  struct raw_decap_conf {
> @@ -336,7 +345,7 @@ struct raw_decap_conf {
>  	size_t size;
>  };
>  
> -struct raw_decap_conf raw_decap_conf = {.size = 0};
> +struct raw_decap_conf raw_decap_confs[RAW_ENCAP_CONFS_MAX_NUM];
>  
>  /** Storage for struct rte_flow_action_vxlan_encap including external data. */
>  struct action_vxlan_encap_data {
> @@ -376,12 +385,14 @@ struct action_raw_encap_data {
>  	struct rte_flow_action_raw_encap conf;
>  	uint8_t data[ACTION_RAW_ENCAP_MAX_DATA];
>  	uint8_t preserve[ACTION_RAW_ENCAP_MAX_DATA];
> +	uint16_t idx;
>  };
>  
>  /** Storage for struct rte_flow_action_raw_decap including external data. */
>  struct action_raw_decap_data {
>  	struct rte_flow_action_raw_decap conf;
>  	uint8_t data[ACTION_RAW_ENCAP_MAX_DATA];
> +	uint16_t idx;
>  };
>  
>  /** Maximum number of subsequent tokens and arguments on the stack. */
> @@ -902,6 +913,12 @@ static const enum index item_meta[] = {
>  	ZERO,
>  };
>  
> +static const enum index next_set_raw[] = {
> +	SET_RAW_INDEX,
> +	ITEM_ETH,
> +	ZERO,
> +};
> +
>  static const enum index next_action[] = {
>  	ACTION_END,
>  	ACTION_VOID,
> @@ -1143,6 +1160,18 @@ static const enum index action_dec_tcp_ack[] = {
>  	ZERO,
>  };
>  
> +static const enum index action_raw_encap[] = {
> +	ACTION_RAW_ENCAP_INDEX,
> +	ACTION_NEXT,
> +	ZERO,
> +};
> +
> +static const enum index action_raw_decap[] = {
> +	ACTION_RAW_DECAP_INDEX,
> +	ACTION_NEXT,
> +	ZERO,
> +};
> +
>  static int parse_set_raw_encap_decap(struct context *, const struct token *,
>  				     const char *, unsigned int,
>  				     void *, unsigned int);
> @@ -1201,6 +1230,12 @@ static int parse_vc_action_raw_encap(struct context *,
>  static int parse_vc_action_raw_decap(struct context *,
>  				     const struct token *, const char *,
>  				     unsigned int, void *, unsigned int);
> +static int parse_vc_action_raw_encap_index(struct context *,
> +					   const struct token *, const char *,
> +					   unsigned int, void *, unsigned int);
> +static int parse_vc_action_raw_decap_index(struct context *,
> +					   const struct token *, const char *,
> +					   unsigned int, void *, unsigned int);
>  static int parse_destroy(struct context *, const struct token *,
>  			 const char *, unsigned int,
>  			 void *, unsigned int);
> @@ -1260,6 +1295,8 @@ static int comp_vc_action_rss_type(struct context *, const struct token *,
>  				   unsigned int, char *, unsigned int);
>  static int comp_vc_action_rss_queue(struct context *, const struct token *,
>  				    unsigned int, char *, unsigned int);
> +static int comp_set_raw_index(struct context *, const struct token *,
> +			      unsigned int, char *, unsigned int);
>  
>  /** Token definitions. */
>  static const struct token token_list[] = {
> @@ -3095,23 +3132,49 @@ static const struct token token_list[] = {
>  		.name = "raw_encap",
>  		.help = "encapsulation data, defined by set raw_encap",
>  		.priv = PRIV_ACTION(RAW_ENCAP,
> -			sizeof(struct rte_flow_action_raw_encap)),
> -		.next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> +			sizeof(struct action_raw_encap_data)),
> +		.next = NEXT(action_raw_encap),
>  		.call = parse_vc_action_raw_encap,
>  	},
> +	[ACTION_RAW_ENCAP_INDEX] = {
> +		.name = "index",
> +		.help = "the index of raw_encap_confs",
> +		.next = NEXT(NEXT_ENTRY(ACTION_RAW_ENCAP_INDEX_VALUE)),
> +	},
> +	[ACTION_RAW_ENCAP_INDEX_VALUE] = {
> +		.name = "{index}",
> +		.type = "UNSIGNED",
> +		.help = "unsigned integer value",
> +		.next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> +		.call = parse_vc_action_raw_encap_index,
> +		.comp = comp_set_raw_index,
> +	},
>  	[ACTION_RAW_DECAP] = {
>  		.name = "raw_decap",
>  		.help = "decapsulation data, defined by set raw_encap",
>  		.priv = PRIV_ACTION(RAW_DECAP,
> -			sizeof(struct rte_flow_action_raw_decap)),
> -		.next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> +			sizeof(struct action_raw_decap_data)),
> +		.next = NEXT(action_raw_decap),
>  		.call = parse_vc_action_raw_decap,
>  	},
> +	[ACTION_RAW_DECAP_INDEX] = {
> +		.name = "index",
> +		.help = "the index of raw_encap_confs",
> +		.next = NEXT(NEXT_ENTRY(ACTION_RAW_DECAP_INDEX_VALUE)),
> +	},
> +	[ACTION_RAW_DECAP_INDEX_VALUE] = {
> +		.name = "{index}",
> +		.type = "UNSIGNED",
> +		.help = "unsigned integer value",
> +		.next = NEXT(NEXT_ENTRY(ACTION_NEXT)),
> +		.call = parse_vc_action_raw_decap_index,
> +		.comp = comp_set_raw_index,
> +	},
>  	/* Top level command. */
>  	[SET] = {
>  		.name = "set",
>  		.help = "set raw encap/decap data",
> -		.type = "set raw_encap|raw_decap <pattern>",
> +		.type = "set raw_encap|raw_decap <index> <pattern>",
>  		.next = NEXT(NEXT_ENTRY
>  			     (SET_RAW_ENCAP,
>  			      SET_RAW_DECAP)),
> @@ -3121,14 +3184,29 @@ static const struct token token_list[] = {
>  	[SET_RAW_ENCAP] = {
>  		.name = "raw_encap",
>  		.help = "set raw encap data",
> -		.next = NEXT(next_item),
> +		.next = NEXT(next_set_raw),
> +		.args = ARGS(ARGS_ENTRY_ARB_BOUNDED
> +				(offsetof(struct buffer, port),
> +				 sizeof(((struct buffer *)0)->port),
> +				 0, RAW_ENCAP_CONFS_MAX_NUM - 1)),
>  		.call = parse_set_raw_encap_decap,
>  	},
>  	[SET_RAW_DECAP] = {
>  		.name = "raw_decap",
>  		.help = "set raw decap data",
> -		.next = NEXT(next_item),
> +		.next = NEXT(next_set_raw),
> +		.args = ARGS(ARGS_ENTRY_ARB_BOUNDED
> +				(offsetof(struct buffer, port),
> +				 sizeof(((struct buffer *)0)->port),
> +				 0, RAW_ENCAP_CONFS_MAX_NUM - 1)),
>  		.call = parse_set_raw_encap_decap,
> +	},
> +	[SET_RAW_INDEX] = {
> +		.name = "{index}",
> +		.type = "UNSIGNED",
> +		.help = "index of raw_encap/raw_decap data",
> +		.next = NEXT(next_item),
> +		.call = parse_port,
>  	}
>  };
>  
> @@ -4423,6 +4501,84 @@ parse_vc_action_mplsoudp_decap(struct context *ctx, const struct token *token,
>  	return ret;
>  }
>  
> +static int
> +parse_vc_action_raw_decap_index(struct context *ctx, const struct token *token,
> +				const char *str, unsigned int len, void *buf,
> +				unsigned int size)
> +{
> +	struct action_raw_decap_data *action_raw_decap_data;
> +	struct rte_flow_action *action;
> +	const struct arg *arg;
> +	struct buffer *out = buf;
> +	int ret;
> +	uint16_t idx;
> +
> +	RTE_SET_USED(token);
> +	RTE_SET_USED(buf);
> +	RTE_SET_USED(size);
> +	arg = ARGS_ENTRY_ARB_BOUNDED
> +		(offsetof(struct action_raw_decap_data, idx),
> +		 sizeof(((struct action_raw_decap_data *)0)->idx),
> +		 0, RAW_ENCAP_CONFS_MAX_NUM - 1);
> +	if (push_args(ctx, arg))
> +		return -1;
> +	ret = parse_int(ctx, token, str, len, NULL, 0);
> +	if (ret < 0) {
> +		pop_args(ctx);
> +		return -1;
> +	}
> +	if (!ctx->object)
> +		return len;
> +	action = &out->args.vc.actions[out->args.vc.actions_n - 1];
> +	action_raw_decap_data = ctx->object;
> +	idx = action_raw_decap_data->idx;
> +	action_raw_decap_data->conf.data = raw_decap_confs[idx].data;
> +	action_raw_decap_data->conf.size = raw_decap_confs[idx].size;
> +	action->conf = &action_raw_decap_data->conf;
> +	return len;
> +}
> +
> +
> +static int
> +parse_vc_action_raw_encap_index(struct context *ctx, const struct token *token,
> +				const char *str, unsigned int len, void *buf,
> +				unsigned int size)
> +{
> +	struct action_raw_encap_data *action_raw_encap_data;
> +	struct rte_flow_action *action;
> +	const struct arg *arg;
> +	struct buffer *out = buf;
> +	int ret;
> +	uint16_t idx;
> +
> +	RTE_SET_USED(token);
> +	RTE_SET_USED(buf);
> +	RTE_SET_USED(size);
> +	if (ctx->curr != ACTION_RAW_ENCAP_INDEX_VALUE)
> +		return -1;
> +	arg = ARGS_ENTRY_ARB_BOUNDED
> +		(offsetof(struct action_raw_encap_data, idx),
> +		 sizeof(((struct action_raw_encap_data *)0)->idx),
> +		 0, RAW_ENCAP_CONFS_MAX_NUM - 1);
> +	if (push_args(ctx, arg))
> +		return -1;
> +	ret = parse_int(ctx, token, str, len, NULL, 0);
> +	if (ret < 0) {
> +		pop_args(ctx);
> +		return -1;
> +	}
> +	if (!ctx->object)
> +		return len;
> +	action = &out->args.vc.actions[out->args.vc.actions_n - 1];
> +	action_raw_encap_data = ctx->object;
> +	idx = action_raw_encap_data->idx;
> +	action_raw_encap_data->conf.data = raw_encap_confs[idx].data;
> +	action_raw_encap_data->conf.size = raw_encap_confs[idx].size;
> +	action_raw_encap_data->conf.preserve = NULL;
> +	action->conf = &action_raw_encap_data->conf;
> +	return len;
> +}
> +
>  static int
>  parse_vc_action_raw_encap(struct context *ctx, const struct token *token,
>  			  const char *str, unsigned int len, void *buf,
> @@ -4430,8 +4586,7 @@ parse_vc_action_raw_encap(struct context *ctx, const struct token *token,
>  {
>  	struct buffer *out = buf;
>  	struct rte_flow_action *action;
> -	struct rte_flow_action_raw_encap *action_raw_encap_conf = NULL;
> -	uint8_t *data = NULL;
> +	struct action_raw_encap_data *action_raw_encap_data = NULL;
>  	int ret;
>  
>  	ret = parse_vc(ctx, token, str, len, buf, size);
> @@ -4447,14 +4602,11 @@ parse_vc_action_raw_encap(struct context *ctx, const struct token *token,
>  	ctx->object = out->args.vc.data;
>  	ctx->objmask = NULL;
>  	/* Copy the headers to the buffer. */
> -	action_raw_encap_conf = ctx->object;
> -	/* data stored from tail of data buffer */
> -	data = (uint8_t *)&(raw_encap_conf.data) +
> -		ACTION_RAW_ENCAP_MAX_DATA - raw_encap_conf.size;
> -	action_raw_encap_conf->data = data;
> -	action_raw_encap_conf->preserve = NULL;
> -	action_raw_encap_conf->size = raw_encap_conf.size;
> -	action->conf = action_raw_encap_conf;
> +	action_raw_encap_data = ctx->object;
> +	action_raw_encap_data->conf.data = raw_encap_confs[0].data;
> +	action_raw_encap_data->conf.preserve = NULL;
> +	action_raw_encap_data->conf.size = raw_encap_confs[0].size;
> +	action->conf = &action_raw_encap_data->conf;
>  	return ret;
>  }
>  
> @@ -4465,8 +4617,7 @@ parse_vc_action_raw_decap(struct context *ctx, const struct token *token,
>  {
>  	struct buffer *out = buf;
>  	struct rte_flow_action *action;
> -	struct rte_flow_action_raw_decap *action_raw_decap_conf = NULL;
> -	uint8_t *data = NULL;
> +	struct action_raw_decap_data *action_raw_decap_data = NULL;
>  	int ret;
>  
>  	ret = parse_vc(ctx, token, str, len, buf, size);
> @@ -4482,13 +4633,10 @@ parse_vc_action_raw_decap(struct context *ctx, const struct token *token,
>  	ctx->object = out->args.vc.data;
>  	ctx->objmask = NULL;
>  	/* Copy the headers to the buffer. */
> -	action_raw_decap_conf = ctx->object;
> -	/* data stored from tail of data buffer */
> -	data = (uint8_t *)&(raw_decap_conf.data) +
> -		ACTION_RAW_ENCAP_MAX_DATA - raw_decap_conf.size;
> -	action_raw_decap_conf->data = data;
> -	action_raw_decap_conf->size = raw_decap_conf.size;
> -	action->conf = action_raw_decap_conf;
> +	action_raw_decap_data = ctx->object;
> +	action_raw_decap_data->conf.data = raw_decap_confs[0].data;
> +	action_raw_decap_data->conf.size = raw_decap_confs[0].size;
> +	action->conf = &action_raw_decap_data->conf;
>  	return ret;
>  }
>  
> @@ -5167,6 +5315,7 @@ parse_set_raw_encap_decap(struct context *ctx, const struct token *token,
>  		return -1;
>  	ctx->objdata = 0;
>  	ctx->objmask = NULL;
> +	ctx->object = out;
>  	if (!out->command)
>  		return -1;
>  	out->command = ctx->curr;
> @@ -5343,6 +5492,24 @@ comp_vc_action_rss_queue(struct context *ctx, const struct token *token,
>  	return -1;
>  }
>  
> +/** Complete index number for set raw_encap/raw_decap commands. */
> +static int
> +comp_set_raw_index(struct context *ctx, const struct token *token,
> +		   unsigned int ent, char *buf, unsigned int size)
> +{
> +	uint16_t idx = 0;
> +	uint16_t nb = 0;
> +
> +	RTE_SET_USED(ctx);
> +	RTE_SET_USED(token);
> +	for (idx = 0; idx < RAW_ENCAP_CONFS_MAX_NUM; ++idx) {
> +		if (buf && idx == ent)
> +			return snprintf(buf, size, "%u", idx);
> +		++nb;
> +	}
> +	return nb;
> +}
> +
>  /** Internal context. */
>  static struct context cmd_flow_context;
>  
> @@ -5777,15 +5944,16 @@ cmd_set_raw_parsed(const struct buffer *in)
>  	size_t *total_size = NULL;
>  	uint16_t upper_layer = 0;
>  	uint16_t proto = 0;
> +	uint16_t idx = in->port; /* We borrow port field as index */
>  
>  	RTE_ASSERT(in->command == SET_RAW_ENCAP ||
>  		   in->command == SET_RAW_DECAP);
>  	if (in->command == SET_RAW_ENCAP) {
> -		total_size = &raw_encap_conf.size;
> -		data = (uint8_t *)&raw_encap_conf.data;
> +		total_size = &raw_encap_confs[idx].size;
> +		data = (uint8_t *)&raw_encap_confs[idx].data;
>  	} else {
> -		total_size = &raw_decap_conf.size;
> -		data = (uint8_t *)&raw_decap_conf.data;
> +		total_size = &raw_decap_confs[idx].size;
> +		data = (uint8_t *)&raw_decap_confs[idx].data;
>  	}
>  	*total_size = 0;
>  	memset(data, 0x00, ACTION_RAW_ENCAP_MAX_DATA);
> @@ -5855,6 +6023,7 @@ cmd_set_raw_parsed(const struct buffer *in)
>  	if (verbose_level & 0x1)
>  		printf("total data size is %zu\n", (*total_size));
>  	RTE_ASSERT((*total_size) <= ACTION_RAW_ENCAP_MAX_DATA);
> +	memmove(data, (data_tail - (*total_size)), *total_size);
>  }
>  
>  /** Populate help strings for current token (cmdline API). */
> @@ -5939,3 +6108,80 @@ cmdline_parse_inst_t cmd_set_raw = {
>  		NULL,
>  	}, /**< Tokens are returned by cmd_flow_tok(). */
>  };
> +
> +/* *** display raw_encap/raw_decap buf */
> +struct cmd_show_set_raw_result {
> +	cmdline_fixed_string_t cmd_show;
> +	cmdline_fixed_string_t cmd_what;
> +	cmdline_fixed_string_t cmd_all;
> +	uint16_t cmd_index;
> +};
> +
> +static void
> +cmd_show_set_raw_parsed(void *parsed_result, struct cmdline *cl, void *data)
> +{
> +	struct cmd_show_set_raw_result *res = parsed_result;
> +	uint16_t index = res->cmd_index;
> +	uint8_t all = 0;
> +	uint8_t *raw_data = NULL;
> +	size_t raw_size = 0;
> +	char title[16] = {0};
> +
> +	RTE_SET_USED(cl);
> +	RTE_SET_USED(data);
> +	if (!strcmp(res->cmd_all, "all")) {
> +		all = 1;
> +		index = 0;
> +	} else if (index >= RAW_ENCAP_CONFS_MAX_NUM) {
> +		printf("index should be 0-%u\n", RAW_ENCAP_CONFS_MAX_NUM - 1);
> +		return;
> +	}
> +	do {
> +		if (!strcmp(res->cmd_what, "raw_encap")) {
> +			raw_data = (uint8_t *)&raw_encap_confs[index].data;
> +			raw_size = raw_encap_confs[index].size;
> +			snprintf(title, 16, "\nindex: %u", index);
> +			rte_hexdump(stdout, title, raw_data, raw_size);
> +		} else {
> +			raw_data = (uint8_t *)&raw_decap_confs[index].data;
> +			raw_size = raw_decap_confs[index].size;
> +			snprintf(title, 16, "\nindex: %u", index);
> +			rte_hexdump(stdout, title, raw_data, raw_size);
> +		}
> +	} while (all && ++index < RAW_ENCAP_CONFS_MAX_NUM);
> +}
> +
> +cmdline_parse_token_string_t cmd_show_set_raw_cmd_show =
> +	TOKEN_STRING_INITIALIZER(struct cmd_show_set_raw_result,
> +			cmd_show, "show");
> +cmdline_parse_token_string_t cmd_show_set_raw_cmd_what =
> +	TOKEN_STRING_INITIALIZER(struct cmd_show_set_raw_result,
> +			cmd_what, "raw_encap#raw_decap");
> +cmdline_parse_token_num_t cmd_show_set_raw_cmd_index =
> +	TOKEN_NUM_INITIALIZER(struct cmd_show_set_raw_result,
> +			cmd_index, UINT16);
> +cmdline_parse_token_string_t cmd_show_set_raw_cmd_all =
> +	TOKEN_STRING_INITIALIZER(struct cmd_show_set_raw_result,
> +			cmd_all, "all");
> +cmdline_parse_inst_t cmd_show_set_raw = {
> +	.f = cmd_show_set_raw_parsed,
> +	.data = NULL,
> +	.help_str = "show <raw_encap|raw_decap> <index>",
> +	.tokens = {
> +		(void *)&cmd_show_set_raw_cmd_show,
> +		(void *)&cmd_show_set_raw_cmd_what,
> +		(void *)&cmd_show_set_raw_cmd_index,
> +		NULL,
> +	},
> +};
> +cmdline_parse_inst_t cmd_show_set_raw_all = {
> +	.f = cmd_show_set_raw_parsed,
> +	.data = NULL,
> +	.help_str = "show <raw_encap|raw_decap> all",
> +	.tokens = {
> +		(void *)&cmd_show_set_raw_cmd_show,
> +		(void *)&cmd_show_set_raw_cmd_what,
> +		(void *)&cmd_show_set_raw_cmd_all,
> +		NULL,
> +	},
> +};
> diff --git a/app/test-pmd/testpmd.h b/app/test-pmd/testpmd.h
> index ce13eb8e6a..a65635d6ff 100644
> --- a/app/test-pmd/testpmd.h
> +++ b/app/test-pmd/testpmd.h
> @@ -265,6 +265,8 @@ extern struct fwd_engine ieee1588_fwd_engine;
>  
>  extern struct fwd_engine * fwd_engines[]; /**< NULL terminated array. */
>  extern cmdline_parse_inst_t cmd_set_raw;
> +extern cmdline_parse_inst_t cmd_show_set_raw;
> +extern cmdline_parse_inst_t cmd_show_set_raw_all;
>  
>  extern uint16_t mempool_flags;
>  
> diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> index 67f4339ca9..1cf9a2bdff 100644
> --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst
> @@ -540,6 +540,25 @@ Dumps the log level for all the dpdk modules::
>  
>     testpmd> dump_log_types
>  
> +show (raw_encap|raw_decap)
> +~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +Display content of raw_encap/raw_decap buffers in hex::
> +
> +  testpmd> show <raw_encap|raw_decap> <index>
> +  testpmd> show <raw_encap|raw_decap> all
> +
> +For example::
> +
> +  testpmd> show raw_encap 6
> +
> +  index: 6 at [0x1c565b0], len=50
> +  00000000: 00 00 00 00 00 00 16 26 36 46 56 66 08 00 45 00 | .......&6FVf..E.
> +  00000010: 00 00 00 00 00 00 00 11 00 00 C0 A8 01 06 C0 A8 | ................
> +  00000020: 03 06 00 00 00 FA 00 00 00 00 08 00 00 00 00 00 | ................
> +  00000030: 06 00                                           | ..
> +
> +
>  Configuration Functions
>  -----------------------
>  
> @@ -1844,12 +1863,22 @@ Config Raw Encapsulation
>  Configure the raw data to be used when encapsulating a packet by
>  rte_flow_action_raw_encap::
>  
> + set raw_encap {index} {item} [/ {item} [...]] / end_set
> +
> +There are multiple global buffers for ``raw_encap``, this command will set one
> +internal buffer index by ``{index}``.
> +If there is no ``{index}`` specified::
> +
>   set raw_encap {item} [/ {item} [...]] / end_set
>  
> -This command will set an internal buffer inside testpmd, any following flow rule
> -using the action raw_encap will use the last configuration set.
> -To have a different encapsulation header, this command must be called before the
> -flow rule creation.
> +the default index ``0`` is used.
> +In order to use different encapsulating header, ``index`` must be specified
> +during the flow rule creation::
> +
> + testpmd> flow create 0 egress pattern eth / ipv4 / end actions
> +        raw_encap index 2 / end
> +
> +Otherwise the default index ``0`` is used.
>  
>  Config Raw Decapsulation
>  ~~~~~~~~~~~~~~~~~~~~~~~~
> @@ -1857,10 +1886,22 @@ Config Raw Decapsulation
>  Configure the raw data to be used when decapsulating a packet by
>  rte_flow_action_raw_decap::
>  
> + set raw_decap {index} {item} [/ {item} [...]] / end_set
> +
> +There are multiple global buffers for ``raw_decap``, this command will set
> +one internal buffer index by ``{index}``.
> +If there is no ``{index}`` specified::
> +
>   set raw_decap {item} [/ {item} [...]] / end_set
>  
> -This command will set an internal buffer inside testpmd, any following flow rule
> -using the action raw_decap will use the last configuration set.
> +the default index ``0`` is used.
> +In order to use different decapsulating header, ``index`` must be specified
> +during the flow rule creation::
> +
> + testpmd> flow create 0 egress pattern eth / ipv4 / end actions
> +          raw_encap index 3 / end
> +
> +Otherwise the default index ``0`` is used.
>  
>  Port Functions
>  --------------
> @@ -4658,11 +4699,11 @@ Raw encapsulation configuration can be set by the following commands
>  
>  Eecapsulating VxLAN::
>  
> - testpmd> set raw_encap eth src is 10:11:22:33:44:55 / vlan tci is 1
> + testpmd> set raw_encap 4 eth src is 10:11:22:33:44:55 / vlan tci is 1
>          inner_type is 0x0800 / ipv4 / udp dst is 4789 / vxlan vni
>          is 2 / end_set
>   testpmd> flow create 0 egress pattern eth / ipv4 / end actions
> -        raw_encap / end
> +        raw_encap index 4 / end
>  
>  Sample Raw decapsulation rule
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> -- 
> 2.23.0
>