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 perlfunc, du(1), Filesys::DiskUsage, Sys::Statistics::Linux AUTHOR Steven Schubiger 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/