|
| 1 | +# `x86_64h-apple-darwin` |
| 2 | + |
| 3 | +**Tier: 3** |
| 4 | + |
| 5 | +Target for macOS on late-generation `x86_64` Apple chips, usable as the |
| 6 | +`x86_64h` entry in universal binaries, and equivalent to LLVM's |
| 7 | +`x86_64h-apple-macosx*` targets. |
| 8 | + |
| 9 | +## Target maintainers |
| 10 | + |
| 11 | +- Thom Chiovoloni `[email protected]` <https://github.com/thomcc> |
| 12 | + |
| 13 | +## Requirements |
| 14 | + |
| 15 | +This target is an `x86_64` target that only supports Apple's late-gen |
| 16 | +(Haswell-compatible) Intel chips. It enables a set of target features available |
| 17 | +on these chips (AVX2 and similar), and MachO binaries built with this target may |
| 18 | +be used as the `x86_64h` entry in universal binaries ("fat" MachO binaries), and |
| 19 | +will fail to load on machines that do not support this. |
| 20 | + |
| 21 | +It should support the full standard library (`std` and `alloc` either with |
| 22 | +default or user-defined allocators). This target is probably most useful when |
| 23 | +targetted via cross-compilation (including from `x86_64-apple-darwin`), but if |
| 24 | +built manually, the host tools work. |
| 25 | + |
| 26 | +It is similar to `x86_64-apple-darwin` in nearly all respects, although the |
| 27 | +minimum supported OS version is slightly higher (it requires 10.8 rather than |
| 28 | +`x86_64-apple-darwin`'s 10.7). |
| 29 | + |
| 30 | +## Building the target |
| 31 | + |
| 32 | +Users on Apple targets can build this by adding it to the `target` list in |
| 33 | +`config.toml`, or with `-Zbuild-std`. |
| 34 | + |
| 35 | +## Building Rust programs |
| 36 | + |
| 37 | +Rust does not yet ship pre-compiled artifacts for this target. To compile for |
| 38 | +this target, you will either need to build Rust with the target enabled (see |
| 39 | +"Building the target" above), or build your own copy of `core` by using |
| 40 | +`build-std` or similar. |
| 41 | + |
| 42 | +## Testing |
| 43 | + |
| 44 | +Code built with this target can be run on the set of Intel macOS machines that |
| 45 | +support running `x86_64h` binaries (relatively recent Intel macs). The Rust test |
| 46 | +suite seems to work. |
| 47 | + |
| 48 | +## Cross-compilation toolchains and C code |
| 49 | + |
| 50 | +Cross-compilation to this target from Apple hosts should generally work without |
| 51 | +much configuration, so long as XCode and the CommandLineTools are installed. |
| 52 | +Targetting it from non-Apple hosts is difficult, but no moreso than targetting |
| 53 | +`x86_64-apple-darwin`. |
| 54 | + |
| 55 | +When compiling C code for this target, either the "`x86_64h-apple-macosx*`" LLVM |
| 56 | +targets should be used, or an argument like `-arch x86_64h` should be passed to |
| 57 | +the C compiler. |
0 commit comments