---
name: "rte_eth_rxconf"
section: "3"
platform: "linux"
package: "dpdk-doc"
version: "24.11.4-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rte_eth_rxconf"
---

# rte\_eth\_rxconf(3)

## NAME

rte\_eth\_rxconf

## SYNOPSIS

`#include <rte_ethdev.h>`

### Data Fields

struct **rte\_eth\_thresh** **rx\_thresh**\
 uint16\_t **rx\_free\_thresh**\
 uint8\_t **rx\_drop\_en**\
 uint8\_t **rx\_deferred\_start**\
 uint16\_t **rx\_nseg**\
 uint16\_t **share\_group**\
 uint16\_t **share\_qid**\
 uint64\_t **offloads**\
 union **rte\_eth\_rxseg** \* **rx\_seg**\
 struct **rte\_mempool** \*\* **rx\_mempools**\
 uint64\_t **reserved\_64s** \[2\]\
 void \* **reserved\_ptrs** \[2\]\

## Detailed Description

A structure used to configure an Rx ring of an Ethernet port.

Definition at line **1125** of file **rte\_ethdev.h**.

## Field Documentation

### struct rte\_eth\_thresh rx\_thresh

Rx ring threshold registers.

Definition at line **1126** of file **rte\_ethdev.h**.

### uint16\_t rx\_free\_thresh

Drives the freeing of Rx descriptors.

Definition at line **1127** of file **rte\_ethdev.h**.

### uint8\_t rx\_drop\_en

Drop packets if no descriptors are available.

Definition at line **1128** of file **rte\_ethdev.h**.

### uint8\_t rx\_deferred\_start

Do not start queue with **rte\_eth\_dev\_start()**.

Definition at line **1129** of file **rte\_ethdev.h**.

### uint16\_t rx\_nseg

Number of descriptions in rx\_seg array.

Definition at line **1130** of file **rte\_ethdev.h**.

### uint16\_t share\_group

Share group index in Rx domain and switch domain. Non-zero value to enable Rx queue share, zero value disable share. PMD is responsible for Rx queue consistency checks to avoid member port's configuration contradict to each other.

Definition at line **1137** of file **rte\_ethdev.h**.

### uint16\_t share\_qid

Shared Rx queue ID in group

Definition at line **1138** of file **rte\_ethdev.h**.

### uint64\_t offloads

Per-queue Rx offloads to be set using RTE\_ETH\_RX\_OFFLOAD\_\* flags. Only offloads set on rx\_queue\_offload\_capa or rx\_offload\_capa fields on **rte\_eth\_dev\_info** structure are allowed to be set.

Definition at line **1144** of file **rte\_ethdev.h**.

### union rte\_eth\_rxseg\* rx\_seg

Points to the array of segment descriptions for an entire packet. Array elements are properties for consecutive Rx segments.

The supported capabilities of receiving segmentation is reported in **rte\_eth\_dev\_info.rx\_seg\_capa** field.

Definition at line **1152** of file **rte\_ethdev.h**.

### struct rte\_mempool\*\* rx\_mempools

Array of mempools to allocate Rx buffers from.

This provides support for multiple mbuf pools per Rx queue. The capability is reported in device info via positive max\_rx\_mempools.

It could be useful for more efficient usage of memory when an application creates different mempools to steer the specific size of the packet.

If many mempools are specified, packets received using Rx burst may belong to any provided mempool. From ethdev user point of view it is undefined how PMD/NIC chooses mempool for a packet.

If Rx scatter is enabled, a packet may be delivered using a chain of mbufs obtained from single mempool or multiple mempools based on the NIC implementation.

Definition at line **1173** of file **rte\_ethdev.h**.

### uint64\_t reserved\_64s\[2\]

\< Number of Rx mempools Reserved for future fields

Definition at line **1176** of file **rte\_ethdev.h**.

### void\* reserved\_ptrs\[2\]

Reserved for future fields

Definition at line **1177** of file **rte\_ethdev.h**.

## Author

Generated automatically by Doxygen for DPDK from the source code.