int
memp_fput(DB_MPOOLFILE *mpf, void *pgaddr, u_int32_t flags);
Description
The memp_fput function indicates that the page referenced by
pgaddr can be evicted from the pool. The pgaddr
argument must be an address previously returned by memp_fget.
The flags value must be set to 0 or by bitwise inclusively OR'ing together one or more
of the following values.
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_fput function returns a non-zero error value on failure and 0 on success.
Errors
The memp_fput function may fail and return a non-zero error for the following conditions:
EACCES
The DB_MPOOL_DIRTY flag was set and the source file was not opened for
writing.
EINVAL
An invalid flag value or parameter was specified.
The pgaddr parameter does not reference a page returned by
memp_fget.
More than one of DB_MPOOL_CLEAN and DB_MPOOL_DIRTY flags was set.
The memp_fput 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 memp_fput function may fail and return
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.