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 StorageTek QFS or Oracle HSM 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 StorageTek QFS or Oracle HSM 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 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 an Oracle HSM 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:

0 on successful completion.
1 on a usage or argument error.
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

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.