Bug 91938

Summary: conflicting information in handbook/users-limiting.html and getcap(3) manual page
Product: Documentation Reporter: reed
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description reed 2006-01-18 07:00:20 UTC
              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.

Fix: 

Please update manual page or handbook as appropriate.
How-To-Repeat:               Look at manual page and at handbook and try to decide if
I need to use login.conf.db.
Comment 1 Ceri Davies freebsd_committer freebsd_triage 2006-01-21 13:46:51 UTC
State Changed
From-To: open->closed

I've updated the text to point out that login.conf.db is there for 
performance reasons.  Thanks for the submission!