head 1.2; access; symbols RPM_4_2_1:1.1.1.4 RPM_4_2:1.1.1.4 RPM_4_1_1:1.1.1.4 RPM_4_1:1.1.1.3 RPM_4_0_5:1.1.1.2 RPM_4_0_4:1.1.1.1 RPM:1.1.1; locks; strict; comment @# @; 1.2 date 2008.01.02.09.53.29; author rse; state dead; branches; next 1.1; commitid z4cpSiAhOCXk5PLs; 1.1 date 2002.01.08.00.30.10; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2002.01.08.00.30.10; author rse; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2003.01.18.13.48.59; author rse; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2002.01.17.20.11.42; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2003.01.18.14.04.58; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: DbMpoolFile::set_clear_len

DbMpoolFile::set_clear_len

 APIRef 

#include <db_cxx.h>


int
DbMpoolFile::set(u_int32_t len);

Description

The DbMpoolFile::set_clear_len method sets the number of initial bytes in a page that should be set to nul when the page is created as a result of the DB_MPOOL_CREATE or DB_MPOOL_NEW flags being specified to DbMpoolFile::get. If no value is specified, or len is 0, the entire page is cleared.

The DbMpoolFile::set_clear_len 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

The DbMpoolFile::set_clear_len method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the DbMpoolFile::set_clear_len method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

DbEnv, DbMpoolFile

See Also

DbEnv::set_cachesize, DbEnv::set_mp_mmapsize, DbEnv::memp_fcreate, DbMpoolFile::close, DbMpoolFile::get, DbMpoolFile::open, DbMpoolFile::put, DbMpoolFile::set, DbMpoolFile::sync, DbEnv::memp_register, DbMpoolFile::set_clear_len, DbMpoolFile::set_fileid, DbMpoolFile::set_ftype, DbMpoolFile::set_lsn_offset, DbMpoolFile::set_pgcookie, DbEnv::memp_stat, DbEnv::memp_sync, and DbEnv::memp_trickle.

APIRef

Copyright Sleepycat Software @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @Import: RPM 4.0.4 @ text @@ 1.1.1.2 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 a32 8

The DbMpoolFile::set_clear_len method configures a file in the memory pool, not only operations performed using the specified DbMpoolFile handle.

The DbMpoolFile::set_clear_len interface may not be called after the DbMpoolFile::open interface is called. If the file is already open in the memory pool when DbMpoolFile::open is called, the information specified to DbMpoolFile::set_clear_len must be consistent with the existing file or an error will be returned. d37 4 a40 4 If a catastrophic error has occurred, the DbMpoolFile::set_clear_len method may fail and either return DB_RUNRECOVERY or throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d42 1 a42 1 DbEnv, DbMpoolFile d44 19 a62 1 Memory Pools and Related Methods @ 1.1.1.3 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d34 8 d46 4 a49 4 If a catastrophic error has occurred, the DbMpoolFile::set_clear_len method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. d51 1 a51 1 DbEnv, DbMpoolFile d53 1 a53 19 DbEnv::set_cachesize, DbEnv::set_mp_mmapsize, DbEnv::memp_fcreate, DbMpoolFile::close, DbMpoolFile::get, DbMpoolFile::open, DbMpoolFile::put, DbMpoolFile::set, DbMpoolFile::sync, DbEnv::memp_register, DbMpoolFile::set_clear_len, DbMpoolFile::set_fileid, DbMpoolFile::set_ftype, DbMpoolFile::set_lsn_offset, DbMpoolFile::set_pgcookie, DbEnv::memp_stat, DbEnv::memp_sync, and DbEnv::memp_trickle. @ 1.1.1.4 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 a32 8

The DbMpoolFile::set_clear_len method configures a file in the memory pool, not only operations performed using the specified DbMpoolFile handle.

The DbMpoolFile::set_clear_len interface may not be called after the DbMpoolFile::open interface is called. If the file is already open in the memory pool when DbMpoolFile::open is called, the information specified to DbMpoolFile::set_clear_len must be consistent with the existing file or an error will be returned. d37 4 a40 4 If a catastrophic error has occurred, the DbMpoolFile::set_clear_len method may fail and either return DB_RUNRECOVERY or throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d42 1 a42 1 DbEnv, DbMpoolFile d44 19 a62 1 Memory Pools and Related Methods @