dbmopen(%ARRAYNAME, "dbmfilename", $mode);
%ARRAYNAME parameter is a Perl hash. (If this hash already has values, the values are discarded.) This hash becomes connected to the DBM database called
dbmfilename, usually stored on disk as a pair of files called dbmfilename.dir and dbmfilename.pag.
0644 gives read-only permission to everyone but the owner, who gets read-write permission. If the files already exist, this parameter has no effect. For example:
mydatabase", 0644); # open
This invocation associates the hash
%FRED with the disk files mydatabase.dir and mydatabase.pag in the current directory. If the files don't already exist, they are created with a mode of
0644 modified by the current umask.
The return value from the
dbmopen is true if the database could be opened or created, and false otherwise, just like an
open invocation. If you don't want the files created, use a
$mode value of
undef. For example:
dbmopen(%A,"/etc/xx",undef) || die "cannot open DBM /etc/xx";
In this case, if the files /etc/xx.dir and /etc/xx.pag cannot be opened, the
dbmopen call returns false, rather than attempting to create the files.
The DBM array stays open throughout the program. When the program terminates, the association is terminated. You can also break the association in a manner similar to closing a filehandle, by using the
dbmclose returns false if something goes wrong.