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)