usr.bin/find/find.1

   1 .\"     The Regents of the University of California.  All rights reserved.
   2 .\"
   3 .\" This code is derived from software contributed to Berkeley by
   4 .\" the Institute of Electrical and Electronics Engineers, Inc.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"     This product includes software developed by the University of
  17 .\"     California, Berkeley and its contributors.
  18 .\" 4. Neither the name of the University nor the names of its contributors
  19 .\"    may be used to endorse or promote products derived from this software
  20 .\"    without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32 .\" SUCH DAMAGE.
  33 .\"
  34 .\"     @(#)find.1      8.7 (Berkeley) 5/9/95
  35 .\" $FreeBSD$
  36 .\"
  37 .Dd May 3, 2001
  38 .Dt FIND 1
  39 .Os
  40 .Sh NAME
  41 .Nm find
  42 .Nd walk a file hierarchy
  43 .Sh SYNOPSIS
  44 .Nm
  45 .Op Fl H | Fl L | Fl P
  46 .Op Fl EXdsx
  47 .Op Fl f Ar pathname
  48 .Op Ar pathname ...
  49 .Ar expression
  50 .Sh DESCRIPTION
  51 The
  52 .Nm
  53 utility recursively descends the directory tree for each
  54 .Ar pathname
  55 listed, evaluating an
  56 .Ar expression
  57 (composed of the
  58 .Dq primaries
  59 and
  60 .Dq operands
  61 listed below) in terms
  62 of each file in the tree.
  63 .Pp
  64 The options are as follows:
  65 .Bl -tag -width indent
  66 .It Fl E
  67 Interpret regular expressions followed by
  68 .Ic -regex
  69 and
  70 .Ic -iregex
  71 options as extended (modern) regular expressions rather than basic
  72 regular expressions (BRE's).
  73 The
  74 .Xr re_format 7
  75 manual page fully describes both formats.
  76 .It Fl H
  77 Cause the file information and file type (see
  78 .Xr stat 2 )
  79 returned for each symbolic link specified on the command line to be
  80 those of the file referenced by the link, not the link itself.
  81 If the referenced file does not exist, the file information and type will
  82 be for the link itself.
  83 File information of all symbolic links not on
  84 the command line is that of the link itself.
  85 .It Fl L
  86 Cause the file information and file type (see
  87 .Xr stat 2 )
  88 returned for each symbolic link to be those of the file referenced by the
  89 link, not the link itself.
  90 If the referenced file does not exist, the file information and type will
  91 be for the link itself.
  92 .It Fl P
  93 Cause the file information and file type (see
  94 .Xr stat 2 )
  95 returned for each symbolic link to be those of the link itself.
  96 This is the default.
  97 .It Fl X
  98 Permit
  99 .Nm
 100 to be safely used in conjunction with
 101 .Xr xargs 1 .
 102 If a file name contains any of the delimiting characters used by
 103 .Xr xargs 1 ,
 104 a diagnostic message is displayed on standard error, and the file
 105 is skipped.
 106 The delimiting characters include single
 107 .Pq Dq Li " ' "
 108 and double
 109 .Pq Dq Li " \*q "
 110 quotes, backslash
 111 .Pq Dq Li \e ,
 112 space, tab and newline characters.
 113 .Pp
 114 However, you may wish to consider the
 115 .Fl print0
 116 primary in conjunction with
 117 .Dq Nm xargs Fl 0
 118 as an effective alternative.
 119 .It Fl d
 120 Cause
 121 .Nm
 122 to perform a depth\-first traversal, i.e., directories
 123 are visited in post\-order and all entries in a directory will be acted
 124 on before the directory itself.
 125 By default,
 126 .Nm
 127 visits directories in pre\-order, i.e., before their contents.
 128 Note, the default is
 129 .Em not
 130 a breadth\-first traversal.
 131 .It Fl f
 132 Specify a file hierarchy for
 133 .Nm
 134 to traverse.
 135 File hierarchies may also be specified as the operands immediately
 136 following the options.
 137 .It Fl s
 138 Cause
 139 .Nm
 140 to traverse the file hierarchies in lexicographical order,
 141 i.e., alphabetical order within each directory.
 142 Note:
 143 .Ql find -s
 144 and
 145 .Ql "find | sort"
 146 may give different results.
 147 .It Fl x
 148 Prevent
 149 .Nm
 150 from descending into directories that have a device number different
 151 than that of the file from which the descent began.
 152 .El
 153 .Sh PRIMARIES
 154 .Bl -tag -width indent
 155 .It Ic -amin Ar n
 156 True if the difference between the file last access time and the time
 157 .Nm
 158 was started, rounded up to the next full minute, is
 159 .Ar n
 160 minutes.
 161 .It Ic -anewer Ar file
 162 Same as
 163 .Ic -neweram .
 164 .It Ic -atime Ar n Ns Op Cm smhdw
 165 If no units are specified, this primary evaluates to
 166 true if the difference between the file last access time and the time
 167 .Nm
 168 was started, rounded up to the next full 24\-hour period, is
 169 .Ar n
 170 24\-hour periods.
 171 .Pp
 172 If units are specified, this primary evaluates to
 173 true if the difference between the file last access time and the time
 174 .Nm
 175 was started is exactly
 176 .Ar n
 177 units.
 178 Possible time units are as follows:
 179 .Pp
 180 .Bl -tag -width indent -compact
 181 .It Cm s
 182 second
 183 .It Cm m
 184 minute (60 seconds)
 185 .It Cm h
 186 hour (60 minutes)
 187 .It Cm d
 188 day (24 hours)
 189 .It Cm w
 190 week (7 days)
 191 .El
 192 .Pp
 193 Any number of units may be combined in one
 194 .Ic -atime
 195 argument, for example,
 196 .Dq Li "-atime -1h30m" .
 197 Units are probably only useful when used in conjunction with the
 198 .Cm +
 199 or
 200 .Cm -
 201 modifier.
 202 .It Ic -cmin Ar n
 203 True if the difference between the time of last change of file status
 204 information and the time
 205 .Nm
 206 was started, rounded up to the next full minute, is
 207 .Ar n
 208 minutes.
 209 .It Ic -cnewer Ar file
 210 Same as
 211 .Ic -newercm .
 212 .It Ic -ctime Ar n Ns Op Cm smhdw
 213 If no units are specified, this primary evaluates to
 214 true if the difference between the time of last change of file status
 215 information and the time
 216 .Nm
 217 was started, rounded up to the next full 24\-hour period, is
 218 .Ar n
 219 24\-hour periods.
 220 .Pp
 221 If units are specified, this primary evaluates to
 222 true if the difference between the time of last change of file status
 223 information and the time
 224 .Nm
 225 was started is exactly
 226 .Ar n
 227 units.
 228 Please refer to the
 229 .Ic -atime
 230 primary description for information on supported time units.
 231 .It Ic -delete
 232 Delete found files and/or directories.
 233 Always returns true.
 234 This executes
 235 from the current working directory as
 236 .Nm
 237 recurses down the tree.
 238 It will not attempt to delete a filename with a
 239 .Dq Pa /
 240 character in its pathname relative to
 241 .Dq Pa \&.
 242 for security reasons.
 243 Depth\-first traversal processing is implied by this option.
 244 .It Ic -depth
 245 Always true;
 246 same as the
 247 .Fl d
 248 option.
 249 .Ic -depth
 250 can be useful when
 251 .Nm
 252 is used with
 253 .Xr cpio 1
 254 to process files that are contained in directories with unusual permissions.
 255 It ensures that you have write permission while you are placing files in a
 256 directory, then sets the directory's permissions as the last thing.
 257 .It Ic -empty
 258 True if the current file or directory is empty.
 259 .It Ic -exec Ar utility Oo Ar argument ...  Oc Li \&;
 260 True if the program named
 261 .Ar utility
 262 returns a zero value as its exit status.
 263 Optional
 264 .Ar arguments
 265 may be passed to the utility.
 266 The expression must be terminated by a semicolon
 267 .Pq Dq Li \&; .
 268 If the string
 269 .Dq Li {}
 270 appears anywhere in the utility name or the
 271 arguments it is replaced by the pathname of the current file.
 272 .Ar Utility
 273 will be executed from the directory from which
 274 .Nm
 275 was executed.
 276 .Ar Utility
 277 and
 278 .Ar arguments
 279 are not subject to the further expansion of shell patterns
 280 and constructs.
 281 .It Ic -exec Ar utility Oo Ar argument ... Oc Li {} +
 282 Same as
 283 .Ic -exec ,
 284 except that
 285 .Dq Li {}
 286 is replaced with as many pathnames as possible for each invocation of
 287 .Ar utility .
 288 This behaviour is similar to that of
 289 .Xr xargs 1 .
 290 .It Ic -execdir Ar utility Oo Ar argument ... Oc Li \&;
 291 The
 292 .Ic -execdir
 293 primary is identical to the
 294 .Ic -exec
 295 primary with the exception that
 296 .Ar utility
 297 will be executed from the directory that holds
 298 the current file.
 299 The filename substituted for
 300 the string
 301 .Dq Li {}
 302 is not qualified.
 303 .It Ic -flags Oo Cm - Ns | Ns Cm + Oc Ns Ar flags , Ns Ar notflags
 304 The flags are specified using symbolic names (see
 305 .Xr chflags 1 ) .
 306 Those with the
 307 .Qq Li no
 308 prefix (except
 309 .Qq Li nodump )
 310 are said to be
 311 .Ar notflags .
 312 Flags in
 313 .Ar flags
 314 are checked to be set, and flags in
 315 .Ar notflags
 316 are checked to be not set.
 317 Note that this is different from
 318 .Ic -perm ,
 319 which only allows the user to specify mode bits that are set.
 320 .Pp
 321 If flags are preceded by a dash
 322 .Pq Dq Li - ,
 323 this primary evaluates to true
 324 if at least all of the bits in
 325 .Ar flags
 326 and none of the bits in
 327 .Ar notflags
 328 are set in the file's flags bits.
 329 If flags are preceded by a plus
 330 .Pq Dq Li + ,
 331 this primary evaluates to true
 332 if any of the bits in
 333 .Ar flags
 334 is set in the file's flags bits,
 335 or any of the bits in
 336 .Ar notflags
 337 is not set in the file's flags bits.
 338 Otherwise,
 339 this primary evaluates to true
 340 if the bits in
 341 .Ar flags
 342 exactly match the file's flags bits,
 343 and none of the
 344 .Ar flags
 345 bits match those of
 346 .Ar notflags .
 347 .It Ic -fstype Ar type
 348 True if the file is contained in a file system of type
 349 .Ar type .
 350 The
 351 .Xr sysctl 8
 352 command can be used to find out the types of file systems
 353 that are available on the system:
 354 .Pp
 355 .Dl "sysctl vfs"
 356 .Pp
 357 In addition, there are two pseudo-types,
 358 .Dq Li local
 359 and
 360 .Dq Li rdonly .
 361 The former matches any file system physically mounted on the system where
 362 the
 363 .Nm
 364 is being executed and the latter matches any file system which is
 365 mounted read-only.
 366 .It Ic -group Ar gname
 367 True if the file belongs to the group
 368 .Ar gname .
 369 If
 370 .Ar gname
 371 is numeric and there is no such group name, then
 372 .Ar gname
 373 is treated as a group ID.
 374 .It Ic -iname Ar pattern
 375 Like
 376 .Ic -name ,
 377 but the match is case insensitive.
 378 .It Ic -inum Ar n
 379 True if the file has inode number
 380 .Ar n .
 381 .It Ic -ipath Ar pattern
 382 Like
 383 .Ic -path ,
 384 but the match is case insensitive.
 385 .It Ic -iregex Ar pattern
 386 Like
 387 .Ic -regex ,
 388 but the match is case insensitive.
 389 .It Ic -links Ar n
 390 True if the file has
 391 .Ar n
 392 links.
 393 .It Ic -ls
 394 This primary always evaluates to true.
 395 The following information for the current file is written to standard output:
 396 its inode number, size in 512\-byte blocks, file permissions, number of hard
 397 links, owner, group, size in bytes, last modification time, and pathname.
 398 If the file is a block or character special file, the major and minor numbers
 399 will be displayed instead of the size in bytes.
 400 If the file is a symbolic link, the pathname of the linked\-to file will be
 401 displayed preceded by
 402 .Dq Li -> .
 403 The format is identical to that produced by
 404 .Bk -words
 405 .Nm ls Fl dgils .
 406 .Ek
 407 .It Ic -maxdepth Ar n
 408 True if the depth of the current file into the tree is less than or equal to
 409 .Ar n .
 410 .It Ic -mindepth Ar n
 411 True if the depth of the current file into the tree is greater than or equal to
 412 .Ar n .
 413 .It Ic -mmin Ar n
 414 True if the difference between the file last modification time and the time
 415 .Nm
 416 was started, rounded up to the next full minute, is
 417 .Ar n
 418 minutes.
 419 .It Ic -mnewer Ar file
 420 Same as
 421 .Ic -newer .
 422 .It Ic -mtime Ar n Ns Op Cm smhdw
 423 If no units are specified, this primary evaluates to
 424 true if the difference between the file last modification time and the time
 425 .Nm
 426 was started, rounded up to the next full 24\-hour period, is
 427 .Ar n
 428 24\-hour periods.
 429 .Pp
 430 If units are specified, this primary evaluates to
 431 true if the difference between the file last modification time and the time
 432 .Nm
 433 was started is exactly
 434 .Ar n
 435 units.
 436 Please refer to the
 437 .Ic -atime
 438 primary description for information on supported time units.
 439 .It Ic -name Ar pattern
 440 True if the last component of the pathname being examined matches
 441 .Ar pattern .
 442 Special shell pattern matching characters
 443 .Dq ( Li \&[ ,
 444 .Dq Li \&] ,
 445 .Dq Li * ,
 446 and
 447 .Dq Li \&? )
 448 may be used as part of
 449 .Ar pattern .
 450 These characters may be matched explicitly by escaping them with a
 451 backslash
 452 .Pq Dq Li \e .
 453 .It Ic -newer Ar file
 454 True if the current file has a more recent last modification time than
 455 .Ar file .
 456 .It Ic -newer Ns Ar X Ns Ar Y Ar file
 457 True if the current file has a more recent last access time
 458 .Ar ( X Ns = Ns Cm a ) ,
 459 change time
 460 .Ar ( X Ns = Ns Cm c ) ,
 461 or modification time
 462 .Ar ( X Ns = Ns Cm m )
 463 than the last access time
 464 .Ar ( Y Ns = Ns Cm a ) ,
 465 change time
 466 .Ar ( Y Ns = Ns Cm c ) ,
 467 or modification time
 468 .Ar ( Y Ns = Ns Cm m )
 469 of
 470 .Ar file .
 471 In addition, if
 472 .Ar Y Ns = Ns Cm t ,
 473 then
 474 .Ar file
 475 is instead interpreted as a direct date specification of the form
 476 understood by
 477 .Xr cvs 1 .
 478 Note that
 479 .Ic -newermm
 480 is equivalent to
 481 .Ic -newer .
 482 .It Ic -nogroup
 483 True if the file belongs to an unknown group.
 484 .It Ic -nouser
 485 True if the file belongs to an unknown user.
 486 .It Ic -ok Ar utility Oo Ar argument ... Oc Li \&;
 487 The
 488 .Ic -ok
 489 primary is identical to the
 490 .Ic -exec
 491 primary with the exception that
 492 .Nm
 493 requests user affirmation for the execution of the
 494 .Ar utility
 495 by printing
 496 a message to the terminal and reading a response.
 497 If the response is other than
 498 .Dq Li y
 499 the command is not executed and the
 500 value of the
 501 .Ic -ok
 502 expression is false.
 503 .It Ic -okdir Ar utility Oo Ar argument ... Oc Li \&;
 504 The
 505 .Ic -okdir
 506 primary is identical to the
 507 .Ic -execdir
 508 primary with the same exception as described for the
 509 .Ic -ok
 510 primary.
 511 .It Ic -path Ar pattern
 512 True if the pathname being examined matches
 513 .Ar pattern .
 514 Special shell pattern matching characters
 515 .Dq ( Li \&[ ,
 516 .Dq Li \&] ,
 517 .Dq Li * ,
 518 and
 519 .Dq Li \&? )
 520 may be used as part of
 521 .Ar pattern .
 522 These characters may be matched explicitly by escaping them with a
 523 backslash
 524 .Pq Dq Li \e .
 525 Slashes
 526 .Pq Dq Li /
 527 are treated as normal characters and do not have to be
 528 matched explicitly.
 529 .It Ic -perm Oo Cm - Ns | Ns Cm + Oc Ns Ar mode
 530 The
 531 .Ar mode
 532 may be either symbolic (see
 533 .Xr chmod 1 )
 534 or an octal number.
 535 If the
 536 .Ar mode
 537 is symbolic, a starting value of zero is assumed and the
 538 .Ar mode
 539 sets or clears permissions without regard to the process' file mode
 540 creation mask.
 541 If the
 542 .Ar mode
 543 is octal, only bits 07777
 544 .Pq Dv S_ISUID | S_ISGID | S_ISTXT | S_IRWXU | S_IRWXG | S_IRWXO
 545 of the file's mode bits participate
 546 in the comparison.
 547 If the
 548 .Ar mode
 549 is preceded by a dash
 550 .Pq Dq Li - ,
 551 this primary evaluates to true
 552 if at least all of the bits in the
 553 .Ar mode
 554 are set in the file's mode bits.
 555 If the
 556 .Ar mode
 557 is preceded by a plus
 558 .Pq Dq Li + ,
 559 this primary evaluates to true
 560 if any of the bits in the
 561 .Ar mode
 562 are set in the file's mode bits.
 563 Otherwise, this primary evaluates to true if
 564 the bits in the
 565 .Ar mode
 566 exactly match the file's mode bits.
 567 Note, the first character of a symbolic mode may not be a dash
 568 .Pq Dq Li - .
 569 .It Ic -print
 570 This primary always evaluates to true.
 571 It prints the pathname of the current file to standard output.
 572 If none of
 573 .Ic -exec , -ls , -print0 ,
 574 or
 575 .Ic -ok
 576 is specified, the given expression shall be effectively replaced by
 577 .Cm \&( Ar "given expression" Cm \&) Ic -print .
 578 .It Ic -print0
 579 This primary always evaluates to true.
 580 It prints the pathname of the current file to standard output, followed by an
 581 .Tn ASCII NUL
 582 character (character code 0).
 583 .It Ic -prune
 584 This primary always evaluates to true.
 585 It causes
 586 .Nm
 587 to not descend into the current file.
 588 Note, the
 589 .Ic -prune
 590 primary has no effect if the
 591 .Fl d
 592 option was specified.
 593 .It Ic -regex Ar pattern
 594 True if the whole path of the file matches
 595 .Ar pattern
 596 using regular expression.
 597 To match a file named
 598 .Dq Pa ./foo/xyzzy ,
 599 you can use the regular expression
 600 .Dq Li ".*/[xyz]*"
 601 or
 602 .Dq Li ".*/foo/.*" ,
 603 but not
 604 .Dq Li xyzzy
 605 or
 606 .Dq Li /foo/ .
 607 .It Ic -size Ar n Ns Op Cm c
 608 True if the file's size, rounded up, in 512\-byte blocks is
 609 .Ar n .
 610 If
 611 .Ar n
 612 is followed by a
 613 .Cm c ,
 614 then the primary is true if the
 615 file's size is
 616 .Ar n
 617 bytes (characters).
 618 .It Ic -type Ar t
 619 True if the file is of the specified type.
 620 Possible file types are as follows:
 621 .Pp
 622 .Bl -tag -width indent -compact
 623 .It Cm b
 624 block special
 625 .It Cm c
 626 character special
 627 .It Cm d
 628 directory
 629 .It Cm f
 630 regular file
 631 .It Cm l
 632 symbolic link
 633 .It Cm p
 634 FIFO
 635 .It Cm s
 636 socket
 637 .El
 638 .It Ic -user Ar uname
 639 True if the file belongs to the user
 640 .Ar uname .
 641 If
 642 .Ar uname
 643 is numeric and there is no such user name, then
 644 .Ar uname
 645 is treated as a user ID.
 646 .El
 647 .Pp
 648 All primaries which take a numeric argument allow the number to be
 649 preceded by a plus sign
 650 .Pq Dq Li +
 651 or a minus sign
 652 .Pq Dq Li - .
 653 A preceding plus sign means
 654 .Dq more than n ,
 655 a preceding minus sign means
 656 .Dq less than n
 657 and neither means
 658 .Dq exactly n .
 659 .Sh OPERATORS
 660 The primaries may be combined using the following operators.
 661 The operators are listed in order of decreasing precedence.
 662 .Pp
 663 .Bl -tag -width "( expression )" -compact
 664 .It Cm \&( Ar expression Cm \&)
 665 This evaluates to true if the parenthesized expression evaluates to
 666 true.
 667 .Pp
 668 .It Cm \&! Ar expression
 669 .It Cm -false Ar expression
 670 .It Cm -not Ar expression
 671 This is the unary
 672 .Tn NOT
 673 operator.
 674 It evaluates to true if the expression is false.
 675 .Pp
 676 .It Ar expression Cm -and Ar expression
 677 .It Ar expression expression
 678 The
 679 .Cm -and
 680 operator is the logical
 681 .Tn AND
 682 operator.
 683 As it is implied by the juxtaposition of two expressions it does not
 684 have to be specified.
 685 The expression evaluates to true if both expressions are true.
 686 The second expression is not evaluated if the first expression is false.
 687 .Pp
 688 .It Ar expression Cm -or Ar expression
 689 The
 690 .Cm -or
 691 operator is the logical
 692 .Tn OR
 693 operator.
 694 The expression evaluates to true if either the first or the second expression
 695 is true.
 696 The second expression is not evaluated if the first expression is true.
 697 .El
 698 .Pp
 699 All operands and primaries must be separate arguments to
 700 .Nm .
 701 Primaries which themselves take arguments expect each argument
 702 to be a separate argument to
 703 .Nm .
 704 .Sh EXAMPLES
 705 The following examples are shown as given to the shell:
 706 .Bl -tag -width indent
 707 .It Li "find / \e! -name \*q*.c\*q -print"
 708 Print out a list of all the files whose names do not end in
 709 .Pa .c .
 710 .It Li "find / -newer ttt -user wnj -print"
 711 Print out a list of all the files owned by user
 712 .Dq wnj
 713 that are newer
 714 than the file
 715 .Pa ttt .
 716 .It Li "find / \e! \e( -newer ttt -user wnj \e) -print"
 717 Print out a list of all the files which are not both newer than
 718 .Pa ttt
 719 and owned by
 720 .Dq wnj .
 721 .It Li "find / \e( -newer ttt -or -user wnj \e) -print"
 722 Print out a list of all the files that are either owned by
 723 .Dq wnj
 724 or that are newer than
 725 .Pa ttt .
 726 .It Li "find . -newerct '1 minute ago' -print"
 727 Print out a list of all the files whose inode change time is more
 728 recent than the current time minus one minute.
 729 .El
 730 .Sh SEE ALSO
 731 .Xr chflags 1 ,
 732 .Xr chmod 1 ,
 733 .Xr cvs 1 ,
 734 .Xr locate 1 ,
 735 .Xr whereis 1 ,
 736 .Xr which 1 ,
 737 .Xr xargs 1 ,
 738 .Xr stat 2 ,
 739 .Xr fts 3 ,
 740 .Xr getgrent 3 ,
 741 .Xr getpwent 3 ,
 742 .Xr strmode 3 ,
 743 .Xr re_format 7 ,
 744 .Xr symlink 7
 745 .Sh STANDARDS
 746 The
 747 .Nm
 748 utility syntax is a superset of the syntax specified by the
 749 .St -p1003.2
 750 standard.
 751 .Pp
 752 All the single character options as well as the
 753 .Ic -iname , -inum , -iregex , -print0 , -delete , -ls ,
 754 and
 755 .Ic -regex
 756 primaries are extensions to
 757 .St -p1003.2 .
 758 .Pp
 759 Historically, the
 760 .Fl d , h
 761 and
 762 .Fl x
 763 options were implemented using the primaries
 764 .Ic -depth , -follow ,
 765 and
 766 .Ic -xdev .
 767 These primaries always evaluated to true.
 768 As they were really global variables that took effect before the traversal
 769 began, some legal expressions could have unexpected results.
 770 An example is the expression
 771 .Ic -print Cm -o Ic -depth .
 772 As
 773 .Ic -print
 774 always evaluates to true, the standard order of evaluation
 775 implies that
 776 .Ic -depth
 777 would never be evaluated.
 778 This is not the case.
 779 .Pp
 780 The operator
 781 .Cm -or
 782 was implemented as
 783 .Cm -o ,
 784 and the operator
 785 .Cm -and
 786 was implemented as
 787 .Cm -a .
 788 .Pp
 789 Historic implementations of the
 790 .Ic -exec
 791 and
 792 .Ic -ok
 793 primaries did not replace the string
 794 .Dq Li {}
 795 in the utility name or the
 796 utility arguments if it had preceding or following non-whitespace characters.
 797 This version replaces it no matter where in the utility name or arguments
 798 it appears.
 799 .Pp
 800 The
 801 .Fl E
 802 option was implemented on the analogy of
 803 .Xr grep 1
 804 and
 805 .Xr sed 1 .
 806 .Sh BUGS
 807 The special characters used by
 808 .Nm
 809 are also special characters to many shell programs.
 810 In particular, the characters
 811 .Dq Li * ,
 812 .Dq Li \&[ ,
 813 .Dq Li \&] ,
 814 .Dq Li \&? ,
 815 .Dq Li \&( ,
 816 .Dq Li \&) ,
 817 .Dq Li \&! ,
 818 .Dq Li \e
 819 and
 820 .Dq Li \&;
 821 may have to be escaped from the shell.
 822 .Pp
 823 As there is no delimiter separating options and file names or file
 824 names and the
 825 .Ar expression ,
 826 it is difficult to specify files named
 827 .Pa -xdev
 828 or
 829 .Pa \&! .
 830 These problems are handled by the
 831 .Fl f
 832 option and the
 833 .Xr getopt 3
 834 .Dq Fl Fl
 835 construct.
 836 .Pp
 837 The
 838 .Ic -delete
 839 primary does not interact well with other options that cause the file system
 840 tree traversal options to be changed.
 841 .Sh HISTORY
 842 A
 843 .Nm
 844 command appeared in
 845 .At v1 .