[BACK]Return to find.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / find

Diff for /src/usr.bin/find/find.1 between version 1.83 and 1.84

version 1.83, 2012/01/02 23:19:45 version 1.84, 2012/01/03 08:42:00
Line 144 
Line 144 
 Where more than one of these options is specified,  Where more than one of these options is specified,
 the last option given overrides the others.  the last option given overrides the others.
 .Sh PRIMARIES  .Sh PRIMARIES
 .Bl -tag -width Ds  .Bl -tag -width Ds -compact
 .It Ic -amin Ar n  .It Ic -amin Ar n
 True if the difference between the file last access time and the time  True if the difference between the file last access time and the time
 .Nm  .Nm
 was started, rounded up to the next full minute, is  was started, rounded up to the next full minute, is
 .Ar n  .Ar n
 minutes.  minutes.
   .Pp
 .It Ic -anewer Ar file  .It Ic -anewer Ar file
 True if the current file has a more recent last access time than  True if the current file has a more recent last access time than
 .Ar file .  .Ar file .
   .Pp
 .It Ic -atime Ar n  .It Ic -atime Ar n
 True if the difference between the file last access time and the time  True if the difference between the file last access time and the time
 .Nm  .Nm
 was started, rounded up to the next full 24-hour period, is  was started, rounded up to the next full 24-hour period, is
 .Ar n  .Ar n
 24-hour periods.  24-hour periods.
   .Pp
 .It Ic -cmin Ar n  .It Ic -cmin Ar n
 True if the difference between the time of last change of file status  True if the difference between the time of last change of file status
 information and the time  information and the time
Line 167 
Line 170 
 was started, rounded up to the next full minute, is  was started, rounded up to the next full minute, is
 .Ar n  .Ar n
 minutes.  minutes.
   .Pp
 .It Ic -cnewer Ar file  .It Ic -cnewer Ar file
 True if the current file has a more recent last change time than  True if the current file has a more recent last change time than
 .Ar file .  .Ar file .
   .Pp
 .It Ic -ctime Ar n  .It Ic -ctime Ar n
 True if the difference between the time of last change of file status  True if the difference between the time of last change of file status
 information and the time  information and the time
Line 177 
Line 182 
 was started, rounded up to the next full 24-hour period, is  was started, rounded up to the next full 24-hour period, is
 .Ar n  .Ar n
 24-hour periods.  24-hour periods.
   .Pp
 .It Ic -depth  .It Ic -depth
 This primary always evaluates to true.  This primary always evaluates to true.
 The same as specifying the  The same as specifying the
 .Fl d  .Fl d
 option.  option.
   .Pp
 .It Ic -empty  .It Ic -empty
 True if the current file or directory is empty.  True if the current file or directory is empty.
   .Pp
 .It Xo  .It Xo
 .Ic -exec Ar utility  .Ic -exec Ar utility
 .Op argument ...  .Op argument ...
Line 192 
Line 200 
 .It Xo  .It Xo
 .Ic -exec Ar utility  .Ic -exec Ar utility
 .Op argument ...  .Op argument ...
 .No {}  .No {} +
 +  
 .Xc  .Xc
 Execute the specified  Execute the specified
 .Ar utility .  .Ar utility .
Line 211 
Line 218 
 appears anywhere in the utility name or the  appears anywhere in the utility name or the
 arguments it is replaced by the pathname of the current file.  arguments it is replaced by the pathname of the current file.
 .Pp  .Pp
 If terminated by a plus sign  If terminated by a plus sign,
 .Pq Dq \&+ ,  
 the pathnames for which the  the pathnames for which the
 primary is evaluated are aggregated into sets, and  primary is evaluated are aggregated into sets, and
 .Ar utility  .Ar utility
 will be invoked once per set, similar to  will be invoked once per set, similar to
 .Xr xargs 1 .  .Xr xargs 1 .
 If any invocation exits with non-zero exit status, then  If any invocation exits with a non-zero exit status, then
 .Nm  .Nm
 will eventually do so as well, but this does not cause  will eventually do so as well, but this does not cause
 .Nm  .Nm
 to exit early.  to exit early.
 The string  The string
 .Dq {}  .Qq {}
 must appear, and must appear last.  must appear, and must appear last.
 Each set is limited to no more than 5,000 pathnames,  Each set is limited to no more than 5,000 pathnames,
 and is also limited such that the invocation of  and is also limited such that the invocation of
 .Ar utility  .Ar utility
 does not exceed  does not exceed
 .Dv ARG_MAX .  .Dv ARG_MAX .
   .Pp
 .It Xo  .It Xo
 .Ic -execdir Ar utility  .Ic -execdir Ar utility
 .Op argument ...  .Op argument ...
