Document default Linux autocommit behavior, and show workaround.

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 27feffde8b620cc6c01eab7d98aa0309b01b4871..02befb8480c572a8ff6fb6618fc453b268fe5b11 100644 (file)
--- 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>