NAME

Unix::Statgrab::sg_fs_stats - container for libstatgrab filesystem statistics

DESCRIPTION

"Unix::Statgrab::sg_fs_stats" is a Perl package name providing accessors to bundled libstatgrab sg_fs_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_fs_stats.3.html> filesystem statistics.

METHODS

nentries

Returns the number of entries in the container.

systime

Returns the seconds since Epoch (0:00:00 on January, 1st 1970) of the time measure the filesystem statistics.

fetchall_hash

Returns all records from sg_fs_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_fs_stats.3.html> container as list of hash containing each datum name as key and the datum as value.

fetchall_table

Returns all records from sg_fs_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_fs_stats.3.html> container as list of arrays containing the values in following order:

  (device_name fs_type mnt_point device_type size used free avail
   total_inodes used_inodes free_inodes avail_inodes
   io_size block_size
   total_blocks used_blocks free_blocks avail_blocks
   systime)

in that order including leading headline.

fetchrow_arrayref($row = 0)

Returns one row as array containing values as above.

fetchall_arrayref

Returns all records from sg_fs_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_fs_stats.3.html> container as array of arrays without header.

fetchrow_hashref($row = 0)

Returns one row as hash containing "{ device_name => $self.device_name($row), fs_type => ... }".

fetchall_hashref

Returns all records from sg_fs_stats <http://www.i-scream.org/libstatgrab/docs/sg_get_fs_stats.3.html> container as array of hashes.

Returns list of column names: "(device_name fs_type mnt_point device_type size used free avail total_inodes used_inodes free_inodes avail_inodes io_size block_size total_blocks used_blocks free_blocks avail_blocks systime)"

device_name

Name of the device the filesystem statistics belong to

device_canonical

Canonical name of the device the filesystem statistics belong to

fs_type

Filesystem type (as string), e.g. "zfs"

mnt_point

Path name of mount point for the file system

device_type

Bitwise combination of "sg_fs_regular sg_fs_special sg_fs_loopback sg_fs_remote", usually one of

size

Size of filesystem, in bytes

used

Used bytes of filesystem

free

Free bytes in filesystem

avail

Available bytes in filesystem (free - reserved)

total_inodes

Total number of inodes in filesystem

used_inodes

Used number of inodes in filesystem

free_inodes

Free number of inodes in filesystem

avail_inodes

Available inodes in filesystem (free - reserved)

io_size

Optimal size for I/O for this filesystem in bytes

block_size

Size of blocks in bytes

total_blocks

Total number of blocks in filesystem

used_blocks

Used number of blocks in filesystem

free_blocks

Free number of blocks in filesystem

avail_blocks

Available blocks in filesystem (free - reserved)

get_fs_stats_diff

Provides the difference between the last measurement and the recent one.

  $recent->get_fs_stats_diff($last);

CONSTANTS

    sg_fs_unknown sg_fs_regular sg_fs_special sg_fs_loopback sg_fs_remote
    sg_fs_local sg_fs_alltypes

AUTHOR

Jens Rehsack, <rehsack AT cpan.org>

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.