From nobody Fri Dec 19 18:59:34 2025 Received: from mail-ed1-f45.google.com (mail-ed1-f45.google.com [209.85.208.45]) (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 DABB830F94B for ; Fri, 7 Nov 2025 08:13:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762503205; cv=none; b=MVjBxucPemmJO2xfCD/ki8SzSR5VtMbZVOcfqOcoS97OB628LcoreY6KwWic6oVnVxnvh+vZebPc6DpUcHxmQuVnEyyumqXBVuGi+1/lXzNkeat8+laBPPyxFVZXbF5SrsVnaM1UIEvZIV/897KReLRBiirI/P2fYFXS+daAXi8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762503205; c=relaxed/simple; bh=0sXmLwNMlYc0PbllYPcwc9yuoEtGcI4ex2Sbk6FXq8o=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=TqquhVCmg9CPrjVVl2KK1lwpuDhUlhigyUgME7cY5IDLaqlWlemgHFZbF+ues4DtqQRQAu+1CkbEtE5Kbdbt1HsN1TJLtGgdef62FHhMT+8cUqWgj4OAyEC/sj+xUVMp3dE5SGw4tcGLMYW4bCdMuZYcSwboKY3Ock0Gs/UTFVs= 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=R6dLF+4X; arc=none smtp.client-ip=209.85.208.45 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="R6dLF+4X" Received: by mail-ed1-f45.google.com with SMTP id 4fb4d7f45d1cf-6407e617ad4so208912a12.0 for ; Fri, 07 Nov 2025 00:13:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1762503202; x=1763108002; 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; bh=PabJINhtTz14DvOSYG0veNaIdLnYHWjqpt4UhSeU28c=; b=R6dLF+4X2CQJ6hVObynXUvpvM2YFmWaT06KkMzU4/XmJaAhsXV5GojsCfPCkEn9G+J 3P3scbJZLsIUlL1wKELkVTwENNosOJmoSr9mffuEeEUDv289t3/VWGFEufzh18rOG3WK 1zkFD4ffevyn1OEN5PGRjjC7+rQVElMoaNafcfqXZOLKb27S/JfHRXXwAoJrIdrzUeeT axl644jra5JDuNQswN/SY0nruy57hohN9rXP71a4e5Gl+AyQxRbdkInUUqygvfNOQB5Y TBAP7zd5s5fgQ0jFGwoAPID7okRS52xKZE/UZz3I4V5GDnPVqD68g1VrfLUJO8doCu5T O2qQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762503202; x=1763108002; 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; bh=PabJINhtTz14DvOSYG0veNaIdLnYHWjqpt4UhSeU28c=; b=QXnDCB1UnRc/ZpcF1kbyxk20ygI27VWBJybtbYB/doxUnpOKKhAHSorN6Ms6tCA6HY EoVfoACssChFu25Gr35Noq0zIzs1zGEJY2ehRVYfxwDsqeZBGXPzK7oEfzI9IRO9C2Ho pkqatGiX9+K5avJIZXecB9MgdeLjtSk6V9emyqAtcqmAAys4kO85xsxFErFYefMBTpkE iaXDGm4z96MHwdHyW18JU2PRZaZUUK9FkQQDT645jCgvdIwR3g8M9kweSilaRNik9PyA +Pz9GrvfxDstlbdqoYid0VnK0W7xys7iiMPePF48Er19d1PWowr3LF2TE6/NgBl+udaA 0ydQ== X-Gm-Message-State: AOJu0YwF6+8bQK5kUeTSgisdDJfXpwoFof1mOky391zAEpHfVXBPaR9x udBXGI40vOADnKSrmo2P+GOfLeuuU6IDatNg9Ny28kfbDlORSscqcKwQ X-Gm-Gg: ASbGnctEmOoZrBBUUrshNfh723zNQMoh3OD32vPEdu6yvidmS/yDqazDhcyuSHgQo9S ly5Pf/qn0hwCOintcGfRJgC1P2zQCHBl5xWjAHdnk43u1vu4/3Cl2v4PrH0IrpOwORYvjBZVJ0C mITwLd5R/wkU7nZYS3pBEh9RCYJ+CdEQ01qCU2pmZgTFgJPIZym+559eFAVDCJsPWlzqxECuwCT uu9IbvuFBiXBFnVmNyOXfreQzx7DOrmteUpDUaVzF3yvoyvX5kVFrhivSIhjAqQUZaKF1prbLlu VXRHHg/F0UESxGVWDXYkxn5zj2PegLxkGyXMq/F6XeBsScV4u6/VgNiLJ6sjaCZYOBGDfTiMT2Z 2KACXE59BGOe+c+NeelVoT3PoymZCDeClDjvK9bX0UmcSO8NAv9gygN20i7ytAIuaD8aNTu2yW6 EE X-Google-Smtp-Source: AGHT+IH8lIVBGU6qZcWj9lXhl2uY6I1BfrQTXsj7jZaaMXy9BNwAH/WaMBWywYg8F8rsMUMO09NxnA== X-Received: by 2002:a05:6402:5352:10b0:640:998e:4471 with SMTP id 4fb4d7f45d1cf-64146d18bb6mr550756a12.5.1762503202010; Fri, 07 Nov 2025 00:13:22 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-6411f862697sm3641613a12.25.2025.11.07.00.13.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 07 Nov 2025 00:13:20 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 032C042439DF; Fri, 07 Nov 2025 15:13:12 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux IOMMU Cc: Jonathan Corbet , Joerg Roedel , Will Deacon , Robin Murphy , Jason Gunthorpe , Randy Dunlap , Bagas Sanjaya , Kevin Tian , Samiullah Khawaja , Pasha Tatashin , Lu Baolu , Stephen Rothwell , Jason Gunthorpe Subject: [PATCH v2 1/2] Documentation: genpt: Don't use code block marker before iommu_amdv1.c include listing Date: Fri, 7 Nov 2025 15:13:00 +0700 Message-ID: <20251107081300.13033-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.2 In-Reply-To: <20251107081300.13033-2-bagasdotme@gmail.com> References: <20251107081300.13033-2-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1631; i=bagasdotme@gmail.com; h=from:subject; bh=0sXmLwNMlYc0PbllYPcwc9yuoEtGcI4ex2Sbk6FXq8o=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJm8K/RqNyVdu5D741ms3OR9ByJeGHXMYO4M15mjVd7zX frZn3lnO0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjCRwL+MDL1NZW6RbP46j7Z9 +cT8asYt5y311mXrQ59Zzdka4nLS5wjD/7KTUmlc95YK67orqgrIZ8xnYhHx2dcg2Tb9/9Izd3k XsgMA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Stephen Rothwell reports htmldocs warning when merging iommu tree: Documentation/driver-api/generic_pt.rst:32: WARNING: Literal block expected= ; none found. [docutils] This is because of duplicate double colon code block markers: one after generic_pt/fmt/iommu_amdv1.c and the one in its preceding paragraph. The resulting htmldocs, however, only marks the include listing (after the former) up as it should be. Drop the latter to fix the warning. Fixes: ab0b572847ac ("genpt: Add Documentation/ files") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251106143925.578e411b@canb.auu= g.org.au/ Acked-by: Randy Dunlap Tested-by: Randy Dunlap Reviewed-by: Jason Gunthorpe Signed-off-by: Bagas Sanjaya --- Documentation/driver-api/generic_pt.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/driver-api/generic_pt.rst b/Documentation/driver= -api/generic_pt.rst index 210d1229aa1c1f..7a9ca9f2878d4f 100644 --- a/Documentation/driver-api/generic_pt.rst +++ b/Documentation/driver-api/generic_pt.rst @@ -27,7 +27,7 @@ compiled into a per-format IOMMU operations kernel module. For this to work the .c file for each compilation unit will include both t= he format headers and the generic code for the implementation. For instance i= n an implementation compilation unit the headers would normally be included as -follows:: +follows: =20 generic_pt/fmt/iommu_amdv1.c:: =20 --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Dec 19 18:59:34 2025 Received: from mail-ed1-f49.google.com (mail-ed1-f49.google.com [209.85.208.49]) (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 0BB5E30F93A for ; Fri, 7 Nov 2025 08:13:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.49 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762503204; cv=none; b=C797/7SZNq8S3kN0wjaT1xAznfwjsfZamIQHdYuU+E0W0pfKeoUdobOr57WZhEVt2FZF0ENswJXB9+P+USq2dT6lReNaKCERDbcD9fXjuIV1oY3LDFTHIr2/DcBlsSqNPNh66v8bs712opFR6VEBSnu9pG4WW50KnRzV0lFijTA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762503204; c=relaxed/simple; bh=l70ZHuFXGxCuiZ9UWHRnDufmsHg5/+S7082Atj+1UWA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=FRRmB5IQ/TwBG3TgjLMQTRAJgVVCOwiOiKF1KukR7gqcfs8ce1VxiZvHkTsmts1luCLeG+EA0BbGIYdQ+eZCabd4VoDTP7uEs4/rnvwcD6+V7tRr5yS4Qq3/7DivJCJ9046i7yhB73ZvJI1Ohs0HY4zkuJz5WYsgUKQb9cwgBnU= 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=lNf5qHPr; arc=none smtp.client-ip=209.85.208.49 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="lNf5qHPr" Received: by mail-ed1-f49.google.com with SMTP id 4fb4d7f45d1cf-640b2a51750so992069a12.0 for ; Fri, 07 Nov 2025 00:13:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1762503201; x=1763108001; 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; bh=s/S84Bq0H+5Q5GEwboYARmckBLSU9dA4Cuq2qpko4lg=; b=lNf5qHPriYstzhQF7q0ACqxkb9UzdxXEov6xxYtdp1nkHrorl8NZ6sM7FaYVp2sdeN Q/rYhVkrmV6NcjaFrHUXgqkIBj4fYcXaA3qcucCBVU31j1hmIwUxR2JlOP9gJiItVIWz CNiwQvVyE7/d4+2suH6fGGwVpz2ON68XiJWeKGEcifRcwRyOGvhoqdq9aFourgvSbltR FUONSqOFVBpwop2bGMrBKqk4ImNmVjlRnvmKvqIXxmtMn2Mzm1AIWaYBhR3723fYrUS1 GU4C6xsPO8Ov9WJuTE7uAjgoPdhZx/M7kHLAT9pF35A/h3xZMuQYoQx5TbqCsF926gBm EVEQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762503201; x=1763108001; 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; bh=s/S84Bq0H+5Q5GEwboYARmckBLSU9dA4Cuq2qpko4lg=; b=gS2CatamM+mmK0gcFsjdlpwN1Cvey9NOUZQkkouoVZK+xvgM13lLLWdX/AFZW1dRuO E6XEG432OeISBwFRNi+N1UgiorO/+tFrV/21/+yySC4aag5OsJ+UlQh+o/vRdFtbFfot /2flp0s41jAu31XLo2WkBuPhcS8jlLwfOm278ukg+Lzsxr56vH2h8WdyuBTExVsN/Nzd doI1Ua97zExuHthMh0I3mIq6Zjk3GEBmeGn+NX0B/KtEJ+xnQv+SJWJaW932Oz56lOdj dEjHS5fKwQstffmeGufoEUsxc4qau5inP5n9PSSiMTnRQZD4GBGVZjit6TeDBIdA8xPu FIOg== X-Gm-Message-State: AOJu0YwjuVpqeGIBaLH+j/bKS07k4//YD2HDlCdUL+e7FvVkC9oucQPS aaxhSUVqanyN6Icc7uN+60kiWpgZIFKAY67nXWK2ChuXtaRLhuecL/xa X-Gm-Gg: ASbGncvfCMprcJ66OoCQ/s5FtCHh+qa54AojNFnLIQ1FNNqESlRfFMSVkj7fV9BrQSL 3yhnxkkWjV9+WGzc0jqf22KyurDR+Lpz1v0KZR9KdhxLGfpmLLm4Jfy5h8sYd6yc8HhpjMx14yO XJvLy6XRhOxoRCDy6nTK82DtVgZaE1bSRsMgmjp9PusH7e1kne/s3GMRJqlrtHfHgPrx/pVp4n1 1f23aIYPBDJBqQ4sYLQ9veVM3iOFwmDmgwwH6SmJ6uoFcjLT1F8uabVxjnws4N3kbW2greabIR5 MCcUni9hWe2na2y92Ni9r4MRG6dBkDD4N7QTAfUXKkMTW427vW+mM8Rat2wxar6m1vrzGUTxOng BCOYzD11tfH6ELCm71j5VDxAfvfNOM2jDo53/KMZQYhkKxUlXtXCLIvg54/J5xE2CGRrvB3P9CS 4EiB1NMsCW54w= X-Google-Smtp-Source: AGHT+IGeKtv44GcSyZP8wA09Y2J6Plyg1nStPrUzCk/QO5GDH6nrlZ7OMpI0TvErsPPE6Q92rFcohw== X-Received: by 2002:a17:907:3d45:b0:b70:e15b:286a with SMTP id a640c23a62f3a-b72c0d9438emr243107866b.57.1762503201240; Fri, 07 Nov 2025 00:13:21 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-b72bf4fbda2sm177442166b.28.2025.11.07.00.13.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 07 Nov 2025 00:13:20 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 41826424DA71; Fri, 07 Nov 2025 15:13:12 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux IOMMU Cc: Jonathan Corbet , Joerg Roedel , Will Deacon , Robin Murphy , Jason Gunthorpe , Randy Dunlap , Bagas Sanjaya , Kevin Tian , Samiullah Khawaja , Pasha Tatashin , Lu Baolu , Jason Gunthorpe Subject: [PATCH v2 2/2] iommupt: Describe @bitnr parameter Date: Fri, 7 Nov 2025 15:13:01 +0700 Message-ID: <20251107081300.13033-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.2 In-Reply-To: <20251107081300.13033-2-bagasdotme@gmail.com> References: <20251107081300.13033-2-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1579; i=bagasdotme@gmail.com; h=from:subject; bh=l70ZHuFXGxCuiZ9UWHRnDufmsHg5/+S7082Atj+1UWA=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJm8K/Q0zOYGTDgr9jri977z+QzvRDbO6GgTcj+x49BOS S0H9z8VHaUsDGJcDLJiiiyTEvmaTu8yErnQvtYRZg4rE8gQBi5OAZiI13lGhk6LMFHd7FuyC1Id DvPLM+1jsX2t9/75qszetQw2Nvs8NjP8jyxeuf3fy8Vh786WbToquy7djy97wZXeWOOsmF2Opiv OcQIA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sphinx reports kernel-doc warnings when making htmldocs: WARNING: ./drivers/iommu/generic_pt/pt_common.h:361 function parameter 'bit= nr' not described in 'pt_test_sw_bit_acquire' WARNING: ./drivers/iommu/generic_pt/pt_common.h:371 function parameter 'bit= nr' not described in 'pt_set_sw_bit_release' Describe @bitnr to squash them. Fixes: bcc64b57b48e ("iommupt: Add basic support for SW bits in the page ta= ble") Reviewed-by: Jason Gunthorpe Signed-off-by: Bagas Sanjaya --- drivers/iommu/generic_pt/pt_common.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/iommu/generic_pt/pt_common.h b/drivers/iommu/generic_p= t/pt_common.h index b5628f47e0db40..3b4e371089140a 100644 --- a/drivers/iommu/generic_pt/pt_common.h +++ b/drivers/iommu/generic_pt/pt_common.h @@ -354,6 +354,7 @@ static inline unsigned int pt_max_sw_bit(struct pt_comm= on *common); /** * pt_test_sw_bit_acquire() - Read a software bit in an item * @pts: Entry to set + * @bitnr: Bit to read * * Software bits are ignored by HW and can be used for any purpose by the * software. This does a test bit and acquire operation. @@ -364,6 +365,7 @@ static inline bool pt_test_sw_bit_acquire(struct pt_sta= te *pts, /** * pt_set_sw_bit_release() - Set a software bit in an item * @pts: Entry to set + * @bitnr: Bit to read * * Software bits are ignored by HW and can be used for any purpose by the * software. This does a set bit and release operation. --=20 An old man doll... just what I always wanted! - Clara