From mboxrd@z Thu Jan 1 00:00:00 1970 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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id D8A81C5B552 for ; Tue, 10 Jun 2025 09:22:02 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6BAD06B008A; Tue, 10 Jun 2025 05:22:02 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 66B336B008C; Tue, 10 Jun 2025 05:22:02 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 559D66B0092; Tue, 10 Jun 2025 05:22:02 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 377F76B008A for ; Tue, 10 Jun 2025 05:22:02 -0400 (EDT) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id F14411A1656 for ; Tue, 10 Jun 2025 09:22:01 +0000 (UTC) X-FDA: 83538949242.10.75C3637 Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) by imf26.hostedemail.com (Postfix) with ESMTP id 00F3A14000D for ; Tue, 10 Jun 2025 09:21:59 +0000 (UTC) Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=BqBedo2t; spf=pass (imf26.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.180 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1749547320; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:references:dkim-signature; bh=OKdiPD8LPOSWcxJtXxV50FsYXO8RX5/fbpx4WTe18gg=; b=K+FDE5eGZPJGdL+dtXfAafC9G54b5qTP85QpUSC1tHPvLPqhJd90+6k6NIjmNbSH5R6fgc odxTFfGpHY+7p3cWrWfKeVuWwJJ/8Hl49iYXG8DzJvbfHoxw+FsAIHg3sdhHoOqNiMc/Jt rTvt/so0aMZah2DjlkZ/GUpDNTxdXSQ= ARC-Authentication-Results: i=1; imf26.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=BqBedo2t; spf=pass (imf26.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.180 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1749547320; a=rsa-sha256; cv=none; b=sBU5tPKeqdj3aYOnAYnjCjhy/EjqxeqyW0Oi7PWsteGor5bGlPrwaITRNzehB1PAGMWKdJ 4UVYRCNU0TQTfbmdBRy96ApbkET/UDGBM+fS/5uApHSZz7qVovXJ0wF4+kafn2ghEVc7ii 6YlnpMCxxLGWsayF6RNMcVZQYJfg4x4= Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-235f9e87f78so47384935ad.2 for ; Tue, 10 Jun 2025 02:21:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1749547319; x=1750152119; darn=kvack.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=OKdiPD8LPOSWcxJtXxV50FsYXO8RX5/fbpx4WTe18gg=; b=BqBedo2t+EuLFg1mwMknmhJlL3W1sXvuLjIR4IbLvb9DLfqQMl3rmankjjE+9xEb9x S0dMOvWKcQ5mRv9/s5SwTIwGh8FDGCldh+dfKVRHTc0+sNwkftF3eFJGH9LgTUAQjw5T GNrbb2Ibtc15pU/mGsJnp9XDdUt0iEdqzpH0BVp4inIzOv2iOC2xi9O+Vo4PDjRHZ1Pc UyzJzDpXa6RRKXsfxJoKU705VlRIHj3jYAsAqWZUgvZ2hEiwEwDRWvWVt58mICHKozUj qYC6TymrQWuMs3ua5TyyRwIti6nDmP+oZmwmO/h/4gUL5N4IzIfJWeEuSCEcrBeGZ88D pE6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1749547319; x=1750152119; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=OKdiPD8LPOSWcxJtXxV50FsYXO8RX5/fbpx4WTe18gg=; b=thrNnNZn6yv3BptATtBqXOvf6mkouFUp6vWLrQbZvQTUYx4kbTN1hQ0RAgGMYVBft4 lt5XKNOk9A9KlWuBL0cZVeWsNwlXDEeg13Ab9jN8p1wRcSxJeqpzfbf4aSVDKZIn19hK lPhBa8DtPav5PyVM8c9ONi1Xeyhz/V0lNeUYHPNWaKE3UPj0Ht30+VCIccUnjxDUUKFu 7NSi8ZmAH/8UpgJmDwFuic7rKl4L90hfMlLF0ZU9QuovgGov/OQwQXkj2FHWdb47S2Oo tumgSW702mIxG/bdtbiQ6tGMdhLBhuEauzLWA2dn0KF3PQ1N2K8ZlvdeRF0yXmjnQ5zB WEpw== X-Forwarded-Encrypted: i=1; AJvYcCW0DxgIzM2MmBldo7ia7GZr6W4cKuTM08haz+J6h1+PZ6hPaGPDwd6RR5E1baTDkoDhrqN3pP+RNA==@kvack.org X-Gm-Message-State: AOJu0YwYE+DfPC9Hpbhah1ECk8OtJ77kOkc6xzuTRAep3JxkpeWWOS1s dSjnBp7dcp0gxHbLsk3kbloY0RB4n6wPOhKOe3k+ut691WeHKHnE+H0l X-Gm-Gg: ASbGncuo3G4rtPRLOvBA+T6AbxMaVG4+lg/KsXHHOqAjTCfvawTGV8OqvanHd19WbGx J4oygw83hADF8QaV8MveiaUDqht6+EKUlON29Favpo4sScf84cksEnSYxM4Dicg4CdiWyCV995v yJFlwp5Mh9R41LsTqoB0Hf8fVN/y43D7GaAX0w3pHHL8jaE6ml10Odto9zKW6cMn87pblxv8Lnh 3fAcltVxXRTExnUgzfd5Zfeb5CzVl+puyit1GjnvV+K3Wcx3cK1zM9N7WLZkI7gjdnArPpXsdW3 iQgFGZmnRE2VwjPw0EMmzt8R/77zJmwFTekNP8JIfWprtnt29h2Wwkn86nLf1J96BkjdR+JE X-Google-Smtp-Source: AGHT+IF8W/u2pc9dXw02ODQ85GE5l7TzGkPD+fTzj71XXSkR/6My/iTxaFj+tl0NDcLeascIkNg8Ww== X-Received: by 2002:a17:902:ec87:b0:235:2403:77b6 with SMTP id d9443c01a7336-23601d702afmr223840085ad.37.1749547318680; Tue, 10 Jun 2025 02:21:58 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-236032fcd1fsm66749495ad.118.2025.06.10.02.21.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 10 Jun 2025 02:21:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 8A39F4209E8C; Tue, 10 Jun 2025 16:21:55 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Memory Management List Cc: Feng Tang , Christoph Lameter , David Rientjes , Andrew Morton , Vlastimil Babka , Roman Gushchin , Harry Yoo , Danilo Krummrich , Bagas Sanjaya Subject: [PATCH] mm: slub: Wrap krealloc() __GFP_ZERO semantics diagram in literal code block Date: Tue, 10 Jun 2025 16:21:53 +0700 Message-ID: <20250610092153.55093-1-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1586; i=bagasdotme@gmail.com; h=from:subject; bh=y1mzetlCTQRwwVQd0XCZePhA+fRudsnAmGM3LW4Q1OI=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBnuP55sm3t/otz94PsBV6S4ysSEFrmy9s2QWvNjgtiW1 Du7OGT8O0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjARu7+MDK8/KgqIufmUfUxU YdvTM6lXs5fvrcSXWf9+m7bend20fBPD//xJUzs/t7Dwej49vmj3v4P6NybJte8+4fVxyZRX8T2 vn7ABAA== X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: 8bit X-Stat-Signature: f5ijpixm4c6ty8pmguo389sa3noss3fg X-Rspamd-Queue-Id: 00F3A14000D X-Rspam-User: X-Rspamd-Server: rspam02 X-HE-Tag: 1749547319-168978 X-HE-Meta: U2FsdGVkX18rosXKREpGd76+bpjKVJsMH1lXFbAPEQq08XsdHfS0fMWdmfbG+OLo+uhGCgghLxViDAJR4GvZd1toVF+n4BF+HjtmdS+jEZXFYTn76Lo1QgG8ceqyTvGkpTR8hYjzeLrb1eAxv0aa3NS7orlp5f/TPuHoKg6jKiNE24ZZpfCwa8mIiuO5j+ynpuparg5N5XC6QUTBhA1YqMsETKo4OAxXhP92RBC4QCJCZOyOHiGrw65MiNjzEmMlXToYy6psstow1cLs+r+FapO75973oGXO2uIJhz4U6o1V8arKg0jy7dM4Qm+d00ymwqf+H7MiU4mjQA4zEuVeiDyQaPs7oh0XZACkU7wmCidNzu91BPD3OupCiZISv2Ilx44wah8Q6yvKny0sKjEarnGTtgyJXJ8uHhUh4ScysTzj8OxV6AuXEiur/yD7/Dfgt/1sNL9ckRv9JnJlrlV5iStLv+iSexqmTJGXcoAWPc8VXgXi+zrbpql3YegNoZqqIXDRG8h8SNYMXxJVm014tFC0iiNWuB5St0I7MBRWrgPhHsqQ402KAriJLUzo8tLVCInF+hC0N+qcB8CwpDAJSRpnLi5Kn6SwF2M4YAINHk9BcfzCHgkAWU5IGUZLNkiiK3pyFXY+2UiCprtSkJ/E25LDeBwHs0KSFOQquh4Bc76lcByElvYY2dOM+32enp5kV4eXzh2EPH5PsIGDfLOB0qusE672US5xykbhsrbU5V8K+B46qCXxOumgrYrnIfWvah2reETmHQUOkaiqy53ZAYcUetwgqp+id6RTtEcwfZwgztVvInL+TX+lcIPGCTWmQFNGBFPSzO7unie/BO3zGZJTH/Xiu9Y6CrStSqlw2sYFn4YZwAI1vrqaLtJ27BoiwRBDDcbRJHbd7vMjpZjEUHVsCZCFNlwLEyns2yc2o/H/Z1K0FMsnDzlgpc6TxTO/DmdoOtnUFYMe+U8ZQSm 1Pml4q3J swWEjvMu+eHqQUNcfXbxUo4u/Q9UddCIu60nbC5kzzhdI00Mt0y9syXudWG1trz7pceTl1MkRvCI7GS3pZ1hpIUyWLS+wiCo13YJULhYlEW3tjScL2USaN3e9UZk6mUFRZnWV2pkLwv3MtxkG2plZca/INtmyxYIpOeVwju5FMbCaYrDzTWennkD7sGjJXgnfKPL0b7UHJ0PftoBcVcUwXFzPPdm3TKEDQsnCZaMkJzM/DDDQ7k20E7MaSuwKoyz+MM6aT/pzvfdUQRS4WoKS1wlMSXh+X6wnhwd9G2ka5lPjCVU1+sVh2T13oLr1o5c4lvifuejFOlBCm3e5+oboJpO/ukDr1GYWw1g9zbIUNm7FOkgIq756s4UYpPWzovbRlc/AUkFpCzyzVSV5X+4wi5oeDs5A99pS4KIB3679+KKz4Qk= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Sphinx reports htmldocs warnings: Documentation/core-api/mm-api:40: ./mm/slub.c:4936: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils] Documentation/core-api/mm-api:40: ./mm/slub.c:4936: ERROR: Undefined substitution referenced: "--------". [docutils] Fix the warning by wrapping krealloc() semantics diagram for __GFP_ZERO in literal code block. Fixes: 489a744e5fb1 ("mm: krealloc: clarify valid usage of __GFP_ZERO") Signed-off-by: Bagas Sanjaya --- mm/slub.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/mm/slub.c b/mm/slub.c index 31e11ef256f90a..45a963e363d32b 100644 --- a/mm/slub.c +++ b/mm/slub.c @@ -4930,12 +4930,12 @@ __do_krealloc(const void *p, size_t new_size, gfp_t flags) * When slub_debug_orig_size() is off, krealloc() only knows about the bucket * size of an allocation (but not the exact size it was allocated with) and * hence implements the following semantics for shrinking and growing buffers - * with __GFP_ZERO. + * with __GFP_ZERO:: * - * new bucket - * 0 size size - * |--------|----------------| - * | keep | zero | + * new bucket + * 0 size size + * |--------|----------------| + * | keep | zero | * * Otherwise, the original allocation size 'orig_size' could be used to * precisely clear the requested size, and the new size will also be stored -- An old man doll... just what I always wanted! - Clara