fetch-them-macos-headers

This is a small utility repo that can be used to fetch and generate deduplicated macOS libc headers. The intention for this utility is to use it to update the libc headers shipped with Zig, and used when cross-compiling to macOS (see this article for an amazing description of the zig cc C compiler frontend).

Howto

1. Build

$ zig build

2. (Optional) Add additional libc headers to src/headers.c.

3. Fetch headers into libc/include/. The fetch command will automatically fetch for both x86_64 and aarch64 architectures by default.

   3.1. Fetch from the system-wide, latest SDK.

   $ ./zig-out/bin/fetch_them_macos_headers fetch
   

   3.2. (Optional) Fetch from a custom SDK by explicitly specifying sysroot path.

   $ ./zig-out/bin/fetch_them_macos_headers fetch --sysroot <path>
   

   See Getting older SDKs for a guide of how to install additional SDKs for older versions of macOS.

4. Merge x86_64 and aarch64 into destination path any-macos-any

mkdir headers/any-macos-any
rsync -vaHP headers/aarch64-macos.<VERSION>-none/. headers/any-macos-any/.
rsync -vaHP headers/x86_64-macos.<VERSION>-none/. headers/any-macos-any/.

5. (Optional) Replace the contents of Zig's lib/libc/include/any-macos-any with headers/any-macos-any, and analyze the changes with git status.

Deprecated Howto

For the deprecated method, replace steps 4,5 as follows:

4. Generate deduplicated headers dirs in <destination> path

./zig-out/bin/fetch_them_macos_headers generate <destination>

5. (Optional) Copy the contents of <destination> into Zig's lib/libc/include/, and analyze the changes with git status.

Getting older SDKs

Thanks to Rasmus Andersson's amazing work on llvmbox it is now possible to download additional, older SDKs on your main Mac, extract them without having to install them, and use the extracted SDKs with fetch_them_macos_headers.

How does it work?

1. Navigate to Apple's developer portal and pick Command Line Tools installers of interest.
2. Mount all of them.
3. Run unpack_sdks.sh script.

$ ./unpack_sdks.sh .

Note that you need pbzx in your PATH which you can get via brew install pbzx or build from source.

4. You can now pass use the extracted SDKs with fetch_them_macos_headers which you will find in ./apple-clts unless you used a different argument to unpack_sdks.sh.