net/ena: support fragment bypass mode
PATCH v2 4/7 net/ena: support fragment bypass mode
Introduce devarg enable_frag_bypass to toggle the fragment bypass mode for egress packets.
When enabled, this feature bypasses the PPS limit enforced by EC2 for fragmented egress packets on every ENI. Note that enabling this might negatively impact network performance.
By default, this feature is disabled. To enable it set enable_frag_bypass=1. If it cannot be enabled, a warning will be printed, but driver initialization will proceed as normal.
--- doc/guides/nics/ena.rst | 9 ++++ doc/guides/rel_notes/release_25_07.rst | 5 ++ drivers/net/ena/base/ena_com.c | 33 +++++++++++++ drivers/net/ena/base/ena_com.h | 8 ++++ .../net/ena/base/ena_defs/ena_admin_defs.h | 15 ++++++ drivers/net/ena/ena_ethdev.c | 46 +++++++++++++++++++ drivers/net/ena/ena_ethdev.h | 2 + 7 files changed, 118 insertions(+)
doc/guides/nics/ena.rst +9 -0
@@ -141,6 +141,15 @@ Runtime Configuration **A non-zero value for this devarg is mandatory for control path functionality when binding ports to uio_pci_generic kernel module which lacks interrupt support.** + * **enable_frag_bypass** (default 0) + + Enable fragment bypass mode for egress packets. This mode bypasses the PPS + limit enforced by EC2 for fragmented egress packets on every ENI. Note that + enabling it might negatively impact network performance. + + 0 - Disabled (Default). + + 1 - Enabled. ENA Configuration Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
doc/guides/rel_notes/release_25_07.rst +5 -0
@@ -55,6 +55,11 @@ New Features Also, make sure to start the actual text at the margin. ======================================================= +* **Updated Amazon ENA (Elastic Network Adapter) net driver.** + + * Added support for enabling fragment bypass mode for egress packets. + This mode bypasses the PPS limit enforced by EC2 for fragmented egress packets on every ENI. + * **Added Mucse rnp net driver.** Added a new network PMD which supports Mucse 10 Gigabit Ethernet NICs.
drivers/net/ena/base/ena_com.c +33 -0
@@ -3459,3 +3459,36 @@ int ena_com_config_dev_mode(struct ena_com_dev *ena_dev,return 0 ; } +int ena_com_set_frag_bypass (struct ena_com_dev *ena_dev,bool enable) +{ +struct ena_admin_set_feat_resp set_feat_resp; +struct ena_com_admin_queue *admin_queue; +struct ena_admin_set_feat_cmd cmd; +int ret; + +if (!ena_com_check_supported_feature_id (ena_dev,ENA_ADMIN_FRAG_BYPASS )) { +ena_trc_dbg (ena_dev,"Feature %d isn't supported\n" , +ENA_ADMIN_FRAG_BYPASS ); +return ENA_COM_UNSUPPORTED ; + } + +memset (&cmd,0x0 ,sizeof (cmd)); + admin_queue = &ena_dev->admin_queue; + + cmd.aq_common_descriptor.opcode =ENA_ADMIN_SET_FEATURE ; + cmd.aq_common_descriptor.flags =0 ; + cmd.feat_common.feature_id =ENA_ADMIN_FRAG_BYPASS ; + cmd.feat_common.feature_version =ENA_ADMIN_FRAG_BYPASS_FEATURE_VERSION_0 ; + cmd.u.frag_bypass.enable = (u8 )enable; + + ret =ena_com_execute_admin_command (admin_queue, + (struct ena_admin_aq_entry *)&cmd, +sizeof (cmd), + (struct ena_admin_acq_entry *)&set_feat_resp, +sizeof (set_feat_resp)); + +if (unlikely (ret)) +ena_trc_err (ena_dev,"Failed to enable frag bypass. error: %d\n" , ret); + +return ret; +}
drivers/net/ena/base/ena_com.h +8 -0
@@ -1109,6 +1109,14 @@ static inline bool ena_com_get_missing_admin_interrupt(struct ena_com_dev *ena_dreturn ena_dev->admin_queue.is_missing_admin_interrupt; } +/* ena_com_set_frag_bypass - set fragment bypass +* @ena_dev: ENA communication layer struct +* @enable: true if fragment bypass is enabled, false otherwise. +* +* @return - 0 on success, negative value on failure. +*/ +int ena_com_set_frag_bypass (struct ena_com_dev *ena_dev,bool enable); +/* ena_com_io_sq_to_ena_dev - Extract ena_com_dev using contained field io_sq. * @io_sq: IO submit queue struct *
drivers/net/ena/base/ena_defs/ena_admin_defs.h +15 -0
@@ -57,6 +57,7 @@ enum ena_admin_aq_feature_id {ENA_ADMIN_EXTRA_PROPERTIES_STRINGS =5 ,ENA_ADMIN_EXTRA_PROPERTIES_FLAGS =6 ,ENA_ADMIN_MAX_QUEUES_EXT =7 , +ENA_ADMIN_FRAG_BYPASS =8 ,ENA_ADMIN_RSS_HASH_FUNCTION =10 ,ENA_ADMIN_STATELESS_OFFLOAD_CONFIG =11 , ENA_ADMIN_RSS_INDIRECTION_TABLE_CONFIG = 12,
@@ -165,6 +166,11 @@ enum ena_admin_ena_srd_flags { ENA_ADMIN_ENA_SRD_UDP_ORDERING_BYPASS_ENABLED = BIT(2), }; +enum ena_admin_frag_bypass_feature_version { +/* Enable only */ +ENA_ADMIN_FRAG_BYPASS_FEATURE_VERSION_0 =0 , +}; +struct ena_admin_aq_common_desc {/* 11:0 : command_id * 15:12 : reserved12
@@ -706,6 +712,13 @@ struct ena_admin_feature_llq_desc {struct ena_admin_accel_mode_req accel_mode; }; +struct ena_admin_feature_frag_bypass_desc { +/* Enable frag_bypass */ +uint8_t enable; + +uint8_t reserved[3 ]; +}; +struct ena_admin_queue_ext_feature_fields {uint32_t max_tx_sq_num;
@@ -1180,6 +1193,8 @@ struct ena_admin_set_feat_cmd {/* PHC configuration */ struct ena_admin_feature_phc_desc phc; +/* Fragment bypass configuration */ +struct ena_admin_feature_frag_bypass_desc frag_bypass; } u; };
drivers/net/ena/ena_ethdev.c +46 -0
88 lines not on this page · raw message
drivers/net/ena/ena_ethdev.h +2 -0
@@ -348,6 +348,8 @@ struct ena_adapter {/* Time (in microseconds) of the control path queues monitoring interval */ uint64_t control_path_poll_interval; +bool enable_frag_bypass; +/* * Helper variables for holding the information about the supported * metrics.
Signature · 1 line
2.17.1
PATCH v2 5/7 net/ena: fix unhandled interrupt config failure
Fixed the device initialization routine to correctly handle failure during the registration or enabling of interrupts when operating in control path interrupt mode.
--- doc/guides/rel_notes/release_25_07.rst | 2 ++ drivers/net/ena/ena_ethdev.c | 20 ++++++++++++++++++-- 2 files changed, 20 insertions(+), 2 deletions(-)
doc/guides/rel_notes/release_25_07.rst +2 -0
@@ -59,6 +59,8 @@ New Features * Added support for enabling fragment bypass mode for egress packets. This mode bypasses the PPS limit enforced by EC2 for fragmented egress packets on every ENI. + * Fixed the device initialization routine to correctly handle failure during the registration + or enabling of interrupts when operating in control path interrupt mode. * **Added Mucse rnp net driver.**
drivers/net/ena/ena_ethdev.c +18 -2
@@ -2465,8 +2465,16 @@ static int eth_ena_dev_init(struct rte_eth_dev *eth_dev)if (!adapter->control_path_poll_interval) {/* Control path interrupt mode */ -rte_intr_callback_register (intr_handle, ena_control_path_handler, eth_dev); -rte_intr_enable (intr_handle); + rc =rte_intr_callback_register (intr_handle, ena_control_path_handler, eth_dev); +if (unlikely (rc <0 )) { +PMD_DRV_LOG_LINE (ERR ,"Failed to register control path interrupt" ); + goto err_stats_destroy; + } + rc =rte_intr_enable (intr_handle); +if (unlikely (rc <0 )) { +PMD_DRV_LOG_LINE (ERR ,"Failed to enable control path interrupt" ); + goto err_control_path_destroy; + }ena_com_set_admin_polling_mode (ena_dev, false); }else {/* Control path polling mode */
@@ -2485,6 +2493,14 @@ static int eth_ena_dev_init(struct rte_eth_dev *eth_dev)return 0 ; err_control_path_destroy: +if (!adapter->control_path_poll_interval) { + rc =rte_intr_callback_unregister_sync (intr_handle, + ena_control_path_handler, + eth_dev); +if (unlikely (rc <0 )) +PMD_INIT_LOG_LINE (ERR ,"Failed to unregister interrupt handler" ); + } +err_stats_destroy:rte_free (adapter->drv_stats); err_indirect_table_destroy:ena_indirect_table_release (adapter);
Signature · 1 line
2.17.1
PATCH v2 6/7 net/ena: fix aenq timeout with low poll interval
In reply to Shai BrandesThe driver can work in polling-based functionality of the admin queue, eliminating the need for interrupts in the control-path. This mode is mandatory when using the uio_pci_generic driver, which lacks interrupt support.
The control_path_poll_interval devarg is being set within the range [1..1000]. A value of 0 disables the polling mechanism. This value defines the interval in milliseconds at which the driver checks for asynchronous notifications from the device.
Testing revealed that setting this interval below 500 milliseconds might lead to false detection of device unresponsiveness. This patch clamps the user-defined value to the updated valid range [500..1000] that ensures reliable aenq monitoring.
--- doc/guides/nics/ena.rst | 4 +++- doc/guides/rel_notes/release_25_07.rst | 2 ++ drivers/net/ena/ena_ethdev.c | 24 ++++++++++-------------- drivers/net/ena/ena_ethdev.h | 3 ++- 4 files changed, 17 insertions(+), 16 deletions(-)
doc/guides/nics/ena.rst +3 -1
@@ -136,7 +136,9 @@ Runtime Configuration 0 - Disable (Admin queue will work in interrupt mode). - [1..1000] - Number of milliseconds to wait between periodic inspection of the admin queues. + [500..1000] – Time in milliseconds to wait between periodic checks of the admin queues. + If a value outside this range is specified, the driver will automatically adjust it to + fit within the valid range. **A non-zero value for this devarg is mandatory for control path functionality when binding ports to uio_pci_generic kernel module which lacks interrupt support.**
doc/guides/rel_notes/release_25_07.rst +2 -0
@@ -61,6 +61,8 @@ New Features This mode bypasses the PPS limit enforced by EC2 for fragmented egress packets on every ENI. * Fixed the device initialization routine to correctly handle failure during the registration or enabling of interrupts when operating in control path interrupt mode. + * Fixed an issue where the device might be incorrectly reported as unresponsive when using + polling-based admin queue functionality with a poll interval of less than 500 milliseconds. * **Added Mucse rnp net driver.**
drivers/net/ena/ena_ethdev.c +10 -14
@@ -30,6 +30,8 @@#define GET_L4_HDR_LEN (mbuf) \ ((rte_pktmbuf_mtod_offset(mbuf, struct rte_tcp_hdr *, \ mbuf->l3_len + mbuf->l2_len)->data_off) >> 4) +#define CLAMP_VAL (val, min, max) \ + (RTE_MIN(RTE_MAX((val), (typeof(val))(min)), (typeof(val))(max)))#define ETH_GSTRING_LEN 32
@@ -3756,25 +3758,19 @@ static int ena_process_uint_devarg(const char *key,uint64_value *rte_get_timer_hz (); } }else if (strcmp (key,ENA_DEVARG_CONTROL_PATH_POLL_INTERVAL ) ==0 ) { -if (uint64_value >ENA_MAX_CONTROL_PATH_POLL_INTERVAL_MSEC ) { -PMD_INIT_LOG_LINE (ERR , -"Control path polling interval is too long: %" PRIu64" msecs. " -"Maximum allowed: %d msecs." , - uint64_value,ENA_MAX_CONTROL_PATH_POLL_INTERVAL_MSEC ); -return -EINVAL ; - }else if (uint64_value ==0 ) { +if (uint64_value ==0 ) {PMD_INIT_LOG_LINE (INFO , -"Control path polling interval is set to zero. Operating in " -"interrupt mode." ); - adapter->control_path_poll_interval =0 ; +"Control path polling is disabled - Operating in interrupt mode" ); }else { + uint64_value =CLAMP_VAL (uint64_value, +ENA_MIN_CONTROL_PATH_POLL_INTERVAL_MSEC , +ENA_MAX_CONTROL_PATH_POLL_INTERVAL_MSEC );PMD_INIT_LOG_LINE (INFO , -"Control path polling interval is set to %" PRIu64" msecs." , +"Control path polling interval is %" PRIu64" msec" , uint64_value); - adapter->control_path_poll_interval = uint64_value *USEC_PER_MSEC ; } + adapter->control_path_poll_interval = uint64_value * (USEC_PER_MSEC ); } -return 0 ; }
@@ -4081,7 +4077,7 @@ RTE_PMD_REGISTER_KMOD_DEP(net_ena, "* igb_uio | uio_pci_generic | vfio-pci");RTE_PMD_REGISTER_PARAM_STRING (net_ena,ENA_DEVARG_LLQ_POLICY "=<0|1|2|3> " ENA_DEVARG_MISS_TXC_TO "=<uint>" -ENA_DEVARG_CONTROL_PATH_POLL_INTERVAL "=<0-1000>" ); +ENA_DEVARG_CONTROL_PATH_POLL_INTERVAL "= 0|<500-1000>" ENA_DEVARG_ENABLE_FRAG_BYPASS "=<0|1> " );RTE_LOG_REGISTER_SUFFIX (ena_logtype_init, init,NOTICE );RTE_LOG_REGISTER_SUFFIX (ena_logtype_driver, driver,NOTICE );
drivers/net/ena/ena_ethdev.h +2 -1
@@ -42,7 +42,8 @@#define ENA_MONITORED_TX_QUEUES 3#define ENA_DEFAULT_MISSING_COMP 256U -#define ENA_MAX_CONTROL_PATH_POLL_INTERVAL_MSEC 1000 +#define ENA_MAX_CONTROL_PATH_POLL_INTERVAL_MSEC 1000U +#define ENA_MIN_CONTROL_PATH_POLL_INTERVAL_MSEC 500U/* While processing submitted and completed descriptors (rx and tx path * respectively) in a loop it is desired to:
Signature · 1 line
2.17.1
PATCH v2 7/7 net/ena: upgrade driver version to 2.13.0
In reply to Shai BrandesUpgraded the driver version to 2.13.0.
--- drivers/net/ena/ena_ethdev.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/ena/ena_ethdev.c +1 -1
@@ -22,7 +22,7 @@#include <ena_eth_io_defs.h> #define DRV_MODULE_VER_MAJOR 2 -#define DRV_MODULE_VER_MINOR 12 +#define DRV_MODULE_VER_MINOR 13#define DRV_MODULE_VER_SUBMINOR 0#define __MERGE_64B_H_L (h, l) (((uint64_t)h << 32) | l)
Signature · 1 line
2.17.1