Struct NativeFile 

pub struct NativeFile { /* private fields */ }

One file owned by the native I/O runtime.

Callers retain responsibility for capability-safe path resolution and pass the resulting handle here exactly once. Operations submitted through this handle execute in first-poll order. Creating an operation is lazy: an unpolled future neither submits I/O nor delays later operations. Once an operation has been polled, dropping its observer does not overtake earlier admitted work.

Implementations

impl NativeFile

pub fn from_file(file: File) -> Result<Self>

Transfers ownership of an already-authorized file handle to the runtime.

pub fn set_len_async(&self, size: u64) -> UnitCompletion

Changes the logical file length without blocking the caller’s executor.

pub fn control_async( &self, operation: impl FnOnce(&File) -> Result<()> + Send + 'static, ) -> UnitCompletion

Runs a platform-specific handle control in this file’s operation order. The closure owns no borrowed handle after completion and executes off the caller’s async executor when native completion is unavailable.

pub fn read_batch_async(&self, reads: Vec<OwnedRead>) -> ReadBatch

Submits owned positional reads while retaining this handle.

pub fn write_all_batch_async(&self, writes: Vec<OwnedWrite>) -> UnitCompletion

Submits owned writes while retaining this handle for later operations.

pub fn sync_async(&self, durability: Durability) -> UnitCompletion

Flushes file contents and metadata without blocking the caller’s executor.