From nobody Sun Feb 8 16:52:56 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 2964FC77B73 for ; Tue, 6 Jun 2023 08:26:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236661AbjFFI0V (ORCPT ); Tue, 6 Jun 2023 04:26:21 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53382 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236617AbjFFI0T (ORCPT ); Tue, 6 Jun 2023 04:26:19 -0400 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E8FECFA; Tue, 6 Jun 2023 01:26:17 -0700 (PDT) Date: Tue, 06 Jun 2023 08:26:15 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1686039976; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=e4Mz+yZ5wgoRWfsGdE2qATMR07LuxF6HxmI420vA0vw=; b=3IJoslHRT8Bsmg2Sr0pPb+P+nSSonQ30k7Sj5pa0C9bGYRG8UD41zffTNQsXCNlqdPDkXQ 4T8ZD4fN5YZN4QBq9Y4dt12iTSUfmw0XeSObRdFLS76YROnyniM4VZ5XBNQ2v8W5mCuZ+z 1GcZ1NmBcLmdV7vHiFm5hnu+uMP5XFlcjPz1NN29jG9waPz1w3LQ4AG+HYeTnhpimRf1p2 srMfV5YQaVyT8GPwncECuBGbWCGGgGkBWtpiV5p6P47oKYhvaTL7Rzp7PfRsD5qLtAsjgu PKA2SIseDRr0b5ifKLUtenL2YKrtjPU1x0Q4fc1i5VSOZTP4ixvLSt80pBtrmw== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1686039976; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=e4Mz+yZ5wgoRWfsGdE2qATMR07LuxF6HxmI420vA0vw=; b=HhEvGpBwso+sIvSVLaX8ZB0uKku9boYpaz9aSFyP+29bF9x1Kt9dZxhKPH0C5cTVfQfKRb ilQ6x27gq8nPdECg== From: "tip-bot2 for Paul E. McKenney" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: locking/core] locking/atomic: docs: Add atomic operations to the driver basic API documentation Cc: "Paul E. McKenney" , Mark Rutland , "Peter Zijlstra (Intel)" , Kees Cook , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <20230605070124.3741859-27-mark.rutland@arm.com> References: <20230605070124.3741859-27-mark.rutland@arm.com> MIME-Version: 1.0 Message-ID: <168603997541.404.16590439453491268749.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The following commit has been merged into the locking/core branch of tip: Commit-ID: e74f4059d11f36e936b08e98bc96f654c308807a Gitweb: https://git.kernel.org/tip/e74f4059d11f36e936b08e98bc96f654c= 308807a Author: Paul E. McKenney AuthorDate: Mon, 05 Jun 2023 08:01:23 +01:00 Committer: Peter Zijlstra CommitterDate: Mon, 05 Jun 2023 09:57:24 +02:00 locking/atomic: docs: Add atomic operations to the driver basic API documen= tation Add the generated atomic headers to driver-api/basics.rst in order to provide documentation for the Linux kernel's atomic operations. At the same time, dtop the x86 atomic header, which provides kerneldoc comments for some arch_atomic*_*() operations. The arch_atomic*_*() operations are now purely an implenentation detail of the raw_atomic*_*() ops, and outside of implementing the atomics, code should use the raw_atomic*_*() forms. [Mark: add atomic-{instrumented,long}.h, update commit message] Signed-off-by: Paul E. McKenney Signed-off-by: Mark Rutland Signed-off-by: Peter Zijlstra (Intel) Reviewed-by: Kees Cook Link: https://lore.kernel.org/r/20230605070124.3741859-27-mark.rutland@arm.= com --- Documentation/driver-api/basics.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api= /basics.rst index 4b4d8e2..7671b53 100644 --- a/Documentation/driver-api/basics.rst +++ b/Documentation/driver-api/basics.rst @@ -84,7 +84,13 @@ Reference counting Atomics ------- =20 -.. kernel-doc:: arch/x86/include/asm/atomic.h +.. kernel-doc:: include/linux/atomic/atomic-instrumented.h + :internal: + +.. kernel-doc:: include/linux/atomic/atomic-arch-fallback.h + :internal: + +.. kernel-doc:: include/linux/atomic/atomic-long.h :internal: =20 Kernel objects manipulation