From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f50.google.com (mail-pj1-f50.google.com [209.85.216.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9B9962DB795 for ; Tue, 1 Sep 2026 01:04:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.50 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788224650; cv=none; b=cqW8A9d+wBA2jWNAWpys1eUianVZ7F/U3kHwm3p23XME8bQEr6o69OAxnY1JzZ8uW2Cc+c+UNYdA/jpyDLQPnhvd51I8ZalifVOMo5Cm9nXcC4rzuN0QlT+0mPM/V4KnT9TzlBdPJbiW1isZqiB3oIF8nrnKh97b7WMdXgT8+Tc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788224650; c=relaxed/simple; bh=CoPPRCtaESHUG9OwZb9CyMVn08i9IGh5mH8Q+LlV8pU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=VFdmacg9Xk5g6E/OgRRX7WY1BstfUiV/xYgz3BnPjrNL/v4jfnjFtFBkjk64SaCkqPJcucHESV7FY5uL66ozGaNM4bblOY7nIAwKKB/o4RpwY3OPVxS+KR/RtdzXNAj0g67AiLYA5ahe5B+LALAvIAHgnRSIy4WEAryZ4cTWVVM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Gok1GWMs; arc=none smtp.client-ip=209.85.216.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Gok1GWMs" Received: by mail-pj1-f50.google.com with SMTP id 98e67ed59e1d1-3965d3d9ab8so3240646a91.3 for ; Mon, 31 Aug 2026 18:04:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1788224649; x=1788829449; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=AYXVDMNHLbdJmU4DKZR7fcyBrcg7wKS5d7QhF+qczOE=; b=Gok1GWMsICvbvt7A9OQY99NKTu1NKdA11Iggvri7Wp12kyZsKtrRG/YU67JygJvdnM 6SzGpPLzAqA+Qt+9z7NYIzLIY/gb/vVdpVaJoUObtHEWD066WaD0j/IaF4c305ZYcZ0H MypzaSHpNbgE6s1xrU709N1/zgv1d1KxXT3heawYNmL2Mw2KLw6LJwv3yLFaL+cYHtzl y2VWmN2ogcOFoDIoUajqnI0VFS0k48Y7V99CG74fY8GdCMqtaMvGothbkd8UesQ0/vmV C9VtyQri6Pc1zg3CoV9ft8Rdw2pxcKZdhN9Yjr9qIhxQVrmXYzvQihsisRC9TppkHWZ/ tMEQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788224649; x=1788829449; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=AYXVDMNHLbdJmU4DKZR7fcyBrcg7wKS5d7QhF+qczOE=; b=IApbU3t3OfXiQe3is8ceagPHlxZmpLjU9uITkI4J8ixSfRGTgwf1NQSYzoDxn/Qdhl zrOomFWDgDimLd0NIohSfSxv9vloYeWnGGheb3p+j01OPCWvQ1HqtmUEmxOQoPc8DPok nZUGwRP1a6qud1mWSOE9D0Y2enamzr5iSYiR/4xCJ10HrBhkljdEnW7oKZT18HngF7qh wvn2JXFezXNHlJ0lOBX3jDCQV7Ag+j5DTehnNfCC0A+qLWrinItZx9cC6BFc9pI4/TgB 8O2roXLOp1NT6tkBtmuVfqvMTGhjy3Q/6uPthKoKCB8RrWBUZnDbcxstGO/mq+IpkrnH Dr3Q== X-Forwarded-Encrypted: i=1; AKwUvBze5lj/1u96iWjeUsOEa0llHE4+KoDyQEvhxGLJP6/MqbwUoVCbQyH51Bfwbkfeje0qP31CnRo5OqoW7w8=@vger.kernel.org X-Gm-Message-State: AFuF++m0PyaXRZVsi/tQi58ijRX1NgnECygJHsgN7ID7Acg6Jnev2f9A UFbWGvx3Im389BmWqRwViREETFPY4s6IpzCBr0IcjK3R3X19xIQpkem9 X-Gm-Gg: AYBFou2TdY5/zH4T8L5tBTG9NppaFP9vwQgzkSLoK2jwKa8/GTzsZ/374tHZu5wSnzz XZCDguBzwxIVFLKqK5mCFEoaPIxLVVgQXjyoJ5jOsesM5w9UvviGN62q6S2l7pnin3AkscUSMPN lERBm7Av60C2N2cyylCHfoQM2AkynV5BPFVjRDO+KmiFYWzq2j7r5DzhevqTj2GidHuYVvyuqF3 7pESCTaI1euKFUYyJ+VUNHUzSIuLv49NpPJMWVsIuakNudkwWORIcWdIfLniBfVwnSoq2ZIiAEc 1IlYGIL/TkyMx6OEeppdjFyyBhyhP8KdM4vv/mgiDoKFyaQbfgNg+svyxvEnqa+hZ3QYPxu+Npg xAZnLviWjmJqVTcgifsKalqbrfQFkjnWfStC4cLT4ODfjl1RDROQuUXSJU8rzMzE5CFgXfrfY2S Xy1NUVxVHOUAYsff+f6x9sO5Z2aZe29JpyZU9mu3GTGMEgmc0HgowZelJd9ODMV5h/LHHcMA/2K 7lhng== X-Received: by 2002:a17:90b:1a8e:b0:396:4c63:7193 with SMTP id 98e67ed59e1d1-396d0fe45damr45825286a91.11.1788224648978; Mon, 31 Aug 2026 18:04:08 -0700 (PDT) Received: from toolbx.alistair23.me ([2403:581e:fdf9:0:13b2:851f:d9cb:44c5]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3990d49e9e0sm2372024a91.11.2026.08.31.18.04.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 31 Aug 2026 18:04:08 -0700 (PDT) From: alistair23@gmail.com X-Google-Original-From: alistair.francis@wdc.com To: linux-pci@vger.kernel.org, Jonathan.Cameron@huawei.com, djbw@kernel.org, rust-for-linux@vger.kernel.org, lukas@wunner.de, alistair@alistair23.me, jic23@kernel.org, linux-cxl@vger.kernel.org, bhelgaas@google.com, akpm@linux-foundation.org, linux-kernel@vger.kernel.org Cc: gary@garyguo.net, ojeda@kernel.org, benno.lossin@proton.me, a.hindborg@kernel.org, wilfred.mallawa@wdc.com, tmgross@umich.edu, alistair23@gmail.com, boqun.feng@gmail.com, bjorn3_gh@protonmail.com, alex.gaynor@gmail.com, aliceryhl@google.com Subject: [PATCH v3 01/21] rust: transmute: add `cast_slice[_mut]` functions Date: Tue, 1 Sep 2026 11:03:27 +1000 Message-ID: <20260901010347.2614656-2-alistair.francis@wdc.com> X-Mailer: git-send-email 2.55.0 In-Reply-To: <20260901010347.2614656-1-alistair.francis@wdc.com> References: <20260901010347.2614656-1-alistair.francis@wdc.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: Benno Lossin Add functions to make casting slices only one `unsafe` block. Signed-off-by: Benno Lossin Message-ID: <20250814124424.516191-2-lossin@kernel.org> --- rust/kernel/transmute.rs | 59 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/rust/kernel/transmute.rs b/rust/kernel/transmute.rs index 654b5ede2fe2..c1282fcc9e65 100644 --- a/rust/kernel/transmute.rs +++ b/rust/kernel/transmute.rs @@ -3,6 +3,7 @@ //! Traits for transmuting types. use core::mem::size_of; +use core::slice; /// Types for which any bit pattern is valid. /// @@ -227,3 +228,61 @@ macro_rules! impl_asbytes { {} [T], {} [T; N], } + +/// Casts the type of a slice to another. +/// +/// Also see [`cast_slice_mut`]. +/// +/// # Examples +/// +/// ```rust +/// # use kernel::transmute::cast_slice; +/// #[repr(transparent)] +/// #[derive(Debug)] +/// struct Container(T); +/// +/// let array = [0u32; 42]; +/// let slice = &array; +/// // SAFETY: `Container` transparently wraps a `u32`. +/// let container_slice = unsafe { cast_slice::>(slice) }; +/// pr_info!("{container_slice:?}"); +/// ``` +/// +/// # Safety +/// +/// - `T` and `U` must have the same layout. +pub unsafe fn cast_slice(slice: &[T]) -> &[U] { + // CAST: by the safety requirements, `T` and `U` have the same layout. + let ptr = slice.as_ptr().cast::(); + // SAFETY: `ptr` and `len` come from the same slice reference. + unsafe { slice::from_raw_parts(ptr, slice.len()) } +} + +/// Casts the type of a slice to another. +/// +/// Also see [`cast_slice`]. +/// +/// # Examples +/// +/// ```rust +/// # use kernel::transmute::cast_slice_mut; +/// #[repr(transparent)] +/// #[derive(Debug)] +/// struct Container(T); +/// +/// let mut array = [0u32; 42]; +/// let slice = &mut array; +/// // SAFETY: `Container` transparently wraps a `u32`. +/// let container_slice = unsafe { cast_slice_mut::>(slice) }; +/// pr_info!("{container_slice:?}"); +/// ``` +/// +/// # Safety +/// +/// - `T` and `U` must have the same layout. +pub unsafe fn cast_slice_mut(slice: &mut [T]) -> &mut [U] { + // CAST: by the safety requirements, `T` and `U` have the same layout. + let ptr = slice.as_mut_ptr().cast::(); + // SAFETY: `ptr` and `len` come from the same slice reference. + unsafe { slice::from_raw_parts_mut(ptr, slice.len()) } +} -- 2.55.0