Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ziglang/fetch-them-macos-headers
A utility for fetching minimal macOS libc headers
https://github.com/ziglang/fetch-them-macos-headers
macos zig
Last synced: about 2 hours ago
JSON representation
A utility for fetching minimal macOS libc headers
- Host: GitHub
- URL: https://github.com/ziglang/fetch-them-macos-headers
- Owner: ziglang
- License: mit
- Created: 2020-10-20T16:33:48.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-18T00:02:41.000Z (about 1 month ago)
- Last Synced: 2024-09-21T03:31:01.472Z (4 days ago)
- Topics: macos, zig
- Language: C
- Homepage:
- Size: 2.97 MB
- Stars: 50
- Watchers: 8
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: COPYING.unpack_sdks
Awesome Lists containing this project
README
# 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).
[Zig]: https://ziglang.org
[this article]: https://andrewkelley.me/post/zig-cc-powerful-drop-in-replacement-gcc-clang.html
## 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
```
See [Getting older SDKs](#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.-none/. headers/any-macos-any/.
rsync -vaHP headers/x86_64-macos.-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 `` path
```
./zig-out/bin/fetch_them_macos_headers generate
```
5. (Optional) Copy the contents of `` 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`](https://github.com/rsms/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](https://developer.apple.com/download/all/?q=command%20line) 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`.