dbh_open - Man Page
open or create a new DBHashTable
Synopsis
#include <dbh.h>
DBHashTable *dbh_open(constchar*path);
DBHashTable *dbh_openR(constchar*path);
DBHashTable *dbh_create (const char *path, unsigned char key_length);
Description
dbh_open () opens an existing DBHashTable at path in read/write mode while dbh_openR () will open in read-only mode. To create, initialize and open a new DBHashTable in read/write mode, dbh_create () is used. key_length is the fixed length of the record access key and must be less than 256. This only need be specified when the DBHashTable is created and initialized.
Return Value
On success, a pointer to a newly initialized and open DBHashTable or NULL if it fails (and errno is set appropriately).
Notes
This function will overwrite any file with the specified path including any previous DBH file. Cuantified keys assure that large DBHashes are spread out optimally.
See Also
dbh (0), dbh_open (3), dbh_openR (3), dbh_close (3), dbh_destroy (3), dbh_genkey (3)
Author
Edscott Wilson Garcia <edscott@xfce.org>
Referenced By
The man pages dbh_create(3) and dbh_open_ro(3) are aliases of dbh_open(3).