cdb(3)

NAME
cdb - read from a constant database

SYNTAX
#include <cdb.h> int cdb_seek(fd,key,len,dlen); int fd;
char *key;
unsigned int len;
uint32 *dlen;

DESCRIPTION
cdb_seek looks up key in a constant database. It returns 1 if key is present, 0 if key is not present, or -1 if there was a read error. key is an array of len characters. cdb_seek needs an open file descriptor, fd, pointing to the database. If cdb_seek returns 1, it points fd at the beginning of the data portion of the first record indexed by key, and it stores the data length in dlen. cdb_seek does not provide a way to read subsequent records with the same key. It's fine to do several cdb_seek lookups with the same open file descriptor. Beware, however, that two simultaneous cdb_seek lookups can fail horribly; separate processes should not share the same database descriptor. Furthermore, any updates after the database was opened will be invisible. It's rarely a good idea for a long-running program to hold a database open.

SEE ALSO
cdbget(1)