NAME

Filesys::POSIX::Real - Portal to actual underlying filesystem

SYNOPSIS

use Filesys::POSIX;
use Filesys::POSIX::Real;

my $fs = Filesys::POSIX->new(Filesys::POSIX::Real->new,
    'special'   => 'real:/home/foo/test',
    'noatime'   => 1
);

DESCRIPTION

This module implements the filesystem device type which provides a portal to the actual system's underlying filesystem.

CREATING A NEW FILESYSTEM

Filesys::POSIX::Real->new

Create a new, uninitialized filesystem.

INITIALIAZATION

$fs->init(%data)

Initializes the new filesystem. A reference to the %data argument is saved in the filesystem object. The following attribute in the %data hash is required, however:

special

A URI-like specifier indicating the absolute path of a portion of the real filesystem, starting with the 'real:' prefix.

Exceptions will be thrown for the following:

Invalid special path

The format of the $data{'special'} argument does not match the aforementioned specification.

Not a directory

The path specified in $data{'special'} on the real filesystem does not correspond to an actual directory.