squota(1)

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.