Update our information about OS X shared memory configuration: it's now

possible to set most of the SHM kernel parameters without a reboot.
Also, reorder the paragraph to explain the modern configuration method first.
There are probably not too many people who still care about how to do it on
OS X 10.3 or older.

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index cb76b1d7b57daf74f69b903cb14fd5bf028a2dbb..2e83dda9cfae2a3d31030fd7d666023091fc92f1 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,4 +1,4 @@
-
+
 
 
  Server Setup and Operation
@@ -942,29 +942,8 @@ options        SEMMAP=256
       MacOS XIPC configuration
       
        
-        In OS X 10.2 and earlier, edit the file
-        /System/Library/StartupItems/SystemTuning/SystemTuning
-        and change the values in the following commands:
-
-sysctl -w kern.sysv.shmmax
-sysctl -w kern.sysv.shmmin
-sysctl -w kern.sysv.shmmni
-sysctl -w kern.sysv.shmseg
-sysctl -w kern.sysv.shmall
-
-       
-
-       
-        In OS X 10.3 and later, these commands have been moved to
-        /etc/rc and must be edited there.  Note that
-        /etc/rc is usually overwritten by OS X updates (such as
-        10.3.6 to 10.3.7) so you should expect to have to redo your edits
-        after each update.
-       
-
-       
-        In OS X 10.3.9 and later, instead of editing /etc/rc
-        you can create a file named /etc/sysctl.conf,
+        The recommended method for configuring shared memory in OS X
+        is to create a file named /etc/sysctl.conf,
         containing variable assignments such as:
 
 kern.sysv.shmmax=4194304
@@ -973,8 +952,7 @@ kern.sysv.shmmni=32
 kern.sysv.shmseg=8
 kern.sysv.shmall=1024
 
-        This method is better than editing /etc/rc because
-        your changes will be preserved across system updates.  Note that
+        Note that in some OS X versions,
         all five shared-memory parameters must be set in
         /etc/sysctl.conf, else the values will be ignored.
        
@@ -989,8 +967,34 @@ kern.sysv.shmall=1024
        
 
        
-        In all OS X versions, you will need to reboot to have changes in the
-        shared memory parameters take effect.  
+        In older OS X versions, you will need to reboot to have changes in the
+        shared memory parameters take effect.  As of 10.5 it is possible to
+        change all but SHMMNI on the fly, using
+        sysctl.  But it's still best to set up your preferred
+        values via /etc/sysctl.conf, so that the values will be
+        kept across reboots.
+       
+
+       
+        The file /etc/sysctl.conf is only honored in OS X
+        10.3.9 and later.  If you are running a previous 10.3.x release,
+        you must edit the file /etc/rc
+        and change the values in the following commands:
+
+sysctl -w kern.sysv.shmmax
+sysctl -w kern.sysv.shmmin
+sysctl -w kern.sysv.shmmni
+sysctl -w kern.sysv.shmseg
+sysctl -w kern.sysv.shmall
+
+        Note that
+        /etc/rc is usually overwritten by OS X system updates,
+        so you should expect to have to redo these edits after each update.
+       
+
+       
+        In OS X 10.2 and earlier, instead edit these commands in the file
+        /System/Library/StartupItems/SystemTuning/SystemTuning.