Struct io_uring::Submitter

pub struct Submitter<'a> { /* fields omitted */ }

Submitter

Methods

impl<'a> Submitter<'a>

pub fn register(&self, target: Target) -> Result<()>

Deprecated since 0.3.5:

please use Submitter::register_* instead

Register files or user buffers for asynchronous I/O.

pub fn unregister(&self, target: Target) -> Result<()>

Deprecated since 0.3.5:

please use Submitter::unregister_* instead

Unregister files or user buffers for asynchronous I/O.

pub unsafe fn enter(
    &self,
    to_submit: u32,
    min_complete: u32,
    flag: u32,
    sig: Option<&sigset_t>
) -> Result<usize>

Initiate and/or complete asynchronous I/O

Safety

This provides a raw interface so developer must ensure that parameters are correct.

pub fn submit(&self) -> Result<usize>

Initiate asynchronous I/O.

pub fn submit_and_wait(&self, want: usize) -> Result<usize>

Initiate and/or complete asynchronous I/O

pub fn register_buffers(&self, bufs: &[iovec]) -> Result<()>

Register buffers.

pub fn register_files(&self, fds: &[RawFd]) -> Result<()>

Register files for I/O.

pub fn register_eventfd(&self, eventfd: RawFd) -> Result<()>

It’s possible to use eventfd(2) to get notified of completion events on an io_uring instance.

pub fn register_files_update(&self, offset: u32, fds: &[RawFd]) -> Result<usize>

This operation replaces existing files in the registered file set with new ones, either turning a sparse entry (one where fd is equal to -1) into a real one, removing an existing entry (new one is set to -1), or replacing an existing entry with a new existing entry.

pub fn register_eventfd_async(&self, eventfd: RawFd) -> Result<()>

This works just like Submitter::register_eventfd, except notifications are only posted for events that complete in an async manner.

pub fn register_probe(&self, probe: &mut Probe) -> Result<()>

This operation returns a structure Probe, which contains information about the opcodes supported by io_uring on the running kernel.

pub fn register_personality(&self) -> Result<i32>

This operation registers credentials of the running application with io_uring, and returns an id associated with these credentials.

pub fn unregister_buffers(&self) -> Result<()>

Unregister buffers.

pub fn unregister_files(&self) -> Result<()>

Unregister files.

pub fn unregister_eventfd(&self) -> Result<()>

Unregister an eventfd file descriptor to stop notifications.

pub fn unregister_personality(&self, id: i32) -> Result<()>

This operation unregisters a previously registered personality with io_uring.