From 8d2d92c5f0169190e4963fb541340bc8c630b02f Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Thu, 12 Jun 2003 15:31:02 +0000
Subject: [PATCH] Document default Linux autocommit behavior, and show
 workaround.

---
 doc/src/sgml/runtime.sgml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 27feffde8b..02befb8480 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.184 2003/06/11 22:13:21 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.185 2003/06/12 15:31:02 momjian Exp $
 -->
 
 <Chapter Id="runtime">
@@ -2780,6 +2780,16 @@ kernel.shmmax = 134217728
         <filename>/usr/src/linux/include/asm-<replaceable>xxx</>/shmpara
         m.h</> and <filename>/usr/src/linux/include/linux/sem.h</>.
        </para>
+
+       <para>
+        Linux has poor default memory overcommit behavior.  Rather than
+        failing if it can not reserve enough memory, it returns success, 
+        but later fails when the memory can't be mapped and terminates 
+        the application.  To prevent unpredictable process termination, use:
+<programlisting>
+sysctl -w vm.overcommit_memory=3
+</programlisting>
+       </para>
       </listitem>
      </varlistentry>
 
-- 
2.11.0