<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/smalldb.c">
<Name>LQTp_CreateEmptyKeyValueDatabase</Name>
<Class>Database/Dynamic Hashing, Database/Files
<Purpose>
<P>Some versions of dbm or ndbm provided with various Unix systems
do not automatically create a new DBM file, even when asked to; it
is necessary to create the file with the open(2) or creat(2) system
calls.  The original Unix dbm library was like this.</P>
<P>This function creates the necessary files, in the given
Directory; the files will have names beginning with the given
Prefix, and depending on the version of ndbm in use, may have a
suffix such as .db; BSD db uses a single file, but most other
implementations use two, one called Prefix.dir and one called
Prefix.pag.</P>
<P>This routine is called automatically by LQT_OpenKeyValueDatabase
when necessary, but is made available for general use
for convenience.</P>
<Bugs>
LQTp_CreateEmptyKeyValueDatabase should be in liblqutil instead.
<SeeAlso>
LQT_OpenKeyValueDatabase
</Function>
<Decl>
LIBRARY char *
LQTp_CreateEmptyKeyValueDatabase(db, Directory, prefix)
    t_LQTEXT_Database *db;
    char *Directory;
    char *prefix;
</Decl>
</Entry>
