From patchwork Wed May 30 23:56:53 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Shi X-Patchwork-Id: 10440097 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 0ACC2602BD for ; Wed, 30 May 2018 23:57:30 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id F22BE29302 for ; Wed, 30 May 2018 23:57:29 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E5DE3293B8; Wed, 30 May 2018 23:57:29 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00, MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DCDED29302 for ; Wed, 30 May 2018 23:57:28 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id ADD2E6B0003; Wed, 30 May 2018 19:57:27 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id A8DD46B0005; Wed, 30 May 2018 19:57:27 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 97CCF6B0006; Wed, 30 May 2018 19:57:27 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-pf0-f198.google.com (mail-pf0-f198.google.com [209.85.192.198]) by kanga.kvack.org (Postfix) with ESMTP id 544616B0003 for ; Wed, 30 May 2018 19:57:27 -0400 (EDT) Received: by mail-pf0-f198.google.com with SMTP id c4-v6so11669419pfg.22 for ; Wed, 30 May 2018 16:57:27 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:message-id; bh=jbjOIsn95L40oVwrRkl3LAkhblpMYT7IVMiOVaoea28=; b=A8D65iPobJCzLFeylnlGpf8PUBTEvMfvMRFZMti2db4dN8flA6t5l/12B9QfE23pIZ Wm6FOJxOiWTuR07p9BnzU0jGw7k30ejm+Qo4SD4WqeIwB8NqxfzTHXU/Hf9RRLzgyFTK 2gTupChwoN6yCQnLL+kx6OXWJ9f07etRQ6KiLHbP8mxOePfswE/3iAoVHEIp2x9r9FD4 1JurVf90xY9wWY+n9P+Ip/jDs7M8b6QpgsmFqs6nnyHetE98NwOga/9PmxEwfLNvhOyK wTQ4Zy70KLIsfZFC5Msrxws/nhqt+7EzqemIP2oLppGqOvmRq30LaTaN2CPdB+txxyDe l2SA== X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of yang.shi@linux.alibaba.com designates 47.88.44.38 as permitted sender) smtp.mailfrom=yang.shi@linux.alibaba.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=alibaba.com X-Gm-Message-State: ALKqPwc9U6FvSJ8JJ24rc3NUR+nl/f/xsYP5W3krtiW6OR9oVbxkTMoV S0+LwEIvZXityiYPi4B8XTJicgcAQAJG7/apsjPGA6x0mFT0d+9dal9fUI/14eEqLIr+L1Vl28c ugo9XjlvjlDmbG0HP8aBV3AEMDDnUpxVs25Sj4i2Od0i1OnzN5uAhoSDzMZTKdv3YHw== X-Received: by 2002:a63:7b1e:: with SMTP id w30-v6mr3717312pgc.249.1527724646993; Wed, 30 May 2018 16:57:26 -0700 (PDT) X-Google-Smtp-Source: ADUXVKJPCPmIqi8PH9pukX3kHeYAnH9v7X3qUxooN8/TZxF7/KLwV5We6yJINTnhEU2btJV4iCfj X-Received: by 2002:a63:7b1e:: with SMTP id w30-v6mr3717288pgc.249.1527724646156; Wed, 30 May 2018 16:57:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1527724646; cv=none; d=google.com; s=arc-20160816; b=nrTbgKj4YvXFLalyMV3C6T4jd7X9cgJKPYoOX/H1tTOvsaNoGwXYBX/oqK15eLKWuu 4nYAVfp+ULhspxtYqJA1R6Qz5WDHhHER5IfnAgq6vpN+rOTn5wOlbic79gSuHZ9ekYqN VLaL0XMedhPci8B9hNWbnnXWLsesN6w0lwtG6qJtIv6/L4ypuPLJIghUhTBkx5BaWgQz gTRoQ/N1YAoiQ9WGrenHILSgpAjBashKcnU2N6JbrCrBZwXJOYJWVEiwZvC81GCvKD2U 2+23w5vB/iR2fFiTzoUO8n66RA5/bC3Wa85dnxw6svN/yTkdYclWMCCZtDBZtM2BrdCY Pp2A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:date:subject:cc:to:from:arc-authentication-results; bh=jbjOIsn95L40oVwrRkl3LAkhblpMYT7IVMiOVaoea28=; b=LmHDd88komFRm0elDCqpOWy0uu3rIygPcuFLEodWD8AYraidxuH23WAAhtD/G6dfOH Rey3UUdOPuRr7TkBlhgoCd8ThZZx1RwKtxpJrF0KlB0ztFAGM09H1gK7fTqRB+uF5yO7 z8psahqeH1Uq5BnKcbNmGZsFBUitU+wPLm2EECrjnXaX8303muzYmoVCPXYeW81N0zFA x8eakUtcU3mNvTnDnAH4thrfE2NAf2KDGhcvhDSGJtbYtYinUQNJcLzuNZBtBxSsnly4 qeDGEDFwovGeVVmrKU5/8HhZqP+cJDoU8sYOE8i8671LQV6YU9Ch8PZdRozjrGrNWuAw Ovjg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of yang.shi@linux.alibaba.com designates 47.88.44.38 as permitted sender) smtp.mailfrom=yang.shi@linux.alibaba.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: from out4438.biz.mail.alibaba.com (out4438.biz.mail.alibaba.com. [47.88.44.38]) by mx.google.com with ESMTPS id i10-v6si28481305pgv.109.2018.05.30.16.57.24 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 30 May 2018 16:57:25 -0700 (PDT) Received-SPF: pass (google.com: domain of yang.shi@linux.alibaba.com designates 47.88.44.38 as permitted sender) client-ip=47.88.44.38; Authentication-Results: mx.google.com; spf=pass (google.com: domain of yang.shi@linux.alibaba.com designates 47.88.44.38 as permitted sender) smtp.mailfrom=yang.shi@linux.alibaba.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=alibaba.com X-Alimail-AntiSpam: AC=PASS; BC=-1|-1; BR=01201311R131e4; CH=green; FP=0|-1|-1|-1|0|-1|-1|-1; HT=e01e07487; MF=yang.shi@linux.alibaba.com; NM=1; PH=DS; RN=7; SR=0; TI=SMTPD_---0T1uApIh_1527724613; Received: from e19h19392.et15sqa.tbsite.net(mailfrom:yang.shi@linux.alibaba.com fp:SMTPD_---0T1uApIh_1527724613) by smtp.aliyun-inc.com(127.0.0.1); Thu, 31 May 2018 07:57:00 +0800 From: Yang Shi To: tytso@mit.edu, corbet@lwn.net, akpm@linux-foundation.org Cc: yang.shi@linux.alibaba.com, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH] doc: add description to dirtytime_expire_seconds Date: Thu, 31 May 2018 07:56:53 +0800 Message-Id: <1527724613-17768-1-git-send-email-yang.shi@linux.alibaba.com> X-Mailer: git-send-email 1.8.3.1 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: X-Virus-Scanned: ClamAV using ClamSMTP commit 1efff914afac8a965ad63817ecf8861a927c2ace ("fs: add dirtytime_expire_seconds sysctl") introduced dirtytime_expire_seconds knob, but there is not description about it in Documentation/sysctl/vm.txt. Add the description for it. Cc: Theodore Ts'o Signed-off-by: Yang Shi --- I didn't dig into the old review discussion about why the description was not added at the first place. I'm supposed every knob under /proc/sys should have a brief description. Documentation/sysctl/vm.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/sysctl/vm.txt b/Documentation/sysctl/vm.txt index 17256f2..f4f4f9c 100644 --- a/Documentation/sysctl/vm.txt +++ b/Documentation/sysctl/vm.txt @@ -27,6 +27,7 @@ Currently, these files are in /proc/sys/vm: - dirty_bytes - dirty_expire_centisecs - dirty_ratio +- dirtytime_expire_seconds - dirty_writeback_centisecs - drop_caches - extfrag_threshold @@ -178,6 +179,16 @@ The total available memory is not equal to total system memory. ============================================================== +dirtytime_expire_seconds + +When a lazytime inode is constantly having its pages dirtied, it with an +updated timestamp will never get chance to be written out. This tunable +is used to define when dirty inode is old enough to be eligible for +writeback by the kernel flusher threads. And, it is also used as the +interval to wakeup dirtytime_writeback thread. It is expressed in seconds. + +============================================================== + dirty_writeback_centisecs The kernel flusher threads will periodically wake up and write `old' data