doc: Document fs listquota 2TB partition limit
authorAndrew Deason <adeason@sinenomine.net>
Tue, 10 Jun 2014 19:47:31 +0000 (14:47 -0500)
committerJeffrey Altman <jaltman@your-file-system.com>
Wed, 3 Dec 2014 06:02:20 +0000 (01:02 -0500)
commitcd8f24d9a1ba8563c6bef2b8d30885a753e8d30c
tree19d6bf8ed3b0e4264a85a6c2136d73a623dd6a7d
parentf889469e271cee5ccf362d829c7827307a6add4c
doc: Document fs listquota 2TB partition limit

We have previously documented that volumes over 2TB can result in
inaccuracies, but this documentation does not say how the 'partition'
field in "fs listquota" can be inaccurate. It is confusing to see a
usage of 0% for a partition that you know is being used, so try to
briefly explain in what way this field is inaccurate.

The reason we _under_-report the partition usage is that the
fileserver actually gives back PartBlocksAvail and PartMaxBlocks (not
"blocks used" and "blocks total"). So 1TB used and 4TB total is
truncated to 2TB and given back as 2TB free and 2TB total. One we hit
3TB used we'll report it as 1TB free 2TB total (50%) when the actual
usage is 75%.

Change-Id: I0b3de04ef2bd6cd32fdcb1a82cbac58d5d621e5b
Reviewed-on: http://gerrit.openafs.org/11245
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
Tested-by: BuildBot <buildbot@rampaginggeek.com>
doc/man-pages/pod1/fs_listquota.pod.in