diff options
Diffstat (limited to 'usr/src/man/man7d/ena.7d')
| -rw-r--r-- | usr/src/man/man7d/ena.7d | 135 |
1 files changed, 0 insertions, 135 deletions
diff --git a/usr/src/man/man7d/ena.7d b/usr/src/man/man7d/ena.7d deleted file mode 100644 index d4070e1745..0000000000 --- a/usr/src/man/man7d/ena.7d +++ /dev/null @@ -1,135 +0,0 @@ -.\" -.\" This file and its contents are supplied under the terms of the -.\" Common Development and Distribution License ("CDDL"), version 1.0. -.\" You may only use this file in accordance with the terms of version -.\" 1.0 of the CDDL. -.\" -.\" A full copy of the text of the CDDL should have accompanied this -.\" source. A copy of the CDDL is also available via the Internet at -.\" http://www.illumos.org/license/CDDL. -.\" -.\" -.\" Copyright 2021 Oxide Computer Company -.\" -.Dd Nov 17, 2021 -.Dt ENA 7D -.Os -.Sh NAME -.Nm ena -.Nd Driver for the AWS Elastic Network Adapter -.Sh SYNOPSIS -.Pa /dev/net/ena* -.Sh DESCRIPTION -The -.Sy ena -driver is a GLDv3 NIC driver for the AWS Elastic Network Adapter -family of virtual devices. -The driver supports: -.Bl -dash -offset indent -.It -Jumbo frames up to 9216 bytes. -.It -Multiple Rx and Tx rings. -.El -.Pp -By design, this driver does not support VNICs. -A given ENA device can only ever receive traffic for a single unicast -MAC address and IP address combination, as determined by the AWS configuration. -There is no support for promiscuous mode, or for receiving traffic for -additional unicast or multicast addresses. -.Sh CONFIGURATION -The -.Sy ena.conf -file contains user configurable parameters, each of which is described -below. -This file is read when an ENA device is found and an instance of the -driver is attached to it. -Changes made to this file do not affect running instances. -Only instances attached after the changes will see the effects of -those changes. -Therefore, if you want your change to take effect on a running -instance, you must somehow reload it. -That could be done by a manual reloading of the driver or a system -reboot. -.Sh PROPERTIES -The configuration file can be found at -.Pa /kernel/drv/ena.conf . -.Bl -hang -width Ds -.It Sy rx_queue_num_descs -.Bd -filled -compact -Minimum: -.Sy 64 | -Maximum: -.Sy device dependent -.Ed -.Bd -filled -compact -Default: -.Sy device maximum -.Ed -.Bd -filled -The -.Sy rx_queue_num_descs -property determines the number of descriptors provided by the Rx queue. -Currently a single descriptor is equal to a single packet, but in the -future it may be that a single packet consumes multiple descriptors. -.Ed -.It Sy rx_queue_intr_limit -.Bd -filled -compact -Minimum: -.Sy 16 | -Maximum: -.Sy 4096 -.Ed -.Bd -filled -compact -Default: -.Sy 256 -.Ed -.Bd -filled -The -.Sy rx_queue_intr_limit -property determines the number frames an Rx interrupt will attempt to -process before returning and claiming the interrupt. -This is meant to keep the ENA Rx interrupt handler from consuming too -much system time. -In general, when a NIC becomes saturated with packets, the -.Sy MAC -layer will switch the driver into polling mode to reduce interrupt -load. -.Ed -.It Sy tx_queue_num_descs -.Bd -filled -compact -Minimum: -.Sy 64 | -Maximum: -.Sy device dependent -.Ed -.Bd -filled -compact -Default: -.Sy device maximum -.Ed -.Bd -filled -The -.Sy tx_queue_num_descs -property determines the number of descriptors provided by the Tx queue. -Currently a single descriptor is equal to a single packet, but in the -future it may be that a single packet consumes multiple descriptors. -.Ed -.El -.Sh FILES -.Bl -tag -width Pa -.It Pa /kernel/drv/amd64/ena -Device driver (x86) -.It Pa /kernel/drv/ena.conf -Driver configuration file containing user-configurable options -.El -.Sh INTERFACE STABILITY -The tunables in -.Pa ena.conf -are considered -.Sy Evolving -and may change in the future. -.Sh SEE ALSO -.Xr dladm 1M , -.Xr snoop 1M , -.Xr driver.conf 4 , -.Xr dlpi 7P |
