This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
untodo the no-longer-failing todo test for rgs' patch
[perl5.git] / lib / finddepth.pl
1 # This library is deprecated and unmaintained. It is included for
2 # compatibility with Perl 4 scripts which may use it, but it will be
3 # removed in a future version of Perl. Please use the File::Find module
4 # instead.
5
6 warn( "Please use the File::Find module instead of the deprecated"
7      ." 'finddepth.pl' library, which will be removed in the next"
8      ." major release of perl" );
9
10 # Usage:
11 #       require "finddepth.pl";
12 #
13 #       &finddepth('/foo','/bar');
14 #
15 #       sub wanted { ... }
16 #               where wanted does whatever you want.  $dir contains the
17 #               current directory name, and $_ the current filename within
18 #               that directory.  $name contains "$dir/$_".  You are cd'ed
19 #               to $dir when the function is called.  The function may
20 #               set $prune to prune the tree.
21 #
22 # For example,
23 #
24 #   find / -name .nfs\* -mtime +7 -exec rm -f {} \; -o -fstype nfs -prune
25 #
26 # corresponds to this
27 #
28 #       sub wanted {
29 #           /^\.nfs.*$/ &&
30 #           (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_)) &&
31 #           int(-M _) > 7 &&
32 #           unlink($_)
33 #           ||
34 #           ($nlink || (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_))) &&
35 #           $dev < 0 &&
36 #           ($prune = 1);
37 #       }
38
39
40 use File::Find ();
41
42 *name           = *File::Find::name;
43 *prune          = *File::Find::prune;
44 *dir            = *File::Find::dir;
45 *topdir         = *File::Find::topdir;
46 *topdev         = *File::Find::topdev;
47 *topino         = *File::Find::topino;
48 *topmode        = *File::Find::topmode;
49 *topnlink       = *File::Find::topnlink;
50
51 sub finddepth {
52     &File::Find::finddepth(\&wanted, @_);
53 }
54
55 1;