| find.1 (3b0fbd312c8b1ad5710eedba2b65d253377d0621) | find.1 (fbccd9db4891e8670119e3bc5686ec4af464535b) |
|---|---|
| 1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Institute of Electrical and Electronics Engineers, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 61 unchanged lines hidden (view full) --- 70.Pp 71The options are as follows: 72.Bl -tag -width indent 73.It Fl E 74Interpret regular expressions followed by 75.Ic -regex 76and 77.Ic -iregex | 1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Institute of Electrical and Electronics Engineers, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 61 unchanged lines hidden (view full) --- 70.Pp 71The options are as follows: 72.Bl -tag -width indent 73.It Fl E 74Interpret regular expressions followed by 75.Ic -regex 76and 77.Ic -iregex |
| 78options as extended (modern) regular expressions rather than basic | 78primaries as extended (modern) regular expressions rather than basic |
| 79regular expressions (BRE's). 80The 81.Xr re_format 7 82manual page fully describes both formats. 83.It Fl H 84Cause the file information and file type (see 85.Xr stat 2 ) 86returned for each symbolic link specified on the command line to be --- 52 unchanged lines hidden (view full) --- 139Note, the default is 140.Em not 141a breadth-first traversal. 142.Pp 143This option is equivalent to the 144.Ic -depth 145primary of 146.St -p1003.1-2001 . | 79regular expressions (BRE's). 80The 81.Xr re_format 7 82manual page fully describes both formats. 83.It Fl H 84Cause the file information and file type (see 85.Xr stat 2 ) 86returned for each symbolic link specified on the command line to be --- 52 unchanged lines hidden (view full) --- 139Note, the default is 140.Em not 141a breadth-first traversal. 142.Pp 143This option is equivalent to the 144.Ic -depth 145primary of 146.St -p1003.1-2001 . |
| 147The |
|
| 147.Fl d | 148.Fl d |
| 149option |
|
| 148can be useful when 149.Nm 150is used with 151.Xr cpio 1 152to process files that are contained in directories with unusual permissions. 153It ensures that you have write permission while you are placing files in a 154directory, then sets the directory's permissions as the last thing. 155.It Fl f --- 49 unchanged lines hidden (view full) --- 205.Nm 206was started is exactly 207.Ar n 208units. 209Please refer to the 210.Ic -atime 211primary description for information on supported time units. 212.It Ic -acl | 150can be useful when 151.Nm 152is used with 153.Xr cpio 1 154to process files that are contained in directories with unusual permissions. 155It ensures that you have write permission while you are placing files in a 156directory, then sets the directory's permissions as the last thing. 157.It Fl f --- 49 unchanged lines hidden (view full) --- 207.Nm 208was started is exactly 209.Ar n 210units. 211Please refer to the 212.Ic -atime 213primary description for information on supported time units. 214.It Ic -acl |
| 213May be used in conjunction with other options to locate | 215May be used in conjunction with other primaries to locate |
| 214files with extended ACLs. 215See 216.Xr acl 3 217for more information. 218.It Ic -amin Ar n 219True if the difference between the file last access time and the time 220.Nm 221was started, rounded up to the next full minute, is --- 238 unchanged lines hidden (view full) --- 460links, owner, group, size in bytes, last modification time, and pathname. 461If the file is a block or character special file, the major and minor numbers 462will be displayed instead of the size in bytes. 463If the file is a symbolic link, the pathname of the linked-to file will be 464displayed preceded by 465.Dq Li -> . 466The format is identical to that produced by 467.Bk -words | 216files with extended ACLs. 217See 218.Xr acl 3 219for more information. 220.It Ic -amin Ar n 221True if the difference between the file last access time and the time 222.Nm 223was started, rounded up to the next full minute, is --- 238 unchanged lines hidden (view full) --- 462links, owner, group, size in bytes, last modification time, and pathname. 463If the file is a block or character special file, the major and minor numbers 464will be displayed instead of the size in bytes. 465If the file is a symbolic link, the pathname of the linked-to file will be 466displayed preceded by 467.Dq Li -> . 468The format is identical to that produced by 469.Bk -words |
| 468.Nm ls Fl dgils . | 470.Dq Nm ls Fl dgils . |
| 469.Ek 470.It Ic -maxdepth Ar n 471Always true; descend at most 472.Ar n 473directory levels below the command line arguments. 474If any 475.Ic -maxdepth 476primary is specified, it applies to the entire expression even if it would 477not normally be evaluated. | 471.Ek 472.It Ic -maxdepth Ar n 473Always true; descend at most 474.Ar n 475directory levels below the command line arguments. 476If any 477.Ic -maxdepth 478primary is specified, it applies to the entire expression even if it would 479not normally be evaluated. |
| 478.Ic -maxdepth Li 0 | 480.Dq Ic -maxdepth Li 0 |
| 479limits the whole search to the command line arguments. 480.It Ic -mindepth Ar n 481Always true; do not apply any tests or actions at levels less than 482.Ar n . 483If any 484.Ic -mindepth 485primary is specified, it applies to the entire expression even if it would 486not normally be evaluated. | 481limits the whole search to the command line arguments. 482.It Ic -mindepth Ar n 483Always true; do not apply any tests or actions at levels less than 484.Ar n . 485If any 486.Ic -mindepth 487primary is specified, it applies to the entire expression even if it would 488not normally be evaluated. |
| 487.Ic -mindepth Li 1 | 489.Dq Ic -mindepth Li 1 |
| 488processes all but the command line arguments. 489.It Ic -mmin Ar n 490True if the difference between the file last modification time and the time 491.Nm 492was started, rounded up to the next full minute, is 493.Ar n 494minutes. 495.It Ic -mnewer Ar file --- 30 unchanged lines hidden (view full) --- 526These characters may be matched explicitly by escaping them with a 527backslash 528.Pq Dq Li \e . 529.It Ic -newer Ar file 530True if the current file has a more recent last modification time than 531.Ar file . 532.It Ic -newer Ns Ar X Ns Ar Y Ar file 533True if the current file has a more recent last access time | 490processes all but the command line arguments. 491.It Ic -mmin Ar n 492True if the difference between the file last modification time and the time 493.Nm 494was started, rounded up to the next full minute, is 495.Ar n 496minutes. 497.It Ic -mnewer Ar file --- 30 unchanged lines hidden (view full) --- 528These characters may be matched explicitly by escaping them with a 529backslash 530.Pq Dq Li \e . 531.It Ic -newer Ar file 532True if the current file has a more recent last modification time than 533.Ar file . 534.It Ic -newer Ns Ar X Ns Ar Y Ar file 535True if the current file has a more recent last access time |
| 534.Ar ( X Ns = Ns Cm a ) , | 536.Pq Ar X Ns = Ns Cm a , |
| 535inode creation time | 537inode creation time |
| 536.Ar ( X Ns = Ns Cm B ) , | 538.Pq Ar X Ns = Ns Cm B , |
| 537change time | 539change time |
| 538.Ar ( X Ns = Ns Cm c ) , | 540.Pq Ar X Ns = Ns Cm c , |
| 539or modification time | 541or modification time |
| 540.Ar ( X Ns = Ns Cm m ) | 542.Pq Ar X Ns = Ns Cm m |
| 541than the last access time | 543than the last access time |
| 542.Ar ( Y Ns = Ns Cm a ) , | 544.Pq Ar Y Ns = Ns Cm a , |
| 543inode creation time | 545inode creation time |
| 544.Ar ( Y Ns = Ns Cm B ) , | 546.Pq Ar Y Ns = Ns Cm B , |
| 545change time | 547change time |
| 546.Ar ( Y Ns = Ns Cm c ) , | 548.Pq Ar Y Ns = Ns Cm c , |
| 547or modification time | 549or modification time |
| 548.Ar ( Y Ns = Ns Cm m ) | 550.Pq Ar Y Ns = Ns Cm m |
| 549of 550.Ar file . 551In addition, if 552.Ar Y Ns = Ns Cm t , 553then 554.Ar file 555is instead interpreted as a direct date specification of the form 556understood by --- 155 unchanged lines hidden (view full) --- 712megabytes (1024 kilobytes) 713.It Cm G 714gigabytes (1024 megabytes) 715.It Cm T 716terabytes (1024 gigabytes) 717.It Cm P 718petabytes (1024 terabytes) 719.El | 551of 552.Ar file . 553In addition, if 554.Ar Y Ns = Ns Cm t , 555then 556.Ar file 557is instead interpreted as a direct date specification of the form 558understood by --- 155 unchanged lines hidden (view full) --- 714megabytes (1024 kilobytes) 715.It Cm G 716gigabytes (1024 megabytes) 717.It Cm T 718terabytes (1024 gigabytes) 719.It Cm P 720petabytes (1024 terabytes) 721.El |
| 720.Pp | |
| 721.It Ic -type Ar t 722True if the file is of the specified type. 723Possible file types are as follows: 724.Pp 725.Bl -tag -width indent -compact 726.It Cm b 727block special 728.It Cm c --- 29 unchanged lines hidden (view full) --- 758a preceding minus sign means 759.Dq less than n 760and neither means 761.Dq exactly n . 762.Sh OPERATORS 763The primaries may be combined using the following operators. 764The operators are listed in order of decreasing precedence. 765.Pp | 722.It Ic -type Ar t 723True if the file is of the specified type. 724Possible file types are as follows: 725.Pp 726.Bl -tag -width indent -compact 727.It Cm b 728block special 729.It Cm c --- 29 unchanged lines hidden (view full) --- 759a preceding minus sign means 760.Dq less than n 761and neither means 762.Dq exactly n . 763.Sh OPERATORS 764The primaries may be combined using the following operators. 765The operators are listed in order of decreasing precedence. 766.Pp |
| 766.Bl -tag -width "( expression )" -compact | 767.Bl -tag -width indent -compact |
| 767.It Cm \&( Ar expression Cm \&) 768This evaluates to true if the parenthesized expression evaluates to 769true. 770.Pp 771.It Cm \&! Ar expression 772.It Cm -false Ar expression 773.It Cm -not Ar expression 774This is the unary --- 107 unchanged lines hidden (view full) --- 882.Sh STANDARDS 883The 884.Nm 885utility syntax is a superset of the syntax specified by the 886.St -p1003.1-2001 887standard. 888.Pp 889All the single character options except | 768.It Cm \&( Ar expression Cm \&) 769This evaluates to true if the parenthesized expression evaluates to 770true. 771.Pp 772.It Cm \&! Ar expression 773.It Cm -false Ar expression 774.It Cm -not Ar expression 775This is the unary --- 107 unchanged lines hidden (view full) --- 883.Sh STANDARDS 884The 885.Nm 886utility syntax is a superset of the syntax specified by the 887.St -p1003.1-2001 888standard. 889.Pp 890All the single character options except |
| 890.Ic -H | 891.Fl H |
| 891and | 892and |
| 892.Ic -L | 893.Fl L |
| 893as well as 894.Ic -amin , -anewer , -cmin , -cnewer , -delete , -empty , -fstype , 895.Ic -iname , -inum , -iregex , -ls , -maxdepth , -mindepth , -mmin , 896.Ic -path , -print0 , -regex 897and all of the | 894as well as 895.Ic -amin , -anewer , -cmin , -cnewer , -delete , -empty , -fstype , 896.Ic -iname , -inum , -iregex , -ls , -maxdepth , -mindepth , -mmin , 897.Ic -path , -print0 , -regex 898and all of the |
| 898.Ic -B | 899.Ic -B* |
| 899birthtime related primaries are extensions to 900.St -p1003.1-2001 . 901.Pp 902Historically, the 903.Fl d , L 904and 905.Fl x 906options were implemented using the primaries --- 91 unchanged lines hidden --- | 900birthtime related primaries are extensions to 901.St -p1003.1-2001 . 902.Pp 903Historically, the 904.Fl d , L 905and 906.Fl x 907options were implemented using the primaries --- 91 unchanged lines hidden --- |