Darwin/macOS emulation layer for Linux
Go to file
Ariel Abreu 14d6e83ede
Improve xtrace output for posix_spawn and fix(?) xtrace TLS
This makes xtrace print more useful debugging information for posix_spawn. There are other syscalls that could definitely benefit from having more detailed output (e.g. `kevent` and friends).

Also, I was noticing segfaults when processes exited with pthread_terminate; they were due to xtrace using pthread keys after pthread_terminate had been called, which cleans up pthread keys. This new static key approach should be fault free, if only at the expense of leaking some memory per-thread. TODO: add a death hook in libsystem_kernel to notify xtrace when a thread is *actually* going to die.
2021-11-07 01:20:18 -04:00
.circleci Update CircleCI image 2021-05-03 22:15:55 -04:00
.github Make Github Actions run on pull requests too 2021-05-29 19:40:11 -04:00
basic-headers Add iosmac platform macros 2020-07-15 12:16:27 -04:00
ci Add Jenkinsfile for my CI 2021-07-07 12:34:54 -04:00
cmake Tell ld about the SDK version we're emulating 2021-06-29 22:45:36 -04:00
debian Merge pull request #825 from TheBrokenRail/better-deb 2021-04-30 23:47:28 -04:00
Developer Add some more stubs in some authentication frameworks 2021-07-07 15:37:10 -04:00
etc Remove obsolete files 2018-08-14 11:10:57 +03:00
framework-include Stub NetFS framework 2021-07-07 15:33:36 -04:00
misc Cleanup benchmarks, misc and tools directories 2016-02-26 22:59:34 +01:00
rpm Rpm auto version (#918) 2021-02-12 12:58:46 -05:00
src Improve xtrace output for posix_spawn and fix(?) xtrace TLS 2021-11-07 01:20:18 -04:00
tests/src Remove unused stuff from tests/ 2016-02-26 23:03:00 +01:00
tools PPA source package build script 2021-07-05 09:53:48 -04:00
.gdbinit Loads of work on dyld and BSD functions 2012-08-15 12:17:58 +02:00
.gitignore Correct header lkm going in wrong folder 2020-01-03 13:10:20 -05:00
.gitmodules Many, many fixes/additions for PyObjC 2021-06-28 23:48:24 -04:00
CMakeLists.txt added clang 11 and 12 support 2021-06-25 13:02:09 -04:00
CONTRIBUTORS.md Add contributors file 2017-04-06 09:12:11 +02:00
LICENSE Loads of work, libmacarchive added, copyright headers... 2012-10-22 19:02:06 +02:00
README.md Update URLs to HTTPS 2021-01-04 03:56:37 +03:00

Darling

Darling logo

Darling is a runtime environment for macOS applications.

Please note that most GUI applications will not run at the moment.

Download

Packages for some distributions are available for download under releases.

Build Instructions

For build instructions, visit Darling Docs.

Prefixes

Darling has support for DPREFIXes, which are very similar to WINEPREFIXes. They are virtual “chroot” environments with an macOS-like filesystem structure, where you can install software safely. The default DPREFIX location is ~/.darling, but this can be changed by exporting an identically named environment variable. A prefix is automatically created and initialized on first use.

Please note that we use overlayfs for creating prefixes, and so we cannot support putting prefix on a filesystem like NFS or eCryptfs. In particular, the default prefix location won't work if you have an encrypted home directory.

Hello world

Let's start with a Hello world:

$ darling shell echo Hello world
Hello world

Congratulations, you have printed Hello world through Darling's OS X system call emulation and runtime libraries.

Installing software

You can install .pkg packages with the installer tool available inside shell. It is a somewhat limited cousin of OS X's installer:

$ darling shell
Darling [~]$ installer -pkg mc-4.8.7-0.pkg -target /

The Midnight Commander package from the above example is available for download.

You can uninstall and list packages with the uninstaller command.

Working with DMG images

DMG images can be attached and deattached from inside darling shell with hdiutil. This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet):

Darling [~]$ hdiutil attach Xcode_7.2.dmg
/Volumes/Xcode_7.2
Darling [~]$ cp -r /Volumes/Xcode_7.2/Xcode.app /Applications
Darling [~]$ export SDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk
Darling [~]$ echo 'void main() { puts("Hello world"); }' > helloworld.c
Darling [~]$ /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang helloworld.c -o helloworld
Darling [~]$ ./helloworld
Hello world

Congratulations, you have just compiled and run your own Hello world application with Apple's toolchain.

Working with XIP archives

Xcode is now distributed in .xip files. These can be installed using unxip:

cd /Applications
unxip Xcode_11.3.xip