NAME

Tie::DiskUsage - Tie disk usage to a hash

SYNOPSIS

            

              
              
use Tie::DiskUsage;
# common use
tie %usage, 'Tie::DiskUsage', '/var', '-h';
print $usage{'/var/log'};
untie %usage;
# also implemented
exists $usage{'/var/log'};
keys   %usage;
values %usage;
each   %usage;
scalar %usage;
# fatal error
%usage = ();
delete $usage{'/var/log'};
$usage{'/var/log'} = 1024 ** 2;
            
          

DESCRIPTION

Tie::DiskUsage ties the disk usage, which is extracted from the output of du(1), to a hash. If the path to perform the du command on is undef, the current working directory will be examined; options to du may be passed at the end of the tie invocation with a string provided per option.

By default, the location of the du command is assumed to be at /usr/bin/du; if du cannot be found there, File::Which will attempt to gather its real location.

The default path to du may be overridden by setting the global $Tie::DiskUsage::DU_BIN (usually not needed due to File::Which's automatic search for du).

BUGS & CAVEATS

Processing output of du(1) requires that each output line is ended by a newline.

In order to successfully run du(1) on a given path, you might need to elevate permissions of the process using Tie::DiskUsage.

SEE ALSO

"tie" in perlfunc, du(1), Filesys::DiskUsage, Sys::Statistics::Linux

AUTHOR

Steven Schubiger <schubiger@cpan.org>

LICENSE

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/