]> git.michaelhowe.org Git - packages/o/openafs.git/commit
doc: Document fs listquota 2TB partition limit
authorAndrew Deason <adeason@sinenomine.net>
Tue, 10 Jun 2014 19:47:31 +0000 (14:47 -0500)
committerStephan Wiesand <stephan.wiesand@desy.de>
Wed, 15 Apr 2015 14:18:10 +0000 (10:18 -0400)
commita48e90ddf1de19e766a8cc5898f9ac0a340eddb4
treec623f23e0d3476f0fa484255f0f62533915cce93
parent1db8a1c134ed64730e6f6719caf2ba6c689ae31a
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%.

Reviewed-on: http://gerrit.openafs.org/11245
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
Tested-by: BuildBot <buildbot@rampaginggeek.com>
(cherry picked from commit cd8f24d9a1ba8563c6bef2b8d30885a753e8d30c)

Change-Id: I2bd72cca994414a88073d26d44bef49e9cac3be1
Reviewed-on: http://gerrit.openafs.org/11626
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Perry Ruiter <pruiter@sinenomine.net>
Reviewed-by: Chas Williams <3chas3@gmail.com>
Reviewed-by: Stephan Wiesand <stephan.wiesand@desy.de>
doc/man-pages/pod1/fs_listquota.pod.in