docs/64063: Size of block in File System Quota documentation is ambiguous

[Stacey Roberts]

>Number:         64063
>Category:       docs
>Synopsis:       Size of block in File System Quota documentation is ambiguous
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 10 11:10:04 PST 2004
>Closed-Date:
>Last-Modified:
>Originator:     Stacey Roberts
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
>Environment:
System: FreeBSD crom.vickiandstacey.com 4.9-STABLE FreeBSD 4.9-STABLE #0: Sat Mar 6 12:31:02 GMT 2004 root at crom.vickiandstacey.com:/usr/obj/usr/src/sys/SMP i386


>Description:
In attempting to follow the online HandBook on setting up per-user File System Quotas as described at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/quotas.html, it is not clear what the size of a block is, as used by the FreeBSD Quota system.

When compared to man du(1) notes:
ENVIRONMENT
     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -k
                option is not specified, the block counts will be displayed in
                units of that size block.  If BLOCKSIZE is not set, and the -k
                option is not specified, the block counts will be displayed in
                512-byte blocks.

man ls(1):
-s      Display the number of file system blocks actually used by each
             file, in units of 512 bytes, where partial units are rounded up
             to the next integer value.  If the output is to a terminal, a
             total sum for all the file sizes is output on a line before the
             listing.  The environment variable BLOCKSIZE overrides the unit
             size of 512 bytes.

it is not clear *what* the size of a block is supposed to be. Together with the PR submitted here: http://www.freebsd.org/cgi/query-pr.cgi?pr=41936, this issue is further complicated by the lack of a clear, unambiguous statement in Chapter 12.13 in the HandBook.

>How-To-Repeat:
N/A

>Fix:
Suggesting: -
1] Addition to Chapter 12.13 of the HandBook of a statement that clearly states what the sizeof a block is (currently?) supposed to be.

2] One or two examples for illustrative purposes
>Release-Note:
>Audit-Trail:
>Unformatted: