'\"macro stdmacro
.if n .pH g1a.ff_ufs @(#)ff_ufs	40.7 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} ff 1M "UFS" "\&"
.if \nX=1 .ds x} ff 1M "UFS"
.if \nX=2 .ds x} ff 1M "" "\&"
.if \nX=3 .ds x} ff "" "" "\&"
.TH \*(x}
.SH NAME
\f4ff\f1 (ufs) \- list file names and statistics for a \f4ufs\fP file system
.SH SYNOPSIS
\f4ff\f1
[
\f4\-F ufs\f1
]
[\f2generic_options\f1]
[
\f4\-o a,m,s\f1
]
.I special 
\&.\|.\|.
.SH DESCRIPTION
.I generic_options
are options supported by the generic \f4ff\f1 command.
.PP
\f4ff\f1
reads the i-list and directories of the 
.I special 
file, assuming it is a file system.
Inode data is saved for files which match
the selection criteria.
Output consists of the path name for each saved inode,
plus other file information requested using the
options below.
Output fields are positional.
The output is produced in inode order;
fields are separated by
.SM TAB
characters.
The default line produced by
\f4ff\f1
is:
.PP
.RS
.I path-name \|i-number
.RE
.P
The options are:
.PP
.TP
\f4\-F ufs\f1
Specifies the \f4ufs\f1-FSType.
.TP
\f4\-o\f1
Specify
\f4ufs\f1 file system specific options.
The options available are:
.RS
.TP
\f5a\f1
Print the
\f1`\f4.\f1'
and
\f1`\f4.\|.\f1'
directory entries.
.TP
\f4m\f1
Print mode information.
.TP
\f4s\f1
Print only special files and files with set-user-ID mode.
.RE
.SH NOTE
.LP
If the
\f4\-l\f1
option is not specified,
only a single path name out of all possible ones is generated for a 
multiply-linked inode. 
If
\f4\-l\f1
is specified, 
all possible names for every linked file on the file system are included
in the output.
However, no selection criteria apply to the names generated.
.SH "SEE ALSO"
\f4find\fP(1),
generic \f4ff\fP(1M),
\f4ncheck\fP(1M).
