The patch titled
Subject: Documentation/sysctl: document page_lock_unfairness
has been added to the -mm tree. Its filename is
documentation-sysctl-document-page_lock_unfairness.patch
This patch should soon appear at
https://ozlabs.org/~akpm/mmots/broken-out/documentation-sysctl-document-page_lock_unfairness.patch
and later at
https://ozlabs.org/~akpm/mmotm/broken-out/documentation-sysctl-document-page_lock_unfairness.patch
Before you just go and hit "reply", please:
a) Consider who else should be cc'ed
b) Prefer to cc a suitable mailing list as well
c) Ideally: find the original patch on the mailing list and do a
reply-to-all to that, adding suitable additional cc's
*** Remember to use Documentation/process/submit-checklist.rst when testing your code ***
The -mm tree is included into linux-next and is updated
there every 3-4 working days
------------------------------------------------------
From: Joel Savitz <jsavitz@xxxxxxxxxx>
Subject: Documentation/sysctl: document page_lock_unfairness
commit 5ef64cc8987a ("mm: allow a controlled amount of unfairness in the
page lock") introduced a new systctl but no accompanying documentation.
Add a simple entry to the documentation.
Link: https://lkml.kernel.org/r/20220325164437.120246-1-jsavitz@xxxxxxxxxx
Signed-off-by: Joel Savitz <jsavitz@xxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Vlastimil Babka <vbabka@xxxxxxx>
Cc: Mel Gorman <mgorman@xxxxxxxxxxxxxxxxxxx>
Cc: Dave Hansen <dave.hansen@xxxxxxxxxxxxxxx>
Cc: Suren Baghdasaryan <surenb@xxxxxxxxxx>
Cc: Mike Rapoport <rppt@xxxxxxxxxx>
Cc: "zhangyi (F)" <yi.zhang@xxxxxxxxxx>
Cc: Charan Teja Reddy <charante@xxxxxxxxxxxxxx>
Cc: Linus Torvalds <torvalds@xxxxxxxxxxxxxxxxxxxx>
Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
Documentation/admin-guide/sysctl/vm.rst | 9 +++++++++
1 file changed, 9 insertions(+)
--- a/Documentation/admin-guide/sysctl/vm.rst~documentation-sysctl-document-page_lock_unfairness
+++ a/Documentation/admin-guide/sysctl/vm.rst
@@ -62,6 +62,7 @@ Currently, these files are in /proc/sys/
- overcommit_memory
- overcommit_ratio
- page-cluster
+- page_lock_unfairness
- panic_on_oom
- percpu_pagelist_high_fraction
- stat_interval
@@ -754,6 +755,14 @@ extra faults and I/O delays for followin
that consecutive pages readahead would have brought in.
+page_lock_unfairness
+====================
+
+This value determines the number of times that the page lock can be
+stolen from under a waiter. After the lock is stolen the number of times
+specified in this file (default is 5), the "fair lock handoff" semantics
+will apply, and the waiter will only be awakened if the lock can be taken.
+
panic_on_oom
============
_
Patches currently in -mm which might be from jsavitz@xxxxxxxxxx are
documentation-sysctl-document-page_lock_unfairness.patch
