NAME
Tie::Mounted - Tie a mounted node to an array
SYNOPSIS
use Tie::Mounted;
tie @files, 'Tie::Mounted', '/backup', '-v';
print $files[-1];
untie @files;
DESCRIPTION
This module ties files (and directories) of a mount point to an array by invoking the system commands mount and umount; mount is invoked when a former attempt to tie an array is being committed, umount when a tied array is to be untied. Suitability is therefore limited and suggests a rarely used node (such as /backup, for example).
The mandatory parameter consists of the node (or: mount point) to be mounted (/backup - as declared in /etc/fstab); options to mount may be subsequently passed (-v). Device names and mount options (-a,-A,-d) will be discarded for safety's sake.
Default paths to mount and umount may be overriden by setting accordingly either $Tie::Mounted::MOUNT_BIN or $Tie::Mounted::UMOUNT_BIN. If one of them does not exist at the predefined path, a which() will be performed to determine the actual path.
If $Tie::Mounted::NO_FILES is set to a true value, a bogus array with zero files will be tied.
BUGS & CAVEATS
Security
There are no security restrictions; it is recommended to adjust filesystem permissions to prevent malicious use.
Portability
Tie::Mounted is Linux/UNIX centered (due to the fstab file and the (u)mount binary requirement) and will most likely not work on other platforms.
Miscellanea
The tied array is read-only.
Files within the tied array are statically tied.
Lacking tests
Tests that test the base functionality are completely missing due to an environment that most likely cannot be adequately simulated.
SEE ALSO
"tie" in perlfunc, fstab(5), mount(8), umount(8)
AUTHOR
Steven Schubiger <schubiger@cpan.org>
LICENSE
This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.