Colin Faber

NAME

Filesys::Virtual::Chroot - Virtual File system Tool

DESCRIPTION

Provide a virtual chroot environment. This module only simulates a chroot environment and only provides a advisory functions for your application. This module is NOT intended to provide application security!!!

SYNOPSIS

 #!/usr/bin/perl
 use strict;
 use Filesys::Virtual::Chroot;

 my $cr = Filesys::Virtual::Chroot->new(
        c => '/tmp',
        i => 0
 ) || die $Filesys::Virtual::Chroot::errstr;

 print " Root: " . $cr->rroot . "\n";
 print " Fake: " . $cr->vpwd . "\n";

 if($cr->vchdir($ARGV[0])){
        print " Change directory success\r\n";
        print " Root: " . $cr->rroot . "\n";
        print " Real: " . $cr->rcwd . "\n";
        print " Fake: " . $cr->vcwd . "\n";
 } else {
        print $cr->errstr . "\n";
 }

 exit;

METHODS

new( %Options )

Create a new Filesys::Virtual::Chroot object.

Options

chroot - The full path of the directory which will be virtual chroot'd

c - Same as chroot

no_force_case - Don't force case matching, Turn this on, on windows machines.

i - Same as no_force_case

Error handling

If something happens which results in an error, nothing will be returned and the Filesys::Virtual::Chroot::errstr will be set with the error message.

errstr()

Return the last error message captured.

rroot()

Return the real full root path of the virtual chroot'd environment.

lchdir()

Return the last real directory that was changed to with $cr->vchdir()

vchdir(path)

Change the virtual directory and return the virtual directory that was changed to.

rpath(file)

Return the real full path of <file> if <file> is within the virtual chroot environment

vcwd()

Return the virtual current working directory

vpwd(path)

aliase for the vcwd() command.

rcwd()

Return the real current working directory

rpwd()

aliase for the rcwd() command.