NAME

DBD::Sys::Plugin::Any::FileSysDf - provides a table containing the free space of file systems

SYNOPSIS

$filesysdf = $dbh->selectall_hashref("select * from filesysdf", "mountpoint");

ISA

DBD::Sys::Plugin::Any::FileSysDf
ISA DBD::Sys::Table

DESCRIPTION

This module provides the table <filesysdf> which contains the free space on file systems.

COLUMNS

mountpoint

The friendly name of the filesystem. This will usually be the same name as appears in the list returned by the filesystems() method.

blocks

Total blocks existing on the filesystem.

bfree

Total blocks free existing on the filesystem.

bavail

Total blocks available to the user executing the Perl application. This can be different than bfree if you have per-user quotas on the filesystem, or if the super user has a reserved amount. bavail can also be a negative value because of this. For instance if there is more space being used then you have available to you.

bused

Total blocks used existing on the filesystem.

bper

Percent of disk space used. This is based on the disk space available to the user executing the application. In other words, if the filesystem has 10% of its space reserved for the superuser, then the percent used can go up to 110%.

files

Total inodes existing on the filesystem.

ffree

Total inodes free existing on the filesystem.

favail

Total inodes available to the user executing the application. See the information for the bavail column.

fused

Total inodes used existing on the filesystem.

fper

Percent of inodes used on the filesystem. See the information for the bper column.

METHODS

getColNames

Returns the column names of the table as named in "Columns"

getAttributes

Return the attributes supported by this module:

blocksize

Allows to specify the blocksize of the returned free blocks. This defaults to 1.

$dbh->{sys_filesysdf_blocksize} = 512; # use UNIX typical blocksize for df

collectData

Retrieves the mountpoints of mounted file systems from Sys::Filesystem and determine the free space on their devices using Filesys::DfPortable. The mountpoint and the free space information are put in fetchable rows.

PREREQUISITES

Sys::Filesystem and Filesys::DfPortable are required in order to fill the table filesysdf with data.

AUTHOR

Jens Rehsack			Alexander Breibach
CPAN ID: REHSACK
rehsack@cpan.org			alexander.breibach@googlemail.com
http://www.rehsack.de/

COPYRIGHT

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

The full text of the license can be found in the LICENSE file included with this module.

SUPPORT

Free support can be requested via regular CPAN bug-tracking system. There is no guaranteed reaction time or solution time, but it's always tried to give accept or reject a reported ticket within a week. It depends on business load. That doesn't mean that ticket via rt aren't handles as soon as possible, that means that soon depends on how much I have to do.

Business and commercial support should be acquired from the authors via preferred freelancer agencies.