lib/46717: libquota(3) enhancements

[martin%NetBSD.org@localhost]

>Number:         46717
>Category:       lib
>Synopsis:       libquota(3) enhancements
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jul 17 21:05:04 +0000 2012
>Originator:     Martin Husemann
>Release:        NetBSD 6.99.9
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD night-owl.duskware.de 6.99.9 NetBSD 6.99.9 (NIGHT-OWL) #103: Sun 
Jul 15 13:43:35 CEST 2012 
martin%night-owl.duskware.de@localhost:/usr/src/sys/arch/amd64/compile/NIGHT-OWL
 amd64
Architecture: x86_64
Machine: amd64
>Description:

libquota(3) does not make it clear what units the predefined object types
use. For QUOTA_OBJTYPE_FILES it is pretty much clear that a count (number
of inodes) is used as the value for qv_softlimit/qv_hardlimit. For
QUOTA_OBJTYPE_BLOCKS the existence of quota_objtype_isbytes() hints at
"number of bytes" as the values, but the name more suggests "number of blocks"
(which probably means you need to multiply the value by 512 to get bytes,
independend of physical medium block size). This should be spelled out
explicitly.

>How-To-Repeat:
man libquota

>Fix:
n/a