Options for the filestats command

Options to use with the filestats command

You can use the following options with the filestats command:

-g
-u
ages
timetype
sizes
style
file
async

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 user 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 suffixes at the end of a number you specify:

K (kilobytes).
M (megabytes).
G (gigabytes).
* (a special value for listing all unique file sizes, one line per unique size).
Note
Using the * suffix 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.

About the file option

The file option prints the results of the filestats command to the specified output file, rather than the console. The output file is created in the /etc/log directory.

About the async option

The async option causes the filestats command to run independently of the console. This option is designed for use with the file option.

Note
Running more than one asynchronous filestats command simultaneously can adversely affect system performance.