28 .\" Common Development and Distribution License (the "License").
29 .\" You may not use this file except in compliance with the License.
30 .\"
31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 .\" or http://www.opensolaris.org/os/licensing.
33 .\" See the License for the specific language governing permissions
34 .\" and limitations under the License.
35 .\"
36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 .\" If applicable, add the following below this CDDL HEADER, with the
39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 .\"
42 .\"
43 .\" Copyright 1989 AT&T
44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
46 .\" Copyright 2011 Nexenta Systems, Inc. All rights reserved.
47 .\" Copyright (c) 2013 Andrew Stormont. All rights reserved.
48 .\"
49 .TH FIND 1 "Sep 5, 2011"
50 .SH NAME
51 find \- find files
52 .SH SYNOPSIS
53 .LP
54 .nf
55 \fB/usr/bin/find\fR [\fB-E\fR] [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
56 .fi
57
58 .LP
59 .nf
60 \fB/usr/xpg4/bin/find\fR [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
61 .fi
62
63 .SH DESCRIPTION
64 .LP
65 The \fBfind\fR utility recursively descends the directory hierarchy for each
66 \fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
67 primaries specified below.
68 .sp
69 .LP
70 \fBfind\fR is able to descend to arbitrary depths in a file hierarchy and does
71 not fail due to path length limitations (unless a \fIpath\fR operand specified
72 by the application exceeds \fIPATH_MAX\fR requirements).
73 .sp
74 .LP
75 \fBfind\fR detects infinite loops; that is, entering a previously visited
76 directory that is an ancestor of the last file encountered.
77 .SH OPTIONS
78 .LP
79 The following options are supported:
80 .sp
81 .ne 2
82 .na
83 \fB\fB-E\fR\fR
84 .ad
85 .RS 6n
86 Interpret regular expressions followed by \fB-regex\fR and \fB-iregex\fR
87 primaries as extended regular expressions.
88 .RE
89
90 .sp
91 .ne 2
92 .na
93 \fB\fB-H\fR\fR
94 .ad
95 .RS 6n
96 Causes the file information and file type evaluated for each symbolic link
97 encountered on the command line to be those of the file referenced by the link,
98 and not the link itself. If the referenced file does not exist, the file
100 links not on the command line is that of the link itself.
101 .RE
102
103 .sp
104 .ne 2
105 .na
106 \fB\fB-L\fR\fR
107 .ad
108 .RS 6n
109 Causes the file information and file type evaluated for each symbolic link to
110 be those of the file referenced by the link, and not the link itself. See
111 \fBNOTES\fR.
112 .RE
113
114 .sp
115 .LP
116 Specifying more than one of the mutually-exclusive options \fB-H\fR and
117 \fB-L\fR is not considered an error. The last option specified determines the
118 behavior of the utility.
119 .SH OPERANDS
120 .LP
121 The following operands are supported:
122 .sp
123 .ne 2
124 .na
125 \fB\fIpath\fR\fR
126 .ad
127 .RS 14n
128 A pathname of a starting point in the directory hierarchy.
129 .RE
130
131 .sp
132 .ne 2
133 .na
134 \fB\fIexpression\fR\fR
135 .ad
136 .RS 14n
137 The first argument that starts with a \fB\(mi\fR, or is a \fB!\fR or a \fB(\fR,
138 and all subsequent arguments are interpreted as an \fIexpression\fR made up of
139 the following primaries and operators. In the descriptions, wherever \fIn\fR is
140 used as a primary argument, it is interpreted as a decimal integer optionally
152 .ne 2
153 .na
154 \fB\fIn\fR\fR
155 .ad
156 .RS 6n
157 exactly \fIn\fR
158 .RE
159
160 .sp
161 .ne 2
162 .na
163 \fB-\fIn\fR\fR
164 .ad
165 .RS 6n
166 less than \fIn\fR
167 .RE
168
169 .RE
170
171 .SS "Expressions"
172 .LP
173 Valid expressions are:
174 .sp
175 .ne 2
176 .na
177 \fB\fB-acl\fR\fR
178 .ad
179 .RS 17n
180 True if the file have additional ACLs defined.
181 .RE
182
183 .sp
184 .ne 2
185 .na
186 \fB\fB-amin\fR \fIn\fR\fR
187 .ad
188 .RS 17n
189 File was last accessed \fIn\fR minutes ago.
190 .RE
191
192 .sp
532 .RS 17n
533 True if the file belongs to non-existing user.
534 .RE
535
536 .sp
537 .ne 2
538 .na
539 \fB\fB-ok\fR \fIcommand\fR\fR
540 .ad
541 .RS 17n
542 Like \fB-exec\fR, except that the generated command line is printed with a
543 question mark first, and is executed only if the response is affirmative.
544 .RE
545
546 .sp
547 .ne 2
548 .na
549 \fB\fB-path\fR\fR
550 .ad
551 .RS 17n
552 Like \fB-name\fR, but matches the entire file path and not just basename.
553 .RE
554
555 .sp
556 .ne 2
557 .na
558 \fB\fB-perm\fR [\fB-\fR]\fImode\fR\fR
559 .ad
560 .RS 17n
561 The \fImode\fR argument is used to represent file mode bits. It is identical in
562 format to the symbolic mode operand, \fIsymbolic_mode_list\fR, described in
563 \fBchmod\fR(1), and is interpreted as follows. To start, a template is assumed
564 with all file mode bits cleared. An \fIop\fR symbol of:
565 .sp
566 .ne 2
567 .na
568 \fB\fB+\fR\fR
569 .ad
570 .RS 8n
571 Set the appropriate mode bits in the template
572 .RE
700
701 .sp
702 .ne 2
703 .na
704 \fB\fB-xdev\fR\fR
705 .ad
706 .RS 17n
707 Same as the \fB-mount\fR primary.
708 .RE
709
710 .sp
711 .ne 2
712 .na
713 \fB\fB-xattr\fR\fR
714 .ad
715 .RS 17n
716 True if the file has extended attributes.
717 .RE
718
719 .SS "Complex Expressions"
720 .LP
721 The primaries can be combined using the following operators (in order of
722 decreasing precedence):
723 .sp
724 .ne 2
725 .na
726 \fB1)\fB(\fR\fIexpression\fR\fB)\fR\fR
727 .ad
728 .sp .6
729 .RS 4n
730 True if the parenthesized expression is true (parentheses are special to the
731 shell and must be escaped).
732 .RE
733
734 .sp
735 .ne 2
736 .na
737 \fB2)\fB!\fR\fIexpression\fR\fR
738 .ad
739 .sp .6
740 .RS 4n
766 .LP
767 When you use \fBfind\fR in conjunction with \fBcpio\fR, if you use the \fB-L\fR
768 option with \fBcpio\fR, you must use the \fB-L\fR option or the \fB-follow\fR
769 primitive with \fBfind\fR and vice versa. Otherwise the results are
770 unspecified.
771 .sp
772 .LP
773 If no \fIexpression\fR is present, \fB-print\fR is used as the expression.
774 Otherwise, if the specified expression does not contain any of the primaries
775 \fB-exec\fR, \fB-ok\fR, \fB-ls\fR, or \fB-print\fR, the specified expression is
776 effectively replaced by:
777 .sp
778 .LP
779 (\fIspecified\fR) \fB-print\fR
780 .sp
781 .LP
782 The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
783 respective arguments only once. Invocation of \fIcommand\fR specified by
784 \fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
785 .SH USAGE
786 .LP
787 See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
788 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
789 .SH EXAMPLES
790 .LP
791 \fBExample 1 \fRWriting Out the Hierarchy Directory
792 .sp
793 .LP
794 The following commands are equivalent:
795
796 .sp
797 .in +2
798 .nf
799 example% \fBfind .\fR
800 example% \fBfind . -print\fR
801 .fi
802 .in -2
803 .sp
804
805 .sp
806 .LP
807 They both write out the entire directory hierarchy from the current directory.
808
809 .LP
810 \fBExample 2 \fRRemoving Files
940 .sp
941 .in +2
942 .nf
943 example% \fBfind . ! -local -prune -o -print\fR
944 .fi
945 .in -2
946 .sp
947
948 .LP
949 \fBExample 10 \fRPrinting the Files in the Name Space Possessing Extended
950 Attributes
951 .sp
952 .in +2
953 .nf
954 example% \fBfind . -xattr\fR
955 .fi
956 .in -2
957 .sp
958
959 .SH ENVIRONMENT VARIABLES
960 .LP
961 See \fBenviron\fR(5) for descriptions of the following environment variables
962 that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
963 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
964 .sp
965 .ne 2
966 .na
967 \fB\fBPATH\fR\fR
968 .ad
969 .RS 8n
970 Determine the location of the \fIutility_name\fR for the \fB-exec\fR and
971 \fB-ok\fR primaries.
972 .RE
973
974 .sp
975 .LP
976 Affirmative responses are processed using the extended regular expression
977 defined for the \fByesexpr\fR keyword in the \fBLC_MESSAGES\fR category of the
978 user's locale. The locale specified in the \fBLC_COLLATE\fR category defines
979 the behavior of ranges, equivalence classes, and multi-character collating
980 elements used in the expression defined for \fByesexpr\fR. The locale specified
981 in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
982 bytes of text data a characters, the behavior of character classes used in the
983 expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
984 .SH EXIT STATUS
985 .LP
986 The following exit values are returned:
987 .sp
988 .ne 2
989 .na
990 \fB\fB0\fR\fR
991 .ad
992 .RS 6n
993 All \fIpath\fR operands were traversed successfully.
994 .RE
995
996 .sp
997 .ne 2
998 .na
999 \fB\fB>0\fR\fR
1000 .ad
1001 .RS 6n
1002 An error occurred.
1003 .RE
1004
1005 .SH FILES
1013
1014 .sp
1015 .ne 2
1016 .na
1017 \fB\fB/etc/group\fR\fR
1018 .ad
1019 .RS 20n
1020 Group file
1021 .RE
1022
1023 .sp
1024 .ne 2
1025 .na
1026 \fB\fB/etc/dfs/fstypes\fR\fR
1027 .ad
1028 .RS 20n
1029 File that registers distributed file system packages
1030 .RE
1031
1032 .SH ATTRIBUTES
1033 .LP
1034 See \fBattributes\fR(5) for descriptions of the following attributes:
1035 .sp
1036
1037 .sp
1038 .TS
1039 box;
1040 c | c
1041 l | l .
1042 ATTRIBUTE TYPE ATTRIBUTE VALUE
1043 _
1044 CSI Enabled
1045 _
1046 Interface Stability Committed
1047 _
1048 Standard See \fBstandards\fR(5).
1049 .TE
1050
1051 .SH SEE ALSO
1052 .LP
1053 \fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
1054 \fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
1055 \fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
1056 \fBlocale\fR(5), \fBstandards\fR(5)
1057 .SH WARNINGS
1058 .LP
1059 The following options are obsolete and will not be supported in future
1060 releases:
1061 .sp
1062 .ne 2
1063 .na
1064 \fB\fB-cpio\fR \fIdevice\fR\fR
1065 .ad
1066 .RS 17n
1067 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format
1068 (5120-byte records).
1069 .RE
1070
1071 .sp
1072 .ne 2
1073 .na
1074 \fB\fB-ncpio\fR \fIdevice\fR\fR
1075 .ad
1076 .RS 17n
1077 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
1078 format (5120-byte records).
1079 .RE
1080
1081 .SH NOTES
1082 .LP
1083 When using \fBfind\fR to determine files modified within a range of time, use
1084 the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
1085 \fBfind\fR gives all files.
1086 .sp
1087 .LP
1088 Some files that might be under the Solaris root file system are actually mount
1089 points for virtual file systems, such as \fBmntfs\fR or \fBnamefs\fR. When
1090 comparing against a \fBufs\fR file system, such files are not selected if
1091 \fB-mount\fR or \fB-xdev\fR is specified in the \fBfind\fR expression.
1092 .sp
1093 .LP
1094 Using the \fB-L\fR or \fB-follow\fR option is not recommended when descending a
1095 file-system hierarchy that is under the control of other users. In particular,
1096 when using \fB-exec\fR, symbolic links can lead the \fBfind\fR command out of
1097 the hierarchy in which it started. Using \fB-type\fR is not sufficient to
1098 restrict the type of files on which the \fB-exec\fR command operates, because
1099 there is an inherent race condition between the type-check performed by the
1100 \fBfind\fR command and the time the executed command operates on the file
1101 argument.
|
28 .\" Common Development and Distribution License (the "License").
29 .\" You may not use this file except in compliance with the License.
30 .\"
31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 .\" or http://www.opensolaris.org/os/licensing.
33 .\" See the License for the specific language governing permissions
34 .\" and limitations under the License.
35 .\"
36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 .\" If applicable, add the following below this CDDL HEADER, with the
39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 .\"
42 .\"
43 .\" Copyright 1989 AT&T
44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
46 .\" Copyright 2011 Nexenta Systems, Inc. All rights reserved.
47 .\" Copyright (c) 2013 Andrew Stormont. All rights reserved.
48 .\" Copyright 2020 Joyent, Inc.
49 .\"
50 .TH FIND 1 "Feb 20, 2020"
51 .SH NAME
52 find \- find files
53 .SH SYNOPSIS
54 .nf
55 \fB/usr/bin/find\fR [\fB-E\fR] [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
56 .fi
57
58 .LP
59 .nf
60 \fB/usr/xpg4/bin/find\fR [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
61 .fi
62
63 .SH DESCRIPTION
64 The \fBfind\fR utility recursively descends the directory hierarchy for each
65 \fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
66 primaries specified below.
67 .sp
68 .LP
69 \fBfind\fR is able to descend to arbitrary depths in a file hierarchy and does
70 not fail due to path length limitations (unless a \fIpath\fR operand specified
71 by the application exceeds \fIPATH_MAX\fR requirements).
72 .sp
73 .LP
74 \fBfind\fR detects infinite loops; that is, entering a previously visited
75 directory that is an ancestor of the last file encountered.
76 .SH OPTIONS
77 The following options are supported:
78 .sp
79 .ne 2
80 .na
81 \fB\fB-E\fR\fR
82 .ad
83 .RS 6n
84 Interpret regular expressions followed by \fB-regex\fR and \fB-iregex\fR
85 primaries as extended regular expressions.
86 .RE
87
88 .sp
89 .ne 2
90 .na
91 \fB\fB-H\fR\fR
92 .ad
93 .RS 6n
94 Causes the file information and file type evaluated for each symbolic link
95 encountered on the command line to be those of the file referenced by the link,
96 and not the link itself. If the referenced file does not exist, the file
98 links not on the command line is that of the link itself.
99 .RE
100
101 .sp
102 .ne 2
103 .na
104 \fB\fB-L\fR\fR
105 .ad
106 .RS 6n
107 Causes the file information and file type evaluated for each symbolic link to
108 be those of the file referenced by the link, and not the link itself. See
109 \fBNOTES\fR.
110 .RE
111
112 .sp
113 .LP
114 Specifying more than one of the mutually-exclusive options \fB-H\fR and
115 \fB-L\fR is not considered an error. The last option specified determines the
116 behavior of the utility.
117 .SH OPERANDS
118 The following operands are supported:
119 .sp
120 .ne 2
121 .na
122 \fB\fIpath\fR\fR
123 .ad
124 .RS 14n
125 A pathname of a starting point in the directory hierarchy.
126 .RE
127
128 .sp
129 .ne 2
130 .na
131 \fB\fIexpression\fR\fR
132 .ad
133 .RS 14n
134 The first argument that starts with a \fB\(mi\fR, or is a \fB!\fR or a \fB(\fR,
135 and all subsequent arguments are interpreted as an \fIexpression\fR made up of
136 the following primaries and operators. In the descriptions, wherever \fIn\fR is
137 used as a primary argument, it is interpreted as a decimal integer optionally
149 .ne 2
150 .na
151 \fB\fIn\fR\fR
152 .ad
153 .RS 6n
154 exactly \fIn\fR
155 .RE
156
157 .sp
158 .ne 2
159 .na
160 \fB-\fIn\fR\fR
161 .ad
162 .RS 6n
163 less than \fIn\fR
164 .RE
165
166 .RE
167
168 .SS "Expressions"
169 Valid expressions are:
170 .sp
171 .ne 2
172 .na
173 \fB\fB-acl\fR\fR
174 .ad
175 .RS 17n
176 True if the file have additional ACLs defined.
177 .RE
178
179 .sp
180 .ne 2
181 .na
182 \fB\fB-amin\fR \fIn\fR\fR
183 .ad
184 .RS 17n
185 File was last accessed \fIn\fR minutes ago.
186 .RE
187
188 .sp
528 .RS 17n
529 True if the file belongs to non-existing user.
530 .RE
531
532 .sp
533 .ne 2
534 .na
535 \fB\fB-ok\fR \fIcommand\fR\fR
536 .ad
537 .RS 17n
538 Like \fB-exec\fR, except that the generated command line is printed with a
539 question mark first, and is executed only if the response is affirmative.
540 .RE
541
542 .sp
543 .ne 2
544 .na
545 \fB\fB-path\fR\fR
546 .ad
547 .RS 17n
548 Like \fB-name\fR, but matches the entire file path and not just basename, and
549 without any special treatment of leading periods.
550 .RE
551
552 .sp
553 .ne 2
554 .na
555 \fB\fB-perm\fR [\fB-\fR]\fImode\fR\fR
556 .ad
557 .RS 17n
558 The \fImode\fR argument is used to represent file mode bits. It is identical in
559 format to the symbolic mode operand, \fIsymbolic_mode_list\fR, described in
560 \fBchmod\fR(1), and is interpreted as follows. To start, a template is assumed
561 with all file mode bits cleared. An \fIop\fR symbol of:
562 .sp
563 .ne 2
564 .na
565 \fB\fB+\fR\fR
566 .ad
567 .RS 8n
568 Set the appropriate mode bits in the template
569 .RE
697
698 .sp
699 .ne 2
700 .na
701 \fB\fB-xdev\fR\fR
702 .ad
703 .RS 17n
704 Same as the \fB-mount\fR primary.
705 .RE
706
707 .sp
708 .ne 2
709 .na
710 \fB\fB-xattr\fR\fR
711 .ad
712 .RS 17n
713 True if the file has extended attributes.
714 .RE
715
716 .SS "Complex Expressions"
717 The primaries can be combined using the following operators (in order of
718 decreasing precedence):
719 .sp
720 .ne 2
721 .na
722 \fB1)\fB(\fR\fIexpression\fR\fB)\fR\fR
723 .ad
724 .sp .6
725 .RS 4n
726 True if the parenthesized expression is true (parentheses are special to the
727 shell and must be escaped).
728 .RE
729
730 .sp
731 .ne 2
732 .na
733 \fB2)\fB!\fR\fIexpression\fR\fR
734 .ad
735 .sp .6
736 .RS 4n
762 .LP
763 When you use \fBfind\fR in conjunction with \fBcpio\fR, if you use the \fB-L\fR
764 option with \fBcpio\fR, you must use the \fB-L\fR option or the \fB-follow\fR
765 primitive with \fBfind\fR and vice versa. Otherwise the results are
766 unspecified.
767 .sp
768 .LP
769 If no \fIexpression\fR is present, \fB-print\fR is used as the expression.
770 Otherwise, if the specified expression does not contain any of the primaries
771 \fB-exec\fR, \fB-ok\fR, \fB-ls\fR, or \fB-print\fR, the specified expression is
772 effectively replaced by:
773 .sp
774 .LP
775 (\fIspecified\fR) \fB-print\fR
776 .sp
777 .LP
778 The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
779 respective arguments only once. Invocation of \fIcommand\fR specified by
780 \fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
781 .SH USAGE
782 See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
783 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
784 .SH EXAMPLES
785 \fBExample 1 \fRWriting Out the Hierarchy Directory
786 .sp
787 .LP
788 The following commands are equivalent:
789
790 .sp
791 .in +2
792 .nf
793 example% \fBfind .\fR
794 example% \fBfind . -print\fR
795 .fi
796 .in -2
797 .sp
798
799 .sp
800 .LP
801 They both write out the entire directory hierarchy from the current directory.
802
803 .LP
804 \fBExample 2 \fRRemoving Files
934 .sp
935 .in +2
936 .nf
937 example% \fBfind . ! -local -prune -o -print\fR
938 .fi
939 .in -2
940 .sp
941
942 .LP
943 \fBExample 10 \fRPrinting the Files in the Name Space Possessing Extended
944 Attributes
945 .sp
946 .in +2
947 .nf
948 example% \fBfind . -xattr\fR
949 .fi
950 .in -2
951 .sp
952
953 .SH ENVIRONMENT VARIABLES
954 See \fBenviron\fR(5) for descriptions of the following environment variables
955 that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
956 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
957 .sp
958 .ne 2
959 .na
960 \fB\fBPATH\fR\fR
961 .ad
962 .RS 8n
963 Determine the location of the \fIutility_name\fR for the \fB-exec\fR and
964 \fB-ok\fR primaries.
965 .RE
966
967 .sp
968 .LP
969 Affirmative responses are processed using the extended regular expression
970 defined for the \fByesexpr\fR keyword in the \fBLC_MESSAGES\fR category of the
971 user's locale. The locale specified in the \fBLC_COLLATE\fR category defines
972 the behavior of ranges, equivalence classes, and multi-character collating
973 elements used in the expression defined for \fByesexpr\fR. The locale specified
974 in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
975 bytes of text data a characters, the behavior of character classes used in the
976 expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
977 .SH EXIT STATUS
978 The following exit values are returned:
979 .sp
980 .ne 2
981 .na
982 \fB\fB0\fR\fR
983 .ad
984 .RS 6n
985 All \fIpath\fR operands were traversed successfully.
986 .RE
987
988 .sp
989 .ne 2
990 .na
991 \fB\fB>0\fR\fR
992 .ad
993 .RS 6n
994 An error occurred.
995 .RE
996
997 .SH FILES
1005
1006 .sp
1007 .ne 2
1008 .na
1009 \fB\fB/etc/group\fR\fR
1010 .ad
1011 .RS 20n
1012 Group file
1013 .RE
1014
1015 .sp
1016 .ne 2
1017 .na
1018 \fB\fB/etc/dfs/fstypes\fR\fR
1019 .ad
1020 .RS 20n
1021 File that registers distributed file system packages
1022 .RE
1023
1024 .SH ATTRIBUTES
1025 See \fBattributes\fR(5) for descriptions of the following attributes:
1026 .sp
1027
1028 .sp
1029 .TS
1030 box;
1031 c | c
1032 l | l .
1033 ATTRIBUTE TYPE ATTRIBUTE VALUE
1034 _
1035 CSI Enabled
1036 _
1037 Interface Stability Committed
1038 _
1039 Standard See \fBstandards\fR(5).
1040 .TE
1041
1042 .SH SEE ALSO
1043 \fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
1044 \fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
1045 \fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
1046 \fBlocale\fR(5), \fBstandards\fR(5)
1047 .SH WARNINGS
1048 The following options are obsolete and will not be supported in future
1049 releases:
1050 .sp
1051 .ne 2
1052 .na
1053 \fB\fB-cpio\fR \fIdevice\fR\fR
1054 .ad
1055 .RS 17n
1056 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format
1057 (5120-byte records).
1058 .RE
1059
1060 .sp
1061 .ne 2
1062 .na
1063 \fB\fB-ncpio\fR \fIdevice\fR\fR
1064 .ad
1065 .RS 17n
1066 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
1067 format (5120-byte records).
1068 .RE
1069
1070 .SH NOTES
1071 When using \fBfind\fR to determine files modified within a range of time, use
1072 the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
1073 \fBfind\fR gives all files.
1074 .sp
1075 .LP
1076 Some files that might be under the Solaris root file system are actually mount
1077 points for virtual file systems, such as \fBmntfs\fR or \fBnamefs\fR. When
1078 comparing against a \fBufs\fR file system, such files are not selected if
1079 \fB-mount\fR or \fB-xdev\fR is specified in the \fBfind\fR expression.
1080 .sp
1081 .LP
1082 Using the \fB-L\fR or \fB-follow\fR option is not recommended when descending a
1083 file-system hierarchy that is under the control of other users. In particular,
1084 when using \fB-exec\fR, symbolic links can lead the \fBfind\fR command out of
1085 the hierarchy in which it started. Using \fB-type\fR is not sufficient to
1086 restrict the type of files on which the \fB-exec\fR command operates, because
1087 there is an inherent race condition between the type-check performed by the
1088 \fBfind\fR command and the time the executed command operates on the file
1089 argument.
|