Filter
Top Products
Command Reference A-39
NAME
filestats - collect file usage statistics
SYNOPSIS
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