Rust PCI drivers need to configure SR-IOV and let VF drivers borrow
selected PF-owned data. This series provides those operations and a
registration that keeps the shared data available until VF removal
completes.

This builds on Peter Colberg's Rust PCI SR-IOV series [1] and Danilo
Krummrich's typed PF registration design [2]. The PF/VF sample demonstrates
the interface using QEMU's 82576 emulation.

Drivers implement separate sriov_enable() and sriov_disable() callbacks,
each receiving pinned driver data and a token for the requested operation.
Enabling VFs returns a guard that disables them if later setup fails.
Returning the guard successfully leaves the VFs enabled, with
VfRegistration owning their final teardown. Drivers that do not share
data with VFs can register ().

Changes since v5 [3]:
- Stub the SR-IOV API when CONFIG_PCI_IOV is disabled instead of
  cfg-gating it, so drivers need no configuration guards, following
  Danilo's suggested diff [4].
- Add SriovEnable::enable_all() (patch 9), following Danilo's
  suggestion [4].
- Split the drvdata_borrow() safety documentation fix into its own
  patch (patch 5), and explain why driver data is dropped before
  remove() returns, following Danilo's and Alexandre's review.
- Use NonZero<u16> for the requested VF count, const_assert!() and
  #[optional] for the paired SR-IOV callbacks, and document the errors
  returned by SriovEnable::enable(), following Alexandre's review.
- Build the sample as a single module with the PF and VF drivers in
  separate files, and simplify it, following Danilo's and Alexandre's
  review.
- Collect Alexandre's Reviewed-by (patches 1-4, 8 and 10) and Bjorn's
  Acked-by for include/linux/pci.h (patch 7).
- Dropped Alexandre's Reviewed-by from patch 7 after adding
  CONFIG_PCI_IOV=n support; the revised patch needs renewed review.

[1]
https://lore.kernel.org/rust-for-linux/[email protected]/
[2]
https://lore.kernel.org/nova-gpu/[email protected]/
[3]
https://lore.kernel.org/all/[email protected]/T/
[4]
https://lore.kernel.org/nova-gpu/[email protected]/

John Hubbard (1):
  rust: pci: add is_virtfn(), to check for VFs

Peter Colberg (5):
  rust: pci: add internal SR-IOV enable and disable helpers
  rust: pci: add vtable attribute to pci::Driver trait
  rust: pci: add num_vf(), to return number of VFs
  rust: pci: add SR-IOV enable and disable callbacks
  samples: rust: add a Rust SR-IOV PF and VF driver sample

Simon Song (1):
  rust: pci: add SriovEnable::enable_all(), to enable all requested VFs

Zhi Wang (4):
  rust: device: clarify the drvdata_borrow() safety requirement
  rust: pci: drop driver data before remove returns
  rust: pci: add typed SR-IOV PF registration data
  rust: pci: add SR-IOV enable and disable tokens

 MAINTAINERS                           |   1 +
 drivers/gpu/nova-core/driver.rs       |   1 +
 include/linux/pci.h                   |   7 +
 rust/helpers/pci.c                    |  16 +
 rust/kernel/device.rs                 |   4 +-
 rust/kernel/pci.rs                    | 116 +++++++
 rust/kernel/pci/iov.rs                | 468 ++++++++++++++++++++++++++
 samples/rust/Kconfig                  |  11 +
 samples/rust/Makefile                 |   1 +
 samples/rust/rust_dma.rs              |   1 +
 samples/rust/rust_driver_auxiliary.rs |   1 +
 samples/rust/rust_driver_pci.rs       |   1 +
 samples/rust/rust_driver_sriov.rs     | 178 ++++++++++
 samples/rust/rust_driver_sriov_vf.rs  |  49 +++
 14 files changed, 853 insertions(+), 2 deletions(-)
 create mode 100644 rust/kernel/pci/iov.rs
 create mode 100644 samples/rust/rust_driver_sriov.rs
 create mode 100644 samples/rust/rust_driver_sriov_vf.rs


base-commit: 6e557330b874b0e1fdd03e8fe4c438f36c93eefa
-- 
2.43.7

Reply via email to