From 62616784ae5460bfd8f68ccfe596f80f55727b87 Mon Sep 17 00:00:00 2001
From: Christof Schmitt <christof.schmitt@us.ibm.com>
Date: Fri, 2 Mar 2012 14:26:24 -0700
Subject: s3:vfs_gpfs: Report disk space and usage on GPFS share according to
 quotas

When a client requests the information about free space and space used,
adjust the reported values according to quotas in the GPFS file system:

- Retrieve quotas for the current user, current group and fileset for
  the top level of the share.
- If the soft block quota grace time has expired, report disk as full.
- If a hard block quota has been exceeded, report disk as full.
- If none of the hard block quotas been exceeded, report
  share size and free space according to the lowest limits found in
  the quotas.
- If no applicable hard block quota has been set, report the
  information from the statfs call.

This feature is disabled by default and has to be enabled by setting the
option gpfs:dfreequota.
---
 docs-xml/manpages-3/vfs_gpfs.8.xml | 47 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

(limited to 'docs-xml/manpages-3/vfs_gpfs.8.xml')

diff --git a/docs-xml/manpages-3/vfs_gpfs.8.xml b/docs-xml/manpages-3/vfs_gpfs.8.xml
index 2107b74a6c..398dcff255 100644
--- a/docs-xml/manpages-3/vfs_gpfs.8.xml
+++ b/docs-xml/manpages-3/vfs_gpfs.8.xml
@@ -221,6 +221,53 @@
 		</varlistentry>
 		<varlistentry>
 
+		<term>gpfs:dfreequota = [ yes | no ]</term>
+		<listitem>
+		<para>
+		Adjust reporting of the size and free space of a share
+		according to quotas. If this setting is "yes", a
+		request for size and free space will also evaluate the
+		following quotas:
+		</para>
+
+		<itemizedlist>
+		<listitem><para>The user quota of the user requesting
+		    the data.</para></listitem>
+		<listitem><para>The group quota of the primary group
+		    of the user.</para></listitem>
+		<listitem><para>The fileset quota for the fileset
+		    containing the top level directory of the share.
+		</para></listitem>
+		</itemizedlist>
+
+		<para>
+		If any of the soft or hard quota limits has been
+		reached, the free space will be reported as 0. If a
+		quota is in place, but the limits have not been
+		reached, the free space will be reported according to
+		the space left in the quota. If more than one quota
+		applies the free space will be reported as the smallest
+		space left in those quotas. The size of the share
+		will be reported according to the quota usage. If more
+		than one quota applies, the smallest size will be
+		reported for the share size according to these quotas.
+		</para>
+
+		<itemizedlist>
+		<listitem><para>
+		<command>yes</command> - include the quotas
+		when reporting the share size and free space
+		</para></listitem>
+		<listitem><para>
+		<command>no(default)</command> - do not include quotas,
+		simply report the size and free space of the file system
+		</para></listitem>
+		</itemizedlist>
+		</listitem>
+
+		</varlistentry>
+		<varlistentry>
+
 		<term>nfs4:mode = [ simple | special ]</term>
 		<listitem>
 		<para>
-- 
cgit