mach-o loader for linux
C C++ Shell Other
Switch branches/tags
Nothing to show
Clone or download
shinh Merge pull request #24 from yoshisatoyanagisawa/mutexlock
Support std::mutex::lock and add several kdebug_trace* functions.
Latest commit 464a90f May 2, 2018
Failed to load latest commit information.
include Handle LC_MAIN to support tools in Xcode 5 Nov 3, 2013
libmac Use arg instead of inlien asm to get this. May 2, 2018
mach Add a testcase for strlcpy Apr 10, 2013
.gdbinit Apparently, we want set follow-fork-mode child Mar 27, 2011
.gitignore Remove whitespace [ WhitespaceBot] Oct 21, 2011
.travis.yml Update .travis.yml to trusty May 2, 2017
LICENSE Create LICENSE file for GPLv3 May 1, 2017
Makefile Makefile updated with C++11 flag and Travis file created May 1, 2017 Correct the link to Travis May 5, 2017 Now handles 32bit Mach-O as well Jun 16, 2011
env_flags.h Log output can be controled by env Mar 25, 2011 Use return values of fwrite Oct 11, 2011 s/x86/i386/ May 22, 2011
fat.h Add fat.h and to share code in Mar 10, 2011 Add a gdb command to output no demangled symbols Mar 26, 2011 Change deprecated auto_ptr to unique_ptr May 1, 2017 Add a short description and license to Jun 16, 2011 Log output can be controled by env Mar 25, 2011
log.h Add a make target to create a release binary Mar 28, 2011 Handle LC_MAIN to support tools in Xcode 5 Nov 3, 2013
mach-o.h Handle LC_MAIN to support tools in Xcode 5 Nov 3, 2013 Change deprecated auto_ptr to unique_ptr May 1, 2017 The first code commit. Mar 9, 2011 Supports std::mutex::lock. May 2, 2018 Use ld-mac explicitly in Nov 12, 2011 Update Nov 3, 2013

Maloader Build Status

This is a userland Mach-O loader for linux.


$ make release


$ ./ld-mac mac_binary [options...]

You need OpenCFLite ( installed if you want to run some programs such as dsymutil. opencflite-476.17.2 is recommended.

How to use compiler toolchains of Xcode

Recent Xcode toolchains are built by clang/libc++. This means some C++ programs do not work with ld-mac linked against libstdc++. To build ld-mac with clang/libc++, run

$ make clean
$ make USE_LIBCXX=1

You need compiler toolchain binaries on your Linux. in this repository helps you to set up them if you have a dmg package of Xcode. This script was checked with Xcode 4.3.3, 4.4.1, 4.5.2, 4.6.2, and 5.0.1. It would work even on other Xcode releases, but you may need to modify the script by yourself. How things are stored in dmg packages heavily depend on the version of Xcode. You can use this like

$ ./ ~/Downloads/xcode_5.0.1_command_line_tools*.dmg

This will create xcode_5.0.1_command_line_tools*/root. We will call this directory as $ROOT.

$ ./ld-mac $ROOT/usr/bin/clang --sysroot=$ROOT -c mach/hello.c
$ file hello.o
hello.o: Mach-O 64-bit x86_64 object

To link binaries on Linux, you also need necessary dylibs in root/usr/lib. For example, simple hello world program requires /usr/lib/libSystem.dylib and /usr/lib/system. Do something like

(mac)$ tar -cvzf sys.tgz /usr/lib/libSystem* /usr/lib/system
(mac)$ scp sys.tgz $USER@linux:/tmp
(linux)$ cd $ROOT && tar -xvzf /tmp/sys.tgz

Also note that it seems ld does not like the version number of Xcode. So you need to move xcode_5.0.1_command_line_tools*/root to somewhere else. For example:

$ ln -sf xcode_5.0.1_command_line_tools_10.9_20131022/root
$ ./ld-mac $ROOT/usr/bin/clang --sysroot=$ROOT -g mach/hello.c
$ ./ld-mac ./a.out
Hello, 64bit world!

How to use compiler toolchains of Xcode 3.2.6

Get xcode_3.2.6_and_ios_sdk_4.3__final.dmg (or another xcode package).

$ git clone
$ ./maloader/ xcode_3.2.6_and_ios_sdk_4.3__final.dmg
$ sudo cp -a xcode_3.2.6_and_ios_sdk_4.3__final/root /usr/i686-apple-darwin10
$ cd maloader
$ make release
$ ./ld-mac /usr/i686-apple-darwin10/usr/bin/gcc mach/hello.c
$ ./ld-mac a.out

How to run Mach-O binaries using binfmt_misc

$ ./
$ /usr/i686-apple-darwin10/usr/bin/gcc mach/hello.c
$ ./a.out

To remove the entries, run the following command:

$ ./ stop

How to try 32bit support

$ make clean
$ make all BITS=32

If you see permission errors like:

ld-mac: ./mach/hello.c.bin mmap(file) failed: Operation not permitted

you should run the following command to allow users to mmap files to addresses less than 0x10000.

$ sudo sh -c 'echo 4096 > /proc/sys/vm/mmap_min_addr'

Or, running ld-mac as a super user would also work.

How to run both 64bit Mach-O and 32bit Mach-O binaries

$ make both
$ ./ start `pwd`/
$ /usr/i686-apple-darwin10/usr/bin/gcc -arch i386 mach/hello.c -o hello32
$ /usr/i686-apple-darwin10/usr/bin/gcc -arch x86_64 mach/hello.c -o hello64
$ /usr/i686-apple-darwin10/usr/bin/gcc -arch i386 -arch x86_64 mach/hello.c -o hello
$ ./hello32
Hello, 32bit world!
$ ./hello64
Hello, 64bit world!
$ ./hello
Hello, 64bit world!
$ LD_MAC_BITS=32 ./hello
Hello, 32bit world!

Which programs should work


  • gcc-4.2 (link with -g requires OpenCFLite)
  • otool
  • nm
  • dyldinfo
  • dwarfdump
  • strip
  • size
  • dsymutil (need OpenCFLite)
  • cpp-4.2
  • clang

not OK

  • llvm-gcc
  • gnumake and bsdmake
  • lex and flex
  • ar
  • m4
  • gdb
  • libtool
  • nasm and ndisasm (i386)
  • mpicc, mpicxx, and mpic++



  • read dwarf for better backtracing
  • make llvm-gcc work
  • improve 32bit support
  • handle dwarf and C++ exception


Simplified BSD License or GPLv3.

Note that all files in "include" directory and some files in "libmac" were copied from Apple's Libc-594.9.1.

See for GPLv3.