3 releases

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

#72 in macOS and iOS APIs

Download history 193/week @ 2024-12-08 155/week @ 2024-12-15 223/week @ 2024-12-22 348/week @ 2024-12-29 208/week @ 2025-01-05 189/week @ 2025-01-12 211/week @ 2025-01-19 281/week @ 2025-01-26 264/week @ 2025-02-02 322/week @ 2025-02-09 270/week @ 2025-02-16 286/week @ 2025-02-23 300/week @ 2025-03-02 302/week @ 2025-03-09 323/week @ 2025-03-16 246/week @ 2025-03-23

1,210 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
~63K SLoC