Struct PendingBufferRegistration 

pub struct PendingBufferRegistration<B: IoBufMut> { /* private fields */ }

A Batch::register_buffers push not yet matched to its completion.

buffers is ManuallyDrop and this type’s own Drop is deliberately empty, mirroring the inventory (PR #20 review response): the registration is already queued via BuildIoRingRegisterBuffers the instant Batch::register_buffers returns, before any completion is observed, so a caller that drops this without ever matching a completion has no proof the kernel is done deciding whether to retain these addresses. Freeing them here anyway would risk handing memory the kernel still references back to the allocator; leaking is the safe failure mode, the same choice the ring’s inventory (D-73) and RegisteredBuffers both already make.

Implementations

impl<B: IoBufMut> PendingBufferRegistration<B>

pub fn user_data(&self) -> usize

This push’s UserData identity, to match against a popped Completion.

pub fn claim_if( self, completion: &Completion, ) -> Result<Result<RegisteredBuffers<B>>, Self>

Turn this pending registration into usable RegisteredBuffers once completion names it, or hand it back unchanged if completion names a different operation.

Errors

The inner Result is Err if the registration itself failed; the buffers are dropped normally in that case, exactly as if they had never been registered – a matched completion, success or failure, is exactly the proof this type’s Drop is waiting for.

Trait Implementations

impl<B: IoBufMut> Debug for PendingBufferRegistration<B>

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

Formats the value using the given formatter.

impl<B: IoBufMut> Drop for PendingBufferRegistration<B>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.