ff

- list file names and statistics for a file system

Synopsis

ff [-F FSType] [-V] [generic_options] [-o specific_options] special...

Description

ff prints the pathnames and inode numbers of files in the file system which resides on the special device special. Other information about the files may be printed using options described below. Selection criteria may be used to instruct ff to only print information for certain files. If no selection criteria are specified, information for all files considered will be printed (the default); the -i option may be used to limit files to those whose inodes are specified.

Output is sorted in ascending inode number order. The default line produced by ff is:

path-name i-number

The maximum information the command will provide is:

path-name i-number size uid

Options

-F

Specify the FSType on which to operate. The FSType should either be specified here or be determinable from /etc/vfstab by matching the special with an entry in the table, or by consulting /etc/default/fs.

-V

Echo the complete command line, but do not execute the command. The command line is generated by using the options and arguments provided by the user and adding to them information derived from /etc/vfstab. This option may be used to verify and validate the command line.

generic_options

Options that are supported by most FSType-specific modules of the command. The following options are available:

-I

Do not print the i-node number after each path name.

-l

Generate a supplementary list of all path names for multiply-linked files.

-p prefix

The specified prefix will be added to each generated path name. The default is `.' (dot).

-s

Print the file size, in bytes, after each path name.

-u

Print the owner's login name after each path name.

-a -n

Select if the file has been accessed in n days.

-m -n

Select if the file has been written or created in n days.

-c -n

Select if file's status has been changed in n days.

-n file

Select if the file has been modified more recently than the argument file.

-i i-node-list

Generate names for only those i-nodes specified in i-node-list. i-node-list is a list of numbers separated by commas (with no intervening spaces).

-o

Specify FSType-specific options in a comma separated (without spaces) list of suboptions and keyword-attribute pairs for interpretation by the FSType-specific module of the command.

Operands

special

A special device.

Usage

See largefile(5) for the description of the behavior of ff when encountering files greater than or equal to 2 Gbyte ( 2³¹ bytes).

Files

/etc/default/fs

default local file system type. Default values can be set for the following flags in /etc/default/fs. For example: LOCAL=ufs

LOCAL

The default partition for a command if no FSType is specified.

/etc/vfstab

list of default parameters for each file system

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

find(1), ncheck(1M), stat(2), vfstab(4), attributes(5), largefile(5) Manual pages for the FSType-specific modules of ff.

Notes

This command may not be supported for all FSTypes.

The -a, -m, and -c flags examine the st_atime, st_mtime, and st_ctime fields of the stat structure respectively. (See stat(2).)