3 releases

0.1.2 Dec 27, 2022
0.1.1 Jun 22, 2017
0.1.0 Jun 22, 2017

#51 in macOS and iOS APIs

Download history 161/week @ 2023-12-20 236/week @ 2023-12-27 241/week @ 2024-01-03 172/week @ 2024-01-10 241/week @ 2024-01-17 279/week @ 2024-01-24 203/week @ 2024-01-31 244/week @ 2024-02-07 397/week @ 2024-02-14 479/week @ 2024-02-21 368/week @ 2024-02-28 382/week @ 2024-03-06 362/week @ 2024-03-13 405/week @ 2024-03-20 370/week @ 2024-03-27 228/week @ 2024-04-03

1,416 downloads per month
Used in 5 crates (3 directly)

MIT/Apache

14KB
222 lines

dmg

Simple attaching/detaching of macOS disk images.

Build Status crates.io Docs

Example

Attach a disk image until dropped:

use dmg::Attach;
let info = Attach::new("Test.dmg").with().expect("could not attach");
println!("Mounted at {:?}", info.mount_point);
// Detched when 'info' dropped

If you prefer to handle detaching yourself simply use attach():

use dmg::Attach;
let info = Attach::new("Test.dmg").attach().expect("could not attach");
println!("Device node {:?}", info.device);
info.detach().expect("could not detach"); // There is also .force_detach()

If you know the device node or mount point, you can detach it like this too:

use dmg;
dmg::detach("/Volumes/Test", false).expect("could not detach"); // Do not force detach

For more examples see src/tests.rs and src/bin/demo.rs

Testing

To create Test.dmg run:

./create_dmg.sh

This will create a read-write .dmg file containg a single file called SAMPLE.

hdiutil doesn not like attaching and detaching the same file concurrently, so test using:

cargo test -- --test-threads 1

License

Licensed under either of

at your option.

Dependencies

~3.5MB
~61K SLoC