Struct MonitorBuilder 

pub struct MonitorBuilder { /* private fields */ }

Monitors for device events.

A monitor communicates with the kernel over a socket. Filtering events is performed efficiently in the kernel, and only events that match the filters are received by the socket. Filters must be set up before listening for events.

Implementations

impl Builder

pub fn new() -> Result<Self>

Creates a new udev event Monitor.

Examples found in repository

examples/monitor.rs (line 185)

fn main() -> io::Result<()> {
    let socket = udev::MonitorBuilder::new()?
        // .match_subsystem_devtype("usb", "usb_device")?
        .match_subsystem_devtype("block", "disk")?
        .listen()?;

    poll::poll(socket)
}

pub fn new_kernel() -> Result<Self>

Creates a new kernel event Monitor.

pub fn match_subsystem<T: AsRef<OsStr>>(self, subsystem: T) -> Result<Self>

Adds a filter that matches events for devices with the given subsystem.

pub fn match_subsystem_devtype<T: AsRef<OsStr>, U: AsRef<OsStr>>( self, subsystem: T, devtype: U, ) -> Result<Self>

Adds a filter that matches events for devices with the given subsystem and device type.

Examples found in repository

examples/monitor.rs (line 187)

fn main() -> io::Result<()> {
    let socket = udev::MonitorBuilder::new()?
        // .match_subsystem_devtype("usb", "usb_device")?
        .match_subsystem_devtype("block", "disk")?
        .listen()?;

    poll::poll(socket)
}

pub fn match_tag<T: AsRef<OsStr>>(self, tag: T) -> Result<Self>

Adds a filter that matches events for devices with the given tag.

pub fn clear_filters(self) -> Result<Self>

Removes all filters currently set on the monitor.

pub fn listen(self) -> Result<Socket>

Listens for events matching the current filters.

This method consumes the Monitor.

Examples found in repository

examples/monitor.rs (line 188)

fn main() -> io::Result<()> {
    let socket = udev::MonitorBuilder::new()?
        // .match_subsystem_devtype("usb", "usb_device")?
        .match_subsystem_devtype("block", "disk")?
        .listen()?;

    poll::poll(socket)
}

Trait Implementations

impl AsFd for Builder

Provides raw access to the monitor’s socket.

fn as_fd(&self) -> BorrowedFd<'_>

Returns the file descriptor of the monitor’s socket.

impl AsRawFd for Builder

Provides raw access to the monitor’s socket.

fn as_raw_fd(&self) -> RawFd

Returns the file descriptor of the monitor’s socket.

impl AsRawWithContext<udev_monitor> for Builder

fn as_raw(&self) -> *mut udev_monitor

Get a reference of the underlying struct.

fn udev(&self) -> &Udev

The udev context with which this struct was created. This must live at least as long as the struct itself or undefined behavior will result.

fn into_raw_with_context(self) -> (*mut udev, *mut udev_monitor)

Convert the object into the raw udev pointer and the underlying pointer for this object.

impl Clone for Builder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Builder

fn drop(&mut self)

Executes the destructor for this type.

impl FromRawWithContext<udev_monitor> for Builder

unsafe fn from_raw_with_context(udev: *mut udev, t: *mut udev_monitor) -> Self

Create an object from a given raw pointer and udev context pointer.