Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME squota - Reports quota information SYNOPSIS squota [-a] [-g] [-h] [-k] [-u] [-O] [file] AVAILABILITY SUNWsamfs SUNWqfs DESCRIPTION The squota command displays file, block, and quota usage statistics. Only a superuser can change quotas (see samquota(1M)). By default, squota(1) writes the user's applicable group ID and user ID quotas and usages on all mounted Sun QFS and SAM-QFS file systems to stdout. An admin set quota applies to a set of files and directories. Typically an admin set quota could be set for a large project that involves users from several groups and spans several files and directories. The admin set IDs must be assigned using the samchaid(1M) command. The samchaid(1M) command allows a system administrator to assign files and directories to individual admin sets. Admin set IDs are not tied to any set of permissions associated with the user. That is, a user can have a set of directories and files on one Sun QFS or SAM-QFS file system with a particular admin set ID, and the same user can have another set of directories and files on another file system (or even the same one) with a completely different admin set ID. A writable file is therefore used as a surrogate to determine that a user has permission to view an admin set's quota values. OPTIONS This command accepts the following options: -a Returns admin set quota statistics. -g Returns group quota statistics. -h Prints a brief usage summary and exits. -k Display all storage units (block quantities) in units of 1024-byte blocks. When specified, all block counts are returned in units of 1024-byte blocks. -u Returns user quota statistics. -O Returns online statistics only. The default is to return total statistics as well as online statistics. file Return the quota information pertaining to file. If file is writeable by the user issuing the command, information about the applicable user, group, and admin set IDs is returned. If file is not writeable by the user issuing the command, information about the quotas for the user's GID and UID on the filesystem that file resides on is returned. EXAMPLES Example 1. The following example is from a system upon which /qfs1 is a mounted Sun QFS file system with group and admin set quotas enabled: server% squota Limits Type ID In Use Soft Hard /qfs1 Files group 101 1 1000 1200 Blocks group 101 8 20000 30000 Grace period 3d No user quota entry. Example 2. The following example is from the same system: server% squota /qfs1/george Limits Type ID In Use Soft Hard /qfs1/george Files admin 12 4 0 0 Blocks admin 12 6824 0 0 Grace period 0s ---> Infinite quotas in effect. /qfs1/george Files group 101 1 1000 1200 Blocks group 101 8 20000 30000 Grace period 3d No user quota entry. Example 3. The following example is from a SAM-QFS file system: server% squota /sam1/adams Online Limits Total Limits Type ID In Use Soft Hard In Use Soft Hard /sam1/adams Files admin 12 4 0 0 4 0 0 Blocks admin 12 6824 0 0 3950 0 0 Grace period 0s ---> Infinite quotas in effect. /sam1/adams Files group 101 1 1000 1200 1 0 0 Blocks group 101 8 20000 30000 8 100000 120000 Grace period 3d /sam6 Files user 130 11 15 2000 11 15 6000 Blocks user 130 320 400 200000 560* 500 700000 Grace period 0s 0s ---> Total soft limits under enforcement (since 18h10m1s ago) EXIT STATUS This command returns the following: o 0 on successful completion. o 1 on a usage or argument error. o 10 on an execution error. FILES filesytem/.quota_a Admin set quota information filesystem/.quota_g Group quota information filesystem/.quota_u User quota information SEE ALSO samquota(1M) samfsck(1M) passwd(4) - User ID information group(4) - Group ID information DIAGNOSTICS No user quota entry. User quotas are not active on the file system. No group quota entry. Group quotas are not active on the file system. No admin quota entry. Admin set quotas are not active on the file system.