jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-18 06:50:12 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: Document fs listquota 2TB partition limit

Browse Source 
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 cd8f24d9a1)

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>
This commit is contained in:
Andrew Deason 2014-06-10 14:47:31 -05:00 committed by Stephan Wiesand
parent 1db8a1c134
commit a48e90ddf1
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/man-pages/pod1/fs_listquota.pod.in
View File

@ -90,6 +90,15 @@ volume. Although not directly related to how much of the user's quota is
used, it is reported because a full partition can cause writing of data
back to the volume to fail even when the volume has not reached its quota.
Note that due to limitations in the current wire protocol, OpenAFS cannot
accurately calculate this field for partitions over 2 terabytes (2^41 bytes)
in size. As a result, the percentage displayed in this field may be smaller
than reality. For example, if the partition has over 2 terabytes (2^41 bytes)
free, B<fs listquota> will report the partition usage as 0%. If the partition
has less than 2 terabytes (2^41 bytes) free, but is larger than 2 terabytes
(2^41 bytes) in size, the reported partition usage will be larger than
0%, but will still be less than the actual usage.
=back
=head1 EXAMPLES