DBM::Deep::File
This is an internal-use-only object for "" in DBM::Deep. It mediates the low-level interaction with the storage mechanism.
Currently, the only storage mechanism supported is the file system.
This class provides an abstraction to the storage mechanism so that the Engine (the only class that uses this class) doesn't have to worry about that.
This method opens the filehandle for the filename in file .
file
There is no return value.
If the filehandle is opened, this will close it.
This will return the size of the DB. If file_offset is set, this will take that into account.
This will set the inode value of the underlying file object.
This is only needed to handle some obscure Win32 bugs. It reqlly shouldn't be needed outside this object.
This takes an optional offset and some data to print.
$offset , if defined, will be used to seek into the file. If file_offset is set, it will be used as the zero location. If it is undefined, no seeking will occur. Then, @data will be printed to the current location.
$offset
@data
This takes an optional offset and a length.
$offset , if defined, will be used to seek into the file. If file_offset is set, it will be used as the zero location. If it is undefined, no seeking will occur. Then, $length bytes will be read from the current location.
$length
The data read will be returned.
When the ::File object goes out of scope, it will be closed.
This takes a size and adds that much space to the DBM.
This returns the offset for the new location.
This flushes the filehandle. This takes no parameters and returns nothing.
This takes no parameters. It returns a boolean saying if this filehandle is writable.
Taken from http://www.perlmonks.org/?node_id=691054/.
This will take the stats for the current filehandle and apply them to $target_filename . The stats copied are:
$target_filename
Onwer UID and GID
Permissions
This is where the actual locking of the storage medium is performed. Nested locking is supported.
NOTE: It is unclear what will happen if a read lock is taken, then a write lock is taken as a nested lock, then the write lock is released.
Currently, the only locking method supported is flock(1). This is a whole-file lock. In the future, more granular locking may be supported. The API for that is unclear right now.
The following methods manage the locking status. In all cases, they take a "" in DBM::Deep object and returns nothing.
lock_exclusive( $obj )
Take a lock usable for writing.
lock_shared( $obj )
Take a lock usable for reading.
unlock( $obj )
Releases the last lock taken. If this is the outermost lock, then the object is actually unlocked.
To install DBM::Deep, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DBM::Deep
CPAN shell
perl -MCPAN -e shell install DBM::Deep
For more information on module installation, please visit the detailed CPAN module installation guide.