Update SysV parameter configuration documentation for FreeBSD.
authorTom Lane
Thu, 14 Aug 2014 20:05:55 +0000 (16:05 -0400)
committerTom Lane
Thu, 14 Aug 2014 20:05:55 +0000 (16:05 -0400)
FreeBSD hasn't made any use of kern.ipc.semmap since 1.1, and newer
releases reject attempts to set it altogether; so stop recommending
that it be adjusted.  Per bug #11161.

Back-patch to all supported branches.  Before 9.3, also incorporate
commit 7a42dff47, which touches the same text and for some reason
was not back-patched at the time.

doc/src/sgml/runtime.sgml

index bb7b8c16f2ee3caf7a0236944aac21f32d0ed051..cfd353293f52399170a5403e57ece8436248e02f 100644 (file)
@@ -753,25 +753,27 @@ psql: could not connect to server: No such file or directory
         loader interfaces.  The following
         parameters can be set using sysctl:
 
-$ sysctl -w kern.ipc.shmall=32768
-$ sysctl -w kern.ipc.shmmax=134217728
-$ sysctl -w kern.ipc.semmap=256
+# sysctl kern.ipc.shmall=32768
+# sysctl kern.ipc.shmmax=134217728
 
-        To have these settings persist over reboots, modify
+        To make these settings persist over reboots, modify
         /etc/sysctl.conf.
        
 
        
-        The remaining semaphore settings are read-only as far as
-        sysctl is concerned, but can be changed
-        before boot using the loader prompt:
-
-(loader) set kern.ipc.semmni=256
-(loader) set kern.ipc.semmns=512
-(loader) set kern.ipc.semmnu=256
-
-        Similarly these can be saved between reboots in
-        /boot/loader.conf.
+        These semaphore-related settings are read-only as far as
+        sysctl is concerned, but can be set in
+        /boot/loader.conf:
+
+kern.ipc.semmni=256
+kern.ipc.semmns=512
+kern.ipc.semmnu=256
+
+        After modifying these values a reboot is required for the new
+        settings to take effect.
+        (Note: FreeBSD does not use SEMMAP.  Older versions
+        would accept but ignore a setting for kern.ipc.semmap;
+        newer versions reject it altogether.)