93 lines
2.0 KiB
Perl
93 lines
2.0 KiB
Perl
# 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 SECURITY AND PORTABILITY
|
|
|
|
B<Do not accept GDBM files from untrusted sources.>
|
|
|
|
GDBM files are not portable across platforms.
|
|
|
|
The GDBM documentation doesn't imply that files from untrusted sources
|
|
can be safely used with C<libgdbm>.
|
|
|
|
A maliciously crafted file might cause perl to crash or even expose a
|
|
security vulnerability.
|
|
|
|
=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.18';
|
|
|
|
XSLoader::load();
|
|
|
|
1;
|