forked from rust-lang/rust
-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Auto merge of rust-lang#93854 - matthiaskrgr:rollup-bh2a85j, r=matthi…
…askrgr Rollup of 7 pull requests Successful merges: - rust-lang#92670 (add kernel target for RustyHermit) - rust-lang#93756 (Support custom options for LLVM build) - rust-lang#93802 (fix oversight in the `min_const_generics` checks) - rust-lang#93808 (Remove first headings indent) - rust-lang#93824 (Stabilize cfg_target_has_atomic) - rust-lang#93830 (Refactor sidebar printing code) - rust-lang#93843 (kmc-solid: Fix wait queue manipulation errors in the `Condvar` implementation) Failed merges: r? `@ghost` `@rustbot` modify labels: rollup
- Loading branch information
Showing
34 changed files
with
445 additions
and
599 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
16 changes: 16 additions & 0 deletions
16
compiler/rustc_target/src/spec/aarch64_unknown_none_hermitkernel.rs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
use crate::spec::Target; | ||
|
||
pub fn target() -> Target { | ||
let mut base = super::hermit_kernel_base::opts(); | ||
base.max_atomic_width = Some(128); | ||
base.abi = "softfloat".to_string(); | ||
base.features = "+strict-align,-neon,-fp-armv8".to_string(); | ||
|
||
Target { | ||
llvm_target: "aarch64-unknown-hermit".to_string(), | ||
pointer_width: 64, | ||
data_layout: "e-m:e-i8:8:32-i16:16:32-i64:64-i128:128-n32:64-S128".to_string(), | ||
arch: "aarch64".to_string(), | ||
options: base, | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
77 changes: 77 additions & 0 deletions
77
src/doc/rustc/src/platform-support/aarch64-unknown-none-hermitkernel.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
# `aarch64-unknown-none-hermitkernel` | ||
|
||
**Tier: 3** | ||
|
||
Required to build the kernel for [HermitCore](https://github.com/hermitcore/hermit-playground) | ||
or [RustyHermit](https://github.com/hermitcore/rusty-hermit). | ||
The result is a bare-metal aarch64 binary in ELF format. | ||
|
||
## Target maintainers | ||
|
||
- Stefan Lankes, https://github.com/stlankes | ||
|
||
## Requirements | ||
|
||
This target is cross-compiled. There is no support for `std`, but the | ||
library operating system provides a simple allocator to use `alloc`. | ||
|
||
By default, Rust code generated for this target does not use any vector or | ||
floating-point registers. This allows the generated code to build the library | ||
operaring system, which may need to avoid the use of such | ||
registers or which may have special considerations about the use of such | ||
registers (e.g. saving and restoring them to avoid breaking userspace code | ||
using the same registers). In contrast to `aarch64-unknown-none-softfloat`, | ||
the target is completly relocatable, which is a required feature of RustyHermit. | ||
|
||
By default, code generated with this target should run on any `aarch64` | ||
hardware; enabling additional target features may raise this baseline. | ||
On `aarch64-unknown-none-hermitkernel`, `extern "C"` uses the [standard System V calling | ||
convention](https://github.com/ARM-software/abi-aa/releases/download/2021Q3/sysvabi64.pdf), | ||
without red zones. | ||
|
||
This target generated binaries in the ELF format. | ||
|
||
## Building the target | ||
|
||
Typical you should not use the target directly. The target `aarch64-unknown-hermit` | ||
builds the _user space_ of RustyHermit and supports red zones and floating-point | ||
operations. | ||
To build and link the kernel to the application, the crate | ||
[hermit-sys](https://github.com/hermitcore/rusty-hermit/tree/master/hermit-sys) | ||
should be used by adding the following lines to the `Cargo.toml` file of | ||
your application. | ||
|
||
```toml | ||
[target.'cfg(target_os = "hermit")'.dependencies] | ||
hermit-sys = "0.1.*" | ||
``` | ||
|
||
The crate `hermit-sys` uses the target `aarch64-unknown-none-hermitkernel` | ||
to build the kernel. | ||
|
||
## Building Rust programs | ||
|
||
Rust does not yet ship pre-compiled artifacts for this target. To compile for | ||
this target, you need to build the crate `hermit-sys` (see | ||
"Building the target" above). | ||
|
||
## Testing | ||
|
||
As `aarch64-unknown-none-hermitkernel` does not support `std` | ||
and does not support running any Rust testsuite. | ||
|
||
## Cross-compilation toolchains and C code | ||
|
||
If you want to compile C code along with Rust you will need an | ||
appropriate `aarch64` toolchain. | ||
|
||
Rust *may* be able to use an `aarch64-linux-gnu-` toolchain with appropriate | ||
standalone flags to build for this toolchain (depending on the assumptions of | ||
that toolchain, see below), or you may wish to use a separate | ||
`aarch64-unknown-none` (or `aarch64-elf-`) toolchain. | ||
|
||
On some `aarch64` hosts that use ELF binaries, you *may* be able to use the host | ||
C toolchain, if it does not introduce assumptions about the host environment | ||
that don't match the expectations of a standalone environment. Otherwise, you | ||
may need a separate toolchain for standalone/freestanding development, just as | ||
when cross-compiling from a non-`aarch64` platform. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.