DbEnv.set_region_init

APIRef

import com.sleepycat.db.*;

public void Db.set_region_init(boolean region_init) throws DbException;

Description

In some applications, the expense of page-faulting the shared memory regions can affect performance, e.g., when the page-fault occurs while holding a lock, other lock requests can convoy and overall throughput may decrease. Setting region_init to a true value specifies that shared regions be read or written, as appropriate, when the region is joined by the application.

This forces the underlying virtual memory and file systems to instantiate both the necessary memory and the necessary disk space. This can avoid out-of-disk space failures later on.

The DbEnv.set_region_init interface may only be used to configure Berkeley DB before the DbEnv.open interface is called.

The DbEnv.set_region_init method throws an exception that encapsulates a non-zero error value on failure.

Errors

EINVAL
An invalid flag value or parameter was specified.

Called after DbEnv.open was called.

Class

DbEnv

See Also

DbEnv.close, DbEnv.open, DbEnv.remove, DbEnv.set_cachesize, DbEnv.set_errcall, DbEnv.set_error_stream, DbEnv.set_errpfx, DbEnv.set_region_init and DbEnv.set_verbose.

APIRef

Copyright Sleepycat Software