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 57670C5B552 for ; Mon, 9 Jun 2025 12:13:11 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D55126B0089; Mon, 9 Jun 2025 08:13:10 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id D2CB96B008C; Mon, 9 Jun 2025 08:13:10 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id C1B356B0092; Mon, 9 Jun 2025 08:13:10 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id A19256B0089 for ; Mon, 9 Jun 2025 08:13:10 -0400 (EDT) Received: from smtpin26.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 2D1C2121AEF for ; Mon, 9 Jun 2025 12:13:10 +0000 (UTC) X-FDA: 83535751740.26.B1F12AD Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.223.130]) by imf29.hostedemail.com (Postfix) with ESMTP id A6E19120009 for ; Mon, 9 Jun 2025 12:13:06 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=BtIuC04U; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=aCS139s1; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=BtIuC04U; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=aCS139s1; dmarc=none; spf=pass (imf29.hostedemail.com: domain of vbabka@suse.cz designates 195.135.223.130 as permitted sender) smtp.mailfrom=vbabka@suse.cz ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1749471187; a=rsa-sha256; cv=none; b=gWzHpLsOZEkQnLOmdgfzw2VhAHxVka2ceG+NKxAmYKKSlylSmiFSqUG41gjazJYrV5r/qy +EN5LAoCG2R8TjkJq2VOl7InbiKnosRhAf34s4XQNpUN2JVrHnn0rZBxd9/UOTYcLe7ran 3Li19aWkcizpsW0UENZrMbjQFzr3/Ww= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=BtIuC04U; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=aCS139s1; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=BtIuC04U; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=aCS139s1; dmarc=none; spf=pass (imf29.hostedemail.com: domain of vbabka@suse.cz designates 195.135.223.130 as permitted sender) smtp.mailfrom=vbabka@suse.cz ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1749471187; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=4ZXGDJ/49sKdu19+kzOaaREck7DBWcDd7XfYROgzk34=; b=3Bq3FYsAKrA6osruXbzzmQsi/VSXW6c7JUMhdi29p2AzUVxasQCapqP0UkeULdqVCYhuJQ 9Rwc+ftzTktP7qHSoZDieU2Fcvpn5RJt7hebsmpvdeizflNl2vbvb82EBC1z5o2NPY+A45 DR9rFImfK3+DxlDzKH8m4hhjBS5NH8A= Received: from imap1.dmz-prg2.suse.org (imap1.dmz-prg2.suse.org [IPv6:2a07:de40:b281:104:10:150:64:97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 01A5121184; Mon, 9 Jun 2025 12:13:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1749471185; h=from:from:reply-to: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:autocrypt:autocrypt; bh=4ZXGDJ/49sKdu19+kzOaaREck7DBWcDd7XfYROgzk34=; b=BtIuC04Uss3Pu56ERsScriSuK0Y4eDcQon3ZWG9fQ3+0FFFSj885nzXSr6jPOP1MgHQGxw anfZIrUM5F05W8ZPg4NPj6UEWiLk7GLkzkk0AzmRYmgGDKk7nREPHjvBfBCSIHl/jktPsS uOqwI+XLDPytp84hvcWihjzp1UlKpQA= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1749471185; h=from:from:reply-to: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:autocrypt:autocrypt; bh=4ZXGDJ/49sKdu19+kzOaaREck7DBWcDd7XfYROgzk34=; b=aCS139s1IZS4qzgsrssLXQTVDd8ZUHlEzxcpONZ+Idf+ABa4SNSnNlsuDi1dZsZWchk+3w mXM8bSW8z1A7/SCg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1749471185; h=from:from:reply-to: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:autocrypt:autocrypt; bh=4ZXGDJ/49sKdu19+kzOaaREck7DBWcDd7XfYROgzk34=; b=BtIuC04Uss3Pu56ERsScriSuK0Y4eDcQon3ZWG9fQ3+0FFFSj885nzXSr6jPOP1MgHQGxw anfZIrUM5F05W8ZPg4NPj6UEWiLk7GLkzkk0AzmRYmgGDKk7nREPHjvBfBCSIHl/jktPsS uOqwI+XLDPytp84hvcWihjzp1UlKpQA= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1749471185; h=from:from:reply-to: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:autocrypt:autocrypt; bh=4ZXGDJ/49sKdu19+kzOaaREck7DBWcDd7XfYROgzk34=; b=aCS139s1IZS4qzgsrssLXQTVDd8ZUHlEzxcpONZ+Idf+ABa4SNSnNlsuDi1dZsZWchk+3w mXM8bSW8z1A7/SCg== Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id E04E813A1D; Mon, 9 Jun 2025 12:13:04 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id y2t3NtDPRmjvSAAAD6G6ig (envelope-from ); Mon, 09 Jun 2025 12:13:04 +0000 Message-ID: <1b913c17-c104-4eec-831e-32814a034739@suse.cz> Date: Mon, 9 Jun 2025 14:13:04 +0200 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 01/10] doc: Move SLUB documentation to the admin guide Content-Language: en-US To: "Matthew Wilcox (Oracle)" Cc: Christoph Lameter , David Rientjes , linux-mm@kvack.org, Harry Yoo References: <20250606222214.1395799-1-willy@infradead.org> <20250606222214.1395799-2-willy@infradead.org> From: Vlastimil Babka Autocrypt: addr=vbabka@suse.cz; keydata= xsFNBFZdmxYBEADsw/SiUSjB0dM+vSh95UkgcHjzEVBlby/Fg+g42O7LAEkCYXi/vvq31JTB KxRWDHX0R2tgpFDXHnzZcQywawu8eSq0LxzxFNYMvtB7sV1pxYwej2qx9B75qW2plBs+7+YB 87tMFA+u+L4Z5xAzIimfLD5EKC56kJ1CsXlM8S/LHcmdD9Ctkn3trYDNnat0eoAcfPIP2OZ+ 9oe9IF/R28zmh0ifLXyJQQz5ofdj4bPf8ecEW0rhcqHfTD8k4yK0xxt3xW+6Exqp9n9bydiy tcSAw/TahjW6yrA+6JhSBv1v2tIm+itQc073zjSX8OFL51qQVzRFr7H2UQG33lw2QrvHRXqD Ot7ViKam7v0Ho9wEWiQOOZlHItOOXFphWb2yq3nzrKe45oWoSgkxKb97MVsQ+q2SYjJRBBH4 8qKhphADYxkIP6yut/eaj9ImvRUZZRi0DTc8xfnvHGTjKbJzC2xpFcY0DQbZzuwsIZ8OPJCc LM4S7mT25NE5kUTG/TKQCk922vRdGVMoLA7dIQrgXnRXtyT61sg8PG4wcfOnuWf8577aXP1x 6mzw3/jh3F+oSBHb/GcLC7mvWreJifUL2gEdssGfXhGWBo6zLS3qhgtwjay0Jl+kza1lo+Cv BB2T79D4WGdDuVa4eOrQ02TxqGN7G0Biz5ZLRSFzQSQwLn8fbwARAQABzSBWbGFzdGltaWwg QmFia2EgPHZiYWJrYUBzdXNlLmN6PsLBlAQTAQoAPgIbAwULCQgHAwUVCgkICwUWAgMBAAIe AQIXgBYhBKlA1DSZLC6OmRA9UCJPp+fMgqZkBQJnyBr8BQka0IFQAAoJECJPp+fMgqZkqmMQ AIbGN95ptUMUvo6aAdhxaOCHXp1DfIBuIOK/zpx8ylY4pOwu3GRe4dQ8u4XS9gaZ96Gj4bC+ jwWcSmn+TjtKW3rH1dRKopvC07tSJIGGVyw7ieV/5cbFffA8NL0ILowzVg8w1ipnz1VTkWDr 2zcfslxJsJ6vhXw5/npcY0ldeC1E8f6UUoa4eyoskd70vO0wOAoGd02ZkJoox3F5ODM0kjHu Y97VLOa3GG66lh+ZEelVZEujHfKceCw9G3PMvEzyLFbXvSOigZQMdKzQ8D/OChwqig8wFBmV QCPS4yDdmZP3oeDHRjJ9jvMUKoYODiNKsl2F+xXwyRM2qoKRqFlhCn4usVd1+wmv9iLV8nPs 2Db1ZIa49fJet3Sk3PN4bV1rAPuWvtbuTBN39Q/6MgkLTYHb84HyFKw14Rqe5YorrBLbF3rl M51Dpf6Egu1yTJDHCTEwePWug4XI11FT8lK0LNnHNpbhTCYRjX73iWOnFraJNcURld1jL1nV r/LRD+/e2gNtSTPK0Qkon6HcOBZnxRoqtazTU6YQRmGlT0v+rukj/cn5sToYibWLn+RoV1CE Qj6tApOiHBkpEsCzHGu+iDQ1WT0Idtdynst738f/uCeCMkdRu4WMZjteQaqvARFwCy3P/jpK uvzMtves5HvZw33ZwOtMCgbpce00DaET4y/UzsBNBFsZNTUBCACfQfpSsWJZyi+SHoRdVyX5 J6rI7okc4+b571a7RXD5UhS9dlVRVVAtrU9ANSLqPTQKGVxHrqD39XSw8hxK61pw8p90pg4G /N3iuWEvyt+t0SxDDkClnGsDyRhlUyEWYFEoBrrCizbmahOUwqkJbNMfzj5Y7n7OIJOxNRkB IBOjPdF26dMP69BwePQao1M8Acrrex9sAHYjQGyVmReRjVEtv9iG4DoTsnIR3amKVk6si4Ea X/mrapJqSCcBUVYUFH8M7bsm4CSxier5ofy8jTEa/CfvkqpKThTMCQPNZKY7hke5qEq1CBk2 wxhX48ZrJEFf1v3NuV3OimgsF2odzieNABEBAAHCwXwEGAEKACYCGwwWIQSpQNQ0mSwujpkQ PVAiT6fnzIKmZAUCZ8gcVAUJFhTonwAKCRAiT6fnzIKmZLY8D/9uo3Ut9yi2YCuASWxr7QQZ lJCViArjymbxYB5NdOeC50/0gnhK4pgdHlE2MdwF6o34x7TPFGpjNFvycZqccSQPJ/gibwNA zx3q9vJT4Vw+YbiyS53iSBLXMweeVV1Jd9IjAoL+EqB0cbxoFXvnjkvP1foiiF5r73jCd4PR rD+GoX5BZ7AZmFYmuJYBm28STM2NA6LhT0X+2su16f/HtummENKcMwom0hNu3MBNPUOrujtW khQrWcJNAAsy4yMoJ2Lw51T/5X5Hc7jQ9da9fyqu+phqlVtn70qpPvgWy4HRhr25fCAEXZDp xG4RNmTm+pqorHOqhBkI7wA7P/nyPo7ZEc3L+ZkQ37u0nlOyrjbNUniPGxPxv1imVq8IyycG AN5FaFxtiELK22gvudghLJaDiRBhn8/AhXc642/Z/yIpizE2xG4KU4AXzb6C+o7LX/WmmsWP Ly6jamSg6tvrdo4/e87lUedEqCtrp2o1xpn5zongf6cQkaLZKQcBQnPmgHO5OG8+50u88D9I rywqgzTUhHFKKF6/9L/lYtrNcHU8Z6Y4Ju/MLUiNYkmtrGIMnkjKCiRqlRrZE/v5YFHbayRD dJKXobXTtCBYpLJM4ZYRpGZXne/FAtWNe4KbNJJqxMvrTOrnIatPj8NhBVI0RSJRsbilh6TE m6M14QORSWTLRg== In-Reply-To: <20250606222214.1395799-2-willy@infradead.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspamd-Action: no action X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: A6E19120009 X-Stat-Signature: ikttospqx3w8wfyy5yomyts4gqhgcdj9 X-Rspam-User: X-HE-Tag: 1749471186-902984 X-HE-Meta: U2FsdGVkX19mgFRALDdTNqBLNikcSNwPM4eXq04EjJxyc5y7OKc2tTkTsgXewbKI50YbS3yFSZSlkogP6QJZtFjrNyvaZ3wxeRuhgrNVsExcTtXJDLQnpON7WZj3JZnQOJQ/RZNaPi5/3njKOxzwcTsJfKpqcwWBa3F2yii8aOrYzus0R8g2I4faHKVZxuroZeNBhMmTYbwYSQuWDzfUcdoqlNusLe+sTTR3M4vJ/ebzk0OZc2QoGBI8ul3/gfz+SXJAaEVFUozl85Y9+en4zdjPyDXAvk1IeWnsYGoN5bbR1tTM7QTA4WId5mqprrylFpraWJVhCET1PSSwTYPVFzA74aa5w9kRgvFiCBOyF6mCtxkyLCw0iGlDdSlfXe+p/gCz7NUdtPoKI1XVdGP2Tiu4nP0MC1c+brOa7DSYiKECm+DQ/IeLrwa1DYUIOoNqYD+Au2+MBSRYbwbBzpfA++j6f6narxE+91VL3M4M40mmSQHseJc1JNNzFKyD6/41aE5ogqo25dRd6CIo+8x6fRTtzNoxYpVmdb0/BJf+bCz4O3cZZhMp9QdI1YCSK7pu2HtXQ4UMg3PzcQvgxXew801uYE99XO04mo0TYf0M4JtcijQBNCgtdR640WvqNu2U7PLmfNTX+D8wUYfYlK5+4kz8Rc6rPpFsqYmW7sbJuvkj5BjATPiDkp4xY/jbwHH36RTtkyDz5eYbjmK/GNgi6/vP446Lkhcra0oU4th+fdiUFmr5HpwgEJ2xgEU6lyKHv5vFZRiCfOxGloK7ThE2CosgpCl6Oz9HG1EsCNzZlxbkEvZfifW/+HWn1eFnDrMH01RKK+EMqPRizFjpKU5PXGUh8uhKlDUyjWIxjYMEOsvV1Y9jYPTS+F5gOznrmZLHJoXc9nf0EXbtsDWqP4EAiV61pOBVlmd5buT/bYf7zqDRyDuJTDSBAHXDmpE0rAmv2rKdW5IdTQr91zEHcul xtLwCWoM VGyk/qfeg0Oz+9WuxKLDtAqLfFtBx43tG8b9BGSQ3ktW+B5xF/1PKheXrkC1dedSxM0904NmEQWxUZdhDa9d4CNrvzA4Q/j7w+QWEnshNNpiET8r4OyqXAZHDTMMhkegRUb74yXr5nA8HmqJN5k9cwPDgAm48g8OrnEqbkPbVGuAd6CLaGKi4YDRewZRBUBC1uLiZLhk7tShRlkyHLWgRDEyNFdOuXacIZODCaON2GVmuGCqaiqmSB4ctNiYYhGjZg+37T299mLdS26vpkU6sXq1K7hpVB60j2MRWOxkF4JUBf1lyik16XIXjZtkfKailrg6Dc5JPimWyjwNchu3y4XT2Bg== 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: On 6/7/25 00:22, Matthew Wilcox (Oracle) wrote: > This section is supposed to be for internal documentation, while the > document is advice for sysadmins. Move it to the appropriate place. > > Signed-off-by: Matthew Wilcox (Oracle) Makes sense. > --- a/Documentation/mm/slub.rst > +++ b/Documentation/admin-guide/mm/slab.rst > @@ -1,10 +1,8 @@ > ========================== > -Short users guide for SLUB > +Short users guide for SLAB Agreed with Harry. We could say "for the slab allocator". Ideally all SLUB references in user-facing text would be removed at some point, but we can get there later. > ========================== > > -The basic philosophy of SLUB is very different from SLAB. SLAB > -requires rebuilding the kernel to activate debug options for all > -slab caches. SLUB always includes full debugging but it is off by default. > +SLUB always includes full debugging but it is off by default. How about: The slab allocator includes full debugging support (when built with CONFIG_SLUB_DEBUG=y) but it is off by default (unless built with CONFIG_SLUB_DEBUG_ON=y). > SLUB can enable debugging only for selected slabs in order to avoid > an impact on overall system performance which may make a bug more > difficult to find. > diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst > index d3ada3e45e10..fb45acba16ac 100644 > --- a/Documentation/mm/index.rst > +++ b/Documentation/mm/index.rst > @@ -56,7 +56,6 @@ documentation, or deleted if it has served its purpose. > page_owner > page_table_check > remap_file_pages > - slub > split_page_table_lock > transhuge > unevictable-lru