From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7EF2A1F582A for ; Fri, 4 Apr 2025 16:18:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.133.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1743783501; cv=none; b=cqfM7et63Ul/ldqYDTwvZUFTjdXV6wWcdGGKHlhtgh9zvR/7w5N8qAaKf+ofJBakxICSmcV5M3jtRGDAgkDzNZ441XQGK/AXQeGapqAt1yqZuPzHJSk2EeNmcKxXBpOKtf5iV0rNuc/oVcMBZHyYpilBxarKfo2+XRk0nhaxw1c= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1743783501; c=relaxed/simple; bh=TYaxjWS4iwUxMgBaeB2fSxhqrtPm8y+U+Y71w7AtIoo=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=l0Tc43j7Ey1GPvYZkYZNB1P1Gd7Jpar0DmW1y+zw7DT9X6s4lZ4fM9NzGsUIgyTDm2Kb6HtUGKTdPiRB2yDu5oNnoArhUXz2hA1lIVnTqiB0VnHS9g8MKLgTm60/SYxWKV2kxe8zIogbrRW8WU/22lRm8w9Vl8XVbF2+LPLFxuU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=Ftn2lre2; arc=none smtp.client-ip=170.10.133.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="Ftn2lre2" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1743783497; h=from:from: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:autocrypt:autocrypt; bh=8OejXCrxqbnmVsxgWwxh4xnmNEURfQ/aJ6V7K3P+SnU=; b=Ftn2lre2zuWgoG/tM3MP+oq127PlYMBNYcuVHCQwoFqTBp3OqcotN0UzMQ2pk/YYWVykNy IDACu5gOFc0qwLmYTjFNA3pAwUEjD/ImX71/t5e23AGrrafp56y1HUEHReBsuz3WFfSF40 RZfgIxQF4iHj4xwOAaXhUPamkqDfNTU= Received: from mail-wm1-f69.google.com (mail-wm1-f69.google.com [209.85.128.69]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-500-lQgRBmUiNpWMS9jGc9c6Hg-1; Fri, 04 Apr 2025 12:18:16 -0400 X-MC-Unique: lQgRBmUiNpWMS9jGc9c6Hg-1 X-Mimecast-MFC-AGG-ID: lQgRBmUiNpWMS9jGc9c6Hg_1743783495 Received: by mail-wm1-f69.google.com with SMTP id 5b1f17b1804b1-43cf5196c25so12739975e9.0 for ; Fri, 04 Apr 2025 09:18:15 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1743783495; x=1744388295; h=content-transfer-encoding:in-reply-to:organization:autocrypt:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=8OejXCrxqbnmVsxgWwxh4xnmNEURfQ/aJ6V7K3P+SnU=; b=Ee59K0By8YEY/H9rt2i5JvkAJobuSiNx3LpMsZDE54LZb5YolyxRMPl0VsR3t+T6Mf pYKphwW+4guhcFOZw3WjEi1k1HjzewGKb0zfR7tqJiDe0HjWNWc9DSlKj1GPcQC7uSzs PTnhhPeBqrF+iNn8mmIeqCmb+a9QlmdEpD1/Jtl63DteLGFuOS5YYrNi1+m7JZL8PMAv 2Mpw9uqgNrS/E+W7fyJAaPSYBYCQeX1BJcSb9IB/xeIuOxR5llZASfu4ZCRN1ZUUkSfb COLywq+XqismoEPvA980ISEvd2jkiH6jVj8Y2O78i0EzhHnqPaErC1LBGnPezLwiPuGO jNsQ== X-Forwarded-Encrypted: i=1; AJvYcCWSp/JOERCC0yt2zA5RtTx6Yta+boTi2aWf+RinW+ZOwfbWuhz58E2ifYqdP927z5hIV+DPm3amL0I=@vger.kernel.org X-Gm-Message-State: AOJu0YzRWxbLRE9ZnbS9kMPhq+9iige6tfBoL+2LcNtX2RMn2AWiqSZF GT3rsYwlSn9/nZDoI1ysinqPxSjsEPBSFFa0WhlcF1naXuTIXbB16q7qhjALv6qGP+9A8O2RtXc Vqpq7dV3qVdMsABOw+lxPoHZ7VHv7yvu4M0wHkMSK10s7KxHJtsEhi5AAqQ== X-Gm-Gg: ASbGncuYqypKJfLuCRQ3GzsISO2bqx1hf5u92CgTxYLuQqDU8QbkgsLT9DJKliRB5X5 JPaiQ5eo5gaNa5xoU2wFXahGfcuEa6uxHfVZKvf15HuWARNjO9v/42momGG3eCVAHI5YZiCN7Y/ TjsYBU2y2GeFIDBjv0tyZWZGUcMsjIAl5960vw93j3jfpMHW2yOmejEssZBf+f5PI82F5HLZWL2 gf8NxsqVFwUXsFs2UOSXcCTg/wlpbEhgEBFCqkPkhcDExD7LQyvkkYO2i9qUTeOGfZJz23Oc4Bl I9tVGJpRvtwcqlO/na/I95jzvHSR5e0w43YcXNAaRGHTFIR1/pqR2nNutl7HKhZsFvNWWRugjtT vxN66S+rcTdgxJk6ybZTwzFZfqdM/NCHmUPDTs7Q5rk0= X-Received: by 2002:a05:600c:46cb:b0:434:fa55:eb56 with SMTP id 5b1f17b1804b1-43ed0b5e180mr29601015e9.7.1743783494852; Fri, 04 Apr 2025 09:18:14 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGw50XUZ8b0mACVEGPstaSHFt8lZgrm023WRQpvI196XI6AXldQlXHgmz4W+aCZxXfYzFNIPA== X-Received: by 2002:a05:600c:46cb:b0:434:fa55:eb56 with SMTP id 5b1f17b1804b1-43ed0b5e180mr29600805e9.7.1743783494482; Fri, 04 Apr 2025 09:18:14 -0700 (PDT) Received: from ?IPV6:2003:cb:c71b:7900:8752:fae3:f9c9:a07e? (p200300cbc71b79008752fae3f9c9a07e.dip0.t-ipconnect.de. [2003:cb:c71b:7900:8752:fae3:f9c9:a07e]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-39c30226b17sm4765020f8f.92.2025.04.04.09.18.13 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 04 Apr 2025 09:18:13 -0700 (PDT) Message-ID: <09c13770-4d62-430a-827d-6ad35411d18c@redhat.com> Date: Fri, 4 Apr 2025 18:18:12 +0200 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3] docs: update THP admin guide about non-tmpfs filesystem support Content-Language: en-US To: Luis Chamberlain , "Pankaj Raghav (Samsung)" Cc: Andrew Morton , Jonathan Corbet , linux-kernel@vger.kernel.org, willy@infradead.org, linux-mm@kvack.org, Bagas Sanjaya , da.gomez@kernel.org, gost.dev@samsung.com, linux-doc@vger.kernel.org, Pankaj Raghav References: <20250404140657.29285-1-kernel@pankajraghav.com> From: David Hildenbrand Autocrypt: addr=david@redhat.com; keydata= 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 WNyWQQ== Organization: Red Hat In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 04.04.25 17:32, Luis Chamberlain wrote: > On Fri, Apr 04, 2025 at 04:06:57PM +0200, Pankaj Raghav (Samsung) wrote: >> From: Pankaj Raghav >> >> THP support for non-tmpfs filesystem has been around for some time now. >> Update the admin guide to reflect it. >> >> While we are at it, move FilePmdMapped to previous paragraph for clarity, >> and clarify ShmemPmdMapped & ShmemHugePage. >> >> Signed-off-by: Pankaj Raghav >> Acked-by: David Hildenbrand >> --- >> >> Changes since v2: >> - Address comment from Bagas Sanjaya >> - Squash commits and Ack from David >> >> Documentation/admin-guide/mm/transhuge.rst | 22 +++++++++++++++------- >> 1 file changed, 15 insertions(+), 7 deletions(-) >> >> diff --git a/Documentation/admin-guide/mm/transhuge.rst b/Documentation/admin-guide/mm/transhuge.rst >> index dff8d5985f0f..f8aae64e38d0 100644 >> --- a/Documentation/admin-guide/mm/transhuge.rst >> +++ b/Documentation/admin-guide/mm/transhuge.rst >> @@ -12,8 +12,8 @@ using huge pages for the backing of virtual memory with huge pages >> that supports the automatic promotion and demotion of page sizes and >> without the shortcomings of hugetlbfs. >> >> -Currently THP only works for anonymous memory mappings and tmpfs/shmem. >> -But in the future it can expand to other filesystems. >> +Currently, THP only works for anonymous memory mappings, tmpfs/shmem and >> +filesystems that support large folios. > > That seems to allude that THP can be supported on filesystems > that suppor large folios. I don't think we want to call that THP > and that can confuse folks. Leaving "currently" also seems to > indicate that there is more work to be done for THP for filesystems > but that's not true as well. So how about something like: > > THP only works for anonymous memory mappings, and the tmpfs/shmem is the only > filesystem to support it. The alternative to THP for other filesystems is to > support large folios and with it you can end up using huge pages That makes things more complicated without a good reason. See CONFIG_READ_ONLY_THP_FOR_FS as an early usage of the term "THP" for stuff we have in the pagecache. (with large folios we now properly implement this concept, and support more than only PMD size) -- Cheers, David / dhildenb