From nobody Tue Feb 10 04:14:06 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 60C4BC7EE2D for ; Wed, 31 May 2023 15:01:39 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233632AbjEaPBi (ORCPT ); Wed, 31 May 2023 11:01:38 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60866 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233543AbjEaPBg (ORCPT ); Wed, 31 May 2023 11:01:36 -0400 Received: from mail-ej1-x649.google.com (mail-ej1-x649.google.com [IPv6:2a00:1450:4864:20::649]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F236EC0 for ; Wed, 31 May 2023 08:01:34 -0700 (PDT) Received: by mail-ej1-x649.google.com with SMTP id a640c23a62f3a-96fb396ee3dso480062566b.1 for ; Wed, 31 May 2023 08:01:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1685545293; x=1688137293; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=1Q+2I5zSt9CeXJ84cI2DkRkCdZ4Svm4rmosqyRFgB4Q=; b=bnNa4BzNnMkAV8sNhlJArseXSoa/Cp3RaANBWBzd9VxjyIDTlr4hV7uLR/Fqr9sPFg V3T4M1u/Cqm0TGKtaApBthh754cK9SVYKk7sf7q3cjbDyz6YZOGdIstimjRAUVz5u2hR 8m671arTsCNlICRB/UITLp9bQ0bfiVv7ZPXC8NfTxKukxFdruO1EVpr8lAweg52Zhtt/ L3D8bfG+9M6OBkd6fuW1h7I971Cedkt4wE2UQtCSpAXNcu0eSmZhV39uhvD0x4mx1YER ls/kFUZu9/H1vEW7IHInniok08Iozig+z3zNg4JUoo/DWBFqr6kTLIvM4uP263wWuHu9 tIyg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1685545293; x=1688137293; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=1Q+2I5zSt9CeXJ84cI2DkRkCdZ4Svm4rmosqyRFgB4Q=; b=OxGD6oaR3LfwYl4fudrd7WPoDkbbQs0N/W0ljMnjw6YvdJveJRQwW2fZYtx2AF1AOc ErxWh9tFKdTGfEG3pz5yhZ9wj9wfCZhxdUFklQo6z5S9clQtGghPL8L7B8PDGQZpF/Hw elk88LFTeM9lO6qTWPWd/IxpfT6bwpl8pPcRGZ0BscXzg0wF9mo4U/Ec/m13ci/eYben V2xlc3XqSw7xGZDLVVpZ2ezxUSCQfBbFpvlb9DwJw++uCgL/SyuY5IFtRveGF9/cujVf KBFkEhbnv2fr5YV6qb4il4oKvk+aV3UGk4Viz5Sp+JmZSoWq47tfkuYw0LfauSOveMpr k4tA== X-Gm-Message-State: AC+VfDz+rJqyQuEGKI4j/6UELh9AumNwcO6JdpuWmkyUaN/7QNlDvxlw w+dmRYiKK0KmvyF/QmSWNFX8Ya7aOLLQBMo= X-Google-Smtp-Source: ACHHUZ4rFIpC5Ll9CIoCxXSbzxO4gKHoA+ZHFByEbtLUbWCcxVxu8ZUSKtcxpuigVxxLU6jw6KkDmlloVWmty3w= X-Received: from aliceryhl.c.googlers.com ([fda3:e722:ac3:cc00:31:98fb:c0a8:6c8]) (user=aliceryhl job=sendgmr) by 2002:a17:906:846d:b0:96f:5348:6ce0 with SMTP id hx13-20020a170906846d00b0096f53486ce0mr2119526ejc.5.1685545293508; Wed, 31 May 2023 08:01:33 -0700 (PDT) Date: Wed, 31 May 2023 14:59:37 +0000 In-Reply-To: <20230531145939.3714886-1-aliceryhl@google.com> Mime-Version: 1.0 References: <20230531145939.3714886-1-aliceryhl@google.com> X-Mailer: git-send-email 2.41.0.rc0.172.g3f132b7071-goog Message-ID: <20230531145939.3714886-3-aliceryhl@google.com> Subject: [PATCH v3 2/4] rust: sync: reword the `Arc` safety comment for `Sync` From: Alice Ryhl To: rust-for-linux@vger.kernel.org Cc: Miguel Ojeda , Wedson Almeida Filho , Alex Gaynor , Boqun Feng , Gary Guo , "=?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?=" , Benno Lossin , Alice Ryhl , Ingo Molnar , Peter Zijlstra , Will Deacon , Mark Rutland , linux-kernel@vger.kernel.org, patches@lists.linux.dev, Andreas Hindborg , Martin Rodriguez Reboredo Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The safety comment on `impl Sync for Arc` references the Send safety comment. This commit avoids that in case the two comments drift apart in the future. Suggested-by: Andreas Hindborg Signed-off-by: Alice Ryhl Reviewed-by: Andreas Hindborg Reviewed-by: Boqun Feng Reviewed-by: Martin Rodriguez Reboredo Reviewed-by: Benno Lossin --- rust/kernel/sync/arc.rs | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/rust/kernel/sync/arc.rs b/rust/kernel/sync/arc.rs index 3ad831603cf4..3da84187ecf4 100644 --- a/rust/kernel/sync/arc.rs +++ b/rust/kernel/sync/arc.rs @@ -150,9 +150,11 @@ impl, U: ?Sized> core::ops::Disp= atchFromDyn> for Ar // mutable reference when the reference count reaches zero and `T` is drop= ped. unsafe impl Send for Arc {} =20 -// SAFETY: It is safe to send `&Arc` to another thread when the underly= ing `T` is `Sync` for the -// same reason as above. `T` needs to be `Send` as well because a thread c= an clone an `&Arc` -// into an `Arc`, which may lead to `T` being accessed by the same reas= oning as above. +// SAFETY: It is safe to send `&Arc` to another thread when the underly= ing `T` is `Sync` +// because it effectively means sharing `&T` (which is safe because `T` is= `Sync`); additionally, +// it needs `T` to be `Send` because any thread that has a `&Arc` may c= lone it and get an +// `Arc` on that thread, so the thread may ultimately access `T` using = a mutable reference when +// the reference count reaches zero and `T` is dropped. unsafe impl Sync for Arc {} =20 impl Arc { --=20 2.41.0.rc0.172.g3f132b7071-goog