|
DB_MPOOLFILE->sync
|
|
#include <db.h>
int
DB_MPOOLFILE->sync(DB_MPOOLFILE *mpf);
Description
The DB_MPOOLFILE->sync function writes all pages associated with the
DB_MPOOLFILE, which were marked as modified using
DB_MPOOLFILE->put or DB_MPOOLFILE->set, back to the source file. If
any of the modified pages are also pinned (that is, this or
another process currently refers to them), DB_MPOOLFILE->sync will
ignore them.
The DB_MPOOLFILE->sync function returns a non-zero error value on failure, 0 on success, and returns DB_INCOMPLETE if there were pages that were modified
but that DB_MPOOLFILE->sync was unable to write immediately.
Errors
The DB_MPOOLFILE->sync 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_MPOOLFILE->sync function may fail and return
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.
See Also
DB_ENV->set_cachesize,
DB_ENV->set_mp_mmapsize,
DB_ENV->memp_fcreate,
DB_MPOOLFILE->close,
DB_MPOOLFILE->get,
DB_MPOOLFILE->open,
DB_MPOOLFILE->put,
DB_MPOOLFILE->set,
DB_MPOOLFILE->sync,
DB_ENV->memp_register,
DB_MPOOLFILE->set_clear_len,
DB_MPOOLFILE->set_fileid,
DB_MPOOLFILE->set_ftype,
DB_MPOOLFILE->set_lsn_offset,
DB_MPOOLFILE->set_pgcookie,
DB_ENV->memp_stat,
DB_ENV->memp_sync,
and
DB_ENV->memp_trickle.
Copyright Sleepycat Software
|