darlinghq/darling-dmg
1
0
Fork 0
mirror of https://github.com/darlinghq/darling-dmg.git synced 2024-11-23 03:39:44 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
FUSE module for .dmg files (containing an HFS+ filesystem)
179 Commits 3 Branches 5 Tags 397 KiB
C++ 87.1%
C 10.4%
CMake 2.5%
master
Go to file
Thomas A a36bf0c07b Update CMake Version To 3.13
2023-07-26 10:06:28 -07:00
cmake_modules consistent capitalization for LibXml2 2020-04-24 23:01:33 +01:00
src Pass input without trailing whitespace to prevent decoder from getting confused 2022-11-14 18:56:33 +01:00
test Move some test sources into the test/ directory 2015-03-31 13:05:59 +02:00
CMakeLists.txt Update CMake Version To 3.13 2023-07-26 10:06:28 -07:00
LICENSE Initial untested work 2013-06-10 21:09:37 +02:00
README.md docs: add table explaining purpose of each dependency 2023-06-13 15:16:55 +05:30

README.md

darling-dmg

This project allows ordinary users to directly mount OS X disk images under Linux via FUSE. darling-dmg is part of Darling - http://www.darlinghq.org

Without darling-dmg, the only way to do this would be to manually extract the DMG file, become root and mount the HFS+ filesystem as root. This is slow, wasteful and may even crash your system. The project's author has seen the Linux HFS+ implementation cause kernel crashes.

Supported file types

  • DMG (UDIF) files containing an Apple Disk Image.
  • Apple Disk Images containing an HFS+/HFSX file system.
  • HFS+/HFSX file systems (incl. file systems embedded within HFS).

This means, darling-dmg can mount DMG files or unpacked DMG files or a single partition carved out of the latter.

Read only access only.

Build Requirements

Dependency Required version Notes
GCC/Clang >5 (GCC), >3 (Clang) Compiler with C++11 support
CMake 3.10 Build system
pkg-config Library-agnostic package detection
OpenSSL Base64 decoding
Bzip2 Decompression
Zlib Decompression
FUSE 2.x (not 3.x) Userspace filesystem support
libicu Unicode support
libxml2 XML (property list) parsing

darling-dmg requires a C++11-capable compiler, CMake >3.10 and make alongside the remaining dependencies mentioned above. Below are common ways to install library dependencies.

On Fedora (and derivatives):

sudo dnf install fuse-devel bzip2-devel libicu-devel libxml2-devel openssl-devel zlib-devel pkgconf

On Debian (and derivatives):

sudo apt-get install libfuse-dev libbz2-dev libicu-dev libxml2-dev libssl-dev libz-dev pkg-config

On Alpine Linux:

sudo apk add fuse-dev bzip2-dev icu-dev libxml2-dev openssl-dev zlib-dev pkgconf

Usage

darling-dmg <file-to-mount> <where-to-mount> [FUSE arguments]

Accessing resource forks

Resource forks are available via xattrs (extended attributes) or preferably under the name /original/filename#..namedfork#rsrc.

Reusability

Some people have had success with using darling-dmg as a library for their own use.