xref: /illumos-gate/usr/src/man/man8/ff.8 (revision bbf21555)
te
Copyright 1989 AT&T Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
FF 8 "Feb 10, 1997"
NAME
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(7) for the description of the behavior of ff when encountering files greater than or equal to 2 Gbyte ( 2^31 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

SEE ALSO

find(1), ncheck(8), stat(2), vfstab(5), attributes(7), largefile(7) 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).)