Bug 25124

Summary: No man pages for quota.user(5) and/or quota.group(5)
Product: Documentation Reporter: Ronald F. Guilmette <rfg>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Ronald F. Guilmette 2001-02-16 00:20:01 UTC 
	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?

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.
How-To-Repeat: 
	man 8 quotacheck
Comment 1 nik freebsd_committer freebsd_triage 2001-02-17 14:41:15 UTC 
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
Comment 2 Ronald F. Guilmette 2001-02-17 17:40:58 UTC 
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.
Comment 3 nik freebsd_committer freebsd_triage 2001-02-22 11:07:59 UTC 
State Changed
From-To: open->closed

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.