Message-ID: <20240725013244.69532-1-ojeda@kernel.org>
Date: Thu, 25 Jul 2024 03:32:44 +0200
From: Miguel Ojeda <ojeda@...nel.org>
To: Linus Torvalds <torvalds@...ux-foundation.org>
Cc: Miguel Ojeda <ojeda@...nel.org>,
	Wedson Almeida Filho <wedsonaf@...il.com>,
	Alex Gaynor <alex.gaynor@...il.com>,
	Boqun Feng <boqun.feng@...il.com>,
	Gary Guo <gary@...yguo.net>,
	Björn Roy Baron <bjorn3_gh@...tonmail.com>,
	Benno Lossin <benno.lossin@...ton.me>,
	Andreas Hindborg <a.hindborg@...sung.com>,
	Alice Ryhl <aliceryhl@...gle.com>,
	rust-for-linux@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	Niko Matsakis <niko@...m.mit.edu>,
	Sid Askary <saskary@...urewei.com>,
	Emilio Cobos Álvarez <emilio@...sal.io>
Subject: [GIT PULL] Rust for 6.11

Hi Linus,

This is the next round of the Rust support.

Later than usual, but all the commits have been in linux-next for about
2 weeks.

A trivial conflict with the block pull you already merged expected
(resolved in linux -next). In addition, there is a small change to the
C side from Arnd that akpm ack'ed.

Please pull for v6.11 -- thanks!

Cheers,
Miguel

The following changes since commit 256abd8e550ce977b728be79a74e1729438b4948:

  Linux 6.10-rc7 (2024-07-07 14:23:46 -0700)

are available in the Git repository at:

  https://github.com/Rust-for-Linux/linux.git tags/rust-6.11

for you to fetch changes up to b1263411112305acf2af728728591465becb45b0:

  docs: rust: quick-start: add section on Linux distributions (2024-07-10 10:29:55 +0200)

----------------------------------------------------------------
Rust changes for v6.11

The highlight is the establishment of a minimum version for the Rust
toolchain, including 'rustc' (and bundled tools) and 'bindgen'.

The initial minimum will be the pinned version we currently have, i.e.
we are just widening the allowed versions. That covers 3 stable Rust
releases: 1.78.0, 1.79.0, 1.80.0 (getting released tomorrow), plus beta,
plus nightly.

This should already be enough for kernel developers in distributions
that provide recent Rust compiler versions routinely, such as Arch
Linux, Debian Unstable (outside the freeze period), Fedora Linux,
Gentoo Linux (especially the testing channel), Nix (unstable) and
openSUSE Slowroll and Tumbleweed.

In addition, the kernel is now being built-tested by Rust's pre-merge
CI. That is, every change that is attempting to land into the Rust
compiler is tested against the kernel, and it is merged only if it
passes. Similarly, the bindgen tool has agreed to build the kernel in
their CI too.

Thus, with the pre-merge CI in place, both projects hope to avoid
unintentional changes to Rust that break the kernel. This means that,
in general, apart from intentional changes on their side (that we
will need to workaround conditionally on our side), the upcoming Rust
compiler versions should generally work.

In addition, the Rust project has proposed getting the kernel into
stable Rust (at least solving the main blockers) as one of its three
flagship goals for 2024H2 [1].

I would like to thank Niko, Sid, Emilio et al. for their help promoting
the collaboration between Rust and the kernel.

[1] https://rust-lang.github.io/rust-project-goals/2024h2/index.html#flagship-goals

Toolchain and infrastructure:

 - Support several Rust toolchain versions.

 - Support several bindgen versions.

 - Remove 'cargo' requirement and simplify 'rusttest', thanks to 'alloc'
   having been dropped last cycle.

 - Provide proper error reporting for the 'rust-analyzer' target.

'kernel' crate:

 - Add 'uaccess' module with a safe userspace pointers abstraction.

 - Add 'page' module with a 'struct page' abstraction.

 - Support more complex generics in workqueue's 'impl_has_work!' macro.

