From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) (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 2D52437FF47 for ; Fri, 19 Jun 2026 11:37:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.48 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1781869022; cv=none; b=cGpU8tIkcouuh8PDPTeAb/LqdcwWGYpz53xdj4ivujU/oS1uGzRKygdkKChHVMnfQscpfJo9/0ofjreODs0ZHR7lYFik3xtJ1bSmtBQsBxuDtGyqnvAAe4HE8Os8rKHK0e5GTgP0UR0B8gAe8jyF/jWVVDkHF2adGKWBFLBCJxo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1781869022; c=relaxed/simple; bh=JPEO11aaCk61b1MyssaBzdmL37sGUcdnybx1cLx2L7E=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=svCH8KNkB9y1qWHJ8h91c6lSXhJ9X4LZpwOeQAmeqAzm+Xy6RRpQwJmOlV6xt9KNd5tpfWZgM+cQ92fWdKtswKKScoqFaOO8VXyJM5Z3OMSLMO7f0vtBU2gt0SjGSKvzfK/1zo+RSw3jRhaZLzSyIAdwux1H8MQJbkE4oMTuNcY= 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=qsjJkNHN; arc=none smtp.client-ip=209.85.221.48 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="qsjJkNHN" Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-4631679f204so1471173f8f.0 for ; Fri, 19 Jun 2026 04:37:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1781869020; x=1782473820; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=OOnLthBK1ZaLDe8IBLdmwVbR76i2jOQdkD1UWnvKsDI=; b=qsjJkNHNnrARej7Y3c1XiNmeGSShsx0Bk1czblryLrFO0UxwN5+dQbBc69LFDcIFNP dHGW/OuE7Lh1Zr6sNvYlXbRbOqGQtgPLYHCZK4Aw6ZiTkQA8SHCot/RGXFkMCruGn6Eu f07EtOIfThWzlhDX7PLPtQgrraAphbMrCfw8TlnAgLu6y87atAcRnj0SWKKPMJJLpdvj CdAPkVtq4RI+GWwM+3eoB/45Mbtbb8Jid0ad/RZNCJ42e/PdPlhXB+7Sw/mERO28Zm5v tY70QeVNPVlOwo/dytw+7/nbas/Xvp6Ycp5kyiUmODU5FATtKLaEQhk1FwUEmCK7P0H7 rimA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1781869020; x=1782473820; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=OOnLthBK1ZaLDe8IBLdmwVbR76i2jOQdkD1UWnvKsDI=; b=GTGaalXbrI12eGJoIlIT0syR1eXNJ0CIPGyke7PplSel5SBZ2yEQctgCj5IEDtOlTP q46OpyAVxNI/hStt/mCVxnJIARi0sxzLn01YLjnHN6Q8slvtHgNrp60cIYfTpJrEjl6X IKeCvyc5fu3ANLzeORUjEIROnXbVnF7X3YBG/B9R35m/R5V5jM8zFKLkcElDq6svDXai /yxhCUI4j9REPHgwdm9Bgbk5pjOZ3hKJ+OxcVCh8kNdhnBDJkhAnqJcKmCUWZx9boFSL 01y4Utt3xRsboYxZvwb52GiTYu1W+RtONCMluwWNLWVIDQcglXtQe5v78tbC9wZAIEhi /Fiw== X-Forwarded-Encrypted: i=1; AFNElJ8tiuaBjsfrGW8pw4TGxTVjqIO//hVP3v+985h7+eHFSwqcy5+K5g8/IAaugDRF7qDGEmkeCytgnADQn9M=@vger.kernel.org X-Gm-Message-State: AOJu0YyaOZR9ofrRPGjB7QKYV/Me1PoWWmkcJc5aFHF8T54/LsDjW74O mNSt9Vslwcj+x5a8UBmzvMuuFm4l0Kqq2sYSjw30Xsz1VmJq5psmTJs= X-Gm-Gg: AfdE7ckM+vS7d7dUz6Z4fr9Q75ASBzj6IPUXd3TsXwM+p0fSoEGYmGBEn5WtI1jiRot 9NQK72Ng25JUnfjpCxP572FGk/lad5QMnupnoLiPLnOFjiSqtbiuoO3T4kNrOlXCNFReyBZBZ/Y ce5Bxs+4NY99NCpMeC/nECnGvsr9Mod165om72OdL8NHDZWoHUPr3MqkMAaLPfgIno8+X0uYvUI w0O+ARtNmGH1upS676JAQILVt7TN9nbs9IO++Q5jvULhx/naIlYXkUAryXSUlToKsXclPu89Sfu VNfLRN40f+w5j3MTx8Ko+yRwyP7k3EVjIShWDYh4obsKOCmvDsK6ENRAI4H5J6G8yaXYl4mj6+y FuWo4krM3nS2g4tIy2+R1q+4IlL62DTXzvsENzb+5zwSHdIstRfFDYbR+Ea8tTf5mINw8/8Fxym pkoMZgtuDdsKS/uwBr2Qk144mp7ezqKqXVL1ww1f1JvyKqGLnBr89Sya2066Pf7mJdyB96vcZeP Ibq7tDIzG4AH2WkwQvICLycl8IavOlMKXLj24XFFP0= X-Received: by 2002:a05:600c:5010:b0:490:e19b:9632 with SMTP id 5b1f17b1804b1-49240a59ademr40537095e9.17.1781869019472; Fri, 19 Jun 2026 04:36:59 -0700 (PDT) Received: from archtop.localdomain (92-242-249-25.broadband.mtnet.hr. [92.242.249.25]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49240efc160sm50419445e9.2.2026.06.19.04.36.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 19 Jun 2026 04:36:59 -0700 (PDT) From: Jakov Novak To: linux-mm@kvack.org, linux-kernel@vger.kernel.org Cc: Vlastimil Babka , Harry Yoo , Andrew Morton , Hao Li , Christoph Lameter , David Rientjes , Roman Gushchin , linux-kernel-mentees@lists.linux.dev, Shuah Khan , Jakov Novak Subject: [PATCH] Docs/mm: fix documentation warning for GFP parameter in kmalloc_obj, kmalloc_objs and kmalloc_flex Date: Fri, 19 Jun 2026 13:36:22 +0200 Message-ID: <20260619113622.11712-1-jakovnovak30@gmail.com> X-Mailer: git-send-email 2.54.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Compiling the documentation currently gives the errors: WARNING: ./include/linux/slab.h:1100 Excess function parameter 'GFP' description in 'kmalloc_obj' WARNING: ./include/linux/slab.h:1112 Excess function parameter 'GFP' description in 'kmalloc_objs' WARNING: ./include/linux/slab.h:1127 Excess function parameter 'GFP' description in 'kmalloc_flex' WARNING: ./include/linux/slab.h:1100 Excess function parameter 'GFP' description in 'kmalloc_obj' WARNING: ./include/linux/slab.h:1112 Excess function parameter 'GFP' description in 'kmalloc_objs' WARNING: ./include/linux/slab.h:1127 Excess function parameter 'GFP' description in 'kmalloc_flex' This effectively omits the GFP parameter from the current kernel documentation. This patch marks the "..." parameter with the previous description of the GFP parameter along with an "optional" tag in parantheses. Signed-off-by: Jakov Novak --- include/linux/slab.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/include/linux/slab.h b/include/linux/slab.h index d4a873a16289..ee952784a150 100644 --- a/include/linux/slab.h +++ b/include/linux/slab.h @@ -1093,7 +1093,7 @@ void *kmalloc_nolock(size_t size, gfp_t gfp_flags, int node); /** * kmalloc_obj - Allocate a single instance of the given type * @VAR_OR_TYPE: Variable or type to allocate. - * @GFP: GFP flags for the allocation. + * @...: GFP flags for the allocation (optional). * * Returns: newly allocated pointer to a @VAR_OR_TYPE on success, or NULL * on failure. @@ -1105,7 +1105,7 @@ void *kmalloc_nolock(size_t size, gfp_t gfp_flags, int node); * kmalloc_objs - Allocate an array of the given type * @VAR_OR_TYPE: Variable or type to allocate an array of. * @COUNT: How many elements in the array. - * @GFP: GFP flags for the allocation. + * @...: GFP flags for the allocation (optional). * * Returns: newly allocated pointer to array of @VAR_OR_TYPE on success, * or NULL on failure. @@ -1118,7 +1118,7 @@ void *kmalloc_nolock(size_t size, gfp_t gfp_flags, int node); * @VAR_OR_TYPE: Variable or type to allocate (with its flex array). * @FAM: The name of the flexible array member of the structure. * @COUNT: How many flexible array member elements are desired. - * @GFP: GFP flags for the allocation. + * @...: GFP flags for the allocation (optional). * * Returns: newly allocated pointer to @VAR_OR_TYPE on success, NULL on * failure. If @FAM has been annotated with __counted_by(), the allocation -- 2.54.0