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 EC0A6C2D0CD for ; Thu, 15 May 2025 13:35:40 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id DB1096B008A; Thu, 15 May 2025 09:35:31 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id D61F76B0092; Thu, 15 May 2025 09:35:31 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BDB5F6B0093; Thu, 15 May 2025 09:35:31 -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 9A4C96B008A for ; Thu, 15 May 2025 09:35:31 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 720AB14011E for ; Thu, 15 May 2025 13:35:32 +0000 (UTC) X-FDA: 83445239304.06.8391DF6 Received: from mail-qv1-f48.google.com (mail-qv1-f48.google.com [209.85.219.48]) by imf29.hostedemail.com (Postfix) with ESMTP id 9B55F120003 for ; Thu, 15 May 2025 13:35:30 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=H4DOOX92; spf=pass (imf29.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.219.48 as permitted sender) smtp.mailfrom=usamaarif642@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=1747316130; 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=gfI/h6yR5T+QGKNn50rKBkNsg03eRR3EOmEc3H6+img=; b=EvzTaiILgqVn/19EH91/p4Ik1FdvK0OeBK93/e1BBeGn7+Ds3Nkm7MBYuDPh6UG20NJbGK 5lfOGjCRpgtFA/gZ8+YRPyoorHl2pPoiax/lDaaQX4i/yLQOXatrzWlKquXsV1QS5NG+tv I01P8piRAHBc/6eikNrLuyXNz85zspo= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1747316130; a=rsa-sha256; cv=none; b=EqiJiMOMYQw3aGrHBs6mWG2wHACHAEI7fVVeR+446BUOORoMxGrRTypZmeyByhxG1OaB91 VRf1eXMNZXdZIHxkcVGoSr5wBQKUlPg/7jCHEda7xS6hucywAkPkmYrLvzygVl+caoUO30 CgKXGkPE303NUwAmalALjsb/IMM5udI= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=H4DOOX92; spf=pass (imf29.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.219.48 as permitted sender) smtp.mailfrom=usamaarif642@gmail.com; dmarc=pass (policy=none) header.from=gmail.com Received: by mail-qv1-f48.google.com with SMTP id 6a1803df08f44-6f8a954ff6bso4283146d6.0 for ; Thu, 15 May 2025 06:35:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1747316130; x=1747920930; darn=kvack.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; bh=gfI/h6yR5T+QGKNn50rKBkNsg03eRR3EOmEc3H6+img=; b=H4DOOX92PsDVXJduymM9ysnAxtJzvTCT56XokwBbtGfz7ors3V4UQXuwx3VFUwkT5D tlEFiLKFnPvyt8cOxqar1B6h5kmq2lNthV7bTgCQMPq64bg1GSoQmdtpQe9StixDZZEs Ks2siZCJg+TckuAl5a83OR9jDQhbUfqnyRROL2Wpo1RGj597FS19WmwzixC8pEVzd58j SxCGwBXo6T08dXrpVhGJ5BlhtsP2dcaRRkH1XBPgvaxJb585mZ8/zlCF921xtR6gUCjO pX8lkzeeTuPbV+TFJsL9r6UlTK1KKZmp0KlyHws0Ukv5yNmZo3giUs0S73HTUTAJCvUy 0kqA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1747316130; x=1747920930; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=gfI/h6yR5T+QGKNn50rKBkNsg03eRR3EOmEc3H6+img=; b=Oiv0L0/Fi5E4EcSBRHwLPPj45k2wrvnLQC0Nwsy+5/h2NpotKhibrOql89vrhONxYH ablpwgeUUKNcv0pEYB5aWonZ0v3+l7/qXg5xtQ+Dxl54rFdYDpGmaKxqPVuMRRff6NyX A5LXR3PczsqYvloIAqLkCO7vHhfOhky6js5/NaME4e23fvqPH0RsMfJqiKZkMlRQ/791 MaWx4tdqX8HAjgW8bTpAMZPHZxHWDtbqLKdL3TLDJ/GNH0pO/yfNTsfJXebysQ0zGjoA P14sFM/Q4tdyDL6c0CA1Loobefkz0GwNcChoG/gyy/VY23BqfsTdp1mBhKgi13MXlTn9 JVLw== X-Forwarded-Encrypted: i=1; AJvYcCXZpHoMWLymAPPNDTcj5iEeU5DEZtM2gN6EOGiMA2Fbg+5MiVXB8DKkT39914c774xMGebDoP9EeQ==@kvack.org X-Gm-Message-State: AOJu0Yw/LCspiKA/uIXRJKNKp2VziE+YOnWq6fbCMRzKRqJ2VnyRIm3W +CxUAcj2N/gjMZv0Y6m7LDs+/aOtPv0waSfk1YioUzF6DMu/6XuM X-Gm-Gg: ASbGncsQbYmfGGld9v7RI83LZjNwHavLVk7Yu2pKfP2sI11d0xRh/W4b43BtAW2nect AB3EIvzC0D/ya59aruGrq5RPYma39kUOuo/7pAAJRTV4Uq4PlJ3wAg1kLOeVoXxucW4Hz7Uf0ji tN8raj+yDKPUAB5o/xPwRKNGjYNeGhXZz9NyfyHXzh7c7na2ZuG2FU/VKBW3OpsXtuNL9Hjk6aD sZ/DSlU1kV38heUIVAkDX6eJlp7lb5VHKoRiBSwu9jc73Fu2qOxAbK9hHH1RbEA8WxgUPO/foTT phdLgGnDmoOI9G37LGKX2htlWAzoWrVJFLGXeDycXfRNUjQeZA== X-Google-Smtp-Source: AGHT+IFhtYFW+nSu82qMrHlJwUBAof/mWqJdiShQs0Id8daZt5/yurPzdh8is1ilm1548tQsdICvuw== X-Received: by 2002:ad4:5c68:0:b0:6f5:372f:1c5b with SMTP id 6a1803df08f44-6f8a31cba87mr49659226d6.11.1747316129425; Thu, 15 May 2025 06:35:29 -0700 (PDT) Received: from localhost ([2a03:2880:20ff:41::]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6f6eb98e5f8sm75823886d6.45.2025.05.15.06.35.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 15 May 2025 06:35:29 -0700 (PDT) From: Usama Arif To: Andrew Morton , david@redhat.com, linux-mm@kvack.org Cc: hannes@cmpxchg.org, shakeel.butt@linux.dev, riel@surriel.com, ziy@nvidia.com, laoar.shao@gmail.com, baolin.wang@linux.alibaba.com, lorenzo.stoakes@oracle.com, Liam.Howlett@oracle.com, npache@redhat.com, ryan.roberts@arm.com, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, kernel-team@meta.com, Usama Arif Subject: [PATCH 6/6] docs: transhuge: document process level THP controls Date: Thu, 15 May 2025 14:33:35 +0100 Message-ID: <20250515133519.2779639-7-usamaarif642@gmail.com> X-Mailer: git-send-email 2.47.1 In-Reply-To: <20250515133519.2779639-1-usamaarif642@gmail.com> References: <20250515133519.2779639-1-usamaarif642@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Stat-Signature: ufi51b5dtdws33sttg5kjqne5puy4569 X-Rspamd-Queue-Id: 9B55F120003 X-Rspam-User: X-Rspamd-Server: rspam02 X-HE-Tag: 1747316130-803719 X-HE-Meta: U2FsdGVkX1/FdnfwmmEI81dtVGtaK0sNIDpmCfuWz9H6a32KYBYxFAtUMumWoSi3AP5ZhgYfLeU7E5f3HCTTOhlTjGEWBXJDer134nkqIAAsf1oDjfuvx5UlTvPuLGTqu3JedvGY4j90BzmRRpgZ+6BAR0rz6xOngyjqb4bvWW/dTeRn3i6Tw+PDXl9R310lm8n1NpmjHJh6dX0D/AOYGpUdu2/ING7D42sB9Ex1ZKkGeD3blPLxG4G3ocsAnouN7uaORY0P+S6SpDfH/jj9E+YAyg8xC12JFX+HoCLWHn+fsZkeC4Ge14wg4GL1hnQ4f49JaTageh9uCBZB20Dc1zoFJNyAif0qjjg4PWvD61Ty54Jn+Q9f77/2JNYaAcx0pQyQ+6pZWnaZBkbt5LDBQ+6kax2hu4p5LXuk0qARI7gsH7QchIaZ5XDkUaYBaKMXYm4WxqknBxXIX9inN+TjXkrwNm5ZzadQAnXB+M29/N3MTIdEFsyb4h8D31Ak0bgUAaDit01nyrF7l8OKKAJXzZNH9CYFQP8yrwydcWR3XD1RanCGl9T8SxV8mmbncL8oH4GPllnIXajHdVQE6iHeM8cGr+f0OPub4YbE+3oXxhdAYpYTTosPan/G3k7+bpcaJzzTBjV4HbT7vML7wosqgWDpflLwnDRT1ulW/g6h1yNa2taPQQ/deaiuR/dvU/gXJLVohOeh/4kNmePE0T4GXBpj7ENePS76E8kKIwKlkNJiXmpFovfc8Q1JH2qC2vHTaUWJlWUbvdzNg/7/TNZ90Syw9SO3Y4QDRpOMVOKJ0w6YP92VKBauI9GKPjcUwgP5H/fvGzKfZJ+Vs9Ws5V61XBS1ma/3VpmJwfftjluQ3+P7yJsFv4Wvy6NHPSGs8m0wOOp0NXJtIutDAJJgbPjcXToeDwN622IRzzmzz5i60NknNcQRc+eb0FfCNgohjM7xR+c60UIxro2CQSmD6jJ jiB7k6y2 MRptB1DCm5wwIHFEfoXDqEzZQK55MgtPYKy5AZKErDlXbwZiNW33JU8rnZp6CaWROPKVb12Fx29Dyjosg+FYzD6VIjlEz9ZbxkmjEAKIG6jy5hjH0HPKQQDWtIVGarjfqBiW5BIxdU1BxZnRHLA3GnXc9hnfmRfLNdg1/8hobacI98nxezE6G13NhygioZkWhn7QCz58o1Cfafd92OlaPnLTzfCsd+h0+1bjLJ+y2jOrnlEN0EMQ3FhXiFJp4bMNr/3AEL/qCfEuUqmqhPYwNwShO7TwjTHoMRr8ml1LfoSIRVVgZGzt5Thx51IE+if11ouQRfyCvhvLHqfjkHhr1UNCPAnmHeTPiaMPXyTnPWsNpVBC0G82CG4psN2Cez/10ephxZ931kw4lDkFT9pCJVF5eq82LcAEu6dFsp3vtm67gAv2qrjPl6AHE0+YgEfUXmi7p4KYrE/sAULCgaUCSQBlUuIFBPf31C/dMnOZaD2baaqvcBSr6uBzEBhYFVye0DjiTzVxrwMTXntMrx3NxwZLGrQ== 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 includes the already existing PR_GET/SET_THP_DISABLE policy, as well as the newly introduced PR_GET/SET_THP_POLICY. Signed-off-by: Usama Arif --- Documentation/admin-guide/mm/transhuge.rst | 40 ++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/Documentation/admin-guide/mm/transhuge.rst b/Documentation/admin-guide/mm/transhuge.rst index dff8d5985f0f..cf3092eb239a 100644 --- a/Documentation/admin-guide/mm/transhuge.rst +++ b/Documentation/admin-guide/mm/transhuge.rst @@ -218,6 +218,46 @@ to "always" or "madvise"), and it'll be automatically shutdown when PMD-sized THP is disabled (when both the per-size anon control and the top-level control are "never") +process THP controls +-------------------- + +Transparent Hugepage behaviour of a process can be modified/obtained by +using the prctl system call. The following operations are supported: + +PR_SET_THP_DISABLE + This will set the MMF_DISABLE_THP process flag which will result + in no hugepages being faulted in or collapsed by khugepaged, + irrespective of global THP controls. + +PR_GET_THP_DISABLE + This will return the MMF_DISABLE_THP process flag, which will be + set if the process has previously been set with PR_SET_THP_DISABLE. + +PR_SET_THP_POLICY + This is used to change the behaviour of existing and future VMAs. + It has support for the following policies: + + PR_THP_POLICY_DEFAULT_HUGE + This will set the MMF2_THP_VMA_DEFAULT_HUGE process flag which + changes the default of new VMAs to be VM_HUGEPAGE. The call + also modifies all existing VMAs that are not VM_NOHUGEPAGE + to be VM_HUGEPAGE. The policy is inherited during fork+exec. + + PR_THP_POLICY_DEFAULT_NOHUGE + This will set the MMF2_THP_VMA_DEFAULT_NOHUGE process flag which + changes the default of new VMAs to be VM_NOHUGEPAGE. The call + also modifies all existing VMAs that are not VM_HUGEPAGE + to be VM_NOHUGEPAGE. The policy is inherited during fork+exec. + + PR_THP_POLICY_DEFAULT_SYSTEM + This will clear both MMF2_THP_VMA_DEFAULT_HUGE and + MMF2_THP_VMA_DEFAULT_NOHUGE process flags. + +PR_SET_THP_POLICY + This will return the current THP policy of the process, i.e. + PR_THP_POLICY_DEFAULT_HUGE, PR_THP_POLICY_DEFAULT_NOHUGE or + PR_THP_POLICY_DEFAULT_SYSTEM. + Khugepaged controls ------------------- -- 2.47.1