NAME

ActiveState::Unix::DiskFree - Portable interface to the df command

SYNOPSIS

 use ActiveState::Unix::DiskFree qw(df);
 my $info = df(".");
 print "$info->{free} bytes available.\n";

DESCRIPTION

This module provide a single function called df() that run the system utility df and returns the information extracted.

$info = df(".")
($info_root, $info_var) = df("/", "/var")
@info = df()

The df() function returns disk status information for the directories given as argument. If no argument is given it will return an entry for each file system present. In scalar context only the first entry is returned.

An information entry is a reference to an hash with the following keys:

filesystem

The name of disk partition that this file system resides on.

root

The location that this disk partition is mounted.

size

Amount of disk space (in bytes) present in the file system.

used

Amount of allocated disk space (in bytes).

used_p

Percentage of disk space allocated. This field might be missing.

free

Amount of unallocated disk space (in bytes).

COPYRIGHT

Copyright (C) 2003 ActiveState Corp. All rights reserved.

SEE ALSO

ActiveState::Bytes

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 111:

You forgot a '=back' before '=head1'