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.