NAME

Filesys::Virtual::Async - Base class for non blocking virtual filesystems

SYNOPSIS

use base 'Filesys::Virtual::Async';

sub new { my $class = shift; $class->SUPER::new(@_); }

# then override the various methods

DESCRIPTION

The goal of Filesys::Virtual::Async is to provide an interface like IO::AIO for a non blocking virtual filesystem

This is a base class, see the "SEE ALSO" section below

This module is still in flux to an extent. If you'd like to suggest changes, please drop in the irc channel #poe on irc.perl.org and speak with xantus[] or Apocalypse

WARNING

This is interface isn't solidified yet. It will change. I released this module early due to demand. You have been warned.

OBJECT METHODS

new( root => $path );

root is optional, and defaults to /. root is prepended to all paths after resolution

cwd()

Returns the current working directory (virtual)

root() or root( $path )

Gets or sets the root path. This path is prepended to the path returned from _path_from_root

_path_from_root( $path )

Resolves a path, with the root path prepended.

This is a private method, do not document it in your subclass.

_resolve_path( $path )

Resolves a path to a normalized direct path based on the cwd, allowing .. traversal, and the ~ home directory shortcut (if home_path is defined)

For example, if the cwd is /foo/bar/baz, and $path is /../../../../foo/../foo/./bar/../foo then /foo will be returned

This is a private method, do not document it in your subclass.

CALLBACK METHODS

All of these work exactly like the IO::AIO methods of the same name. Use IO::AIO as a reference for these functions, but note that this in no way requires you to use IO::AIO.

open()

close()

read()

write()

sendfile()

readahead()

stat()

lstat()

utime()

chown()

truncate()

chmod()

unlink()

mknod()

link()

symlink()

readlink()

rename()

mkdir()

rmdir()

readdir()

load()

copy()

move()

scandir()

rmtree()

fsync()

fdatasync()

SEE ALSO

Filesys::Virtual::Async::Plain

http://xant.us/

AUTHOR

David W Davis <xantus@cpan.org>

RATING

You can rate this this module at http://cpanratings.perl.org/rate/?distribution=Filesys::Virtual::Async

COPYRIGHT AND LICENSE

Copyright (c) 2009 by David W Davis, All rights reserved

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