Struct userfaultfd::UffdBuilder

pub struct UffdBuilder { /* fields omitted */ }

A builder for initializing Uffd objects.

use userfaultfd::UffdBuilder;

let uffd = UffdBuilder::new()
    .close_on_exec(true)
    .non_blocking(true)
    .create();
assert!(uffd.is_ok());

Implementations

impl UffdBuilder

pub fn new() -> UffdBuilder

Create a new builder with no required features or ioctls, and close_on_exec and non_blocking both set to false.

pub fn close_on_exec(&mut self, close_on_exec: bool) -> &mut Self

Enable the close-on-exec flag for the new userfaultfd object (see the description of O_CLOEXEC in open(2)).

pub fn non_blocking(&mut self, non_blocking: bool) -> &mut Self

Enable non-blocking operation for the userfaultfd object.

If this is set to false, Uffd::read_event() will block until an event is available to read. Otherwise, it will immediately return None if no event is available.

pub fn require_features(&mut self, feature: FeatureFlags) -> &mut Self

Add a requirement that a particular feature or set of features is available.

If a required feature is unavailable, UffdBuilder.create() will return an error.

pub fn require_ioctls(&mut self, ioctls: IoctlFlags) -> &mut Self

Add a requirement that a particular ioctl or set of ioctls is available.

If a required ioctl is unavailable, UffdBuilder.create() will return an error.

pub fn create(&self) -> Result<Uffd>

Create a Uffd object with the current settings of this builder.