diff options
| author | jbj <devnull@localhost> | 2002-08-14 17:31:52 +0000 |
|---|---|---|
| committer | jbj <devnull@localhost> | 2002-08-14 17:31:52 +0000 |
| commit | 8faf9d1ea6d5743be84b20e509d52bab283ece71 (patch) | |
| tree | c5a2fc227a050adedb6329d61b0fa785387092d2 /db/docs | |
| parent | 4aac97a69fb764add274089dbc7a1c5bd02c59c8 (diff) | |
| download | rpm-8faf9d1ea6d5743be84b20e509d52bab283ece71.tar.gz rpm-8faf9d1ea6d5743be84b20e509d52bab283ece71.tar.bz2 rpm-8faf9d1ea6d5743be84b20e509d52bab283ece71.zip | |
db-4.1.17 orphans.
CVS patchset: 5632
CVS date: 2002/08/14 17:31:52
Diffstat (limited to 'db/docs')
88 files changed, 1146 insertions, 784 deletions
diff --git a/db/docs/api_c/env_set_timeout.html b/db/docs/api_c/env_set_timeout.html index e55e1450f..dfe94bda6 100644 --- a/db/docs/api_c/env_set_timeout.html +++ b/db/docs/api_c/env_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: env_set_timeout.so,v 10.3 2001/10/22 15:24:31 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: env_set_timeout.so,v 10.6 2002/06/24 14:49:21 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->set_timeout</title> @@ -59,40 +60,57 @@ detection is performed. <p>Timeout values specified for the database environment may be overridden on a per-lock or per-transaction basis. See <a href="../api_c/lock_vec.html">DB_ENV->lock_vec</a> and <a href="../api_c/txn_set_timeout.html">DB_TXN->set_timeout</a> for more information. -<p>The DB_ENV->set_timeout interface may be used only to configure Berkeley DB before -the <a href="../api_c/env_open.html">DB_ENV->open</a> interface is called. +<p>The DB_ENV->set_timeout function configures a database environment, not only operations +performed using the specified <a href="../api_c/env_create.html">DB_ENV</a> handle. +<p>The DB_ENV->set_timeout interface may be called at any time during the life of +the application. <p>The DB_ENV->set_timeout function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_ENV->set_timeout function may fail and return a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. -<p>Called after <a href="../api_c/env_open.html">DB_ENV->open</a> was called. </dl> <p>The DB_ENV->set_timeout 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 DB_ENV->set_timeout function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->set_timeout function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_create.html">db_env_create</a>, <a href="../api_c/env_close.html">DB_ENV->close</a>, -<a href="../api_c/env_err.html">DB_ENV->err</a>, <a href="../api_c/env_err.html">DB_ENV->errx</a> +<a href="../api_c/env_dbremove.html">DB_ENV->dbremove</a>, +<a href="../api_c/env_dbrename.html">DB_ENV->dbrename</a>, +<a href="../api_c/env_err.html">DB_ENV->err</a>, +<a href="../api_c/env_err.html">DB_ENV->errx</a>, <a href="../api_c/env_open.html">DB_ENV->open</a>, <a href="../api_c/env_remove.html">DB_ENV->remove</a>, <a href="../api_c/env_set_alloc.html">DB_ENV->set_alloc</a>, +<a href="../api_c/env_set_app_dispatch.html">DB_ENV->set_app_dispatch</a>, <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_data_dir.html">DB_ENV->set_data_dir</a>, +<a href="../api_c/env_set_encrypt.html">DB_ENV->set_encrypt</a>, <a href="../api_c/env_set_errcall.html">DB_ENV->set_errcall</a>, <a href="../api_c/env_set_errfile.html">DB_ENV->set_errfile</a>, <a href="../api_c/env_set_errpfx.html">DB_ENV->set_errpfx</a>, <a href="../api_c/env_set_feedback.html">DB_ENV->set_feedback</a>, <a href="../api_c/env_set_flags.html">DB_ENV->set_flags</a>, +<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>, +<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>, +<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>, +<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>, +<a href="../api_c/env_set_lk_conflicts.html">DB_ENV->set_lk_conflicts</a>, +<a href="../api_c/env_set_lk_detect.html">DB_ENV->set_lk_detect</a>, +<a href="../api_c/env_set_lk_max_lockers.html">DB_ENV->set_lk_max_lockers</a>, +<a href="../api_c/env_set_lk_max_locks.html">DB_ENV->set_lk_max_locks</a>, +<a href="../api_c/env_set_lk_max_objects.html">DB_ENV->set_lk_max_objects</a>, +<a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, <a href="../api_c/env_set_paniccall.html">DB_ENV->set_paniccall</a>, -<a href="../api_c/env_set_rec_init.html">DB_ENV->set_recovery_init</a>, <a href="../api_c/env_set_rpc_server.html">DB_ENV->set_rpc_server</a>, <a href="../api_c/env_set_shm_key.html">DB_ENV->set_shm_key</a>, <a href="../api_c/env_set_tas_spins.html">DB_ENV->set_tas_spins</a>, -<a href="../api_c/env_set_tmp_dir.html">DB_ENV->set_tmp_dir</a>, <a href="../api_c/env_set_timeout.html">DB_ENV->set_timeout</a>, +<a href="../api_c/env_set_tmp_dir.html">DB_ENV->set_tmp_dir</a>, +<a href="../api_c/env_set_tx_max.html">DB_ENV->set_tx_max</a>, +<a href="../api_c/env_set_tx_timestamp.html">DB_ENV->set_tx_timestamp</a>, <a href="../api_c/env_set_verbose.html">DB_ENV->set_verbose</a>, <a href="../api_c/env_strerror.html">db_strerror</a> and diff --git a/db/docs/api_c/lock_id_free.html b/db/docs/api_c/lock_id_free.html index 0f32651a5..73e8a31d2 100644 --- a/db/docs/api_c/lock_id_free.html +++ b/db/docs/api_c/lock_id_free.html @@ -1,6 +1,7 @@ -<!--Id: lock_id_free.so,v 10.2 2001/10/22 15:24:32 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: lock_id_free.so,v 10.4 2002/06/24 14:49:23 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->lock_id_free</title> @@ -34,9 +35,9 @@ DB_ENV->lock_id function. <p>The locker ID is invalid or locks are still held by this locker ID. </dl> <p>The DB_ENV->lock_id_free 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 DB_ENV->lock_id_free function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->lock_id_free function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_lk_conflicts.html">DB_ENV->set_lk_conflicts</a>, <a href="../api_c/env_set_lk_detect.html">DB_ENV->set_lk_detect</a>, @@ -48,7 +49,7 @@ in the same way. <a href="../api_c/lock_id.html">DB_ENV->lock_id</a>, <a href="../api_c/lock_id_free.html">DB_ENV->lock_id_free</a>, <a href="../api_c/lock_put.html">DB_ENV->lock_put</a>, -<a href="../api_c/lock_stat.html">DB_ENV->lock_stat</a>, +<a href="../api_c/lock_stat.html">DB_ENV->lock_stat</a> and <a href="../api_c/lock_vec.html">DB_ENV->lock_vec</a>. </tt> diff --git a/db/docs/api_c/log_cursor.html b/db/docs/api_c/log_cursor.html index 0bf50ab34..33e0f5173 100644 --- a/db/docs/api_c/log_cursor.html +++ b/db/docs/api_c/log_cursor.html @@ -1,6 +1,7 @@ -<!--Id: log_cursor.so,v 10.2 2001/10/22 15:24:33 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: log_cursor.so,v 10.3 2002/06/24 14:49:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->log_cursor</title> @@ -36,34 +37,37 @@ creates a log cursor and copies a pointer to it into the memory to which <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DB_ENV->log_cursor 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 DB_ENV->log_cursor function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->log_cursor function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/db_create.html">db_create</a>, +<a href="../api_c/db_set_alloc.html">DB->set_alloc</a>, <a href="../api_c/db_associate.html">DB->associate</a>, <a href="../api_c/db_close.html">DB->close</a>, <a href="../api_c/db_cursor.html">DB->cursor</a>, <a href="../api_c/db_del.html">DB->del</a>, -<a href="../api_c/db_err.html">DB->err</a>, <a href="../api_c/db_err.html">DB->errx</a> +<a href="../api_c/db_err.html">DB->err</a>, +<a href="../api_c/db_err.html">DB->errx</a>, <a href="../api_c/db_fd.html">DB->fd</a>, <a href="../api_c/db_get.html">DB->get</a>, -<a href="../api_c/db_get.html">DB->pget</a>, <a href="../api_c/db_get_byteswapped.html">DB->get_byteswapped</a>, <a href="../api_c/db_get_type.html">DB->get_type</a>, <a href="../api_c/db_join.html">DB->join</a>, <a href="../api_c/db_key_range.html">DB->key_range</a>, <a href="../api_c/db_open.html">DB->open</a>, +<a href="../api_c/db_get.html">DB->pget</a>, <a href="../api_c/db_put.html">DB->put</a>, <a href="../api_c/db_remove.html">DB->remove</a>, <a href="../api_c/db_rename.html">DB->rename</a>, -<a href="../api_c/db_set_alloc.html">DB->set_alloc</a>, <a href="../api_c/db_set_append_recno.html">DB->set_append_recno</a>, <a href="../api_c/db_set_bt_compare.html">DB->set_bt_compare</a>, <a href="../api_c/db_set_bt_minkey.html">DB->set_bt_minkey</a>, <a href="../api_c/db_set_bt_prefix.html">DB->set_bt_prefix</a>, +<a href="../api_c/db_set_cache_priority.html">DB->set_cache_priority</a>, <a href="../api_c/db_set_cachesize.html">DB->set_cachesize</a>, <a href="../api_c/db_set_dup_compare.html">DB->set_dup_compare</a>, +<a href="../api_c/db_set_encrypt.html">DB->set_encrypt</a>, <a href="../api_c/db_set_errcall.html">DB->set_errcall</a>, <a href="../api_c/db_set_errfile.html">DB->set_errfile</a>, <a href="../api_c/db_set_errpfx.html">DB->set_errpfx</a>, @@ -83,7 +87,7 @@ in the same way. <a href="../api_c/db_stat.html">DB->stat</a>, <a href="../api_c/db_sync.html">DB->sync</a>, <a href="../api_c/db_truncate.html">DB->truncate</a>, -<a href="../api_c/db_upgrade.html">DB->upgrade</a>, +<a href="../api_c/db_upgrade.html">DB->upgrade</a> and <a href="../api_c/db_verify.html">DB->verify</a>. </tt> diff --git a/db/docs/api_c/logc_close.html b/db/docs/api_c/logc_close.html index 6747f34ef..59cf31bd5 100644 --- a/db/docs/api_c/logc_close.html +++ b/db/docs/api_c/logc_close.html @@ -1,6 +1,7 @@ -<!--Id: logc_close.so,v 10.4 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_close.so,v 10.5 2002/06/24 14:49:25 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_LOGC->close</title> @@ -37,23 +38,23 @@ used again. <p>The cursor was previously closed. </dl> <p>The DB_LOGC->close 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 DB_LOGC->close function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_LOGC->close function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> -<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>, -<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>, -<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>, -<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>, <a href="../api_c/log_archive.html">DB_ENV->log_archive</a>, -<a href="../api_c/log_compare.html">log_compare</a>, -<a href="../api_c/log_cursor.html">DB_ENV->log_cursor</a>, <a href="../api_c/log_file.html">DB_ENV->log_file</a>, <a href="../api_c/log_flush.html">DB_ENV->log_flush</a>, <a href="../api_c/log_put.html">DB_ENV->log_put</a>, -<a href="../api_c/log_register.html">DB_ENV->log_register</a>, <a href="../api_c/log_stat.html">DB_ENV->log_stat</a>, -<a href="../api_c/log_unregister.html">DB_ENV->log_unregister</a>, +<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>, +<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>, +<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>, +<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>, +and +<a href="../api_c/log_compare.html">log_compare</a>. +<p> +<a href="../api_c/log_cursor.html">DB_ENV->log_cursor</a>, <a href="../api_c/logc_close.html">DB_LOGC->close</a> and <a href="../api_c/logc_get.html">DB_LOGC->get</a>. diff --git a/db/docs/api_c/logc_get.html b/db/docs/api_c/logc_get.html index 4284db1b6..074763029 100644 --- a/db/docs/api_c/logc_get.html +++ b/db/docs/api_c/logc_get.html @@ -1,6 +1,7 @@ -<!--Id: logc_get.so,v 10.31 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_get.so,v 10.36 2002/07/01 16:52:26 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_LOGC->get</title> @@ -35,41 +36,38 @@ record. See <a href="../api_c/dbt.html">DBT</a> for a description of other fiel for any <a href="../api_c/dbt.html">DBT</a> used for data retrieval. <p>The <b>flags</b> value must be set to one of the following values: <p><dl compact> -<p><dt><a name="DB_CHECKPOINT">DB_CHECKPOINT</a><dd>The last record written with the DB_CHECKPOINT flag specified to the -<a href="../api_c/log_put.html">DB_ENV->log_put</a> function is returned in the <b>data</b> argument. The -<b>lsn</b> argument is overwritten with the <a href="../api_c/db_lsn.html">DB_LSN</a> of the record -returned. If no record has been previously written with the DB_CHECKPOINT -flag specified, the first record in the log is returned. -<p>If the log is empty, the DB_LOGC->get function will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. <p><dt><a name="DB_FIRST">DB_FIRST</a><dd>The first record from any of the log files found in the log directory is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_c/db_lsn.html">DB_LSN</a> of the record returned. -<p>If the log is empty, the DB_LOGC->get function will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. +<p> +If the log is empty, the DB_LOGC->get function will return DB_NOTFOUND. <p><dt><a name="DB_LAST">DB_LAST</a><dd>The last record in the log is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_c/db_lsn.html">DB_LSN</a> of the record returned. -<p>If the log is empty, the DB_LOGC->get function will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. +<p> +If the log is empty, the DB_LOGC->get function will return DB_NOTFOUND. <p><dt><a name="DB_NEXT">DB_NEXT</a>, <a name="DB_PREV">DB_PREV</a><dd>The current log position is advanced to the next (previous) record in the log, and that record is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_c/db_lsn.html">DB_LSN</a> of the record returned. -<p>If the pointer has not been initialized via DB_FIRST, DB_LAST, DB_SET, +<p>If the cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, DB_NEXT, or DB_PREV, DB_LOGC->get will return the first (last) record -in the log. If the last (first) log record has already been returned -or the log is empty, the DB_LOGC->get function will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. -<p>If the log was opened with the DB_THREAD flag set, calls to -DB_LOGC->get with the DB_NEXT (DB_PREV) flag set will return -EINVAL. +in the log. +If the last (first) log record has already been returned or the log is +empty, the DB_LOGC->get function will return DB_NOTFOUND. +If the log was opened with the DB_THREAD flag set, calls to +DB_LOGC->get with the DB_NEXT (DB_PREV) flag set, the DB_LOGC->get function will return EINVAL. <p><dt><a name="DB_CURRENT">DB_CURRENT</a><dd>Return the log record to which the log currently refers. -<p>If the log pointer has not been initialized via DB_FIRST, DB_LAST, +If the log cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, DB_NEXT, or DB_PREV, or if the log was opened with the DB_THREAD -flag set, DB_LOGC->get will return EINVAL. -<p><dt><a name="DB_SET">DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. If the -specified <a href="../api_c/db_lsn.html">DB_LSN</a> is invalid (for example, it does not appear in -the log) DB_LOGC->get will return EINVAL. +flag set, the DB_LOGC->get function will return EINVAL. +<p><dt><a name="DB_SET">DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. +If the specified <a href="../api_c/db_lsn.html">DB_LSN</a> is invalid (for example, it does not +appear in the log), the DB_LOGC->get function will return EINVAL. </dl> -<p>Otherwise, the DB_LOGC->get function returns a non-zero error value on failure and 0 on success. +<p> +Otherwise, the DB_LOGC->get function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_LOGC->get function may fail and return a non-zero error for the following conditions: <p><dl compact> @@ -80,23 +78,23 @@ initialized. exist. </dl> <p>The DB_LOGC->get 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 DB_LOGC->get function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_LOGC->get function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> -<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>, -<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>, -<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>, -<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>, <a href="../api_c/log_archive.html">DB_ENV->log_archive</a>, -<a href="../api_c/log_compare.html">log_compare</a>, -<a href="../api_c/log_cursor.html">DB_ENV->log_cursor</a>, <a href="../api_c/log_file.html">DB_ENV->log_file</a>, <a href="../api_c/log_flush.html">DB_ENV->log_flush</a>, <a href="../api_c/log_put.html">DB_ENV->log_put</a>, -<a href="../api_c/log_register.html">DB_ENV->log_register</a>, <a href="../api_c/log_stat.html">DB_ENV->log_stat</a>, -<a href="../api_c/log_unregister.html">DB_ENV->log_unregister</a>, +<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>, +<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>, +<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>, +<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>, +and +<a href="../api_c/log_compare.html">log_compare</a>. +<p> +<a href="../api_c/log_cursor.html">DB_ENV->log_cursor</a>, <a href="../api_c/logc_close.html">DB_LOGC->close</a> and <a href="../api_c/logc_get.html">DB_LOGC->get</a>. diff --git a/db/docs/api_c/memp_fcreate.html b/db/docs/api_c/memp_fcreate.html index 169c64051..34ab2e92b 100644 --- a/db/docs/api_c/memp_fcreate.html +++ b/db/docs/api_c/memp_fcreate.html @@ -1,6 +1,7 @@ -<!--Id: memp_fcreate.so,v 10.4 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_fcreate.so,v 10.5 2002/06/24 14:49:26 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->memp_fcreate</title> @@ -33,29 +34,30 @@ Calling the <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a> funct <p>The DB_ENV->memp_fcreate function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_ENV->memp_fcreate 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 DB_ENV->memp_fcreate function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->memp_fcreate function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/memp_set_clear_len.html b/db/docs/api_c/memp_set_clear_len.html index 02a90a849..e5de7ab2d 100644 --- a/db/docs/api_c/memp_set_clear_len.html +++ b/db/docs/api_c/memp_set_clear_len.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_clear_len.so,v 10.2 2001/10/22 15:24:36 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_clear_len.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_clear_len</title> @@ -30,32 +31,41 @@ page that should be set to nul when the page is created as a result of the <a href="../api_c/memp_fget.html#DB_MPOOL_CREATE">DB_MPOOL_CREATE</a> or <a href="../api_c/memp_fget.html#DB_MPOOL_NEW">DB_MPOOL_NEW</a> flags being specified to <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>. If no value is specified, or <b>len</b> is 0, the entire page is cleared. +<p>The DB_MPOOLFILE->set_clear_len function configures a file in the memory pool, not only +operations performed using the specified <a href="../api_c/memp_fcreate.html">DB_MPOOLFILE</a> handle. +<p>The DB_MPOOLFILE->set_clear_len interface may not be called after the <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> is called, the information specified to DB_MPOOLFILE->set_clear_len +must be consistent with the existing file or an error will be +returned. <p>The DB_MPOOLFILE->set_clear_len function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_MPOOLFILE->set_clear_len 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 DB_MPOOLFILE->set_clear_len function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_MPOOLFILE->set_clear_len function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/memp_set_fileid.html b/db/docs/api_c/memp_set_fileid.html index 90a73171a..2bfb51996 100644 --- a/db/docs/api_c/memp_set_fileid.html +++ b/db/docs/api_c/memp_set_fileid.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_fileid.so,v 10.2 2001/10/22 15:24:36 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_fileid.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_fileid</title> @@ -51,32 +52,37 @@ using the Berkeley DB access methods instead of calling the pool functions explicitly, or if the files in the memory pool are stored on filesystems in which the default values as described previously are invariant between process and across system reboots. +<p>The DB_MPOOLFILE->set_fileid function configures a file in the memory pool, not only +operations performed using the specified <a href="../api_c/memp_fcreate.html">DB_MPOOLFILE</a> handle. +<p>The DB_MPOOLFILE->set_fileid interface may not be called after the <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> +interface is called. <p>The DB_MPOOLFILE->set_fileid function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_MPOOLFILE->set_fileid 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 DB_MPOOLFILE->set_fileid function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_MPOOLFILE->set_fileid function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/memp_set_ftype.html b/db/docs/api_c/memp_set_ftype.html index 512cb34ef..19b81b6be 100644 --- a/db/docs/api_c/memp_set_ftype.html +++ b/db/docs/api_c/memp_set_ftype.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_ftype.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_ftype.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_ftype</title> @@ -31,32 +32,40 @@ written to, the backing filesystem store. The <b>ftype</b> argument must be the same as a <b>ftype</b> argument previously specified to the <a href="../api_c/memp_register.html">DB_ENV->memp_register</a> function. (See the <a href="../api_c/memp_register.html">DB_ENV->memp_register</a> documentation for more information.) +<p>The DB_MPOOLFILE->set_ftype function configures a file in the memory pool, not only +operations performed using the specified <a href="../api_c/memp_fcreate.html">DB_MPOOLFILE</a> handle. +<p>The DB_MPOOLFILE->set_ftype interface may not be called after the <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> is called, the information specified to DB_MPOOLFILE->set_ftype +will replace the existing information. <p>The DB_MPOOLFILE->set_ftype function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_MPOOLFILE->set_ftype 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 DB_MPOOLFILE->set_ftype function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_MPOOLFILE->set_ftype function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/memp_set_lsn_offset.html b/db/docs/api_c/memp_set_lsn_offset.html index 40941e6ea..fbc6e8a22 100644 --- a/db/docs/api_c/memp_set_lsn_offset.html +++ b/db/docs/api_c/memp_set_lsn_offset.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_lsn_offset.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_lsn_offset.so,v 10.4 2002/06/24 14:49:28 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_lsn_offset</title> @@ -29,32 +30,41 @@ DB_MPOOLFILE->set_lsn_offset(DB_MPOOLFILE *mpf, int32_t lsn_offset); of a log sequence number (<a href="../api_c/db_lsn.html">DB_LSN</a>) on the file's pages, for the purposes of page-flushing as part of transaction checkpoint. (See the <a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a> documentation for more information.) +<p>The DB_MPOOLFILE->set_lsn_offset function configures a file in the memory pool, not only +operations performed using the specified <a href="../api_c/memp_fcreate.html">DB_MPOOLFILE</a> handle. +<p>The DB_MPOOLFILE->set_lsn_offset interface may not be called after the <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> is called, the information specified to DB_MPOOLFILE->set_lsn_offset +must be consistent with the existing file or an error will be +returned. <p>The DB_MPOOLFILE->set_lsn_offset function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_MPOOLFILE->set_lsn_offset 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 DB_MPOOLFILE->set_lsn_offset function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_MPOOLFILE->set_lsn_offset function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/memp_set_pgcookie.html b/db/docs/api_c/memp_set_pgcookie.html index bcfaa8e12..7e9e76133 100644 --- a/db/docs/api_c/memp_set_pgcookie.html +++ b/db/docs/api_c/memp_set_pgcookie.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_pgcookie.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_pgcookie.so,v 10.4 2002/06/24 14:49:28 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_MPOOLFILE->set_pgcookie</title> @@ -30,32 +31,40 @@ to the functions registered to do input or output processing of the file's pages as they are read from or written to, the backing filesystem store. (See the <a href="../api_c/memp_register.html">DB_ENV->memp_register</a> documentation for more information.) +<p>The DB_MPOOLFILE->set_pgcookie function configures a file in the memory pool, not only +operations performed using the specified <a href="../api_c/memp_fcreate.html">DB_MPOOLFILE</a> handle. +<p>The DB_MPOOLFILE->set_pgcookie interface may not be called after the <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a> is called, the information specified to DB_MPOOLFILE->set_pgcookie +will replace the existing information. <p>The DB_MPOOLFILE->set_pgcookie function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_MPOOLFILE->set_pgcookie 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 DB_MPOOLFILE->set_pgcookie function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_MPOOLFILE->set_pgcookie function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_cachesize.html">DB_ENV->set_cachesize</a>, <a href="../api_c/env_set_mp_mmapsize.html">DB_ENV->set_mp_mmapsize</a>, +<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, +<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, +<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>, +<p> <a href="../api_c/memp_fcreate.html">DB_ENV->memp_fcreate</a>, <a href="../api_c/memp_fclose.html">DB_MPOOLFILE->close</a>, <a href="../api_c/memp_fget.html">DB_MPOOLFILE->get</a>, <a href="../api_c/memp_fopen.html">DB_MPOOLFILE->open</a>, <a href="../api_c/memp_fput.html">DB_MPOOLFILE->put</a>, <a href="../api_c/memp_fset.html">DB_MPOOLFILE->set</a>, -<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>, -<a href="../api_c/memp_register.html">DB_ENV->memp_register</a>, -<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_fileid.html">DB_MPOOLFILE->set_fileid</a>, +<a href="../api_c/memp_set_clear_len.html">DB_MPOOLFILE->set_clear_len</a>, <a href="../api_c/memp_set_ftype.html">DB_MPOOLFILE->set_ftype</a>, <a href="../api_c/memp_set_lsn_offset.html">DB_MPOOLFILE->set_lsn_offset</a>, -<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a>, -<a href="../api_c/memp_stat.html">DB_ENV->memp_stat</a>, -<a href="../api_c/memp_sync.html">DB_ENV->memp_sync</a>, +<a href="../api_c/memp_set_pgcookie.html">DB_MPOOLFILE->set_pgcookie</a> and -<a href="../api_c/memp_trickle.html">DB_ENV->memp_trickle</a>. +<a href="../api_c/memp_fsync.html">DB_MPOOLFILE->sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_c/rep_elect.html b/db/docs/api_c/rep_elect.html index 609eae899..76b396dc3 100644 --- a/db/docs/api_c/rep_elect.html +++ b/db/docs/api_c/rep_elect.html @@ -1,6 +1,7 @@ -<!--Id: rep_elect.so,v 1.4 2001/10/26 13:57:00 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_elect.so,v 1.6 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->rep_elect</title> @@ -64,13 +65,13 @@ incoming messages is necessary to successfully complete an election. <p><dt>DB_REP_UNAVAIL<dd>The replication group was unable to elect a master. </dl> <p>The DB_ENV->rep_elect 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 DB_ENV->rep_elect function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->rep_elect function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/rep_start.html">DB_ENV->rep_start</a>, <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>, -<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a>, +<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a> and <a href="../api_c/rep_transport.html">DB_ENV->set_rep_transport</a>. </tt> diff --git a/db/docs/api_c/rep_message.html b/db/docs/api_c/rep_message.html index ef61b5e49..56d7c8078 100644 --- a/db/docs/api_c/rep_message.html +++ b/db/docs/api_c/rep_message.html @@ -1,6 +1,7 @@ -<!--Id: rep_message.so,v 1.4 2001/10/25 20:15:23 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_message.so,v 1.9 2002/07/02 15:22:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->rep_process_message</title> @@ -40,37 +41,43 @@ information). processed using the same <a href="../api_c/env_create.html">DB_ENV</a> handle. It is not required that a single thread of control process all messages, only that all threads of control processing messages use the same handle. -<p>The DB_ENV->rep_process_message function may return one of several special conditions: -<p><dl compact> -<p><dt><a name="DB_REP_DUPMASTER">DB_REP_DUPMASTER</a><dd>The replication group has more than one master; the application should -reconfigure itself as a client by calling the <a href="../api_c/rep_start.html">DB_ENV->rep_start</a> function, and -then call for an election by calling <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>. -<p><dt><a name="DB_REP_HOLDELECTION">DB_REP_HOLDELECTION</a><dd>An election is needed, the application should call for an election by -calling <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>. -<p><dt><a name="DB_REP_NEWMASTER">DB_REP_NEWMASTER</a><dd>A new master has been elected. The memory location referenced by the -<b>envid</b> parameter contains the environment ID of the new master. -If the recipient of this error return has been made master, it is the -application's responsibility to begin acting as the master environment. -<p><dt><a name="DB_REP_NEWSITE">DB_REP_NEWSITE</a><dd>The system received contact information from a new environment. The -<b>rec</b> parameter contains the opaque data specified in the +<p> +If a new master has been elected, the DB_ENV->rep_process_message function will return DB_REP_NEWMASTER. +The <b>envid</b> parameter contains the environment ID of the new +master. If the recipient of this error return has been made master, it +is the application's responsibility to begin acting as the master +environment. +<p> +If the system received contact information from a new environment, the DB_ENV->rep_process_message function will return DB_REP_NEWSITE. +The <b>rec</b> parameter contains the opaque data specified in the <b>cdata</b> parameter to the <a href="../api_c/rep_start.html">DB_ENV->rep_start</a>. The application should take whatever action is needed to establish a communication channel with this new environment. -<p><dt><a name="DB_REP_OUTDATED">DB_REP_OUTDATED</a><dd>The current environment's logs are too far out of date with respect to -the master to be automatically synchronized. The application should -copy over a hot backup of the environment, run recovery, and restart -the client. -</dl> -<p>Otherwise, the DB_ENV->rep_process_message function returns a non-zero error value on failure and 0 on success. +<p> +If the replication group has more than one master, the DB_ENV->rep_process_message function will return DB_REP_DUPMASTER. +The application should reconfigure itself as a client by calling the +<a href="../api_c/rep_start.html">DB_ENV->rep_start</a> function, and then call for an election by calling +<a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>. +<p> +If an election is needed, the DB_ENV->rep_process_message function will return DB_REP_HOLDELECTION. +The application should call for an election by +calling <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>. +<p> +If the current environment's logs are too far out of date with respect +to the master to be automatically synchronized, the DB_ENV->rep_process_message function will return DB_REP_OUTDATED. The +application should copy over a hot backup of the environment, run +recovery, and restart the client. +<p> +Otherwise, the DB_ENV->rep_process_message function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_ENV->rep_process_message 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 DB_ENV->rep_process_message function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->rep_process_message function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/rep_start.html">DB_ENV->rep_start</a>, <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>, -<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a>, +<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a> and <a href="../api_c/rep_transport.html">DB_ENV->set_rep_transport</a>. </tt> diff --git a/db/docs/api_c/rep_start.html b/db/docs/api_c/rep_start.html index b4b7be4c5..ab320ccbd 100644 --- a/db/docs/api_c/rep_start.html +++ b/db/docs/api_c/rep_start.html @@ -1,6 +1,7 @@ -<!--Id: rep_start.so,v 1.2 2001/10/25 14:08:43 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_start.so,v 1.3 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->rep_start</title> @@ -56,13 +57,13 @@ replication group by a call to <a href="../api_c/rep_transport.html">DB_ENV-> <p>The environment was not already opened. </dl> <p>The DB_ENV->rep_start 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 DB_ENV->rep_start function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->rep_start function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/rep_start.html">DB_ENV->rep_start</a>, <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>, -<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a>, +<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a> and <a href="../api_c/rep_transport.html">DB_ENV->set_rep_transport</a>. </tt> diff --git a/db/docs/api_c/rep_transport.html b/db/docs/api_c/rep_transport.html index ac3d59f18..dd935940a 100644 --- a/db/docs/api_c/rep_transport.html +++ b/db/docs/api_c/rep_transport.html @@ -1,6 +1,7 @@ -<!--Id: rep_transport.so,v 1.4 2001/10/26 23:51:06 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_transport.so,v 1.7 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_ENV->set_rep_transport</title> @@ -51,7 +52,7 @@ The special identifier DB_EID_BROADCAST indicates that a message should be broadcast to every environment in the replication group. The application may use a true broadcast protocol, or may send the message in sequence to each machine with which it is in communication. -<p><dt>flag<dd> +<p><dt>flags<dd> <p>The <b>flags</b> value must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <p><dl compact> @@ -70,17 +71,21 @@ otherwise, any error from the <b>send</b> interface will be ignored. <p>It may sometimes be useful to pass application-specific data to the <b>send</b> interface; see <a href="../ref/env/faq.html">Environment FAQ</a> for a discussion on how to do this. -<p>The <b>flags</b> parameter is currently unused, and must be set to 0. +<p>The DB_ENV->set_rep_transport function configures operations performed using the specified +<a href="../api_c/env_create.html">DB_ENV</a> handle, not all operations performed on the underlying +database environment. +<p>The DB_ENV->set_rep_transport interface may be called at any time during the life of +the application. <p>The DB_ENV->set_rep_transport function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_ENV->set_rep_transport 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 DB_ENV->set_rep_transport function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_ENV->set_rep_transport function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/rep_start.html">DB_ENV->rep_start</a>, <a href="../api_c/rep_elect.html">DB_ENV->rep_elect</a>, -<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a>, +<a href="../api_c/rep_message.html">DB_ENV->rep_process_message</a> and <a href="../api_c/rep_transport.html">DB_ENV->set_rep_transport</a>. </tt> diff --git a/db/docs/api_c/txn_set_timeout.html b/db/docs/api_c/txn_set_timeout.html index 4bd06a7a6..6c008523c 100644 --- a/db/docs/api_c/txn_set_timeout.html +++ b/db/docs/api_c/txn_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: txn_set_timeout.so,v 10.3 2001/10/22 15:24:39 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: txn_set_timeout.so,v 10.6 2002/06/24 14:49:36 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DB_TXN->set_timeout</title> @@ -46,6 +47,11 @@ is performed, the accuracy of the timeout depends on how often deadlock detection is performed. <p>Timeout values may be specified for the database environment as a whole. See <a href="../api_c/env_set_timeout.html">DB_ENV->set_timeout</a> and for more information. +<p>The DB_TXN->set_timeout function configures operations performed on the underlying +transaction, not only operations performed using the specified +<a href="../api_c/txn_begin.html">DB_TXN</a> handle. +<p>The DB_TXN->set_timeout interface may be called at any time during the life of +the application. <p>The DB_TXN->set_timeout function returns a non-zero error value on failure and 0 on success. <h1>Errors</h1> <p>The DB_TXN->set_timeout function may fail and return a non-zero error for the following conditions: @@ -53,24 +59,25 @@ See <a href="../api_c/env_set_timeout.html">DB_ENV->set_timeout</a> and for m <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DB_TXN->set_timeout 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 DB_TXN->set_timeout function may fail and return -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DB_TXN->set_timeout function may fail and +return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_c/env_set_tx_max.html">DB_ENV->set_tx_max</a>, -<a href="../api_c/env_set_tx_recover.html">DB_ENV->set_tx_recover</a>, <a href="../api_c/env_set_tx_timestamp.html">DB_ENV->set_tx_timestamp</a>, -<a href="../api_c/txn_abort.html">DB_TXN->abort</a>, <a href="../api_c/txn_begin.html">DB_ENV->txn_begin</a>, <a href="../api_c/txn_checkpoint.html">DB_ENV->txn_checkpoint</a>, +<a href="../api_c/txn_recover.html">DB_ENV->txn_recover</a> +and +<a href="../api_c/txn_stat.html">DB_ENV->txn_stat</a>. +<p> +<a href="../api_c/txn_abort.html">DB_TXN->abort</a>, <a href="../api_c/txn_commit.html">DB_TXN->commit</a>, <a href="../api_c/txn_discard.html">DB_TXN->discard</a>, <a href="../api_c/txn_id.html">DB_TXN->id</a>, -<a href="../api_c/txn_prepare.html">DB_TXN->prepare</a>, -<a href="../api_c/txn_recover.html">DB_ENV->txn_recover</a>, -<a href="../api_c/txn_set_timeout.html">DB_TXN->set_timeout</a> +<a href="../api_c/txn_prepare.html">DB_TXN->prepare</a> and -<a href="../api_c/txn_stat.html">DB_ENV->txn_stat</a>. +<a href="../api_c/txn_set_timeout.html">DB_TXN->set_timeout</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/c_index.html b/db/docs/api_cxx/c_index.html index 8aba44c15..3958b8f0a 100644 --- a/db/docs/api_cxx/c_index.html +++ b/db/docs/api_cxx/c_index.html @@ -1,24 +1,31 @@ -<!--Id: c_index.so,v 10.80 2001/10/13 19:56:20 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: c_index.so,v 10.96 2002/07/24 05:06:08 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: C++ Interface</title> +<title>Berkeley DB: Berkeley DB: C++ Interface</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> <body bgcolor=white> -<h1 align=center>C++ Interface</h1> +<h1 align=center>Berkeley DB: C++ Interface</h1> <p><table border=1 align=center> <tr><th>Section</th><th>Class/Method</th><th>Description</th></tr> <tr><td><b>Database Environment</b></td><td><a href="../api_cxx/dbenv_class.html">DbEnv</a></td><td>Create an environment handle</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_close.html">DbEnv::close</a></td><td>Close an environment</td></tr> +<tr><td><br></td><td><a href="../api_cxx/env_dbremove.html">DbEnv::dbremove</a></td><td>Remove a database</td></tr> +<tr><td><br></td><td><a href="../api_cxx/env_dbrename.html">DbEnv::dbrename</a></td><td>Rename a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_err.html">DbEnv::err</a></td><td>Error message with error string</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_err.html">DbEnv::errx</a></td><td>Error message</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_open.html">DbEnv::open</a></td><td>Open an environment</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_remove.html">DbEnv::remove</a></td><td>Remove an environment</td></tr> +<tr><td><br></td><td><a href="../api_cxx/env_strerror.html">DbEnv::strerror</a></td><td>Error strings</td></tr> +<tr><td><br></td><td><a href="../api_cxx/env_version.html">DbEnv::version</a></td><td>Return version information</td></tr> +<tr><td><b>Environment Configuration</b></td><td><a href="../api_cxx/env_set_app_dispatch.html">DbEnv::set_app_dispatch</a></td><td>Configure application recovery interface</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a></td><td>Set local space allocation functions</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_data_dir.html">DbEnv::set_data_dir</a></td><td>Set the environment data directory</td></tr> +<tr><td><br></td><td><a href="../api_cxx/env_set_encrypt.html">DbEnv::set_encrypt</a></td><td>Set the environment cryptographic key</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a></td><td>Set error message callback</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_errfile.html">DbEnv::set_errfile</a></td><td>Set error message FILE</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_error_stream.html">DbEnv::set_error_stream</a></td><td>Set error message output stream</td></tr> @@ -26,19 +33,18 @@ <tr><td><br></td><td><a href="../api_cxx/env_set_feedback.html">DbEnv::set_feedback</a></td><td>Set feedback callback</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_flags.html">DbEnv::set_flags</a></td><td>Environment configuration</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_paniccall.html">DbEnv::set_paniccall</a></td><td>Set panic callback</td></tr> -<tr><td><br></td><td><a href="../api_cxx/env_set_rec_init.html">DbEnv::set_recovery_init</a></td><td>Set recovery initialization callback</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_rpc_server.html">DbEnv::set_rpc_server</a></td><td>Establish an RPC server connection</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_shm_key.html">DbEnv::set_shm_key</a></td><td>Set system memory shared segment ID</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_tas_spins.html">DbEnv::set_tas_spins</a></td><td>Set the number of test-and-set spins</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_tmp_dir.html">DbEnv::set_tmp_dir</a></td><td>Set the environment temporary file directory</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_verbose.html">DbEnv::set_verbose</a></td><td>Set verbose messages</td></tr> -<tr><td><br></td><td><a href="../api_cxx/env_strerror.html">DbEnv::strerror</a></td><td>Error strings</td></tr> -<tr><td><br></td><td><a href="../api_cxx/env_version.html">DbEnv::version</a></td><td>Return version information</td></tr> <tr><td><b>Database Operations</b></td><td><a href="../api_cxx/db_class.html">Db</a></td><td>Create a database handle</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_associate.html">Db::associate</a></td><td>Associate a secondary index</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_close.html">Db::close</a></td><td>Close a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_del.html">Db::del</a></td><td>Delete items from a database</td></tr> +<tr><td><br></td><td><a href="../api_cxx/db_err.html">Db::err</a></td><td>Error message with error string</td></tr> +<tr><td><br></td><td><a href="../api_cxx/db_err.html">Db::errx</a></td><td>Error message</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_fd.html">Db::fd</a></td><td>Return a file descriptor from a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_get.html">Db::get</a>, <a href="../api_cxx/db_get.html">Db::pget</a></td><td>Get items from a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_get_byteswapped.html">Db::get_byteswapped</a></td><td>Return if the underlying database is in host order</td></tr> @@ -54,16 +60,17 @@ <tr><td><br></td><td><a href="../api_cxx/db_truncate.html">Db::truncate</a></td><td>Empty a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_upgrade.html">Db::upgrade</a></td><td>Upgrade a database</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_verify.html">Db::verify</a></td><td>Verify/salvage a database</td></tr> -<tr><td><b>Database Configuration</b></td><td><a href="../api_cxx/db_err.html">Db::err</a></td><td>Error message with error string</td></tr> -<tr><td><br></td><td><a href="../api_cxx/db_err.html">Db::errx</a></td><td>Error message</td></tr> -<tr><td><br></td><td><a href="../api_cxx/db_set_alloc.html">Db::set_alloc</a></td><td>Set local space allocation functions</td></tr> +<tr><td><b>Database Configuration</b></td><td><a href="../api_cxx/db_set_alloc.html">Db::set_alloc</a></td><td>Set local space allocation functions</td></tr> +<tr><td><br></td><td><a href="../api_cxx/db_set_cache_priority.html">Db::set_cache_priority</a></td><td>Set the database cache priority</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_cachesize.html">Db::set_cachesize</a></td><td>Set the database cache size</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_dup_compare.html">Db::set_dup_compare</a></td><td>Set a duplicate comparison function</td></tr> +<tr><td><br></td><td><a href="../api_cxx/db_set_encrypt.html">Db::set_encrypt</a></td><td>Set the database cryptographic key</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_errcall.html">Db::set_errcall</a></td><td>Set error message callback</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_errfile.html">Db::set_errfile</a></td><td>Set error message FILE</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_errpfx.html">Db::set_errpfx</a></td><td>Set error message prefix</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_feedback.html">Db::set_feedback</a></td><td>Set feedback callback</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_flags.html">Db::set_flags</a></td><td>General database configuration</td></tr> +<tr><td><br></td><td><a href="../api_cxx/db_set_lorder.html">Db::set_lorder</a></td><td>Set the database byte order</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_pagesize.html">Db::set_pagesize</a></td><td>Set the underlying database page size</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_paniccall.html">Db::set_paniccall</a></td><td>Set panic callback</td></tr> <tr><td><b>Btree/Recno Configuration</b></td><td><a href="../api_cxx/db_set_append_recno.html">Db::set_append_recno</a></td><td>Set record append callback</td></tr> @@ -77,7 +84,6 @@ <tr><td><b>Hash Configuration</b></td><td><a href="../api_cxx/db_set_h_ffactor.html">Db::set_h_ffactor</a></td><td>Set the Hash table density</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_h_hash.html">Db::set_h_hash</a></td><td>Set a hashing function</td></tr> <tr><td><br></td><td><a href="../api_cxx/db_set_h_nelem.html">Db::set_h_nelem</a></td><td>Set the Hash table size</td></tr> -<tr><td><br></td><td><a href="../api_cxx/db_set_lorder.html">Db::set_lorder</a></td><td>Set the database byte order</td></tr> <tr><td><b>Queue Configuration</b></td><td><a href="../api_cxx/db_set_q_extentsize.html">Db::set_q_extentsize</a></td><td>Set Queue database extent size</td></tr> <tr><td><b>Database Cursor Operations</b></td><td><a href="../api_cxx/dbc_class.html">Dbc</a></td><td><b>Cursor class</b></td></tr> <tr><td><br></td><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor handle</td></tr> @@ -109,13 +115,11 @@ <tr><td><br></td><td><a href="../api_cxx/log_file.html">DbEnv::log_file</a></td><td>Map Log Sequence Numbers to log files</td></tr> <tr><td><br></td><td><a href="../api_cxx/log_flush.html">DbEnv::log_flush</a></td><td>Flush log records</td></tr> <tr><td><br></td><td><a href="../api_cxx/log_put.html">DbEnv::log_put</a></td><td>Write a log record</td></tr> -<tr><td><br></td><td><a href="../api_cxx/log_register.html">DbEnv::log_register</a></td><td>Register a filename with the log manager</td></tr> <tr><td><br></td><td><a href="../api_cxx/log_stat.html">DbEnv::log_stat</a></td><td>Return log subsystem statistics</td></tr> -<tr><td><br></td><td><a href="../api_cxx/log_unregister.html">DbEnv::log_unregister</a></td><td>Unregister a filename with the log manager</td></tr> <tr><td><b>Log Cursor Operations</b></td><td><a href="../api_cxx/logc_class.html">DbLogc</a></td><td><b>Log cursor class</b></td></tr> <tr><td><br></td><td><a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a></td><td>Create a log cursor handle</td></tr> -<tr><td><br></td><td><a href="../api_cxx/logc_close.html">DbLogc::logc_close</a></td><td>Close a log cursor</td></tr> -<tr><td><br></td><td><a href="../api_cxx/logc_get.html">DbLogc::logc_get</a></td><td>Retrieve a log record</td></tr> +<tr><td><br></td><td><a href="../api_cxx/logc_close.html">DbLogc::close</a></td><td>Close a log cursor</td></tr> +<tr><td><br></td><td><a href="../api_cxx/logc_get.html">DbLogc::get</a></td><td>Retrieve a log record</td></tr> <tr><td><b>Log Sequence Numbers</b></td><td><a href="../api_cxx/lsn_class.html">DbLsn</a></td><td><br></td></tr> <tr><td><br></td><td><a href="../api_cxx/log_compare.html">DbEnv::log_compare</a></td><td>Compare two Log Sequence Numbers</td></tr> <tr><td><b>Memory Pool Subsystem</b></td><td><a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a></td><td>Set the environment cache size</td></tr> @@ -138,7 +142,6 @@ <tr><td><br></td><td><a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a></td><td>Set file log-sequence-number offset</td></tr> <tr><td><br></td><td><a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a></td><td>Set file cookie for pgin/pgout</td></tr> <tr><td><b>Transaction Subsystem</b></td><td><a href="../api_cxx/env_set_tx_max.html">DbEnv::set_tx_max</a></td><td>Set maximum number of transactions</td></tr> -<tr><td><br></td><td><a href="../api_cxx/env_set_tx_recover.html">DbEnv::set_tx_recover</a></td><td>Set transaction abort recover function</td></tr> <tr><td><br></td><td><a href="../api_cxx/env_set_tx_timestamp.html">DbEnv::set_tx_timestamp</a></td><td>Set recovery timestamp</td></tr> <tr><td><br></td><td><a href="../api_cxx/txn_checkpoint.html">DbEnv::txn_checkpoint</a></td><td>Checkpoint the transaction subsystem</td></tr> <tr><td><br></td><td><a href="../api_cxx/txn_recover.html">DbEnv::txn_recover</a></td><td>Distributed transaction recovery</td></tr> @@ -153,13 +156,17 @@ <tr><td><br></td><td><a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a></td><td>Set transaction timeout</td></tr> <tr><td><b>Replication</b></td><td><a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a></td><td>Configure replication transport</td></tr> <tr><td><br></td><td><a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a></td><td>Hold a replication election</td></tr> +<tr><td><br></td><td><a href="../api_cxx/rep_limit.html">DbEnv::set_rep_limit</a></td><td>Limit data sent in response to a single message</td></tr> <tr><td><br></td><td><a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a></td><td>Process a replication message</td></tr> <tr><td><br></td><td><a href="../api_cxx/rep_start.html">DbEnv::rep_start</a></td><td>Configure an environment for replication</td></tr> +<tr><td><br></td><td><a href="../api_cxx/rep_stat.html">DbEnv::rep_stat</a></td><td>Replication statistics</td></tr> <tr><td><b>Exceptions</b></td><td><a href="../api_cxx/except_class.html">DbException</a></td><td><b>Exception Class for Berkeley DB Activity</b></td></tr> <tr><td><br></td><td><a href="../api_cxx/get_errno.html">DbException::get_errno</a></td><td>Get the error value</td></tr> <tr><td><br></td><td><a href="../api_cxx/what.html">DbException::what</a></td><td>Get the error string</td></tr> +<tr><td><br></td><td><a href="../api_cxx/deadlock_class.html">DbDeadlockException</a></td><td><b>Exception Class for deadlocks</b></td></tr> +<tr><td><br></td><td><a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a></td><td><b>Exception Class for lock request failures</b></td></tr> <tr><td><br></td><td><a href="../api_cxx/mem_class.html">DbMemoryException</a></td><td><b>Exception Class for insufficient memory</b></td></tr> -<tr><td><br></td><td><a href="../api_cxx/get_dbt.html">DbMemoryException::get_dbt</a></td><td>Get the failing Dbt</td></tr> +<tr><td><br></td><td><a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a></td><td><b>Exception Class for failures requiring recovery</b></td></tr> </table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> </body> diff --git a/db/docs/api_cxx/env_set_timeout.html b/db/docs/api_cxx/env_set_timeout.html index a04ec7d33..26a6b719c 100644 --- a/db/docs/api_cxx/env_set_timeout.html +++ b/db/docs/api_cxx/env_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: env_set_timeout.so,v 10.3 2001/10/22 15:24:31 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: env_set_timeout.so,v 10.6 2002/06/24 14:49:21 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::set_timeout</title> @@ -59,44 +60,61 @@ detection is performed. <p>Timeout values specified for the database environment may be overridden on a per-lock or per-transaction basis. See <a href="../api_cxx/lock_vec.html">DbEnv::lock_vec</a> and <a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a> for more information. -<p>The DbEnv::set_timeout interface may be used only to configure Berkeley DB before -the <a href="../api_cxx/env_open.html">DbEnv::open</a> interface is called. +<p>The DbEnv::set_timeout method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/dbenv_class.html">DbEnv</a> handle. +<p>The DbEnv::set_timeout interface may be called at any time during the life of +the application. <p>The DbEnv::set_timeout 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. <h1>Errors</h1> <p>The DbEnv::set_timeout method may fail and throw an exception or return a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. -<p>Called after <a href="../api_cxx/env_open.html">DbEnv::open</a> was called. </dl> <p>The DbEnv::set_timeout 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 DbEnv::set_timeout method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::set_timeout method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a> <h1>See Also</h1> <a href="../api_cxx/env_close.html">DbEnv::close</a>, -<a href="../api_cxx/env_err.html">DbEnv::err</a>, <a href="../api_cxx/env_err.html">DbEnv::errx</a> +<a href="../api_cxx/env_dbremove.html">DbEnv::dbremove</a>, +<a href="../api_cxx/env_dbrename.html">DbEnv::dbrename</a>, +<a href="../api_cxx/env_err.html">DbEnv::err</a>, +<a href="../api_cxx/env_err.html">DbEnv::errx</a>, <a href="../api_cxx/env_open.html">DbEnv::open</a>, <a href="../api_cxx/env_remove.html">DbEnv::remove</a>, <a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a>, +<a href="../api_cxx/env_set_app_dispatch.html">DbEnv::set_app_dispatch</a>, <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_data_dir.html">DbEnv::set_data_dir</a>, +<a href="../api_cxx/env_set_encrypt.html">DbEnv::set_encrypt</a>, <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a>, <a href="../api_cxx/env_set_errfile.html">DbEnv::set_errfile</a>, <a href="../api_cxx/env_set_error_stream.html">DbEnv::set_error_stream</a>, <a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a>, <a href="../api_cxx/env_set_feedback.html">DbEnv::set_feedback</a>, <a href="../api_cxx/env_set_flags.html">DbEnv::set_flags</a>, +<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, +<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, +<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, +<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, +<a href="../api_cxx/env_set_lk_conflicts.html">DbEnv::set_lk_conflicts</a>, +<a href="../api_cxx/env_set_lk_detect.html">DbEnv::set_lk_detect</a>, +<a href="../api_cxx/env_set_lk_max_lockers.html">DbEnv::set_lk_max_lockers</a>, +<a href="../api_cxx/env_set_lk_max_locks.html">DbEnv::set_lk_max_locks</a>, +<a href="../api_cxx/env_set_lk_max_objects.html">DbEnv::set_lk_max_objects</a>, +<a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, <a href="../api_cxx/env_set_paniccall.html">DbEnv::set_paniccall</a>, -<a href="../api_cxx/env_set_rec_init.html">DbEnv::set_recovery_init</a>, <a href="../api_cxx/env_set_rpc_server.html">DbEnv::set_rpc_server</a>, <a href="../api_cxx/env_set_shm_key.html">DbEnv::set_shm_key</a>, <a href="../api_cxx/env_set_tas_spins.html">DbEnv::set_tas_spins</a>, -<a href="../api_cxx/env_set_tmp_dir.html">DbEnv::set_tmp_dir</a>, <a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a>, +<a href="../api_cxx/env_set_tmp_dir.html">DbEnv::set_tmp_dir</a>, +<a href="../api_cxx/env_set_tx_max.html">DbEnv::set_tx_max</a>, +<a href="../api_cxx/env_set_tx_timestamp.html">DbEnv::set_tx_timestamp</a>, <a href="../api_cxx/env_set_verbose.html">DbEnv::set_verbose</a>, <a href="../api_cxx/env_strerror.html">DbEnv::strerror</a> and diff --git a/db/docs/api_cxx/lock_id_free.html b/db/docs/api_cxx/lock_id_free.html index e6e8f8f36..ee463e484 100644 --- a/db/docs/api_cxx/lock_id_free.html +++ b/db/docs/api_cxx/lock_id_free.html @@ -1,6 +1,7 @@ -<!--Id: lock_id_free.so,v 10.2 2001/10/22 15:24:32 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: lock_id_free.so,v 10.4 2002/06/24 14:49:23 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::lock_id_free</title> @@ -35,10 +36,10 @@ encapsulates a non-zero error value on failure, and returns 0 on success. <p>The locker ID is invalid or locks are still held by this locker ID. </dl> <p>The DbEnv::lock_id_free 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 DbEnv::lock_id_free method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::lock_id_free method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/lock_class.html">DbLock</a> <h1>See Also</h1> @@ -52,7 +53,7 @@ in the same way. <a href="../api_cxx/lock_id.html">DbEnv::lock_id</a>, <a href="../api_cxx/lock_id_free.html">DbEnv::lock_id_free</a>, <a href="../api_cxx/lock_put.html">DbEnv::lock_put</a>, -<a href="../api_cxx/lock_stat.html">DbEnv::lock_stat</a>, +<a href="../api_cxx/lock_stat.html">DbEnv::lock_stat</a> and <a href="../api_cxx/lock_vec.html">DbEnv::lock_vec</a>. </tt> diff --git a/db/docs/api_cxx/log_cursor.html b/db/docs/api_cxx/log_cursor.html index b6a877ba3..083920d55 100644 --- a/db/docs/api_cxx/log_cursor.html +++ b/db/docs/api_cxx/log_cursor.html @@ -1,6 +1,7 @@ -<!--Id: log_cursor.so,v 10.2 2001/10/22 15:24:33 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: log_cursor.so,v 10.3 2002/06/24 14:49:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::log_cursor</title> @@ -37,36 +38,39 @@ encapsulates a non-zero error value on failure, and returns 0 on success. <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DbEnv::log_cursor 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 DbEnv::log_cursor method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::log_cursor method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/db_class.html">Db</a> <h1>See Also</h1> +<a href="../api_cxx/db_set_alloc.html">Db::set_alloc</a>, <a href="../api_cxx/db_associate.html">Db::associate</a>, <a href="../api_cxx/db_close.html">Db::close</a>, <a href="../api_cxx/db_cursor.html">Db::cursor</a>, <a href="../api_cxx/db_del.html">Db::del</a>, -<a href="../api_cxx/db_err.html">Db::err</a>, <a href="../api_cxx/db_err.html">Db::errx</a> +<a href="../api_cxx/db_err.html">Db::err</a>, +<a href="../api_cxx/db_err.html">Db::errx</a>, <a href="../api_cxx/db_fd.html">Db::fd</a>, <a href="../api_cxx/db_get.html">Db::get</a>, -<a href="../api_cxx/db_get.html">Db::pget</a>, <a href="../api_cxx/db_get_byteswapped.html">Db::get_byteswapped</a>, <a href="../api_cxx/db_get_type.html">Db::get_type</a>, <a href="../api_cxx/db_join.html">Db::join</a>, <a href="../api_cxx/db_key_range.html">Db::key_range</a>, <a href="../api_cxx/db_open.html">Db::open</a>, +<a href="../api_cxx/db_get.html">Db::pget</a>, <a href="../api_cxx/db_put.html">Db::put</a>, <a href="../api_cxx/db_remove.html">Db::remove</a>, <a href="../api_cxx/db_rename.html">Db::rename</a>, -<a href="../api_cxx/db_set_alloc.html">Db::set_alloc</a>, <a href="../api_cxx/db_set_append_recno.html">Db::set_append_recno</a>, <a href="../api_cxx/db_set_bt_compare.html">Db::set_bt_compare</a>, <a href="../api_cxx/db_set_bt_minkey.html">Db::set_bt_minkey</a>, <a href="../api_cxx/db_set_bt_prefix.html">Db::set_bt_prefix</a>, +<a href="../api_cxx/db_set_cache_priority.html">Db::set_cache_priority</a>, <a href="../api_cxx/db_set_cachesize.html">Db::set_cachesize</a>, <a href="../api_cxx/db_set_dup_compare.html">Db::set_dup_compare</a>, +<a href="../api_cxx/db_set_encrypt.html">Db::set_encrypt</a>, <a href="../api_cxx/db_set_errcall.html">Db::set_errcall</a>, <a href="../api_cxx/db_set_errfile.html">Db::set_errfile</a>, <a href="../api_cxx/db_set_errpfx.html">Db::set_errpfx</a>, @@ -86,7 +90,7 @@ in the same way. <a href="../api_cxx/db_stat.html">Db::stat</a>, <a href="../api_cxx/db_sync.html">Db::sync</a>, <a href="../api_cxx/db_truncate.html">Db::truncate</a>, -<a href="../api_cxx/db_upgrade.html">Db::upgrade</a>, +<a href="../api_cxx/db_upgrade.html">Db::upgrade</a> and <a href="../api_cxx/db_verify.html">Db::verify</a>. </tt> diff --git a/db/docs/api_cxx/logc_class.html b/db/docs/api_cxx/logc_class.html index c83c12e95..de5b7d81b 100644 --- a/db/docs/api_cxx/logc_class.html +++ b/db/docs/api_cxx/logc_class.html @@ -1,6 +1,7 @@ -<!--Id: logc_class.so,v 1.1 2001/09/28 15:09:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_class.so,v 1.3 2002/06/27 19:10:06 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbLogc</title> @@ -30,24 +31,24 @@ which provides cursor support for log files. sequential access to the records stored in log files. Cursors are created by calling the <a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a> method which returns a pointer to a DbLogc object. <h1>Class</h1> -<a href="../api_cxx/dbenv_class.html">DbEnv</a> +<a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, -<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, -<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, -<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, <a href="../api_cxx/log_archive.html">DbEnv::log_archive</a>, -<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>, -<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, <a href="../api_cxx/log_file.html">DbEnv::log_file</a>, <a href="../api_cxx/log_flush.html">DbEnv::log_flush</a>, <a href="../api_cxx/log_put.html">DbEnv::log_put</a>, -<a href="../api_cxx/log_register.html">DbEnv::log_register</a>, <a href="../api_cxx/log_stat.html">DbEnv::log_stat</a>, -<a href="../api_cxx/log_unregister.html">DbEnv::log_unregister</a>, -<a href="../api_cxx/logc_close.html">DbLogc::logc_close</a> +<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, +<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, +<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, +<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, +and +<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>. +<p> +<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, +<a href="../api_cxx/logc_close.html">DbLogc::close</a> and -<a href="../api_cxx/logc_get.html">DbLogc::logc_get</a>. +<a href="../api_cxx/logc_get.html">DbLogc::get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/logc_close.html b/db/docs/api_cxx/logc_close.html index b3ad0fc69..20c55bb79 100644 --- a/db/docs/api_cxx/logc_close.html +++ b/db/docs/api_cxx/logc_close.html @@ -1,9 +1,10 @@ -<!--Id: logc_close.so,v 10.4 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_close.so,v 10.5 2002/06/24 14:49:25 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbLogc::logc_close</title> +<title>Berkeley DB: DbLogc::close</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> @@ -11,7 +12,7 @@ <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td> -<h1>DbLogc::logc_close</h1> +<h1>DbLogc::close</h1> </td> <td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> @@ -25,42 +26,42 @@ int DbLogc::close(u_int32_t flags); </pre></h3> <h1>Description</h1> -<p>The DbLogc::logc_close method discards the log cursor. After DbLogc::logc_close +<p>The DbLogc::close method discards the log cursor. After DbLogc::close has been called, regardless of its return, the cursor handle may not be used again. <p>The <b>flags</b> parameter is currently unused, and must be set to 0. -<p>The DbLogc::logc_close method either returns a non-zero error value or throws an exception that +<p>The DbLogc::close 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. <h1>Errors</h1> -<p>The DbLogc::logc_close method may fail and throw an exception or return a non-zero error for the following conditions: +<p>The DbLogc::close method may fail and throw an exception or return a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. <p>The cursor was previously closed. </dl> -<p>The DbLogc::logc_close 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 DbLogc::logc_close method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +<p>The DbLogc::close 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 DbLogc::close method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> -<a href="../api_cxx/dbenv_class.html">DbEnv</a> +<a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, -<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, -<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, -<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, <a href="../api_cxx/log_archive.html">DbEnv::log_archive</a>, -<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>, -<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, <a href="../api_cxx/log_file.html">DbEnv::log_file</a>, <a href="../api_cxx/log_flush.html">DbEnv::log_flush</a>, <a href="../api_cxx/log_put.html">DbEnv::log_put</a>, -<a href="../api_cxx/log_register.html">DbEnv::log_register</a>, <a href="../api_cxx/log_stat.html">DbEnv::log_stat</a>, -<a href="../api_cxx/log_unregister.html">DbEnv::log_unregister</a>, -<a href="../api_cxx/logc_close.html">DbLogc::logc_close</a> +<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, +<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, +<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, +<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, +and +<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>. +<p> +<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, +<a href="../api_cxx/logc_close.html">DbLogc::close</a> and -<a href="../api_cxx/logc_get.html">DbLogc::logc_get</a>. +<a href="../api_cxx/logc_get.html">DbLogc::get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/logc_get.html b/db/docs/api_cxx/logc_get.html index 73d6e9f46..cbfef46d0 100644 --- a/db/docs/api_cxx/logc_get.html +++ b/db/docs/api_cxx/logc_get.html @@ -1,9 +1,10 @@ -<!--Id: logc_get.so,v 10.31 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_get.so,v 10.36 2002/07/01 16:52:26 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbLogc::logc_get</title> +<title>Berkeley DB: DbLogc::get</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> @@ -11,7 +12,7 @@ <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td> -<h1>DbLogc::logc_get</h1> +<h1>DbLogc::get</h1> </td> <td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> @@ -25,7 +26,7 @@ int DbLogc::get(DbLsn *lsn, Dbt *data, u_int32_t flags); </pre></h3> <h1>Description</h1> -<p>The DbLogc::logc_get method retrieve records from the log according to the +<p>The DbLogc::get method retrieve records from the log according to the <b>lsn</b> and <b>flags</b> arguments. <p>The data field of the <b>data</b> structure is set to the record retrieved, and the size field indicates the number of bytes in the @@ -35,44 +36,41 @@ record. See <a href="../api_cxx/dbt_class.html">Dbt</a> for a description of ot for any <a href="../api_cxx/dbt_class.html">Dbt</a> used for data retrieval. <p>The <b>flags</b> value must be set to one of the following values: <p><dl compact> -<p><dt><a name="DB_CHECKPOINT">DB_CHECKPOINT</a><dd>The last record written with the DB_CHECKPOINT flag specified to the -<a href="../api_cxx/log_put.html">DbEnv::log_put</a> method is returned in the <b>data</b> argument. The -<b>lsn</b> argument is overwritten with the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the record -returned. If no record has been previously written with the DB_CHECKPOINT -flag specified, the first record in the log is returned. -<p>If the log is empty, the DbLogc::logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. <p><dt><a name="DB_FIRST">DB_FIRST</a><dd>The first record from any of the log files found in the log directory is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the record returned. -<p>If the log is empty, the DbLogc::logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. +<p> +If the log is empty, the DbLogc::get method will return DB_NOTFOUND. <p><dt><a name="DB_LAST">DB_LAST</a><dd>The last record in the log is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the record returned. -<p>If the log is empty, the DbLogc::logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. +<p> +If the log is empty, the DbLogc::get method will return DB_NOTFOUND. <p><dt><a name="DB_NEXT">DB_NEXT</a>, <a name="DB_PREV">DB_PREV</a><dd>The current log position is advanced to the next (previous) record in the log, and that record is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the record returned. -<p>If the pointer has not been initialized via DB_FIRST, DB_LAST, DB_SET, -DB_NEXT, or DB_PREV, DbLogc::logc_get will return the first (last) record -in the log. If the last (first) log record has already been returned -or the log is empty, the DbLogc::logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">DB_NOTFOUND</a>. -<p>If the log was opened with the DB_THREAD flag set, calls to -DbLogc::logc_get with the DB_NEXT (DB_PREV) flag set will return -EINVAL. +<p>If the cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, +DB_NEXT, or DB_PREV, DbLogc::get will return the first (last) record +in the log. +If the last (first) log record has already been returned or the log is +empty, the DbLogc::get method will return DB_NOTFOUND. +If the log was opened with the DB_THREAD flag set, calls to +DbLogc::get with the DB_NEXT (DB_PREV) flag set, the DbLogc::get method either returns EINVAL or throws an exception that encapsulates EINVAL. <p><dt><a name="DB_CURRENT">DB_CURRENT</a><dd>Return the log record to which the log currently refers. -<p>If the log pointer has not been initialized via DB_FIRST, DB_LAST, +If the log cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, DB_NEXT, or DB_PREV, or if the log was opened with the DB_THREAD -flag set, DbLogc::logc_get will return EINVAL. -<p><dt><a name="DB_SET">DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. If the -specified <a href="../api_cxx/lsn_class.html">DbLsn</a> is invalid (for example, it does not appear in -the log) DbLogc::logc_get will return EINVAL. +flag set, the DbLogc::get method either returns EINVAL or throws an exception that encapsulates EINVAL. +<p><dt><a name="DB_SET">DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. +If the specified <a href="../api_cxx/lsn_class.html">DbLsn</a> is invalid (for example, it does not +appear in the log), the DbLogc::get method either returns EINVAL or throws an exception that encapsulates EINVAL. </dl> -<p>Otherwise, the DbLogc::logc_get method either returns a non-zero error value or throws an exception that +<p> +Otherwise, the DbLogc::get 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. <h1>Errors</h1> -<p>The DbLogc::logc_get method may fail and throw an exception or return a non-zero error for the following conditions: +<p>The DbLogc::get method may fail and throw an exception or return a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. <p>The DB_CURRENT flag was set and the log pointer had not yet been @@ -80,30 +78,30 @@ initialized. <p>The DB_SET flag was set and the specified log sequence number does not exist. </dl> -<p>The DbLogc::logc_get 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 DbLogc::logc_get method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +<p>The DbLogc::get 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 DbLogc::get method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> -<a href="../api_cxx/dbenv_class.html">DbEnv</a> +<a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, -<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, -<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, -<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, <a href="../api_cxx/log_archive.html">DbEnv::log_archive</a>, -<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>, -<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, <a href="../api_cxx/log_file.html">DbEnv::log_file</a>, <a href="../api_cxx/log_flush.html">DbEnv::log_flush</a>, <a href="../api_cxx/log_put.html">DbEnv::log_put</a>, -<a href="../api_cxx/log_register.html">DbEnv::log_register</a>, <a href="../api_cxx/log_stat.html">DbEnv::log_stat</a>, -<a href="../api_cxx/log_unregister.html">DbEnv::log_unregister</a>, -<a href="../api_cxx/logc_close.html">DbLogc::logc_close</a> +<a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a>, +<a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a>, +<a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a>, +<a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a>, +and +<a href="../api_cxx/log_compare.html">DbEnv::log_compare</a>. +<p> +<a href="../api_cxx/log_cursor.html">DbEnv::log_cursor</a>, +<a href="../api_cxx/logc_close.html">DbLogc::close</a> and -<a href="../api_cxx/logc_get.html">DbLogc::logc_get</a>. +<a href="../api_cxx/logc_get.html">DbLogc::get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_fcreate.html b/db/docs/api_cxx/memp_fcreate.html index 6a6a202f3..25da222d0 100644 --- a/db/docs/api_cxx/memp_fcreate.html +++ b/db/docs/api_cxx/memp_fcreate.html @@ -1,6 +1,7 @@ -<!--Id: memp_fcreate.so,v 10.4 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_fcreate.so,v 10.5 2002/06/24 14:49:26 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::memp_fcreate</title> @@ -34,32 +35,33 @@ Calling the <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a> method encapsulates a non-zero error value on failure, and returns 0 on success. <h1>Errors</h1> <p>The DbEnv::memp_fcreate 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 DbEnv::memp_fcreate method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::memp_fcreate method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_set_clear_len.html b/db/docs/api_cxx/memp_set_clear_len.html index 56017cc18..98ed67676 100644 --- a/db/docs/api_cxx/memp_set_clear_len.html +++ b/db/docs/api_cxx/memp_set_clear_len.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_clear_len.so,v 10.2 2001/10/22 15:24:36 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_clear_len.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMpoolFile::set_clear_len</title> @@ -30,36 +31,45 @@ page that should be set to nul when the page is created as a result of the <a href="../api_cxx/memp_fget.html#DB_MPOOL_CREATE">DB_MPOOL_CREATE</a> or <a href="../api_cxx/memp_fget.html#DB_MPOOL_NEW">DB_MPOOL_NEW</a> flags being specified to <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>. If no value is specified, or <b>len</b> is 0, the entire page is cleared. +<p>The DbMpoolFile::set_clear_len method configures a file in the memory pool, not only +operations performed using the specified <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle. +<p>The DbMpoolFile::set_clear_len interface may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> is called, the information specified to DbMpoolFile::set_clear_len +must be consistent with the existing file or an error will be +returned. <p>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. <h1>Errors</h1> <p>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 <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbMpoolFile::set_clear_len method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_set_fileid.html b/db/docs/api_cxx/memp_set_fileid.html index 50c179a2e..d63738fcc 100644 --- a/db/docs/api_cxx/memp_set_fileid.html +++ b/db/docs/api_cxx/memp_set_fileid.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_fileid.so,v 10.2 2001/10/22 15:24:36 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_fileid.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMpoolFile::set_fileid</title> @@ -51,36 +52,41 @@ using the Berkeley DB access methods instead of calling the pool functions explicitly, or if the files in the memory pool are stored on filesystems in which the default values as described previously are invariant between process and across system reboots. +<p>The DbMpoolFile::set_fileid method configures a file in the memory pool, not only +operations performed using the specified <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle. +<p>The DbMpoolFile::set_fileid interface may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> +interface is called. <p>The DbMpoolFile::set_fileid 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. <h1>Errors</h1> <p>The DbMpoolFile::set_fileid 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_fileid method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbMpoolFile::set_fileid method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_set_ftype.html b/db/docs/api_cxx/memp_set_ftype.html index 04195c00a..7dd394def 100644 --- a/db/docs/api_cxx/memp_set_ftype.html +++ b/db/docs/api_cxx/memp_set_ftype.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_ftype.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_ftype.so,v 10.4 2002/06/24 14:49:27 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMpoolFile::set_ftype</title> @@ -31,36 +32,44 @@ written to, the backing filesystem store. The <b>ftype</b> argument must be the same as a <b>ftype</b> argument previously specified to the <a href="../api_cxx/memp_register.html">DbEnv::memp_register</a> method. (See the <a href="../api_cxx/memp_register.html">DbEnv::memp_register</a> documentation for more information.) +<p>The DbMpoolFile::set_ftype method configures a file in the memory pool, not only +operations performed using the specified <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle. +<p>The DbMpoolFile::set_ftype interface may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> is called, the information specified to DbMpoolFile::set_ftype +will replace the existing information. <p>The DbMpoolFile::set_ftype 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. <h1>Errors</h1> <p>The DbMpoolFile::set_ftype 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_ftype method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbMpoolFile::set_ftype method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_set_lsn_offset.html b/db/docs/api_cxx/memp_set_lsn_offset.html index 05891ba4c..74c76d4f8 100644 --- a/db/docs/api_cxx/memp_set_lsn_offset.html +++ b/db/docs/api_cxx/memp_set_lsn_offset.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_lsn_offset.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_lsn_offset.so,v 10.4 2002/06/24 14:49:28 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMpoolFile::set_lsn_offset</title> @@ -29,36 +30,45 @@ DbMpoolFile::set(int32_t lsn_offset); of a log sequence number (<a href="../api_cxx/lsn_class.html">DbLsn</a>) on the file's pages, for the purposes of page-flushing as part of transaction checkpoint. (See the <a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a> documentation for more information.) +<p>The DbMpoolFile::set_lsn_offset method configures a file in the memory pool, not only +operations performed using the specified <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle. +<p>The DbMpoolFile::set_lsn_offset interface may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> is called, the information specified to DbMpoolFile::set_lsn_offset +must be consistent with the existing file or an error will be +returned. <p>The DbMpoolFile::set_lsn_offset 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. <h1>Errors</h1> <p>The DbMpoolFile::set_lsn_offset 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_lsn_offset method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbMpoolFile::set_lsn_offset method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/memp_set_pgcookie.html b/db/docs/api_cxx/memp_set_pgcookie.html index 945f729f0..6c89916e8 100644 --- a/db/docs/api_cxx/memp_set_pgcookie.html +++ b/db/docs/api_cxx/memp_set_pgcookie.html @@ -1,6 +1,7 @@ -<!--Id: memp_set_pgcookie.so,v 10.2 2001/10/22 15:24:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: memp_set_pgcookie.so,v 10.4 2002/06/24 14:49:28 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMpoolFile::set_pgcookie</title> @@ -30,36 +31,44 @@ to the functions registered to do input or output processing of the file's pages as they are read from or written to, the backing filesystem store. (See the <a href="../api_cxx/memp_register.html">DbEnv::memp_register</a> documentation for more information.) +<p>The DbMpoolFile::set_pgcookie method configures a file in the memory pool, not only +operations performed using the specified <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle. +<p>The DbMpoolFile::set_pgcookie interface may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> +interface is called. +If the file is already open in the memory pool when +<a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> is called, the information specified to DbMpoolFile::set_pgcookie +will replace the existing information. <p>The DbMpoolFile::set_pgcookie 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. <h1>Errors</h1> <p>The DbMpoolFile::set_pgcookie 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_pgcookie method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbMpoolFile::set_pgcookie method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> <h1>See Also</h1> <a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a>, <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a>, +<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, +<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, +<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>, +<p> <a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a>, <a href="../api_cxx/memp_fclose.html">DbMpoolFile::close</a>, <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>, <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a>, <a href="../api_cxx/memp_fput.html">DbMpoolFile::put</a>, <a href="../api_cxx/memp_fset.html">DbMpoolFile::set</a>, -<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>, -<a href="../api_cxx/memp_register.html">DbEnv::memp_register</a>, -<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_fileid.html">DbMpoolFile::set_fileid</a>, +<a href="../api_cxx/memp_set_clear_len.html">DbMpoolFile::set_clear_len</a>, <a href="../api_cxx/memp_set_ftype.html">DbMpoolFile::set_ftype</a>, <a href="../api_cxx/memp_set_lsn_offset.html">DbMpoolFile::set_lsn_offset</a>, -<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a>, -<a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a>, -<a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a>, +<a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a> and -<a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a>. +<a href="../api_cxx/memp_fsync.html">DbMpoolFile::sync</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_cxx/rep_elect.html b/db/docs/api_cxx/rep_elect.html index 7aac497e7..a15408235 100644 --- a/db/docs/api_cxx/rep_elect.html +++ b/db/docs/api_cxx/rep_elect.html @@ -1,6 +1,7 @@ -<!--Id: rep_elect.so,v 1.4 2001/10/26 13:57:00 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_elect.so,v 1.6 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::rep_elect</title> @@ -65,14 +66,14 @@ encapsulates a non-zero error value on failure, and returns 0 on success. <p><dt>DB_REP_UNAVAIL<dd>The replication group was unable to elect a master. </dl> <p>The DbEnv::rep_elect 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 DbEnv::rep_elect method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::rep_elect method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a>, <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>, -<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>, +<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> and <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a>. </tt> diff --git a/db/docs/api_cxx/rep_message.html b/db/docs/api_cxx/rep_message.html index 4004c3f0e..a11cd9566 100644 --- a/db/docs/api_cxx/rep_message.html +++ b/db/docs/api_cxx/rep_message.html @@ -1,6 +1,7 @@ -<!--Id: rep_message.so,v 1.4 2001/10/25 20:15:23 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_message.so,v 1.9 2002/07/02 15:22:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::rep_process_message</title> @@ -39,39 +40,45 @@ information). processed using the same <a href="../api_cxx/dbenv_class.html">DbEnv</a> handle. It is not required that a single thread of control process all messages, only that all threads of control processing messages use the same handle. -<p>The DbEnv::rep_process_message method may return one of several special conditions: -<p><dl compact> -<p><dt><a name="DB_REP_DUPMASTER">DB_REP_DUPMASTER</a><dd>The replication group has more than one master; the application should -reconfigure itself as a client by calling the <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a> method, and -then call for an election by calling <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>. -<p><dt><a name="DB_REP_HOLDELECTION">DB_REP_HOLDELECTION</a><dd>An election is needed, the application should call for an election by -calling <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>. -<p><dt><a name="DB_REP_NEWMASTER">DB_REP_NEWMASTER</a><dd>A new master has been elected. The memory location referenced by the -<b>envid</b> parameter contains the environment ID of the new master. -If the recipient of this error return has been made master, it is the -application's responsibility to begin acting as the master environment. -<p><dt><a name="DB_REP_NEWSITE">DB_REP_NEWSITE</a><dd>The system received contact information from a new environment. The -<b>rec</b> parameter contains the opaque data specified in the +<p> +If a new master has been elected, the DbEnv::rep_process_message method will return DB_REP_NEWMASTER. +The <b>envid</b> parameter contains the environment ID of the new +master. If the recipient of this error return has been made master, it +is the application's responsibility to begin acting as the master +environment. +<p> +If the system received contact information from a new environment, the DbEnv::rep_process_message method will return DB_REP_NEWSITE. +The <b>rec</b> parameter contains the opaque data specified in the <b>cdata</b> parameter to the <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a>. The application should take whatever action is needed to establish a communication channel with this new environment. -<p><dt><a name="DB_REP_OUTDATED">DB_REP_OUTDATED</a><dd>The current environment's logs are too far out of date with respect to -the master to be automatically synchronized. The application should -copy over a hot backup of the environment, run recovery, and restart -the client. -</dl> -<p>Otherwise, the DbEnv::rep_process_message method either returns a non-zero error value or throws an exception that +<p> +If the replication group has more than one master, the DbEnv::rep_process_message method either returns DB_REP_DUPMASTER or throws an exception that encapsulates DB_REP_DUPMASTER. +The application should reconfigure itself as a client by calling the +<a href="../api_cxx/rep_start.html">DbEnv::rep_start</a> method, and then call for an election by calling +<a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>. +<p> +If an election is needed, the DbEnv::rep_process_message method either returns DB_REP_HOLDELECTION or throws an exception that encapsulates DB_REP_HOLDELECTION. +The application should call for an election by +calling <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>. +<p> +If the current environment's logs are too far out of date with respect +to the master to be automatically synchronized, the DbEnv::rep_process_message method either returns DB_REP_OUTDATED or throws an exception that encapsulates DB_REP_OUTDATED. The +application should copy over a hot backup of the environment, run +recovery, and restart the client. +<p> +Otherwise, the DbEnv::rep_process_message 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. <h1>Errors</h1> <p>The DbEnv::rep_process_message 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 DbEnv::rep_process_message method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::rep_process_message method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a>, <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>, -<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>, +<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> and <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a>. </tt> diff --git a/db/docs/api_cxx/rep_start.html b/db/docs/api_cxx/rep_start.html index 3be75a427..7a81b6fcf 100644 --- a/db/docs/api_cxx/rep_start.html +++ b/db/docs/api_cxx/rep_start.html @@ -1,6 +1,7 @@ -<!--Id: rep_start.so,v 1.2 2001/10/25 14:08:43 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_start.so,v 1.3 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::rep_start</title> @@ -57,14 +58,14 @@ replication group by a call to <a href="../api_cxx/rep_transport.html">DbEnv::se <p>The environment was not already opened. </dl> <p>The DbEnv::rep_start 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 DbEnv::rep_start method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::rep_start method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a>, <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>, -<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>, +<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> and <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a>. </tt> diff --git a/db/docs/api_cxx/rep_transport.html b/db/docs/api_cxx/rep_transport.html index 6998e11cd..19fb8d233 100644 --- a/db/docs/api_cxx/rep_transport.html +++ b/db/docs/api_cxx/rep_transport.html @@ -1,6 +1,7 @@ -<!--Id: rep_transport.so,v 1.4 2001/10/26 23:51:06 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_transport.so,v 1.7 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv::set_rep_transport</title> @@ -51,7 +52,7 @@ The special identifier DB_EID_BROADCAST indicates that a message should be broadcast to every environment in the replication group. The application may use a true broadcast protocol, or may send the message in sequence to each machine with which it is in communication. -<p><dt>flag<dd> +<p><dt>flags<dd> <p>The <b>flags</b> value must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <p><dl compact> @@ -70,19 +71,23 @@ otherwise, any error from the <b>send</b> interface will be ignored. <p>It may sometimes be useful to pass application-specific data to the <b>send</b> interface; see <a href="../ref/env/faq.html">Environment FAQ</a> for a discussion on how to do this. -<p>The <b>flags</b> parameter is currently unused, and must be set to 0. +<p>The DbEnv::set_rep_transport method configures operations performed using the specified +<a href="../api_cxx/dbenv_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment. +<p>The DbEnv::set_rep_transport interface may be called at any time during the life of +the application. <p>The DbEnv::set_rep_transport 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. <h1>Errors</h1> <p>The DbEnv::set_rep_transport 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 DbEnv::set_rep_transport method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbEnv::set_rep_transport method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_cxx/rep_start.html">DbEnv::rep_start</a>, <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a>, -<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>, +<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> and <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a>. </tt> diff --git a/db/docs/api_cxx/txn_set_timeout.html b/db/docs/api_cxx/txn_set_timeout.html index f67020601..29e675587 100644 --- a/db/docs/api_cxx/txn_set_timeout.html +++ b/db/docs/api_cxx/txn_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: txn_set_timeout.so,v 10.3 2001/10/22 15:24:39 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: txn_set_timeout.so,v 10.6 2002/06/24 14:49:36 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbTxn::set_timeout</title> @@ -46,6 +47,11 @@ is performed, the accuracy of the timeout depends on how often deadlock detection is performed. <p>Timeout values may be specified for the database environment as a whole. See <a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a> and for more information. +<p>The DbTxn::set_timeout method configures operations performed on the underlying +transaction, not only operations performed using the specified +<a href="../api_cxx/txn_class.html">DbTxn</a> handle. +<p>The DbTxn::set_timeout interface may be called at any time during the life of +the application. <p>The DbTxn::set_timeout 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. <h1>Errors</h1> @@ -54,27 +60,28 @@ encapsulates a non-zero error value on failure, and returns 0 on success. <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DbTxn::set_timeout 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 DbTxn::set_timeout method may fail and either -return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw an exception encapsulating -<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail -in the same way. +If a catastrophic error has occurred, the DbTxn::set_timeout method may fail and +either return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> or throw a +<a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_cxx/dbenv_class.html">DbEnv</a>, <a href="../api_cxx/txn_class.html">DbTxn</a> <h1>See Also</h1> <a href="../api_cxx/env_set_tx_max.html">DbEnv::set_tx_max</a>, -<a href="../api_cxx/env_set_tx_recover.html">DbEnv::set_tx_recover</a>, <a href="../api_cxx/env_set_tx_timestamp.html">DbEnv::set_tx_timestamp</a>, -<a href="../api_cxx/txn_abort.html">DbTxn::abort</a>, <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>, <a href="../api_cxx/txn_checkpoint.html">DbEnv::txn_checkpoint</a>, +<a href="../api_cxx/txn_recover.html">DbEnv::txn_recover</a> +and +<a href="../api_cxx/txn_stat.html">DbEnv::txn_stat</a>. +<p> +<a href="../api_cxx/txn_abort.html">DbTxn::abort</a>, <a href="../api_cxx/txn_commit.html">DbTxn::commit</a>, <a href="../api_cxx/txn_discard.html">DbTxn::discard</a>, <a href="../api_cxx/txn_id.html">DbTxn::id</a>, -<a href="../api_cxx/txn_prepare.html">DbTxn::prepare</a>, -<a href="../api_cxx/txn_recover.html">DbEnv::txn_recover</a>, -<a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a> +<a href="../api_cxx/txn_prepare.html">DbTxn::prepare</a> and -<a href="../api_cxx/txn_stat.html">DbEnv::txn_stat</a>. +<a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_java/c_index.html b/db/docs/api_java/c_index.html index 2647f7042..73c9cbb1f 100644 --- a/db/docs/api_java/c_index.html +++ b/db/docs/api_java/c_index.html @@ -1,39 +1,47 @@ -<!--Id: c_index.so,v 10.80 2001/10/13 19:56:20 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: c_index.so,v 10.96 2002/07/24 05:06:08 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: Java Interface</title> +<title>Berkeley DB: Berkeley DB: Java Interface</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> <body bgcolor=white> -<h1 align=center>Java Interface</h1> +<h1 align=center>Berkeley DB: Java Interface</h1> <p><table border=1 align=center> <tr><th>Section</th><th>Class/Method</th><th>Description</th></tr> <tr><td><b>Database Environment</b></td><td><a href="../api_java/dbenv_class.html">DbEnv</a></td><td>Create an environment handle</td></tr> <tr><td><br></td><td><a href="../api_java/env_close.html">DbEnv.close</a></td><td>Close an environment</td></tr> +<tr><td><br></td><td><a href="../api_java/env_dbremove.html">DbEnv.dbremove</a></td><td>Remove a database</td></tr> +<tr><td><br></td><td><a href="../api_java/env_dbrename.html">DbEnv.dbrename</a></td><td>Rename a database</td></tr> +<tr><td><br></td><td><a href="../api_java/env_err.html">DbEnv.err</a></td><td>Error message with error string</td></tr> +<tr><td><br></td><td><a href="../api_java/env_err.html">DbEnv.errx</a></td><td>Error message</td></tr> <tr><td><br></td><td><a href="../api_java/env_open.html">DbEnv.open</a></td><td>Open an environment</td></tr> <tr><td><br></td><td><a href="../api_java/env_remove.html">DbEnv.remove</a></td><td>Remove an environment</td></tr> +<tr><td><br></td><td><a href="../api_java/env_strerror.html">DbEnv.strerror</a></td><td>Error strings</td></tr> +<tr><td><br></td><td><a href="../api_java/env_version.html">DbEnv.version</a></td><td>Return version information</td></tr> +<tr><td><b>Environment Configuration</b></td><td><a href="../api_java/env_set_app_dispatch.html">DbEnv.set_app_dispatch</a></td><td>Configure application recovery interface</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_data_dir.html">DbEnv.set_data_dir</a></td><td>Set the environment data directory</td></tr> +<tr><td><br></td><td><a href="../api_java/env_set_encrypt.html">DbEnv.set_encrypt</a></td><td>Set the environment cryptographic key</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_errcall.html">DbEnv.set_errcall</a></td><td>Set error message callback</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_error_stream.html">DbEnv.set_error_stream</a></td><td>Set error message output stream</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_errpfx.html">DbEnv.set_errpfx</a></td><td>Set error message prefix</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_feedback.html">DbEnv.set_feedback</a></td><td>Set feedback callback</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_flags.html">DbEnv.set_flags</a></td><td>Environment configuration</td></tr> -<tr><td><br></td><td><a href="../api_java/env_set_rec_init.html">DbEnv.set_recovery_init</a></td><td>Set recovery initialization callback</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_rpc_server.html">DbEnv.set_rpc_server</a></td><td>Establish an RPC server connection</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_shm_key.html">DbEnv.set_shm_key</a></td><td>Set system memory shared segment ID</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_tas_spins.html">DbEnv.set_tas_spins</a></td><td>Set the number of test-and-set spins</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_tmp_dir.html">DbEnv.set_tmp_dir</a></td><td>Set the environment temporary file directory</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_timeout.html">DbEnv.set_timeout</a></td><td>Set lock and transaction timeout</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_verbose.html">DbEnv.set_verbose</a></td><td>Set verbose messages</td></tr> -<tr><td><br></td><td><a href="../api_java/env_strerror.html">DbEnv.strerror</a></td><td>Error strings</td></tr> -<tr><td><br></td><td><a href="../api_java/env_version.html">DbEnv.version</a></td><td>Return version information</td></tr> <tr><td><b>Database Operations</b></td><td><a href="../api_java/db_class.html">Db</a></td><td>Create a database handle</td></tr> <tr><td><br></td><td><a href="../api_java/db_associate.html">Db.associate</a></td><td>Associate a secondary index</td></tr> <tr><td><br></td><td><a href="../api_java/db_close.html">Db.close</a></td><td>Close a database</td></tr> <tr><td><br></td><td><a href="../api_java/db_del.html">Db.del</a></td><td>Delete items from a database</td></tr> +<tr><td><br></td><td><a href="../api_java/db_err.html">Db.err</a></td><td>Error message with error string</td></tr> +<tr><td><br></td><td><a href="../api_java/db_err.html">Db.errx</a></td><td>Error message</td></tr> <tr><td><br></td><td><a href="../api_java/db_fd.html">Db.fd</a></td><td>Return a file descriptor from a database</td></tr> <tr><td><br></td><td><a href="../api_java/db_get.html">Db.get</a>, <a href="../api_java/db_get.html">Db.pget</a></td><td>Get items from a database</td></tr> <tr><td><br></td><td><a href="../api_java/db_get_byteswapped.html">Db.get_byteswapped</a></td><td>Return if the underlying database is in host order</td></tr> @@ -49,12 +57,15 @@ <tr><td><br></td><td><a href="../api_java/db_truncate.html">Db.truncate</a></td><td>Empty a database</td></tr> <tr><td><br></td><td><a href="../api_java/db_upgrade.html">Db.upgrade</a></td><td>Upgrade a database</td></tr> <tr><td><br></td><td><a href="../api_java/db_verify.html">Db.verify</a></td><td>Verify/salvage a database</td></tr> -<tr><td><b>Database Configuration</b></td><td><a href="../api_java/db_set_cachesize.html">Db.set_cachesize</a></td><td>Set the database cache size</td></tr> +<tr><td><b>Database Configuration</b></td><td><a href="../api_java/db_set_cache_priority.html">Db.set_cache_priority</a></td><td>Set the database cache priority</td></tr> +<tr><td><br></td><td><a href="../api_java/db_set_cachesize.html">Db.set_cachesize</a></td><td>Set the database cache size</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_dup_compare.html">Db.set_dup_compare</a></td><td>Set a duplicate comparison function</td></tr> +<tr><td><br></td><td><a href="../api_java/db_set_encrypt.html">Db.set_encrypt</a></td><td>Set the database cryptographic key</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_errcall.html">Db.set_errcall</a></td><td>Set error message callback</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_errpfx.html">Db.set_errpfx</a></td><td>Set error message prefix</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_feedback.html">Db.set_feedback</a></td><td>Set feedback callback</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_flags.html">Db.set_flags</a></td><td>General database configuration</td></tr> +<tr><td><br></td><td><a href="../api_java/db_set_lorder.html">Db.set_lorder</a></td><td>Set the database byte order</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_pagesize.html">Db.set_pagesize</a></td><td>Set the underlying database page size</td></tr> <tr><td><b>Btree/Recno Configuration</b></td><td><a href="../api_java/db_set_append_recno.html">Db.set_append_recno</a></td><td>Set record append callback</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_bt_compare.html">Db.set_bt_compare</a></td><td>Set a Btree comparison function</td></tr> @@ -67,7 +78,6 @@ <tr><td><b>Hash Configuration</b></td><td><a href="../api_java/db_set_h_ffactor.html">Db.set_h_ffactor</a></td><td>Set the Hash table density</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_h_hash.html">Db.set_h_hash</a></td><td>Set a hashing function</td></tr> <tr><td><br></td><td><a href="../api_java/db_set_h_nelem.html">Db.set_h_nelem</a></td><td>Set the Hash table size</td></tr> -<tr><td><br></td><td><a href="../api_java/db_set_lorder.html">Db.set_lorder</a></td><td>Set the database byte order</td></tr> <tr><td><b>Queue Configuration</b></td><td><a href="../api_java/db_set_q_extentsize.html">Db.set_q_extentsize</a></td><td>Set Queue database extent size</td></tr> <tr><td><b>Database Cursor Operations</b></td><td><a href="../api_java/dbc_class.html">Dbc</a></td><td><b>Cursor class</b></td></tr> <tr><td><br></td><td><a href="../api_java/db_cursor.html">Db.cursor</a></td><td>Create a cursor handle</td></tr> @@ -92,6 +102,7 @@ <tr><td><br></td><td><a href="../api_java/lock_id_free.html">DbEnv.lock_id_free</a></td><td>Release a locker ID</td></tr> <tr><td><br></td><td><a href="../api_java/lock_put.html">DbEnv.lock_put</a></td><td>Release a lock</td></tr> <tr><td><br></td><td><a href="../api_java/lock_stat.html">DbEnv.lock_stat</a></td><td>Return lock subsystem statistics</td></tr> +<tr><td><br></td><td><a href="../api_java/lock_vec.html">DbEnv.lock_vec</a></td><td>Acquire/release locks</td></tr> <tr><td><b>Log Subsystem</b></td><td><a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a></td><td>Set log buffer size</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a></td><td>Set the environment logging directory</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a></td><td>Set log file size</td></tr> @@ -100,22 +111,18 @@ <tr><td><br></td><td><a href="../api_java/log_file.html">DbEnv.log_file</a></td><td>Map Log Sequence Numbers to log files</td></tr> <tr><td><br></td><td><a href="../api_java/log_flush.html">DbEnv.log_flush</a></td><td>Flush log records</td></tr> <tr><td><br></td><td><a href="../api_java/log_put.html">DbEnv.log_put</a></td><td>Write a log record</td></tr> -<tr><td><br></td><td><a href="../api_java/log_register.html">DbEnv.log_register</a></td><td>Register a filename with the log manager</td></tr> <tr><td><br></td><td><a href="../api_java/log_stat.html">DbEnv.log_stat</a></td><td>Return log subsystem statistics</td></tr> -<tr><td><br></td><td><a href="../api_java/log_unregister.html">DbEnv.log_unregister</a></td><td>Unregister a filename with the log manager</td></tr> <tr><td><b>Log Cursor Operations</b></td><td><a href="../api_java/logc_class.html">DbLogc</a></td><td><b>Log cursor class</b></td></tr> <tr><td><br></td><td><a href="../api_java/log_cursor.html">DbEnv.log_cursor</a></td><td>Create a log cursor handle</td></tr> -<tr><td><br></td><td><a href="../api_java/logc_close.html">DbLogc.logc_close</a></td><td>Close a log cursor</td></tr> -<tr><td><br></td><td><a href="../api_java/logc_get.html">DbLogc.logc_get</a></td><td>Retrieve a log record</td></tr> +<tr><td><br></td><td><a href="../api_java/logc_close.html">DbLogc.close</a></td><td>Close a log cursor</td></tr> +<tr><td><br></td><td><a href="../api_java/logc_get.html">DbLogc.get</a></td><td>Retrieve a log record</td></tr> <tr><td><b>Log Sequence Numbers</b></td><td><a href="../api_java/lsn_class.html">DbLsn</a></td><td><br></td></tr> <tr><td><br></td><td><a href="../api_java/log_compare.html">DbEnv.log_compare</a></td><td>Compare two Log Sequence Numbers</td></tr> <tr><td><b>Memory Pool Subsystem</b></td><td><a href="../api_java/env_set_cachesize.html">DbEnv.set_cachesize</a></td><td>Set the environment cache size</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_mp_mmapsize.html">DbEnv.set_mp_mmapsize</a></td><td>Set maximum mapped-in database file size</td></tr> -<tr><td><br></td><td><a href="../api_java/memp_stat.html">DbEnv.memp_stat</a></td><td>Return memory pool statistics</td></tr> +<tr><td><br></td><td><a href="../api_java/memp_stat.html">DbEnv.memp_stat</a>, <a href="../api_java/memp_stat.html">DbEnv.memp_fstat</a></td><td>Return memory pool statistics</td></tr> <tr><td><br></td><td><a href="../api_java/memp_trickle.html">DbEnv.memp_trickle</a></td><td>Trickle flush pages from a memory pool</td></tr> -<tr><td><br></td><td><a href="../api_java/memp_stat.html">DbEnv.memp_fstat</a></td><td>Return memory pool statistics</td></tr> <tr><td><b>Transaction Subsystem</b></td><td><a href="../api_java/env_set_tx_max.html">DbEnv.set_tx_max</a></td><td>Set maximum number of transactions</td></tr> -<tr><td><br></td><td><a href="../api_java/env_set_tx_recover.html">DbEnv.set_tx_recover</a></td><td>Set transaction abort recover function</td></tr> <tr><td><br></td><td><a href="../api_java/env_set_tx_timestamp.html">DbEnv.set_tx_timestamp</a></td><td>Set recovery timestamp</td></tr> <tr><td><br></td><td><a href="../api_java/txn_checkpoint.html">DbEnv.txn_checkpoint</a></td><td>Checkpoint the transaction subsystem</td></tr> <tr><td><br></td><td><a href="../api_java/txn_recover.html">DbEnv.txn_recover</a></td><td>Distributed transaction recovery</td></tr> @@ -130,13 +137,15 @@ <tr><td><br></td><td><a href="../api_java/txn_set_timeout.html">DbTxn.set_timeout</a></td><td>Set transaction timeout</td></tr> <tr><td><b>Replication</b></td><td><a href="../api_java/rep_transport.html">DbEnv.set_rep_transport</a></td><td>Configure replication transport</td></tr> <tr><td><br></td><td><a href="../api_java/rep_elect.html">DbEnv.rep_elect</a></td><td>Hold a replication election</td></tr> +<tr><td><br></td><td><a href="../api_java/rep_limit.html">DbEnv.set_rep_limit</a></td><td>Limit data sent in response to a single message</td></tr> <tr><td><br></td><td><a href="../api_java/rep_message.html">DbEnv.rep_process_message</a></td><td>Process a replication message</td></tr> <tr><td><br></td><td><a href="../api_java/rep_start.html">DbEnv.rep_start</a></td><td>Configure an environment for replication</td></tr> +<tr><td><br></td><td><a href="../api_java/rep_stat.html">DbEnv.rep_stat</a></td><td>Replication statistics</td></tr> <tr><td><b>Exceptions</b></td><td><a href="../api_java/except_class.html">DbException</a></td><td><b>Exception Class for Berkeley DB Activity</b></td></tr> <tr><td><br></td><td><a href="../api_java/get_errno.html">DbException.get_errno</a></td><td>Get the error value</td></tr> <tr><td><br></td><td><a href="../api_java/deadlock_class.html">DbDeadlockException</a></td><td><b>Exception Class for deadlocks</b></td></tr> +<tr><td><br></td><td><a href="../api_java/lockng_class.html">DbLockNotGrantedException</a></td><td><b>Exception Class for lock request failures</b></td></tr> <tr><td><br></td><td><a href="../api_java/mem_class.html">DbMemoryException</a></td><td><b>Exception Class for insufficient memory</b></td></tr> -<tr><td><br></td><td><a href="../api_java/get_dbt.html">DbMemoryException.get_dbt</a></td><td>Get the failing Dbt</td></tr> <tr><td><br></td><td><a href="../api_java/runrec_class.html">DbRunRecoveryException</a></td><td><b>Exception Class for failures requiring recovery</b></td></tr> </table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> diff --git a/db/docs/api_java/dbt_bulk_class.html b/db/docs/api_java/dbt_bulk_class.html index 51bb116e6..e58524221 100644 --- a/db/docs/api_java/dbt_bulk_class.html +++ b/db/docs/api_java/dbt_bulk_class.html @@ -1,6 +1,7 @@ -<!--Id: dbt_bulk_class.so,v 1.2 2001/07/02 01:03:13 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: dbt_bulk_class.so,v 1.4 2002/06/27 19:35:20 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbMultipleDataIterator</title> diff --git a/db/docs/api_java/env_set_timeout.html b/db/docs/api_java/env_set_timeout.html index 809bfdd48..2657643c4 100644 --- a/db/docs/api_java/env_set_timeout.html +++ b/db/docs/api_java/env_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: env_set_timeout.so,v 10.3 2001/10/22 15:24:31 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: env_set_timeout.so,v 10.6 2002/06/24 14:49:21 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.set_timeout</title> @@ -59,42 +60,61 @@ detection is performed. <p>Timeout values specified for the database environment may be overridden on a per-lock or per-transaction basis. See <a href="../api_java/lock_vec.html">DbEnv.lock_vec</a> and <a href="../api_java/txn_set_timeout.html">DbTxn.set_timeout</a> for more information. -<p>The DbEnv.set_timeout interface may be used only to configure Berkeley DB before -the <a href="../api_java/env_open.html">DbEnv.open</a> interface is called. +<p>The DbEnv.set_timeout method configures a database environment, not only operations +performed using the specified <a href="../api_java/dbenv_class.html">DbEnv</a> handle. +<p>The DbEnv.set_timeout interface may be called at any time during the life of +the application. <p>The DbEnv.set_timeout method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> <p>The DbEnv.set_timeout method may fail and throw an exception encapsulating a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. -<p>Called after <a href="../api_java/env_open.html">DbEnv.open</a> was called. </dl> <p>The DbEnv.set_timeout method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.set_timeout method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.set_timeout method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_java/dbenv_class.html">DbEnv</a> <h1>See Also</h1> <a href="../api_java/env_close.html">DbEnv.close</a>, +<a href="../api_java/env_dbremove.html">DbEnv.dbremove</a>, +<a href="../api_java/env_dbrename.html">DbEnv.dbrename</a>, +<a href="../api_java/env_err.html">DbEnv.err</a>, +<a href="../api_java/env_err.html">DbEnv.errx</a>, <a href="../api_java/env_version.html">DbEnv.get_version_string</a>, <a href="../api_java/env_open.html">DbEnv.open</a>, <a href="../api_java/env_remove.html">DbEnv.remove</a>, +<a href="../api_java/env_set_app_dispatch.html">DbEnv.set_app_dispatch</a>, <a href="../api_java/env_set_cachesize.html">DbEnv.set_cachesize</a>, <a href="../api_java/env_set_data_dir.html">DbEnv.set_data_dir</a>, +<a href="../api_java/env_set_encrypt.html">DbEnv.set_encrypt</a>, <a href="../api_java/env_set_errcall.html">DbEnv.set_errcall</a>, <a href="../api_java/env_set_error_stream.html">DbEnv.set_error_stream</a>, <a href="../api_java/env_set_errpfx.html">DbEnv.set_errpfx</a>, <a href="../api_java/env_set_feedback.html">DbEnv.set_feedback</a>, <a href="../api_java/env_set_flags.html">DbEnv.set_flags</a>, -<a href="../api_java/env_set_rec_init.html">DbEnv.set_recovery_init</a>, +<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, +<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, +<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, +<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, +<a href="../api_java/env_set_lk_conflicts.html">DbEnv.set_lk_conflicts</a>, +<a href="../api_java/env_set_lk_detect.html">DbEnv.set_lk_detect</a>, +<a href="../api_java/env_set_lk_max_lockers.html">DbEnv.set_lk_max_lockers</a>, +<a href="../api_java/env_set_lk_max_locks.html">DbEnv.set_lk_max_locks</a>, +<a href="../api_java/env_set_lk_max_objects.html">DbEnv.set_lk_max_objects</a>, +<a href="../api_java/env_set_mp_mmapsize.html">DbEnv.set_mp_mmapsize</a>, <a href="../api_java/env_set_rpc_server.html">DbEnv.set_rpc_server</a>, <a href="../api_java/env_set_shm_key.html">DbEnv.set_shm_key</a>, <a href="../api_java/env_set_tas_spins.html">DbEnv.set_tas_spins</a>, -<a href="../api_java/env_set_tmp_dir.html">DbEnv.set_tmp_dir</a>, <a href="../api_java/env_set_timeout.html">DbEnv.set_timeout</a>, -<a href="../api_java/env_set_verbose.html">DbEnv.set_verbose</a>, -and <a href="../api_java/env_strerror.html">DbEnv.strerror</a>. +<a href="../api_java/env_set_tmp_dir.html">DbEnv.set_tmp_dir</a>, +<a href="../api_java/env_set_tx_max.html">DbEnv.set_tx_max</a>, +<a href="../api_java/env_set_tx_timestamp.html">DbEnv.set_tx_timestamp</a>, +<a href="../api_java/env_set_verbose.html">DbEnv.set_verbose</a> +and +<a href="../api_java/env_strerror.html">DbEnv.strerror</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_java/lock_id_free.html b/db/docs/api_java/lock_id_free.html index f275643a3..57b47f026 100644 --- a/db/docs/api_java/lock_id_free.html +++ b/db/docs/api_java/lock_id_free.html @@ -1,6 +1,7 @@ -<!--Id: lock_id_free.so,v 10.2 2001/10/22 15:24:32 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: lock_id_free.so,v 10.4 2002/06/24 14:49:23 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.lock_id_free</title> @@ -21,7 +22,7 @@ <h3><pre> import com.sleepycat.db.*; <p> -public int lock_id_free(int id) +public void lock_id_free(int id) throws DbException; </pre></h3> <h1>Description</h1> @@ -35,9 +36,9 @@ failure. <p>The locker ID is invalid or locks are still held by this locker ID. </dl> <p>The DbEnv.lock_id_free method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.lock_id_free method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.lock_id_free method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_java/dbenv_class.html">DbEnv</a>, <a href="../api_java/lock_class.html">DbLock</a> <h1>See Also</h1> @@ -50,7 +51,7 @@ will fail in the same way. <a href="../api_java/lock_get.html">DbEnv.lock_get</a>, <a href="../api_java/lock_id.html">DbEnv.lock_id</a>, <a href="../api_java/lock_id_free.html">DbEnv.lock_id_free</a>, -<a href="../api_java/lock_put.html">DbEnv.lock_put</a>, +<a href="../api_java/lock_put.html">DbEnv.lock_put</a> and <a href="../api_java/lock_stat.html">DbEnv.lock_stat</a>. </tt> diff --git a/db/docs/api_java/log_cursor.html b/db/docs/api_java/log_cursor.html index 6c3acd5f7..9542433af 100644 --- a/db/docs/api_java/log_cursor.html +++ b/db/docs/api_java/log_cursor.html @@ -1,6 +1,7 @@ -<!--Id: log_cursor.so,v 10.2 2001/10/22 15:24:33 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: log_cursor.so,v 10.3 2002/06/24 14:49:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.log_cursor</title> @@ -36,9 +37,9 @@ failure. <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DbEnv.log_cursor method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.log_cursor method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.log_cursor method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_java/db_class.html">Db</a> <h1>See Also</h1> @@ -46,20 +47,24 @@ will fail in the same way. <a href="../api_java/db_close.html">Db.close</a>, <a href="../api_java/db_cursor.html">Db.cursor</a>, <a href="../api_java/db_del.html">Db.del</a>, +<a href="../api_java/db_err.html">Db.err</a>, +<a href="../api_java/db_err.html">Db.errx</a>, <a href="../api_java/db_fd.html">Db.fd</a>, <a href="../api_java/db_get.html">Db.get</a>, -<a href="../api_java/db_get.html">Db.pget</a>, <a href="../api_java/db_get_byteswapped.html">Db.get_byteswapped</a>, <a href="../api_java/db_get_type.html">Db.get_type</a>, <a href="../api_java/db_join.html">Db.join</a>, <a href="../api_java/db_key_range.html">Db.key_range</a>, <a href="../api_java/db_open.html">Db.open</a>, +<a href="../api_java/db_get.html">Db.pget</a>, <a href="../api_java/db_put.html">Db.put</a>, <a href="../api_java/db_remove.html">Db.remove</a>, <a href="../api_java/db_rename.html">Db.rename</a>, <a href="../api_java/db_set_append_recno.html">Db.set_append_recno</a>, <a href="../api_java/db_set_bt_minkey.html">Db.set_bt_minkey</a>, +<a href="../api_java/db_set_cache_priority.html">Db.set_cache_priority</a>, <a href="../api_java/db_set_cachesize.html">Db.set_cachesize</a>, +<a href="../api_java/db_set_encrypt.html">Db.set_encrypt</a>, <a href="../api_java/db_set_errcall.html">Db.set_errcall</a>, <a href="../api_java/db_set_errpfx.html">Db.set_errpfx</a>, <a href="../api_java/db_set_feedback.html">Db.set_feedback</a>, @@ -76,7 +81,7 @@ will fail in the same way. <a href="../api_java/db_stat.html">Db.stat</a>, <a href="../api_java/db_sync.html">Db.sync</a>, <a href="../api_java/db_truncate.html">Db.truncate</a>, -<a href="../api_java/db_upgrade.html">Db.upgrade</a>, +<a href="../api_java/db_upgrade.html">Db.upgrade</a> and <a href="../api_java/db_verify.html">Db.verify</a>. </tt> diff --git a/db/docs/api_java/logc_class.html b/db/docs/api_java/logc_class.html index f079cb494..5cefe0f34 100644 --- a/db/docs/api_java/logc_class.html +++ b/db/docs/api_java/logc_class.html @@ -1,6 +1,7 @@ -<!--Id: logc_class.so,v 1.1 2001/09/28 15:09:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_class.so,v 1.3 2002/06/27 19:10:06 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbLogc</title> @@ -30,24 +31,24 @@ which provides cursor support for log files. sequential access to the records stored in log files. Cursors are created by calling the <a href="../api_java/log_cursor.html">DbEnv.log_cursor</a> method which returns a DbLogc object. <h1>Class</h1> -<a href="../api_java/dbenv_class.html">DbEnv</a> +<a href="../api_java/dbenv_class.html">DbEnv</a>, <a href="../api_java/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, -<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, -<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, -<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, <a href="../api_java/log_archive.html">DbEnv.log_archive</a>, -<a href="../api_java/log_compare.html">DbEnv.log_compare</a>, -<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, <a href="../api_java/log_file.html">DbEnv.log_file</a>, <a href="../api_java/log_flush.html">DbEnv.log_flush</a>, <a href="../api_java/log_put.html">DbEnv.log_put</a>, -<a href="../api_java/log_register.html">DbEnv.log_register</a>, <a href="../api_java/log_stat.html">DbEnv.log_stat</a>, -<a href="../api_java/log_unregister.html">DbEnv.log_unregister</a>, -<a href="../api_java/logc_close.html">DbLogc.logc_close</a> +<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, +<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, +<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, +<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, +and +<a href="../api_java/log_compare.html">DbEnv.log_compare</a>. +<p> +<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, +<a href="../api_java/logc_close.html">DbLogc.close</a> and -<a href="../api_java/logc_get.html">DbLogc.logc_get</a>. +<a href="../api_java/logc_get.html">DbLogc.get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_java/logc_close.html b/db/docs/api_java/logc_close.html index 90f13965c..cabdf6ebb 100644 --- a/db/docs/api_java/logc_close.html +++ b/db/docs/api_java/logc_close.html @@ -1,9 +1,10 @@ -<!--Id: logc_close.so,v 10.4 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_close.so,v 10.5 2002/06/24 14:49:25 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbLogc.logc_close</title> +<title>Berkeley DB: DbLogc.close</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> @@ -11,7 +12,7 @@ <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td> -<h1>DbLogc.logc_close</h1> +<h1>DbLogc.close</h1> </td> <td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> @@ -25,41 +26,41 @@ public void close(int flags) throws DbException; </pre></h3> <h1>Description</h1> -<p>The DbLogc.logc_close method discards the log cursor. After DbLogc.logc_close +<p>The DbLogc.close method discards the log cursor. After DbLogc.close has been called, regardless of its return, the cursor handle may not be used again. <p>The <b>flags</b> parameter is currently unused, and must be set to 0. -<p>The DbLogc.logc_close method throws an exception that encapsulates a non-zero error value on +<p>The DbLogc.close method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> -<p>The DbLogc.logc_close method may fail and throw an exception encapsulating a non-zero error for the following conditions: +<p>The DbLogc.close method may fail and throw an exception encapsulating a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. <p>The cursor was previously closed. </dl> -<p>The DbLogc.logc_close method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbLogc.logc_close method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +<p>The DbLogc.close method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. +If a catastrophic error has occurred, the DbLogc.close method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> -<a href="../api_java/dbenv_class.html">DbEnv</a> +<a href="../api_java/dbenv_class.html">DbEnv</a>, <a href="../api_java/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, -<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, -<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, -<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, <a href="../api_java/log_archive.html">DbEnv.log_archive</a>, -<a href="../api_java/log_compare.html">DbEnv.log_compare</a>, -<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, <a href="../api_java/log_file.html">DbEnv.log_file</a>, <a href="../api_java/log_flush.html">DbEnv.log_flush</a>, <a href="../api_java/log_put.html">DbEnv.log_put</a>, -<a href="../api_java/log_register.html">DbEnv.log_register</a>, <a href="../api_java/log_stat.html">DbEnv.log_stat</a>, -<a href="../api_java/log_unregister.html">DbEnv.log_unregister</a>, -<a href="../api_java/logc_close.html">DbLogc.logc_close</a> +<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, +<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, +<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, +<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, +and +<a href="../api_java/log_compare.html">DbEnv.log_compare</a>. +<p> +<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, +<a href="../api_java/logc_close.html">DbLogc.close</a> and -<a href="../api_java/logc_get.html">DbLogc.logc_get</a>. +<a href="../api_java/logc_get.html">DbLogc.get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_java/logc_get.html b/db/docs/api_java/logc_get.html index 0ae8791e1..c9288d3e3 100644 --- a/db/docs/api_java/logc_get.html +++ b/db/docs/api_java/logc_get.html @@ -1,9 +1,10 @@ -<!--Id: logc_get.so,v 10.31 2001/10/22 15:24:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logc_get.so,v 10.36 2002/07/01 16:52:26 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbLogc.logc_get</title> +<title>Berkeley DB: DbLogc.get</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++"> </head> @@ -11,7 +12,7 @@ <a name="2"><!--meow--></a> <table width="100%"><tr valign=top> <td> -<h1>DbLogc.logc_get</h1> +<h1>DbLogc.get</h1> </td> <td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> @@ -25,7 +26,7 @@ public int get(DbLsn lsn, Dbt data, int flags) throws DbException; </pre></h3> <h1>Description</h1> -<p>The DbLogc.logc_get method retrieve records from the log according to the +<p>The DbLogc.get method retrieve records from the log according to the <b>lsn</b> and <b>flags</b> arguments. <p>The data field of the <b>data</b> structure is set to the record retrieved, and the size field indicates the number of bytes in the @@ -35,44 +36,41 @@ record. See <a href="../api_java/dbt_class.html">Dbt</a> for a description of o for any <a href="../api_java/dbt_class.html">Dbt</a> used for data retrieval. <p>The <b>flags</b> value must be set to one of the following values: <p><dl compact> -<p><dt><a name="Db.DB_CHECKPOINT">Db.DB_CHECKPOINT</a><dd>The last record written with the DB_CHECKPOINT flag specified to the -<a href="../api_java/log_put.html">DbEnv.log_put</a> method is returned in the <b>data</b> argument. The -<b>lsn</b> argument is overwritten with the <a href="../api_java/lsn_class.html">DbLsn</a> of the record -returned. If no record has been previously written with the DB_CHECKPOINT -flag specified, the first record in the log is returned. -<p>If the log is empty, the DbLogc.logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">Db.DB_NOTFOUND</a>. <p><dt><a name="Db.DB_FIRST">Db.DB_FIRST</a><dd>The first record from any of the log files found in the log directory is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_java/lsn_class.html">DbLsn</a> of the record returned. -<p>If the log is empty, the DbLogc.logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">Db.DB_NOTFOUND</a>. +<p> +If the log is empty, the DbLogc.get method will return Db.DB_NOTFOUND. <p><dt><a name="Db.DB_LAST">Db.DB_LAST</a><dd>The last record in the log is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_java/lsn_class.html">DbLsn</a> of the record returned. -<p>If the log is empty, the DbLogc.logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">Db.DB_NOTFOUND</a>. +<p> +If the log is empty, the DbLogc.get method will return Db.DB_NOTFOUND. <p><dt><a name="Db.DB_NEXT">Db.DB_NEXT</a>, <a name="Db.DB_PREV">Db.DB_PREV</a><dd>The current log position is advanced to the next (previous) record in the log, and that record is returned in the <b>data</b> argument. The <b>lsn</b> argument is overwritten with the <a href="../api_java/lsn_class.html">DbLsn</a> of the record returned. -<p>If the pointer has not been initialized via DB_FIRST, DB_LAST, DB_SET, -DB_NEXT, or DB_PREV, DbLogc.logc_get will return the first (last) record -in the log. If the last (first) log record has already been returned -or the log is empty, the DbLogc.logc_get method will return <a href="../ref/program/errorret.html#DB_NOTFOUND">Db.DB_NOTFOUND</a>. -<p>If the log was opened with the DB_THREAD flag set, calls to -DbLogc.logc_get with the DB_NEXT (DB_PREV) flag set will return -EINVAL. +<p>If the cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, +DB_NEXT, or DB_PREV, DbLogc.get will return the first (last) record +in the log. +If the last (first) log record has already been returned or the log is +empty, the DbLogc.get method will return Db.DB_NOTFOUND. +If the log was opened with the DB_THREAD flag set, calls to +DbLogc.get with the DB_NEXT (DB_PREV) flag set, the DbLogc.get method throws an exception that encapsulates Db.EINVAL. <p><dt><a name="Db.DB_CURRENT">Db.DB_CURRENT</a><dd>Return the log record to which the log currently refers. -<p>If the log pointer has not been initialized via DB_FIRST, DB_LAST, +If the log cursor has not been initialized via DB_FIRST, DB_LAST, DB_SET, DB_NEXT, or DB_PREV, or if the log was opened with the DB_THREAD -flag set, DbLogc.logc_get will return EINVAL. -<p><dt><a name="Db.DB_SET">Db.DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. If the -specified <a href="../api_java/lsn_class.html">DbLsn</a> is invalid (for example, it does not appear in -the log) DbLogc.logc_get will return EINVAL. +flag set, the DbLogc.get method throws an exception that encapsulates Db.EINVAL. +<p><dt><a name="Db.DB_SET">Db.DB_SET</a><dd>Retrieve the record specified by the <b>lsn</b> argument. +If the specified <a href="../api_java/lsn_class.html">DbLsn</a> is invalid (for example, it does not +appear in the log), the DbLogc.get method throws an exception that encapsulates Db.EINVAL. </dl> -<p>Otherwise, the DbLogc.logc_get method throws an exception that encapsulates a non-zero error value on +<p> +Otherwise, the DbLogc.get method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> -<p>The DbLogc.logc_get method may fail and throw an exception encapsulating a non-zero error for the following conditions: +<p>The DbLogc.get method may fail and throw an exception encapsulating a non-zero error for the following conditions: <p><dl compact> <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. <p>The DB_CURRENT flag was set and the log pointer had not yet been @@ -80,29 +78,29 @@ initialized. <p>The DB_SET flag was set and the specified log sequence number does not exist. </dl> -<p>The DbLogc.logc_get method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbLogc.logc_get method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +<p>The DbLogc.get method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. +If a catastrophic error has occurred, the DbLogc.get method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> -<a href="../api_java/dbenv_class.html">DbEnv</a> +<a href="../api_java/dbenv_class.html">DbEnv</a>, <a href="../api_java/logc_class.html">DbLogc</a> <h1>See Also</h1> -<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, -<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, -<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, -<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, <a href="../api_java/log_archive.html">DbEnv.log_archive</a>, -<a href="../api_java/log_compare.html">DbEnv.log_compare</a>, -<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, <a href="../api_java/log_file.html">DbEnv.log_file</a>, <a href="../api_java/log_flush.html">DbEnv.log_flush</a>, <a href="../api_java/log_put.html">DbEnv.log_put</a>, -<a href="../api_java/log_register.html">DbEnv.log_register</a>, <a href="../api_java/log_stat.html">DbEnv.log_stat</a>, -<a href="../api_java/log_unregister.html">DbEnv.log_unregister</a>, -<a href="../api_java/logc_close.html">DbLogc.logc_close</a> +<a href="../api_java/env_set_lg_bsize.html">DbEnv.set_lg_bsize</a>, +<a href="../api_java/env_set_lg_dir.html">DbEnv.set_lg_dir</a>, +<a href="../api_java/env_set_lg_max.html">DbEnv.set_lg_max</a>, +<a href="../api_java/env_set_lg_regionmax.html">DbEnv.set_lg_regionmax</a>, +and +<a href="../api_java/log_compare.html">DbEnv.log_compare</a>. +<p> +<a href="../api_java/log_cursor.html">DbEnv.log_cursor</a>, +<a href="../api_java/logc_close.html">DbLogc.close</a> and -<a href="../api_java/logc_get.html">DbLogc.logc_get</a>. +<a href="../api_java/logc_get.html">DbLogc.get</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/api_java/rep_elect.html b/db/docs/api_java/rep_elect.html index 6d68a98fd..d68435a9c 100644 --- a/db/docs/api_java/rep_elect.html +++ b/db/docs/api_java/rep_elect.html @@ -1,6 +1,7 @@ -<!--Id: rep_elect.so,v 1.4 2001/10/26 13:57:00 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_elect.so,v 1.6 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.rep_elect</title> @@ -21,8 +22,7 @@ <h3><pre> import com.sleepycat.db.*; <p> -public int rep_elect(int nsites, - int priority, int timeout, int *envid); +public int rep_elect(int nsites, int pri, int timeout); throws DbException; </pre></h3> <h1>Description</h1> @@ -65,13 +65,13 @@ failure. <p><dt>DB_REP_UNAVAIL<dd>The replication group was unable to elect a master. </dl> <p>The DbEnv.rep_elect method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.rep_elect method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.rep_elect method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_java/rep_start.html">DbEnv.rep_start</a>, <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>, -<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a>, +<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a> and <a href="../api_java/rep_transport.html">DbEnv.set_rep_transport</a>. </tt> diff --git a/db/docs/api_java/rep_message.html b/db/docs/api_java/rep_message.html index 8c553b309..c127df371 100644 --- a/db/docs/api_java/rep_message.html +++ b/db/docs/api_java/rep_message.html @@ -1,6 +1,7 @@ -<!--Id: rep_message.so,v 1.4 2001/10/25 20:15:23 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_message.so,v 1.9 2002/07/02 15:22:24 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.rep_process_message</title> @@ -21,7 +22,11 @@ <h3><pre> import com.sleepycat.db.*; <p> -public void rep_process_message(Dbt *control, Dbt *rec, int *envid) +public static class RepProcessMessage { + public int envid; +} +public int rep_process_message( + Dbt control, Dbt rec, DbEnv.RepProcessMessage envid) throws DbException; </pre></h3> <h1>Description</h1> @@ -39,38 +44,44 @@ information). processed using the same <a href="../api_java/dbenv_class.html">DbEnv</a> handle. It is not required that a single thread of control process all messages, only that all threads of control processing messages use the same handle. -<p>The DbEnv.rep_process_message method may return one of several special conditions: -<p><dl compact> -<p><dt><a name="Db.DB_REP_DUPMASTER">Db.DB_REP_DUPMASTER</a><dd>The replication group has more than one master; the application should -reconfigure itself as a client by calling the <a href="../api_java/rep_start.html">DbEnv.rep_start</a> method, and -then call for an election by calling <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>. -<p><dt><a name="Db.DB_REP_HOLDELECTION">Db.DB_REP_HOLDELECTION</a><dd>An election is needed, the application should call for an election by -calling <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>. -<p><dt><a name="Db.DB_REP_NEWMASTER">Db.DB_REP_NEWMASTER</a><dd>A new master has been elected. The memory location referenced by the -<b>envid</b> parameter contains the environment ID of the new master. -If the recipient of this error return has been made master, it is the -application's responsibility to begin acting as the master environment. -<p><dt><a name="Db.DB_REP_NEWSITE">Db.DB_REP_NEWSITE</a><dd>The system received contact information from a new environment. The -<b>rec</b> parameter contains the opaque data specified in the +<p> +If a new master has been elected, the DbEnv.rep_process_message method will return Db.DB_REP_NEWMASTER. +The <b>envid</b> parameter contains the environment ID of the new +master. If the recipient of this error return has been made master, it +is the application's responsibility to begin acting as the master +environment. +<p> +If the system received contact information from a new environment, the DbEnv.rep_process_message method will return Db.DB_REP_NEWSITE. +The <b>rec</b> parameter contains the opaque data specified in the <b>cdata</b> parameter to the <a href="../api_java/rep_start.html">DbEnv.rep_start</a>. The application should take whatever action is needed to establish a communication channel with this new environment. -<p><dt><a name="Db.DB_REP_OUTDATED">Db.DB_REP_OUTDATED</a><dd>The current environment's logs are too far out of date with respect to -the master to be automatically synchronized. The application should -copy over a hot backup of the environment, run recovery, and restart -the client. -</dl> -<p>Otherwise, the DbEnv.rep_process_message method throws an exception that encapsulates a non-zero error value on +<p> +If the replication group has more than one master, the DbEnv.rep_process_message method throws an exception that encapsulates Db.DB_REP_DUPMASTER. +The application should reconfigure itself as a client by calling the +<a href="../api_java/rep_start.html">DbEnv.rep_start</a> method, and then call for an election by calling +<a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>. +<p> +If an election is needed, the DbEnv.rep_process_message method throws an exception that encapsulates Db.DB_REP_HOLDELECTION. +The application should call for an election by +calling <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>. +<p> +If the current environment's logs are too far out of date with respect +to the master to be automatically synchronized, the DbEnv.rep_process_message method throws an exception that encapsulates Db.DB_REP_OUTDATED. The +application should copy over a hot backup of the environment, run +recovery, and restart the client. +<p> +Otherwise, the DbEnv.rep_process_message method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> <p>The DbEnv.rep_process_message method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.rep_process_message method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.rep_process_message method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_java/rep_start.html">DbEnv.rep_start</a>, <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>, -<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a>, +<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a> and <a href="../api_java/rep_transport.html">DbEnv.set_rep_transport</a>. </tt> diff --git a/db/docs/api_java/rep_start.html b/db/docs/api_java/rep_start.html index a3c0f3750..f0d5e3273 100644 --- a/db/docs/api_java/rep_start.html +++ b/db/docs/api_java/rep_start.html @@ -1,6 +1,7 @@ -<!--Id: rep_start.so,v 1.2 2001/10/25 14:08:43 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_start.so,v 1.3 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.rep_start</title> @@ -57,13 +58,13 @@ replication group by a call to <a href="../api_java/rep_transport.html">DbEnv.se <p>The environment was not already opened. </dl> <p>The DbEnv.rep_start method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.rep_start method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.rep_start method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_java/rep_start.html">DbEnv.rep_start</a>, <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>, -<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a>, +<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a> and <a href="../api_java/rep_transport.html">DbEnv.set_rep_transport</a>. </tt> diff --git a/db/docs/api_java/rep_transport.html b/db/docs/api_java/rep_transport.html index f27039c86..0b263947a 100644 --- a/db/docs/api_java/rep_transport.html +++ b/db/docs/api_java/rep_transport.html @@ -1,6 +1,7 @@ -<!--Id: rep_transport.so,v 1.4 2001/10/26 23:51:06 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: rep_transport.so,v 1.7 2002/06/24 14:49:30 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbEnv.set_rep_transport</title> @@ -58,7 +59,7 @@ The special identifier Db.DB_EID_BROADCAST indicates that a message should be broadcast to every environment in the replication group. The application may use a true broadcast protocol, or may send the message in sequence to each machine with which it is in communication. -<p><dt>flag<dd> +<p><dt>flags<dd> <p>The <b>flags</b> value must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <p><dl compact> @@ -77,18 +78,22 @@ otherwise, any error from the <b>send</b> interface will be ignored. <p>It may sometimes be useful to pass application-specific data to the <b>send</b> interface; see <a href="../ref/env/faq.html">Environment FAQ</a> for a discussion on how to do this. -<p>The <b>flags</b> parameter is currently unused, and must be set to 0. +<p>The DbEnv.set_rep_transport method configures operations performed using the specified +<a href="../api_java/dbenv_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment. +<p>The DbEnv.set_rep_transport interface may be called at any time during the life of +the application. <p>The DbEnv.set_rep_transport method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> <p>The DbEnv.set_rep_transport method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbEnv.set_rep_transport method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbEnv.set_rep_transport method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>See Also</h1> <a href="../api_java/rep_start.html">DbEnv.rep_start</a>, <a href="../api_java/rep_elect.html">DbEnv.rep_elect</a>, -<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a>, +<a href="../api_java/rep_message.html">DbEnv.rep_process_message</a> and <a href="../api_java/rep_transport.html">DbEnv.set_rep_transport</a>. </tt> diff --git a/db/docs/api_java/txn_set_timeout.html b/db/docs/api_java/txn_set_timeout.html index 78a1df76d..5b44a390b 100644 --- a/db/docs/api_java/txn_set_timeout.html +++ b/db/docs/api_java/txn_set_timeout.html @@ -1,6 +1,7 @@ -<!--Id: txn_set_timeout.so,v 10.3 2001/10/22 15:24:39 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: txn_set_timeout.so,v 10.6 2002/06/24 14:49:36 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB: DbTxn.set_timeout</title> @@ -21,7 +22,7 @@ <h3><pre> import com.sleepycat.db.*; <p> -public int set_timeout(long timeout, int flags) +public void set_timeout(long timeout, int flags) throws DbException; </pre></h3> <h1>Description</h1> @@ -46,6 +47,11 @@ is performed, the accuracy of the timeout depends on how often deadlock detection is performed. <p>Timeout values may be specified for the database environment as a whole. See <a href="../api_java/env_set_timeout.html">DbEnv.set_timeout</a> and for more information. +<p>The DbTxn.set_timeout method configures operations performed on the underlying +transaction, not only operations performed using the specified +<a href="../api_java/txn_class.html">DbTxn</a> handle. +<p>The DbTxn.set_timeout interface may be called at any time during the life of +the application. <p>The DbTxn.set_timeout method throws an exception that encapsulates a non-zero error value on failure. <h1>Errors</h1> @@ -54,25 +60,27 @@ failure. <p><dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <p>The DbTxn.set_timeout method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. -If a catastrophic error has occurred, the DbTxn.set_timeout method may fail and throw -a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, in which case all subsequent Berkeley DB calls -will fail in the same way. +If a catastrophic error has occurred, the DbTxn.set_timeout method may fail and +throw a <a href="../api_java/runrec_class.html">DbRunRecoveryException</a>, +in which case all subsequent Berkeley DB calls will fail in the same way. <h1>Class</h1> <a href="../api_java/dbenv_class.html">DbEnv</a>, <a href="../api_java/txn_class.html">DbTxn</a> <h1>See Also</h1> <a href="../api_java/env_set_tx_max.html">DbEnv.set_tx_max</a>, <a href="../api_java/env_set_tx_timestamp.html">DbEnv.set_tx_timestamp</a>, -<a href="../api_java/txn_abort.html">DbTxn.abort</a>, <a href="../api_java/txn_begin.html">DbEnv.txn_begin</a>, <a href="../api_java/txn_checkpoint.html">DbEnv.txn_checkpoint</a>, +<a href="../api_java/txn_recover.html">DbEnv.txn_recover</a> +and +<a href="../api_java/txn_stat.html">DbEnv.txn_stat</a>. +<p> +<a href="../api_java/txn_abort.html">DbTxn.abort</a>, <a href="../api_java/txn_commit.html">DbTxn.commit</a>, <a href="../api_java/txn_discard.html">DbTxn.discard</a>, <a href="../api_java/txn_id.html">DbTxn.id</a>, -<a href="../api_java/txn_prepare.html">DbTxn.prepare</a>, -<a href="../api_java/txn_recover.html">DbEnv.txn_recover</a>, -<a href="../api_java/txn_set_timeout.html">DbTxn.set_timeout</a> +<a href="../api_java/txn_prepare.html">DbTxn.prepare</a> and -<a href="../api_java/txn_stat.html">DbEnv.txn_stat</a>. +<a href="../api_java/txn_set_timeout.html">DbTxn.set_timeout</a>. </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a> diff --git a/db/docs/ref/am_misc/get_bulk.html b/db/docs/ref/am_misc/get_bulk.html index 267b8e88c..eb340ae3b 100644 --- a/db/docs/ref/am_misc/get_bulk.html +++ b/db/docs/ref/am_misc/get_bulk.html @@ -1,6 +1,7 @@ -<!--Id: get_bulk.so,v 10.2 2001/05/30 14:54:37 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: get_bulk.so,v 10.3 2002/06/24 14:50:33 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Retrieving records in bulk</title> diff --git a/db/docs/ref/build_unix/macosx.html b/db/docs/ref/build_unix/macosx.html index 783a41140..202d5191e 100644 --- a/db/docs/ref/build_unix/macosx.html +++ b/db/docs/ref/build_unix/macosx.html @@ -1,6 +1,7 @@ -<!--Id: macosx.so,v 11.1 2001/09/21 16:23:52 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: macosx.so,v 11.4 2002/06/20 14:43:40 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Mac OS X</title> @@ -16,10 +17,16 @@ <p> <h1 align=center>Mac OS X</h1> <p><ol> -<p><li><b>I can't use the Berkeley DB Tcl and Java APIs on Mac OS X.</b> +<p><li><b>I can't use the Java API on Mac OS X.</b> <p>The Berkeley DB configuration and build procedure is unable to dynamically -load libraries on Mac OS X. This restriction is expected to be removed -in future Berkeley DB releases. +load some libraries on Mac OS X. This restriction is expected to be +removed in future Berkeley DB releases. +<p>There is a workaround for Java. Mac OS X normally requires Java +loadable libraries to end with a .jnilib extension. Libtool, used by +our build procedure, does not support this extension. To work around +this, you must add a -D option to your Java command line to specify the +complete pathname of the installed library: +<p><blockquote><pre>% java -Dsleepycat.db.libfile=/full/path/to/libdb_java-VERSION.so</pre></blockquote> </ol> <table width="100%"><tr><td><br></td><td align=right><a href="../../ref/build_unix/linux.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/build_unix/osf1.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> diff --git a/db/docs/ref/build_vxworks/introae.html b/db/docs/ref/build_vxworks/introae.html index 34b24671e..b0a8b8b70 100644 --- a/db/docs/ref/build_vxworks/introae.html +++ b/db/docs/ref/build_vxworks/introae.html @@ -1,6 +1,7 @@ -<!--Id: introae.so,v 1.4 2001/11/05 21:05:19 sue Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: introae.so,v 1.6 2002/03/26 15:20:29 sue Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Building for VxWorks AE</title> @@ -25,7 +26,7 @@ all component files are named <i>component.wpj</i>. <p><table border=1 align=center> <tr><th>File</th><th>Description</th></tr> <tr> <td align=left>Berkeley DB/</td> <td align=left>Berkeley DB component directory</td> </tr> -<tr> <td align=left>demo/demo</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Demo program</a> component directory</td> </tr> +<tr> <td align=left>dbdemo/dbdemo</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Demo program</a> component directory</td> </tr> <tr> <td align=left>db_*/db_*</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Support utilities</a> component directories</td> </tr> </table> <h3>Building With Tornado 3.1</h3> @@ -114,9 +115,6 @@ macro, which is the Berkeley DB subdirectory of <i>build_vxworks</i>. Then, click OK. The typical addition of include directories will look like: <p><blockquote><pre>-I$(PRJ_DIR)/.. -I$(PRJ_DIR)/../../include -I$(PRJ_DIR)/../../include_auto</pre></blockquote> -<p>If the architecture for this new build has the most significant byte -first, you also need to edit the <i>db_config.h</i> file in the -build directory and define <b>WORDS_BIGENDIAN</b>. <p>To build and download the Berkeley DB downloadable application for the first time requires several steps: <p><ol> diff --git a/db/docs/ref/lock/timeout.html b/db/docs/ref/lock/timeout.html index 063f9fce2..a6da96ca6 100644 --- a/db/docs/ref/lock/timeout.html +++ b/db/docs/ref/lock/timeout.html @@ -1,6 +1,7 @@ -<!--Id: timeout.so,v 1.1 2001/08/18 17:05:29 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: timeout.so,v 1.2 2002/06/01 23:42:12 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Deadlock detection using timers</title> @@ -11,7 +12,7 @@ <a name="2"><!--meow--></a><a name="3"><!--meow--></a> <table width="100%"><tr valign=top> <td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Locking Subsystem</dl></h3></td> -<td align=right><a href="../../ref/lock/dead.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/lock/page.html"><img src="../../images/next.gif" alt="Next"></a> +<td align=right><a href="../../ref/lock/dead.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/lock/deaddbg.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p> <h1 align=center>Deadlock detection using timers</h1> @@ -51,7 +52,7 @@ out if it blocks waiting for a lock after 8ms. By default, any lock request in this system will be timed out if it blocks longer than 10ms, and the specific lock described will be timed out if it blocks longer than 4ms. -<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/lock/dead.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/lock/page.html"><img src="../../images/next.gif" alt="Next"></a> +<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/lock/dead.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/lock/deaddbg.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> </body> diff --git a/db/docs/ref/rep/app.html b/db/docs/ref/rep/app.html index abc26fdd0..cb05fc5a6 100644 --- a/db/docs/ref/rep/app.html +++ b/db/docs/ref/rep/app.html @@ -1,6 +1,7 @@ -<!--Id: app.so,v 1.3 2001/10/25 21:17:51 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: app.so,v 1.5 2002/07/13 18:09:09 margo Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Building replicated applications</title> @@ -16,10 +17,11 @@ <h1 align=center>Building replicated applications</h1> <p>The simplest way to build a replicated Berkeley DB application is to first build (and debug!) the transactional version of the same application. -Then, add a thin replication layer to the application. Highly available +Then, add a thin replication layer to the application. All highly available applications use the following additional four Berkeley DB methods: <a href="../../api_c/rep_elect.html">DB_ENV->rep_elect</a>, <a href="../../api_c/rep_message.html">DB_ENV->rep_process_message</a>, <a href="../../api_c/rep_start.html">DB_ENV->rep_start</a> and -<a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a>: +<a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> and may also use the configuration method +<a href="../../api_c/rep_limit.html">DB_ENV->set_rep_limit</a>: <p><dl compact> <p><dt><a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a><dd>The <a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> function configures the replication system's communications infrastructure. @@ -34,13 +36,14 @@ protocol for dealing with lost messages), and permitting new clients to join an active replication group. <p><dt><a href="../../api_c/rep_elect.html">DB_ENV->rep_elect</a><dd>The <a href="../../api_c/rep_elect.html">DB_ENV->rep_elect</a> function causes the replication group to elect a new master; it is called whenever contact with the master is lost. +<p><dt><a href="../../api_c/rep_limit.html">DB_ENV->set_rep_limit</a><dd>The <a href="../../api_c/rep_limit.html">DB_ENV->set_rep_limit</a> imposes an upper bound on the amount of data +that will be sent in response to a single call to <a href="../../api_c/rep_message.html">DB_ENV->rep_process_message</a>. </dl> <p>To add replication to a Berkeley DB application, application initialization -must be changed, and some new code, the application's communications -infrastructure, must be written. The application initialization changes -are relatively simple, but the communications infrastructure code is -fairly complex. -<p>During application initialization, the application must perform two +must be changed and the application's communications infrastructure must +be written. The application initialization changes are relatively +simple, but the communications infrastructure code can be complex. +<p>During application initialization, the application performs two additional tasks: first, it must provide Berkeley DB information about its communications infrastructure, and second, it must start the Berkeley DB replication system. Generally, a replicated application will do normal @@ -58,6 +61,20 @@ application. master, or the declaration of the local environment as the master. If a master has not been discovered after a reasonable amount of time, the application should call <a href="../../api_c/rep_elect.html">DB_ENV->rep_elect</a> to call for an election. +<p>In the case of multiple processes accessing a replicated environment, +all of the threads of control expecting to modify databases in the +environment or process replication messages must call the +<a href="../../api_c/rep_start.html">DB_ENV->rep_start</a> function. Note that not all processes running in replicated +environments need to call <a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> or <a href="../../api_c/rep_start.html">DB_ENV->rep_start</a>. +Read-only processes running in a master environment do not need to be +configured for replication in any way. Processes running in a client +environment are read-only by definition, and so do not need to be +configured for replication either (although, in the case of clients that +may become masters, it is usually simplest to configure for replication +on process startup rather than trying to reconfigure when the client +becomes a master). Obviously, at least one thread of control on each +client must be configured for replication as messages must be passed +between the master and the client. <p>Databases are generally opened read-write on both clients and masters in order to simplify upgrading replication clients to be masters. (If databases are opened read-only on clients, and the client is then diff --git a/db/docs/ref/rep/comm.html b/db/docs/ref/rep/comm.html index d7f550b7f..26a47734f 100644 --- a/db/docs/ref/rep/comm.html +++ b/db/docs/ref/rep/comm.html @@ -1,6 +1,7 @@ -<!--Id: comm.so,v 1.3 2001/10/25 20:05:34 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: comm.so,v 1.4 2002/05/09 20:38:15 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Building the communications infrastructure</title> @@ -14,7 +15,7 @@ </td></tr></table> <p> <h1 align=center>Building the communications infrastructure</h1> -<p>The replication portion of an application is typically written with one +<p>The replication support in an application is typically written with one or more threads of control looping on one or more communication channels, receiving and sending messages. These threads accept messages from remote environments for the local database environment, and accept @@ -23,8 +24,9 @@ from remote environments are passed to the local database environment using the <a href="../../api_c/rep_message.html">DB_ENV->rep_process_message</a> function. Messages from the local environment are passed to the application for transmission using the callback interface specified to the <a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> function. -<p>Both clients and servers establish communication channels by calling -the <a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> function. This method specifies the <b>send</b> +<p>Processes establish communication channels by calling the +<a href="../../api_c/rep_transport.html">DB_ENV->set_rep_transport</a> function, regardless of whether they are running in client +or server environments. This method specifies the <b>send</b> interface, a callback interface used by Berkeley DB for sending messages to other database environments in the replication group. The <b>send</b> interface takes an environment ID and two opaque data objects. It is diff --git a/db/docs/ref/rep/elect.html b/db/docs/ref/rep/elect.html index c0b2ed9ac..a811d4fd1 100644 --- a/db/docs/ref/rep/elect.html +++ b/db/docs/ref/rep/elect.html @@ -1,6 +1,7 @@ <!--Id: elect.so,v 1.5 2001/10/25 21:20:01 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Elections</title> diff --git a/db/docs/ref/rep/ex.html b/db/docs/ref/rep/ex.html index d0e38e0f5..b9f89921c 100644 --- a/db/docs/ref/rep/ex.html +++ b/db/docs/ref/rep/ex.html @@ -1,6 +1,7 @@ -<!--Id: ex.so,v 1.3 2001/11/18 15:17:22 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: ex.so,v 1.4 2002/06/24 14:50:47 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Ex_repquote: a replication example</title> diff --git a/db/docs/ref/rep/ex_comm.html b/db/docs/ref/rep/ex_comm.html index 2e41aeb72..bc0f2dcc0 100644 --- a/db/docs/ref/rep/ex_comm.html +++ b/db/docs/ref/rep/ex_comm.html @@ -1,6 +1,7 @@ -<!--Id: ex_comm.so,v 1.5 2001/11/18 15:32:21 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: ex_comm.so,v 1.6 2002/06/24 14:50:48 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Ex_repquote: a TCP/IP based communication infrastructure</title> @@ -76,7 +77,7 @@ quote_send(dbenv, control, rec, eid, flags) <p> machtab = (machtab_t *)dbenv->app_private; <p> - /* + /* * If this is a broadcast, call a separate function to * iterate through the table of environment (a/k/a * machine) IDs and call quote_send_one on each. @@ -113,7 +114,7 @@ quote_send(dbenv, control, rec, eid, flags) return (ret); } <p> -static int +int quote_send_broadcast(machtab, rec, control, flags) machtab_t *machtab; const DBT *rec, *control; diff --git a/db/docs/ref/rep/ex_rq.html b/db/docs/ref/rep/ex_rq.html index 84d0e83ba..6d83e98aa 100644 --- a/db/docs/ref/rep/ex_rq.html +++ b/db/docs/ref/rep/ex_rq.html @@ -1,6 +1,7 @@ -<!--Id: ex_rq.so,v 1.3 2001/11/18 15:17:23 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: ex_rq.so,v 1.4 2002/06/24 14:50:48 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Ex_repquote: putting it all together</title> @@ -53,7 +54,7 @@ addition to the normal functionality of any database application). infrastructure is initialized, the application signals that it is ready for replication and joins a replication group by calling <a href="../../api_c/rep_start.html">DB_ENV->rep_start</a>: -<pre><p><blockquote>if (whoami == MASTER) { +<pre><p><blockquote>if (whoami == MASTER) { if ((ret = dbenv->rep_start(dbenv, NULL, DB_REP_MASTER)) != 0) { /* Complain and exit on error. */ } @@ -94,7 +95,7 @@ DBT rec, control; /* Structures encapsulating a received message. */ elect_args *ea; /* Parameters to the elect thread. */ machtab_t *tab; /* The environment ID to fd mapping table. */ pthread_t elect_thr; /* Election thread spawned. */ -site_t self; /* My host and port identification. */ +repsite_t self; /* My host and port identification. */ int eid; /* Environment from whom I am receiving messages. */ int fd; /* FD on which I am receiving messages. */ int master_eid; /* Global indicating the current master eid. */ @@ -136,8 +137,8 @@ for (ret = 0; ret == 0;) { break; <p> master_eid = DB_EID_INVALID; - /* - * In ex_repquote, the environment ID table stores + /* + * In ex_repquote, the environment ID table stores * election parameters. */ machtab_parm(tab, &n, &pri, &timeout); diff --git a/db/docs/ref/rep/faq.html b/db/docs/ref/rep/faq.html index 83ed42e96..bd0e421a3 100644 --- a/db/docs/ref/rep/faq.html +++ b/db/docs/ref/rep/faq.html @@ -1,6 +1,7 @@ -<!--Id: faq.so,v 1.5 2001/11/17 16:59:33 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: faq.so,v 1.6 2002/05/09 20:38:15 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Replication FAQ</title> @@ -49,6 +50,47 @@ for the message. This will likely require a global numbering scheme, however, as the Berkeley DB library has to be able to send specific log records to clients apart from the general broadcast of new log records intended for all members of a replication group. +<p><li><b>Does every one of my threads of control on the master have to +set up its own connection to every client? And, does every one of my +threads of control on the client have to set up its own connection to +every master?</b> +<p>This is not always necessary. In the Berkeley DB replication model, any +thread of control which modifies a database in the master environment +must be prepared to send a message to the client environments, and any +thread of control which delivers a message to a client environment must +be prepared to send a message to the master. There are many ways in +which these requirements can be satisfied. +<p>The simplest case is probably a single, multithreaded process running +on the master and clients. The process running on the master would +require a single write connection to each client and a single read +connection from each client. A process running on each client would +require a single read connection from the master and a single write +connection to the master. Threads running in these processes on the +master and clients would use the same network connections to pass +messages back and forth. +<p>A common complication is when there are multiple processes running on +the master and clients. A straight-forward solution is to increase the +numbers of connections on the master -- each process running on the +master has its own write connection to each client. However, this +requires only one additional connection for each possible client in the +master process. The master environment still requires only a single +read connection from each client (this can be done by allocating a +separate thread of control which does nothing other than receive client +messages and forward them into the database). Similarly, each client +still only requires a single thread of control that receives master +messages and forwards them into the database, and which also takes +database messages and forwards them back to the master. This model +requires the networking infrastructure support many-to-one +writers-to-readers, of course. +<p>If the number of network connections is a problem in the multiprocess +model, and inter-process communication on the system is inexpensive +enough, an alternative is have a single process which communicates +between the master the each client, and whenever a process' +<b>send</b> function is called, the process passes the message to the +communications process which is responsible for forwarding the message +to the appropriate client. Alternatively, a broadcast mechanism will +simplify the entire networking infrastructure, as processes will likely +no longer have to maintain their own specific network connections. <p><li><b>Can I use replication to replicate just the database environment's log files?</b> <p>Yes. If the <a href="../../api_c/rep_start.html#DB_REP_LOGSONLY">DB_REP_LOGSONLY</a> flag is specified to diff --git a/db/docs/ref/rep/id.html b/db/docs/ref/rep/id.html index 572fcc1d6..9cae04d06 100644 --- a/db/docs/ref/rep/id.html +++ b/db/docs/ref/rep/id.html @@ -1,6 +1,7 @@ -<!--Id: id.so,v 1.5 2001/11/05 17:24:27 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: id.so,v 1.6 2002/05/09 20:38:15 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Replication environment IDs</title> @@ -21,8 +22,8 @@ each database environment can assign local identifiers to members of the replication group as it encounters them. For example, given three sites: A, B and C, site A might assign the identifiers 1 and 2 to sites B and C respectively, while site B might assign the identifiers 301 and -302 to sites A and C respectively. Note, it is not wrong to have global -identifiers, of course, it is just not necessary. +302 to sites A and C respectively. Note that it is not wrong to have +global identifiers, it is just not a requirement. <p>It is the responsibility of the application to label each incoming replication message passed to <a href="../../api_c/rep_message.html">DB_ENV->rep_process_message</a> function with the appropriate identifier. Subsequently, Berkeley DB will label outgoing messages to the diff --git a/db/docs/ref/rep/init.html b/db/docs/ref/rep/init.html index 46a784c12..9901967ba 100644 --- a/db/docs/ref/rep/init.html +++ b/db/docs/ref/rep/init.html @@ -1,6 +1,7 @@ <!--Id: init.so,v 1.2 2001/11/05 17:24:27 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Initializing a new site</title> diff --git a/db/docs/ref/rep/intro.html b/db/docs/ref/rep/intro.html index 439937cd1..d300cd27e 100644 --- a/db/docs/ref/rep/intro.html +++ b/db/docs/ref/rep/intro.html @@ -1,6 +1,7 @@ -<!--Id: intro.so,v 1.3 2001/10/24 19:06:38 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: intro.so,v 1.4 2002/05/09 20:38:15 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Introduction</title> @@ -26,28 +27,35 @@ new master. The database environments might be on separate computers, on separate hardware partitions in a non-uniform memory access (NUMA) system, or on separate disks in a single server. As always with Berkeley DB environments, any number of concurrent processes or threads may access -a database environment. +a database environment. In the case of a master environment, any number +of threads of control may read and write the environment, and in the +case of a client environment, any number of threads of control may read +the environment. <p>Applications may be written to provide various degrees of consistency between the master and clients. The system can be run synchronously such that replicas are guaranteed to be up-to-date with all committed transactions, but doing so may incur a significant performance penalty. Higher performance solutions sacrifice total consistency, allowing the clients to be out of date for an application-controlled amount of time. -<p>While Berkeley DB includes the tools necessary to construct highly available -database environments, applications must provide several critical -components. First, the application is responsible for providing the -communication infrastructure. Applications may use whatever wire -protocol is appropriate for their application (for example, RPC, TCP/IP, -UDP, VI, message-passing over the backplane, etc.). Second, the -application is responsible for naming. Berkeley DB refers to the members of -a replication group using an application-provided ID, and applications -must map that ID to a particular database environment or communication -channel. Third, the application is responsible for monitoring the status -of the master and clients, and identifying any unavailable database -environments. Finally, the application must provide whatever security -policies are needed. For example, the application may choose to encrypt -data, use a secure socket layer, or do nothing at all. The level of -security is left to the sole discretion of the application. +<p>While Berkeley DB includes the database infrastructure necessary to construct +highly available database environments, applications must still provide +some critical components: +<p><ol> +<p><li>The application is responsible for providing the communication +infrastructure. Applications may use whatever wire protocol is +appropriate for their application (for example, RPC, TCP/IP, UDP, VI or +message-passing over the backplane). +<p><li>The application is responsible for naming. Berkeley DB refers to the members +of a replication group using an application-provided ID, and +applications must map that ID to a particular database environment or +communication channel. +<p><li>The application is responsible for monitoring the status of the master +and clients, and identifying any unavailable database environments. +<p><li>The application must provide whatever security policies are needed. +For example, the application may choose to encrypt data, use a secure +socket layer, or do nothing at all. The level of security is left to +the sole discretion of the application. +</ol> <table width="100%"><tr><td><br></td><td align=right><a href="../../ref/transapp/faq.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/rep/id.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> diff --git a/db/docs/ref/rep/logonly.html b/db/docs/ref/rep/logonly.html index 70860f10d..e3f26ac2e 100644 --- a/db/docs/ref/rep/logonly.html +++ b/db/docs/ref/rep/logonly.html @@ -1,6 +1,7 @@ -<!--Id: logonly.so,v 1.4 2001/11/06 22:20:11 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: logonly.so,v 1.6 2002/08/08 15:46:02 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Log file only clients</title> @@ -17,20 +18,30 @@ <p>Applications wanting to use replication to support recovery after catastrophic failure of the master may want to configure a site as a logs-file-only replica. Such clients cannot respond to read (or write) -queries but still receive a complete copy the log files, so that in the -event of master failure, catastrophic recovery can be run. +queries but they still receive a complete copy the log files, so that in the +event of master failure, a copy of the logs is available. <p>Log file only clients are configured like other client sites, except they should specify the <a href="../../api_c/rep_start.html#DB_REP_LOGSONLY">DB_REP_LOGSONLY</a> flag to the <a href="../../api_c/rep_start.html">DB_ENV->rep_start</a> function and should specify a priority of 0 to the <a href="../../api_c/rep_elect.html">DB_ENV->rep_elect</a> function. -<p>To recover using a log-file-only replica, recovery must be run on the -log files accumulated by the replica. If the log files are entirely +<p>There are two ways to recover using a log-file-only replica. +The simplest way is to copy the log files from the log-file-only +replica onto another site (either master or replica) and run catastrophic +recovery there. If that is not an option, then +recovery must be run on the log-file-only replica, using the log files +that have accumulated there. +If the log files are entirely self-contained, that is, they start with log file number 1, then a log replica can simply run catastrophic recovery. Obviously, if there are a large number of log files in this case, recovery may take a long time. If the log files are not self-contained, an archival copy of the databases must first be restored onto the replica before running -catastrophic recovery. +catastrophic recovery. In the latter case (that is, running recovery +on the log-file-only replica), once the site returns to being a log-file-only +replica, the database files on the log-file-only replica should be removed, +and if the log files do not begin with log file number 1, +a new set of archival databases should be created from +the current master. <p>More specifically, the log files accumulating on the log-file-only replica can take the place of the log files described in <i>catastrophic recovery</i> section of the diff --git a/db/docs/ref/rep/newsite.html b/db/docs/ref/rep/newsite.html index ace77acf7..cdd6afaf2 100644 --- a/db/docs/ref/rep/newsite.html +++ b/db/docs/ref/rep/newsite.html @@ -1,6 +1,7 @@ <!--Id: newsite.so,v 1.2 2001/10/25 14:58:49 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Connecting to a new site</title> diff --git a/db/docs/ref/rep/partition.html b/db/docs/ref/rep/partition.html index 1b9cc8e41..e4d678ddd 100644 --- a/db/docs/ref/rep/partition.html +++ b/db/docs/ref/rep/partition.html @@ -1,6 +1,7 @@ <!--Id: partition.so,v 1.1 2001/10/25 20:05:34 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Network partitions</title> diff --git a/db/docs/ref/rep/pri.html b/db/docs/ref/rep/pri.html index cd92c9b13..e3d7a8f9d 100644 --- a/db/docs/ref/rep/pri.html +++ b/db/docs/ref/rep/pri.html @@ -1,6 +1,7 @@ <!--Id: pri.so,v 1.3 2001/11/05 17:24:27 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Replication environment priorities</title> diff --git a/db/docs/ref/rep/trans.html b/db/docs/ref/rep/trans.html index 4dac09dee..64e033d85 100644 --- a/db/docs/ref/rep/trans.html +++ b/db/docs/ref/rep/trans.html @@ -1,6 +1,7 @@ -<!--Id: trans.so,v 1.5 2001/11/05 17:24:27 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: trans.so,v 1.6 2002/05/11 18:00:23 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Transactional guarantees</title> @@ -57,34 +58,34 @@ of the <b>send</b> interface returning failure is to flush the local database environment's log as necessary to ensure that any information critical to database integrity is not lost. Because this flush is an expensive operation in terms of database performance, applications will -want to avoid returning an error from the <b>send</b> interface, unless -it is absolutely necessary. +want to avoid returning an error from the <b>send</b> interface, if at +all possible: <p>First, there is no reason for the <b>send</b> interface to ever return failure unless the <a href="../../api_c/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a> flag is specified. Messages without that flag do not make visible changes to databases, and therefore the application's <b>send</b> interface can return success -to Berkeley DB immediately after it has sent the message (or even simply -copied the message to its local memory). +to Berkeley DB for such messages as soon as the message has been sent or even +just copied to local memory. <p>Further, unless the master's database environment has been configured to not synchronously flush the log on transaction commit, there is no reason for the <b>send</b> interface to ever return failure, as any information critical to database integrity has already been flushed to the local log before <b>send</b> was called. Again, the <b>send</b> interface should return success to Berkeley DB as soon as possible. However, -in such cases, in order to avoid potential loss of information after -the master database environment fails, the master database environment +in this case, in order to avoid potential loss of information after the +master database environment fails, the master database environment should be recovered before holding an election, as only the master database environment is guaranteed to have the most up-to-date logs. <p>To sum up, the only reason for the <b>send</b> interface to return failure is when the master database environment has been configured to not synchronously flush the log on transaction commit, the -<a href="../../api_c/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a> flag is specified, and the <b>send</b> -interface was unable to determine that some number of clients have -received the current message (and all messages preceding the current -message). How many clients should receive the message before the -<b>send</b> interface can return success is an application choice, and, -in fact, may not depend as much on a specific number of clients -reporting success as one or more geographically distributed clients. +<a href="../../api_c/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a> flag is specified for the message, and the +<b>send</b> interface was unable to determine that some number of +clients have received the current message (and all messages preceding +the current message). How many clients should receive the message +before the <b>send</b> interface can return success is an application +choice (and may not depend as much on a specific number of clients +reporting success as one or more geographically distributed clients). <p>Of course, it is important to ensure that the replicated master and client environments are truly independent of each other. For example, it does not help matters that a client has acknowledged receipt of a diff --git a/db/docs/ref/transapp/faq.html b/db/docs/ref/transapp/faq.html index c41ba2870..1a94344a6 100644 --- a/db/docs/ref/transapp/faq.html +++ b/db/docs/ref/transapp/faq.html @@ -1,6 +1,7 @@ -<!--Id: faq.so,v 10.3 2001/10/13 19:56:25 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: faq.so,v 10.5 2002/05/14 15:01:45 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Transaction FAQ</title> @@ -66,18 +67,14 @@ database will first be referenced in the log. If we copy the database first, then we can also know that any inconsistency in the database will be described in the log files, and so we know that we can fix everything up during recovery. -<p><li><b>Why happens if my database page size isn't the same size as the -block size used by the system for filesystem I/O?</b> -<p>Berkeley DB does not do checksums across database pages, it relies on bytes -found in a single part of each database page to decide during recovery -if a page needs to be modified or if the page is correct and no changes -are required. If the operating system wrote a large page in two parts, -or the underlying hardware could fail in some way so that those bytes -were written, but the rest of the page was not, then it would be -possible for recovery to not correctly update the page. This is an -unlikely failure scenario, but a possible one. -<p>See <a href="../../ref/transapp/reclimit.html">Berkeley DB recoverability</a> -for more detailed information. +<p><li><b>How can I move a database from one transactional environment +into another?</b> +<p>Because database pages contain references to log records, databases +cannot be simply moved into different database environments. To move +a database into a different environment, dump and reload the database +before moving it. If the database is too large to dump and reload, the +database may be prepared in place by setting the first eight bytes of +each page in the file to 0. </ol> <table width="100%"><tr><td><br></td><td align=right><a href="../../ref/transapp/throughput.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/rep/intro.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> diff --git a/db/docs/ref/transapp/hotfail.html b/db/docs/ref/transapp/hotfail.html index 469a826b1..5caea831a 100644 --- a/db/docs/ref/transapp/hotfail.html +++ b/db/docs/ref/transapp/hotfail.html @@ -1,6 +1,7 @@ <!--Id: hotfail.so,v 10.2 2001/07/28 01:45:07 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Hot failover</title> diff --git a/db/docs/ref/upgrade.3.3/bigfile.html b/db/docs/ref/upgrade.3.3/bigfile.html index 0630c21fe..29b018ed5 100644 --- a/db/docs/ref/upgrade.3.3/bigfile.html +++ b/db/docs/ref/upgrade.3.3/bigfile.html @@ -1,6 +1,7 @@ <!--Id: bigfile.so,v 1.2 2001/06/07 19:03:21 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 3.3: --disable-bigfile</title> diff --git a/db/docs/ref/upgrade.3.3/getswap.html b/db/docs/ref/upgrade.3.3/getswap.html index 49f3757cd..17a2e004b 100644 --- a/db/docs/ref/upgrade.3.3/getswap.html +++ b/db/docs/ref/upgrade.3.3/getswap.html @@ -1,6 +1,7 @@ <!--Id: getswap.so,v 1.1 2001/06/07 19:00:21 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 3.3: DB->get_byteswapped</title> diff --git a/db/docs/ref/upgrade.3.3/gettype.html b/db/docs/ref/upgrade.3.3/gettype.html index 2dc203de0..883bc2149 100644 --- a/db/docs/ref/upgrade.3.3/gettype.html +++ b/db/docs/ref/upgrade.3.3/gettype.html @@ -1,6 +1,7 @@ <!--Id: gettype.so,v 1.1 2001/06/07 19:00:21 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 3.3: DB->get_type</title> diff --git a/db/docs/ref/upgrade.3.3/shared.html b/db/docs/ref/upgrade.3.3/shared.html index 770bd21ab..48fc16a9c 100644 --- a/db/docs/ref/upgrade.3.3/shared.html +++ b/db/docs/ref/upgrade.3.3/shared.html @@ -1,6 +1,7 @@ <!--Id: shared.so,v 1.2 2001/07/10 13:16:34 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 3.3: --enable-dynamic, --enable-shared</title> diff --git a/db/docs/ref/upgrade.4.0/asr.html b/db/docs/ref/upgrade.4.0/asr.html index 36d6efa09..78db8a1e4 100644 --- a/db/docs/ref/upgrade.4.0/asr.html +++ b/db/docs/ref/upgrade.4.0/asr.html @@ -1,6 +1,7 @@ <!--Id: asr.so,v 1.2 2001/11/14 02:27:11 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: application-specific recovery</title> @@ -23,11 +24,11 @@ included in the Berkeley DB distribution. against the code generated by the last release in which you built a template file. Any changes in the templates should be incorporated into the recovery routines you have written. -<p>Third, if your recovery functions refer to <a href="../../api_c/env_set_tx_recover.html#DB_TXN_FORWARD_ROLL">DB_TXN_FORWARD_ROLL</a> +<p>Third, if your recovery functions refer to <a href="../../api_c/env_set_app_dispatch.html#DB_TXN_FORWARD_ROLL">DB_TXN_FORWARD_ROLL</a> (that is, your code checks for that particular operation code), you should replace it with DB_REDO(op) which compares the operation code to -both <a href="../../api_c/env_set_tx_recover.html#DB_TXN_FORWARD_ROLL">DB_TXN_FORWARD_ROLL</a> and <a href="../../api_c/env_set_tx_recover.html#DB_TXN_APPLY">DB_TXN_APPLY</a>. -(<a href="../../api_c/env_set_tx_recover.html#DB_TXN_APPLY">DB_TXN_APPLY</a> is a potential value for the operation code as of +both <a href="../../api_c/env_set_app_dispatch.html#DB_TXN_FORWARD_ROLL">DB_TXN_FORWARD_ROLL</a> and <a href="../../api_c/env_set_app_dispatch.html#DB_TXN_APPLY">DB_TXN_APPLY</a>. +(<a href="../../api_c/env_set_app_dispatch.html#DB_TXN_APPLY">DB_TXN_APPLY</a> is a potential value for the operation code as of the 4.0 release.) <p>Finally, if you have created your own logging and recovery routines, we recommend that you contact Sleepycat support and ask us to review those diff --git a/db/docs/ref/upgrade.4.0/cxx.html b/db/docs/ref/upgrade.4.0/cxx.html index 410b0cf06..d077cf8d1 100644 --- a/db/docs/ref/upgrade.4.0/cxx.html +++ b/db/docs/ref/upgrade.4.0/cxx.html @@ -1,6 +1,7 @@ <!--Id: cxx.so,v 1.2 2001/11/16 16:49:43 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: C++ ostream objects</title> diff --git a/db/docs/ref/upgrade.4.0/deadlock.html b/db/docs/ref/upgrade.4.0/deadlock.html index 9fb8dbff5..2c12a9a77 100644 --- a/db/docs/ref/upgrade.4.0/deadlock.html +++ b/db/docs/ref/upgrade.4.0/deadlock.html @@ -1,6 +1,7 @@ <!--Id: deadlock.so,v 1.1 2001/09/07 16:55:56 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: db_deadlock</title> diff --git a/db/docs/ref/upgrade.4.0/disk.html b/db/docs/ref/upgrade.4.0/disk.html index 230840167..eba0d30cb 100644 --- a/db/docs/ref/upgrade.4.0/disk.html +++ b/db/docs/ref/upgrade.4.0/disk.html @@ -1,6 +1,7 @@ -<!--Id: disk.so,v 1.10 2001/11/09 22:11:29 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: disk.so,v 1.11 2001/12/10 15:14:06 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: upgrade requirements</title> @@ -10,7 +11,7 @@ <body bgcolor=white> <table width="100%"><tr valign=top> <td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></h3></td> -<td align=right><a href="../../ref/upgrade.4.0/asr.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/test/run.html"><img src="../../images/next.gif" alt="Next"></a> +<td align=right><a href="../../ref/upgrade.4.0/asr.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/upgrade.4.1/intro.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p> <h1 align=center>Release 4.0: upgrade requirements</h1> @@ -18,7 +19,7 @@ formats changed in the Berkeley DB 4.0 release. <p>For further information on upgrading Berkeley DB installations, see <a href="../../ref/upgrade/process.html">Upgrading Berkeley DB installations</a>. -<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/upgrade.4.0/asr.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/test/run.html"><img src="../../images/next.gif" alt="Next"></a> +<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/upgrade.4.0/asr.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/upgrade.4.1/intro.html"><img src="../../images/next.gif" alt="Next"></a> </td></tr></table> <p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> </body> diff --git a/db/docs/ref/upgrade.4.0/env.html b/db/docs/ref/upgrade.4.0/env.html index d7c6bbaa6..e506bdc51 100644 --- a/db/docs/ref/upgrade.4.0/env.html +++ b/db/docs/ref/upgrade.4.0/env.html @@ -1,6 +1,7 @@ <!--Id: env.so,v 1.5 2001/08/07 01:42:35 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: db_env_set_XXX</title> diff --git a/db/docs/ref/upgrade.4.0/intro.html b/db/docs/ref/upgrade.4.0/intro.html index 6284e4bf5..edd2bf9bb 100644 --- a/db/docs/ref/upgrade.4.0/intro.html +++ b/db/docs/ref/upgrade.4.0/intro.html @@ -1,6 +1,7 @@ <!--Id: intro.so,v 1.5 2001/09/28 15:10:29 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: introduction</title> diff --git a/db/docs/ref/upgrade.4.0/java.html b/db/docs/ref/upgrade.4.0/java.html index 788620b18..74ec217fd 100644 --- a/db/docs/ref/upgrade.4.0/java.html +++ b/db/docs/ref/upgrade.4.0/java.html @@ -1,6 +1,7 @@ <!--Id: java.so,v 1.6 2001/11/14 02:27:12 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: Java CLASSPATH environment variable</title> @@ -19,7 +20,7 @@ release, the <b>CLASSPATH</b> environment variable must change to include at least the <b>db.jar</b> file. It can optionally include the <b>dbexamples.jar</b> file if you want to run the examples. For example, on UNIX: -<p><blockquote><pre>export CLASSPATH="/usr/local/BerkeleyDB.4.0/lib/db.jar:/usr/local/BerkeleyDB.4.0/lib/dbexamples.jar"</pre></blockquote> +<p><blockquote><pre>export CLASSPATH="/usr/local/BerkeleyDB.4.1/lib/db.jar:/usr/local/BerkeleyDB.4.1/lib/dbexamples.jar"</pre></blockquote> <p>For example, on Windows: <p><blockquote><pre>set CLASSPATH="D:\db\build_win32\Release\db.jar;D:\db\build_win32\Release\dbexamples.jar"</pre></blockquote> <p>For more information on Java configuration, please see diff --git a/db/docs/ref/upgrade.4.0/lock.html b/db/docs/ref/upgrade.4.0/lock.html index 118f2d884..d7dcf1d1f 100644 --- a/db/docs/ref/upgrade.4.0/lock.html +++ b/db/docs/ref/upgrade.4.0/lock.html @@ -1,6 +1,7 @@ <!--Id: lock.so,v 1.6 2001/09/27 02:25:51 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: lock_XXX</title> diff --git a/db/docs/ref/upgrade.4.0/lock_id_free.html b/db/docs/ref/upgrade.4.0/lock_id_free.html index fb1b56a3c..0fe47ad6b 100644 --- a/db/docs/ref/upgrade.4.0/lock_id_free.html +++ b/db/docs/ref/upgrade.4.0/lock_id_free.html @@ -1,6 +1,7 @@ <!--Id: lock_id_free.so,v 1.1 2001/09/25 21:05:24 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: DB_ENV->lock_id_free</title> diff --git a/db/docs/ref/upgrade.4.0/log.html b/db/docs/ref/upgrade.4.0/log.html index dfae570ab..41ae96de8 100644 --- a/db/docs/ref/upgrade.4.0/log.html +++ b/db/docs/ref/upgrade.4.0/log.html @@ -1,6 +1,7 @@ -<!--Id: log.so,v 1.3 2001/09/28 15:09:42 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Id: log.so,v 1.4 2001/12/31 21:07:00 bostic Exp --> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: log_XXX</title> @@ -23,9 +24,9 @@ release as follows: <tr><td>log_flush</td><td><a href="../../api_c/log_flush.html">DB_ENV->log_flush</a></td></tr> <tr><td>log_get</td><td><a href="../../api_c/log_cursor.html">DB_ENV->log_cursor</a>, <a href="../../api_c/logc_get.html">DB_LOGC->get</a>, <a href="../../api_c/logc_close.html">DB_LOGC->close</a></td></tr> <tr><td>log_put</td><td><a href="../../api_c/log_put.html">DB_ENV->log_put</a></td></tr> -<tr><td>log_register</td><td><a href="../../api_c/log_register.html">DB_ENV->log_register</a></td></tr> +<tr><td>log_register</td><td>DB_ENV->log_register</td></tr> <tr><td>log_stat</td><td><a href="../../api_c/log_stat.html">DB_ENV->log_stat</a></td></tr> -<tr><td>log_unregister</td><td><a href="../../api_c/log_unregister.html">DB_ENV->log_unregister</a></td></tr> +<tr><td>log_unregister</td><td>DB_ENV->log_unregister</td></tr> </table> <p>Applications calling any of these functions should update their calls to use the enclosing <a href="../../api_c/env_create.html">DB_ENV</a> handle's method (in all cases other diff --git a/db/docs/ref/upgrade.4.0/mp.html b/db/docs/ref/upgrade.4.0/mp.html index c99a47863..bbd8b7ebe 100644 --- a/db/docs/ref/upgrade.4.0/mp.html +++ b/db/docs/ref/upgrade.4.0/mp.html @@ -1,6 +1,7 @@ <!--Id: mp.so,v 1.2 2001/09/27 02:25:52 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: memp_XXX</title> diff --git a/db/docs/ref/upgrade.4.0/rpc.html b/db/docs/ref/upgrade.4.0/rpc.html index b273750fa..50f4cf074 100644 --- a/db/docs/ref/upgrade.4.0/rpc.html +++ b/db/docs/ref/upgrade.4.0/rpc.html @@ -1,6 +1,7 @@ <!--Id: rpc.so,v 1.5 2001/07/27 23:18:47 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: DB_ENV->set_server</title> diff --git a/db/docs/ref/upgrade.4.0/set_lk_max.html b/db/docs/ref/upgrade.4.0/set_lk_max.html index 020b379e7..e2605de58 100644 --- a/db/docs/ref/upgrade.4.0/set_lk_max.html +++ b/db/docs/ref/upgrade.4.0/set_lk_max.html @@ -1,6 +1,7 @@ <!--Id: set_lk_max.so,v 1.3 2001/09/25 21:05:25 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: DB_ENV->set_lk_max</title> diff --git a/db/docs/ref/upgrade.4.0/toc.html b/db/docs/ref/upgrade.4.0/toc.html index ad2033946..f0c3138ea 100644 --- a/db/docs/ref/upgrade.4.0/toc.html +++ b/db/docs/ref/upgrade.4.0/toc.html @@ -1,6 +1,7 @@ <!--Id: toc.so,v 1.15 2001/11/14 02:27:12 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Upgrading Berkeley DB 3.3.X applications to Berkeley DB 4.0</title> diff --git a/db/docs/ref/upgrade.4.0/txn.html b/db/docs/ref/upgrade.4.0/txn.html index 23e15227a..913f06334 100644 --- a/db/docs/ref/upgrade.4.0/txn.html +++ b/db/docs/ref/upgrade.4.0/txn.html @@ -1,6 +1,7 @@ <!--Id: txn.so,v 1.5 2001/09/27 02:25:52 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Release 4.0: txn_XXX</title> diff --git a/db/docs/ref/upgrade/version.html b/db/docs/ref/upgrade/version.html index 26ffd4e99..53c09b559 100644 --- a/db/docs/ref/upgrade/version.html +++ b/db/docs/ref/upgrade/version.html @@ -1,6 +1,7 @@ <!--Id: version.so,v 10.19 2001/06/25 13:29:43 bostic Exp --> -<!--Copyright 1997-2001 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2002 by Sleepycat Software, Inc.--> <!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> <html> <head> <title>Berkeley DB Reference Guide: Library version information</title> |