Struct MountWatcher 

pub struct MountWatcher { /* private fields */ }

MountWatcher allows to react to changes in the mounted filesystems.

Stopping

When the MountWatcher is dropped, the background thread that drives the watcher is stopped, and the callback will never be called again. You can also call stop.

Furthermore, you can stop the watcher from the event handler itself, by returning WatchControl::Stop.

Example (stop in handler)

use mount_watcher::{MountWatcher, WatchControl};

let watch = MountWatcher::new(|event| {
    let added_mounts = event.mounted;
    let removed_mounts = event.unmounted;
    let stop_condition = todo!();
    if stop_condition {
        // I have found what I wanted, stop here.
        WatchControl::Stop
    } else {
        // Continue to watch, I still want events.
        WatchControl::Continue
    }
}).unwrap();
// Wait for the watcher to be stopped by the handler
watch.join().unwrap();

Implementations

impl MountWatcher

pub fn new( callback: impl FnMut(MountEvent) -> WatchControl + Send + 'static, ) -> Result<Self, SetupError>

Watches the list of mounted filesystems and executes the callback when it changes.

pub fn stop(&self) -> Result<(), StopError>

Requests the background thread to terminate.

To wait for the termination, use join.

pub fn join(self) -> Result<()>

Waits for the background thread to terminate.

This blocks the current thread.

Errors

If the background thread has panicked, an error is returned with the panic payload.

Trait Implementations

impl Drop for MountWatcher

fn drop(&mut self)

Executes the destructor for this type.