From 493eea649cafd8ffb2d2d12f7f526e56609af050 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 11 Apr 2006 19:28:03 +0000
Subject: [PATCH] Add documentation about running postmasters in FreeBSD jails
 (use separate users).

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

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index a94d7a48ba..9cee668edf 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.357.2.1 2006/03/02 20:30:33 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.357.2.2 2006/04/11 19:28:03 momjian Exp $
 -->
 
 <chapter Id="runtime">
@@ -766,6 +766,18 @@ options "SEMMNS=240"
         setting <literal>kern.ipc.shm_use_phys</literal>.
        </para>
 
+       <para>
+        If running in FreeBSD jails by enabling <application>sysconf</>'s
+        <literal>security.jail.sysvipc_allowed</>, <application>postmaster</>s
+        running in different jails should be run by different operating system
+        users.  This improves security because it prevents one jail from
+        interfering with shared memory or semaphores in another, and it
+        allows the PostgreSQL IPC cleanup code to function properly.  
+        (In FreeBSD 6.0 and later the IPC cleanup code doesn't properly detect
+        processes in other jails, preventing the running of postmasters on the
+        same port in different jails.)
+       </para>
+
        <para>
         <systemitem class="osname">FreeBSD</> versions before 4.0 work like 
         <systemitem class="osname">NetBSD</> and <systemitem class="osname">
-- 
2.50.0