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)

                                                                                                          cdb(3)