LU-15011 lod: count all spilling events

[fs/lustre-release.git] / lustre / doc / llapi_quotactl.3

diff --git a/lustre/doc/llapi_quotactl.3 b/lustre/doc/llapi_quotactl.3
index 87ad80c..f2a467f 100644 (file)
--- a/lustre/doc/llapi_quotactl.3
+++ b/lustre/doc/llapi_quotactl.3
@@ -3,10 +3,7 @@
 llapi_quotactl \- manipulate disk quotas on a Lustre filesystem
 .SH SYNOPSIS
 .nf
 llapi_quotactl \- manipulate disk quotas on a Lustre filesystem
 .SH SYNOPSIS
 .nf

-.B #include <liblustre.h>
-.B #include <lustre/lustre_idl.h>
-.B #include <lustre/liblustreapi.h>
-.B #include <lustre/lustre_user.h>
+.B #include <lustre/lustreapi.h>

 .sp
 .BI "int llapi_quotactl(char" " *mnt," " struct if_quotactl" " *qctl)
 .sp
 .sp
 .BI "int llapi_quotactl(char" " *mnt," " struct if_quotactl" " *qctl)
 .sp


@@ -64,17 +61,20 @@ or
 .IR qc_id .
 .TP 15
 .SB LUSTRE_Q_QUOTAON
 .IR qc_id .
 .TP 15
 .SB LUSTRE_Q_QUOTAON

-Turn on quotas for a Lustre filesystem.
+Turn on quotas for a Lustre filesystem. Deprecated as of 2.4.0.

 .I qc_type
 is USRQUOTA, GRPQUOTA or UGQUOTA (both user and group quotas).
 The quota files must exist; they are normally created with the
 .BR llapi_quotacheck (3)
 .I qc_type
 is USRQUOTA, GRPQUOTA or UGQUOTA (both user and group quotas).
 The quota files must exist; they are normally created with the
 .BR llapi_quotacheck (3)

-call.  This call is restricted to the super-user.
+call.
+
+This call is restricted to the super-user.

 .TP
 .SB LUSTRE_Q_QUOTAOFF
 .TP
 .SB LUSTRE_Q_QUOTAOFF

-Turn off quotas for a Lustre filesystem.
+Turn off quotas for a Lustre filesystem. Deprecated as of 2.4.0.

 .I qc_type
 is USRQUOTA, GRPQUOTA or UGQUOTA (both user and group quotas).
 .I qc_type
 is USRQUOTA, GRPQUOTA or UGQUOTA (both user and group quotas).

+

 This call is restricted to the super-user.
 .TP
 .SB LUSTRE_Q_GETQUOTA
 This call is restricted to the super-user.
 .TP
 .SB LUSTRE_Q_GETQUOTA


@@ -92,6 +92,11 @@ is an empty string and
 is zero then clusterwide limits and usage are returned. On return
 .I obd_dqblk
 contains the requested information (block limits unit is kilobyte).
 is zero then clusterwide limits and usage are returned. On return
 .I obd_dqblk
 contains the requested information (block limits unit is kilobyte).

+.I dqb_btime
+and
+.I dqb_itime
+are block and inode softlimit grace period expiration timestamps for the requested user or group.
+

 Quotas must be turned on before using this command.
 .TP
 .SB LUSTRE_Q_SETQUOTA
 Quotas must be turned on before using this command.
 .TP
 .SB LUSTRE_Q_SETQUOTA


@@ -105,6 +110,7 @@ must be set to QIF_ILIMITS, QIF_BLIMITS or QIF_LIMITS (both inode limits and blo
 must be filled with limits values (as set in
 .I dqb_valid 
 , block limits unit is kilobyte).
 must be filled with limits values (as set in
 .I dqb_valid 
 , block limits unit is kilobyte).

+

 Quotas must be turned on before using this command.
 .TP
 .SB LUSTRE_Q_GETINFO
 Quotas must be turned on before using this command.
 .TP
 .SB LUSTRE_Q_GETINFO


@@ -112,9 +118,9 @@ Get information about quotas.
 .I qc_type
 is either USRQUOTA or GRPQUOTA. On return
 .I dqi_igrace
 .I qc_type
 is either USRQUOTA or GRPQUOTA. On return
 .I dqi_igrace

-is inode grace time (in seconds),
+is the default inode grace period duration for all users or all groups (in seconds),

 .I dqi_bgrace
 .I dqi_bgrace

-is block grace time (in seconds),
+is the default block grace period duration for all users or all groups (in seconds),

 .I dqi_flags
 is not used by the current Lustre version.
 .TP
 .I dqi_flags
 is not used by the current Lustre version.
 .TP


@@ -176,4 +182,5 @@ No disc quota is found for the indicated user.
 Quotas have not been turned on for this filesystem.
 .SH "SEE ALSO"
 .BR lfs (1),
 Quotas have not been turned on for this filesystem.
 .SH "SEE ALSO"
 .BR lfs (1),

-.BR lustre (7)
+.BR lustre (7),
+.BR lustreapi (7)