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 5BA9AC27C78 for ; Tue, 11 Jun 2024 21:55:58 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 93DC26B00EE; Tue, 11 Jun 2024 17:55:56 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 8C48B6B00EF; Tue, 11 Jun 2024 17:55:56 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 765BB6B00F0; Tue, 11 Jun 2024 17:55:56 -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 535F96B00EE for ; Tue, 11 Jun 2024 17:55:56 -0400 (EDT) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 10F7B1A03CA for ; Tue, 11 Jun 2024 21:55:56 +0000 (UTC) X-FDA: 82219965912.12.6338EC8 Received: from mail-pg1-f201.google.com (mail-pg1-f201.google.com [209.85.215.201]) by imf03.hostedemail.com (Postfix) with ESMTP id 48ED22000B for ; Tue, 11 Jun 2024 21:55:54 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=a1eKclT7; spf=pass (imf03.hostedemail.com: domain of 36MdoZggKCFU65xD5LxA3BB381.zB985AHK-997Ixz7.BE3@flex--jiaqiyan.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=36MdoZggKCFU65xD5LxA3BB381.zB985AHK-997Ixz7.BE3@flex--jiaqiyan.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1718142954; 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: in-reply-to:in-reply-to:references:references:dkim-signature; bh=WHQrsHsxDopyLkSSwJmPkWDGR/C1iA1OobsIIfIGPV4=; b=UMni1CQ1UaPRzCFHh58gVH2EmWSLJq8Vl2rEjXHAquY+gFyGjtVrJ8loDjTVbdcvZifhpa dFzELsZh4Q84TylQK1UMTLWZvTsahkUtfj3wErMwjDE3JJ5YxWhE66lyQBT5CKjwdd1GRo cUOsTphjZleyR1pJlSy1cTeufPxxVBE= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1718142954; a=rsa-sha256; cv=none; b=2dsqzrb3tLXcwneor+g0dyUSEyHbJARGKNpdaLN6mE5mNDgk30J7aqnj9GGj5SeENAIwNu iSS4+86m+7vowH9wojXOKfv/o14sk/mq/BhedeU+u7xwd7eNiPBKX4yumrdMLy4QbQtR5p ZDe84KjkMQ66lBM59oRXCh2WnFHgrX4= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=a1eKclT7; spf=pass (imf03.hostedemail.com: domain of 36MdoZggKCFU65xD5LxA3BB381.zB985AHK-997Ixz7.BE3@flex--jiaqiyan.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=36MdoZggKCFU65xD5LxA3BB381.zB985AHK-997Ixz7.BE3@flex--jiaqiyan.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com Received: by mail-pg1-f201.google.com with SMTP id 41be03b00d2f7-6658818ad5eso4875824a12.0 for ; Tue, 11 Jun 2024 14:55:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1718142953; x=1718747753; darn=kvack.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=WHQrsHsxDopyLkSSwJmPkWDGR/C1iA1OobsIIfIGPV4=; b=a1eKclT7gkG+KORgQB99a4OlDXUATOWTA3xdZkY/lKAQZkuAEOMPlRSlAbKRPWcMut ayvQuNoJKIYQm8jRXfKDPw/8V5AjwAKg8gYRLB9DjChF9QzUlYqcJBIHHiH13C91tGO7 8xE9IHYycqFU+hSFh4/A2qUcBtYX7djcbnPnaE3DgCj5+ayESQLTb2oy9PrFYJI4/HZT 9ZwP+voYaLq2qRAOh+eEzL/eawPfATm+4BUq28JkK+LdzgtDLdtZUmJZSmuWvAdqcF3R dOQw5ZHKsPZaw60WBNZJSTtgFJpgBPl7W9bxhG83wZ3mf/Tx/dDO7PAU9Nuahmz9UYcJ 28BQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1718142953; x=1718747753; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=WHQrsHsxDopyLkSSwJmPkWDGR/C1iA1OobsIIfIGPV4=; b=bxez9JZMEe/p5zI7h68AOlk73dQ4a2THhNLNSybekhWLaup7n+1IA6Xk656dO53WF3 KsN6b9oM9WzdnQ579iAQ9AbFgTLEXCkqFNJ5mahkFEKlZcel6DsMrfpQ3strU8fffJQ1 7qRONHiqV50IjcAPikpllj2J4DTLS32KaOXobHHoPqByVHMQDgW61rFIiU7XEhcZDd1s 7HeKa9ZpOy29lpOWpdnV2xHMdlRxZrpJPN2vWKk+cGE2yz4PsjIkH5cCgykRaoN3vzXJ YyCFoYf4sDmcNDs3N8WQ4G7wL8eFVmVEZwVgJH3zN2OKd5QpMi2Sb97DIXwSUC1CmQmY pYoQ== X-Forwarded-Encrypted: i=1; AJvYcCUyY2HRMh1hOjIEVTlwz8i5zlMeIW0HAkcswzvMUqBFtLoTCiTGSIOA0N8wXqTxfG8ez8knlYmBgLRP6wRejeMi4P0= X-Gm-Message-State: AOJu0YzsagbyrIKJ9LlJHxsEGVWTl/gJUn3uluTjB9RAbIHoo8BLuJZY nOIpXL/OxfLgu7EJcFbu1s3xh9lSbnAUVewj1uBloPLK4lgXDAJ1BzuPz8rZkHtXa6rRbPqC99L NMjez8aNxrA== X-Google-Smtp-Source: AGHT+IE7Hu1Utk6hKZYc2/5v0BAUMc85WtlS2vZJkVYtta2I3YTIOk0Jt9c2VGJfWWlmwXFp1yRF39LVPqKQZw== X-Received: from yjq3.c.googlers.com ([fda3:e722:ac3:cc00:24:72f4:c0a8:272f]) (user=jiaqiyan job=sendgmr) by 2002:a63:20a:0:b0:673:9f86:3f23 with SMTP id 41be03b00d2f7-6e156ce6eccmr32320a12.3.1718142952846; Tue, 11 Jun 2024 14:55:52 -0700 (PDT) Date: Tue, 11 Jun 2024 21:55:44 +0000 In-Reply-To: <20240611215544.2105970-1-jiaqiyan@google.com> Mime-Version: 1.0 References: <20240611215544.2105970-1-jiaqiyan@google.com> X-Mailer: git-send-email 2.45.2.505.gda0bf45e8d-goog Message-ID: <20240611215544.2105970-4-jiaqiyan@google.com> Subject: [PATCH v2 3/3] docs: mm: add enable_soft_offline sysctl From: Jiaqi Yan To: nao.horiguchi@gmail.com, linmiaohe@huawei.com, jane.chu@oracle.com Cc: muchun.song@linux.dev, akpm@linux-foundation.org, shuah@kernel.org, corbet@lwn.net, osalvador@suse.de, rientjes@google.com, duenwen@google.com, fvdl@google.com, linux-mm@kvack.org, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, Jiaqi Yan Content-Type: text/plain; charset="UTF-8" X-Rspamd-Server: rspam03 X-Stat-Signature: fks874z8z9bduw8gpxh5x31onge667xa X-Rspamd-Queue-Id: 48ED22000B X-Rspam-User: X-HE-Tag: 1718142954-832791 X-HE-Meta: U2FsdGVkX18r6Huw1meRCrbCjgx3uRQvMKISP8iq2t1sQQdMoyutY1UT0M4QfnxJo4Xd58Xb8IOJOJNZeRTI0djAM2h5iu8ut1UA4+eW17t8qu3dLZHULjztOTanaGRVRrV+A39PP+EarboxrNoDa669dJcHY3jIevCNM9MhtzF3Ln90+YfZYyH5IsYYMdTaCJpiNGvtECdpD4yE+HE9V3YGWQiGHUlImcAhZEHAHHmfCoQayhmJtv6tS+uwk0+72PIjvsf4xyBW2iI9MV4T5Mq4o/V+zZJPCREk6Dkv7cbATdFs9aEcIo+kWEIdaTzzTu+X7KBlIUtlyLdKCYT5DxdEltz56U5OUGlJ+W9SzeSO0pUh2aCuxoHRMtxX4xzf3vD/Oab3QLG8ZVeATN6c7dX4XyJZjotJvIp8j4PpTyUnnpSeansPAZetvuJwgIZ7EqvVzogoR/Dzez0cPQkCZ+pREJJFbGWXfEtWgaL1OBmUptZQwMuKSbKTjnN8VQpDy2E1pErfnDeT286yeuRNZSktFGftw3etNLag4Oeh3VKA4YdOEYWUWAvVBMH4Wgv4hghVRb6Upb3sYKwbClBrTSoj5mEB/YZKU3TyuuD77Ngpdh5DQDNsFcnKuJZAFpUO7i9Qcxu0ihjQ9h+mopVDg2sDHGNaFyPd4J5YPuKiXBYgDSCw5R+pyNRZHStbZxV5qzlfeO3ViSuPYADdW1ixk8S6OXG2dMf/8Y9PHeBSWVT/kKm88/bOW6MmHwuqAuTVAEmoP6bKBXW9V+ouKVy4/w+N+fwiqBjrM4fbmXRx9lEK6x5NlcSVU8FIoHyGsuj++R+PVS/Pmeq+HQLaYGNq6ELYvKhKFCrgIK/UvDr0E1fXaGohY4Nd9c9oaDgcHmFqvoZHLTF7sohW33ux2DFSZfYIPfmsXy5aheU5NcJLndUP2/zuylggfNzPRXy92JjJzWJ2UQyMOms7962Wlib edcztGXe 1DOnDzkp2cG+dOM1wm9T0Y0qI1wZhTmGin02cTdXChlVNXza9hR9/eXZWRo9zg3Xmr1NTD4UdgnZhLMRh1K7JGo09gwHOtiaCVYoZp4BwRm5i/6IN/4cp4iBiQtYoRUJMJCPQ/uwlzf2v1rFLtth3I7sCxkjRJsWdVea8PLIzjh22Pl9oTsPgY1AOExSlRgNJZhwq6Iql9+AiPLUU2faejMm7FTteOE+s1a55ZUxU+401l0TWwDSz3QwDuAvKftkoUjdGTHmvo6Otw0Vw2+tF3V3spBV/iXoOxr2hGUPBfh0HRlUHs+Db9lJ+dUq4xWvxy0W1ocCQR2mZPMj1cgStN1S0/zYvHJhnCIcxjieVEw61b+T9Ihh2LREmXtj3Qxsc1ssHzB2OxzacaEkY3FHm7FLC/lSjq5mklmALGxjEFC1fKfwqBkAIlI2PgqdRr8V8YnlnJYOWpZrBich0YBcpuPQpjcRNQwilvjN7aV46dP3MCm+PO2UeYRzBvPqmkAOyQqJQycyyXHUu6HK96vssGzJuPV1GD0sBy6uwkozfASVUPlZ9tQaxxVgMnq5wwbswPE9tsUn4LIS3gQeJmYM+Y9GK/8fbmrubfq8+N+QaXdYIrQiOl3BYOk2pwVTcXz/Ja15IGcA/Gmj+Onc9vbaxaW5Evw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000250, 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 the documentation for what enable_soft_offline sysctl is for. Signed-off-by: Jiaqi Yan --- Documentation/admin-guide/sysctl/vm.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/Documentation/admin-guide/sysctl/vm.rst b/Documentation/admin-guide/sysctl/vm.rst index e86c968a7a0e..856bb17c07bc 100644 --- a/Documentation/admin-guide/sysctl/vm.rst +++ b/Documentation/admin-guide/sysctl/vm.rst @@ -36,6 +36,7 @@ Currently, these files are in /proc/sys/vm: - dirtytime_expire_seconds - dirty_writeback_centisecs - drop_caches +- enable_soft_offline - extfrag_threshold - highmem_is_dirtyable - hugetlb_shm_group @@ -267,6 +268,20 @@ used:: These are informational only. They do not mean that anything is wrong with your system. To disable them, echo 4 (bit 2) into drop_caches. +enable_soft_offline +=================== +Control whether to soft offline memory pages that have (excessive) correctable +memory errors. It is your call to choose between reliability (stay away from +fragile physical memory) vs performance (brought by HugeTLB or transparent +hugepages). + +When setting to 1, kernel attempts to soft offline the page when it thinks +needed. For in-use page, page content will be migrated to a new page. If +the oringinal hugepage is a HugeTLB hugepage, regardless of in-use or free, +it will be dissolved into raw pages, and the capacity of the HugeTLB pool +will reduce by 1. If the original hugepage is a transparent hugepage, it +will be split into raw pages. When setting to 0, kernel won't attempt to +soft offline the page. Its default value is 1. extfrag_threshold ================= -- 2.45.2.505.gda0bf45e8d-goog