aboutsummaryrefslogtreecommitdiff
path: root/GDBM_File.pm
diff options
context:
space:
mode:
Diffstat (limited to 'GDBM_File.pm')
-rw-r--r--GDBM_File.pm80
1 files changed, 80 insertions, 0 deletions
diff --git a/GDBM_File.pm b/GDBM_File.pm
new file mode 100644
index 0000000..a33b8b5
--- /dev/null
+++ b/GDBM_File.pm
@@ -0,0 +1,80 @@
+# GDBM_File.pm -- Perl 5 interface to GNU gdbm library.
+
+=head1 NAME
+
+GDBM_File - Perl5 access to the gdbm library.
+
+=head1 SYNOPSIS
+
+ use GDBM_File ;
+ tie %hash, 'GDBM_File', $filename, &GDBM_WRCREAT, 0640;
+ # Use the %hash array.
+ untie %hash ;
+
+=head1 DESCRIPTION
+
+B<GDBM_File> is a module which allows Perl programs to make use of the
+facilities provided by the GNU gdbm library. If you intend to use this
+module you should really have a copy of the gdbm manualpage at hand.
+
+Most of the libgdbm.a functions are available through the GDBM_File
+interface.
+
+Unlike Perl's built-in hashes, it is not safe to C<delete> the current
+item from a GDBM_File tied hash while iterating over it with C<each>.
+This is a limitation of the gdbm library.
+
+=head1 AVAILABILITY
+
+gdbm is available from any GNU archive. The master site is
+C<ftp.gnu.org>, but you are strongly urged to use one of the many
+mirrors. You can obtain a list of mirror sites from
+L<http://www.gnu.org/order/ftp.html>.
+
+=head1 BUGS
+
+The available functions and the gdbm/perl interface need to be documented.
+
+The GDBM error number and error message interface needs to be added.
+
+=head1 SEE ALSO
+
+L<perl(1)>, L<DB_File(3)>, L<perldbmfilter>.
+
+=cut
+
+package GDBM_File;
+
+use strict;
+use warnings;
+our($VERSION, @ISA, @EXPORT);
+
+require Carp;
+require Tie::Hash;
+require Exporter;
+require XSLoader;
+@ISA = qw(Tie::Hash Exporter);
+@EXPORT = qw(
+ GDBM_CACHESIZE
+ GDBM_CENTFREE
+ GDBM_COALESCEBLKS
+ GDBM_FAST
+ GDBM_FASTMODE
+ GDBM_INSERT
+ GDBM_NEWDB
+ GDBM_NOLOCK
+ GDBM_OPENMASK
+ GDBM_READER
+ GDBM_REPLACE
+ GDBM_SYNC
+ GDBM_SYNCMODE
+ GDBM_WRCREAT
+ GDBM_WRITER
+);
+
+# This module isn't dual life, so no need for dev version numbers.
+$VERSION = '1.17';
+
+XSLoader::load();
+
+1;

Return to:

Send suggestions and report system problems to the System administrator.