summaryrefslogtreecommitdiff
path: root/docs-xml
diff options
context:
space:
mode:
authorChristof Schmitt <christof.schmitt@us.ibm.com>2012-03-02 14:26:24 -0700
committerChristian Ambach <ambi@samba.org>2012-03-22 18:41:22 +0100
commit62616784ae5460bfd8f68ccfe596f80f55727b87 (patch)
tree2e860c5e93939fa27affcee669519be687c759d6 /docs-xml
parenta9cfd80d8722f9af7fc18ea70115a6b1b1033168 (diff)
downloadsamba-62616784ae5460bfd8f68ccfe596f80f55727b87.tar.gz
samba-62616784ae5460bfd8f68ccfe596f80f55727b87.tar.bz2
samba-62616784ae5460bfd8f68ccfe596f80f55727b87.zip
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.
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/manpages-3/vfs_gpfs.8.xml47
1 files changed, 47 insertions, 0 deletions
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>