Find a file
Stuart Cook 586f7aa02b
Rollup merge of #147996 - pmur:murp/stabilize-ppc-inlineasm, r=Amanieu
Stabilize ppc inline assembly

This stabilizes inline assembly for PowerPC and PowerPC64.

Corresponding reference PR: rust-lang/reference#2056

---

From the requirements of stabilization mentioned in https://github.com/rust-lang/rust/issues/93335

> Each architecture needs to be reviewed before stabilization:

> * It must have clobber_abi.

Done in https://github.com/rust-lang/rust/pull/146949.

> * It must be possible to clobber every register that is normally clobbered by a function call.

Done in https://github.com/rust-lang/rust/pull/131341

Similarly, `preserves_flags` is also implemented by this PR. Likewise, there is a non-code change to `preserve_flags` expectations that floating point and vector status and sticky bits are preserved. The reference manual update has more details.

 > * Generally review that the exposed register classes make sense.

The followings can be used as input/output:
* reg (`r0`, `r[3-12]`, `r[14-r28]`): Any usable general-purpose register
* reg_nonzero (`r[3-12]`, `r[14-r28]`): General-purpose registers, but excludes `r0`. This is needed for instructions which define `r0` to be the value 0, such as register + immediate memory operations.
* reg/reg_nonzero `r29` on PowerPC64 targets.
* freg (`f[0-31]`): 64 bit floating pointer registers

The following are clobber-only:

* `ctr`, `lr`, `xer`: commonly clobbered special-purpose registers used in inline asm
* `cr` (`cr[0-7]`, `cr`): the condition register fields, or the entire condition register.
* `vreg` (`v[0-31]`): altivec/vmx register
* `vsreg` (`vs[0-63]`): vector-scalar register
* `spe_acc`: SPE accumulator, only available for PowerPC SPE targets.

The vreg and vsreg registers technically accept `#[repr(simd)]` types, but require the experimental `altivec` or `vsx` target features to be enabled. That work seems to be tracked here, rust-lang/rust#42743.

The following cannot be used as operands for inline asm:

* `r2`: the TOC pointer, required for most PIC code.
* `r13`: the TLS pointer
* `r[29]`: Reserved for internal usage by LLVM on PowerPC
* `r[30]`: Reserved for internal usage by LLVM on PowerPC and PowerPC64
* `r31`: the frame pointer
* `vrsave`: this is effectively an unused special-purpose register.

The `preserves_flags` behavior is updated with the following behavior (Note, this is not enforceable today due to LLVM restrictions):
* All status and sticky bits of `fpscr`, `spefscr`, and `vscr` are preserved.

The following registers are unavailable:
* `mma[0-7]`: These are new "registers" available on Power10, they are 512b registers which overlay 4x vsx registers. If needed, users can mark such clobbers as vsN*4, vsN*4+1,...,vsN*4+3.
* `ap`: This is actually a pseudo-register in gcc/llvm.
* `mq`: This register is only available on Power1 and Power2, and is not supported by llvm.

