Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

GDBM_File (3)

Name

GDBM_File - Perl5 access to the gdbm library.

Synopsis

use GDBM_File ;
tie %hash, 'GDBM_File', $filename, &GDBM_WRCREAT, 0640;
# Use the %hash array.
untie %hash ;

Description

Perl Programmers Reference Guide                                  GDBM_File(3)



NAME
       GDBM_File - Perl5 access to the gdbm library.

SYNOPSIS
           use GDBM_File ;
           tie %hash, 'GDBM_File', $filename, &GDBM_WRCREAT, 0640;
           # Use the %hash array.
           untie %hash ;

DESCRIPTION
       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 "delete" the current
       item from a GDBM_File tied hash while iterating over it with "each".
       This is a limitation of the gdbm library.

AVAILABILITY
       gdbm is available from any GNU archive.  The master site is
       "ftp.gnu.org", but you are strongly urged to use one of the many
       mirrors.  You can obtain a list of mirror sites from
       <http://www.gnu.org/order/ftp.html>.

SECURITY AND PORTABILITY
       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 "libgdbm".

       A maliciously crafted file might cause perl to crash or even expose a
       security vulnerability.

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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | runtime/perl-532      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

SEE ALSO
       perl(1), DB_File(3), perldbmfilter.



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.perl.org/.



perl v5.32.0                      2020-06-14                      GDBM_File(3)