| find.1 (233456) | find.1 (233648) |
|---|---|
| 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 --- 15 unchanged lines hidden (view full) --- 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)find.1 8.7 (Berkeley) 5/9/95 | 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 --- 15 unchanged lines hidden (view full) --- 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)find.1 8.7 (Berkeley) 5/9/95 |
| 32.\" $FreeBSD: head/usr.bin/find/find.1 233456 2012-03-25 09:19:25Z joel $ | 32.\" $FreeBSD: head/usr.bin/find/find.1 233648 2012-03-29 05:02:12Z eadler $ |
| 33.\" 34.Dd September 28, 2011 35.Dt FIND 1 36.Os 37.Sh NAME 38.Nm find 39.Nd walk a file hierarchy 40.Sh SYNOPSIS --- 255 unchanged lines hidden (view full) --- 296.Nm 297was started is exactly 298.Ar n 299units. 300Please refer to the 301.Ic -atime 302primary description for information on supported time units. 303.It Ic -d | 33.\" 34.Dd September 28, 2011 35.Dt FIND 1 36.Os 37.Sh NAME 38.Nm find 39.Nd walk a file hierarchy 40.Sh SYNOPSIS --- 255 unchanged lines hidden (view full) --- 296.Nm 297was started is exactly 298.Ar n 299units. 300Please refer to the 301.Ic -atime 302primary description for information on supported time units. 303.It Ic -d |
| 304Same as | 304Same as |
| 305.Ic depth . 306GNU find implements this as a primary in mistaken emulation of 307.Fx 308.Xr find 1 . 309.It Ic -delete 310Delete found files and/or directories. 311Always returns true. 312This executes --- 132 unchanged lines hidden (view full) --- 445.Dq Li rdonly . 446The former matches any file system physically mounted on the system where 447the 448.Nm 449is being executed and the latter matches any file system which is 450mounted read-only. 451.It Ic -gid Ar gname 452The same thing as | 305.Ic depth . 306GNU find implements this as a primary in mistaken emulation of 307.Fx 308.Xr find 1 . 309.It Ic -delete 310Delete found files and/or directories. 311Always returns true. 312This executes --- 132 unchanged lines hidden (view full) --- 445.Dq Li rdonly . 446The former matches any file system physically mounted on the system where 447the 448.Nm 449is being executed and the latter matches any file system which is 450mounted read-only. 451.It Ic -gid Ar gname 452The same thing as |
| 453.Ar -group Ar gname | 453.Ar -group Ar gname |
| 454for compatibility with GNU find. 455GNU find imposes a restriction that | 454for compatibility with GNU find. 455GNU find imposes a restriction that |
| 456.Ar gname | 456.Ar gname |
| 457is numeric, while | 457is numeric, while |
| 458.Xr find 1 | 458.Xr find 1 |
| 459does not. 460.It Ic -group Ar gname 461True if the file belongs to the group 462.Ar gname . 463If 464.Ar gname 465is numeric and there is no such group name, then 466.Ar gname --- 16 unchanged lines hidden (view full) --- 483Like 484.Ic -path , 485but the match is case insensitive. 486.It Ic -iregex Ar pattern 487Like 488.Ic -regex , 489but the match is case insensitive. 490.It Ic -iwholename Ar pattern | 459does not. 460.It Ic -group Ar gname 461True if the file belongs to the group 462.Ar gname . 463If 464.Ar gname 465is numeric and there is no such group name, then 466.Ar gname --- 16 unchanged lines hidden (view full) --- 483Like 484.Ic -path , 485but the match is case insensitive. 486.It Ic -iregex Ar pattern 487Like 488.Ic -regex , 489but the match is case insensitive. 490.It Ic -iwholename Ar pattern |
| 491The same thing as | 491The same thing as |
| 492.Ic -ipath , 493for GNU find compatibility. 494.It Ic -links Ar n 495True if the file has 496.Ar n 497links. 498.It Ic -lname Ar pattern 499Like --- 39 unchanged lines hidden (view full) --- 539.Nm 540was started, rounded up to the next full minute, is 541.Ar n 542minutes. 543.It Ic -mnewer Ar file 544Same as 545.Ic -newer . 546.It Ic -mount | 492.Ic -ipath , 493for GNU find compatibility. 494.It Ic -links Ar n 495True if the file has 496.Ar n 497links. 498.It Ic -lname Ar pattern 499Like --- 39 unchanged lines hidden (view full) --- 539.Nm 540was started, rounded up to the next full minute, is 541.Ar n 542minutes. 543.It Ic -mnewer Ar file 544Same as 545.Ic -newer . 546.It Ic -mount |
| 547The same thing as | 547The same thing as |
| 548.Ic -xdev , 549for GNU find compatibility. 550.It Ic -mtime Ar n Ns Op Cm smhdw 551If no units are specified, this primary evaluates to 552true if the difference between the file last modification time and the time 553.Nm 554was started, rounded up to the next full 24-hour period, is 555.Ar n --- 56 unchanged lines hidden (view full) --- 612is equivalent to 613.Ic -newer . 614.It Ic -nogroup 615True if the file belongs to an unknown group. 616.It Ic -noignore_readdir_race 617This option is for GNU find compatibility and is ignored. 618.It Ic -noleaf 619This option is for GNU find compatibility. | 548.Ic -xdev , 549for GNU find compatibility. 550.It Ic -mtime Ar n Ns Op Cm smhdw 551If no units are specified, this primary evaluates to 552true if the difference between the file last modification time and the time 553.Nm 554was started, rounded up to the next full 24-hour period, is 555.Ar n --- 56 unchanged lines hidden (view full) --- 612is equivalent to 613.Ic -newer . 614.It Ic -nogroup 615True if the file belongs to an unknown group. 616.It Ic -noignore_readdir_race 617This option is for GNU find compatibility and is ignored. 618.It Ic -noleaf 619This option is for GNU find compatibility. |
| 620In GNU find it disables an optimization not relevant to | 620In GNU find it disables an optimization not relevant to |
| 621.Xr find 1 , 622so it is ignored. 623.It Ic -nouser 624True if the file belongs to an unknown user. 625.It Ic -ok Ar utility Oo Ar argument ... Oc Li \&; 626The 627.Ic -ok 628primary is identical to the --- 119 unchanged lines hidden (view full) --- 748or 749.Dq Li /foo/ . 750.It Ic -samefile Ar name 751True if the file is a hard link to 752.Ar name . 753If the command option 754.Ic -L 755is specified, it is also true if the file is a symbolic link and | 621.Xr find 1 , 622so it is ignored. 623.It Ic -nouser 624True if the file belongs to an unknown user. 625.It Ic -ok Ar utility Oo Ar argument ... Oc Li \&; 626The 627.Ic -ok 628primary is identical to the --- 119 unchanged lines hidden (view full) --- 748or 749.Dq Li /foo/ . 750.It Ic -samefile Ar name 751True if the file is a hard link to 752.Ar name . 753If the command option 754.Ic -L 755is specified, it is also true if the file is a symbolic link and |
| 756points to | 756points to |
| 757.Ar name . 758.It Ic -size Ar n Ns Op Cm ckMGTP 759True if the file's size, rounded up, in 512-byte blocks is 760.Ar n . 761If 762.Ar n 763is followed by a 764.Cm c , --- 36 unchanged lines hidden (view full) --- 801symbolic link 802.It Cm p 803FIFO 804.It Cm s 805socket 806.El 807.It Ic -uid Ar uname 808The same thing as | 757.Ar name . 758.It Ic -size Ar n Ns Op Cm ckMGTP 759True if the file's size, rounded up, in 512-byte blocks is 760.Ar n . 761If 762.Ar n 763is followed by a 764.Cm c , --- 36 unchanged lines hidden (view full) --- 801symbolic link 802.It Cm p 803FIFO 804.It Cm s 805socket 806.El 807.It Ic -uid Ar uname 808The same thing as |
| 809.Ar -user Ar uname | 809.Ar -user Ar uname |
| 810for compatibility with GNU find. 811GNU find imposes a restriction that | 810for compatibility with GNU find. 811GNU find imposes a restriction that |
| 812.Ar uname | 812.Ar uname |
| 813is numeric, while | 813is numeric, while |
| 814.Xr find 1 | 814.Xr find 1 |
| 815does not. 816.It Ic -user Ar uname 817True if the file belongs to the user 818.Ar uname . 819If 820.Ar uname 821is numeric and there is no such user name, then 822.Ar uname 823is treated as a user ID. 824.It Ic -wholename Ar pattern | 815does not. 816.It Ic -user Ar uname 817True if the file belongs to the user 818.Ar uname . 819If 820.Ar uname 821is numeric and there is no such user name, then 822.Ar uname 823is treated as a user ID. 824.It Ic -wholename Ar pattern |
| 825The same thing as | 825The same thing as |
| 826.Ic -path , 827for GNU find compatibility. 828.El 829.Sh OPERATORS 830The primaries may be combined using the following operators. 831The operators are listed in order of decreasing precedence. 832.Pp 833.Bl -tag -width indent -compact --- 236 unchanged lines hidden --- | 826.Ic -path , 827for GNU find compatibility. 828.El 829.Sh OPERATORS 830The primaries may be combined using the following operators. 831The operators are listed in order of decreasing precedence. 832.Pp 833.Bl -tag -width indent -compact --- 236 unchanged lines hidden --- |