Struct Descriptor 

pub struct Descriptor { /* private fields */ }

高层描述符

封装 XdpDesc 并添加所有权元数据。

• index: 帧索引（通过 addr 计算）
• generation: 代际号（ABA 防护）
• owner: 所有者 ID（队列/Worker）
• desc_type: 语义类型

Implementations

impl Descriptor

pub fn new( xdp: XdpDesc, index: u32, owner: u16, generation: u16, desc_type: DescriptorType, ) -> Self

创建新的描述符

pub fn from_xdp( xdp: XdpDesc, owner: u16, generation: u16, frame_shift: u32, ) -> Result<Self>

从内核描述符创建（自动派生 index，fail-closed）

xdp.addr >> frame_shift 必须落入 20-bit frame index 域（≤ MAX_FRAME_INDEX）。 frame_shift 由调用方从 DescriptorEngine::frame_shift 获取， 保证与引擎实际帧移位一致，杜绝硬编码 >> 12 在非 4096 帧大小下的索引坍塌。

返回

• Ok(Self) - 帧索引合法的描述符
• Err(DescriptorError::OutOfRange) - addr >> frame_shift 超出 20-bit 帧索引域； 静默 as u32 截断会丢弃高 32 位并指向错误帧（甚至回绕到帧 0）， 故构造期拒绝（fail-closed，参照 DescriptorEngine::allocate 的对称语义）

pub fn xdp_desc(&self) -> &XdpDesc

获取内核描述符

pub fn addr(&self) -> u64

获取 addr

pub fn len(&self) -> u32

获取 len

pub fn is_empty(&self) -> bool

判断描述符的 len 是否为 0

pub fn options(&self) -> u32

获取 options

pub fn index(&self) -> u32

获取帧索引

pub fn owner(&self) -> u16

获取所有者 ID

pub fn generation(&self) -> u16

获取代际号

pub fn descriptor_type(&self) -> DescriptorType

获取描述符类型

pub fn set_owner(&mut self, new_owner: u16)

设置所有者

pub fn set_generation(&mut self, new_generation: u16)

设置代际号

pub fn is_zero(&self) -> bool

是否为零描述符

pub fn to_raw(&self) -> [u64; 2]

转换为原始 ring 数据（两个 u64）

Trait Implementations

impl Clone for Descriptor

fn clone(&self) -> Descriptor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Descriptor

impl Debug for Descriptor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Descriptor

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Descriptor

impl PartialEq for Descriptor

fn eq(&self, other: &Descriptor) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Descriptor