Viewing file:  db_fd.html (4.97 KB) -rw-r--r--
Select action/file-type:
 (+) | (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
Berkeley DB: DB->fd
DB->fd
|
 
|
#include <db.h>
int
DB->fd(DB *db, int *fdp);
Description
The DB->fd function
copies a file descriptor representative of the underlying database into
the memory to which fdp refers. A file descriptor referring to
the same file will be returned to all processes that call
DB->open with the same file argument. This file
descriptor may be safely used as an argument to the fcntl(2)
and flock(2) locking functions. The file descriptor is not
necessarily associated with any of the underlying files actually used
by the access method.
The DB->fd function only supports a coarse-grained form of locking.
Applications should use the lock manager where possible.
The DB->fd function returns a non-zero error value on failure and 0 on success.
Errors
The DB->fd function may fail and return a non-zero error for errors specified for other Berkeley DB and C library or system functions.
If a catastrophic error has occurred, the DB->fd function may fail and return
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.
See Also
db_create,
DB->associate,
DB->close,
DB->cursor,
DB->del,
DB->err, DB->errx
DB->fd,
DB->get,
DB->pget,
DB->get_byteswapped,
DB->get_type,
DB->join,
DB->key_range,
DB->open,
DB->put,
DB->remove,
DB->rename,
DB->set_alloc,
DB->set_append_recno,
DB->set_bt_compare,
DB->set_bt_minkey,
DB->set_bt_prefix,
DB->set_cachesize,
DB->set_dup_compare,
DB->set_errcall,
DB->set_errfile,
DB->set_errpfx,
DB->set_feedback,
DB->set_flags,
DB->set_h_ffactor,
DB->set_h_hash,
DB->set_h_nelem,
DB->set_lorder,
DB->set_pagesize,
DB->set_paniccall,
DB->set_q_extentsize,
DB->set_re_delim,
DB->set_re_len,
DB->set_re_pad,
DB->set_re_source,
DB->stat,
DB->sync,
DB->truncate,
DB->upgrade,
and
DB->verify.
Copyright Sleepycat Software
|