Command ReferenceA-39
NAME
filestats - collect file usage statistics
SYNOP SIS
filestats [ ages ages] [ timetype {a,m,c,cr}] [ sizes sizes] [ snapshot
snapshot_name] [ style style] [ volume volume_name]
DESCRIPTION
The filestats utility provides a summary of file usage within a volume. It must be
used on a snapshot, and the only required argument is the snapshot name. The
volume name defaults to vol0 if not specified. If the volume you are examining
is named otherwise, specify the name explicitly.
OPTIONS
The following options are supported.
ages ages
Specifies the breakdown of ages, as a set of comma-separated time values.
The values are in seconds, but as a convenience you can add an H or D suffix
to a number to get hours and days. For example, 900,4H,7D would pro-
duce a breakdown with 4 categories - files accessed in the last 15 minutes,
files accessed in the last four hours, files accessed in the last week, and all
other files.
expr expression
This lets you specify a boolean expression that will be evaluated for each
inode encountered, and if the expression is true, then the inode will be
selected and included in the various breakdowns of file usage. The expres-
sion can contain variables, which are merely the name of an inode attribute
enclosed in curly braces. For example, {size} is evaluated as the size of the
current inode. The valid inode attributes that you can use in expressions are:
tid The tree id (for qtrees).
type The file type (numeric, currently).
perm Permissions.
flags Additional flags.
nlink Count of hard links.
uid User id (numeric) of file owner.
gid Group id (numeric) of file owner.
size Size in bytes.
blkcnt Size in blocks.
gen Generation number.
filestats