Darwin/macOS emulation layer for Linux
Go to file
2012-08-15 12:17:58 +02:00
include Adding more XNU headers 2012-08-09 21:52:24 +02:00
misc Adding a project logo 2012-08-08 00:05:58 +02:00
src Loads of work on dyld and BSD functions 2012-08-15 12:17:58 +02:00
tests Restructuring, adding CMake 2012-08-05 17:36:54 +02:00
tools dyld now working, added support for LC_MAIN 2012-08-13 23:26:33 +02:00
.gdbinit Loads of work on dyld and BSD functions 2012-08-15 12:17:58 +02:00
.gitignore Merge branch 'master' of ssh://git.dolezel.info/var/git/darling 2012-08-06 17:07:12 +02:00
CMakeLists.txt Loads of work on dyld and BSD functions 2012-08-15 12:17:58 +02:00
config.h.in dyld now working, added support for LC_MAIN 2012-08-13 23:26:33 +02:00
README Now ld in xcode4 should work 2011-11-13 18:10:55 +09:00
runtests.sh Use ld-mac explicitly in runtests.sh 2011-11-12 09:54:39 +09:00

This is a userland Mach-O loader for linux.

* Usage

% make release
% ./ld-mac mac_binary [options...]

You need OpenCFLite (http://sourceforge.net/projects/opencflite/)
installed if you want to run some programs such as dsymutil.
opencflite-476.17.2 is recommended.

* How to use compiler tool chains of Xcode

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

% git clone git@github.com:shinh/maloader.git
% ./maloader/unpack_xcode.sh 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

% ./binfmt_misc.sh
% /usr/i686-apple-darwin10/usr/bin/gcc mach/hello.c
% ./a.out

To remove the entries, run the following command:

% ./binfmt_misc.sh 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
% ./binfmt_misc.sh start `pwd`/ld-mac.sh
% /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

OK

- gcc-4.2 (link with -g requires OpenCFLite)
- otool
- nm
- dyldinfo
- dwarfdump
- strip
- size
- dsymutil (need OpenCFLite)
- cpp-4.2
- clang
-- clang-70 (xcode 3.2.6): OK, but linking wasn't checked due to lack of sysroot
-- clang-137 (xcode 4.0): OK

not OK

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

* Notice

- Running all Mac binaries isn't my goal. Only command line tools such
  as compiler tool chain can be executed by this loader.
- A slide about this: http://shinh.skr.jp/slide/ldmac/000.html

* TODO

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

* License

Simplified BSD License.

Note that all files in "include" directory and some files in "libmac"
were copied from Apple's Libc-594.9.1.
http://www.opensource.apple.com/release/mac-os-x-1064/