Lines Matching +full:rx +full:- +full:device

1 .\" SPDX-License-Identifier: BSD-2-Clause
3 .\" Copyright (c) 2015-2024 Amazon.com, Inc. or its affiliates.
40 .Bd -ragged -offset indent
41 .Cd "device ena"
47 .Bd -literal -offset indent
54 The ENA device exposes a lightweight management interface with a
58 The driver supports a range of ENA devices, is link-speed independent
62 Some ENA devices support SR-IOV.
63 This driver is used for both the SR-IOV Physical Function (PF) and Virtual
67 processing by providing multiple Tx/Rx queue pairs (the maximum number
68 is advertised by the device via the Admin Queue), a dedicated MSI-X
69 interrupt vector per Tx/Rx queue pair, and CPU cacheline optimized
72 When RSS is enabled, each Tx/Rx queue pair is bound to a corresponding
77 Receive-side scaling (RSS) is supported for multi-core scaling.
82 monitoring mechanisms such as watchdog, enabling the device and driver
86 Some of the ENA devices support a working mode called Low-latency
98 driver supports the following PCI vendor ID/device IDs:
100 .Bl -bullet -compact
102 1d0f:0ec2 - ENA PF
104 1d0f:1ec2 - ENA PF with LLQ support
106 1d0f:ec20 - ENA VF
108 1d0f:ec21 - ENA VF with LLQ support
113 driver's behavior can be changed using run-time or boot-time sysctl
115 The boot-time arguments can be set at the
119 The run-time arguments can be set using the
123 Boot-time tunables:
124 .Bl -tag -width indent
126 Use 9k mbufs for the Rx descriptors.
128 If the node value is set to 1, 9k mbufs will be used for the Rx buffers.
131 Using 9k buffers for Rx can improve Rx throughput, but in low memory conditions
143 In some cases, the packet header can be bigger than this (for example -
147 Using large LLQ header size will take effect only if the device supports
155 Run-time tunables:
156 .Bl -tag -width indent
167 .Bl -bullet -compact
169 0 - ENA_ERR  - Enable driver error messages and ena_com error logs.
171 1 - ENA_WARN - Enable logs for non-critical errors.
173 2 - ENA_INFO - Make the driver more verbose about its actions.
175 3 - ENA_DBG  - Enable debug logs.
178 NOTE: In order to enable logging on the Tx/Rx data path, driver must be compiled
183 .Bd -literal -offset indent
189 Controls the number of IO queue pairs (Tx/Rx). As this call has to reallocate
190 the queues, it will reset the interface and restart all the queues - this means
198 If this also fails, the device reset will be triggered.
201 To use only 2 Tx and Rx queues for the device ena1, the following command should
203 .Bd -literal -offset indent
207 Size of the Rx queue.
209 Controls the number of IO descriptors for each Rx queue.
210 The user may want to increase the Rx queue size if they observe a high number of
212 For performance reasons, the Rx queue size must be a power of 2.
218 If this also fails, the device reset will be triggered.
221 To increase Rx ring size to 8K descriptors for the device ena0, the following
223 .Bd -literal -offset indent
231 The drbr is used as a multiple-producer, single-consumer lockless ring for
244 drbr and trigger the device reset.
249 .Bd -literal -offset indent
259 the device, which will update the ENI metrics values.
268 To update ENI metrics for the device ena1 every 10 seconds, the following
270 .Bd -literal -offset indent
280 .Bd -literal -offset indent
285 The default is x:y key-pairs of indir_table_size length.
298 .Bd -literal -offset indent
322 .Bd -literal -offset indent
327 .Ss Device initialization phase
328 .Bl -diag
332 .It ena%d: Can not reset device
334 Device could not be reset.
336 Device may not be responding or is already during reset.
337 .It ena%d: device version is too low
344 Device stopped responding or it demanded invalid value.
345 .It ena%d: Can not initialize ena admin queue with device
349 Device may not be responding or there was a problem with initialization of
351 .It ena%d: Cannot get attribute for ena device rc: %d
353 Failed to get attributes of the device from the controller.
359 .Bl -diag
365 .It ena%d: Error, MSI-X is already enabled
367 .It ena%d: Not enough number of MSI-X allocated: %d
368 .It ena%d: Error with MSI-X enablement
373 Resource allocation failed when initializing the device.
376 .It ena%d: ENA device init failed (err: %d)
377 .It ena%d: Cannot initialize device
379 Device initialization failed.
388 .It ena%d: Enable MSI-X failed
390 Configuration of the MSI-X for Admin Queue failed.
400 .It ena%d: Unmapped RX DMA tag associations
403 Error occurred when trying to destroy RX/TX DMA tag.
412 The device will work with reduced performance because all RX packets will be
415 .It ena%d: Failed to configure the device mode. Fallback to host mode policy.
418 Error occurred during Low-latency Queue mode setup.
420 The device will work, but without the LLQ performance gain.
429 .Bl -diag
435 This message appears when either MTU change feature is not supported, or device
439 Device stopped responding and will be reset.
445 .It ena%d: The number of lost tx completion is above the threshold (%d > %d). Reset the device
447 If too many Tx weren't completed on time the device is going to be reset.
449 It may be caused by hanged queue or device.
452 Device will be reset.
456 .It ena%d: device reset scheduled but trigger_reset is off
460 Device reset will not be performed.
461 .It ena%d: Device reset failed
463 Error occurred while trying to reset the device.
464 .It ena%d: Cannot initialize device
466 .It ena%d: Error, device max mtu is smaller than ifp MTU
467 .It ena%d: Validation of device parameters failed
468 .It ena%d: Enable MSI-X failed
470 .It ena%d: Reset attempt failed. Can not reset the device
472 Error occurred while trying to restore the device after reset.
473 .It ena%d: Device reset completed successfully, Driver info: %s
475 Device has been correctly restored after reset and is ready to use.
477 .It ena%d: Allocation for Rx Queue %u failed
478 .It ena%d: Unable to create Rx DMA map for buffer %d
481 .It ena%d: Failed to create io RX queue[%d] rc: %d
482 .It ena%d: Failed to get RX queue handlers. RX queue num %d rc: %d
491 Initialization of the LRO for the RX ring failed.
492 .It ena%d: failed to alloc buffer for rx queue
493 .It ena%d: failed to add buffer for rx queue %d
494 .It ena%d: refilled rx qid %d with only %d mbufs (from %d)
496 Allocation of resources used on RX path failed.
510 IOCTL request for the device to work in promiscuous/allmulti mode.