Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Portable libraries and utilities that manipulate HFS+ volumes and Apple's DMG images

branch: master

ADC support for libdmg-hfsplus

adds decompression support only. code is from dmg2img
(http://vu1tur.eu.org/tools/) and is available under the GPL
latest commit d4a253cae4
Derrick Brashear authored March 07, 2010
Octocat-spinner-32 common Updated from xpwn branch November 09, 2008
Octocat-spinner-32 dmg ADC support for libdmg-hfsplus March 07, 2010
Octocat-spinner-32 hdutil Updated from xpwn branch November 09, 2008
Octocat-spinner-32 hfs Updated from xpwn branch November 09, 2008
Octocat-spinner-32 ide Added eclipse IDE support April 27, 2008
Octocat-spinner-32 includes ADC support for libdmg-hfsplus March 07, 2010
Octocat-spinner-32 CMakeLists.txt Updated from xpwn branch November 09, 2008
Octocat-spinner-32 LICENSE changed to GPL license May 16, 2008
Octocat-spinner-32 README.markdown changed to GPL license May 16, 2008
README.markdown

README

This project was first conceived to manipulate Apple's software restore packages (IPSWs) and hence much of it is geared specifically toward that format. Useful tools to read and manipulate the internal data structures of those files have been created to that end, and with minor changes, more generality can be achieved in the general utility. An inexhaustive list of such changes would be selectively enabling folder counts in HFS+, switching between case sensitivity and non-sensitivity, and more fine-grained control over the layout of created dmgs.

THE CODE HEREIN SHOULD BE CONSIDERED HIGHLY EXPERIMENTAL

Extensive testing have not been done, but comparatively simple tasks like adding and removing files from a mostly contiguous filesystem are well proven.

Please note that these tools and routines are currently only suitable to be accessed by other programs that know what they're doing. I.e., doing something you "shouldn't" be able to do, like removing non-existent files is probably not a very good idea.

LICENSE

This work is released under the terms of the GNU General Public License, version 3. The full text of the license can be found in the LICENSE file.

DEPENDENCIES

The HFS portion will work on any platform that supports GNU C and POSIX conventions. The dmg portion has dependencies on zlib (which is included) and libcrypto from openssl (which is not). If libcrypto is not available, remove the -DHAVE_CRYPT flags from the CFLAGS of the makefiles. All FileVault related actions will fail, but everything else should still work. I imagine most places have libcrypto, and probably statically compiled zlib was a dumb idea too.

USING

The targets of the current repository are three command-line utilities that demonstrate the usage of the library functions (except cmd_grow, which really ought to be moved to catalog.c). To make compilation simpler, a complete, unmodified copy of the zlib distribution is included. The dmg portion of the code has dependencies on the HFS+ portion of the code. The "hdutil" section contains a version of the HFS+ utility that supports directly reading from dmgs. It is separate from the HFS+ utility in order that the hfs directory does not have dependencies on the dmg directory.

The makefile in the root folder will make all utilities.

HFS+

cd hfs
make

DMG

cd dmg/zlib-1.2.3
./configure
make
cd ..
make

hdutil

cd hdiutil
make
Something went wrong with that request. Please try again.