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 71E86C5AD49 for ; Fri, 6 Jun 2025 22:22:30 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D03F46B008C; Fri, 6 Jun 2025 18:22:23 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id CB5146B0092; Fri, 6 Jun 2025 18:22:23 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BF2B86B0093; Fri, 6 Jun 2025 18:22:23 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id A17036B008C for ; Fri, 6 Jun 2025 18:22:23 -0400 (EDT) Received: from smtpin23.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 5C57D1CF9A6 for ; Fri, 6 Jun 2025 22:22:23 +0000 (UTC) X-FDA: 83526400566.23.1E11453 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf29.hostedemail.com (Postfix) with ESMTP id BBD30120009 for ; Fri, 6 Jun 2025 22:22:21 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b="RctX/Mqe"; dmarc=none; spf=none (imf29.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1749248541; 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:in-reply-to:references:references:dkim-signature; bh=gdEgl3iboK0/jKu9dipDWQUpvdyARVlaKny29HdwpoI=; b=dmeWerzl5XkTvkRhvLIxEsPumqgO+61EgAZm4evmQKHPdCSfDtr45z1fFIJFy1al+rPu4e yNxNLp3n23cP1fTujR+vV0ydvIPzYoX879dWT912KKL6bJ2uDROtBr6BvH/jJXMd+/q42f xdB7IJotOYVNA6jxOcifpO8mpsrsRls= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b="RctX/Mqe"; dmarc=none; spf=none (imf29.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1749248541; a=rsa-sha256; cv=none; b=xV2s2QVii45M89SCKNFka7dd1yVUWuF8flDyDF2/6LyVQCVnuqVm2VFRVvSvfNbFgjQW7L rgHOFVALnlHYvNYd/nCF+cXO6yoD4oZaQHHuQD8c7jk2n2AzZRk821mqNTxF/QG6xmELN0 q3zX/aPtaDZ/IdA5ubaMW8LC9gqqOpU= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=gdEgl3iboK0/jKu9dipDWQUpvdyARVlaKny29HdwpoI=; b=RctX/MqenigmxcjbE/cgbe2gW/ fPzgzu7l505zlq2sdFxCh37SJ2ZP0SIcIOSZa9FQmiVbZX3Mcdk+r40y66FMDFRJLnV6NneQ72YQ8 Ltt2v6qD3cbqPkrZnAsRUgAPZhtseseY4oPuxiAkgn/mir6RwsIZMMNNdLW8wSz7DXSorAarYtKl2 MCrwBv8rZJ5WWBCAkh8d+V4o0Q2UpedWbXDvMxQ5nerV1EZDe1IY2YK6vmjqhzQg+QZ6FBf//ojll vxmqfQgFPeSNMcVlCa/TPbtVcCsk0VPU3RFUV4bCVmGut4MbQaupDfuYgSzIBfomomN6WQpNsQTFf sTf+GfcA==; Received: from willy by casper.infradead.org with local (Exim 4.98.2 #2 (Red Hat Linux)) id 1uNfS4-00000005r7G-35pX; Fri, 06 Jun 2025 22:22:16 +0000 From: "Matthew Wilcox (Oracle)" To: Vlastimil Babka Cc: "Matthew Wilcox (Oracle)" , Christoph Lameter , David Rientjes , linux-mm@kvack.org Subject: [PATCH 01/10] doc: Move SLUB documentation to the admin guide Date: Fri, 6 Jun 2025 23:22:03 +0100 Message-ID: <20250606222214.1395799-2-willy@infradead.org> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250606222214.1395799-1-willy@infradead.org> References: <20250606222214.1395799-1-willy@infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: BBD30120009 X-Stat-Signature: juexnriirf91nkiebnncdgzai6kaoxah X-Rspam-User: X-HE-Tag: 1749248541-675950 X-HE-Meta: U2FsdGVkX1+O+WlRw9h5SxrFkzNT2DPO31UUlD8iRM/RAasPCjaMlnNee5yFkzCE/c8UuCxbFRK6iLUVWhgujrcaZTMLDCd6UBEjyNCighaTPSo//+bUYRp4Qu9+tLD4B5eimrXtk0sN/Wpvj9GALpPht2TC4gXZhaOYFtwYB4tL+YqdHfFm6TZJXVeHfwZBYGFgXqipIOxCj/b+7fEAmFE6woBOK71gCWMm4NIyyugoOf9K2eDAUSXoTGebajUSVOvIRVolN/itvqip+nJTRhj7YkW+rUsUve0HvnNwnlDyNZ5P3VCyWcAc+TTWyLrnnWNHO9NZj/lIpm8YDKaO/7uefk1e/RZX02sdt3KRJjmEUvV++WxIpChw6lDlnpTUxvcPd6iclCrpjMtqExKylTohG4sF0xbJpDsnyzMlwxWBJ/J6xYIryWRXwF4CpVXh65qpIWosh4ESe1wXUFv3Jjj5MdcYdmnEKqtRMt2HntXMXhYQZf1+kArDYADdOgSftwGuqGg2XFFW8ATHdfjggh9sjHshGWvcm+pnwLcc+iUme1XnNGIMrsxjHydCBNUBvzlqKoWsn1nxJE5u75cnxsBVsRV5ir37420xRJTHrygXc9XkW5SAQb2Y7JbYbiWsCbmhPxJsNBFqgWI/+Og6NZU0fiQXjOhSVfEsuU0nqaftQGFNH3Zvu0oXIbrnJ1lIZJ2+HDxTHvUszAipRMoWB6pkX7ahv6/Vm6b19yOVXBjyagN57MACKusmLdrXo5SWJz7Fh4Ck6CHGGo0+b8YvtZSFQVnmvcP9CJZnpPOr0fX2maZPErBHCiODE3+mgxg/FqqRkmP8H6GvyKrEHPagAD/XNBvYdW4P0GeRoj4owoscc53KLFXRmbInRtxKkY7t0MARtQ/cOfcFSzzcWb8WZyzjlzenrGi/eaERhtsZKIFNNR5CcR+YxKw2DswT5BS52SbVgJ4R8lT6pV8E8/y 5FxdfpGC CpisS9g+gG0oYcGRcDHm8OmCodpW8mHEsB84hNqk+Z+hFErm3C9hTTSJ7UioLD4VopYk1XWy1eu0Q0iVEQEOH11aozQ5Q7iOPv6pSRB3yo6DJ13Oac7lTcCajJx5UWHhdzi2ezeQLGdxH/hcH6dg/6ySn0bYycR8dHhl96wO5v7Xu777jLt0OTSQW+NN25P3LDK0MAJTpH1kDYfLY7DNXHhEe97SCVlshGLN8jxYnQPI/rco= 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: 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) --- Documentation/ABI/testing/sysfs-kernel-slab | 4 ++-- Documentation/admin-guide/kernel-parameters.txt | 12 +++++++----- Documentation/admin-guide/mm/index.rst | 1 + .../{mm/slub.rst => admin-guide/mm/slab.rst} | 6 ++---- Documentation/mm/index.rst | 1 - 5 files changed, 12 insertions(+), 12 deletions(-) rename Documentation/{mm/slub.rst => admin-guide/mm/slab.rst} (98%) diff --git a/Documentation/ABI/testing/sysfs-kernel-slab b/Documentation/ABI/testing/sysfs-kernel-slab index 658999be5164..355550edf431 100644 --- a/Documentation/ABI/testing/sysfs-kernel-slab +++ b/Documentation/ABI/testing/sysfs-kernel-slab @@ -37,7 +37,7 @@ Description: The alloc_calls file is read-only and lists the kernel code locations from which allocations for this cache were performed. The alloc_calls file only contains information if debugging is - enabled for that cache (see Documentation/mm/slub.rst). + enabled for that cache (see Documentation/mm/slab.rst). What: /sys/kernel/slab//alloc_fastpath Date: February 2008 @@ -219,7 +219,7 @@ Contact: Pekka Enberg , Description: The free_calls file is read-only and lists the locations of object frees if slab debugging is enabled (see - Documentation/mm/slub.rst). + Documentation/mm/slab.rst). What: /sys/kernel/slab//free_fastpath Date: February 2008 diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt index a3ea40b22fb9..5f530edc4312 100644 --- a/Documentation/admin-guide/kernel-parameters.txt +++ b/Documentation/admin-guide/kernel-parameters.txt @@ -6555,14 +6555,14 @@ slab_debug can create guard zones around objects and may poison objects when not in use. Also tracks the last alloc / free. For more information see - Documentation/mm/slub.rst. + Documentation/admin-guide/mm/slab.rst. (slub_debug legacy name also accepted for now) slab_max_order= [MM] Determines the maximum allowed order for slabs. A high setting may cause OOMs due to memory fragmentation. For more information see - Documentation/mm/slub.rst. + Documentation/admin-guide/mm/slab.rst. (slub_max_order legacy name also accepted for now) slab_merge [MM] @@ -6577,13 +6577,14 @@ the number of objects indicated. The higher the number of objects the smaller the overhead of tracking slabs and the less frequently locks need to be acquired. - For more information see Documentation/mm/slub.rst. + For more information see + Documentation/admin-guide/mm/slab.rst. (slub_min_objects legacy name also accepted for now) slab_min_order= [MM] Determines the minimum page order for slabs. Must be lower or equal to slab_max_order. For more information see - Documentation/mm/slub.rst. + Documentation/admin-guide/mm/slab.rst. (slub_min_order legacy name also accepted for now) slab_nomerge [MM] @@ -6597,7 +6598,8 @@ cache (risks via metadata attacks are mostly unchanged). Debug options disable merging on their own. - For more information see Documentation/mm/slub.rst. + For more information see + Documentation/admin-guide/mm/slab.rst. (slub_nomerge legacy name also accepted for now) slab_strict_numa [MM] diff --git a/Documentation/admin-guide/mm/index.rst b/Documentation/admin-guide/mm/index.rst index 2d2f6c222308..ebc83ca20fdc 100644 --- a/Documentation/admin-guide/mm/index.rst +++ b/Documentation/admin-guide/mm/index.rst @@ -37,6 +37,7 @@ the Linux memory management. numaperf pagemap shrinker_debugfs + slab soft-dirty swap_numa transhuge diff --git a/Documentation/mm/slub.rst b/Documentation/admin-guide/mm/slab.rst similarity index 98% rename from Documentation/mm/slub.rst rename to Documentation/admin-guide/mm/slab.rst index 84ca1dc94e5e..16933b7b3377 100644 --- 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 ========================== -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. 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 -- 2.47.2