rustc_target/spec/targets/
x86_64_unknown_uefi.rs

1// This defines the amd64 target for UEFI systems as described in the UEFI specification. See the
2// uefi-base module for generic UEFI options. On x86_64 systems (mostly called "x64" in the spec)
3// UEFI systems always run in long-mode, have the interrupt-controller pre-configured and force a
4// single-CPU execution.
5// The win64 ABI is used. It differs from the sysv64 ABI, so we must use a windows target with
6// LLVM. "x86_64-unknown-windows" is used to get the minimal subset of windows-specific features.
7
8use rustc_abi::{CanonAbi, X86Call};
9
10use crate::spec::{RustcAbi, Target, TargetMetadata, base};
11
12pub(crate) fn target() -> Target {
13    let mut base = base::uefi_msvc::opts();
14    base.cpu = "x86-64".into();
15    base.plt_by_default = false;
16    base.max_atomic_width = Some(64);
17    base.entry_abi = CanonAbi::X86(X86Call::Win64);
18
19    // We disable MMX and SSE for now, even though UEFI allows using them. Problem is, you have to
20    // enable these CPU features explicitly before their first use, otherwise their instructions
21    // will trigger an exception. Rust does not inject any code that enables AVX/MMX/SSE
22    // instruction sets, so this must be done by the firmware. However, existing firmware is known
23    // to leave these uninitialized, thus triggering exceptions if we make use of them. Which is
24    // why we avoid them and instead use soft-floats. This is also what GRUB and friends did so
25    // far.
26    //
27    // If you initialize FP units yourself, you can override these flags with custom linker
28    // arguments, thus giving you access to full MMX/SSE acceleration.
29    base.features = "-mmx,-sse,+soft-float".into();
30    base.rustc_abi = Some(RustcAbi::X86Softfloat);
31
32    Target {
33        llvm_target: "x86_64-unknown-windows".into(),
34        metadata: TargetMetadata {
35            description: Some("64-bit UEFI".into()),
36            tier: Some(2),
37            host_tools: Some(false),
38            std: None, // ?
39        },
40        pointer_width: 64,
41        data_layout:
42            "e-m:w-p270:32:32-p271:32:32-p272:64:64-i64:64-i128:128-f80:128-n8:16:32:64-S128".into(),
43        arch: "x86_64".into(),
44
45        options: base,
46    }
47}