• NAME
• SYNOPSIS
• DESCRIPTION
• IMPORT PARAMETERS
• AUTHOR

NAME

Alzabo::ObjectCache::Sync::BerkeleyDB - Uses a DBM file to sync object caches

SYNOPSIS

  use Alzabo::ObjectCache( store => 'Alzabo::ObjectCache::Store::Memory',
                           sync  => 'Alzabo::ObjectCache::Sync::BerkeleyDB',
                           sync_dbm_file => 'somefilename.db',
                           clear_on_startup => 1 );

DESCRIPTION

This class implements object cache syncing between multiple processes using a Berkeley DB file to handle data storage. It implements locking to make sure that there are no race conditions with reading/writing data.

The difference between this module and the Alzabo::ObjectCache::Sync::DB_File module is that module uses the BerkeleyDB Perl module, which can take advantage of the new features available in versions 2 and 3 of the Berkeley DB library. These features allow this module to avoid having to constantly open and close the DBM file. In addition, locking is handled by the Berkeley DB library at a much lower level than would be possible from this module.

IMPORT PARAMETERS

• sync_dbm_file => $filename
  This parameter is required. It is the name of the file which will be used to store the syncing data. If the file does not exist, it will be created. If it does exist it will not be overwritten.

• clear_on_startup => $boolean
  If this is true, then a new file is always created on when the module is loaded, overwriting any existing file. This is generally desirable as an existing file may contain spurious entries from previous executions of the program. However, in the interests of safety, this parameter defaults to false.

AUTHOR

Dave Rolsky, <autarch@urth.org>