3.5.2. Displaying Quota Limits and Usage

3.5.2. Displaying Quota Limits and Usage

Quota limits and current usage can be displayed for a specific user or group using the gfs_quota get command. The entire contents of the quota file can also be displayed using the gfs_quota list command, in which case all IDs with a non-zero hard limit, warn limit, or value are listed.

Usage

Displaying Quota Limits for a User

gfs_quota get -u User -f MountPoint

Displaying Quota Limits for a Group

gfs_quota get -g Group -f MountPoint

Displaying Entire Quota File

gfs_quota list -f MountPoint
User

A user ID to display information about a specific user. It can be either a user name from the password file or the UID number.

Group

A group ID to display information about a specific group. It can be either a group name from the group file or the GID number.

MountPoint

Specifies the GFS file system to which the actions apply.

Command Output

GFS quota information from the gfs_quota command is displayed as follows:

user User: limit:LimitSize warn:WarnSize value:Value

group Group: limit:LimitSize warn:WarnSize value:Value

The LimitSize, WarnSize, and Value numbers (values) are in units of megabytes by default. Adding the -k, -s, or -b flags to the command line change the units to kilobytes, sectors, or file system blocks, respectively.

User

A user name or ID to which the data is associated.

Group

A group name or ID to which the data is associated.

LimitSize

The hard limit set for the user or group. This value is zero if no limit has been set.

Value

The actual amount of disk space used by the user or group.

Comments

When displaying quota information, the gfs_quota command does not resolve UIDs and GIDs into names if the -n option is added to the command line.

Space allocated to GFS's hidden files can be left out of displayed values for the root UID and GID by adding the -d option to the command line. This is useful when trying to match the numbers from gfs_quota with the results of a du command.

Examples

This example displays quota information for all users and groups that have a limit set or are using any disk space on file system /gfs.

[root@ask-07 ~]# gfs_quota list -f /gfs
user        root:  limit: 0.0        warn: 0.0        value: 0.2       
user         moe:  limit: 1024.0     warn: 0.0        value: 0.0
group       root:  limit: 0.0        warn: 0.0        value: 0.2
group    stooges:  limit: 0.0        warn: 0.0        value: 0.0

This example displays quota information in sectors for group users on file system /gfs.

[root@ask-07 ~]# gfs_quota get -g users -f /gfs -s
group    users:  limit: 0          warn: 96         value: 0

Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.