From nobody@FreeBSD.org  Tue Dec 20 19:42:15 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 566CC106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Dec 2011 19:42:15 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 422F98FC14
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Dec 2011 19:42:15 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pBKJgExI041792
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Dec 2011 19:42:14 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id pBKJgEEt041788;
	Tue, 20 Dec 2011 19:42:14 GMT
	(envelope-from nobody)
Message-Id: <201112201942.pBKJgEEt041788@red.freebsd.org>
Date: Tue, 20 Dec 2011 19:42:14 GMT
From: Peter <fbsdq@peterk.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Confusing explanation in defaults/rc.conf
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         163488
>Category:       conf
>Synopsis:       Confusing explanation in defaults/rc.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-rc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 20 19:50:11 UTC 2011
>Closed-Date:    
>Last-Modified:  Sat Dec 24 02:02:50 UTC 2011
>Originator:     Peter
>Release:        FreeBSD 9.0-PRERELEASE #0 r228292
>Organization:
>Environment:
FreeBSD pkbsd.pk.pb 9.0-PRERELEASE FreeBSD 9.0-PRERELEASE #0 r228292: Mon Dec  5 16:20:40 MST 2011     root@pkbsd.pb.com:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
pkbsd:#grep "nfs.*server_enable" defaults/rc.conf
nfs_server_enable="NO"          # This host is an NFS server (or NO).
oldnfs_server_enable="NO"       # Run the old NFS server (YES/NO).
nfsv4_server_enable="NO"        # Enable support for NFSv4

It took me a bit to trace exactly what happens when both these options are set to "NO" in defaults/rc.conf - Which one is started? Initially I figured nfsv4 is started as oldnfs is set to NO, but then nfsv4 was also set to NO.  Only after looking through /etc/rc.d/nfsd and then looking at 'man nfsd' and the '-o' option did that clear it up.

 -o      Forces the use of the old NFS server that does not include NFSv4
             support in it.


Maybe instead of '# Run the old NFS server (YES/NO).' [Sounds like "run nfsv3"]
 put in '# Force old NFSv3 only server (YES/NO)' - More inline/same terminology as the man page for 'nfsd'.
  or
'# Force old non NFSv4 server'
>How-To-Repeat:
grep "nfs.*server_enable" defaults/rc.conf
man nfsd|grep -A 1 -- -o
>Fix:

Change defaults/rc.conf one liner to resemble 'man nfsd' terminology.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-rc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Sat Dec 24 02:02:42 UTC 2011 
Responsible-Changed-Why:  
Over to maintainer(s). 

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