showfsets(8) System Manager's Manual showfsets(8)
showfsets - Display information about filesets in an AdvFS file domain
/sbin/showfsets [-b | -q] [-k] domain [fileset...]
Lists the names of the filesets in a file domain, without additional detail. Displays the total number of blocks and the number of free 1K
blocks. Displays the quota limits for filesets in a domain.
Specifies the full path name of the AdvFS file domain. Specifies the name of one or more filesets in the file domain.
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: 2be95ef4.000a129
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 a 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 (B) and file (F) usage limits. A + in this field means that the soft limit 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).
Specifies the number of files used, the soft and hard file limits for the fileset, and the grace period remaining.
On a TruCluster Server, showfsets can sometimes report incorrect disk usage. Data in CFS client caches is synchronized to the server
at least every 30 seconds. The disk usage reported does not account for dirty data in client caches that has not yet been synchro-
nized to the server.
The following example shows the command line and resulting display for the showfsets command: # showfsets usr_domain
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
Id : 2f1dabd6.00059d50.3.8052
Clone of : usr
Revision : 82 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
Commands: chfsets(8), mkfset(8), rmfset(8)
File Formats: advfs(4)