From nobody@FreeBSD.org  Wed Jan 18 06:56:24 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 58D3316A41F
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 18 Jan 2006 06:56:24 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 21CE443D45
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 18 Jan 2006 06:56:24 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k0I6uN17053486
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 18 Jan 2006 06:56:23 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id k0I6uNDA053485;
	Wed, 18 Jan 2006 06:56:23 GMT
	(envelope-from nobody)
Message-Id: <200601180656.k0I6uNDA053485@www.freebsd.org>
Date: Wed, 18 Jan 2006 06:56:23 GMT
From: "Jeremy C. Reed" <reed@reedmedia.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: conflicting information in handbook/users-limiting.html and getcap(3) manual page
X-Send-Pr-Version: www-2.3

>Number:         91938
>Category:       docs
>Synopsis:       conflicting information in handbook/users-limiting.html and getcap(3) manual page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 18 07:00:20 GMT 2006
>Closed-Date:    Sat Jan 21 13:47:39 GMT 2006
>Last-Modified:  Sat Jan 21 13:47:39 GMT 2006
>Originator:     Jeremy C. Reed
>Release:        6
>Organization:
>Environment:
>Description:
              I noticed that RELENG_6's getcap.3 says

 cgetent() will first look for files ending in ``.db'' (see cap_mkdb(1))
 before accessing the ASCII version of the capability database.

But the webpage at
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/users-limiting.html
says

  Note: The system does not read the configuration in /etc/login.conf
  directly, but reads the database file /etc/login.conf.db. To generate
  /etc/login.conf.db from /etc/login.conf, execute the following command:
 
  # cap_mkdb /etc/login.conf

This conflicts or is confusing.

>How-To-Repeat:
              Look at manual page and at handbook and try to decide if
I need to use login.conf.db.
>Fix:
              Please update manual page or handbook as appropriate.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Sat Jan 21 13:46:51 UTC 2006 
State-Changed-Why:  
I've updated the text to point out that login.conf.db is there for 
performance reasons.  Thanks for the submission! 

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