UDisks

An unofficial Rust client crate for udisks2. UDisks allows accessing and manipulating disks, storage devices and similar technologies.

udisks need to be installed and accessible.

Version

Based on udisks version 2.11.0.

Example

// we use zbus::block_on in this example, but you can use any runtime
fn main() -> udisks2::Result<()> {
    zbus::block_on(async move {
        let client = udisks2::Client::new().await?;
        let object = client.object("/org/freedesktop/UDisks2/block_devices/sda")?;
        let Ok(block) = object.block().await else {
            eprintln!("No block for sda found");
            return Ok(());
        };
        let drive = client.drive_for_block(&block).await?;
        println!(
            "Size: {}",
            client.size_for_display(drive.size().await?, true, true)
        );
        Ok(())
    })
}

Internationalization

Some functions in the crate provide the option to return translated text, which may be directly used in user interface. This crate uses the same localization as UDisks2 (via gettext). If the locale is left unset, English will be used.

To setup localization, to e.g. German:

unsafe { gettextrs::setlocale(gettextrs::LocaleCategory::LcAll, "de_DE.UTF-8") };
gettextrs::textdomain("udisks2").expect("Failed to set textdomain");