| find.1 (45438f9c8b5b91ebf5606b4a98e891559913d25b) | find.1 (2a121b97e9673ff37062c9fa026eee969940d2e2) |
|---|---|
| 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 --- 14 unchanged lines hidden (view full) --- 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 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.\" | 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 --- 14 unchanged lines hidden (view full) --- 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 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.Dd December 22, 2023 | 31.Dd January 15, 2024 |
| 32.Dt FIND 1 33.Os 34.Sh NAME 35.Nm find 36.Nd walk a file hierarchy 37.Sh SYNOPSIS 38.Nm 39.Op Fl H | Fl L | Fl P --- 712 unchanged lines hidden (view full) --- 752.Ar pattern . 753These characters may be matched explicitly by escaping them with a 754backslash 755.Pq Dq Li \e . 756Slashes 757.Pq Dq Li / 758are treated as normal characters and do not have to be 759matched explicitly. | 32.Dt FIND 1 33.Os 34.Sh NAME 35.Nm find 36.Nd walk a file hierarchy 37.Sh SYNOPSIS 38.Nm 39.Op Fl H | Fl L | Fl P --- 712 unchanged lines hidden (view full) --- 752.Ar pattern . 753These characters may be matched explicitly by escaping them with a 754backslash 755.Pq Dq Li \e . 756Slashes 757.Pq Dq Li / 758are treated as normal characters and do not have to be 759matched explicitly. |
| 760.It Ic -perm Oo Cm - Ns | Ns Cm + Oc Ns Ar mode | 760.It Ic -perm Oo Cm - Ns | Ns Cm + Ns | Ns Cm / Oc Ns Ar mode |
| 761The 762.Ar mode 763may be either symbolic (see 764.Xr chmod 1 ) 765or an octal number. 766If the 767.Ar mode 768is symbolic, a starting value of zero is assumed and the --- 12 unchanged lines hidden (view full) --- 781.Pq Dq Li - , 782this primary evaluates to true 783if at least all of the bits in the 784.Ar mode 785are set in the file's mode bits. 786If the 787.Ar mode 788is preceded by a plus | 761The 762.Ar mode 763may be either symbolic (see 764.Xr chmod 1 ) 765or an octal number. 766If the 767.Ar mode 768is symbolic, a starting value of zero is assumed and the --- 12 unchanged lines hidden (view full) --- 781.Pq Dq Li - , 782this primary evaluates to true 783if at least all of the bits in the 784.Ar mode 785are set in the file's mode bits. 786If the 787.Ar mode 788is preceded by a plus |
| 789.Pq Dq Li + , | 789.Pq Dq Li + |
| 790this primary evaluates to true 791if any of the bits in the 792.Ar mode 793are set in the file's mode bits. | 790this primary evaluates to true 791if any of the bits in the 792.Ar mode 793are set in the file's mode bits. |
| 794A slash 795.Pq Dq Li / 796is also accepted with the same meaning as plus for compatibility with GNU find. |
|
| 794Otherwise, this primary evaluates to true if 795the bits in the 796.Ar mode 797exactly match the file's mode bits. 798Note, the first character of a symbolic mode may not be a dash 799.Pq Dq Li - . 800.It Ic -print 801This primary always evaluates to true. --- 309 unchanged lines hidden (view full) --- 1111.Pp 1112The 1113.Fl E 1114option was inspired by the equivalent 1115.Xr grep 1 1116and 1117.Xr sed 1 1118options. | 797Otherwise, this primary evaluates to true if 798the bits in the 799.Ar mode 800exactly match the file's mode bits. 801Note, the first character of a symbolic mode may not be a dash 802.Pq Dq Li - . 803.It Ic -print 804This primary always evaluates to true. --- 309 unchanged lines hidden (view full) --- 1114.Pp 1115The 1116.Fl E 1117option was inspired by the equivalent 1118.Xr grep 1 1119and 1120.Xr sed 1 1121options. |
| 1122.Pp 1123The 1124.Ic -perm 1125primary accepts a leading slash 1126.Pq Dq Li / 1127as an alias for a leading plus 1128.Pq Dq Li + 1129for its argument as an extension of 1130.St -p1003.1-2001 1131to be compatible with GNU find. |
|
| 1119.Sh HISTORY 1120A simple 1121.Nm 1122command appeared in 1123.At v1 1124and was removed in 1125.At v3 . 1126It was rewritten for --- 47 unchanged lines hidden --- | 1132.Sh HISTORY 1133A simple 1134.Nm 1135command appeared in 1136.At v1 1137and was removed in 1138.At v3 . 1139It was rewritten for --- 47 unchanged lines hidden --- |