DB_MPOOLFILE->set(DB_MPOOLFILE *mpf, void *pgaddr, u_int32_t flags);
The DB_MPOOLFILE->set method sets the flags associated with the page to which
pgaddr refers without unpinning it from the pool. The
pgaddr argument must be an address previously returned by
The flags value must be set to 0 or by bitwise inclusively OR'ing together one or
more of the following values:
- Clear any previously set modification information (that is, don't bother
writing the page back to the source file).
- The page has been modified and must be written to the source file before
being evicted from the pool.
- 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
The DB_MPOOLFILE->set method returns a non-zero error value on failure and 0 on success.
The DB_MPOOLFILE->set method may fail and return a non-zero error for the following conditions:
- An invalid flag value or parameter was specified.
The DB_MPOOLFILE->set method 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->set method may fail and
in which case all subsequent Berkeley DB calls will fail in the same way.
Memory Pools and Related Methods
Copyright Sleepycat Software