volume quota report

Description​

This command displays the quota report for all volumes in each Vserver that are online and for which quotas are activated. Quota report includes the quota rules (default, explicit, and derived) in effect and the associated resource usage (disk space and files). If quotas are still initializing for a specific volume, that volume is not included.

This command displays the following information:

• Vserver name

• Volume name

• Index - This is a unique number within a volume assigned to each quota rule displayed in the quota report.

• Tree name - This field gives the name of the qtree if the quota rule is at the qtree level. It is empty if the quota rule is at the volume level.

• Quota type - Type of quota rule (tree or user or group).

• Quota target - This field gives the name of the target of the quota rule. For tree quota rules, it will be the qtree ID of the qtree. For user quota rules, it will be the UNIX user name or the Windows user name. For group quota rules, it will be the UNIX group name. For default rules (tree or user or group), this will display "*". If the UNIX user identifier, UNIX group identifier, or Windows security identifier no longer exists or if the identifier-to-name conversion fails, the target appears in numeric form.

• Quota target ID - This field gives the target of the quota rule in numeric form. For tree quota rules, it will be the qtree ID of the qtree. For group quota rules, it will be the UNIX group identifier. For UNIX user quota rules, it will be the UNIX user identifier. For Windows user quota rules, it will be the Windows security identifier in its native format. For default rules (tree or user or group), "*" will be displayed.

• Disk space used - For a default quota, the value is 0.

• Disk space limit

• Soft disk space limit

• Threshold for disk space limit

• Files used - For a default quota, the value is 0.

• File limit

• Soft file limit

• Quota specifier - For an explicit quota, this field shows how the quota target was configured by the administrator using the volume quota policy rule command. For a default quota, the field shows "*". For a derived tree quota, this field shows the qtree path. For a derived user and group quota, the field is either blank or "*".

The following parameters: -soft, -soft-limit-thresholds, -target-id, -thresholds, -fields and -instance display different set of fields listed above. For example, -soft will display the soft disk space limit and soft file limit apart from other information. Similarly -target-id will display the target in the numeric form.

A quota report is a resource intensive operation. If you run it on many volumes in the cluster, it might take a long time to complete. A more efficient way would be to view the quota report for a particular volume in a Vserver.

Depending upon the quota rules configured for a volume, the quota report for a single volume can be large. If you want to monitor the quota report entry for a particular tree/user/group repeatedly, find the index of that quota report entry and use the -index field to view only that quota report entry. See the examples section for an illustration.

Parameters​

{ [-fields <fieldname>, ...]

If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-soft ]

If this parameter is specified, the command display will include the soft disk space limit and the soft file limit.

| [-soft-limit-thresholds ]

If this parameter is specified, the command display will include the soft disk space limit, threshold for disk space limit and soft file limit.

| [-target-id ]

If this parameter is specified, the command will display the target of a user or group quota rule in numeric form.

| [-thresholds ]

If this parameter is specified, the command display will include the threshold for disk space limit.

| [-instance ]}

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Name

If this parameter is specified, the command displays the quota report for volumes in the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter is specified, the command displays the quota report for the specified volume.

[-index <integer>] - Index

If this parameter is specified, the command displays the quota report for the quota rules that have the specified index.

[-tree <qtree name>] - Qtree Name

If this parameter is specified, the command displays the quota report for the quota rules that have the specified qtree name.

[-quota-type <text>] - Quota Type

If this parameter is specified, the command displays the quota report for the quota rules of the given type.

[-quota-target <text>, ...] - Quota Target

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota target.

[-quota-target-id <text>, ...] - Quota Target ID

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota target identifier.

[-disk-used {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Used

If this parameter is specified, the command displays the quota report for the quota rules that have the specified disk space used value.

[-disk-limit {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified disk space limit.

[-files-used <integer>] - Files Used

If this parameter is specified, the command displays the quota report for the quota rules that have the specified files used value.

[-file-limit <integer>] - Files Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified file limit.

[-threshold {<integer>[KB|MB|GB|TB|PB]}] - Disk Space Threshold

If this parameter is specified, the command displays the quota report for the quota rules that have the specified threshold for disk space limit.

[-soft-disk-limit {<integer>[KB|MB|GB|TB|PB]}] - Soft Disk Space Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified soft disk space limit.

[-soft-file-limit <integer>] - Soft Files Limit

If this parameter is specified, the command displays the quota report for the quota rules that have the specified soft file limit.

[-quota-specifier <text>] - Quota Specifier

If this parameter is specified, the command displays the quota report for the quota rules that have the specified quota specifier.

[-path <text>] - Path

If this parameter is specified, the command will display the quota report for the quota rules that are applicable for the file in the specified path. The format of the path to the file should begin with /vol/<volume name>/. The quota rules that are applicable typically consists of the tree quota rule corresponding to the qtree in which the file resides within the volume, user quota rule at the volume and qtree level corresponding to the UNIX user identifier or the Windows security identifier associated with the file and the group quota rule at the volume and qtree level corresponding to the UNIX group identifier associated with the file.

[-disk-used-pct-soft-disk-limit <percent_no_limit>] - Disk Space Used % Soft Disk Space Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and soft-disk-limit.

[-disk-used-pct-threshold <percent_no_limit>] - Disk Space Used % Disk Space Threshold

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and threshold.

[-disk-used-pct-disk-limit <percent_no_limit>] - Disk Space Used % Disk Space Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from disk-used and disk-limit.

[-files-used-pct-soft-file-limit <percent_no_limit>] - Files Used % Soft File Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from files-used and soft-file-limit.

[-files-used-pct-file-limit <percent_no_limit>] - Files Used % File Limit

If this parameter is specified, the command displays the quota report for entries that have the specified percent utilization. The attribute value is computed from files-used and file-limit.