cdb

Section: C Library Functions (3)
Index Return to Main Contents
 

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)


 

Index

NAME
SYNTAX
DESCRIPTION
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 05:37:10 GMT, April 21, 2005