Berkeley DB: memp_fset
ee,hash,hashing,transaction,transactions,locking,logging,access method,access me
thods,java,C,C++">
memp_fset
#include <db.h>
int
memp_fset(DB_MPOOLFILE *mpf, void *pgaddr, u_int32_t flags);
Description
The memp_fset function sets the flags associated with the page referenced
by pgaddr without unpinning it from the pool. The pgaddr
argument must be an address previously returned by memp_fget.
The flags argument is specified by logically OR'ing together one or more
of the following values:
- DB_MPOOL_CLEAN
- Clear any previously set modification information (i.e., don't bother
writing the page back to the source file).
- DB_MPOOL_DIRTY
- The page has been modified and must be written to the source file
before being evicted from the pool.
- DB_MPOOL_DISCARD
- The page is unlikely to be useful in the near future,
and should be discarded before other pages in the pool.
The DB_MPOOL_CLEAN and DB_MPOOL_DIRTY flags are
mutually exclusive.
The memp_fset
function returns the value of errno on failure, and 0 on success.
Errors
If a fatal error occurs in Berkeley DB, the memp_fset function may fail and return
DB_RUNRECOVERY, at which point all subsequent database calls will also
return DB_RUNRECOVERY.
The memp_fset
function may fail and return errno
for any of the errors specified for the following Berkeley DB and C library
functions:
abort(3),
fcntl(3),
fflush(3),
fprintf(3),
getpid(3),
vfprintf(3),
and
vsnprintf(3).
In addition, the memp_fset
function may fail and return errno
for the following conditions:
- EINVAL
- An invalid flag value or parameter was specified.
See Also
memp_close,
memp_fclose,
memp_fget,
memp_fopen,
memp_fput,
memp_fset,
memp_fsync,
memp_open,
memp_register,
memp_stat,
memp_stat,
memp_sync,
memp_trickle
and
memp_unlink.
|