linux.git/rust/kernel/pci.rs, branch v6.18.21

rust: pci: fix incorrect platform reference in PCI driver probe doc comment

2025-09-17T10:51:13+00:00

Substitute 'platform' with 'pci'.

Fixes: 1bd8b6b2c5d3 ("rust: pci: add basic PCI device / driver abstractions")
Cc: stable@kernel.org
Signed-off-by: Rahul Rameshbabu 
Signed-off-by: Danilo Krummrich

rust: pci: fix incorrect platform reference in PCI driver unbind doc comment

2025-09-17T10:51:07+00:00

Substitute 'platform' with 'pci'.

Fixes: 18ebb25dfa18 ("rust: pci: implement Driver::unbind()")
Cc: stable@kernel.org
Signed-off-by: Rahul Rameshbabu 
Signed-off-by: Danilo Krummrich

rust: pci: inline several tiny functions

2025-09-01T18:29:08+00:00

Several previous commits added Vendor and Class functionality. As part
of that, the new functions were inlined where appropriate. But that left
this file with inconsistent use of inlining. Fix that by inlining the
remaining items that should be.

Cc: Danilo Krummrich 
Cc: Elle Rhumsaa 
Reviewed-by: Alexandre Courbot 
Signed-off-by: John Hubbard 
Link: https://lore.kernel.org/r/20250829223632.144030-7-jhubbard@nvidia.com
Signed-off-by: Danilo Krummrich

rust: pci: use pci::Vendor instead of bindings::PCI_VENDOR_ID_*

2025-09-01T18:16:36+00:00

Change Device::vendor_id() to return a Vendor type, and change
DeviceId::from_id() to accept a Vendor type.

Use the new pci::Vendor in the various Rust for Linux callers who were
previously using bindings::PCI_VENDOR_ID_*.

Doing so also allows removing "use kernel::bindings" entirely from most
of the affected files here.

Also, mark vendor_id() as inline.

Cc: Danilo Krummrich 
Cc: Elle Rhumsaa 
Reviewed-by: Alexandre Courbot 
Signed-off-by: John Hubbard 
Link: https://lore.kernel.org/r/20250829223632.144030-6-jhubbard@nvidia.com
[ Replace "as a validated vendor" with "as [`Vendor`]". - Danilo ]
Signed-off-by: Danilo Krummrich

rust: pci: add DeviceId::from_class_and_vendor() method

2025-09-01T18:09:55+00:00

Add a new method to create PCI DeviceIds that match both a specific
vendor and PCI class. This is more targeted than the existing
from_class() method as it filters on both vendor and class criteria.

Cc: Danilo Krummrich 
Cc: Elle Rhumsaa 
Reviewed-by: Alexandre Courbot 
Signed-off-by: John Hubbard 
Link: https://lore.kernel.org/r/20250829223632.144030-4-jhubbard@nvidia.com
[ Minor doc-comment improvements. - Danilo ]
Signed-off-by: Danilo Krummrich

rust: pci: provide access to PCI Vendor values

2025-09-01T18:05:22+00:00

This allows callers to write Vendor::SOME_COMPANY instead of
bindings::PCI_VENDOR_ID_SOME_COMPANY.

New APIs:
    Vendor::SOME_COMPANY
    Vendor::from_raw() -- Only accessible from the pci (parent) module.
    Vendor::as_raw()
    Vendor: fmt::Display for Vendor

Cc: Danilo Krummrich 
Cc: Elle Rhumsaa 
Reviewed-by: Alexandre Courbot 
Signed-off-by: John Hubbard 
Link: https://lore.kernel.org/r/20250829223632.144030-3-jhubbard@nvidia.com
[ Minor doc-comment improvements, align Debug and Display. - Danilo ]
Signed-off-by: Danilo Krummrich

rust: pci: provide access to PCI Class and Class-related items

2025-09-01T17:58:44+00:00

Allow callers to write Class::STORAGE_SCSI instead of
bindings::PCI_CLASS_STORAGE_SCSI, for example.

New APIs:
    Class::STORAGE_SCSI, Class::NETWORK_ETHERNET, etc.
    Class::from_raw() -- Only callable from pci module.
    Class::as_raw()
    ClassMask: Full, ClassSubclass
    Device::pci_class()

Cc: Danilo Krummrich 
Cc: Elle Rhumsaa 
Reviewed-by: Alexandre Courbot 
Signed-off-by: John Hubbard 
Link: https://lore.kernel.org/r/20250829223632.144030-2-jhubbard@nvidia.com
[ Minor doc-comment improvements, align Debug and Display. - Danilo ]
Signed-off-by: Danilo Krummrich

rust: driver-core: Update ARef and AlwaysRefCounted imports from sync::aref

2025-08-15T20:34:41+00:00

Update call sites in the driver-core files and its related samples
to import `ARef` and `AlwaysRefCounted` from `sync::aref`
instead of `types`.

This aligns with the ongoing effort to move `ARef` and
`AlwaysRefCounted` to sync.

Suggested-by: Benno Lossin 
Link: https://github.com/Rust-for-Linux/linux/issues/1173
Signed-off-by: Shankari Anand 
Link: https://lore.kernel.org/r/20250814104615.355106-1-shankari.ak0208@gmail.com
Signed-off-by: Danilo Krummrich

rust: Add several miscellaneous PCI helpers

2025-08-15T18:25:42+00:00

Add bindings to obtain a PCI device's resource start address, bus/
device function, revision ID and subsystem device and vendor IDs.

These will be used by the nova-core GPU driver which is currently in
development.

Reviewed-by: Alexandre Courbot 
Cc: Danilo Krummrich 
Cc: Bjorn Helgaas 
Cc: Krzysztof Wilczyński 
Cc: Miguel Ojeda 
Cc: Alex Gaynor 
Cc: Boqun Feng 
Cc: Gary Guo 
Cc: Björn Roy Baron 
Cc: Benno Lossin 
Cc: Andreas Hindborg 
Cc: Alice Ryhl 
Cc: Trevor Gross 
Cc: Greg Kroah-Hartman 
Cc: Rafael J. Wysocki 
Cc: John Hubbard 
Cc: Alexandre Courbot 
Cc: linux-pci@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Signed-off-by: Alistair Popple 
Link: https://lore.kernel.org/r/20250730013417.640593-2-apopple@nvidia.com
Signed-off-by: Danilo Krummrich

rust: Update PCI binding safety comments and add inline compiler hint

2025-08-15T18:24:10+00:00

Update the safety comments to be consistent with other safety comments
in the PCI bindings. Also add an inline compiler hint.

Suggested-by: Danilo Krummrich 
Cc: Danilo Krummrich 
Cc: Bjorn Helgaas 
Cc: Krzysztof Wilczyński 
Cc: Miguel Ojeda 
Cc: Alex Gaynor 
Cc: Boqun Feng 
Cc: Gary Guo 
Cc: Björn Roy Baron 
Cc: Benno Lossin 
Cc: Andreas Hindborg 
Cc: Alice Ryhl 
Cc: Trevor Gross 
Cc: Greg Kroah-Hartman 
Cc: Rafael J. Wysocki 
Cc: John Hubbard 
Cc: Alexandre Courbot 
Cc: linux-pci@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Signed-off-by: Alistair Popple 
Link: https://lore.kernel.org/r/20250730013417.640593-1-apopple@nvidia.com
Signed-off-by: Danilo Krummrich