#mount #linux #syscalls #high-level #sys #umount

sys-mount

High level FFI binding around the sys mount & umount2 calls

13 stable releases

3.0.1 Feb 5, 2024
2.1.1 Jan 5, 2024
2.1.0 Aug 4, 2023
2.0.2 Jan 31, 2023
1.1.0 Nov 1, 2018

#17 in Unix APIs

Download history 2966/week @ 2023-12-23 3987/week @ 2023-12-30 17292/week @ 2024-01-06 22653/week @ 2024-01-13 21316/week @ 2024-01-20 24747/week @ 2024-01-27 30773/week @ 2024-02-03 23636/week @ 2024-02-10 35117/week @ 2024-02-17 35094/week @ 2024-02-24 29640/week @ 2024-03-02 35565/week @ 2024-03-09 35050/week @ 2024-03-16 39442/week @ 2024-03-23 36480/week @ 2024-03-30 37337/week @ 2024-04-06

153,716 downloads per month
Used in 10 crates (9 directly)

MIT/Apache

35KB
534 lines

sys-mount

Rust Compatibility License

High level FFI bindings to the mount and umount2 system calls, for Rust.

Examples

Mount

This is how the mount command could be written with this API.

extern crate clap;
extern crate sys_mount;

use clap::{App, Arg};
use sys_mount::{Mount, MountFlags, SupportedFilesystems};
use std::process::exit;

fn main() {
    let matches = App::new("mount")
        .arg(Arg::with_name("source").required(true))
        .arg(Arg::with_name("directory").required(true))
        .get_matches();

    let src = matches.value_of("source").unwrap();
    let dir = matches.value_of("directory").unwrap();

    // Fetch a listed of supported file systems on this system. This will be used
    // as the fstype to `Mount::new`, as the `Auto` mount parameter.
    let supported = match SupportedFilesystems::new() {
        Ok(supported) => supported,
        Err(why) => {
            eprintln!("failed to get supported file systems: {}", why);
            exit(1);
        }
    };

    // The source block will be mounted to the target directory, and the fstype is likely
    // one of the supported file systems.
    let result = Mount::builder()
        .fstype(FilesystemType::from(&supported))
        .mount(src, dir);

    match result {
        Ok(mount) => {
            println!("mounted {} ({}) to {}", src, mount.get_fstype(), dir);
        }
        Err(why) => {
            eprintln!("failed to mount {} to {}: {}", src, dir, why);
            exit(1);
        }
    }
}

Umount

This is how the umount command could be implemented.

extern crate clap;
extern crate sys_mount;

use clap::{App, Arg};
use sys_mount::{unmount, UnmountFlags};
use std::process::exit;

fn main() {
    let matches = App::new("umount")
        .arg(Arg::with_name("lazy")
            .short("l")
            .long("lazy"))
        .arg(Arg::with_name("source").required(true))
        .get_matches();

    let src = matches.value_of("source").unwrap();

    let flags = if matches.is_present("lazy") {
        UnmountFlags::DETACH
    } else {
        UnmountFlags::empty()
    };

    match unmount(src, flags) {
        Ok(()) => (),
        Err(why) => {
            eprintln!("failed to unmount {}: {}", src, why);
            exit(1);
        }
    }
}

Dependencies

~0.7–10MB
~73K SLoC