showfsets(8) — Maintenance
NAME
showfsets − displays information about the filesets in a file domain
SYNOPSIS
/sbin/showfsets [−b|−q] [−k] domain [fileset...]
OPTIONS
−bLists the names of the filesets in a domain, without additional detail.
−kDisplays the total number of blocks and the number of free blocks in terms of 1K blocks instead of the default 512-byte blocks.
−qDisplays quota limits for filesets in a domain.
OPERANDS
domain
Specifies the full path name of the file domain.
fileset
Specifies the name of one or more filesets.
DESCRIPTION
The showfsets command displays the filesets (or clone filesets) and their characteristics in a specified domain. The characteristics of a fileset are:
•Fileset Identifier
A fileset identifier is a combination of the file-domain identifier and an additional set of numbers that identify the fileset within the file domain. For example, the fileset identifier 2be95ef4.000a129.1.8001 consists of the following:
File-domain identifier
2be95ef4.000a129
Fileset-specific numbers
1.8001
•Clone status
The status items of a clone fileset vary, depending on the fileset. Status items can include:
—
Clone is
Specifies the name of a clone fileset, if one exists for the parent fileset.
—
Clone of
Specifies the name of the parent fileset, if the displayed fileset is clone fileset.
—
Revision
Specifies the number of times you revised a clone fileset. For example, if you recreate a clone fileset of the same parent fileset three times, the revision value is 3.
•Files
Specifies the number of files in the fileset and the current file usage limits (quotas). SLim, the soft limit, is a quota that can be exceeded for a fixed period of time and HLim, the hard limit, is a quota that cannot be exceeded.
•Blocks
Specifies the number of blocks that are in use by a mounted fileset and the current block soft and hard usage limits (quotas). For filesets that are not mounted, zero blocks will display. For an accurate display, the fileset must be mounted.
•Quota Status
Specifies which quota types are enabled (enforced).
The showfsets command with the −q option set displays block and file information for a specified domain or for one or more named filesets in the domain. The characteristics of a named fileset are:
•BF (block flag)
Specifies block usage limits. A + in this field means that the soft block usage is exceeded; a ∗ means that the hard limit is reached.
•Block (512) Limits
Specifies the number of blocks used, the soft limit (the number of blocks that can be exceeded for a period of time), the hard limit (the number of blocks that cannot be exceeded), and the grace period (the remaining time for which the soft limit may be exceeded).
•File Limits
Specifies the number of files used, the soft and hard file limits for the fileset, and the grace period remaining.
RESTRICTIONS
You must have root-user privilege to access this command if the file domain is inactive (filesets unmounted).
EXAMPLES
1.The following example shows the command line and resulting display for the showfsets command:
# showfsets usr_domain
usr
Id : 2f1dabd6.00059d50.1.8001
Clone is : usr_clone
Files : 17644, SLim= 0, HLim= 0
Blocks (512) : 90582, SLim= 212000, HLim= 256000
Quota Status : user=on group=on
usr_clone
Id : 2f1dabd6.00059d50.3.8052
Clone of : usr
Revision : 82
2.The following example shows the command line and resulting display when the fileset quota option is set:
# showfsets -q test_domain
Block (512) Limits File Limits
Fileset BF used soft hard grace used soft hard grace
fileset1 +- 1750 1500 2000 11:32 35 300 400