[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <8e0209de-5be3-4d41-807f-1b7e73aa3d1d@nvidia.com>
Date: Thu, 30 Oct 2025 17:29:06 +0000
From: Zhi Wang <zhiw@...dia.com>
To: "rust-for-linux@...r.kernel.org" <rust-for-linux@...r.kernel.org>
CC: "dakr@...nel.org" <dakr@...nel.org>, "bhelgaas@...gle.com"
	<bhelgaas@...gle.com>, "kwilczynski@...nel.org" <kwilczynski@...nel.org>,
	"ojeda@...nel.org" <ojeda@...nel.org>, "alex.gaynor@...il.com"
	<alex.gaynor@...il.com>, "boqun.feng@...il.com" <boqun.feng@...il.com>,
	"gary@...yguo.net" <gary@...yguo.net>, "bjorn3_gh@...tonmail.com"
	<bjorn3_gh@...tonmail.com>, "lossin@...nel.org" <lossin@...nel.org>,
	"a.hindborg@...nel.org" <a.hindborg@...nel.org>, "aliceryhl@...gle.com"
	<aliceryhl@...gle.com>, "tmgross@...ch.edu" <tmgross@...ch.edu>,
	"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>, Neo Jia
	<cjia@...dia.com>, Surath Mitra <smitra@...dia.com>, Ankit Agrawal
	<ankita@...dia.com>, Aniket Agashe <aniketa@...dia.com>, Kirti Wankhede
	<kwankhede@...dia.com>, "Tarun Gupta (SW-GPU)" <targupta@...dia.com>,
	"zhiwang@...nel.org" <zhiwang@...nel.org>, Alex Williamson
	<alwilliamson@...dia.com>, Alexandre Courbot <acourbot@...dia.com>, Joel
 Fernandes <joelagnelf@...dia.com>, John Hubbard <jhubbard@...dia.com>, Jason
 Gunthorpe <jgg@...dia.com>
Subject: Re: [RFC 0/2] rust: introduce abstractions for fwctl
On 30.10.2025 18.03, Zhi Wang wrote:
> In the NVIDIA vGPU RFC [1], the vGPU type blobs must be provided to the GSP
> before userspace can enumerate available vGPU types and create vGPU
> instances. The original design relied on the firmware loading interface,
> but fwctl is a more natural fit for this use case, as it is designed for
> uploading configuration or firmware data required before the device becomes
> operational.
> 
Hi Jason and Danilo:
Thanks for the comments. I had one more open to discuss, handling the buffer
allocation/free between rust and C world.
Two fwctl ioctls:
FWCTL_CMD_INFO: The driver allocates the info memory (kmalloc) and the fwctl
subsystem frees it.
FWCTL_RPC:
Case 1: The driver can choose to re-use the input buffer and write the *out_len
for actual length of data.
Case 2: The driver can allocate a new buffer (kmalloc) and the fwctl subsystem
frees it.
----
Now with the Rust driver:
FWCTL_CMD_INFO: The rust side returns a new KVec, the rust fwctl abstraction
consumes it, get void *buf and pass it to fwctl subsystem (C). The memory
will be freed by C side.
FWCTL_RPC:
The input buffer will be wrapped in a mutable slice.
Case 1: Re-use the input buffer. The rust side writes the mut slice and the
* mut out_len.
Case 2: Allocate the new output buffer. The same approach as FWCTL_CMD_INFO.
----
We know KVec is backed by kmalloc. If C side changes the requirements of
the driver memory allocation someday, E.g. from kfree() to kvfree() or vfree().
Drivers in C will be updated surely at that time.
Is possible that we can have some approaches to catch that change from the rust
side via rust compiler for rust drivers?
Z.
> This patch introduces a Rust abstraction over the fwctl subsystem,
> providing safe and idiomatic bindings.
> 
> The new `fwctl` module allows Rust drivers to integrate with the existing
> C-side fwctl core through a typed trait interface. It provides:
> 
>   - `FwCtlOps` trait — defines driver-specific operations such as
>     `open_uctx()`, `close_uctx()`, `info()`, and `fw_rpc()`.  
>     Each Rust driver implements this trait to describe its own per-FD
>     user-context behavior and RPC handling.
> 
>   - `FwCtlUCtx<T>` — a generic wrapper around `struct fwctl_uctx`
>     embedding driver-specific context data, providing safe conversion
>     from raw C pointers and access to the parent device.
> 
>   - `Registration<T>` — safe registration and automatic unregistration
>     of `struct fwctl_device` objects using the kernel’s device model.
> 
>   - `FwCtlVTable<T>` — a static vtable bridging C callbacks and Rust
>     trait methods, ensuring type safety across the FFI boundary.
> 
> `rust/kernel/lib.rs` is updated to conditionally include this module
> under `CONFIG_FWCTL`.
> 
> [1] https://lore.kernel.org/all/20250903221111.3866249-1-zhiw@nvidia.com/
> 
> Zhi Wang (2):
>   rust: introduce abstractions for fwctl
>   samples: rust: fwctl: add sample code for FwCtl
> 
>  include/uapi/fwctl/fwctl.h        |   1 +
>  rust/bindings/bindings_helper.h   |   1 +
>  rust/kernel/fwctl.rs              | 254 ++++++++++++++++++++++++++++++
>  rust/kernel/lib.rs                |   2 +
>  samples/rust/Kconfig              |  11 ++
>  samples/rust/Makefile             |   1 +
>  samples/rust/rust_driver_fwctl.rs | 123 +++++++++++++++
>  7 files changed, 393 insertions(+)
>  create mode 100644 rust/kernel/fwctl.rs
>  create mode 100644 samples/rust/rust_driver_fwctl.rs
> 
Powered by blists - more mailing lists
 
