It returns the number of files successfully deleted.  Symlinks are
treated as ordinary files.

B<NOTE:> If the third parameter is not TRUE, C<rmtree> is B<unsecure>
in the face of failure or interruption.  Files and directories which
were not deleted may be left with permissions reset to allow world
read and write access.  Note also that the occurrence of errors in
rmtree can be determined I<only> by trapping diagnostic messages
using C<$SIG{__WARN__}>; it is not apparent from the return value.
Therefore, you must be extremely careful about using C<rmtree($foo,$bar,0>
in situations where security is an issue.


##</code><code>##

unless (unlink $root) {
  carp "Can't unlink file $root: $!";
  if ($force_writeable) {
    chmod $rp, $root
    or carp("and can't restore permissions to "
    . sprintf("0%o",$rp) . "\n");
  }
  last;
}


##</code><code>##

$SIG{'__WARN__'} = sub { die $_[0] };
rmtree("/tmp/tempdir",0,1);
$SIG{'__WARN__'} = 'DEFAULT';