From patchwork Thu Oct 10 09:58:14 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Baolin Wang X-Patchwork-Id: 13829878 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 29DB6CF11C4 for ; Thu, 10 Oct 2024 09:58:35 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id BD6F46B0093; Thu, 10 Oct 2024 05:58:31 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id B6BF06B0095; Thu, 10 Oct 2024 05:58:31 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9D84A6B0096; Thu, 10 Oct 2024 05:58:31 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 74E946B0093 for ; Thu, 10 Oct 2024 05:58:31 -0400 (EDT) Received: from smtpin01.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id C0157160D2F for ; Thu, 10 Oct 2024 09:58:27 +0000 (UTC) X-FDA: 82657242822.01.914B07C Received: from out30-119.freemail.mail.aliyun.com (out30-119.freemail.mail.aliyun.com [115.124.30.119]) by imf15.hostedemail.com (Postfix) with ESMTP id 08E80A000B for ; Thu, 10 Oct 2024 09:58:27 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=ydRL6U1n; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf15.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.119 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728554265; a=rsa-sha256; cv=none; b=Cv2Oq7EhmCq74etbuwt1nYHoFruCNxzU9BNVYAye/9+tbbh02pfJCiYePi6V4SegB0c3A+ IXTqkiVyl+ScspQL11zxgJGqi5yEWca33RBXgaIDW+mx3COzX7EVDQ8NdFqNEmcAp7GFF2 yHTORLOOq3eX1QotbHGx+SpywNBwGiY= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=ydRL6U1n; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf15.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.119 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728554265; 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=TAqUYxnDAtyT0H6gtJz0ppazair4o9uzMNjBuGwGaBM=; b=uztkDEtd9wI4/QHVDPZlfgzbklGLlQXrtUnQTX5IPThgwsm5k33GLrqUDRMDDlvLfSd2oz E98/fam6/NMgnXNzBAVs+bRQZJnj3VRy3IxjAbyaghsLLuUxTKpbYr64auDzqeiY0gn1Jk Yh3RbHBmpYo1FFoFmrKydpCCAWc9YTc= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1728554304; h=From:To:Subject:Date:Message-Id:MIME-Version; bh=TAqUYxnDAtyT0H6gtJz0ppazair4o9uzMNjBuGwGaBM=; b=ydRL6U1nY2azVkkVYc6BLmhUr6hJMYXBnJKiCq4oFUMBGLBhUd1y3M9+ChPUW6uQfrFmzqNbHXGWevNtT7db2baLh9KV9smzOukwH9FChhbiaQBFMi9LUYNenRsE5C3GgoLEHiqGaR2XoA1rY/j7rw0GFGtuS4E0AGJy9iB+a+o= Received: from localhost(mailfrom:baolin.wang@linux.alibaba.com fp:SMTPD_---0WGlzQYu_1728554301 cluster:ay36) by smtp.aliyun-inc.com; Thu, 10 Oct 2024 17:58:22 +0800 From: Baolin Wang To: akpm@linux-foundation.org, hughd@google.com Cc: willy@infradead.org, david@redhat.com, wangkefeng.wang@huawei.com, 21cnbao@gmail.com, ryan.roberts@arm.com, ioworker0@gmail.com, da.gomez@samsung.com, baolin.wang@linux.alibaba.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [RFC PATCH v3 4/4] docs: tmpfs: add documention for 'write_size' huge option Date: Thu, 10 Oct 2024 17:58:14 +0800 Message-Id: <556e9944f0328ccb0025e8582894ae01efd98842.1728548374.git.baolin.wang@linux.alibaba.com> X-Mailer: git-send-email 2.39.3 In-Reply-To: References: MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: 08E80A000B X-Rspamd-Server: rspam01 X-Stat-Signature: 9smo9jznmw5icimry8rhd9785uequb1d X-HE-Tag: 1728554307-539017 X-HE-Meta: U2FsdGVkX198vq5oe4QSvxwYPJ1bdg2I9WT3EPHMKImdREAbJBE4CodgrR1Oe3OGpXI8bq/Zuyn79Sa8eTq+rLjOpwlxPwYFRlSiZbY1bSFqyvSifG1InKKG1DWWFt7U+Z/ZiwLq+/rw87C2UAKoo43mDXD0vDcbFsRbwbA3q6XBYrGud4xxusi7dbsN7l/1tXs3hd72vnWl2Oqh3qi/zao25fXBUYu2YdMVatpBRtFPDlCzzvTDNzFURtXsXQrHEd8Maa7F/gzYHIuIHMFGmSk/7IeWC/9Rl46FgIhFRyDL8MjZzeERnEc/XhViCw9v/T5yCcwg4UYJmF/s5UE1zlgjuDBIax3d90jKW8Odn1SqOWWDk5LuYWCpP6xM8pvYy/dB6yHpIsrIPNwcVVcyQnzHcYdxmWd+s6vmZCKq4Ca+tJLH7/cmrcQRtDf9hbZ2QUoUD2R/6pGkJnJ5zfK7XRsAsU4/MSbzVHMHakLP7fs4SiH3exixNbFIoNI5NFfTmzqNFoCSVq7PiyJO8I/+I7VF/Hxgpo0RNpdaX+B5x8Wf3b8QKZBilwMzR93DgYEfz8X6pi94KCHOESjiL6+4rFMaUHYNSSWjCunrHd2/ejeMuz5F8gbtYHQXFq9azInfWB85a5PfRIwpjC/9eb2+zOED+jIg6n9/UIvAxwae4O9bsflVOrcz1TWfMfHKPuoudFZSrH5iyIQM/rfl+xvDRePO/81b1xAzJdY7AnG8IuwXS2RUfnBcnMxAyvOU3iRZhbj3IJuadZDklldlOroRrho/sugiaw9DTpZcbD45/hcAidrX0WC0aKVElzcglO86QEOKvKbJepRJORUebDSAdEwfmLrDW9OO96ht88Re7A8mfgCTsXc0EprWcGSCo4xrjTwqHM6cgDYtCWfwBxSoEpjCYXzeTkV/HD5wjJPHKrh2YXu3C+FM+zW83aPaRpRhH1UKJYnI2GsTF7+no2I 9oW1ky4s JvfkPwgNsNT/Tj6HbVmOqm3CD/G3TFbEDO1mRDhRAubJpmbNVfinCeV53yGjD3pSNOY7cm5eQ77K99bvpfqdT8WvhWiWzOx26BwY2sdJEtNbSJVshGOt0YK8ygZ+/2UbCj+iGsRTQlUeATD2+mWL7QCqyu2VQhJn4EDfK+crZyEje+EWZcPaUqy7izWGoX+KUxfZVzGuLl8Szbomlc2wX9S3KsZlcZJiydsqAIWumaIq56wBs6Gpupx9A71ycXLDhel1nHmkzC+oh9R79QgDzNCQ9lg== 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: Add documention for 'write_size' huge option, as well as making previous huge options more clear. Signed-off-by: Baolin Wang --- Documentation/filesystems/tmpfs.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Documentation/filesystems/tmpfs.rst b/Documentation/filesystems/tmpfs.rst index 56a26c843dbe..be998ff47018 100644 --- a/Documentation/filesystems/tmpfs.rst +++ b/Documentation/filesystems/tmpfs.rst @@ -115,10 +115,11 @@ The mount options for this are: ================ ============================================================== huge=never Do not allocate huge pages. This is the default. -huge=always Attempt to allocate huge page every time a new page is needed. -huge=within_size Only allocate huge page if it will be fully within i_size. +huge=always Attempt to allocate PMD sized huge page every time a new page is needed. +huge=within_size Only allocate PMD sized huge page if it will be fully within i_size. Also respect madvise(2) hints. -huge=advise Only allocate huge page if requested with madvise(2). +huge=advise Only allocate PMD sized huge page if requested with madvise(2). +huge=write_size Can allocate various sized huge page based on the write size. ================ ============================================================== See also Documentation/admin-guide/mm/transhuge.rst, which describes the