Add a new VM options section. Move KSTACK_PAGES there from the MI NOTES

file and better document it.  Add better documentation for the DISABLE_PSE
option.  Add the missing DISABLE_PG_G option and document it.

1 files changed, 25 insertions, 3 deletions

diff --git a/sys/i386/conf/NOTES b/sys/i386/conf/NOTES
index 7730730..161903e 100644
--- a/sys/i386/conf/NOTES
+++ b/sys/i386/conf/NOTES
@@ -918,6 +918,31 @@ options 	COMPAT_SVR4	# build emulator statically
 options 	DEBUG_SVR4	# enable verbose debugging
 device		streams		# STREAMS network driver (required for svr4).
 
+
+#####################################################################
+# VM OPTIONS
+
+# Disable the 4 MByte page PSE CPU feature.  The PSE feature allows the
+# kernel to use a 4 MByte pages to map the kernel instead of 4k pages.
+# This saves on the amount of memory needed for page tables needed to
+# map the kernel.  You should only disable this feature as a temporary
+# workaround if you are having problems with it enabled.
+#
+#options 	DISABLE_PSE
+
+# Disable the global pages PGE CPU feature.  The PGE feature allows pages
+# to be marked with the PG_G bit.  TLB entries for these pages are not
+# flushed from the cache when %cr3 is reloaded.  This can make context
+# switches less expensive.  You should only disable this feature as a
+# temporary workaround if you are having problems with it enabled.
+#
+#options	DISABLE_PG_G
+
+# KSTACK_PAGES is the number of memory pages to assign to the kernel
+# stack of each thread.
+
+options 	KSTACK_PAGES=3
+
 #####################################################################
 
 # More undocumented options for linting.
@@ -927,9 +952,6 @@ device		streams		# STREAMS network driver (required for svr4).
 options 	PECOFF_SUPPORT
 options 	PECOFF_DEBUG
 
-# Disable the 4 MByte PSE CPU feature.
-#options 	DISABLE_PSE
-
 options 	ENABLE_ALART
 options 	I4B_SMP_WORKAROUND
 options 	I586_PMC_GUPROF=0x70000