From 1fbe3cd4841aef35b7e2798769504ee85fc6851d Mon Sep 17 00:00:00 2001 From: Stephan Wiesand Date: Tue, 17 Feb 2015 15:34:33 +0100 Subject: [PATCH] Document --enable-linux-d_splice_alias-extra-iput Even though we hope no one will actually ever need to use it, explain this configure switch in the same place as the others. Reviewed-on: http://gerrit.openafs.org/11749 Tested-by: BuildBot Reviewed-by: Chas Williams - CONTRACTOR Reviewed-by: Perry Ruiter Reviewed-by: Daria Brashear (cherry picked from commit e02b852f05c0927d48b6467872378bae99df2760) Change-Id: I4f7e42730afab2387d343880acc81d28b70ef5e9 Reviewed-on: http://gerrit.openafs.org/11752 Reviewed-by: Daria Brashear Tested-by: Daria Brashear Reviewed-by: Stephan Wiesand --- README | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README b/README index 9ea0509fd..e7b480d72 100644 --- a/README +++ b/README @@ -303,6 +303,20 @@ I Other configure options by the option with debugging information. If --enable-debug is given, also do not strip binaries when installing them. + --enable-linux-d_splice_alias-extra-iput + Work around a kernel memory leak present in a few Linux kernels. + The only affected mainline kernels are 3.17 to 3.17.2, but this + switch will also be required should a distribution backport commit + 908790fa3b779d37365e6b28e3aa0f6e833020c3 or commit + 95ad5c291313b66a98a44dc92b57e0b37c1dd589 but not the fix in commit + 51486b900ee92856b977eacfc5bfbe6565028070 from the linux-stable repo + (git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git) or + the corresponding changes on other branches. This is impossible to + detect automatically. Without this switch, the openafs module will + build and work even with affected kernels. But it will leak kernel + memory, leading to performance degradation and eventually system + failure due to memory exhaustion. + --enable-linux-syscall-probing OpenAFS now uses keyrings to manage PAGs by default on Linux, which does not require hooking into the system call table. On older -- 2.39.5