| Filename | /Users/timbo/perl5/perlbrew/perls/perl-5.18.2/lib/5.18.2/File/Find.pm |
| Statements | Executed 3103 statements in 11.6ms |
| Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
|---|---|---|---|---|---|
| 1 | 1 | 1 | 5.12ms | 8.89ms | File::Find::_find_dir_symlnk |
| 159 | 2 | 1 | 1.06ms | 1.72ms | File::Find::Follow_SymLink |
| 177 | 2 | 1 | 694µs | 694µs | File::Find::CORE:lstat (opcode) |
| 18 | 1 | 1 | 259µs | 259µs | File::Find::CORE:readdir (opcode) |
| 194 | 1 | 1 | 160µs | 160µs | File::Find::CORE:regcomp (opcode) |
| 18 | 1 | 1 | 125µs | 125µs | File::Find::CORE:open_dir (opcode) |
| 194 | 1 | 1 | 63µs | 63µs | File::Find::CORE:match (opcode) |
| 1 | 1 | 1 | 61µs | 9.01ms | File::Find::_find_opt |
| 18 | 1 | 1 | 45µs | 45µs | File::Find::CORE:closedir (opcode) |
| 159 | 2 | 1 | 33µs | 33µs | File::Find::CORE:ftdir (opcode) |
| 159 | 1 | 1 | 32µs | 32µs | File::Find::CORE:ftlink (opcode) |
| 1 | 1 | 1 | 20µs | 20µs | File::Find::BEGIN@2 |
| 1 | 1 | 1 | 12µs | 9.03ms | File::Find::find |
| 1 | 1 | 1 | 11µs | 112µs | File::Find::BEGIN@5 |
| 1 | 1 | 1 | 9µs | 25µs | File::Find::BEGIN@357 |
| 1 | 1 | 1 | 9µs | 14µs | File::Find::BEGIN@4 |
| 1 | 1 | 1 | 9µs | 24µs | File::Find::BEGIN@3 |
| 1 | 1 | 1 | 5µs | 5µs | File::Find::CORE:stat (opcode) |
| 1 | 1 | 1 | 4µs | 4µs | File::Find::wrap_wanted |
| 2 | 2 | 1 | 3µs | 3µs | File::Find::CORE:qr (opcode) |
| 1 | 1 | 1 | 600ns | 600ns | File::Find::CORE:subst (opcode) |
| 0 | 0 | 0 | 0s | 0s | File::Find::PathCombine |
| 0 | 0 | 0 | 0s | 0s | File::Find::_find_dir |
| 0 | 0 | 0 | 0s | 0s | File::Find::contract_name |
| 0 | 0 | 0 | 0s | 0s | File::Find::finddepth |
| 0 | 0 | 0 | 0s | 0s | File::Find::is_tainted_pp |
| Line | State ments |
Time on line |
Calls | Time in subs |
Code |
|---|---|---|---|---|---|
| 1 | package File::Find; | ||||
| 2 | 2 | 51µs | 1 | 20µs | # spent 20µs within File::Find::BEGIN@2 which was called:
# once (20µs+0s) by Module::Pluggable::Object::BEGIN@4 at line 2 # spent 20µs making 1 call to File::Find::BEGIN@2 |
| 3 | 2 | 24µs | 2 | 40µs | # spent 24µs (9+15) within File::Find::BEGIN@3 which was called:
# once (9µs+15µs) by Module::Pluggable::Object::BEGIN@4 at line 3 # spent 24µs making 1 call to File::Find::BEGIN@3
# spent 15µs making 1 call to strict::import |
| 4 | 2 | 29µs | 2 | 20µs | # spent 14µs (9+5) within File::Find::BEGIN@4 which was called:
# once (9µs+5µs) by Module::Pluggable::Object::BEGIN@4 at line 4 # spent 14µs making 1 call to File::Find::BEGIN@4
# spent 5µs making 1 call to warnings::import |
| 5 | 2 | 210µs | 2 | 214µs | # spent 112µs (11+101) within File::Find::BEGIN@5 which was called:
# once (11µs+101µs) by Module::Pluggable::Object::BEGIN@4 at line 5 # spent 112µs making 1 call to File::Find::BEGIN@5
# spent 101µs making 1 call to warnings::register::import |
| 6 | 1 | 700ns | our $VERSION = '1.23'; | ||
| 7 | 1 | 500ns | require Exporter; | ||
| 8 | 1 | 127µs | require Cwd; | ||
| 9 | |||||
| 10 | # | ||||
| 11 | # Modified to ensure sub-directory traversal order is not inverted by stack | ||||
| 12 | # push and pops. That is remains in the same order as in the directory file, | ||||
| 13 | # or user pre-processing (EG:sorted). | ||||
| 14 | # | ||||
| 15 | |||||
| 16 | =head1 NAME | ||||
| 17 | |||||
| 18 | File::Find - Traverse a directory tree. | ||||
| 19 | |||||
| 20 | =head1 SYNOPSIS | ||||
| 21 | |||||
| 22 | use File::Find; | ||||
| 23 | find(\&wanted, @directories_to_search); | ||||
| 24 | sub wanted { ... } | ||||
| 25 | |||||
| 26 | use File::Find; | ||||
| 27 | finddepth(\&wanted, @directories_to_search); | ||||
| 28 | sub wanted { ... } | ||||
| 29 | |||||
| 30 | use File::Find; | ||||
| 31 | find({ wanted => \&process, follow => 1 }, '.'); | ||||
| 32 | |||||
| 33 | =head1 DESCRIPTION | ||||
| 34 | |||||
| 35 | These are functions for searching through directory trees doing work | ||||
| 36 | on each file found similar to the Unix I<find> command. File::Find | ||||
| 37 | exports two functions, C<find> and C<finddepth>. They work similarly | ||||
| 38 | but have subtle differences. | ||||
| 39 | |||||
| 40 | =over 4 | ||||
| 41 | |||||
| 42 | =item B<find> | ||||
| 43 | |||||
| 44 | find(\&wanted, @directories); | ||||
| 45 | find(\%options, @directories); | ||||
| 46 | |||||
| 47 | C<find()> does a depth-first search over the given C<@directories> in | ||||
| 48 | the order they are given. For each file or directory found, it calls | ||||
| 49 | the C<&wanted> subroutine. (See below for details on how to use the | ||||
| 50 | C<&wanted> function). Additionally, for each directory found, it will | ||||
| 51 | C<chdir()> into that directory and continue the search, invoking the | ||||
| 52 | C<&wanted> function on each file or subdirectory in the directory. | ||||
| 53 | |||||
| 54 | =item B<finddepth> | ||||
| 55 | |||||
| 56 | finddepth(\&wanted, @directories); | ||||
| 57 | finddepth(\%options, @directories); | ||||
| 58 | |||||
| 59 | C<finddepth()> works just like C<find()> except that it invokes the | ||||
| 60 | C<&wanted> function for a directory I<after> invoking it for the | ||||
| 61 | directory's contents. It does a postorder traversal instead of a | ||||
| 62 | preorder traversal, working from the bottom of the directory tree up | ||||
| 63 | where C<find()> works from the top of the tree down. | ||||
| 64 | |||||
| 65 | =back | ||||
| 66 | |||||
| 67 | =head2 %options | ||||
| 68 | |||||
| 69 | The first argument to C<find()> is either a code reference to your | ||||
| 70 | C<&wanted> function, or a hash reference describing the operations | ||||
| 71 | to be performed for each file. The | ||||
| 72 | code reference is described in L<The wanted function> below. | ||||
| 73 | |||||
| 74 | Here are the possible keys for the hash: | ||||
| 75 | |||||
| 76 | =over 3 | ||||
| 77 | |||||
| 78 | =item C<wanted> | ||||
| 79 | |||||
| 80 | The value should be a code reference. This code reference is | ||||
| 81 | described in L<The wanted function> below. The C<&wanted> subroutine is | ||||
| 82 | mandatory. | ||||
| 83 | |||||
| 84 | =item C<bydepth> | ||||
| 85 | |||||
| 86 | Reports the name of a directory only AFTER all its entries | ||||
| 87 | have been reported. Entry point C<finddepth()> is a shortcut for | ||||
| 88 | specifying C<< { bydepth => 1 } >> in the first argument of C<find()>. | ||||
| 89 | |||||
| 90 | =item C<preprocess> | ||||
| 91 | |||||
| 92 | The value should be a code reference. This code reference is used to | ||||
| 93 | preprocess the current directory. The name of the currently processed | ||||
| 94 | directory is in C<$File::Find::dir>. Your preprocessing function is | ||||
| 95 | called after C<readdir()>, but before the loop that calls the C<wanted()> | ||||
| 96 | function. It is called with a list of strings (actually file/directory | ||||
| 97 | names) and is expected to return a list of strings. The code can be | ||||
| 98 | used to sort the file/directory names alphabetically, numerically, | ||||
| 99 | or to filter out directory entries based on their name alone. When | ||||
| 100 | I<follow> or I<follow_fast> are in effect, C<preprocess> is a no-op. | ||||
| 101 | |||||
| 102 | =item C<postprocess> | ||||
| 103 | |||||
| 104 | The value should be a code reference. It is invoked just before leaving | ||||
| 105 | the currently processed directory. It is called in void context with no | ||||
| 106 | arguments. The name of the current directory is in C<$File::Find::dir>. This | ||||
| 107 | hook is handy for summarizing a directory, such as calculating its disk | ||||
| 108 | usage. When I<follow> or I<follow_fast> are in effect, C<postprocess> is a | ||||
| 109 | no-op. | ||||
| 110 | |||||
| 111 | =item C<follow> | ||||
| 112 | |||||
| 113 | Causes symbolic links to be followed. Since directory trees with symbolic | ||||
| 114 | links (followed) may contain files more than once and may even have | ||||
| 115 | cycles, a hash has to be built up with an entry for each file. | ||||
| 116 | This might be expensive both in space and time for a large | ||||
| 117 | directory tree. See L</follow_fast> and L</follow_skip> below. | ||||
| 118 | If either I<follow> or I<follow_fast> is in effect: | ||||
| 119 | |||||
| 120 | =over 6 | ||||
| 121 | |||||
| 122 | =item * | ||||
| 123 | |||||
| 124 | It is guaranteed that an I<lstat> has been called before the user's | ||||
| 125 | C<wanted()> function is called. This enables fast file checks involving S<_>. | ||||
| 126 | Note that this guarantee no longer holds if I<follow> or I<follow_fast> | ||||
| 127 | are not set. | ||||
| 128 | |||||
| 129 | =item * | ||||
| 130 | |||||
| 131 | There is a variable C<$File::Find::fullname> which holds the absolute | ||||
| 132 | pathname of the file with all symbolic links resolved. If the link is | ||||
| 133 | a dangling symbolic link, then fullname will be set to C<undef>. | ||||
| 134 | |||||
| 135 | =back | ||||
| 136 | |||||
| 137 | This is a no-op on Win32. | ||||
| 138 | |||||
| 139 | =item C<follow_fast> | ||||
| 140 | |||||
| 141 | This is similar to I<follow> except that it may report some files more | ||||
| 142 | than once. It does detect cycles, however. Since only symbolic links | ||||
| 143 | have to be hashed, this is much cheaper both in space and time. If | ||||
| 144 | processing a file more than once (by the user's C<wanted()> function) | ||||
| 145 | is worse than just taking time, the option I<follow> should be used. | ||||
| 146 | |||||
| 147 | This is also a no-op on Win32. | ||||
| 148 | |||||
| 149 | =item C<follow_skip> | ||||
| 150 | |||||
| 151 | C<follow_skip==1>, which is the default, causes all files which are | ||||
| 152 | neither directories nor symbolic links to be ignored if they are about | ||||
| 153 | to be processed a second time. If a directory or a symbolic link | ||||
| 154 | are about to be processed a second time, File::Find dies. | ||||
| 155 | |||||
| 156 | C<follow_skip==0> causes File::Find to die if any file is about to be | ||||
| 157 | processed a second time. | ||||
| 158 | |||||
| 159 | C<follow_skip==2> causes File::Find to ignore any duplicate files and | ||||
| 160 | directories but to proceed normally otherwise. | ||||
| 161 | |||||
| 162 | =item C<dangling_symlinks> | ||||
| 163 | |||||
| 164 | If true and a code reference, will be called with the symbolic link | ||||
| 165 | name and the directory it lives in as arguments. Otherwise, if true | ||||
| 166 | and warnings are on, warning "symbolic_link_name is a dangling | ||||
| 167 | symbolic link\n" will be issued. If false, the dangling symbolic link | ||||
| 168 | will be silently ignored. | ||||
| 169 | |||||
| 170 | =item C<no_chdir> | ||||
| 171 | |||||
| 172 | Does not C<chdir()> to each directory as it recurses. The C<wanted()> | ||||
| 173 | function will need to be aware of this, of course. In this case, | ||||
| 174 | C<$_> will be the same as C<$File::Find::name>. | ||||
| 175 | |||||
| 176 | =item C<untaint> | ||||
| 177 | |||||
| 178 | If find is used in taint-mode (-T command line switch or if EUID != UID | ||||
| 179 | or if EGID != GID) then internally directory names have to be untainted | ||||
| 180 | before they can be chdir'ed to. Therefore they are checked against a regular | ||||
| 181 | expression I<untaint_pattern>. Note that all names passed to the user's | ||||
| 182 | I<wanted()> function are still tainted. If this option is used while | ||||
| 183 | not in taint-mode, C<untaint> is a no-op. | ||||
| 184 | |||||
| 185 | =item C<untaint_pattern> | ||||
| 186 | |||||
| 187 | See above. This should be set using the C<qr> quoting operator. | ||||
| 188 | The default is set to C<qr|^([-+@\w./]+)$|>. | ||||
| 189 | Note that the parentheses are vital. | ||||
| 190 | |||||
| 191 | =item C<untaint_skip> | ||||
| 192 | |||||
| 193 | If set, a directory which fails the I<untaint_pattern> is skipped, | ||||
| 194 | including all its sub-directories. The default is to 'die' in such a case. | ||||
| 195 | |||||
| 196 | =back | ||||
| 197 | |||||
| 198 | =head2 The wanted function | ||||
| 199 | |||||
| 200 | The C<wanted()> function does whatever verifications you want on | ||||
| 201 | each file and directory. Note that despite its name, the C<wanted()> | ||||
| 202 | function is a generic callback function, and does B<not> tell | ||||
| 203 | File::Find if a file is "wanted" or not. In fact, its return value | ||||
| 204 | is ignored. | ||||
| 205 | |||||
| 206 | The wanted function takes no arguments but rather does its work | ||||
| 207 | through a collection of variables. | ||||
| 208 | |||||
| 209 | =over 4 | ||||
| 210 | |||||
| 211 | =item C<$File::Find::dir> is the current directory name, | ||||
| 212 | |||||
| 213 | =item C<$_> is the current filename within that directory | ||||
| 214 | |||||
| 215 | =item C<$File::Find::name> is the complete pathname to the file. | ||||
| 216 | |||||
| 217 | =back | ||||
| 218 | |||||
| 219 | The above variables have all been localized and may be changed without | ||||
| 220 | affecting data outside of the wanted function. | ||||
| 221 | |||||
| 222 | For example, when examining the file F</some/path/foo.ext> you will have: | ||||
| 223 | |||||
| 224 | $File::Find::dir = /some/path/ | ||||
| 225 | $_ = foo.ext | ||||
| 226 | $File::Find::name = /some/path/foo.ext | ||||
| 227 | |||||
| 228 | You are chdir()'d to C<$File::Find::dir> when the function is called, | ||||
| 229 | unless C<no_chdir> was specified. Note that when changing to | ||||
| 230 | directories is in effect the root directory (F</>) is a somewhat | ||||
| 231 | special case inasmuch as the concatenation of C<$File::Find::dir>, | ||||
| 232 | C<'/'> and C<$_> is not literally equal to C<$File::Find::name>. The | ||||
| 233 | table below summarizes all variants: | ||||
| 234 | |||||
| 235 | $File::Find::name $File::Find::dir $_ | ||||
| 236 | default / / . | ||||
| 237 | no_chdir=>0 /etc / etc | ||||
| 238 | /etc/x /etc x | ||||
| 239 | |||||
| 240 | no_chdir=>1 / / / | ||||
| 241 | /etc / /etc | ||||
| 242 | /etc/x /etc /etc/x | ||||
| 243 | |||||
| 244 | |||||
| 245 | When C<follow> or C<follow_fast> are in effect, there is | ||||
| 246 | also a C<$File::Find::fullname>. The function may set | ||||
| 247 | C<$File::Find::prune> to prune the tree unless C<bydepth> was | ||||
| 248 | specified. Unless C<follow> or C<follow_fast> is specified, for | ||||
| 249 | compatibility reasons (find.pl, find2perl) there are in addition the | ||||
| 250 | following globals available: C<$File::Find::topdir>, | ||||
| 251 | C<$File::Find::topdev>, C<$File::Find::topino>, | ||||
| 252 | C<$File::Find::topmode> and C<$File::Find::topnlink>. | ||||
| 253 | |||||
| 254 | This library is useful for the C<find2perl> tool, which when fed, | ||||
| 255 | |||||
| 256 | find2perl / -name .nfs\* -mtime +7 \ | ||||
| 257 | -exec rm -f {} \; -o -fstype nfs -prune | ||||
| 258 | |||||
| 259 | produces something like: | ||||
| 260 | |||||
| 261 | sub wanted { | ||||
| 262 | /^\.nfs.*\z/s && | ||||
| 263 | (($dev, $ino, $mode, $nlink, $uid, $gid) = lstat($_)) && | ||||
| 264 | int(-M _) > 7 && | ||||
| 265 | unlink($_) | ||||
| 266 | || | ||||
| 267 | ($nlink || (($dev, $ino, $mode, $nlink, $uid, $gid) = lstat($_))) && | ||||
| 268 | $dev < 0 && | ||||
| 269 | ($File::Find::prune = 1); | ||||
| 270 | } | ||||
| 271 | |||||
| 272 | Notice the C<_> in the above C<int(-M _)>: the C<_> is a magical | ||||
| 273 | filehandle that caches the information from the preceding | ||||
| 274 | C<stat()>, C<lstat()>, or filetest. | ||||
| 275 | |||||
| 276 | Here's another interesting wanted function. It will find all symbolic | ||||
| 277 | links that don't resolve: | ||||
| 278 | |||||
| 279 | sub wanted { | ||||
| 280 | -l && !-e && print "bogus link: $File::Find::name\n"; | ||||
| 281 | } | ||||
| 282 | |||||
| 283 | Note that you may mix directories and (non-directory) files in the list of | ||||
| 284 | directories to be searched by the C<wanted()> function. | ||||
| 285 | |||||
| 286 | find(\&wanted, "./foo", "./bar", "./baz/epsilon"); | ||||
| 287 | |||||
| 288 | In the example above, no file in F<./baz/> other than F<./baz/epsilon> will be | ||||
| 289 | evaluated by C<wanted()>. | ||||
| 290 | |||||
| 291 | See also the script C<pfind> on CPAN for a nice application of this | ||||
| 292 | module. | ||||
| 293 | |||||
| 294 | =head1 WARNINGS | ||||
| 295 | |||||
| 296 | If you run your program with the C<-w> switch, or if you use the | ||||
| 297 | C<warnings> pragma, File::Find will report warnings for several weird | ||||
| 298 | situations. You can disable these warnings by putting the statement | ||||
| 299 | |||||
| 300 | no warnings 'File::Find'; | ||||
| 301 | |||||
| 302 | in the appropriate scope. See L<perllexwarn> for more info about lexical | ||||
| 303 | warnings. | ||||
| 304 | |||||
| 305 | =head1 CAVEAT | ||||
| 306 | |||||
| 307 | =over 2 | ||||
| 308 | |||||
| 309 | =item $dont_use_nlink | ||||
| 310 | |||||
| 311 | You can set the variable C<$File::Find::dont_use_nlink> to 1, if you want to | ||||
| 312 | force File::Find to always stat directories. This was used for file systems | ||||
| 313 | that do not have an C<nlink> count matching the number of sub-directories. | ||||
| 314 | Examples are ISO-9660 (CD-ROM), AFS, HPFS (OS/2 file system), FAT (DOS file | ||||
| 315 | system) and a couple of others. | ||||
| 316 | |||||
| 317 | You shouldn't need to set this variable, since File::Find should now detect | ||||
| 318 | such file systems on-the-fly and switch itself to using stat. This works even | ||||
| 319 | for parts of your file system, like a mounted CD-ROM. | ||||
| 320 | |||||
| 321 | If you do set C<$File::Find::dont_use_nlink> to 1, you will notice slow-downs. | ||||
| 322 | |||||
| 323 | =item symlinks | ||||
| 324 | |||||
| 325 | Be aware that the option to follow symbolic links can be dangerous. | ||||
| 326 | Depending on the structure of the directory tree (including symbolic | ||||
| 327 | links to directories) you might traverse a given (physical) directory | ||||
| 328 | more than once (only if C<follow_fast> is in effect). | ||||
| 329 | Furthermore, deleting or changing files in a symbolically linked directory | ||||
| 330 | might cause very unpleasant surprises, since you delete or change files | ||||
| 331 | in an unknown directory. | ||||
| 332 | |||||
| 333 | =back | ||||
| 334 | |||||
| 335 | =head1 BUGS AND CAVEATS | ||||
| 336 | |||||
| 337 | Despite the name of the C<finddepth()> function, both C<find()> and | ||||
| 338 | C<finddepth()> perform a depth-first search of the directory | ||||
| 339 | hierarchy. | ||||
| 340 | |||||
| 341 | =head1 HISTORY | ||||
| 342 | |||||
| 343 | File::Find used to produce incorrect results if called recursively. | ||||
| 344 | During the development of perl 5.8 this bug was fixed. | ||||
| 345 | The first fixed version of File::Find was 1.01. | ||||
| 346 | |||||
| 347 | =head1 SEE ALSO | ||||
| 348 | |||||
| 349 | find, find2perl. | ||||
| 350 | |||||
| 351 | =cut | ||||
| 352 | |||||
| 353 | 1 | 5µs | our @ISA = qw(Exporter); | ||
| 354 | 1 | 700ns | our @EXPORT = qw(find finddepth); | ||
| 355 | |||||
| 356 | |||||
| 357 | 2 | 3.80ms | 2 | 40µs | # spent 25µs (9+15) within File::Find::BEGIN@357 which was called:
# once (9µs+15µs) by Module::Pluggable::Object::BEGIN@4 at line 357 # spent 25µs making 1 call to File::Find::BEGIN@357
# spent 15µs making 1 call to strict::import |
| 358 | 1 | 100ns | my $Is_VMS; | ||
| 359 | 1 | 0s | my $Is_Win32; | ||
| 360 | |||||
| 361 | 1 | 400ns | require File::Basename; | ||
| 362 | 1 | 300ns | require File::Spec; | ||
| 363 | |||||
| 364 | # Should ideally be my() not our() but local() currently | ||||
| 365 | # refuses to operate on lexicals | ||||
| 366 | |||||
| 367 | 1 | 100ns | our %SLnkSeen; | ||
| 368 | 1 | 300ns | our ($wanted_callback, $avoid_nlink, $bydepth, $no_chdir, $follow, | ||
| 369 | $follow_skip, $full_check, $untaint, $untaint_skip, $untaint_pat, | ||||
| 370 | $pre_process, $post_process, $dangling_symlinks); | ||||
| 371 | |||||
| 372 | sub contract_name { | ||||
| 373 | my ($cdir,$fn) = @_; | ||||
| 374 | |||||
| 375 | return substr($cdir,0,rindex($cdir,'/')) if $fn eq $File::Find::current_dir; | ||||
| 376 | |||||
| 377 | $cdir = substr($cdir,0,rindex($cdir,'/')+1); | ||||
| 378 | |||||
| 379 | $fn =~ s|^\./||; | ||||
| 380 | |||||
| 381 | my $abs_name= $cdir . $fn; | ||||
| 382 | |||||
| 383 | if (substr($fn,0,3) eq '../') { | ||||
| 384 | 1 while $abs_name =~ s!/[^/]*/\.\./+!/!; | ||||
| 385 | } | ||||
| 386 | |||||
| 387 | return $abs_name; | ||||
| 388 | } | ||||
| 389 | |||||
| 390 | sub PathCombine($$) { | ||||
| 391 | my ($Base,$Name) = @_; | ||||
| 392 | my $AbsName; | ||||
| 393 | |||||
| 394 | if (substr($Name,0,1) eq '/') { | ||||
| 395 | $AbsName= $Name; | ||||
| 396 | } | ||||
| 397 | else { | ||||
| 398 | $AbsName= contract_name($Base,$Name); | ||||
| 399 | } | ||||
| 400 | |||||
| 401 | # (simple) check for recursion | ||||
| 402 | my $newlen= length($AbsName); | ||||
| 403 | if ($newlen <= length($Base)) { | ||||
| 404 | if (($newlen == length($Base) || substr($Base,$newlen,1) eq '/') | ||||
| 405 | && $AbsName eq substr($Base,0,$newlen)) | ||||
| 406 | { | ||||
| 407 | return undef; | ||||
| 408 | } | ||||
| 409 | } | ||||
| 410 | return $AbsName; | ||||
| 411 | } | ||||
| 412 | |||||
| 413 | sub Follow_SymLink($) { | ||||
| 414 | 159 | 37µs | my ($AbsName) = @_; | ||
| 415 | |||||
| 416 | 159 | 200ns | my ($NewName,$DEV, $INO); | ||
| 417 | 159 | 928µs | 159 | 634µs | ($DEV, $INO)= lstat $AbsName; # spent 634µs making 159 calls to File::Find::CORE:lstat, avg 4µs/call |
| 418 | |||||
| 419 | 159 | 251µs | 159 | 32µs | while (-l _) { # spent 32µs making 159 calls to File::Find::CORE:ftlink, avg 203ns/call |
| 420 | if ($SLnkSeen{$DEV, $INO}++) { | ||||
| 421 | if ($follow_skip < 2) { | ||||
| 422 | die "$AbsName is encountered a second time"; | ||||
| 423 | } | ||||
| 424 | else { | ||||
| 425 | return undef; | ||||
| 426 | } | ||||
| 427 | } | ||||
| 428 | $NewName= PathCombine($AbsName, readlink($AbsName)); | ||||
| 429 | unless(defined $NewName) { | ||||
| 430 | if ($follow_skip < 2) { | ||||
| 431 | die "$AbsName is a recursive symbolic link"; | ||||
| 432 | } | ||||
| 433 | else { | ||||
| 434 | return undef; | ||||
| 435 | } | ||||
| 436 | } | ||||
| 437 | else { | ||||
| 438 | $AbsName= $NewName; | ||||
| 439 | } | ||||
| 440 | ($DEV, $INO) = lstat($AbsName); | ||||
| 441 | return undef unless defined $DEV; # dangling symbolic link | ||||
| 442 | } | ||||
| 443 | |||||
| 444 | 159 | 209µs | if ($full_check && defined $DEV && $SLnkSeen{$DEV, $INO}++) { | ||
| 445 | if ( ($follow_skip < 1) || ((-d _) && ($follow_skip < 2)) ) { | ||||
| 446 | die "$AbsName encountered a second time"; | ||||
| 447 | } | ||||
| 448 | else { | ||||
| 449 | return undef; | ||||
| 450 | } | ||||
| 451 | } | ||||
| 452 | |||||
| 453 | 159 | 315µs | return $AbsName; | ||
| 454 | } | ||||
| 455 | |||||
| 456 | 1 | 100ns | our($dir, $name, $fullname, $prune); | ||
| 457 | sub _find_dir_symlnk($$$); | ||||
| 458 | sub _find_dir($$$); | ||||
| 459 | |||||
| 460 | # check whether or not a scalar variable is tainted | ||||
| 461 | # (code straight from the Camel, 3rd ed., page 561) | ||||
| 462 | sub is_tainted_pp { | ||||
| 463 | my $arg = shift; | ||||
| 464 | my $nada = substr($arg, 0, 0); # zero-length | ||||
| 465 | local $@; | ||||
| 466 | eval { eval "# $nada" }; | ||||
| 467 | return length($@) != 0; | ||||
| 468 | } | ||||
| 469 | |||||
| 470 | # spent 9.01ms (61µs+8.95) within File::Find::_find_opt which was called:
# once (61µs+8.95ms) by File::Find::find at line 1079 | ||||
| 471 | 1 | 200ns | my $wanted = shift; | ||
| 472 | 1 | 300ns | die "invalid top directory" unless defined $_[0]; | ||
| 473 | |||||
| 474 | # This function must local()ize everything because callbacks may | ||||
| 475 | # call find() or finddepth() | ||||
| 476 | |||||
| 477 | 1 | 300ns | local %SLnkSeen; | ||
| 478 | 1 | 500ns | local ($wanted_callback, $avoid_nlink, $bydepth, $no_chdir, $follow, | ||
| 479 | $follow_skip, $full_check, $untaint, $untaint_skip, $untaint_pat, | ||||
| 480 | $pre_process, $post_process, $dangling_symlinks); | ||||
| 481 | 1 | 200ns | local($dir, $name, $fullname, $prune); | ||
| 482 | 1 | 600ns | local *_ = \my $a; | ||
| 483 | |||||
| 484 | 1 | 34µs | 1 | 28µs | my $cwd = $wanted->{bydepth} ? Cwd::fastcwd() : Cwd::getcwd(); # spent 28µs making 1 call to Cwd::getcwd |
| 485 | 1 | 100ns | if ($Is_VMS) { | ||
| 486 | # VMS returns this by default in VMS format which just doesn't | ||||
| 487 | # work for the rest of this module. | ||||
| 488 | $cwd = VMS::Filespec::unixpath($cwd); | ||||
| 489 | |||||
| 490 | # Apparently this is not expected to have a trailing space. | ||||
| 491 | # To attempt to make VMS/UNIX conversions mostly reversable, | ||||
| 492 | # a trailing slash is needed. The run-time functions ignore the | ||||
| 493 | # resulting double slash, but it causes the perl tests to fail. | ||||
| 494 | $cwd =~ s#/\z##; | ||||
| 495 | |||||
| 496 | # This comes up in upper case now, but should be lower. | ||||
| 497 | # In the future this could be exact case, no need to change. | ||||
| 498 | } | ||||
| 499 | 1 | 300ns | my $cwd_untainted = $cwd; | ||
| 500 | 1 | 200ns | my $check_t_cwd = 1; | ||
| 501 | 1 | 300ns | $wanted_callback = $wanted->{wanted}; | ||
| 502 | 1 | 100ns | $bydepth = $wanted->{bydepth}; | ||
| 503 | 1 | 100ns | $pre_process = $wanted->{preprocess}; | ||
| 504 | 1 | 100ns | $post_process = $wanted->{postprocess}; | ||
| 505 | 1 | 100ns | $no_chdir = $wanted->{no_chdir}; | ||
| 506 | 1 | 300ns | $full_check = $Is_Win32 ? 0 : $wanted->{follow}; | ||
| 507 | 1 | 300ns | $follow = $Is_Win32 ? 0 : | ||
| 508 | $full_check || $wanted->{follow_fast}; | ||||
| 509 | 1 | 200ns | $follow_skip = $wanted->{follow_skip}; | ||
| 510 | 1 | 100ns | $untaint = $wanted->{untaint}; | ||
| 511 | 1 | 100ns | $untaint_pat = $wanted->{untaint_pattern}; | ||
| 512 | 1 | 100ns | $untaint_skip = $wanted->{untaint_skip}; | ||
| 513 | 1 | 200ns | $dangling_symlinks = $wanted->{dangling_symlinks}; | ||
| 514 | |||||
| 515 | # for compatibility reasons (find.pl, find2perl) | ||||
| 516 | 1 | 300ns | local our ($topdir, $topdev, $topino, $topmode, $topnlink); | ||
| 517 | |||||
| 518 | # a symbolic link to a directory doesn't increase the link count | ||||
| 519 | 1 | 100ns | $avoid_nlink = $follow || $File::Find::dont_use_nlink; | ||
| 520 | |||||
| 521 | 1 | 100ns | my ($abs_dir, $Is_Dir); | ||
| 522 | |||||
| 523 | Proc_Top_Item: | ||||
| 524 | 1 | 25µs | foreach my $TOP (@_) { | ||
| 525 | 1 | 300ns | my $top_item = $TOP; | ||
| 526 | 1 | 0s | $top_item = VMS::Filespec::unixify($top_item) if $Is_VMS; | ||
| 527 | |||||
| 528 | 1 | 10µs | 1 | 5µs | ($topdev,$topino,$topmode,$topnlink) = $follow ? stat $top_item : lstat $top_item; # spent 5µs making 1 call to File::Find::CORE:stat |
| 529 | |||||
| 530 | 1 | 200ns | if ($Is_Win32) { | ||
| 531 | $top_item =~ s|[/\\]\z|| | ||||
| 532 | unless $top_item =~ m{^(?:\w:)?[/\\]$}; | ||||
| 533 | } | ||||
| 534 | else { | ||||
| 535 | 1 | 4µs | 1 | 600ns | $top_item =~ s|/\z|| unless $top_item eq '/'; # spent 600ns making 1 call to File::Find::CORE:subst |
| 536 | } | ||||
| 537 | |||||
| 538 | 1 | 100ns | $Is_Dir= 0; | ||
| 539 | |||||
| 540 | 1 | 200ns | if ($follow) { | ||
| 541 | |||||
| 542 | 1 | 1µs | if (substr($top_item,0,1) eq '/') { | ||
| 543 | $abs_dir = $top_item; | ||||
| 544 | } | ||||
| 545 | elsif ($top_item eq $File::Find::current_dir) { | ||||
| 546 | $abs_dir = $cwd; | ||||
| 547 | } | ||||
| 548 | else { # care about any ../ | ||||
| 549 | $top_item =~ s/\.dir\z//i if $Is_VMS; | ||||
| 550 | $abs_dir = contract_name("$cwd/",$top_item); | ||||
| 551 | } | ||||
| 552 | 1 | 1µs | 1 | 23µs | $abs_dir= Follow_SymLink($abs_dir); # spent 23µs making 1 call to File::Find::Follow_SymLink |
| 553 | 1 | 200ns | unless (defined $abs_dir) { | ||
| 554 | if ($dangling_symlinks) { | ||||
| 555 | if (ref $dangling_symlinks eq 'CODE') { | ||||
| 556 | $dangling_symlinks->($top_item, $cwd); | ||||
| 557 | } else { | ||||
| 558 | warnings::warnif "$top_item is a dangling symbolic link\n"; | ||||
| 559 | } | ||||
| 560 | } | ||||
| 561 | next Proc_Top_Item; | ||||
| 562 | } | ||||
| 563 | |||||
| 564 | 1 | 4µs | 1 | 300ns | if (-d _) { # spent 300ns making 1 call to File::Find::CORE:ftdir |
| 565 | 1 | 0s | $top_item =~ s/\.dir\z//i if $Is_VMS; | ||
| 566 | 1 | 1µs | 1 | 8.89ms | _find_dir_symlnk($wanted, $abs_dir, $top_item); # spent 8.89ms making 1 call to File::Find::_find_dir_symlnk |
| 567 | 1 | 300ns | $Is_Dir= 1; | ||
| 568 | } | ||||
| 569 | } | ||||
| 570 | else { # no follow | ||||
| 571 | $topdir = $top_item; | ||||
| 572 | unless (defined $topnlink) { | ||||
| 573 | warnings::warnif "Can't stat $top_item: $!\n"; | ||||
| 574 | next Proc_Top_Item; | ||||
| 575 | } | ||||
| 576 | if (-d _) { | ||||
| 577 | $top_item =~ s/\.dir\z//i if $Is_VMS; | ||||
| 578 | _find_dir($wanted, $top_item, $topnlink); | ||||
| 579 | $Is_Dir= 1; | ||||
| 580 | } | ||||
| 581 | else { | ||||
| 582 | $abs_dir= $top_item; | ||||
| 583 | } | ||||
| 584 | } | ||||
| 585 | |||||
| 586 | 1 | 100ns | unless ($Is_Dir) { | ||
| 587 | unless (($_,$dir) = File::Basename::fileparse($abs_dir)) { | ||||
| 588 | ($dir,$_) = ('./', $top_item); | ||||
| 589 | } | ||||
| 590 | |||||
| 591 | $abs_dir = $dir; | ||||
| 592 | if (( $untaint ) && (is_tainted($dir) )) { | ||||
| 593 | ( $abs_dir ) = $dir =~ m|$untaint_pat|; | ||||
| 594 | unless (defined $abs_dir) { | ||||
| 595 | if ($untaint_skip == 0) { | ||||
| 596 | die "directory $dir is still tainted"; | ||||
| 597 | } | ||||
| 598 | else { | ||||
| 599 | next Proc_Top_Item; | ||||
| 600 | } | ||||
| 601 | } | ||||
| 602 | } | ||||
| 603 | |||||
| 604 | unless ($no_chdir || chdir $abs_dir) { | ||||
| 605 | warnings::warnif "Couldn't chdir $abs_dir: $!\n"; | ||||
| 606 | next Proc_Top_Item; | ||||
| 607 | } | ||||
| 608 | |||||
| 609 | $name = $abs_dir . $_; # $File::Find::name | ||||
| 610 | $_ = $name if $no_chdir; | ||||
| 611 | |||||
| 612 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 613 | |||||
| 614 | } | ||||
| 615 | |||||
| 616 | 1 | 700ns | unless ( $no_chdir ) { | ||
| 617 | if ( ($check_t_cwd) && (($untaint) && (is_tainted($cwd) )) ) { | ||||
| 618 | ( $cwd_untainted ) = $cwd =~ m|$untaint_pat|; | ||||
| 619 | unless (defined $cwd_untainted) { | ||||
| 620 | die "insecure cwd in find(depth)"; | ||||
| 621 | } | ||||
| 622 | $check_t_cwd = 0; | ||||
| 623 | } | ||||
| 624 | unless (chdir $cwd_untainted) { | ||||
| 625 | die "Can't cd to $cwd: $!\n"; | ||||
| 626 | } | ||||
| 627 | } | ||||
| 628 | } | ||||
| 629 | } | ||||
| 630 | |||||
| 631 | # API: | ||||
| 632 | # $wanted | ||||
| 633 | # $p_dir : "parent directory" | ||||
| 634 | # $nlink : what came back from the stat | ||||
| 635 | # preconditions: | ||||
| 636 | # chdir (if not no_chdir) to dir | ||||
| 637 | |||||
| 638 | sub _find_dir($$$) { | ||||
| 639 | my ($wanted, $p_dir, $nlink) = @_; | ||||
| 640 | my ($CdLvl,$Level) = (0,0); | ||||
| 641 | my @Stack; | ||||
| 642 | my @filenames; | ||||
| 643 | my ($subcount,$sub_nlink); | ||||
| 644 | my $SE= []; | ||||
| 645 | my $dir_name= $p_dir; | ||||
| 646 | my $dir_pref; | ||||
| 647 | my $dir_rel = $File::Find::current_dir; | ||||
| 648 | my $tainted = 0; | ||||
| 649 | my $no_nlink; | ||||
| 650 | |||||
| 651 | if ($Is_Win32) { | ||||
| 652 | $dir_pref | ||||
| 653 | = ($p_dir =~ m{^(?:\w:[/\\]?|[/\\])$} ? $p_dir : "$p_dir/" ); | ||||
| 654 | } elsif ($Is_VMS) { | ||||
| 655 | |||||
| 656 | # VMS is returning trailing .dir on directories | ||||
| 657 | # and trailing . on files and symbolic links | ||||
| 658 | # in UNIX syntax. | ||||
| 659 | # | ||||
| 660 | |||||
| 661 | $p_dir =~ s/\.(dir)?$//i unless $p_dir eq '.'; | ||||
| 662 | |||||
| 663 | $dir_pref = ($p_dir =~ m/[\]>]+$/ ? $p_dir : "$p_dir/" ); | ||||
| 664 | } | ||||
| 665 | else { | ||||
| 666 | $dir_pref= ( $p_dir eq '/' ? '/' : "$p_dir/" ); | ||||
| 667 | } | ||||
| 668 | |||||
| 669 | local ($dir, $name, $prune, *DIR); | ||||
| 670 | |||||
| 671 | unless ( $no_chdir || ($p_dir eq $File::Find::current_dir)) { | ||||
| 672 | my $udir = $p_dir; | ||||
| 673 | if (( $untaint ) && (is_tainted($p_dir) )) { | ||||
| 674 | ( $udir ) = $p_dir =~ m|$untaint_pat|; | ||||
| 675 | unless (defined $udir) { | ||||
| 676 | if ($untaint_skip == 0) { | ||||
| 677 | die "directory $p_dir is still tainted"; | ||||
| 678 | } | ||||
| 679 | else { | ||||
| 680 | return; | ||||
| 681 | } | ||||
| 682 | } | ||||
| 683 | } | ||||
| 684 | unless (chdir ($Is_VMS && $udir !~ /[\/\[<]+/ ? "./$udir" : $udir)) { | ||||
| 685 | warnings::warnif "Can't cd to $udir: $!\n"; | ||||
| 686 | return; | ||||
| 687 | } | ||||
| 688 | } | ||||
| 689 | |||||
| 690 | # push the starting directory | ||||
| 691 | push @Stack,[$CdLvl,$p_dir,$dir_rel,-1] if $bydepth; | ||||
| 692 | |||||
| 693 | while (defined $SE) { | ||||
| 694 | unless ($bydepth) { | ||||
| 695 | $dir= $p_dir; # $File::Find::dir | ||||
| 696 | $name= $dir_name; # $File::Find::name | ||||
| 697 | $_= ($no_chdir ? $dir_name : $dir_rel ); # $_ | ||||
| 698 | # prune may happen here | ||||
| 699 | $prune= 0; | ||||
| 700 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 701 | next if $prune; | ||||
| 702 | } | ||||
| 703 | |||||
| 704 | # change to that directory | ||||
| 705 | unless ($no_chdir || ($dir_rel eq $File::Find::current_dir)) { | ||||
| 706 | my $udir= $dir_rel; | ||||
| 707 | if ( ($untaint) && (($tainted) || ($tainted = is_tainted($dir_rel) )) ) { | ||||
| 708 | ( $udir ) = $dir_rel =~ m|$untaint_pat|; | ||||
| 709 | unless (defined $udir) { | ||||
| 710 | if ($untaint_skip == 0) { | ||||
| 711 | die "directory (" . ($p_dir ne '/' ? $p_dir : '') . "/) $dir_rel is still tainted"; | ||||
| 712 | } else { # $untaint_skip == 1 | ||||
| 713 | next; | ||||
| 714 | } | ||||
| 715 | } | ||||
| 716 | } | ||||
| 717 | unless (chdir ($Is_VMS && $udir !~ /[\/\[<]+/ ? "./$udir" : $udir)) { | ||||
| 718 | warnings::warnif "Can't cd to (" . | ||||
| 719 | ($p_dir ne '/' ? $p_dir : '') . "/) $udir: $!\n"; | ||||
| 720 | next; | ||||
| 721 | } | ||||
| 722 | $CdLvl++; | ||||
| 723 | } | ||||
| 724 | |||||
| 725 | $dir= $dir_name; # $File::Find::dir | ||||
| 726 | |||||
| 727 | # Get the list of files in the current directory. | ||||
| 728 | unless (opendir DIR, ($no_chdir ? $dir_name : $File::Find::current_dir)) { | ||||
| 729 | warnings::warnif "Can't opendir($dir_name): $!\n"; | ||||
| 730 | next; | ||||
| 731 | } | ||||
| 732 | @filenames = readdir DIR; | ||||
| 733 | closedir(DIR); | ||||
| 734 | @filenames = $pre_process->(@filenames) if $pre_process; | ||||
| 735 | push @Stack,[$CdLvl,$dir_name,"",-2] if $post_process; | ||||
| 736 | |||||
| 737 | # default: use whatever was specified | ||||
| 738 | # (if $nlink >= 2, and $avoid_nlink == 0, this will switch back) | ||||
| 739 | $no_nlink = $avoid_nlink; | ||||
| 740 | # if dir has wrong nlink count, force switch to slower stat method | ||||
| 741 | $no_nlink = 1 if ($nlink < 2); | ||||
| 742 | |||||
| 743 | if ($nlink == 2 && !$no_nlink) { | ||||
| 744 | # This dir has no subdirectories. | ||||
| 745 | for my $FN (@filenames) { | ||||
| 746 | if ($Is_VMS) { | ||||
| 747 | # Big hammer here - Compensate for VMS trailing . and .dir | ||||
| 748 | # No win situation until this is changed, but this | ||||
| 749 | # will handle the majority of the cases with breaking the fewest | ||||
| 750 | |||||
| 751 | $FN =~ s/\.dir\z//i; | ||||
| 752 | $FN =~ s#\.$## if ($FN ne '.'); | ||||
| 753 | } | ||||
| 754 | next if $FN =~ $File::Find::skip_pattern; | ||||
| 755 | |||||
| 756 | $name = $dir_pref . $FN; # $File::Find::name | ||||
| 757 | $_ = ($no_chdir ? $name : $FN); # $_ | ||||
| 758 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 759 | } | ||||
| 760 | |||||
| 761 | } | ||||
| 762 | else { | ||||
| 763 | # This dir has subdirectories. | ||||
| 764 | $subcount = $nlink - 2; | ||||
| 765 | |||||
| 766 | # HACK: insert directories at this position. so as to preserve | ||||
| 767 | # the user pre-processed ordering of files. | ||||
| 768 | # EG: directory traversal is in user sorted order, not at random. | ||||
| 769 | my $stack_top = @Stack; | ||||
| 770 | |||||
| 771 | for my $FN (@filenames) { | ||||
| 772 | next if $FN =~ $File::Find::skip_pattern; | ||||
| 773 | if ($subcount > 0 || $no_nlink) { | ||||
| 774 | # Seen all the subdirs? | ||||
| 775 | # check for directoriness. | ||||
| 776 | # stat is faster for a file in the current directory | ||||
| 777 | $sub_nlink = (lstat ($no_chdir ? $dir_pref . $FN : $FN))[3]; | ||||
| 778 | |||||
| 779 | if (-d _) { | ||||
| 780 | --$subcount; | ||||
| 781 | $FN =~ s/\.dir\z//i if $Is_VMS; | ||||
| 782 | # HACK: replace push to preserve dir traversal order | ||||
| 783 | #push @Stack,[$CdLvl,$dir_name,$FN,$sub_nlink]; | ||||
| 784 | splice @Stack, $stack_top, 0, | ||||
| 785 | [$CdLvl,$dir_name,$FN,$sub_nlink]; | ||||
| 786 | } | ||||
| 787 | else { | ||||
| 788 | $name = $dir_pref . $FN; # $File::Find::name | ||||
| 789 | $_= ($no_chdir ? $name : $FN); # $_ | ||||
| 790 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 791 | } | ||||
| 792 | } | ||||
| 793 | else { | ||||
| 794 | $name = $dir_pref . $FN; # $File::Find::name | ||||
| 795 | $_= ($no_chdir ? $name : $FN); # $_ | ||||
| 796 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 797 | } | ||||
| 798 | } | ||||
| 799 | } | ||||
| 800 | } | ||||
| 801 | continue { | ||||
| 802 | while ( defined ($SE = pop @Stack) ) { | ||||
| 803 | ($Level, $p_dir, $dir_rel, $nlink) = @$SE; | ||||
| 804 | if ($CdLvl > $Level && !$no_chdir) { | ||||
| 805 | my $tmp; | ||||
| 806 | if ($Is_VMS) { | ||||
| 807 | $tmp = '[' . ('-' x ($CdLvl-$Level)) . ']'; | ||||
| 808 | } | ||||
| 809 | else { | ||||
| 810 | $tmp = join('/',('..') x ($CdLvl-$Level)); | ||||
| 811 | } | ||||
| 812 | die "Can't cd to $tmp from $dir_name" | ||||
| 813 | unless chdir ($tmp); | ||||
| 814 | $CdLvl = $Level; | ||||
| 815 | } | ||||
| 816 | |||||
| 817 | if ($Is_Win32) { | ||||
| 818 | $dir_name = ($p_dir =~ m{^(?:\w:[/\\]?|[/\\])$} | ||||
| 819 | ? "$p_dir$dir_rel" : "$p_dir/$dir_rel"); | ||||
| 820 | $dir_pref = "$dir_name/"; | ||||
| 821 | } | ||||
| 822 | elsif ($^O eq 'VMS') { | ||||
| 823 | if ($p_dir =~ m/[\]>]+$/) { | ||||
| 824 | $dir_name = $p_dir; | ||||
| 825 | $dir_name =~ s/([\]>]+)$/.$dir_rel$1/; | ||||
| 826 | $dir_pref = $dir_name; | ||||
| 827 | } | ||||
| 828 | else { | ||||
| 829 | $dir_name = "$p_dir/$dir_rel"; | ||||
| 830 | $dir_pref = "$dir_name/"; | ||||
| 831 | } | ||||
| 832 | } | ||||
| 833 | else { | ||||
| 834 | $dir_name = ($p_dir eq '/' ? "/$dir_rel" : "$p_dir/$dir_rel"); | ||||
| 835 | $dir_pref = "$dir_name/"; | ||||
| 836 | } | ||||
| 837 | |||||
| 838 | if ( $nlink == -2 ) { | ||||
| 839 | $name = $dir = $p_dir; # $File::Find::name / dir | ||||
| 840 | $_ = $File::Find::current_dir; | ||||
| 841 | $post_process->(); # End-of-directory processing | ||||
| 842 | } | ||||
| 843 | elsif ( $nlink < 0 ) { # must be finddepth, report dirname now | ||||
| 844 | $name = $dir_name; | ||||
| 845 | if ( substr($name,-2) eq '/.' ) { | ||||
| 846 | substr($name, length($name) == 2 ? -1 : -2) = ''; | ||||
| 847 | } | ||||
| 848 | $dir = $p_dir; | ||||
| 849 | $_ = ($no_chdir ? $dir_name : $dir_rel ); | ||||
| 850 | if ( substr($_,-2) eq '/.' ) { | ||||
| 851 | substr($_, length($_) == 2 ? -1 : -2) = ''; | ||||
| 852 | } | ||||
| 853 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 854 | } | ||||
| 855 | else { | ||||
| 856 | push @Stack,[$CdLvl,$p_dir,$dir_rel,-1] if $bydepth; | ||||
| 857 | last; | ||||
| 858 | } | ||||
| 859 | } | ||||
| 860 | } | ||||
| 861 | } | ||||
| 862 | |||||
| 863 | |||||
| 864 | # API: | ||||
| 865 | # $wanted | ||||
| 866 | # $dir_loc : absolute location of a dir | ||||
| 867 | # $p_dir : "parent directory" | ||||
| 868 | # preconditions: | ||||
| 869 | # chdir (if not no_chdir) to dir | ||||
| 870 | |||||
| 871 | # spent 8.89ms (5.12+3.77) within File::Find::_find_dir_symlnk which was called:
# once (5.12ms+3.77ms) by File::Find::_find_opt at line 566 | ||||
| 872 | 1 | 500ns | my ($wanted, $dir_loc, $p_dir) = @_; # $dir_loc is the absolute directory | ||
| 873 | 1 | 100ns | my @Stack; | ||
| 874 | 1 | 0s | my @filenames; | ||
| 875 | 1 | 100ns | my $new_loc; | ||
| 876 | 1 | 100ns | my $updir_loc = $dir_loc; # untainted parent directory | ||
| 877 | 1 | 400ns | my $SE = []; | ||
| 878 | 1 | 100ns | my $dir_name = $p_dir; | ||
| 879 | 1 | 0s | my $dir_pref; | ||
| 880 | 1 | 0s | my $loc_pref; | ||
| 881 | 1 | 200ns | my $dir_rel = $File::Find::current_dir; | ||
| 882 | 1 | 0s | my $byd_flag; # flag for pending stack entry if $bydepth | ||
| 883 | 1 | 100ns | my $tainted = 0; | ||
| 884 | 1 | 100ns | my $ok = 1; | ||
| 885 | |||||
| 886 | 1 | 600ns | $dir_pref = ( $p_dir eq '/' ? '/' : "$p_dir/" ); | ||
| 887 | 1 | 300ns | $loc_pref = ( $dir_loc eq '/' ? '/' : "$dir_loc/" ); | ||
| 888 | |||||
| 889 | 1 | 900ns | local ($dir, $name, $fullname, $prune, *DIR); | ||
| 890 | |||||
| 891 | 1 | 100ns | unless ($no_chdir) { | ||
| 892 | # untaint the topdir | ||||
| 893 | if (( $untaint ) && (is_tainted($dir_loc) )) { | ||||
| 894 | ( $updir_loc ) = $dir_loc =~ m|$untaint_pat|; # parent dir, now untainted | ||||
| 895 | # once untainted, $updir_loc is pushed on the stack (as parent directory); | ||||
| 896 | # hence, we don't need to untaint the parent directory every time we chdir | ||||
| 897 | # to it later | ||||
| 898 | unless (defined $updir_loc) { | ||||
| 899 | if ($untaint_skip == 0) { | ||||
| 900 | die "directory $dir_loc is still tainted"; | ||||
| 901 | } | ||||
| 902 | else { | ||||
| 903 | return; | ||||
| 904 | } | ||||
| 905 | } | ||||
| 906 | } | ||||
| 907 | $ok = chdir($updir_loc) unless ($p_dir eq $File::Find::current_dir); | ||||
| 908 | unless ($ok) { | ||||
| 909 | warnings::warnif "Can't cd to $updir_loc: $!\n"; | ||||
| 910 | return; | ||||
| 911 | } | ||||
| 912 | } | ||||
| 913 | |||||
| 914 | 1 | 0s | push @Stack,[$dir_loc,$updir_loc,$p_dir,$dir_rel,-1] if $bydepth; | ||
| 915 | |||||
| 916 | 1 | 15µs | while (defined $SE) { | ||
| 917 | |||||
| 918 | 18 | 2µs | unless ($bydepth) { | ||
| 919 | # change (back) to parent directory (always untainted) | ||||
| 920 | 18 | 400ns | unless ($no_chdir) { | ||
| 921 | unless (chdir $updir_loc) { | ||||
| 922 | warnings::warnif "Can't cd to $updir_loc: $!\n"; | ||||
| 923 | next; | ||||
| 924 | } | ||||
| 925 | } | ||||
| 926 | 18 | 2µs | $dir= $p_dir; # $File::Find::dir | ||
| 927 | 18 | 500ns | $name= $dir_name; # $File::Find::name | ||
| 928 | 18 | 4µs | $_= ($no_chdir ? $dir_name : $dir_rel ); # $_ | ||
| 929 | 18 | 1µs | $fullname= $dir_loc; # $File::Find::fullname | ||
| 930 | # prune may happen here | ||||
| 931 | 18 | 2µs | $prune= 0; | ||
| 932 | 18 | 91µs | 18 | 60µs | lstat($_); # make sure file tests with '_' work # spent 60µs making 18 calls to File::Find::CORE:lstat, avg 3µs/call |
| 933 | 36 | 23µs | 18 | 100µs | { $wanted_callback->() }; # protect against wild "next" # spent 100µs making 18 calls to Module::Pluggable::Object::__ANON__[Module/Pluggable/Object.pm:317], avg 6µs/call |
| 934 | 18 | 2µs | next if $prune; | ||
| 935 | } | ||||
| 936 | |||||
| 937 | # change to that directory | ||||
| 938 | 18 | 200ns | unless ($no_chdir || ($dir_rel eq $File::Find::current_dir)) { | ||
| 939 | $updir_loc = $dir_loc; | ||||
| 940 | if ( ($untaint) && (($tainted) || ($tainted = is_tainted($dir_loc) )) ) { | ||||
| 941 | # untaint $dir_loc, what will be pushed on the stack as (untainted) parent dir | ||||
| 942 | ( $updir_loc ) = $dir_loc =~ m|$untaint_pat|; | ||||
| 943 | unless (defined $updir_loc) { | ||||
| 944 | if ($untaint_skip == 0) { | ||||
| 945 | die "directory $dir_loc is still tainted"; | ||||
| 946 | } | ||||
| 947 | else { | ||||
| 948 | next; | ||||
| 949 | } | ||||
| 950 | } | ||||
| 951 | } | ||||
| 952 | unless (chdir $updir_loc) { | ||||
| 953 | warnings::warnif "Can't cd to $updir_loc: $!\n"; | ||||
| 954 | next; | ||||
| 955 | } | ||||
| 956 | } | ||||
| 957 | |||||
| 958 | 18 | 4µs | $dir = $dir_name; # $File::Find::dir | ||
| 959 | |||||
| 960 | # Get the list of files in the current directory. | ||||
| 961 | 18 | 161µs | 18 | 125µs | unless (opendir DIR, ($no_chdir ? $dir_loc : $File::Find::current_dir)) { # spent 125µs making 18 calls to File::Find::CORE:open_dir, avg 7µs/call |
| 962 | warnings::warnif "Can't opendir($dir_loc): $!\n"; | ||||
| 963 | next; | ||||
| 964 | } | ||||
| 965 | 18 | 337µs | 18 | 259µs | @filenames = readdir DIR; # spent 259µs making 18 calls to File::Find::CORE:readdir, avg 14µs/call |
| 966 | 18 | 76µs | 18 | 45µs | closedir(DIR); # spent 45µs making 18 calls to File::Find::CORE:closedir, avg 3µs/call |
| 967 | |||||
| 968 | 18 | 12µs | for my $FN (@filenames) { | ||
| 969 | 194 | 4µs | if ($Is_VMS) { | ||
| 970 | # Big hammer here - Compensate for VMS trailing . and .dir | ||||
| 971 | # No win situation until this is changed, but this | ||||
| 972 | # will handle the majority of the cases with breaking the fewest. | ||||
| 973 | |||||
| 974 | $FN =~ s/\.dir\z//i; | ||||
| 975 | $FN =~ s#\.$## if ($FN ne '.'); | ||||
| 976 | } | ||||
| 977 | 194 | 677µs | 388 | 223µs | next if $FN =~ $File::Find::skip_pattern; # spent 160µs making 194 calls to File::Find::CORE:regcomp, avg 823ns/call
# spent 63µs making 194 calls to File::Find::CORE:match, avg 326ns/call |
| 978 | |||||
| 979 | # follow symbolic links / do an lstat | ||||
| 980 | 158 | 202µs | 158 | 1.70ms | $new_loc = Follow_SymLink($loc_pref.$FN); # spent 1.70ms making 158 calls to File::Find::Follow_SymLink, avg 11µs/call |
| 981 | |||||
| 982 | # ignore if invalid symlink | ||||
| 983 | 158 | 16µs | unless (defined $new_loc) { | ||
| 984 | if (!defined -l _ && $dangling_symlinks) { | ||||
| 985 | if (ref $dangling_symlinks eq 'CODE') { | ||||
| 986 | $dangling_symlinks->($FN, $dir_pref); | ||||
| 987 | } else { | ||||
| 988 | warnings::warnif "$dir_pref$FN is a dangling symbolic link\n"; | ||||
| 989 | } | ||||
| 990 | } | ||||
| 991 | |||||
| 992 | $fullname = undef; | ||||
| 993 | $name = $dir_pref . $FN; | ||||
| 994 | $_ = ($no_chdir ? $name : $FN); | ||||
| 995 | { $wanted_callback->() }; | ||||
| 996 | next; | ||||
| 997 | } | ||||
| 998 | |||||
| 999 | 158 | 3.48ms | 158 | 33µs | if (-d _) { # spent 33µs making 158 calls to File::Find::CORE:ftdir, avg 207ns/call |
| 1000 | 17 | 200ns | if ($Is_VMS) { | ||
| 1001 | $FN =~ s/\.dir\z//i; | ||||
| 1002 | $FN =~ s#\.$## if ($FN ne '.'); | ||||
| 1003 | $new_loc =~ s/\.dir\z//i; | ||||
| 1004 | $new_loc =~ s#\.$## if ($new_loc ne '.'); | ||||
| 1005 | } | ||||
| 1006 | 17 | 30µs | push @Stack,[$new_loc,$updir_loc,$dir_name,$FN,1]; | ||
| 1007 | } | ||||
| 1008 | else { | ||||
| 1009 | 141 | 17µs | $fullname = $new_loc; # $File::Find::fullname | ||
| 1010 | 141 | 30µs | $name = $dir_pref . $FN; # $File::Find::name | ||
| 1011 | 141 | 15µs | $_ = ($no_chdir ? $name : $FN); # $_ | ||
| 1012 | 282 | 161µs | 141 | 1.22ms | { $wanted_callback->() }; # protect against wild "next" # spent 1.22ms making 141 calls to Module::Pluggable::Object::__ANON__[Module/Pluggable/Object.pm:317], avg 9µs/call |
| 1013 | } | ||||
| 1014 | } | ||||
| 1015 | |||||
| 1016 | } | ||||
| 1017 | continue { | ||||
| 1018 | 18 | 19µs | while (defined($SE = pop @Stack)) { | ||
| 1019 | 17 | 27µs | ($dir_loc, $updir_loc, $p_dir, $dir_rel, $byd_flag) = @$SE; | ||
| 1020 | 17 | 9µs | $dir_name = ($p_dir eq '/' ? "/$dir_rel" : "$p_dir/$dir_rel"); | ||
| 1021 | 17 | 2µs | $dir_pref = "$dir_name/"; | ||
| 1022 | 17 | 2µs | $loc_pref = "$dir_loc/"; | ||
| 1023 | 17 | 2µs | if ( $byd_flag < 0 ) { # must be finddepth, report dirname now | ||
| 1024 | unless ($no_chdir || ($dir_rel eq $File::Find::current_dir)) { | ||||
| 1025 | unless (chdir $updir_loc) { # $updir_loc (parent dir) is always untainted | ||||
| 1026 | warnings::warnif "Can't cd to $updir_loc: $!\n"; | ||||
| 1027 | next; | ||||
| 1028 | } | ||||
| 1029 | } | ||||
| 1030 | $fullname = $dir_loc; # $File::Find::fullname | ||||
| 1031 | $name = $dir_name; # $File::Find::name | ||||
| 1032 | if ( substr($name,-2) eq '/.' ) { | ||||
| 1033 | substr($name, length($name) == 2 ? -1 : -2) = ''; # $File::Find::name | ||||
| 1034 | } | ||||
| 1035 | $dir = $p_dir; # $File::Find::dir | ||||
| 1036 | $_ = ($no_chdir ? $dir_name : $dir_rel); # $_ | ||||
| 1037 | if ( substr($_,-2) eq '/.' ) { | ||||
| 1038 | substr($_, length($_) == 2 ? -1 : -2) = ''; | ||||
| 1039 | } | ||||
| 1040 | |||||
| 1041 | lstat($_); # make sure file tests with '_' work | ||||
| 1042 | { $wanted_callback->() }; # protect against wild "next" | ||||
| 1043 | } | ||||
| 1044 | else { | ||||
| 1045 | 17 | 2µs | push @Stack,[$dir_loc, $updir_loc, $p_dir, $dir_rel,-1] if $bydepth; | ||
| 1046 | 17 | 4µs | last; | ||
| 1047 | } | ||||
| 1048 | } | ||||
| 1049 | } | ||||
| 1050 | } | ||||
| 1051 | |||||
| 1052 | |||||
| 1053 | # spent 4µs within File::Find::wrap_wanted which was called:
# once (4µs+0s) by File::Find::find at line 1079 | ||||
| 1054 | 1 | 100ns | my $wanted = shift; | ||
| 1055 | 1 | 600ns | if ( ref($wanted) eq 'HASH' ) { | ||
| 1056 | 1 | 600ns | unless( exists $wanted->{wanted} and ref( $wanted->{wanted} ) eq 'CODE' ) { | ||
| 1057 | die 'no &wanted subroutine given'; | ||||
| 1058 | } | ||||
| 1059 | 1 | 700ns | if ( $wanted->{follow} || $wanted->{follow_fast}) { | ||
| 1060 | $wanted->{follow_skip} = 1 unless defined $wanted->{follow_skip}; | ||||
| 1061 | } | ||||
| 1062 | 1 | 100ns | if ( $wanted->{untaint} ) { | ||
| 1063 | $wanted->{untaint_pattern} = $File::Find::untaint_pattern | ||||
| 1064 | unless defined $wanted->{untaint_pattern}; | ||||
| 1065 | $wanted->{untaint_skip} = 0 unless defined $wanted->{untaint_skip}; | ||||
| 1066 | } | ||||
| 1067 | 1 | 8µs | return $wanted; | ||
| 1068 | } | ||||
| 1069 | elsif( ref( $wanted ) eq 'CODE' ) { | ||||
| 1070 | return { wanted => $wanted }; | ||||
| 1071 | } | ||||
| 1072 | else { | ||||
| 1073 | die 'no &wanted subroutine given'; | ||||
| 1074 | } | ||||
| 1075 | } | ||||
| 1076 | |||||
| 1077 | # spent 9.03ms (12µs+9.01) within File::Find::find which was called:
# once (12µs+9.01ms) by Module::Pluggable::Object::find_files at line 318 of Module/Pluggable/Object.pm | ||||
| 1078 | 1 | 200ns | my $wanted = shift; | ||
| 1079 | 1 | 5µs | 2 | 9.01ms | _find_opt(wrap_wanted($wanted), @_); # spent 9.01ms making 1 call to File::Find::_find_opt
# spent 4µs making 1 call to File::Find::wrap_wanted |
| 1080 | } | ||||
| 1081 | |||||
| 1082 | sub finddepth { | ||||
| 1083 | my $wanted = wrap_wanted(shift); | ||||
| 1084 | $wanted->{bydepth} = 1; | ||||
| 1085 | _find_opt($wanted, @_); | ||||
| 1086 | } | ||||
| 1087 | |||||
| 1088 | # default | ||||
| 1089 | 1 | 7µs | 1 | 2µs | $File::Find::skip_pattern = qr/^\.{1,2}\z/; # spent 2µs making 1 call to File::Find::CORE:qr |
| 1090 | 1 | 3µs | 1 | 1µs | $File::Find::untaint_pattern = qr|^([-+@\w./]+)$|; # spent 1µs making 1 call to File::Find::CORE:qr |
| 1091 | |||||
| 1092 | # These are hard-coded for now, but may move to hint files. | ||||
| 1093 | 1 | 700ns | if ($^O eq 'VMS') { | ||
| 1094 | $Is_VMS = 1; | ||||
| 1095 | $File::Find::dont_use_nlink = 1; | ||||
| 1096 | } | ||||
| 1097 | elsif ($^O eq 'MSWin32') { | ||||
| 1098 | $Is_Win32 = 1; | ||||
| 1099 | } | ||||
| 1100 | |||||
| 1101 | # this _should_ work properly on all platforms | ||||
| 1102 | # where File::Find can be expected to work | ||||
| 1103 | 1 | 5µs | 1 | 2µs | $File::Find::current_dir = File::Spec->curdir || '.'; # spent 2µs making 1 call to File::Spec::Unix::curdir |
| 1104 | |||||
| 1105 | 1 | 1µs | $File::Find::dont_use_nlink = 1 | ||
| 1106 | if $^O eq 'os2' || $^O eq 'dos' || $^O eq 'amigaos' || $Is_Win32 || | ||||
| 1107 | $^O eq 'interix' || $^O eq 'cygwin' || $^O eq 'qnx' || $^O eq 'nto'; | ||||
| 1108 | |||||
| 1109 | # Set dont_use_nlink in your hint file if your system's stat doesn't | ||||
| 1110 | # report the number of links in a directory as an indication | ||||
| 1111 | # of the number of files. | ||||
| 1112 | # See, e.g. hints/machten.sh for MachTen 2.2. | ||||
| 1113 | 1 | 700ns | unless ($File::Find::dont_use_nlink) { | ||
| 1114 | 1 | 200ns | require Config; | ||
| 1115 | 1 | 3µs | 1 | 2µs | $File::Find::dont_use_nlink = 1 if ($Config::Config{'dont_use_nlink'}); # spent 2µs making 1 call to Config::FETCH |
| 1116 | } | ||||
| 1117 | |||||
| 1118 | # We need a function that checks if a scalar is tainted. Either use the | ||||
| 1119 | # Scalar::Util module's tainted() function or our (slower) pure Perl | ||||
| 1120 | # fallback is_tainted_pp() | ||||
| 1121 | { | ||||
| 1122 | 2 | 300ns | local $@; | ||
| 1123 | 2 | 700ns | eval { require Scalar::Util }; | ||
| 1124 | 1 | 1µs | *is_tainted = $@ ? \&is_tainted_pp : \&Scalar::Util::tainted; | ||
| 1125 | } | ||||
| 1126 | |||||
| 1127 | 1 | 10µs | 1; | ||
# spent 45µs within File::Find::CORE:closedir which was called 18 times, avg 3µs/call:
# 18 times (45µs+0s) by File::Find::_find_dir_symlnk at line 966, avg 3µs/call | |||||
sub File::Find::CORE:ftdir; # opcode | |||||
# spent 32µs within File::Find::CORE:ftlink which was called 159 times, avg 203ns/call:
# 159 times (32µs+0s) by File::Find::Follow_SymLink at line 419, avg 203ns/call | |||||
sub File::Find::CORE:lstat; # opcode | |||||
# spent 63µs within File::Find::CORE:match which was called 194 times, avg 326ns/call:
# 194 times (63µs+0s) by File::Find::_find_dir_symlnk at line 977, avg 326ns/call | |||||
# spent 125µs within File::Find::CORE:open_dir which was called 18 times, avg 7µs/call:
# 18 times (125µs+0s) by File::Find::_find_dir_symlnk at line 961, avg 7µs/call | |||||
sub File::Find::CORE:qr; # opcode | |||||
# spent 259µs within File::Find::CORE:readdir which was called 18 times, avg 14µs/call:
# 18 times (259µs+0s) by File::Find::_find_dir_symlnk at line 965, avg 14µs/call | |||||
# spent 160µs within File::Find::CORE:regcomp which was called 194 times, avg 823ns/call:
# 194 times (160µs+0s) by File::Find::_find_dir_symlnk at line 977, avg 823ns/call | |||||
# spent 5µs within File::Find::CORE:stat which was called:
# once (5µs+0s) by File::Find::_find_opt at line 528 | |||||
# spent 600ns within File::Find::CORE:subst which was called:
# once (600ns+0s) by File::Find::_find_opt at line 535 |