Line 245 
Line 252 
 The filename substituted for the string  The filename substituted for the string
 .Qq {}  .Qq {}
 is not qualified.  is not qualified.
   .Pp
 .It Xo  .It Xo
 .Ic -flags  .Ic -flags
 .Oo - Oc Ns Ar flags  .Oo - Oc Ns Ar flags
Line 261 
Line 269 
 are set in the file's flags.  are set in the file's flags.
 If the flags are not preceded by a dash, this primary evaluates to true if the  If the flags are not preceded by a dash, this primary evaluates to true if the
 flags specified exactly match those of the file.  flags specified exactly match those of the file.
   .Pp
 .It Ic -follow  .It Ic -follow
 This primary always evaluates to true.  This primary always evaluates to true.
 The same as specifying the  The same as specifying the
 .Fl H  .Fl H
 option.  option.
   .Pp
 .It Ic -fstype Ar type  .It Ic -fstype Ar type
 True if the file is contained in a file system of type  True if the file is contained in a file system of type
 .Ar type .  .Ar type .
Line 278 
Line 288 
 .Nm  .Nm
 is being executed whereas the latter matches any file system which is  is being executed whereas the latter matches any file system which is
 mounted read-only.  mounted read-only.
   .Pp
 .It Ic -group Ar gname  .It Ic -group Ar gname
 True if the file belongs to the group  True if the file belongs to the group
 .Ar gname .  .Ar gname .
Line 286 
Line 297 
 is numeric and there is no such group name, then  is numeric and there is no such group name, then
 .Ar gname  .Ar gname
 is treated as a group ID.  is treated as a group ID.
   .Pp
 .It Ic -iname Ar pattern  .It Ic -iname Ar pattern
 Identical to the  Identical to the
 .Ic -name  .Ic -name
 primary except that the matching is done in a case insensitive manner.  primary except that the matching is done in a case insensitive manner.
   .Pp
 .It Ic -inum Ar n  .It Ic -inum Ar n
 True if the file has inode number  True if the file has inode number
 .Ar n .  .Ar n .
   .Pp
 .It Ic -links Ar n  .It Ic -links Ar n
 True if the file has  True if the file has
 .Ar n  .Ar n
 links.  links.
   .Pp
 .It Ic -ls  .It Ic -ls
 This primary always evaluates to true.  This primary always evaluates to true.
 The following information for the current file is written to standard output:  The following information for the current file is written to standard output:
