Disk Quota and Usage Command

Under this Baseline Configuration policy, each HPCMP center shall maintain a command named show_storage. This command allows users to easily identify their quota and usage information for shared storage areas provided on allocated HPC systems: 1) the home file system ($HOME), 2) the primary scratch file system ($WORKDIR), and 3) any additional file systems that a Center chooses to report.

Centers may choose to enhance the command's reporting capabilities through the use of additional command-line options.

Default Report Format:

$ show_storage

                 CENTER_NAME User Disk Storage Information
                 As of HHMM hours TZ on DD MMM YYYY

System     Location     Disk Usage     Disk Quota  File Usage  File Quota
=========  ========  =============  =============  ==========  ==========
system     /p/home           35953      104857600       12345           -
system     /p/work         1285160    53687091200         360           -

The command output shall contain the following information (a hyphen indicates the absence of information for a particular field):

  1. System - The name of the system.
  2. Location - The file system corresponding to the reported storage location.
  3. Disk Usage - The disk storage owned by the user (in KBytes).
  4. Disk Quota - The disk storage quota, if any (in KBytes).
  5. File Usage - The number of files owned by the user.
  6. File Quota - The file count quota, if any.

Because a user's disk usage can change rapidly, centers are encouraged to provide information that is as close to real-time as is feasible.

Back to BC Policy FY10-06.