From rfg@monkeys.com  Thu Feb 15 16:15:20 2001
Return-Path: <rfg@monkeys.com>
Received: from mail.monkeys.com (236.dsl9226.rcsis.com [63.92.26.236])
	by hub.freebsd.org (Postfix) with ESMTP id AF47B37B491
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 Feb 2001 16:15:19 -0800 (PST)
Received: (from rfg@localhost)
	by mail.monkeys.com (8.11.1/8.11.1) id f1G0FII15200;
	Thu, 15 Feb 2001 16:15:19 -0800 (PST)
Message-Id: <200102160015.f1G0FII15200@mail.monkeys.com>
Date: Thu, 15 Feb 2001 16:15:19 -0800 (PST)
From: "Ronald F. Guilmette" <rfg@monkeys.com>
Reply-To: rfg@monkeys.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: No man pages for quota.user(5) and/or quota.group(5)
X-Send-Pr-Version: 3.2

>Number:         25124
>Category:       docs
>Synopsis:       No man pages for quota.user(5) and/or quota.group(5)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 15 16:20:01 PST 2001
>Closed-Date:    Thu Feb 22 03:07:59 PST 2001
>Last-Modified:  Thu Feb 22 03:08:45 PST 2001
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 4.2-RELEASE i386
>Organization:
Infinite Monkeys & Co.
>Environment:

	FreeBSD 4.2-RELEASE i386

>Description:

	The quotacheck(8) man page refers to two magical files, i.e.
	"quota.user" and "quota.group" but I have been unable to find
	any man pages that describe the exact contents/formal/layout of
	these magical files.

	Shouldn't there exist a quota.user(5) man page and a quota.group(5)
	man page, specifying the format of these files?

>How-To-Repeat:

	man 8 quotacheck

>Fix:

	None known at the moment.  I guess that I have to turn on quotas
	on one of my filesystems and then try to `cat' or `od' these files
	and try to figure out for myself what's in them, and how that info
	is laid out.


>Release-Note:
>Audit-Trail:

From: Nik Clayton <nik@freebsd.org>
To: "Ronald F. Guilmette" <rfg@monkeys.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/25124: No man pages for quota.user(5) and/or quota.group(5)
Date: Sat, 17 Feb 2001 14:41:15 +0000

 On Thu, Feb 15, 2001 at 04:15:19PM -0800, Ronald F. Guilmette wrote:
 > >Synopsis:       No man pages for quota.user(5) and/or quota.group(5)
 > 
 > 	The quotacheck(8) man page refers to two magical files, i.e.
 > 	"quota.user" and "quota.group" but I have been unable to find
 > 	any man pages that describe the exact contents/formal/layout of
 > 	these magical files.
 
 They are (I think) binary files.  edquota(8) converts them in to a
 textual representation, lets you edit them, and converts them back.
 
 > 	Shouldn't there exist a quota.user(5) man page and a quota.group(5)
 > 	man page, specifying the format of these files?
 
 Probably not.  What there probably should be is a quota.user(5) and
 quota.group(5) which explains that these are binary files, and should be
 edited by edquota(8).  quotacheck(8) should probably mention that these
 files should be edited by edquota(8).
 
 Thoughts?
 
 N
 -- 
 Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
 Telephone line, $24.95 a month.  Software, free.  USENET transmission,
 hundreds if not thousands of dollars.  Thinking before posting, priceless.
 Somethings in life you can't buy.  For everything else, there's MasterCard.
   -- Graham Reed, in the Scary Devil Monastery
 

From: "Ronald F. Guilmette" <rfg@monkeys.com>
To: Nik Clayton <nik@freebsd.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/25124: No man pages for quota.user(5) and/or quota.group(5) 
Date: Sat, 17 Feb 2001 09:40:58 -0800

 In message <20010217144115.C13544@canyon.nothing-going-on.org>, you wrote:
 
 >On Thu, Feb 15, 2001 at 04:15:19PM -0800, Ronald F. Guilmette wrote:
 >> >Synopsis:       No man pages for quota.user(5) and/or quota.group(5)
 >> 
 >> 	The quotacheck(8) man page refers to two magical files, i.e.
 >> 	"quota.user" and "quota.group" but I have been unable to find
 >> 	any man pages that describe the exact contents/formal/layout of
 >> 	these magical files.
 >
 >They are (I think) binary files.
 
 Yes.  So I discovered.
 
 >edquota(8) converts them in to a
 >textual representation, lets you edit them, and converts them back.
 
 Yep.  I figured that part out too.
 
 >> 	Shouldn't there exist a quota.user(5) man page and a quota.group(5)
 >> 	man page, specifying the format of these files?
 >
 >Probably not.  What there probably should be is a quota.user(5) and
 >quota.group(5) which explains that these are binary files, and should be
 >edited by edquota(8).  quotacheck(8) should probably mention that these
 >files should be edited by edquota(8).
 >
 >Thoughts?
 
 Your suggestion sounds like the best way to go.
 
 
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Thu Feb 22 03:07:59 PST 2001 
State-Changed-Why:  
I've committed a quota.user(5) and quota.group(5), and updated the 
quotacheck(8) page to talk bout using edquota(8) when it mentions the 
files as well. 

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