'macros' crate:

 - Add 'firmware' field support to the 'module!' macro.

 - Improve 'module!' macro documentation.

Documentation:

 - Provide instructions on what packages should be installed to build
   the kernel in some popular Linux distributions.

 - Introduce the new kernel.org LLVM+Rust toolchains.

 - Explain '#[no_std]'.

And a few other small bits.

----------------------------------------------------------------
Alice Ryhl (4):
      rust: alloc: fix typo in docs for GFP_NOWAIT
      rust: alloc: add __GFP_HIGHMEM flag
      rust: uaccess: add typed accessors for userspace pointers
      rust: add abstraction for `struct page`

Arnd Bergmann (1):
      uaccess: always export _copy_[from|to]_user with CONFIG_RUST

Aswin Unnikrishnan (2):
      rust: add example for `alias` argument in `module` macro documentation
      rust: fix datatype in docs for `module` macro arguments

Dirk Behme (1):
      docs: rust: no_std is used

FUJITA Tomonori (1):
      rust: add 'firmware' field support to module! macro

John Hubbard (2):
      kbuild: rust-analyzer: better error handling
      kbuild: rust-analyzer: improve comment documentation

Miguel Ojeda (12):
      kbuild: rust: remove now-unneeded `rusttest` custom sysroot handling
      rust: macros: indent list item in `paste!`'s docs
      rust: init: simplify from `map_err` to `inspect_err`
      rust: allow `dead_code` for never constructed bindings
      rust: relax most deny-level lints to warnings
      rust: simplify Clippy warning flags set
      rust: start supporting several compiler versions
      rust: avoid assuming a particular `bindgen` build
      rust: work around `bindgen` 0.69.0 issue
      rust: start supporting several `bindgen` versions
      rust: warn about `bindgen` versions 0.66.0 and 0.66.1
      docs: rust: quick-start: add section on Linux distributions

Nathan Chancellor (1):
      docs: rust: introduce the new kernel.org LLVM+Rust toolchains

Roland Xu (1):
      rust: kernel: make impl_has_work compatible with more generics

Wedson Almeida Filho (1):
      rust: uaccess: add userspace pointers

 Documentation/process/changes.rst          |   9 +-
 Documentation/rust/general-information.rst |   8 +
 Documentation/rust/quick-start.rst         | 143 +++++++----
 Documentation/rust/testing.rst             |   5 +-
 Makefile                                   |  30 +--
 include/linux/uaccess.h                    |  46 ++--
 init/Kconfig                               |   5 +-
 lib/usercopy.c                             |  30 +--
 rust/Makefile                              |  74 +-----
 rust/bindings/bindings_helper.h            |   2 +
 rust/bindings/lib.rs                       |   1 +
 rust/helpers.c                             |  34 +++
 rust/kernel/alloc.rs                       |  17 +-
 rust/kernel/init.rs                        |  13 +-
 rust/kernel/lib.rs                         |   2 +
 rust/kernel/page.rs                        | 250 +++++++++++++++++++
 rust/kernel/types.rs                       |  64 +++++
 rust/kernel/uaccess.rs                     | 388 +++++++++++++++++++++++++++++
 rust/kernel/workqueue.rs                   |  16 +-
 rust/macros/lib.rs                         |  45 +++-
 rust/macros/module.rs                      |  18 +-
 rust/uapi/lib.rs                           |   1 +
 scripts/rust_is_available.sh               |  33 +--
 scripts/rust_is_available_bindgen_0_66.h   |   2 +
 scripts/rust_is_available_test.py          |  59 +++--
 25 files changed, 1059 insertions(+), 236 deletions(-)
 create mode 100644 rust/kernel/page.rs
 create mode 100644 rust/kernel/uaccess.rs
 create mode 100644 scripts/rust_is_available_bindgen_0_66.h

Powered by blists - more mailing lists