DbEnv::set_pageyield

APIRef

#include <db_cxx.h>

static int DbEnv::set_pageyield(int pageyield);

Description

Yield the processor whenever requesting a page from the cache. Setting pageyield to a non-zero value causes Berkeley DB to yield the processor any time a thread requests a page from the cache.

The DbEnv::set_pageyield interface affects the entire application, not a single database or database environment.

While the DbEnv::set_pageyield interface may be used to configure Berkeley DB at any time during the life of the application, it should normally be called before making any calls to the db_env_create or db_create methods.

This functionality should never be used for any other purpose than stress testing.

The DbEnv::set_pageyield interface may be used to configure Berkeley DB at any time during the life of the application.

The DbEnv::set_pageyield 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.

Errors

EINVAL
An invalid flag value or parameter was specified.

Class

DbEnv

See Also

DbEnv::close, DbEnv::open, DbEnv::remove, DbEnv::err, DbEnv::strerror, DbEnv::version, DbEnv::set_cachesize, DbEnv::set_errcall, DbEnv::set_errfile, DbEnv::set_error_stream, DbEnv::set_errpfx, DbEnv::set_flags, DbEnv::set_mutexlocks, DbEnv::set_paniccall, and DbEnv::set_verbose.

APIRef

Copyright Sleepycat Software