Shows quota and quota usage information for filesets and disk size and usage information for aggregates or partitions
Synopsis
fts lsquota [{-path {filename | directory_name}... | -fileset {name | ID}...}]
[-cell cellname]
[{-noauth | -localauth}] [-verbose] [-help]
Options
-path filename or directory_name
Names a file or directory from each fileset about which quota, size, and usage information is to be displayed. Include
filenames or directory names from different filesets if desired. It is not necessary to name more than one file or directory from the same fileset. Use this option or use -fileset; omit
both options to display information about the fileset containing the current working directory.
-fileset name or ID
Specifies the complete name or fileset ID number of each fileset about which quota, size, and usage information is to be displayed. Use
this option or use -path; omit both options to display information about the fileset that contains the current working directory.
-cell cellname
Specifies the cell with respect to which the command is to be run. The default is the local cell of the issuer of the command.
-noauth
Directs fts to use the unprivileged identity nobody as the identity of the issuer of the command. Generally, the -noauth option is included
if DFS authorization checking is disabled on a server machine on which administrative privilege is required or if the Security Service is unavailable. If you use this option, do not use the
-localauth option.
-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-verbose
Directs fts to provide detailed information about its actions during command execution.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The fts lsquota command displays quota and quota usage information about filesets and disk size and usage information about the partitions or aggregates on
which the filesets reside. Use the -path option to specify a file or directory on a fileset to see information about that fileset; use the -fileset option to specify the name or ID
number of a fileset to see information about that fileset; omit both options to see information about the fileset that contains the current working directory.
For DCE LFS filesets, the fts lsquota command displays the quota and quota use (in kilobytes) and the percentage of the quota in use. For both DCE LFS and non-LFS filesets, this command displays the name of the fileset, information about the number of available kilobytes on the aggregate or partition on which the fileset resides, the number of kilobytes in use on the aggregate or partition, and the percentage of the aggregate or partition in use. It also reports whether the device is a DCE LFS aggregate or a non-LFS partition.
The size of a non-LFS fileset is equal to the size of the partition on which it resides. Therefore, the size and usage information displayed for the partition (non-LFS aggregate) in the output of the fts lsquota command equals the quota and quota usage information of the fileset on the partition. Using this command with a non-LFS fileset is analogous to using the UNIX df command with the partition on which the fileset resides. (Note that the df command can be used to display the size of exported DCE LFS aggregates and locally mounted DCE LFS filesets, but it cannot be used to display the size of a DCE LFS fileset that is not mounted locally.)
The fts lsheader and fts lsft commands can be used to display the quota of a DCE LFS fileset. The fts aggrinfo command can be used to display the total disk space on an aggregate and the amount currently available.
By default, every newly created DCE LFS fileset has a quota of 5000 kilobytes. The fts setquota command can be used to increase or decrease the quota of a DCE LFS fileset. Because the quota of a DCE LFS fileset does not represent the amount of physical data stored on the fileset, it can be larger than the size of the aggregate on which the fileset resides. Similarly, the combined quotas of all filesets on an aggregate can be larger than the size of the aggregate.
The quota of a non-LFS fileset cannot be changed via DFS. (The fts setquota command works only with DCE LFS filesets.)
Privilege Required
No privileges are required.
Output
This command displays the following information about each specified fileset:
· The name of the fileset
· The quota, in kilobytes, of the fileset (DCE LFS only)
· The number of kilobytes of the quota currently in use on the fileset (DCE LFS only)
· The percentage of the quota currently in use on the fileset (DCE LFS only)
· The percentage of available disk space currently in use on the aggregate or partition on which the fileset resides
· The number of kilobytes of disk space in use and available on the aggregate or partition on which the fileset resides
· The file system type of the aggregate (LFS or non-LFS)
If the fileset quota usage rises above 90% or the aggregate or partition usage rises above 97%, the appropriate percentage is indicated with << and the message <<WARNING is displayed at the end of the output line.
Note: Because each non-LFS partition contains a single fileset, the information displayed for a non-LFS partition applies to the single non-LFS fileset it houses. Ignore the quota, quota usage, and quota usage percentage values displayed for a non-LFS fileset; they are always 0 (zeros). Consult the disk size, usage, and percentage values displayed for the partition on which the non-LFS fileset resides to determine the corresponding values for the fileset.
Examples
The following command lists quota and quota usage information for the fileset that contains the directory named /.../abc.com/fs/usr/terry, and it displays size
and usage information for the aggregate that contains this fileset. The command also displays size and usage information for the partition that contains the directory named
/.../abc.com/fs/usr/jlw. The first directory resides on the DCE LFS fileset named user.terry; the quota of the DCE LFS fileset is less than the size of the aggregate on which it is
located. The second directory resides on the non-LFS fileset named user.jlw; the quota of the non-LFS fileset is the same as the size of the partition on which it is located.
$ fts lsq /.../abc.com/fs/usr/terry /.../abc.com/fs/usr/jlw
Fileset Name Quota Used % Used Aggregate
user.terry 15000 5071 34% 86% = 84538/98300 (LFS)
user.jlw 0 0 0% 84% = 8448/10000 (non-LFS)
The following command lists quota and usage information for the DCE LFS fileset named user.jean, and size and usage information for the aggregate on which the fileset resides. The <<WARNING message directs the issuer's attention to the fact that the percentage of the quota in use on the indicated fileset is well above the warning level of 90%.
$ fts lsq -f user.jean
Fileset Name Quota Used % Used Aggregate
user.jean 5000 4955 99%<< 92% = 87436/98300 (LFS) <<WARNING
Related Information
Commands: fts aggrinfo(8dfs)