linux-kernel - Suggestion for improving documentation (/usr/src/linux/Documentation/sysctl/vm.txt)

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Date:	Thu, 28 Jan 2016 15:01:17 +0100
From:	"Ulrich Windl" <Ulrich.Windl@...uni-regensburg.de>
To:	<linux-kernel@...r.kernel.org>
Subject: Suggestion for improving documentation
 (/usr/src/linux/Documentation/sysctl/vm.txt)

Hi!

I just read the documentation for the "swappiness" sysctl parameter, and I realized that
1) the documentation does not talk about the valid range of the parameter (0-100?)
2) the documentation does not talk about the units the parameter uses (Percent?)

==============================================================

swappiness

This control is used to define how aggressive the kernel will swap
memory pages.  Higher values will increase agressiveness, lower values
decrease the amount of swap.

The default value is 60.

==============================================================

My proposal to improve sysctl documentation is obvious, and no, I don't mean "Use the source, Luke!" ;-)

(I'm not subscribed to LKML)

Regards,
Ulrich