From owner-freebsd-doc  Wed Dec  5 16:30: 7 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id A0B0337B41C
	for <freebsd-doc@freebsd.org>; Wed,  5 Dec 2001 16:30:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id fB60U1e39455;
	Wed, 5 Dec 2001 16:30:01 -0800 (PST)
	(envelope-from gnats)
Received: from fledge.watson.org (fledge.watson.org [204.156.12.50])
	by hub.freebsd.org (Postfix) with ESMTP id 7126C37B41A
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  5 Dec 2001 16:22:18 -0800 (PST)
Received: (from robert@localhost)
	by fledge.watson.org (8.11.6/8.11.5) id fB60M4x08864;
	Wed, 5 Dec 2001 19:22:04 -0500 (EST)
	(envelope-from robert)
Message-Id: <200112060022.fB60M4x08864@fledge.watson.org>
Date: Wed, 5 Dec 2001 19:22:04 -0500 (EST)
From: Robert Watson <rwatson@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/32542: tuning(7) inaccurate
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         32542
>Category:       docs
>Synopsis:       tuning(7) inaccurate
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Dec 05 16:30:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Robert Watson
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
NAI Labs
>Environment:

src/share/man/man7/tuning.7 on -CURRENT includes a number of
inaccuracies regarding kern.maxusers.  First, kern.maxusers is
not a writable sysctl (although it is exported as a read-only
sysctl), it's a boot-time tunable.  Second, the -CURRENT man page
incorrectly distinguishes the behavior regarding kern.maxusers
between -CURRENT and -STABLE.  Both versions support modifying the
value at boottime using loader.conf.  The -STABLE version should be
updated to reflect that this is the case (rather than recommending
a kernel recompile), and the -CURRENT version should refer to it as
a tunable, and stop casting aspersions at -STABLE.

Note that in -CURRENT, nmbclusters is also a boot-time tunable,
but that in -STABLE, it still requires a kernel recompile.

There may be other aging information in tuning(7) that needs updating.

>Description:
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message