* [PATCH 5/7] net/mlx5: fix the error set in control tables create
@ 2023-06-30 6:36 Bing Zhao
2023-06-30 9:25 ` [PATCH v2] " Bing Zhao
0 siblings, 1 reply; 4+ messages in thread
From: Bing Zhao @ 2023-06-30 6:36 UTC (permalink / raw)
To: matan, viacheslavo, orika, suanmingm, rasland; +Cc: dev, dsosnowski
When some failure occurrs in the flow_hw_create_ctrl_tables(), the
"rte_flow_error" should be set properly with all needed information.
Then the rte_errno and the "message" will reflect the actual failure.
This will also solve the crash when trying to access the "message".
Fixes: 1939eb6f660c ("net/mlx5: support flow port action with HWS")
Fixes: 483181f7b6dd ("net/mlx5: support device control of representor matching")
Fixes: ddb68e47331e ("net/mlx5: add extended metadata mode for HWS")
Cc: dsosnowski@nvidia.com
Signed-off-by: Bing Zhao <bingz@nvidia.com>
Reviewed-by: Suanming Mou <suanmingm@nvidia.com>
Acked-by: Ori Kam <orika@nvidia.com>
---
drivers/net/mlx5/mlx5_flow_hw.c | 176 +++++++++++++++++++-------------
1 file changed, 106 insertions(+), 70 deletions(-)
diff --git a/drivers/net/mlx5/mlx5_flow_hw.c b/drivers/net/mlx5/mlx5_flow_hw.c
index 87584c1e94..4163fe23e6 100644
--- a/drivers/net/mlx5/mlx5_flow_hw.c
+++ b/drivers/net/mlx5/mlx5_flow_hw.c
@@ -5421,7 +5421,7 @@ flow_hw_pattern_template_create(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it;
struct rte_flow_item *copied_items = NULL;
const struct rte_flow_item *tmpl_items;
- uint64_t orig_item_nb;
+ uint32_t orig_item_nb;
struct rte_flow_item port = {
.type = RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT,
.mask = &rte_flow_item_ethdev_mask,
@@ -6242,12 +6242,15 @@ flow_hw_esw_mgr_regc_marker(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6277,7 +6280,7 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6290,12 +6293,15 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6328,7 +6334,7 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6338,12 +6344,15 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6362,7 +6371,7 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/*
@@ -6372,12 +6381,15 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr tx_pa_attr = {
.relaxed_matching = 0,
@@ -6398,10 +6410,8 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ITEM_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
- return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, &drop_err);
+ return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, error);
}
/**
@@ -6412,12 +6422,15 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
uint32_t marker_mask = flow_hw_esw_mgr_regc_marker_mask(dev);
uint32_t marker_bits = flow_hw_esw_mgr_regc_marker(dev);
@@ -6484,7 +6497,7 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
set_reg_v.dst.offset = rte_bsf32(marker_mask);
rte_memcpy(set_reg_v.src.value, &marker_bits, sizeof(marker_bits));
rte_memcpy(set_reg_m.src.value, &marker_mask, sizeof(marker_mask));
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/**
@@ -6496,13 +6509,16 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
* Pointer to Ethernet device.
* @param group
* Destination group for this action template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
- uint32_t group)
+ uint32_t group,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6532,8 +6548,8 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v,
+ actions_m, error);
}
/**
@@ -6542,12 +6558,15 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow action template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6577,8 +6596,7 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/*
@@ -6587,12 +6605,15 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr tx_act_attr = {
.egress = 1,
@@ -6657,11 +6678,9 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ACTION_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
return flow_hw_actions_template_create(dev, &tx_act_attr, actions,
- masks, &drop_err);
+ masks, error);
}
/**
@@ -6674,6 +6693,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6681,7 +6702,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6698,7 +6720,7 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
@@ -6712,6 +6734,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6719,7 +6743,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6736,7 +6761,7 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/*
@@ -6748,6 +6773,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6755,7 +6782,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *pt,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr tx_tbl_attr = {
.flow_attr = {
@@ -6769,14 +6797,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
.attr = tx_tbl_attr,
.external = false,
};
- struct rte_flow_error drop_err = {
- .type = RTE_FLOW_ERROR_TYPE_NONE,
- .cause = NULL,
- .message = NULL,
- };
- RTE_SET_USED(drop_err);
- return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, &drop_err);
+ return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, error);
}
/**
@@ -6789,6 +6811,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6796,7 +6820,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table *
flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6813,7 +6838,7 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/**
@@ -6822,12 +6847,14 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
- * 0 on success, EINVAL otherwise
+ * 0 on success, negative values otherwise
*/
static __rte_unused int
-flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_tables(struct rte_eth_dev *dev, struct rte_flow_error *error)
{
struct mlx5_priv *priv = dev->data->dev_private;
struct rte_flow_pattern_template *esw_mgr_items_tmpl = NULL;
@@ -6840,96 +6867,107 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
struct rte_flow_actions_template *tx_meta_actions_tmpl = NULL;
uint32_t xmeta = priv->sh->config.dv_xmeta_en;
uint32_t repr_matching = priv->sh->config.repr_matching;
+ int ret;
/* Create templates and table for default SQ miss flow rules - root table. */
- esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev);
+ esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev, error);
if (!esw_mgr_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create E-Switch Manager item"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev);
+ regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev, error);
if (!regc_jump_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create REG_C set and jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_root_tbl == NULL);
priv->hw_esw_sq_miss_root_tbl = flow_hw_create_ctrl_sq_miss_root_table
- (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl);
+ (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_root_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default SQ miss flow rules - non-root table. */
- regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev);
+ regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev, error);
if (!regc_sq_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev);
+ port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev, error);
if (!port_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create port action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_tbl == NULL);
priv->hw_esw_sq_miss_tbl = flow_hw_create_ctrl_sq_miss_table(dev, regc_sq_items_tmpl,
- port_actions_tmpl);
+ port_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (non-root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default FDB jump flow rules. */
- port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev);
+ port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev, error);
if (!port_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
jump_one_actions_tmpl = flow_hw_create_ctrl_jump_actions_template
- (dev, MLX5_HW_LOWEST_USABLE_GROUP);
+ (dev, MLX5_HW_LOWEST_USABLE_GROUP, error);
if (!jump_one_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_zero_tbl == NULL);
priv->hw_esw_zero_tbl = flow_hw_create_ctrl_jump_table(dev, port_items_tmpl,
- jump_one_actions_tmpl);
+ jump_one_actions_tmpl,
+ error);
if (!priv->hw_esw_zero_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default jump to group 1"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default Tx metadata copy flow rule. */
if (!repr_matching && xmeta == MLX5_XMETA_MODE_META32_HWS) {
- tx_meta_items_tmpl = flow_hw_create_tx_default_mreg_copy_pattern_template(dev);
+ tx_meta_items_tmpl =
+ flow_hw_create_tx_default_mreg_copy_pattern_template(dev, error);
if (!tx_meta_items_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy pattern"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- tx_meta_actions_tmpl = flow_hw_create_tx_default_mreg_copy_actions_template(dev);
+ tx_meta_actions_tmpl =
+ flow_hw_create_tx_default_mreg_copy_actions_template(dev, error);
if (!tx_meta_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy actions"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_tx_meta_cpy_tbl == NULL);
- priv->hw_tx_meta_cpy_tbl = flow_hw_create_tx_default_mreg_copy_table(dev,
- tx_meta_items_tmpl, tx_meta_actions_tmpl);
+ priv->hw_tx_meta_cpy_tbl =
+ flow_hw_create_tx_default_mreg_copy_table(dev, tx_meta_items_tmpl,
+ tx_meta_actions_tmpl, error);
if (!priv->hw_tx_meta_cpy_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default"
" Tx metadata copy flow rule", dev->data->port_id);
- goto error;
+ goto err;
}
}
return 0;
-error:
+err:
+ /* Do not overwrite the rte_errno. */
+ ret = -rte_errno;
+ if (ret == 0)
+ ret = rte_flow_error_set(error, EINVAL,
+ RTE_FLOW_ERROR_TYPE_UNSPECIFIED, NULL,
+ "Failed to create control tables.");
if (priv->hw_esw_zero_tbl) {
flow_hw_table_destroy(dev, priv->hw_esw_zero_tbl, NULL);
priv->hw_esw_zero_tbl = NULL;
@@ -6958,7 +6996,7 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
flow_hw_pattern_template_destroy(dev, regc_sq_items_tmpl, NULL);
if (esw_mgr_items_tmpl)
flow_hw_pattern_template_destroy(dev, esw_mgr_items_tmpl, NULL);
- return -EINVAL;
+ return ret;
}
static void
@@ -7834,11 +7872,9 @@ flow_hw_configure(struct rte_eth_dev *dev,
NULL, "Failed to create vport actions.");
goto err;
}
- ret = flow_hw_create_ctrl_tables(dev);
- if (ret) {
- rte_errno = -ret;
+ ret = flow_hw_create_ctrl_tables(dev, error);
+ if (ret)
goto err;
- }
}
if (!priv->shared_host)
flow_hw_create_send_to_kernel_actions(priv);
--
2.34.1
^ permalink raw reply [flat|nested] 4+ messages in thread
* [PATCH v2] net/mlx5: fix the error set in control tables create
2023-06-30 6:36 [PATCH 5/7] net/mlx5: fix the error set in control tables create Bing Zhao
@ 2023-06-30 9:25 ` Bing Zhao
2023-06-30 9:46 ` [PATCH v3] " Bing Zhao
0 siblings, 1 reply; 4+ messages in thread
From: Bing Zhao @ 2023-06-30 9:25 UTC (permalink / raw)
To: matan, viacheslavo, orika, suanmingm, rasland; +Cc: dev, dsosnowski, stable
When some failure occurrs in the flow_hw_create_ctrl_tables(), the
"rte_flow_error" should be set properly with all needed information.
Then the rte_errno and the "message" will reflect the actual failure.
This will also solve the crash when trying to access the "message".
Fixes: 1939eb6f660c ("net/mlx5: support flow port action with HWS")
Fixes: 483181f7b6dd ("net/mlx5: support device control of representor matching")
Fixes: ddb68e47331e ("net/mlx5: add extended metadata mode for HWS")
Cc: dsosnowski@nvidia.com
Cc: stable@dpdk.org
Signed-off-by: Bing Zhao <bingz@nvidia.com>
Reviewed-by: Suanming Mou <suanmingm@nvidia.com>
Acked-by: Ori Kam <orika@nvidia.com>
---
v2: add CC stable
---
drivers/net/mlx5/mlx5_flow_hw.c | 176 +++++++++++++++++++-------------
1 file changed, 106 insertions(+), 70 deletions(-)
diff --git a/drivers/net/mlx5/mlx5_flow_hw.c b/drivers/net/mlx5/mlx5_flow_hw.c
index 87584c1e94..4163fe23e6 100644
--- a/drivers/net/mlx5/mlx5_flow_hw.c
+++ b/drivers/net/mlx5/mlx5_flow_hw.c
@@ -5421,7 +5421,7 @@ flow_hw_pattern_template_create(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it;
struct rte_flow_item *copied_items = NULL;
const struct rte_flow_item *tmpl_items;
- uint64_t orig_item_nb;
+ uint32_t orig_item_nb;
struct rte_flow_item port = {
.type = RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT,
.mask = &rte_flow_item_ethdev_mask,
@@ -6242,12 +6242,15 @@ flow_hw_esw_mgr_regc_marker(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6277,7 +6280,7 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6290,12 +6293,15 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6328,7 +6334,7 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6338,12 +6344,15 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6362,7 +6371,7 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/*
@@ -6372,12 +6381,15 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr tx_pa_attr = {
.relaxed_matching = 0,
@@ -6398,10 +6410,8 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ITEM_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
- return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, &drop_err);
+ return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, error);
}
/**
@@ -6412,12 +6422,15 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
uint32_t marker_mask = flow_hw_esw_mgr_regc_marker_mask(dev);
uint32_t marker_bits = flow_hw_esw_mgr_regc_marker(dev);
@@ -6484,7 +6497,7 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
set_reg_v.dst.offset = rte_bsf32(marker_mask);
rte_memcpy(set_reg_v.src.value, &marker_bits, sizeof(marker_bits));
rte_memcpy(set_reg_m.src.value, &marker_mask, sizeof(marker_mask));
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/**
@@ -6496,13 +6509,16 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
* Pointer to Ethernet device.
* @param group
* Destination group for this action template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
- uint32_t group)
+ uint32_t group,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6532,8 +6548,8 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v,
+ actions_m, error);
}
/**
@@ -6542,12 +6558,15 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow action template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6577,8 +6596,7 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/*
@@ -6587,12 +6605,15 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr tx_act_attr = {
.egress = 1,
@@ -6657,11 +6678,9 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ACTION_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
return flow_hw_actions_template_create(dev, &tx_act_attr, actions,
- masks, &drop_err);
+ masks, error);
}
/**
@@ -6674,6 +6693,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6681,7 +6702,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6698,7 +6720,7 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
@@ -6712,6 +6734,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6719,7 +6743,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6736,7 +6761,7 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/*
@@ -6748,6 +6773,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6755,7 +6782,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *pt,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr tx_tbl_attr = {
.flow_attr = {
@@ -6769,14 +6797,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
.attr = tx_tbl_attr,
.external = false,
};
- struct rte_flow_error drop_err = {
- .type = RTE_FLOW_ERROR_TYPE_NONE,
- .cause = NULL,
- .message = NULL,
- };
- RTE_SET_USED(drop_err);
- return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, &drop_err);
+ return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, error);
}
/**
@@ -6789,6 +6811,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6796,7 +6820,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table *
flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6813,7 +6838,7 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/**
@@ -6822,12 +6847,14 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
- * 0 on success, EINVAL otherwise
+ * 0 on success, negative values otherwise
*/
static __rte_unused int
-flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_tables(struct rte_eth_dev *dev, struct rte_flow_error *error)
{
struct mlx5_priv *priv = dev->data->dev_private;
struct rte_flow_pattern_template *esw_mgr_items_tmpl = NULL;
@@ -6840,96 +6867,107 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
struct rte_flow_actions_template *tx_meta_actions_tmpl = NULL;
uint32_t xmeta = priv->sh->config.dv_xmeta_en;
uint32_t repr_matching = priv->sh->config.repr_matching;
+ int ret;
/* Create templates and table for default SQ miss flow rules - root table. */
- esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev);
+ esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev, error);
if (!esw_mgr_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create E-Switch Manager item"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev);
+ regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev, error);
if (!regc_jump_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create REG_C set and jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_root_tbl == NULL);
priv->hw_esw_sq_miss_root_tbl = flow_hw_create_ctrl_sq_miss_root_table
- (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl);
+ (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_root_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default SQ miss flow rules - non-root table. */
- regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev);
+ regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev, error);
if (!regc_sq_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev);
+ port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev, error);
if (!port_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create port action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_tbl == NULL);
priv->hw_esw_sq_miss_tbl = flow_hw_create_ctrl_sq_miss_table(dev, regc_sq_items_tmpl,
- port_actions_tmpl);
+ port_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (non-root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default FDB jump flow rules. */
- port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev);
+ port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev, error);
if (!port_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
jump_one_actions_tmpl = flow_hw_create_ctrl_jump_actions_template
- (dev, MLX5_HW_LOWEST_USABLE_GROUP);
+ (dev, MLX5_HW_LOWEST_USABLE_GROUP, error);
if (!jump_one_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_zero_tbl == NULL);
priv->hw_esw_zero_tbl = flow_hw_create_ctrl_jump_table(dev, port_items_tmpl,
- jump_one_actions_tmpl);
+ jump_one_actions_tmpl,
+ error);
if (!priv->hw_esw_zero_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default jump to group 1"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default Tx metadata copy flow rule. */
if (!repr_matching && xmeta == MLX5_XMETA_MODE_META32_HWS) {
- tx_meta_items_tmpl = flow_hw_create_tx_default_mreg_copy_pattern_template(dev);
+ tx_meta_items_tmpl =
+ flow_hw_create_tx_default_mreg_copy_pattern_template(dev, error);
if (!tx_meta_items_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy pattern"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- tx_meta_actions_tmpl = flow_hw_create_tx_default_mreg_copy_actions_template(dev);
+ tx_meta_actions_tmpl =
+ flow_hw_create_tx_default_mreg_copy_actions_template(dev, error);
if (!tx_meta_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy actions"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_tx_meta_cpy_tbl == NULL);
- priv->hw_tx_meta_cpy_tbl = flow_hw_create_tx_default_mreg_copy_table(dev,
- tx_meta_items_tmpl, tx_meta_actions_tmpl);
+ priv->hw_tx_meta_cpy_tbl =
+ flow_hw_create_tx_default_mreg_copy_table(dev, tx_meta_items_tmpl,
+ tx_meta_actions_tmpl, error);
if (!priv->hw_tx_meta_cpy_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default"
" Tx metadata copy flow rule", dev->data->port_id);
- goto error;
+ goto err;
}
}
return 0;
-error:
+err:
+ /* Do not overwrite the rte_errno. */
+ ret = -rte_errno;
+ if (ret == 0)
+ ret = rte_flow_error_set(error, EINVAL,
+ RTE_FLOW_ERROR_TYPE_UNSPECIFIED, NULL,
+ "Failed to create control tables.");
if (priv->hw_esw_zero_tbl) {
flow_hw_table_destroy(dev, priv->hw_esw_zero_tbl, NULL);
priv->hw_esw_zero_tbl = NULL;
@@ -6958,7 +6996,7 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
flow_hw_pattern_template_destroy(dev, regc_sq_items_tmpl, NULL);
if (esw_mgr_items_tmpl)
flow_hw_pattern_template_destroy(dev, esw_mgr_items_tmpl, NULL);
- return -EINVAL;
+ return ret;
}
static void
@@ -7834,11 +7872,9 @@ flow_hw_configure(struct rte_eth_dev *dev,
NULL, "Failed to create vport actions.");
goto err;
}
- ret = flow_hw_create_ctrl_tables(dev);
- if (ret) {
- rte_errno = -ret;
+ ret = flow_hw_create_ctrl_tables(dev, error);
+ if (ret)
goto err;
- }
}
if (!priv->shared_host)
flow_hw_create_send_to_kernel_actions(priv);
--
2.34.1
^ permalink raw reply [flat|nested] 4+ messages in thread
* [PATCH v3] net/mlx5: fix the error set in control tables create
2023-06-30 9:25 ` [PATCH v2] " Bing Zhao
@ 2023-06-30 9:46 ` Bing Zhao
2023-07-03 10:42 ` Raslan Darawsheh
0 siblings, 1 reply; 4+ messages in thread
From: Bing Zhao @ 2023-06-30 9:46 UTC (permalink / raw)
To: matan, viacheslavo, orika, suanmingm, rasland; +Cc: dev, dsosnowski, stable
When some failure occurs in the flow_hw_create_ctrl_tables(), the
"rte_flow_error" should be set properly with all needed information.
Then the rte_errno and the "message" will reflect the actual failure.
This will also solve the crash when trying to access the "message".
Fixes: 1939eb6f660c ("net/mlx5: support flow port action with HWS")
Fixes: 483181f7b6dd ("net/mlx5: support device control of representor matching")
Fixes: ddb68e47331e ("net/mlx5: add extended metadata mode for HWS")
Cc: dsosnowski@nvidia.com
Cc: stable@dpdk.org
Signed-off-by: Bing Zhao <bingz@nvidia.com>
Reviewed-by: Suanming Mou <suanmingm@nvidia.com>
Acked-by: Ori Kam <orika@nvidia.com>
---
v2: add CC stable
v3: fix the typo
---
drivers/net/mlx5/mlx5_flow_hw.c | 176 +++++++++++++++++++-------------
1 file changed, 106 insertions(+), 70 deletions(-)
diff --git a/drivers/net/mlx5/mlx5_flow_hw.c b/drivers/net/mlx5/mlx5_flow_hw.c
index 87584c1e94..4163fe23e6 100644
--- a/drivers/net/mlx5/mlx5_flow_hw.c
+++ b/drivers/net/mlx5/mlx5_flow_hw.c
@@ -5421,7 +5421,7 @@ flow_hw_pattern_template_create(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it;
struct rte_flow_item *copied_items = NULL;
const struct rte_flow_item *tmpl_items;
- uint64_t orig_item_nb;
+ uint32_t orig_item_nb;
struct rte_flow_item port = {
.type = RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT,
.mask = &rte_flow_item_ethdev_mask,
@@ -6242,12 +6242,15 @@ flow_hw_esw_mgr_regc_marker(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6277,7 +6280,7 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6290,12 +6293,15 @@ flow_hw_create_ctrl_esw_mgr_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6328,7 +6334,7 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/**
@@ -6338,12 +6344,15 @@ flow_hw_create_ctrl_regc_sq_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr attr = {
.relaxed_matching = 0,
@@ -6362,7 +6371,7 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
},
};
- return flow_hw_pattern_template_create(dev, &attr, items, NULL);
+ return flow_hw_pattern_template_create(dev, &attr, items, error);
}
/*
@@ -6372,12 +6381,15 @@ flow_hw_create_ctrl_port_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow pattern template on success, NULL otherwise.
*/
static struct rte_flow_pattern_template *
-flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_pattern_template_attr tx_pa_attr = {
.relaxed_matching = 0,
@@ -6398,10 +6410,8 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ITEM_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
- return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, &drop_err);
+ return flow_hw_pattern_template_create(dev, &tx_pa_attr, eth_all, error);
}
/**
@@ -6412,12 +6422,15 @@ flow_hw_create_tx_default_mreg_copy_pattern_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
uint32_t marker_mask = flow_hw_esw_mgr_regc_marker_mask(dev);
uint32_t marker_bits = flow_hw_esw_mgr_regc_marker(dev);
@@ -6484,7 +6497,7 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
set_reg_v.dst.offset = rte_bsf32(marker_mask);
rte_memcpy(set_reg_v.src.value, &marker_bits, sizeof(marker_bits));
rte_memcpy(set_reg_m.src.value, &marker_mask, sizeof(marker_mask));
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/**
@@ -6496,13 +6509,16 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev)
* Pointer to Ethernet device.
* @param group
* Destination group for this action template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
- uint32_t group)
+ uint32_t group,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6532,8 +6548,8 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v,
+ actions_m, error);
}
/**
@@ -6542,12 +6558,15 @@ flow_hw_create_ctrl_jump_actions_template(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow action template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr attr = {
.transfer = 1,
@@ -6577,8 +6596,7 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
}
};
- return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m,
- NULL);
+ return flow_hw_actions_template_create(dev, &attr, actions_v, actions_m, error);
}
/*
@@ -6587,12 +6605,15 @@ flow_hw_create_ctrl_port_actions_template(struct rte_eth_dev *dev)
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow actions template on success, NULL otherwise.
*/
static struct rte_flow_actions_template *
-flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
+flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev,
+ struct rte_flow_error *error)
{
struct rte_flow_actions_template_attr tx_act_attr = {
.egress = 1,
@@ -6657,11 +6678,9 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
.type = RTE_FLOW_ACTION_TYPE_END,
},
};
- struct rte_flow_error drop_err;
- RTE_SET_USED(drop_err);
return flow_hw_actions_template_create(dev, &tx_act_attr, actions,
- masks, &drop_err);
+ masks, error);
}
/**
@@ -6674,6 +6693,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6681,7 +6702,8 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev)
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6698,7 +6720,7 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
@@ -6712,6 +6734,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6719,7 +6743,8 @@ flow_hw_create_ctrl_sq_miss_root_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6736,7 +6761,7 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/*
@@ -6748,6 +6773,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6755,7 +6782,8 @@ flow_hw_create_ctrl_sq_miss_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table*
flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *pt,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr tx_tbl_attr = {
.flow_attr = {
@@ -6769,14 +6797,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
.attr = tx_tbl_attr,
.external = false,
};
- struct rte_flow_error drop_err = {
- .type = RTE_FLOW_ERROR_TYPE_NONE,
- .cause = NULL,
- .message = NULL,
- };
- RTE_SET_USED(drop_err);
- return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, &drop_err);
+ return flow_hw_table_create(dev, &tx_tbl_cfg, &pt, 1, &at, 1, error);
}
/**
@@ -6789,6 +6811,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
* Pointer to flow pattern template.
* @param at
* Pointer to flow actions template.
+ * @param error
+ * Pointer to error structure.
*
* @return
* Pointer to flow table on success, NULL otherwise.
@@ -6796,7 +6820,8 @@ flow_hw_create_tx_default_mreg_copy_table(struct rte_eth_dev *dev,
static struct rte_flow_template_table *
flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
struct rte_flow_pattern_template *it,
- struct rte_flow_actions_template *at)
+ struct rte_flow_actions_template *at,
+ struct rte_flow_error *error)
{
struct rte_flow_template_table_attr attr = {
.flow_attr = {
@@ -6813,7 +6838,7 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
.external = false,
};
- return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, NULL);
+ return flow_hw_table_create(dev, &cfg, &it, 1, &at, 1, error);
}
/**
@@ -6822,12 +6847,14 @@ flow_hw_create_ctrl_jump_table(struct rte_eth_dev *dev,
*
* @param dev
* Pointer to Ethernet device.
+ * @param error
+ * Pointer to error structure.
*
* @return
- * 0 on success, EINVAL otherwise
+ * 0 on success, negative values otherwise
*/
static __rte_unused int
-flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
+flow_hw_create_ctrl_tables(struct rte_eth_dev *dev, struct rte_flow_error *error)
{
struct mlx5_priv *priv = dev->data->dev_private;
struct rte_flow_pattern_template *esw_mgr_items_tmpl = NULL;
@@ -6840,96 +6867,107 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
struct rte_flow_actions_template *tx_meta_actions_tmpl = NULL;
uint32_t xmeta = priv->sh->config.dv_xmeta_en;
uint32_t repr_matching = priv->sh->config.repr_matching;
+ int ret;
/* Create templates and table for default SQ miss flow rules - root table. */
- esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev);
+ esw_mgr_items_tmpl = flow_hw_create_ctrl_esw_mgr_pattern_template(dev, error);
if (!esw_mgr_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create E-Switch Manager item"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev);
+ regc_jump_actions_tmpl = flow_hw_create_ctrl_regc_jump_actions_template(dev, error);
if (!regc_jump_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create REG_C set and jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_root_tbl == NULL);
priv->hw_esw_sq_miss_root_tbl = flow_hw_create_ctrl_sq_miss_root_table
- (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl);
+ (dev, esw_mgr_items_tmpl, regc_jump_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_root_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default SQ miss flow rules - non-root table. */
- regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev);
+ regc_sq_items_tmpl = flow_hw_create_ctrl_regc_sq_pattern_template(dev, error);
if (!regc_sq_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev);
+ port_actions_tmpl = flow_hw_create_ctrl_port_actions_template(dev, error);
if (!port_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create port action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_sq_miss_tbl == NULL);
priv->hw_esw_sq_miss_tbl = flow_hw_create_ctrl_sq_miss_table(dev, regc_sq_items_tmpl,
- port_actions_tmpl);
+ port_actions_tmpl, error);
if (!priv->hw_esw_sq_miss_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default sq miss (non-root table)"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default FDB jump flow rules. */
- port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev);
+ port_items_tmpl = flow_hw_create_ctrl_port_pattern_template(dev, error);
if (!port_items_tmpl) {
DRV_LOG(ERR, "port %u failed to create SQ item template for"
" control flows", dev->data->port_id);
- goto error;
+ goto err;
}
jump_one_actions_tmpl = flow_hw_create_ctrl_jump_actions_template
- (dev, MLX5_HW_LOWEST_USABLE_GROUP);
+ (dev, MLX5_HW_LOWEST_USABLE_GROUP, error);
if (!jump_one_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to create jump action template"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_esw_zero_tbl == NULL);
priv->hw_esw_zero_tbl = flow_hw_create_ctrl_jump_table(dev, port_items_tmpl,
- jump_one_actions_tmpl);
+ jump_one_actions_tmpl,
+ error);
if (!priv->hw_esw_zero_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default jump to group 1"
" for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
/* Create templates and table for default Tx metadata copy flow rule. */
if (!repr_matching && xmeta == MLX5_XMETA_MODE_META32_HWS) {
- tx_meta_items_tmpl = flow_hw_create_tx_default_mreg_copy_pattern_template(dev);
+ tx_meta_items_tmpl =
+ flow_hw_create_tx_default_mreg_copy_pattern_template(dev, error);
if (!tx_meta_items_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy pattern"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
- tx_meta_actions_tmpl = flow_hw_create_tx_default_mreg_copy_actions_template(dev);
+ tx_meta_actions_tmpl =
+ flow_hw_create_tx_default_mreg_copy_actions_template(dev, error);
if (!tx_meta_actions_tmpl) {
DRV_LOG(ERR, "port %u failed to Tx metadata copy actions"
" template for control flows", dev->data->port_id);
- goto error;
+ goto err;
}
MLX5_ASSERT(priv->hw_tx_meta_cpy_tbl == NULL);
- priv->hw_tx_meta_cpy_tbl = flow_hw_create_tx_default_mreg_copy_table(dev,
- tx_meta_items_tmpl, tx_meta_actions_tmpl);
+ priv->hw_tx_meta_cpy_tbl =
+ flow_hw_create_tx_default_mreg_copy_table(dev, tx_meta_items_tmpl,
+ tx_meta_actions_tmpl, error);
if (!priv->hw_tx_meta_cpy_tbl) {
DRV_LOG(ERR, "port %u failed to create table for default"
" Tx metadata copy flow rule", dev->data->port_id);
- goto error;
+ goto err;
}
}
return 0;
-error:
+err:
+ /* Do not overwrite the rte_errno. */
+ ret = -rte_errno;
+ if (ret == 0)
+ ret = rte_flow_error_set(error, EINVAL,
+ RTE_FLOW_ERROR_TYPE_UNSPECIFIED, NULL,
+ "Failed to create control tables.");
if (priv->hw_esw_zero_tbl) {
flow_hw_table_destroy(dev, priv->hw_esw_zero_tbl, NULL);
priv->hw_esw_zero_tbl = NULL;
@@ -6958,7 +6996,7 @@ flow_hw_create_ctrl_tables(struct rte_eth_dev *dev)
flow_hw_pattern_template_destroy(dev, regc_sq_items_tmpl, NULL);
if (esw_mgr_items_tmpl)
flow_hw_pattern_template_destroy(dev, esw_mgr_items_tmpl, NULL);
- return -EINVAL;
+ return ret;
}
static void
@@ -7834,11 +7872,9 @@ flow_hw_configure(struct rte_eth_dev *dev,
NULL, "Failed to create vport actions.");
goto err;
}
- ret = flow_hw_create_ctrl_tables(dev);
- if (ret) {
- rte_errno = -ret;
+ ret = flow_hw_create_ctrl_tables(dev, error);
+ if (ret)
goto err;
- }
}
if (!priv->shared_host)
flow_hw_create_send_to_kernel_actions(priv);
--
2.34.1
^ permalink raw reply [flat|nested] 4+ messages in thread
* RE: [PATCH v3] net/mlx5: fix the error set in control tables create
2023-06-30 9:46 ` [PATCH v3] " Bing Zhao
@ 2023-07-03 10:42 ` Raslan Darawsheh
0 siblings, 0 replies; 4+ messages in thread
From: Raslan Darawsheh @ 2023-07-03 10:42 UTC (permalink / raw)
To: Bing Zhao, Matan Azrad, Slava Ovsiienko, Ori Kam, Suanming Mou
Cc: dev, Dariusz Sosnowski, stable
Hi,
> -----Original Message-----
> From: Bing Zhao <bingz@nvidia.com>
> Sent: Friday, June 30, 2023 12:47 PM
> To: Matan Azrad <matan@nvidia.com>; Slava Ovsiienko
> <viacheslavo@nvidia.com>; Ori Kam <orika@nvidia.com>; Suanming Mou
> <suanmingm@nvidia.com>; Raslan Darawsheh <rasland@nvidia.com>
> Cc: dev@dpdk.org; Dariusz Sosnowski <dsosnowski@nvidia.com>;
> stable@dpdk.org
> Subject: [PATCH v3] net/mlx5: fix the error set in control tables create
>
> When some failure occurs in the flow_hw_create_ctrl_tables(), the
> "rte_flow_error" should be set properly with all needed information.
> Then the rte_errno and the "message" will reflect the actual failure.
>
> This will also solve the crash when trying to access the "message".
>
> Fixes: 1939eb6f660c ("net/mlx5: support flow port action with HWS")
> Fixes: 483181f7b6dd ("net/mlx5: support device control of representor
> matching")
> Fixes: ddb68e47331e ("net/mlx5: add extended metadata mode for HWS")
> Cc: dsosnowski@nvidia.com
> Cc: stable@dpdk.org
>
> Signed-off-by: Bing Zhao <bingz@nvidia.com>
> Reviewed-by: Suanming Mou <suanmingm@nvidia.com>
> Acked-by: Ori Kam <orika@nvidia.com>
> ---
> v2: add CC stable
> v3: fix the typo
Patch applied to next-net-mlx,
Kindest regards,
Raslan Darawsheh
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2023-07-03 10:42 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-06-30 6:36 [PATCH 5/7] net/mlx5: fix the error set in control tables create Bing Zhao
2023-06-30 9:25 ` [PATCH v2] " Bing Zhao
2023-06-30 9:46 ` [PATCH v3] " Bing Zhao
2023-07-03 10:42 ` Raslan Darawsheh
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).