Line 309 
Line 324 
 .Dq -\*(Gt .  .Dq -\*(Gt .
 The format is identical to that produced by  The format is identical to that produced by
 .Dq ls -dils .  .Dq ls -dils .
   .Pp
 .It Ic -maxdepth Ar n  .It Ic -maxdepth Ar n
 True if the current search depth is less than or equal to what is specified in  True if the current search depth is less than or equal to what is specified in
 .Ar n .  .Ar n .
   .Pp
 .It Ic -mindepth Ar n  .It Ic -mindepth Ar n
 True if the current search depth is at least what is specified in  True if the current search depth is at least what is specified in
 .Ar n .  .Ar n .
   .Pp
 .It Ic -mmin Ar n  .It Ic -mmin Ar n
 True if the difference between the file last modification time and the time  True if the difference between the file last modification time and the time
 .Nm  .Nm
 was started, rounded up to the next full minute, is  was started, rounded up to the next full minute, is
 .Ar n  .Ar n
 minutes.  minutes.
   .Pp
 .It Ic -mtime Ar n  .It Ic -mtime Ar n
 True if the difference between the file last modification time and the time  True if the difference between the file last modification time and the time
 .Nm  .Nm
 was started, rounded up to the next full 24-hour period, is  was started, rounded up to the next full 24-hour period, is
 .Ar n  .Ar n
 24-hour periods.  24-hour periods.
   .Pp
 .It Ic -name Ar pattern  .It Ic -name Ar pattern
 True if the last component of the pathname being examined matches  True if the last component of the pathname being examined matches
 .Ar pattern ,  .Ar pattern ,
 which may use any of the special characters documented in  which may use any of the special characters documented in
 .Xr glob 7 .  .Xr glob 7 .
   .Pp
 .It Ic -newer Ar file  .It Ic -newer Ar file
 True if the current file has a more recent last modification time than  True if the current file has a more recent last modification time than
 .Ar file .  .Ar file .
   .Pp
 .It Ic -nogroup  .It Ic -nogroup
 True if the file belongs to an unknown group.  True if the file belongs to an unknown group.
   .Pp
 .It Ic -nouser  .It Ic -nouser
 True if the file belongs to an unknown user.  True if the file belongs to an unknown user.
   .Pp
 .It Xo  .It Xo
 .Ic -ok Ar utility  .Ic -ok Ar utility
 .Op argument ...  .Op argument ...
Line 358 
Line 382 
 value of the  value of the
 .Ic ok  .Ic ok
 expression is false.  expression is false.
   .Pp
 .It Ic -path Ar pattern  .It Ic -path Ar pattern
 True if the pathname being examined matches  True if the pathname being examined matches
 .Ar pattern ,  .Ar pattern ,
Line 367 
Line 392 
 .Pq Ql /  .Pq Ql /
 are treated as normal characters and do not have to be  are treated as normal characters and do not have to be
 matched explicitly.  matched explicitly.
   .Pp
 .It Xo  .It Xo
 .Ic -perm  .Ic -perm
 .Oo - Oc Ns Ar mode  .Oo - Oc Ns Ar mode
Line 393 
Line 419 
 If the mode is not preceded by a dash, this primary evaluates to  If the mode is not preceded by a dash, this primary evaluates to
 true if the bits in the mode exactly match the file's mode bits.  true if the bits in the mode exactly match the file's mode bits.
 Note, the first character of a symbolic mode may not be a dash.  Note, the first character of a symbolic mode may not be a dash.
   .Pp
 .It Ic -print  .It Ic -print
 This primary always evaluates to true.  This primary always evaluates to true.
 It prints the pathname of the current file to standard output, followed  It prints the pathname of the current file to standard output, followed
 by a newline  by a newline
 .Pq Ql \en  .Pq Ql \en
 character.  character.
   .Pp
 .It Ic -print0  .It Ic -print0
 This primary always evaluates to true.  This primary always evaluates to true.
 It prints the pathname of the current file to standard output, followed  It prints the pathname of the current file to standard output, followed
Line 406 
Line 434 
 .Fl 0  .Fl 0
 option to  option to
 .Xr xargs 1 .  .Xr xargs 1 .
   .Pp
 .It Ic -prune  .It Ic -prune
 This primary always evaluates to true.  This primary always evaluates to true.
 It causes  It causes
Line 416 
Line 445 
 primary has no effect if the  primary has no effect if the
 .Fl d  .Fl d
 option was specified.  option was specified.
   .Pp
 .It Ic -size Ar n Ns Op Cm c  .It Ic -size Ar n Ns Op Cm c
 True if the file's size, rounded up, in 512-byte blocks is  True if the file's size, rounded up, in 512-byte blocks is
 .Ar n .  .Ar n .
Line 427 
Line 457 
 file's size is  file's size is
 .Ar n  .Ar n
 bytes.  bytes.
   .Pp
 .It Ic -type Ar t  .It Ic -type Ar t
 True if the file is of the specified type.  True if the file is of the specified type.
 Possible file types are as follows:  Possible file types are as follows:
Line 456 
Line 487 
 is numeric and there is no such user name, then  is numeric and there is no such user name, then
 .Ar uname  .Ar uname
 is treated as a user ID.  is treated as a user ID.
   .Pp
 .It Ic -xdev  .It Ic -xdev
 This primary always evaluates to true.  This primary always evaluates to true.
 The same as specifying the  The same as specifying the
Legend:
Removed from v.1.83  
changed lines
  Added in v.1.84