---
name: "Sys::Statistics::Linux::FileStats"
section: "3pm"
platform: "linux"
package: "libsys-statistics-linux-perl"
version: "0.66-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Sys::Statistics::Linux::FileStats"
---

# Sys::Statistics::Linux::FileStats(3pm)

Collect linux file statistics.

## NAME

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

## SYNOPSIS

```
    use Sys::Statistics::Linux::FileStats;
    my $lxs  = Sys::Statistics::Linux::FileStats->new;
    my $stat = $lxs->get;
```

## DESCRIPTION

Sys::Statistics::Linux::FileStats gathers file statistics from the virtual */proc* filesystem (procfs).

For more information read the documentation of the front-end module Sys::Statistics::Linux.

## 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 = Sys::Statistics::Linux::FileStats->new;
```

It's possible to set the path to the proc filesystem.

```
     Sys::Statistics::Linux::FileStats->new(
        files => {
            # This is the default
            path     => '/proc',
            file_nr  => 'sys/fs/file-nr',
            inode_nr => 'sys/fs/inode-nr',
            dentries => 'sys/fs/dentry-state',
        }
    );
```

### get()

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

```
    my $stat = $lxs->get;
```

## EXPORTS

No exports.

## SEE ALSO

**[proc(5)](/proc/5.md)**

## 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.