Added mention of SHMALL and removed BSD/OS-specific table.
authorBruce Momjian <[email protected]>
Wed, 2 May 2001 17:04:53 +0000 (17:04 +0000)
committerBruce Momjian <[email protected]>
Wed, 2 May 2001 17:04:53 +0000 (17:04 +0000)
doc/src/sgml/runtime.sgml

index 4224ab68b7811d488d887076ba529c40a15a8bf5..5e24157d477d1de66fa09b21b791afe66708aa15 100644 (file)
@@ -1449,7 +1449,7 @@ env PGOPTIONS='-c geqo=off' psql
       <row>
        <entry><varname>SHMMAX</></>
        <entry>Maximum size of shared memory segment (bytes)</>
-       <entry>512 kB + 8192 * buffers + extra ... infinity</entry>
+       <entry>700 kB + 8192 * buffers + extra ... infinity</entry>
       </row>
 
       <row>
@@ -1458,6 +1458,12 @@ env PGOPTIONS='-c geqo=off' psql
        <entry>1 (at most about 256 kB)</>
       </row>
 
+      <row>
+       <entry><varname>SHMALL</></>
+       <entry>Total amount of shared memory available (bytes or pages)</>
+       <entry>if bytes, same as SHMMAX; if pages, ceil(SHMMAX/PAGE_SIZE)</>
+      </row>
+
       <row>
        <entry><varname>SHMSEG</></>
        <entry>Maximum number of shared memory segments per process</>
@@ -1588,42 +1594,37 @@ env PGOPTIONS='-c geqo=off' psql
         <para>
          By default, only 4 MB of shared memory is supported. Keep in
          mind that shared memory is not pageable; it is locked in RAM.
-        The shared memory parameters are:
-<programlisting>
-#define SHMMAX         /* max shared memory segment size (bytes) */
-#define SHMMIN         /* min shared memory segment size (bytes) */
-#define SHMMNI         /* max number of shared memory identifiers */
-#define SHMSEG         /* max shared memory segments per process */
-#define SHMALL         /* max amount of shared memory (pages) */
-</programlisting>
-
-        To increase the number of buffers supported by the postmaster, add the
-        following to your kernel config file.  A <varname>SHMALL</> value of 1024 
-        represents 4MB of shared memory.  Increase it accordingly:
+        
+        To increase the number of shared buffers supported by the
+        postmaster, add the following to your kernel config file. A
+        <varname>SHMALL</> value of 1024 represents 4MB of shared
+        memory. The following increases the maximum shared memory area
+        to 32 MB:
 <programlisting>
-options "SHMALL=4096"
+options "SHMALL=8192"
 options "SHMMAX=\(SHMALL*PAGE_SIZE\)"
 </programlisting>
         </para>
        </formalpara>
 
        <para>
-        For those running 4.1 or later, just recompile the kernel and
-        reboot. For those running earlier releases, use
-        <application>bpatch</> to find the <varname>sysptsize</> value
-        for the current kernel. This is computed dynamically at
-        bootup.
+        For those running 4.1 or later, just make the above changes,
+        recompile the kernel, and reboot. For those running earlier
+        releases, use <application>bpatch</> to find the
+        <varname>sysptsize</> value in the current kernel. This is
+        computed dynamically at bootup.
 <screen>
 $ <userinput>bpatch -r sysptsize</>
 <computeroutput>0x9 = 9</>
 </screen>
-        Next, change <varname>SYSPTSIZE</> to a hard-coded value. Use
-        the bpatch value, plus add 1 for every additional 4 MB of
+        Next, add <varname>SYSPTSIZE</> as a hard-coded value in the
+        kernel config file. Increase the value you found using
+        <application>bpatch</>. Add 1 for every additional 4 MB of
         shared memory you desire.
 <programlisting>
-options "SYSPTSIZE=13"
+options "SYSPTSIZE=16"
 </programlisting>
-        <varname>sysptsize</> can not be changed by sysctl on the fly.
+        <varname>sysptsize</> can not be changed by sysctl.
        </para>
 
        <formalpara>
@@ -1635,17 +1636,6 @@ options "SYSPTSIZE=13"
         </para>
        </formalpara>
 
-       <para>
-        The defaults are in <filename>/sys/sys/sem.h</>:
-<programlisting>
-#define SEMMNI  10              /* # of semaphore identifiers */
-
-#define SEMMNS  60              /* # of semaphores in system */
-
-#define SEMUME  10              /* max # of undo entries per process */
-
-#define SEMMNU  30              /* # of undo structures in system */
-</programlisting>
         Set the values you want in your kernel config file, e.g.:
 <programlisting>
 options "SEMMNI=40"