---
cc @taiki-e
r? @Amanieu
@rustbot label +A-inline-assembly
2026-01-27 12:50:49 +11:00
.github ci: Move lockfile updates to a script 2026-01-19 05:23:45 +00:00
compiler Rollup merge of #147996 - pmur:murp/stabilize-ppc-inlineasm, r=Amanieu 2026-01-27 12:50:49 +11:00
library Rollup merge of #151661 - estebank:issue-68095, r=mati865 2026-01-26 18:19:17 +01:00
LICENSES Synchronize Unicode license text from unicode.org 2024-11-20 00:54:12 -08:00
src Rollup merge of #147996 - pmur:murp/stabilize-ppc-inlineasm, r=Amanieu 2026-01-27 12:50:49 +11:00
tests Rollup merge of #151661 - estebank:issue-68095, r=mati865 2026-01-26 18:19:17 +01:00
.clang-format Add .clang-format 2024-06-26 05:56:00 +08:00
.editorconfig editorconfig: don't use nonexistant syntax 2025-08-24 10:37:19 -05:00
.git-blame-ignore-revs git: ignore 60600a6fa4 for blame purposes 2025-04-17 11:50:24 +08:00
.gitattributes Mark .pp files as Rust 2025-03-29 12:39:06 +01:00
.gitignore ignore build-rust-analyzer even if it's a symlink 2025-11-12 16:41:41 +01:00
.gitmodules Update to LLVM 21 2025-08-01 10:17:04 +02:00
.ignore change config.toml to bootstrap.toml for bootstrap module 2025-03-17 12:56:41 +05:30
.mailmap Add temporary new bors e-mail address to the mailmap 2026-01-14 18:01:50 +01:00
bootstrap.example.toml Change how we build offload as a single Step 2025-12-22 23:50:11 +01:00
Cargo.lock Update sysinfo version to 0.38.0 2026-01-25 16:12:13 +01:00
Cargo.toml Bump Clippy version -> 0.1.95 2026-01-22 16:55:20 +01:00
CODE_OF_CONDUCT.md Remove the code of conduct; instead link https://www.rust-lang.org/conduct.html 2019-10-05 22:55:19 +02:00
configure Ensure ./configure works when configure.py path contains spaces 2024-02-16 18:57:22 +00:00
CONTRIBUTING.md chore: remove dead links 2025-09-22 10:15:50 +01:00
COPYRIGHT Merge commit '500e0ff187' into clippy-subtree-update 2026-01-09 10:37:00 +01:00
INSTALL.md Rename rust.use-lld to rust.bootstrap-override-lld in INSTALL.md 2026-01-14 14:20:45 -06:00
LICENSE-APACHE Merge commit '500e0ff187' into clippy-subtree-update 2026-01-09 10:37:00 +01:00
license-metadata.json Update license metadata 2025-02-15 16:48:37 +01:00
LICENSE-MIT Merge commit '500e0ff187' into clippy-subtree-update 2026-01-09 10:37:00 +01:00
package.json Update browser-ui-test version to 0.23.1 2026-01-07 13:55:53 +01:00
README.md Merge commit '500e0ff187' into clippy-subtree-update 2026-01-09 10:37:00 +01:00
RELEASES.md relnotes: fix 1.93's as_mut_array methods 2026-01-23 15:54:13 -08:00
REUSE.toml Use yarn instead of npm in tidy 2025-11-17 10:58:13 +02:00
rust-bors.toml Add S-blocked to labels_blocking_approval 2026-01-19 16:01:16 +01:00
rustfmt.toml Rename tests/rustdoc into tests/rustdoc-html 2026-01-07 14:23:30 +01:00
triagebot.toml misc: roll bootstrap reviewers for src/tools/build-manifest 2026-01-21 09:59:34 +08:00
typos.toml spellcheck: "numer" as in "numerator" 2026-01-19 15:31:25 +01:00
x fix ./x readdir logic when CDPATH is set 2025-09-19 16:48:05 +02:00
x.ps1 use & instead of start-process in x.ps1 2023-12-09 09:46:16 -05:00
x.py Reformat Python code with ruff 2024-12-04 23:03:44 +01:00
yarn.lock Update npm package, remove another unused one, and fix some typing errors that started popping when we moved to yarn 2025-11-17 10:58:18 +02:00

This is the main source code repository for Rust. It contains the compiler, standard library, and documentation.

Why Rust?

  • Performance: Fast and memory-efficient, suitable for critical services, embedded devices, and easily integrated with other languages.

  • Reliability: Our rich type system and ownership model ensure memory and thread safety, reducing bugs at compile-time.

  • Productivity: Comprehensive documentation, a compiler committed to providing great diagnostics, and advanced tooling including package manager and build tool (Cargo), auto-formatter (rustfmt), linter (Clippy) and editor support (rust-analyzer).

Quick Start

Read "Installation" from The Book.

Installing from Source

If you really want to install from source (though this is not recommended), see INSTALL.md.

Getting Help

See https://www.rust-lang.org/community for a list of chat platforms and forums.

Contributing

See CONTRIBUTING.md.

License

Rust is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.

See LICENSE-APACHE, LICENSE-MIT, and COPYRIGHT for details.

Trademark

The Rust Foundation owns and protects the Rust and Cargo trademarks and logos (the "Rust Trademarks").

If you want to use these names or brands, please read the Rust language trademark policy.

Third-party logos may be subject to third-party copyrights and trademarks. See Licenses for details.