Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DBM::Deep::Storage::FiUser)Contributed Perl DocumenDBM::Deep::Storage::File(3)

NAME
       DBM::Deep::Storage::File

PURPOSE
       This is an internal-use-only object for DBM::Deep. It mediates the low-
       level interaction with the storage mechanism.

       Currently, the only storage mechanism supported is the file system.

OVERVIEW
       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.

METHODS
   new( \%args )
   open()
       This method opens the filehandle for the filename in " file ".

       There is no return value.

   close()
       If the filehandle is opened, this will close it.

       There is no return value.

   size()
       This will return the size of the DB. If file_offset is set, this will
       take that into account.

       NOTE: This function isn't used internally anywhere.

   set_inode()
       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.

       There is no return value.

   print_at( $offset, @data )
       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.

       There is no return value.

   read_at( $offset, $length )
       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.

       The data read will be returned.

   DESTROY
       When the ::Storage::File object goes out of scope, it will be closed.

   request_space( $size )
       This takes a size and adds that much space to the DBM.

       This returns the offset for the new location.

   copy_stats( $target_filename )
       This will take the stats for the current filehandle and apply them to
       $target_filename . The stats copied are:

       ·   Onwer UID and GID

       ·   Permissions

perl v5.14.1			  2011-07-15	   DBM::Deep::Storage::File(3)

Vote for polarhome