Name DSLI Description Info ---------------- ---- -------------------------------------------- ----- Tie::DB_FileLock Rdpr Locking access to Berkeley DB 1.x. JMV # Tie::FileLock.pm 1/10/2000 # John M Vinopal jmv@cpan.org # # Copyright (C) 1998-2000, John M Vinopal, All Rights Reserved. # This program is free software. Permission is granted to copy # and modify this program so long as this copyright notice is # preserved. This software is distributed without warranty. # You can redistribute it and/or modify it under the same terms # as Perl itself. # DESCRIPTION ----------- Module DB_File allows perl to tie hashes to on-disk dbm files, but fails to provide any method by which the hashes might be locked, providing exclusive access or preventing page-level collisions. Tie::DB_FileLock extends DB_File, providing a locking layer using flock(). Unlike Tie::DB_Lock, Tie::DB_FileLock does not duplicate files to allow concurrent access for readers and writers. Tie::DB_FileLock is therefore suitable for large dbms with relatively short locking periods. DB_File::Lock is another option, a lightweight wrapper around DB_File using an external lockfile. See the POD documentation for more information. PREREQUISITES ------------- * Perl 5.004 or greater. * Module DB_File (1.65 through 1.820 should work). BUILDING THE MODULE ------------------- Tie::DB_FileLock is all perl, no compilation. perl Makefile.PL make make test INSTALLATION ------------ make install FEEDBACK -------- How to report a problem with Tie::DB_FileLock. To help me help you, I need of the following information: 1. The version of Perl and the operating system name and version you are running. The command 'perl -V' should provide everything. 2. The version of Tie::DB_FileLock you have installed. If you've installed Tie::DB_FileLock, this one-liner will tell you: perl -e 'use Tie::DB_FileLock; print "V: $Tie::DB_FileLock::VERSION\n"' Otherwise search DB_FileLock.pm for a line like this: $VERSION = 'X.XX'; 3. The error message(s) generated or a concise description of the problem. 4. Finally if this is a bug, a fix or a small example of the bug. CHANGES ------- See the Changes file. John M Vinopal