NAME

Net::LibNFS::Async - Non-blocking I/O for Net::LibNFS

SYNOPSIS

After creating $nfs_async from a Net::LibNFS instance …

    $nfs->mount("the.nfs.server", "/export-dir")->then(
        sub {
            return $nfs->stat("/");
        },
    )->then(
        sub ($stat) {
            printf "mode(/) = 0%03o\n", $stat->mode() & 0777;
            return $nfs->open('/some-file', Fcntl::O_RDONLY);
        },
    )->then(
        sub ($fh) {
            return $fh->read(120)->then(
                sub ($buf) {
                    print $buf;
                    return $fh->close();
                },
            );
        },
    )->then(
        sub {
            return $nfs->umount();
        }
    )

DESCRIPTION

This module exposes non-blocking counterparts to Net::LibNFS’s blocking I/O calls.

Its methods return promises. (Mozilla publishes a nice introduction to promises that may be of help if you’re unfamiliar with that pattern.)

NFS METHODS

The below all accept the same arguments as their equivalents in Net::LibNFS.

promise() = OBJ->mount( $SERVERNAME, $EXPORTNAME )

Promise resolves empty.

promise() = OBJ->umount()

Promise resolves empty.

promise($stat) = OBJ->stat( $PATH )

Promise resolves to a Net::LibNFS::Stat instance.

promise($stat) = OBJ->lstat( $PATH )

Promise resolves to a Net::LibNFS::Stat instance.

promise($fh) = OBJ->open( $PATH, $FLAGS [, $MODE] )

Promise resolves to a Net::LibNFS::Async::Filehandle instance.

promise() = OBJ->mkdir( $PATH [, $MODE] )

Promise resolves empty.

promise() = OBJ->rmdir( $PATH )

Promise resolves empty.

promise() = OBJ->chdir( $PATH )

Promise resolves empty.

promise() = OBJ->unlink( $PATH )

Promise resolves empty.

promise($dh) = OBJ->opendir( $PATH )

Promise resolves to a Net::LibNFS::Dirhandle instance.

promise($statvfs) = OBJ->statvfs( $PATH )

Promise resolves to a Net::LibNFS::StatVFS instance.

promise() = OBJ->mknod( $PATH, $MODE, $DEV )

Promise resolves empty.

promise() = OBJ->chmod( $PATH, $MODE )

Promise resolves empty.

promise() = OBJ->lchmod( $PATH, $MODE )

Promise resolves empty.

promise() = OBJ->chown( $PATH, $UID, $GID )

Promise resolves empty.

promise() = OBJ->lchown( $PATH, $UID, $GID )

Promise resolves empty.

promise() = OBJ->utime( $PATH, $ATIME, $MTIME )

Promise resolves empty.

promise() = OBJ->lutime( $PATH, $ATIME, $MTIME )

Promise resolves empty.

promise() = OBJ->truncate( $PATH, $LENGTH )

Promise resolves empty.

OTHER METHODS

promise(\@exports) = OBJ->mount_getexports( $SERVERNAME )

Promise resolves to an arrayref of hashrefs such as Net::LibNFS’s corresponding static function returns.

$obj = OBJ->pause()

Pauses all reads. (Writes still continue.)

Returns OBJ.

$obj = OBJ->resume()

The inverse of pause().