Options for the filestates command

Options to use with the filestats command

You can use the following options with the filestats command:

-g
-u
ages
timetype
sizes
style

About the group list option

The -g option of the filestats command enables you to generate separate file usage summaries for each group ID. For each group ID, a separate table containing information about file sizes and ages is listed.

About the user list option

The -u option of the filestats command enables you to generate separate file usage summaries for each user ID. For each group ID, a separate table containing information about file sizes and ages is listed.

About the ages option

The ages option of the filestats command enables you to see when files have been accessed. You can specify file ages in seconds, hours, and days, using a comma to separate each value. By default, file ages are broken down by days, in 30-day increments.

Example of the ages option

To display files with ages under 900 seconds (15 minutes), under 4 hours, and under 7 days, enter the following command:

filestats ages 900,4H,7D volume vol0 snapshot hourly.1

The age section of the output looks like the following:

AGE(ATIME)       CUMULATIVE COUNT       CUMULATIVE TOTAL KB

900              0                      0

4H               0                      0

7D               785                    21568

MAX              882                    146000

For an example of the entire filestats command output, see Example with no options specified.

About the timetype option

The timetype option enables you to specify the time types that you want to list in the age comparison.

The following table describes the valid timetype values you can use with the timetype option.

Value	Definition
`a`	Access time
`m`	Modification time
`c`	File change time (last size/status change)
`cr`	File creation time

About the sizes option

The sizes option enables you to specify the breakdown of sizes, using a comma to separate each value. Default values are in bytes, but you can also use the following three suffixes at the end of a number you specify:

K (kilobytes)
M (megabytes)
G (gigabytes)
* (a special value you use to list all unique file sizes, one line per unique size. Using this command can result in output of several thousands of lines.)

Example of the sizes option

To display file sizes in four categories--files with less than 500 kilobytes, files with less than 2 megabytes, files with less than 1 gigabyte, and all other files-- enter the following command:

filestats sizes 500K,2M,1G volume vol0 snapshot hourly.1

The file size section of the output looks like the following:

FILE SIZE        CUMULATIVE COUNT       CUMULATIVE TOTAL KB

500K             862                    4969

2M               866                    10748

1G               882                    146000

MAX              882                    146000

For an example of the entire filestats command output, see Example with no options specified.

About the style option

The style option controls the output style. The three style option arguments are as follows:

readable. This is the default and is what you see when you use the filestats command with no style option.
table. Use the table argument when the filestats output will be used by processing programs.
html. Use the html argument for output that will be read by a Web browser.