3 releases

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

#48 in macOS and iOS APIs

Download history 409/week @ 2024-06-20 433/week @ 2024-06-27 461/week @ 2024-07-04 583/week @ 2024-07-11 451/week @ 2024-07-18 376/week @ 2024-07-25 436/week @ 2024-08-01 423/week @ 2024-08-08 371/week @ 2024-08-15 342/week @ 2024-08-22 337/week @ 2024-08-29 401/week @ 2024-09-05 302/week @ 2024-09-12 242/week @ 2024-09-19 394/week @ 2024-09-26 459/week @ 2024-10-03

1,447 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