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 .sp
65 .LP
66 The \fBfind\fR utility recursively descends the directory hierarchy for each
67 \fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
68 primaries specified below.
69 .sp
70 .LP
71 \fBfind\fR is able to descend to arbitrary depths in a file hierarchy and does
72 not fail due to path length limitations (unless a \fIpath\fR operand specified
73 by the application exceeds \fIPATH_MAX\fR requirements).
74 .sp
75 .LP
76 \fBfind\fR detects infinite loops; that is, entering a previously visited
77 directory that is an ancestor of the last file encountered.
78 .SH OPTIONS
79 .sp
80 .LP
81 The following options are supported:
82 .sp
83 .ne 2
84 .na
85 \fB\fB-E\fR\fR
86 .ad
87 .RS 6n
88 Interpret regular expressions followed by \fB-regex\fR and \fB-iregex\fR
89 primaries as extended regular expressions.
90 .RE
91
92 .sp
93 .ne 2
94 .na
95 \fB\fB-H\fR\fR
96 .ad
97 .RS 6n
98 Causes the file information and file type evaluated for each symbolic link
99 encountered on the command line to be those of the file referenced by the link,
102 links not on the command line is that of the link itself.
103 .RE
104
105 .sp
106 .ne 2
107 .na
108 \fB\fB-L\fR\fR
109 .ad
110 .RS 6n
111 Causes the file information and file type evaluated for each symbolic link to
112 be those of the file referenced by the link, and not the link itself. See
113 \fBNOTES\fR.
114 .RE
115
116 .sp
117 .LP
118 Specifying more than one of the mutually-exclusive options \fB-H\fR and
119 \fB-L\fR is not considered an error. The last option specified determines the
120 behavior of the utility.
121 .SH OPERANDS
122 .sp
123 .LP
124 The following operands are supported:
125 .sp
126 .ne 2
127 .na
128 \fB\fIpath\fR\fR
129 .ad
130 .RS 14n
131 A pathname of a starting point in the directory hierarchy.
132 .RE
133
134 .sp
135 .ne 2
136 .na
137 \fB\fIexpression\fR\fR
138 .ad
139 .RS 14n
140 The first argument that starts with a \fB\(mi\fR, or is a \fB!\fR or a \fB(\fR,
141 and all subsequent arguments are interpreted as an \fIexpression\fR made up of
142 the following primaries and operators. In the descriptions, wherever \fIn\fR is
155 .ne 2
156 .na
157 \fB\fIn\fR\fR
158 .ad
159 .RS 6n
160 exactly \fIn\fR
161 .RE
162
163 .sp
164 .ne 2
165 .na
166 \fB-\fIn\fR\fR
167 .ad
168 .RS 6n
169 less than \fIn\fR
170 .RE
171
172 .RE
173
174 .SS "Expressions"
175 .sp
176 .LP
177 Valid expressions are:
178 .sp
179 .ne 2
180 .na
181 \fB\fB-acl\fR\fR
182 .ad
183 .RS 17n
184 True if the file have additional ACLs defined.
185 .RE
186
187 .sp
188 .ne 2
189 .na
190 \fB\fB-amin\fR \fIn\fR\fR
191 .ad
192 .RS 17n
193 File was last accessed \fIn\fR minutes ago.
194 .RE
195
704
705 .sp
706 .ne 2
707 .na
708 \fB\fB-xdev\fR\fR
709 .ad
710 .RS 17n
711 Same as the \fB-mount\fR primary.
712 .RE
713
714 .sp
715 .ne 2
716 .na
717 \fB\fB-xattr\fR\fR
718 .ad
719 .RS 17n
720 True if the file has extended attributes.
721 .RE
722
723 .SS "Complex Expressions"
724 .sp
725 .LP
726 The primaries can be combined using the following operators (in order of
727 decreasing precedence):
728 .sp
729 .ne 2
730 .na
731 \fB1)\fB(\fR\fIexpression\fR\fB)\fR\fR
732 .ad
733 .sp .6
734 .RS 4n
735 True if the parenthesized expression is true (parentheses are special to the
736 shell and must be escaped).
737 .RE
738
739 .sp
740 .ne 2
741 .na
742 \fB2)\fB!\fR\fIexpression\fR\fR
743 .ad
744 .sp .6
771 .LP
772 When you use \fBfind\fR in conjunction with \fBcpio\fR, if you use the \fB-L\fR
773 option with \fBcpio\fR, you must use the \fB-L\fR option or the \fB-follow\fR
774 primitive with \fBfind\fR and vice versa. Otherwise the results are
775 unspecified.
776 .sp
777 .LP
778 If no \fIexpression\fR is present, \fB-print\fR is used as the expression.
779 Otherwise, if the specified expression does not contain any of the primaries
780 \fB-exec\fR, \fB-ok\fR, \fB-ls\fR, or \fB-print\fR, the specified expression is
781 effectively replaced by:
782 .sp
783 .LP
784 (\fIspecified\fR) \fB-print\fR
785 .sp
786 .LP
787 The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
788 respective arguments only once. Invocation of \fIcommand\fR specified by
789 \fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
790 .SH USAGE
791 .sp
792 .LP
793 See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
794 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
795 .SH EXAMPLES
796 .LP
797 \fBExample 1 \fRWriting Out the Hierarchy Directory
798 .sp
799 .LP
800 The following commands are equivalent:
801
802 .sp
803 .in +2
804 .nf
805 example% \fBfind .\fR
806 example% \fBfind . -print\fR
807 .fi
808 .in -2
809 .sp
810
811 .sp
812 .LP
813 They both write out the entire directory hierarchy from the current directory.
814
815 .LP
816 \fBExample 2 \fRRemoving Files
817 .sp
818 .LP
819 The following comand removes all files in your home directory named \fBa.out\fR
820 or \fB*.o\fR that have not been accessed for a week:
821
822 .sp
823 .in +2
824 .nf
825 example% \fBfind $HOME \e( -name a.out -o -name '*.o' \e) \e
826 -atime +7 -exec rm {} \e;\fR
827 .fi
828 .in -2
829 .sp
830
831 .LP
832 \fBExample 3 \fRPrinting All File Names But Skipping SCCS Directories
833 .sp
834 .LP
835 The following command recursively print all file names in the current directory
836 and below, but skipping \fBSCCS\fR directories:
837
838 .sp
839 .in +2
946 .sp
947 .in +2
948 .nf
949 example% \fBfind . ! -local -prune -o -print\fR
950 .fi
951 .in -2
952 .sp
953
954 .LP
955 \fBExample 10 \fRPrinting the Files in the Name Space Possessing Extended
956 Attributes
957 .sp
958 .in +2
959 .nf
960 example% \fBfind . -xattr\fR
961 .fi
962 .in -2
963 .sp
964
965 .SH ENVIRONMENT VARIABLES
966 .sp
967 .LP
968 See \fBenviron\fR(5) for descriptions of the following environment variables
969 that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
970 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
971 .sp
972 .ne 2
973 .na
974 \fB\fBPATH\fR\fR
975 .ad
976 .RS 8n
977 Determine the location of the \fIutility_name\fR for the \fB-exec\fR and
978 \fB-ok\fR primaries.
979 .RE
980
981 .sp
982 .LP
983 Affirmative responses are processed using the extended regular expression
984 defined for the \fByesexpr\fR keyword in the \fBLC_MESSAGES\fR category of the
985 user's locale. The locale specified in the \fBLC_COLLATE\fR category defines
986 the behavior of ranges, equivalence classes, and multi-character collating
987 elements used in the expression defined for \fByesexpr\fR. The locale specified
988 in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
989 bytes of text data a characters, the behavior of character classes used in the
990 expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
991 .SH EXIT STATUS
992 .sp
993 .LP
994 The following exit values are returned:
995 .sp
996 .ne 2
997 .na
998 \fB\fB0\fR\fR
999 .ad
1000 .RS 6n
1001 All \fIpath\fR operands were traversed successfully.
1002 .RE
1003
1004 .sp
1005 .ne 2
1006 .na
1007 \fB\fB>0\fR\fR
1008 .ad
1009 .RS 6n
1010 An error occurred.
1011 .RE
1012
1013 .SH FILES
1014 .sp
1015 .ne 2
1016 .na
1017 \fB\fB/etc/passwd\fR\fR
1018 .ad
1019 .RS 20n
1020 Password file
1021 .RE
1022
1023 .sp
1024 .ne 2
1025 .na
1026 \fB\fB/etc/group\fR\fR
1027 .ad
1028 .RS 20n
1029 Group file
1030 .RE
1031
1032 .sp
1033 .ne 2
1034 .na
1035 \fB\fB/etc/dfs/fstypes\fR\fR
1036 .ad
1037 .RS 20n
1038 File that registers distributed file system packages
1039 .RE
1040
1041 .SH ATTRIBUTES
1042 .sp
1043 .LP
1044 See \fBattributes\fR(5) for descriptions of the following attributes:
1045 .sp
1046
1047 .sp
1048 .TS
1049 box;
1050 c | c
1051 l | l .
1052 ATTRIBUTE TYPE ATTRIBUTE VALUE
1053 _
1054 CSI Enabled
1055 _
1056 Interface Stability Committed
1057 _
1058 Standard See \fBstandards\fR(5).
1059 .TE
1060
1061 .SH SEE ALSO
1062 .sp
1063 .LP
1064 \fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
1065 \fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
1066 \fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
1067 \fBlocale\fR(5), \fBstandards\fR(5)
1068 .SH WARNINGS
1069 .sp
1070 .LP
1071 The following options are obsolete and will not be supported in future
1072 releases:
1073 .sp
1074 .ne 2
1075 .na
1076 \fB\fB-cpio\fR \fIdevice\fR\fR
1077 .ad
1078 .RS 17n
1079 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format
1080 (5120-byte records).
1081 .RE
1082
1083 .sp
1084 .ne 2
1085 .na
1086 \fB\fB-ncpio\fR \fIdevice\fR\fR
1087 .ad
1088 .RS 17n
1089 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
1090 format (5120-byte records).
1091 .RE
1092
1093 .SH NOTES
1094 .sp
1095 .LP
1096 When using \fBfind\fR to determine files modified within a range of time, use
1097 the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
1098 \fBfind\fR gives all files.
1099 .sp
1100 .LP
1101 Some files that might be under the Solaris root file system are actually mount
1102 points for virtual file systems, such as \fBmntfs\fR or \fBnamefs\fR. When
1103 comparing against a \fBufs\fR file system, such files are not selected if
1104 \fB-mount\fR or \fB-xdev\fR is specified in the \fBfind\fR expression.
1105 .sp
1106 .LP
1107 Using the \fB-L\fR or \fB-follow\fR option is not recommended when descending a
1108 file-system hierarchy that is under the control of other users. In particular,
1109 when using \fB-exec\fR, symbolic links can lead the \fBfind\fR command out of
1110 the hierarchy in which it started. Using \fB-type\fR is not sufficient to
1111 restrict the type of files on which the \fB-exec\fR command operates, because
1112 there is an inherent race condition between the type-check performed by the
1113 \fBfind\fR command and the time the executed command operates on the file
1114 argument.
|
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,
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
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
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
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
811 .sp
812 .LP
813 The following command removes all files in your home directory named \fBa.out\fR
814 or \fB*.o\fR that have not been accessed for a week:
815
816 .sp
817 .in +2
818 .nf
819 example% \fBfind $HOME \e( -name a.out -o -name '*.o' \e) \e
820 -atime +7 -exec rm {} \e;\fR
821 .fi
822 .in -2
823 .sp
824
825 .LP
826 \fBExample 3 \fRPrinting All File Names But Skipping SCCS Directories
827 .sp
828 .LP
829 The following command recursively print all file names in the current directory
830 and below, but skipping \fBSCCS\fR directories:
831
832 .sp
833 .in +2
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
1006 .ne 2
1007 .na
1008 \fB\fB/etc/passwd\fR\fR
1009 .ad
1010 .RS 20n
1011 Password file
1012 .RE
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.
|