From personal@bloodhound.noc.clara.net  Mon Sep  5 08:44:08 2005
Return-Path: <personal@bloodhound.noc.clara.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id ED9A016A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  5 Sep 2005 08:44:08 +0000 (GMT)
	(envelope-from personal@bloodhound.noc.clara.net)
Received: from leto.uk.clara.net (leto.uk.clara.net [80.168.69.50])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9102043D49
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  5 Sep 2005 08:44:08 +0000 (GMT)
	(envelope-from personal@bloodhound.noc.clara.net)
Received: from bloodhound.noc.clara.net ([195.8.70.207])
	by leto.uk.clara.net with esmtp (Exim 4.43)
	id 1ECCaF-0000lw-CE
	for FreeBSD-gnats-submit@freebsd.org; Mon, 05 Sep 2005 09:44:07 +0100
Received: from personal by bloodhound.noc.clara.net with local (Exim 4.50 (FreeBSD))
	id 1ECCan-0002HP-Di
	for FreeBSD-gnats-submit@freebsd.org; Mon, 05 Sep 2005 09:44:41 +0100
Message-Id: <E1ECCan-0002HP-Di@bloodhound.noc.clara.net>
Date: Mon, 05 Sep 2005 09:44:41 +0100
From: Brian Candler <B.Candler@pobox.com>
Reply-To: Brian Candler <B.Candler@pobox.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: FAQ should point to /boot/loader.conf for changing kern.maxproc
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         85733
>Category:       docs
>Synopsis:       [patch] FAQ should point to /boot/loader.conf for changing kern.maxproc
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 05 08:50:18 GMT 2005
>Closed-Date:    Mon Dec 26 14:40:47 GMT 2005
>Last-Modified:  Mon Dec 26 14:40:47 GMT 2005
>Originator:     Brian Candler
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
>Environment:
System: FreeBSD XXX 5.4-RELEASE FreeBSD 5.4-RELEASE #0: Sun May 8 10:21:06 UTC 2005 root@harlow.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
http://www.freebsd.org/doc/faq/troubleshoot.html#PROC-TABLE-FULL

says:

  "If your machine is lightly loaded, and you are simply running a very
   large number of processes, you can adjust this with the kern.maxproc
   sysctl.
   ...
   To make a sysctl permanent across reboots, set this in
   /etc/sysctl.conf in recent versions of FreeBSD, or /etc/rc.local in
   older versions."

However, this particular tunable needs to be set in /boot/loader.conf and
requires a reboot.

It's true that attempting to make the change manually tells you this:

   # sysctl kern.maxproc=2000
   sysctl: oid 'kern.maxproc' is a read only tunable
   sysctl: Tunable values are set in /boot/loader.conf

However, readers of this document might be inclined just to put a setting in
/etc/sysctl.conf, and then find it doesn't work.

>How-To-Repeat:

>Fix:

Refer to /boot/loader.conf, and/or cross-reference to
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-sysctl.html

(Personally I don't know a way to tell whether sysctl variable X is a
/boot/loader.conf tunable or an /etc/sysctl.conf frob other than trying to
change it. If there's a better way, please document that too :-)
>Release-Note:
>Audit-Trail:

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org, B.Candler@pobox.com
Cc:  
Subject: Re: docs/85733: FAQ should point to /boot/loader.conf for changing kern.maxproc
Date: Sat, 24 Sep 2005 14:13:26 +0200

 I think this should be proper diff:
 
 --- book.sgml.orig	Sat Sep 24 12:58:51 2005
 +++ book.sgml	Sat Sep 24 14:09:07 2005
 @@ -3313,8 +3313,12 @@
  
            <para>If your machine is lightly loaded, and you are simply
              running a very large number of processes, you can adjust
 -            this with the <varname>kern.maxproc</varname> sysctl.  If
 -            these processes are being run by a single user, you will
 +            this with the <varname>kern.maxproc</varname> tunable.  If
 +            you want to adjust this tunable, you will need to set this
 +            in <filename>/boot/loader.conf</filename> and reboot.  For
 +            more information about tuning tunables, you should see the
 +            &man.loader.conf.5; and &man.sysctl.conf.5; manual pages.
 +            If these processes are being run by a single user, you will
              also need to adjust <varname>kern.maxprocperuid</varname>
              to be one less than your new
              <varname>kern.maxproc</varname> value.  (It must be at
 @@ -3322,9 +3326,10 @@
              must always be running.)</para>
  
            <para>To make a sysctl permanent across reboots, set this in
 -            <filename>/etc/sysctl.conf</filename> in recent versions
 -            of FreeBSD, or <filename>/etc/rc.local</filename> in older
 -            versions.</para>
 +            <filename>/etc/sysctl.conf</filename>.  More information
 +            about tuning with sysctl can be found at <ulink
 +            url="&url.books.handbook;/configtuning-sysctl.html">Tuning
 +            with sysctl</ulink> section of the Handbook.</para>
          </answer>
        </qandaentry>
  
 
 -- 
 Sincerely,
    Daniel Gerzo
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Sat Sep 24 19:34:21 GMT 2005 
Responsible-Changed-Why:  
I will make this happen 

http://www.freebsd.org/cgi/query-pr.cgi?pr=85733 
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Mon Dec 26 14:40:20 UTC 2005 
State-Changed-Why:  
I committed a slightly modified patch to the FAQ. 
It should appear within 24 hours from now. 
Thanks for the notice and submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=85733 
>Unformatted:
