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)