ethernet/amazon/ena.rst

4 Linux kernel driver for Elastic Network Adapter (ENA) family
10 ENA is a networking interface designed to make good use of modern CPU
13 The ENA device exposes a lightweight management interface with a
17 The driver supports a range of ENA devices, is link-speed independent
21 Some ENA devices support SR-IOV. This driver is used for both the
24 ENA devices enable high speed and low overhead network traffic
30 The ENA driver supports industry standard TCP/IP offload features such as
34 The ENA driver and its corresponding devices implement health
39 Some of the ENA devices support a working mode called Low-latency
42 ENA Source Code Directory Structure
51 ena_admin_defs.h    Definition of ENA management interface.
52 ena_eth_io_defs.h   Definition of ENA data path interface.
54 ena_regs_defs.h     Definition of ENA PCI memory-mapped (MMIO) registers.
64 ENA management interface is exposed by means of:
71 ENA device MMIO Registers are accessed only during driver
78 ENA introduces a small set of management commands with room for
97 queue used by the ENA device to send to the driver events that cannot
131 The ENA driver supports two Queue Operation modes for Tx SQs:
134   In this mode the Tx SQs reside in the host's memory. The ENA
135   device fetches the ENA Tx descriptors and packet data from host
140   first 96 bytes of the packet directly to the ENA device memory
145   **Note that** not all ENA devices support LLQ, and this feature is negotiated
146   with the device upon initialization. If the ENA device does not
184 The ENA device operates in auto-mask and auto-clear interrupt
192 ENA driver and device can operate in conventional or adaptive interrupt
221 The user can obtain ENA device and driver statistics using `ethtool`.
238 The ENA driver supports:
246 - The ENA device supports RSS that allows flexible Rx traffic
271 - Prepares ENA bufs for the remaining frags.
276 - Calls :code:`ena_com_prepare_tx()`, an ENA communication layer that converts
277   the ``ena_bufs`` to ENA descriptors (and adds meta ENA descriptors as
280   * This function also copies the ENA descriptors and the push buffer
283 - Writes a doorbell to the ENA device.
284 - When the ENA device finishes sending the packet, a completion
288   completion descriptors generated by the ENA, with a single
300 - When a packet is received from the ENA device.
303   :code:`ena_com_rx_pkt()`, an ENA communication layer function, which returns the