From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f42.google.com (mail-wr1-f42.google.com [209.85.221.42]) (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 0B8C92405EB for ; Sun, 16 Aug 2026 13:15:41 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.42 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786886143; cv=none; b=IzqsCLt13eeA7uCuRlUZH/zd02Bu6tVZHB1JYt5UiTRYSrJxfGD/GFX5pqNWURkd2ObwURys5bRvzXNfXNvBpLFYqlQV64ov/G+VQopndE2AohWwebVLzwB4kgaL+ccMXlS5etkc8jTbR8rpzYIvgqb27oUhBUci8gvbZWZ4p2Y= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786886143; c=relaxed/simple; bh=7bHEVnffJ0Ha1AmdgWjbxfy5izeofTmU4jrvr0MP5/w=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=CD19gJuzHgSZpNz1yclr4H3P3lc1pZCtF3hPID0kZIehAwLiVyFosI+P6PdqXMxYtvktXhTShWB7azX9SmuvHqLeGCj66ZKMYdxvUnCHEFqBAw97ArykmwOCffqZNp9mzKk1A96cHIdDjLXqux5Oe8SZqoeH+uB81jehqVVjKkk= 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=VhM4HYu6; arc=none smtp.client-ip=209.85.221.42 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="VhM4HYu6" Received: by mail-wr1-f42.google.com with SMTP id ffacd0b85a97d-47de0093c42so2278900f8f.3 for ; Sun, 16 Aug 2026 06:15:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786886140; x=1787490940; 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=pv2jURNhPUK2tV76gyguAJRM2PrSOiDKR10eWUSfOs8=; b=VhM4HYu6l9om3s5PVkAvhKLsN9PjfTM4YgBN6TL1WvDz7mc/Rz4S/aSRp30m1zBNE/ mViO+qhGTggpgBXva/7eW0D/AvQ1JYq/jauNbUup6w0QwYJoKiQNqO2sUo9idQy61NyJ Q5+Sm9Or5fsJGKd5EWNQGWSkY0v2u8fV95JB7NIw1bky2qfFdzquX+TkCCmcsBOdJzY6 eUbmELe82Zhol2jf0NzS2ET99YsCARjB92qZf2mUI8S9rwYNu1hWibwtD1jTLUUNjwJT lEHaGTAQ2j6ZuD9X9b0NzCWpDhI5PO8CfvPyBsmMMlIQvvLeoBbdg6MZU2B0Ud0yB6kZ vw2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786886140; x=1787490940; 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=pv2jURNhPUK2tV76gyguAJRM2PrSOiDKR10eWUSfOs8=; b=EAQNvWC7uHFvsEBLg81SYbOy+tHOnTqgMZ4htCfBVro39hymfQ6UF0l8un2MwWVqux np6jmGOhxTj+wuw2z5ZVGmifrzNJoAzCg8e7wL6TTQ/UHrcUaIkwASZLMzfUUcJgGPyD NwC7ckvV1mi/gkPj7M3w2Ca+7FbwvbdJ+jWKhUFwrx8x9bf9q5LF7HW3EejxTGpkXcrD TTWCK9m3K5c0gpeRFcWD30YdGTaBMfGIydAA1iaVrBxuYdaR+AE+Ol+GG7SDQ0rbR0fk hzXUodeDfooyo65EXScj9aXTZ4hh6CEqfrDTouSjS8MixfIFWQXRg64xP4EVdQCHQgEk K5xQ== X-Forwarded-Encrypted: i=1; AHgh+RqixiOD0E5pW2Y88Edg0dLD2HkrmsASFP7/Q05DxHPUVR8ykaOAmC5vmH2Yu8SgA9a/+kiIFMLau/fwPEM=@vger.kernel.org X-Gm-Message-State: AOJu0YyjtmzBuSWNkcfi0h9VAW281eFc4bo9TyIWfgjkRsrusaxNUuDV sTf+iwrjlZEsy2AG63Q/+PUPxhEpI8PLcs/8KNlrmV1yHexdO89eJrO5 X-Gm-Gg: AR+sD12KsyRJ/87/dTqTcl6326swcQDo1Xs2OfbW5SIKsEOtoeJuY1NjH4/p/+wp2vz gw/Ma7n/gjItVbEj8xle5ZveS9v5vQdlgEu8kbXgEHaWapncPHpVxmLCgoJvGrX/YpvjsK0zj/s 6dRjbJUwDrxOx0dkqGRFf2hEOf2VozwFhX8iqX/HwQi59cC2rPhoqPkW8plFOh/w3zSrvFXIkDx OiVWA7dOGisNAQ5dt/wFmFdvXaQon97Rlh22dBokI3vxHqPQDdAQaNUQ7FQf/dFdtycI/MbJZhY bNGqvAtlKRVybQnDcncDWfuMcnGEDk4UkZAm7TtuN2zcmsFIMBGtpSlYcsli+VvyoF29T1MGiBG 2i/3bJWj4w84VX6IzMDWwqGrZrxbLPR/p2/WMAOG7eMPKLlF16Gjo6DthPaxP3JNmEZ0BKpKo2k TanqAk0H119tGCVwPmzfZvSnzLJCthy9lAsaUg5rqMGyfg/FWzsw99XpKsDWMFeXXtoTwlv1M2N jc2CYJoFJp1AAcRT+8IKa/d8SUQ23kL+KgAnMkyZyL40VelOZ4QK5ZewRbNXiAZpDFCPHJ04I0e G2uZSVqUiw== X-Received: by 2002:a05:6000:230e:b0:481:60fc:edc6 with SMTP id ffacd0b85a97d-48160fcee5bmr27201126f8f.27.1786886139921; Sun, 16 Aug 2026 06:15:39 -0700 (PDT) Received: from macbook-pro-de-bryan.home ([2a01:e0a:d7f:f4f0:306b:5f99:5378:73e0]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-4815f2cc81csm24721295f8f.34.2026.08.16.06.15.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 16 Aug 2026 06:15:39 -0700 (PDT) From: Bryan Boquel To: axboe@kernel.dk Cc: linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, Bryan Boquel Subject: [PATCH 1/2] blk-mq-dma: fix kernel-doc for integrity DMA iterators Date: Sun, 16 Aug 2026 15:14:55 +0200 Message-Id: <20260816131456.16374-2-boquelbryan6@gmail.com> X-Mailer: git-send-email 2.39.2 (Apple Git-143) In-Reply-To: <20260816131456.16374-1-boquelbryan6@gmail.com> References: <20260816131456.16374-1-boquelbryan6@gmail.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 blk_rq_integrity_dma_map_iter_next() documents a @state parameter it has never had. It takes (req, dma_dev, iter), as declared in include/linux/blk-integrity.h, so scripts/kernel-doc reports an "Excess function parameter 'state' description" warning at block/blk-mq-dma.c:379. The wrapped summary lines of both integrity helpers also indent with tabs directly after "* ", which checkpatch flags as: block/blk-mq-dma.c:320: WARNING: please, no space before tabs block/blk-mq-dma.c:361: WARNING: please, no space before tabs Drop the stale parameter description and use spaces for the alignment; the rendered output is unchanged. No functional change. Both issues were found by running scripts/kernel-doc and scripts/checkpatch.pl over block/, and verified against the prototype in include/linux/blk-integrity.h. Fixes: fec9b16dc555 ("blk-mq-dma: add scatter-less integrity data DMA mapping") Assisted-by: Claude:claude-opus-5 kernel-doc checkpatch Signed-off-by: Bryan Boquel --- block/blk-mq-dma.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/block/blk-mq-dma.c b/block/blk-mq-dma.c index 88fd9cbc951..fca7ac01e73 100644 --- a/block/blk-mq-dma.c +++ b/block/blk-mq-dma.c @@ -317,7 +317,7 @@ EXPORT_SYMBOL(__blk_rq_map_sg); #ifdef CONFIG_BLK_DEV_INTEGRITY /** * blk_rq_integrity_dma_map_iter_start - map the first integrity DMA segment - * for a request + * for a request * @req: request to map * @dma_dev: device to map to * @state: DMA IOVA state @@ -358,10 +358,9 @@ EXPORT_SYMBOL_GPL(blk_rq_integrity_dma_map_iter_start); /** * blk_rq_integrity_dma_map_iter_next - map the next integrity DMA segment for - * a request + * a request * @req: request to map * @dma_dev: device to map to - * @state: DMA IOVA state * @iter: block layer DMA iterator * * Iterate to the next integrity mapping after a previous call to -- 2.39.2 (Apple Git-143)