Instructions for FreeBSD ipc config showing age

Поиск
Список
Период
Сортировка
Искать

Instructions for FreeBSD ipc config showing age

От:
Mark Kirkwood <markir@coretech.co.nz>
Дата:
A recent mailing on the -perf list highlighted that the docs concerning
ipc configuration are a bit out for date for FreeBSD.

The attached patch separates out FreeBSD from Open/NetBSD, and shows how
to change settings via sysctl w/o a kernel rebuild. Any thoughts?

BTW I suspect that both Open and NetBSD are in need of an update too,
however I don't have any installations of such to experiment on.

regards

Mark

--- runtime.sgml.orig	Sat Jan 29 18:30:50 2005
+++ runtime.sgml	Mon Jan 31 22:30:35 2005
@@ -4350,10 +4350,8 @@
 
 
      
-      FreeBSD</>
       NetBSD</>
       OpenBSD</>
-      FreeBSD</>IPC configuration</></>
       NetBSD</>IPC configuration</></>
       OpenBSD</>IPC configuration</></>
       
@@ -4364,25 +4362,66 @@
         the option SHMMAXPGS</> (in pages). The following
         shows an example of how to set the various parameters:
 
-options         SYSVSHM
-options         SHMMAXPGS=4096
-options         SHMSEG=256
+option         SYSVSHM
+option         SHMMAXPGS=4096
+option         SHMSEG=256
 
-options         SYSVSEM
-options         SEMMNI=256
-options         SEMMNS=512
-options         SEMMNU=256
-options         SEMMAP=256
+option         SYSVSEM
+option         SEMMNI=256
+option         SEMMNS=512
+option         SEMMNU=256
+option         SEMMAP=256
 
-        (On NetBSD</> and OpenBSD</> the key word is actually
-        option singular.)
        
        
         You might also want to configure your kernel to lock shared
         memory into RAM and prevent it from being paged out to swap.
         Use the sysctl</> setting
         kern.ipc.shm_use_phys</>.
+       
+      
+     
+
+
+     
+      FreeBSD</>
+      FreeBSD</>IPC configuration</></>
+      
+       
+        The default settings are only suitable for small installations 
+        (default SHMMAX is 32 MB). Changes can be made via
+        the sysctl or loader interfaces.
+        Firstly the ones that are settable using sysctl:
+
+$ systcl -w kern.ipc.shmall=32768
+$ systcl -w kern.ipc.shmmax=134217728
+$ systcl -w kern.ipc.semmap=256
+
+        These to be saved between reboots in /etc/sysctl.conf.
+       
+       
+        The remaining sempahore 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.
+       
+       
+        You might also want to configure your kernel to lock shared
+        memory into RAM and prevent it from being paged out to swap.
+        Use the sysctl</> setting
+        kern.ipc.shm_use_phys</>.
+       
+       
+        Versions before 4.0 will require a kernel rebuild, see the
+        NetBSD</> and OpenBSD</> instructions above, however the key word is 
+        options (plural) in this case.
        
       
      

Re: Instructions for FreeBSD ipc config showing age

От:
Tom Lane <tgl@sss.pgh.pa.us>
Дата:
Mark Kirkwood  writes:
> A recent mailing on the -perf list highlighted that the docs concerning
> ipc configuration are a bit out for date for FreeBSD.
> The attached patch separates out FreeBSD from Open/NetBSD, and shows how
> to change settings via sysctl w/o a kernel rebuild. Any thoughts?

This seems a bit awkwardly phrased:

> +       
> +        Versions before 4.0 will require a kernel rebuild, see the
> +        NetBSD</> and  +        class="osname">OpenBSD</> instructions above, however the key word is 
> +        options (plural) in this case.
>         

Perhaps

	FreeBSD versions before 4.0 work like NetBSD and OpenBSD (see above),
	except that the configuration file uses the key word "options"
	instead of "option".

Also, alphabetization would suggest putting the FreeBSD entry before the
other two, not after, so maybe that should be "see below".

			regards, tom lane

Re: Instructions for FreeBSD ipc config showing age

От:
Mark Kirkwood <markir@coretech.co.nz>
Дата:
Tom Lane wrote:
>
> 
> This seems a bit awkwardly phrased:
> 
> 
>>+       
>>+        Versions before 4.0 will require a kernel rebuild, see the
>>+        NetBSD</> and >+        class="osname">OpenBSD</> instructions above, however the key word is 
>>+        options (plural) in this case.
>>        
> 
> 
> Perhaps
> 
> 	FreeBSD versions before 4.0 work like NetBSD and OpenBSD (see above),
> 	except that the configuration file uses the key word "options"
> 	instead of "option".
> 
Yeah - much nicer.
> Also, alphabetization would suggest putting the FreeBSD entry before the
> other two, not after, so maybe that should be "see below".
Thanks - had not considered that!

Amended patch attached.

regards

Mark

--- runtime.sgml.orig	Sat Jan 29 18:30:50 2005
+++ runtime.sgml	Tue Feb  1 14:25:53 2005
@@ -4351,9 +4351,51 @@
 
      
       FreeBSD</>
+      FreeBSD</>IPC configuration</></>
+      
+       
+        The default settings are only suitable for small installations 
+        (default SHMMAX is 32 MB). Changes can be made via
+        the sysctl or loader interfaces.
+        Firstly the ones that are settable using sysctl:
+
+$ systcl -w kern.ipc.shmall=32768
+$ systcl -w kern.ipc.shmmax=134217728
+$ systcl -w kern.ipc.semmap=256
+
+        These to be saved between reboots in /etc/sysctl.conf.
+       
+       
+        The remaining sempahore 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.
+       
+       
+        You might also want to configure your kernel to lock shared
+        memory into RAM and prevent it from being paged out to swap.
+        Use the sysctl</> setting
+        kern.ipc.shm_use_phys</>.
+       
+       
+        FreeBSD</> versions before 4.0 work like 
+        NetBSD</> and 
+        OpenBSD</> (see below), except that the configuration file uses the 
+        key word "options" instead of "option".
+       
+      
+     
+
+
+     
       NetBSD</>
       OpenBSD</>
-      FreeBSD</>IPC configuration</></>
       NetBSD</>IPC configuration</></>
       OpenBSD</>IPC configuration</></>
       
@@ -4364,19 +4406,16 @@
         the option SHMMAXPGS</> (in pages). The following
         shows an example of how to set the various parameters:
 
-options         SYSVSHM
-options         SHMMAXPGS=4096
-options         SHMSEG=256
+option         SYSVSHM
+option         SHMMAXPGS=4096
+option         SHMSEG=256
 
-options         SYSVSEM
-options         SEMMNI=256
-options         SEMMNS=512
-options         SEMMNU=256
-options         SEMMAP=256
+option         SYSVSEM
+option         SEMMNI=256
+option         SEMMNS=512
+option         SEMMNU=256
+option         SEMMAP=256
 
-        (On NetBSD</> and OpenBSD</> the key word is actually
-        option singular.)
        
        
         You might also want to configure your kernel to lock shared

FAQ