NAME

Sys::Statistics::Linux::FileStats - Collect linux file statistics.

SYNOPSIS

use Sys::Statistics::Linux::FileStats;

my $lxs   = new Sys::Statistics::Linux::FileStats;
my $stats = $lxs->get;

DESCRIPTION

This module collects statistics by the virtual /proc filesystem (procfs) and is developed on default vanilla kernels. It is tested on x86 hardware with the distributions SuSE (SuSE on s390 and s390x architecture as well), Red Hat, Debian, Asianux, Slackware and Mandrake on kernel versions 2.4 and 2.6 and should run on all linux kernels with a default vanilla kernel as well. It is possible that this module doesn't run on all distributions if the procfs is too much changed.

Further it is necessary to run it as a user with the authorization to read the /proc filesystem.

FILE STATISTICS

Generated by /proc/sys/fs/file-nr, /proc/sys/fs/inode-nr and /proc/sys/fs/dentry-state.

fhalloc    -  Number of allocated file handles.
fhfree     -  Number of free file handles.
fhmax      -  Number of maximum file handles.
inalloc    -  Number of allocated inodes.
infree     -  Number of free inodes.
inmax      -  Number of maximum inodes.
dentries   -  Dirty directory cache entries.
unused     -  Free diretory cache size.
agelimit   -  Time in seconds the dirty cache entries can be reclaimed.
wantpages  -  Pages that are requested by the system when memory is short.

METHODS

new()

Call new() to create a new object.

my $lxs = new Sys::Statistics::Linux::FileStats;

get()

Call get() to get the statistics. get() returns the statistics as a hash reference.

my $stats = $lxs->get;

EXPORTS

No exports.

SEE ALSO

proc(5)

REPORTING BUGS

Please report all bugs to <jschulz.cpan(at)bloonix.de>.

AUTHOR

Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

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