Print this page
9842 man page typos and spelling

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/find.1
          +++ new/usr/src/man/man1/find.1
↓ open down ↓ 53 lines elided ↑ open up ↑
  54   54  .nf
  55   55  \fB/usr/bin/find\fR [\fB-E\fR] [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
  56   56  .fi
  57   57  
  58   58  .LP
  59   59  .nf
  60   60  \fB/usr/xpg4/bin/find\fR [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
  61   61  .fi
  62   62  
  63   63  .SH DESCRIPTION
  64      -.sp
  65   64  .LP
  66   65  The \fBfind\fR utility recursively descends the directory hierarchy for each
  67   66  \fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
  68   67  primaries specified below.
  69   68  .sp
  70   69  .LP
  71   70  \fBfind\fR is able to descend to arbitrary depths in a file hierarchy and does
  72   71  not fail due to path length limitations (unless a \fIpath\fR operand specified
  73   72  by the application exceeds \fIPATH_MAX\fR requirements).
  74   73  .sp
  75   74  .LP
  76   75  \fBfind\fR detects infinite loops; that is, entering a previously visited
  77   76  directory that is an ancestor of the last file encountered.
  78   77  .SH OPTIONS
  79      -.sp
  80   78  .LP
  81   79  The following options are supported:
  82   80  .sp
  83   81  .ne 2
  84   82  .na
  85   83  \fB\fB-E\fR\fR
  86   84  .ad
  87   85  .RS 6n
  88   86  Interpret regular expressions followed by \fB-regex\fR and \fB-iregex\fR
  89   87  primaries as extended regular expressions.
↓ open down ↓ 22 lines elided ↑ open up ↑
 112  110  be those of the file referenced by the link, and not the link itself. See
 113  111  \fBNOTES\fR.
 114  112  .RE
 115  113  
 116  114  .sp
 117  115  .LP
 118  116  Specifying more than one of the mutually-exclusive options \fB-H\fR and
 119  117  \fB-L\fR is not considered an error. The last option specified determines the
 120  118  behavior of the utility.
 121  119  .SH OPERANDS
 122      -.sp
 123  120  .LP
 124  121  The following operands are supported:
 125  122  .sp
 126  123  .ne 2
 127  124  .na
 128  125  \fB\fIpath\fR\fR
 129  126  .ad
 130  127  .RS 14n
 131  128  A pathname of a starting point in the directory hierarchy.
 132  129  .RE
↓ open down ↓ 32 lines elided ↑ open up ↑
 165  162  .na
 166  163  \fB-\fIn\fR\fR
 167  164  .ad
 168  165  .RS 6n
 169  166  less than \fIn\fR
 170  167  .RE
 171  168  
 172  169  .RE
 173  170  
 174  171  .SS "Expressions"
 175      -.sp
 176  172  .LP
 177  173  Valid expressions are:
 178  174  .sp
 179  175  .ne 2
 180  176  .na
 181  177  \fB\fB-acl\fR\fR
 182  178  .ad
 183  179  .RS 17n
 184  180  True if the file have additional ACLs defined.
 185  181  .RE
↓ open down ↓ 528 lines elided ↑ open up ↑
 714  710  .sp
 715  711  .ne 2
 716  712  .na
 717  713  \fB\fB-xattr\fR\fR
 718  714  .ad
 719  715  .RS 17n
 720  716  True if the file has extended attributes.
 721  717  .RE
 722  718  
 723  719  .SS "Complex Expressions"
 724      -.sp
 725  720  .LP
 726  721  The primaries can be combined using the following operators (in order of
 727  722  decreasing precedence):
 728  723  .sp
 729  724  .ne 2
 730  725  .na
 731  726  \fB1)\fB(\fR\fIexpression\fR\fB)\fR\fR
 732  727  .ad
 733  728  .sp .6
 734  729  .RS 4n
↓ open down ↓ 46 lines elided ↑ open up ↑
 781  776  effectively replaced by:
 782  777  .sp
 783  778  .LP
 784  779  (\fIspecified\fR) \fB-print\fR
 785  780  .sp
 786  781  .LP
 787  782  The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
 788  783  respective arguments only once. Invocation of \fIcommand\fR specified by
 789  784  \fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
 790  785  .SH USAGE
 791      -.sp
 792  786  .LP
 793  787  See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
 794  788  encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 795  789  .SH EXAMPLES
 796  790  .LP
 797  791  \fBExample 1 \fRWriting Out the Hierarchy Directory
 798  792  .sp
 799  793  .LP
 800  794  The following commands are equivalent:
 801  795  
↓ open down ↓ 7 lines elided ↑ open up ↑
 809  803  .sp
 810  804  
 811  805  .sp
 812  806  .LP
 813  807  They both write out the entire directory hierarchy from the current directory.
 814  808  
 815  809  .LP
 816  810  \fBExample 2 \fRRemoving Files
 817  811  .sp
 818  812  .LP
 819      -The following comand removes all files in your home directory named \fBa.out\fR
      813 +The following command removes all files in your home directory named \fBa.out\fR
 820  814  or \fB*.o\fR that have not been accessed for a week:
 821  815  
 822  816  .sp
 823  817  .in +2
 824  818  .nf
 825  819  example% \fBfind $HOME \e( -name a.out -o -name '*.o' \e) \e
 826  820         -atime +7 -exec rm {} \e;\fR
 827  821  .fi
 828  822  .in -2
 829  823  .sp
↓ open down ↓ 126 lines elided ↑ open up ↑
 956  950  Attributes
 957  951  .sp
 958  952  .in +2
 959  953  .nf
 960  954  example% \fBfind . -xattr\fR
 961  955  .fi
 962  956  .in -2
 963  957  .sp
 964  958  
 965  959  .SH ENVIRONMENT VARIABLES
 966      -.sp
 967  960  .LP
 968  961  See \fBenviron\fR(5) for descriptions of the following environment variables
 969  962  that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
 970  963  \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 971  964  .sp
 972  965  .ne 2
 973  966  .na
 974  967  \fB\fBPATH\fR\fR
 975  968  .ad
 976  969  .RS 8n
↓ open down ↓ 5 lines elided ↑ open up ↑
 982  975  .LP
 983  976  Affirmative responses are processed using the extended regular expression
 984  977  defined for the \fByesexpr\fR keyword in the \fBLC_MESSAGES\fR category of the
 985  978  user's locale. The locale specified in the \fBLC_COLLATE\fR category defines
 986  979  the behavior of ranges, equivalence classes, and multi-character collating
 987  980  elements used in the expression defined for \fByesexpr\fR. The locale specified
 988  981  in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
 989  982  bytes of text data a characters, the behavior of character classes used in the
 990  983  expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
 991  984  .SH EXIT STATUS
 992      -.sp
 993  985  .LP
 994  986  The following exit values are returned:
 995  987  .sp
 996  988  .ne 2
 997  989  .na
 998  990  \fB\fB0\fR\fR
 999  991  .ad
1000  992  .RS 6n
1001  993  All \fIpath\fR operands were traversed successfully.
1002  994  .RE
↓ open down ↓ 1 lines elided ↑ open up ↑
1004  996  .sp
1005  997  .ne 2
1006  998  .na
1007  999  \fB\fB>0\fR\fR
1008 1000  .ad
1009 1001  .RS 6n
1010 1002  An error occurred.
1011 1003  .RE
1012 1004  
1013 1005  .SH FILES
1014      -.sp
1015 1006  .ne 2
1016 1007  .na
1017 1008  \fB\fB/etc/passwd\fR\fR
1018 1009  .ad
1019 1010  .RS 20n
1020 1011  Password file
1021 1012  .RE
1022 1013  
1023 1014  .sp
1024 1015  .ne 2
↓ open down ↓ 7 lines elided ↑ open up ↑
1032 1023  .sp
1033 1024  .ne 2
1034 1025  .na
1035 1026  \fB\fB/etc/dfs/fstypes\fR\fR
1036 1027  .ad
1037 1028  .RS 20n
1038 1029  File that registers distributed file system packages
1039 1030  .RE
1040 1031  
1041 1032  .SH ATTRIBUTES
1042      -.sp
1043 1033  .LP
1044 1034  See \fBattributes\fR(5) for descriptions of the following attributes:
1045 1035  .sp
1046 1036  
1047 1037  .sp
1048 1038  .TS
1049 1039  box;
1050 1040  c | c
1051 1041  l | l .
1052 1042  ATTRIBUTE TYPE  ATTRIBUTE VALUE
1053 1043  _
1054 1044  CSI     Enabled
1055 1045  _
1056 1046  Interface Stability     Committed
1057 1047  _
1058 1048  Standard        See \fBstandards\fR(5).
1059 1049  .TE
1060 1050  
1061 1051  .SH SEE ALSO
1062      -.sp
1063 1052  .LP
1064 1053  \fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
1065 1054  \fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
1066 1055  \fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
1067 1056  \fBlocale\fR(5), \fBstandards\fR(5)
1068 1057  .SH WARNINGS
1069      -.sp
1070 1058  .LP
1071 1059  The following options are obsolete and will not be supported in future
1072 1060  releases:
1073 1061  .sp
1074 1062  .ne 2
1075 1063  .na
1076 1064  \fB\fB-cpio\fR \fIdevice\fR\fR
1077 1065  .ad
1078 1066  .RS 17n
1079 1067  Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR format
↓ open down ↓ 4 lines elided ↑ open up ↑
1084 1072  .ne 2
1085 1073  .na
1086 1074  \fB\fB-ncpio\fR \fIdevice\fR\fR
1087 1075  .ad
1088 1076  .RS 17n
1089 1077  Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
1090 1078  format (5120-byte records).
1091 1079  .RE
1092 1080  
1093 1081  .SH NOTES
1094      -.sp
1095 1082  .LP
1096 1083  When using \fBfind\fR to determine files modified within a range of time, use
1097 1084  the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
1098 1085  \fBfind\fR gives all files.
1099 1086  .sp
1100 1087  .LP
1101 1088  Some files that might be under the Solaris root file system are actually mount
1102 1089  points for virtual file systems, such as \fBmntfs\fR or \fBnamefs\fR. When
1103 1090  comparing against a \fBufs\fR file system, such files are not selected if
1104 1091  \fB-mount\fR or \fB-xdev\fR is specified in the \fBfind\fR expression.
1105 1092  .sp
1106 1093  .LP
1107 1094  Using the \fB-L\fR or \fB-follow\fR option is not recommended when descending a
1108 1095  file-system hierarchy that is under the control of other users. In particular,
1109 1096  when using \fB-exec\fR, symbolic links can lead the \fBfind\fR command out of
1110 1097  the hierarchy in which it started. Using \fB-type\fR is not sufficient to
1111 1098  restrict the type of files on which the \fB-exec\fR command operates, because
1112 1099  there is an inherent race condition between the type-check performed by the
1113 1100  \fBfind\fR command and the time the executed command operates on the file
1114 1101  argument.
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX