usr/src/man/man1m/ff.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1997, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH FF 1M "Feb 10, 1997"
   7 .SH NAME
   8 ff \- list file names and statistics for a file system
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBff\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR] \fIspecial\fR...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBff\fR prints the pathnames and inode numbers of files in the file system
  19 which resides on the special device \fIspecial\fR. Other information about the
  20 files may be printed using options described below.  Selection criteria may be
  21 used to instruct  \fBff\fR to only print information for certain files. If no
  22 selection criteria are specified, information for all files considered will be
  23 printed (the default); the \fB-i\fR option may be used to limit files to those
  24 whose inodes are specified.
  25 .sp
  26 .LP
  27 Output is sorted in ascending inode number order.   The default line produced
  28 by \fBff\fR is:
  29 .sp
  30 .LP
  31 \fIpath-name\fR \|i-number
  32 .sp
  33 .LP
  34 The maximum information the command will provide is:
  35 .sp
  36 .LP
  37 \fIpath-name\fR \|i-number \|size \|uid
  38 .SH OPTIONS
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fB-F\fR\fR
  43 .ad
  44 .RS 19n
  45 Specify the  \fIFSType\fR on which to operate. The  \fIFSType\fR should either
  46 be specified here or be determinable from  \fB/etc/vfstab\fR by matching the
  47 \fIspecial\fR with an entry in the table, or by consulting
  48 \fB/etc/default/fs\fR.
  49 .RE
  50
  51 .sp
  52 .ne 2
  53 .na
  54 \fB\fB-V\fR\fR
  55 .ad
  56 .RS 19n
  57 Echo the complete command line, but do not execute the command. The command
  58 line is generated by using the options and arguments provided by the user and
  59 adding to them information derived from  \fB/etc/vfstab\fR. This option may be
  60 used to verify and validate the command line.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fIgeneric_options\fR\fR
  67 .ad
  68 .RS 19n
  69 Options that are supported by most FSType-specific modules of the command.  The
  70 following options are available:
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fB-I\fR\fR
  75 .ad
  76 .RS 18n
  77 Do not print the i-node number after each path name.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-l\fR\fR
  84 .ad
  85 .RS 18n
  86 Generate a supplementary list of all path names for multiply-linked files.
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-p\fR\fI prefix\fR\fR
  93 .ad
  94 .RS 18n
  95 The specified \fIprefix\fR will be added to each generated path name. The
  96 default is `.' (dot).
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fB-s\fR\fR
 103 .ad
 104 .RS 18n
 105 Print the file size, in bytes, after each path name.
 106 .RE
 107
 108 .sp
 109 .ne 2
 110 .na
 111 \fB\fB-u\fR\fR
 112 .ad
 113 .RS 18n
 114 Print the owner's login name after each path name.
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fB-a\fR \fB-\fR\fIn\fR\fR
 121 .ad
 122 .RS 18n
 123 Select if the file has been accessed in \fIn\fR days.
 124 .RE
 125
 126 .sp
 127 .ne 2
 128 .na
 129 \fB\fB-m\fR \fB-\fR\fIn\fR\fR
 130 .ad
 131 .RS 18n
 132 Select if the file has been written or created in \fIn\fR days.
 133 .RE
 134
 135 .sp
 136 .ne 2
 137 .na
 138 \fB\fB-c\fR \fB-\fR\fIn\fR\fR
 139 .ad
 140 .RS 18n
 141 Select if file's status has been changed in \fIn\fR days.
 142 .RE
 143
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fB-n\fR\fI file\fR\fR
 148 .ad
 149 .RS 18n
 150 Select if the file has been modified more recently than the argument
 151 \fBfile\fR.
 152 .RE
 153
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fB-i\fR\fI i-node-list\fR\fR
 158 .ad
 159 .RS 18n
 160 Generate names for only those i-nodes specified in \fIi-node-list\fR.
 161 \fIi-node-list\fR is a list of numbers separated by commas (with no intervening
 162 spaces).
 163 .RE
 164
 165 .RE
 166
 167 .sp
 168 .ne 2
 169 .na
 170 \fB\fB-o\fR\fR
 171 .ad
 172 .RS 19n
 173 Specify  \fIFSType\fR-specific options in a comma separated (without spaces)
 174 list of suboptions and keyword-attribute pairs for interpretation by the
 175 \fIFSType\fR-specific module of the command.
 176 .RE
 177
 178 .SH OPERANDS
 179 .sp
 180 .ne 2
 181 .na
 182 \fB\fIspecial\fR\fR
 183 .ad
 184 .RS 11n
 185 A special device.
 186 .RE
 187
 188 .SH USAGE
 189 .sp
 190 .LP
 191 See \fBlargefile\fR(5) for the description of the behavior of \fBff\fR when
 192 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 193 .SH FILES
 194 .sp
 195 .ne 2
 196 .na
 197 \fB\fB/etc/default/fs\fR\fR
 198 .ad
 199 .RS 19n
 200 default local file system type. Default values can be set for the following
 201 flags in \fB/etc/default/fs\fR. For example: \fBLOCAL=ufs\fR
 202 .sp
 203 .ne 2
 204 .na
 205 \fB\fBLOCAL\fR\fR
 206 .ad
 207 .RS 9n
 208 The default partition for a command if no FSType is specified.
 209 .RE
 210
 211 .RE
 212
 213 .sp
 214 .ne 2
 215 .na
 216 \fB\fB/etc/vfstab\fR\fR
 217 .ad
 218 .RS 19n
 219 list of default parameters for each file system
 220 .RE
 221
 222 .SH SEE ALSO
 223 .sp
 224 .LP
 225 \fBfind\fR(1), \fBncheck\fR(1M), \fBstat\fR(2), \fBvfstab\fR(4),
 226 \fBattributes\fR(5), \fBlargefile\fR(5) Manual pages for the
 227 \fIFSType\fR-specific modules of \fBff\fR.
 228 .SH NOTES
 229 .sp
 230 .LP
 231 This command may not be supported for all  \fIFSTypes\fR.
 232 .sp
 233 .LP
 234 The  \fB-a\fR, \fB-m\fR, and \fB-c\fR flags examine the  \fBst_atime\fR,
 235 \fBst_mtime\fR, and \fBst_ctime\fR fields of the \fBstat\fR structure
 236 respectively.  (See \fBstat\fR(2).)