# Berkeley DB: DbEnv::memp_trickle
Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++

DbEnv::memp_trickle |

`

    #include <db_cxx.h>

    int
    DbEnv::memp_trickle(int percent, int *nwrotep);

Description: DbEnv::memp_trickle

The DbEnv::memp_trickle method ensures that a specified percent of the pages in the shared memory pool are clean, by writing dirty pages to their backing files.

The purpose of the DbEnv::memp_trickle function is to enable a memory pool manager to ensure that a page is always available for reading in new information without having to wait for a write.

The DbEnv::memp_trickle method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

Parameters
nwrotep

- The nwrotep parameter references memory into which the number of pages written to reach the specified percentage is copied.

percent

- The percent parameter is the percent of the pages in the cache that should be clean.

Errors

The DbEnv::memp_trickle method may fail and throw DbException, encapsulating one of the following non-zero errors, or return one of the following non-zero errors:

EINVAL

- An invalid flag value or parameter was specified.

Class DbEnv, DbMpoolFile
See Also Memory Pools and Related Methods`

Copyright (c) 1996,2008 Oracle. All rights reserved.