Updated from xsubpp-1.924 to 1.929.

[p5sagit/p5-mst-13.2.git] / lib / File / Find.pm

diff --git a/lib/File/Find.pm b/lib/File/Find.pm
index 612f145..c151bcc 100644 (file)
--- a/lib/File/Find.pm
+++ b/lib/File/Find.pm
@@ -1,9 +1,69 @@
 package File::Find;
 require 5.000;
 require Exporter;
+use Config;
+use Cwd;
+use File::Basename;
+
+=head1 NAME
+
+find - traverse a file tree
+
+finddepth - traverse a directory structure depth-first
+
+=head1 SYNOPSIS
+
+    use File::Find;
+    find(\&wanted, '/foo','/bar');
+    sub wanted { ... }
+    
+    use File::Find;
+    finddepth(\&wanted, '/foo','/bar');
+    sub wanted { ... }
+
+=head1 DESCRIPTION
+
+The wanted() function does whatever verifications you want.  $dir contains
+the current directory name, and $_ the current filename within that
+directory.  $name contains C<"$dir/$_">.  You are chdir()'d to $dir when
+the function is called.  The function may set $prune to prune the tree.
+
+This library is primarily for the C<find2perl> tool, which when fed, 
+
+    find2perl / -name .nfs\* -mtime +7 \
+       -exec rm -f {} \; -o -fstype nfs -prune
+
+produces something like:
+
+    sub wanted {
+        /^\.nfs.*$/ &&
+        (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_)) &&
+        int(-M _) > 7 &&
+        unlink($_)
+        ||
+        ($nlink || (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_))) &&
+        $dev < 0 &&
+        ($prune = 1);
+    }
+
+Set the variable $dont_use_nlink if you're using AFS, since AFS cheats.
+
+C<finddepth> is just like C<find>, except that it does a depth-first
+search.
+
+Here's another interesting wanted function.  It will find all symlinks
+that don't resolve:
+
+    sub wanted {
+       -l && !-e && print "bogus link: $name\n";
+    } 
+
+=cut
 
 @ISA = qw(Exporter);
-@EXPORT = qw(find finddepth);
+@EXPORT = qw(find finddepth $name $dir);
+
+$dont_use_nlink = 1 if $Config{osname} =~ m:^os/?2$:i ;
 
 # Usage:
 #      use File::Find;
@@ -38,7 +98,7 @@ require Exporter;
 
 sub find {
     my $wanted = shift;
-    chop($cwd = `pwd`);
+    my $cwd = fastcwd();
     foreach $topdir (@_) {
        (($topdev,$topino,$topmode,$topnlink) = stat($topdir))
          || (warn("Can't stat $topdir: $!\n"), next);
@@ -48,6 +108,7 @@ sub find {
                $name = $topdir;
                &$wanted;
                ($fixtopdir = $topdir) =~ s,/$,, ;
+               $fixtopdir =~ s/\.dir$// if $Is_VMS; ;
                &finddir($wanted,$fixtopdir,$topnlink);
            }
            else {
@@ -55,7 +116,7 @@ sub find {
            }
        }
        else {
-           unless (($dir,$_) = $topdir =~ m#^(.*/)(.*)$#) {
+           unless (($dir,$_) = fileparse($topdir)) {
                ($dir,$_) = ('.', $topdir);
            }
            $name = $topdir;
@@ -97,13 +158,15 @@ sub finddir {
 
                # Get link count and check for directoriness.
 
-               ($dev,$ino,$mode,$nlink) = lstat($_) unless $nlink;
+               ($dev,$ino,$mode,$nlink) = ($Is_VMS ? stat($_) : lstat($_))
+                   unless ($nlink || $dont_use_nlink);
                
                if (-d _) {
 
                    # It really is a directory, so do it recursively.
 
                    if (!$prune && chdir $_) {
+                       $name =~ s/\.dir$// if $Is_VMS;
                        &finddir($wanted,$name,$nlink);
                        chdir '..';
                    }
@@ -145,13 +208,14 @@ sub finddir {
 
 sub finddepth {
     my $wanted = shift;
-    chop($cwd = `pwd`);
+    $cwd = fastcwd();;
     foreach $topdir (@_) {
        (($topdev,$topino,$topmode,$topnlink) = stat($topdir))
          || (warn("Can't stat $topdir: $!\n"), next);
        if (-d _) {
            if (chdir($topdir)) {
                ($fixtopdir = $topdir) =~ s,/$,, ;
+               $fixtopdir =~ s/\.dir$// if $Is_VMS;
                &finddepthdir($wanted,$fixtopdir,$topnlink);
                ($dir,$_) = ($fixtopdir,'.');
                $name = $fixtopdir;
@@ -162,7 +226,7 @@ sub finddepth {
            }
        }
        else {
-           unless (($dir,$_) = $topdir =~ m#^(.*/)(.*)$#) {
+           unless (($dir,$_) = fileparse($topdir)) {
                ($dir,$_) = ('.', $topdir);
            }
            chdir $dir && &$wanted;
@@ -174,7 +238,7 @@ sub finddepth {
 sub finddepthdir {
     my($wanted,$dir,$nlink) = @_;
     my($dev,$ino,$mode,$subcount);
-    my($name);
+    local($name); # so &wanted sees current value
 
     # Get the list of files in the current directory.
 
@@ -182,7 +246,7 @@ sub finddepthdir {
     my(@filenames) = readdir(DIR);
     closedir(DIR);
 
-    if ($nlink == 2) {        # This dir has no subdirectories.
+    if ($nlink == 2 && !$dont_use_nlink) {   # This dir has no subdirectories.
        for (@filenames) {
            next if $_ eq '.';
            next if $_ eq '..';
@@ -198,17 +262,18 @@ sub finddepthdir {
            next if $_ eq '..';
            $nlink = $prune = 0;
            $name = "$dir/$_";
-           if ($subcount > 0) {    # Seen all the subdirs?
+           if ($subcount > 0 || $dont_use_nlink) {    # Seen all the subdirs?
 
                # Get link count and check for directoriness.
 
-               ($dev,$ino,$mode,$nlink) = lstat($_) unless $nlink;
+               ($dev,$ino,$mode,$nlink) = ($Is_VMS ? stat($_) : lstat($_));
                
                if (-d _) {
 
                    # It really is a directory, so do it recursively.
 
                    if (!$prune && chdir $_) {
+                       $name =~ s/\.dir$// if $Is_VMS;
                        &finddepthdir($wanted,$name,$nlink);
                        chdir '..';
                    }
@@ -220,5 +285,10 @@ sub finddepthdir {
     }
 }
 
+if ($Config{'osname'} eq 'VMS') {
+  $Is_VMS = 1;
+  $dont_use_nlink = 1;
+}
+
 1;