Print this page
12328 FNMPERIOD makes little sense for find -path
@@ -43,16 +43,16 @@
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
.\" Copyright 2011 Nexenta Systems, Inc. All rights reserved.
.\" Copyright (c) 2013 Andrew Stormont. All rights reserved.
+.\" Copyright 2020 Joyent, Inc.
.\"
-.TH FIND 1 "Sep 5, 2011"
+.TH FIND 1 "Feb 20, 2020"
.SH NAME
find \- find files
.SH SYNOPSIS
-.LP
.nf
\fB/usr/bin/find\fR [\fB-E\fR] [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
.fi
.LP
@@ -59,11 +59,10 @@
.nf
\fB/usr/xpg4/bin/find\fR [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
.fi
.SH DESCRIPTION
-.LP
The \fBfind\fR utility recursively descends the directory hierarchy for each
\fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
primaries specified below.
.sp
.LP
@@ -73,11 +72,10 @@
.sp
.LP
\fBfind\fR detects infinite loops; that is, entering a previously visited
directory that is an ancestor of the last file encountered.
.SH OPTIONS
-.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-E\fR\fR
@@ -115,11 +113,10 @@
.LP
Specifying more than one of the mutually-exclusive options \fB-H\fR and
\fB-L\fR is not considered an error. The last option specified determines the
behavior of the utility.
.SH OPERANDS
-.LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIpath\fR\fR
@@ -167,11 +164,10 @@
.RE
.RE
.SS "Expressions"
-.LP
Valid expressions are:
.sp
.ne 2
.na
\fB\fB-acl\fR\fR
@@ -547,11 +543,12 @@
.ne 2
.na
\fB\fB-path\fR\fR
.ad
.RS 17n
-Like \fB-name\fR, but matches the entire file path and not just basename.
+Like \fB-name\fR, but matches the entire file path and not just basename, and
+without any special treatment of leading periods.
.RE
.sp
.ne 2
.na
@@ -715,11 +712,10 @@
.RS 17n
True if the file has extended attributes.
.RE
.SS "Complex Expressions"
-.LP
The primaries can be combined using the following operators (in order of
decreasing precedence):
.sp
.ne 2
.na
@@ -781,15 +777,13 @@
.LP
The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
respective arguments only once. Invocation of \fIcommand\fR specified by
\fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
.SH USAGE
-.LP
See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
encountering files greater than or equal to 2 Gbyte (2^31 bytes).
.SH EXAMPLES
-.LP
\fBExample 1 \fRWriting Out the Hierarchy Directory
.sp
.LP
The following commands are equivalent:
@@ -955,11 +949,10 @@
.fi
.in -2
.sp
.SH ENVIRONMENT VARIABLES
-.LP
See \fBenviron\fR(5) for descriptions of the following environment variables
that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
\fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
.sp
.ne 2
@@ -980,11 +973,10 @@
elements used in the expression defined for \fByesexpr\fR. The locale specified
in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
bytes of text data a characters, the behavior of character classes used in the
expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
.SH EXIT STATUS
-.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR\fR
@@ -1028,11 +1020,10 @@
.RS 20n
File that registers distributed file system packages
.RE
.SH ATTRIBUTES
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
@@ -1047,17 +1038,15 @@
_
Standard See \fBstandards\fR(5).
.TE
.SH SEE ALSO
-.LP
\fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
\fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
\fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
\fBlocale\fR(5), \fBstandards\fR(5)
.SH WARNINGS
-.LP
The following options are obsolete and will not be supported in future
releases:
.sp
.ne 2
.na
@@ -1077,11 +1066,10 @@
Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
format (5120-byte records).
.RE
.SH NOTES
-.LP
When using \fBfind\fR to determine files modified within a range of time, use
the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
\fBfind\fR gives all files.
.sp
.LP