diff options
| author | Panu Matilainen <pmatilai@redhat.com> | 2007-07-16 16:48:14 +0300 |
|---|---|---|
| committer | Panu Matilainen <pmatilai@redhat.com> | 2007-07-16 16:48:14 +0300 |
| commit | 2cfd3012bfcb5c5c61bbaf662ef084e0ab789d79 (patch) | |
| tree | e12ee52087506ac8c7a5eee83b17497d98df2d40 /db/docs/api_cxx | |
| parent | b754fe19fd387ca5fe8e7c00ddaa25c898fa192f (diff) | |
| download | rpm-2cfd3012bfcb5c5c61bbaf662ef084e0ab789d79.tar.gz rpm-2cfd3012bfcb5c5c61bbaf662ef084e0ab789d79.tar.bz2 rpm-2cfd3012bfcb5c5c61bbaf662ef084e0ab789d79.zip | |
Update internal BDB to version 4.5.20
Diffstat (limited to 'db/docs/api_cxx')
221 files changed, 4772 insertions, 1274 deletions
diff --git a/db/docs/api_cxx/api_core.html b/db/docs/api_cxx/api_core.html index a5240ecd8..93eea10ff 100644 --- a/db/docs/api_cxx/api_core.html +++ b/db/docs/api_cxx/api_core.html @@ -1,33 +1,32 @@ <!--DO NOT EDIT: automatically built by build script.--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: Berkeley DB: C++ Handle Methods (version 4.3.27)</title> +<title>Berkeley DB: Berkeley DB: C++ Handle Methods (version 4.5.20)</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> -<h3 align=center>Berkeley DB: C++ Handle Methods (version 4.3.27)</h3> +<h3 align=center>Berkeley DB: C++ Handle Methods (version 4.5.20)</h3> <table border=1 align=center> <tr><th>C++ Handle Methods</th><th>Description</th></tr> <!--Db::--><tr><td><a href="../api_cxx/db_class.html">Db</a></td><td>Create a database handle</td></tr> <!--Db::associate--><tr><td><a href="../api_cxx/db_associate.html">Db::associate</a></td><td>Associate a secondary index</td></tr> <!--Db::close--><tr><td><a href="../api_cxx/db_close.html">Db::close</a></td><td>Close a database</td></tr> -<!--Db::cursor--><tr><td><a href="../api_cxx/db_close.html">Db::close</a></td><td>Create a cursor</td></tr> -<!--Db::cursor--><tr><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor handle</td></tr> +<!--Db::compact--><tr><td><a href="../api_cxx/db_compact.html">Db::compact</a></td><td>Compact a database</td></tr> +<!--Db::cursor--><tr><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor</td></tr> <!--Db::del--><tr><td><a href="../api_cxx/db_del.html">Db::del</a></td><td>Delete items from a database</td></tr> <!--Db::err--><tr><td><a href="../api_cxx/db_err.html">Db::err</a>, <a href="../api_cxx/db_err.html">Db::errx</a></td><td>Error message</td></tr> <!--Db::fd--><tr><td><a href="../api_cxx/db_fd.html">Db::fd</a></td><td>Return a file descriptor from a database</td></tr> <!--Db::get--><tr><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> <!--Db::get_byteswapped--><tr><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> -<!--Db::get_env--><tr><td><a href="../api_cxx/db_getenv.html">Db::getenv</a></td><td>Return database environment handle</td></tr> -<!--Db::get_mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return underlying <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle</td></tr> +<!--Db::get_env--><tr><td><a href="../api_cxx/db_getenv.html">Db::getenv</a></td><td>Return <a href="../api_cxx/db_class.html">Db</a>'s underlying <a href="../api_cxx/env_class.html">DbEnv</a> handle</td></tr> <!--Db::get_type--><tr><td><a href="../api_cxx/db_get_type.html">Db::get_type</a></td><td>Return the database type</td></tr> <!--Db::join--><tr><td><a href="../api_cxx/db_join.html">Db::join</a></td><td>Perform a database join on cursors</td></tr> <!--Db::key_range--><tr><td><a href="../api_cxx/db_key_range.html">Db::key_range</a></td><td>Return estimate of key location</td></tr> -<!--Db::mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return the database's memory pool handle</td></tr> +<!--Db::mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return <a href="../api_cxx/db_class.html">Db</a>'s underlying <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle</td></tr> <!--Db::open--><tr><td><a href="../api_cxx/db_open.html">Db::open</a></td><td>Open a database</td></tr> <!--Db::put--><tr><td><a href="../api_cxx/db_put.html">Db::put</a></td><td>Store items into a database</td></tr> <!--Db::remove--><tr><td><a href="../api_cxx/db_remove.html">Db::remove</a></td><td>Remove a database</td></tr> @@ -51,7 +50,6 @@ <!--Db::set_h_nelem--><tr><td><a href="../api_cxx/db_set_h_nelem.html">Db::set_h_nelem</a></td><td>Set the Hash table size</td></tr> <!--Db::set_lorder--><tr><td><a href="../api_cxx/db_set_lorder.html">Db::set_lorder</a></td><td>Set the database byte order</td></tr> <!--Db::set_pagesize--><tr><td><a href="../api_cxx/db_set_pagesize.html">Db::set_pagesize</a></td><td>Set the underlying database page size</td></tr> -<!--Db::set_paniccall--><tr><td><a href="../api_cxx/db_set_paniccall.html">Db::set_paniccall</a></td><td>Set panic callback</td></tr> <!--Db::set_q_extentsize--><tr><td><a href="../api_cxx/db_set_q_extentsize.html">Db::set_q_extentsize</a></td><td>Set Queue database extent size</td></tr> <!--Db::set_re_delim--><tr><td><a href="../api_cxx/db_set_re_delim.html">Db::set_re_delim</a></td><td>Set the variable-length record delimiter</td></tr> <!--Db::set_re_len--><tr><td><a href="../api_cxx/db_set_re_len.html">Db::set_re_len</a></td><td>Set the fixed-length record length</td></tr> @@ -70,12 +68,15 @@ <!--DbCursor::put--><tr><td><a href="../api_cxx/dbc_put.html">Dbc::put</a></td><td>Store by cursor</td></tr> <!--DbDeadlockException--><tr><td><a href="../api_cxx/deadlock_class.html">DbDeadlockException</a></td><td>Deadlock exception</td></tr> <!--DbEnv::--><tr><td><a href="../api_cxx/env_class.html">DbEnv</a></td><td>Create an environment handle</td></tr> +<!--DbEnv::cdsgroup_begin--><tr><td><a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a></td><td>Get a locker ID in Berkeley DB Concurrent Data Store</td></tr> <!--DbEnv::close--><tr><td><a href="../api_cxx/env_close.html">DbEnv::close</a></td><td>Close an environment</td></tr> <!--DbEnv::dbremove--><tr><td><a href="../api_cxx/env_dbremove.html">DbEnv::dbremove</a></td><td>Remove a database</td></tr> <!--DbEnv::dbrename--><tr><td><a href="../api_cxx/env_dbrename.html">DbEnv::dbrename</a></td><td>Rename a database</td></tr> <!--DbEnv::err--><tr><td><a href="../api_cxx/env_err.html">DbEnv::err</a>, <a href="../api_cxx/env_err.html">DbEnv::errx</a></td><td>Error message</td></tr> +<!--DbEnv::failchk--><tr><td><a href="../api_cxx/env_failchk.html">DbEnv::failchk</a></td><td>Check for thread failure</td></tr> +<!--DbEnv::fileid_reset--><tr><td><a href="../api_cxx/env_fileid_reset.html">DbEnv::fileid_reset</a></td><td>Reset database file IDs</td></tr> <!--DbEnv::get_home--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_home</a></td><td>Return environment's home directory</td></tr> -<!--DbEnv::get_open_flags--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_open_flags</a></td><td>Return the flags with which the environment was opened</td></tr> +<!--DbEnv::get_open_flags--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_open_flags</a></td><td>Return flags with which the environment was opened</td></tr> <!--DbEnv::lock_detect--><tr><td><a href="../api_cxx/lock_detect.html">DbEnv::lock_detect</a></td><td>Perform deadlock detection</td></tr> <!--DbEnv::lock_get--><tr><td><a href="../api_cxx/lock_get.html">DbEnv::lock_get</a></td><td>Acquire a lock</td></tr> <!--DbEnv::lock_id--><tr><td><a href="../api_cxx/lock_id.html">DbEnv::lock_id</a></td><td>Acquire a locker ID</td></tr> @@ -86,35 +87,58 @@ <!--DbEnv::log_archive--><tr><td><a href="../api_cxx/log_archive.html">DbEnv::log_archive</a></td><td>List log and database files</td></tr> <!--DbEnv::log_file--><tr><td><a href="../api_cxx/log_file.html">DbEnv::log_file</a></td><td>Map Log Sequence Numbers to log files</td></tr> <!--DbEnv::log_flush--><tr><td><a href="../api_cxx/log_flush.html">DbEnv::log_flush</a></td><td>Flush log records</td></tr> +<!--DbEnv::log_printf--><tr><td><a href="../api_cxx/log_printf.html">DbEnv::log_printf</a></td><td>Append informational message to the log</td></tr> <!--DbEnv::log_put--><tr><td><a href="../api_cxx/log_put.html">DbEnv::log_put</a></td><td>Write a log record</td></tr> <!--DbEnv::log_stat--><tr><td><a href="../api_cxx/log_stat.html">DbEnv::log_stat</a></td><td>Return log subsystem statistics</td></tr> +<!--DbEnv::lsn_reset--><tr><td><a href="../api_cxx/env_lsn_reset.html">DbEnv::lsn_reset</a></td><td>Reset database file LSNs</td></tr> <!--DbEnv::memp_fcreate--><tr><td><a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a></td><td>Create a memory pool file handle</td></tr> <!--DbEnv::memp_register--><tr><td><a href="../api_cxx/memp_register.html">DbEnv::memp_register</a></td><td>Register input/output functions for a file in a memory pool</td></tr> -<!--DbEnv::memp_set_max_openfd--><tr><td><a href="../api_cxx/memp_openfd.html">DbEnv::set_max_openfd</a></td><td>Set the maximum number of open file descriptors</td></tr> -<!--DbEnv::memp_set_max_write--><tr><td><a href="../api_cxx/memp_maxwrite.html">DbEnv::set_max_write</a></td><td>Set the maximum number of sequential disk writes</td></tr> <!--DbEnv::memp_stat--><tr><td><a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a></td><td>Return memory pool statistics</td></tr> <!--DbEnv::memp_sync--><tr><td><a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a></td><td>Flush pages from a memory pool</td></tr> <!--DbEnv::memp_trickle--><tr><td><a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a></td><td>Trickle flush pages from a memory pool</td></tr> +<!--DbEnv::mutex_alloc--><tr><td><a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a></td><td>Allocate a mutex</td></tr> +<!--DbEnv::mutex_free--><tr><td><a href="../api_cxx/mutex_free.html">DbEnv::mutex_free</a></td><td>Free a mutex</td></tr> +<!--DbEnv::mutex_lock--><tr><td><a href="../api_cxx/mutex_lock.html">DbEnv::mutex_lock</a></td><td>Lock a mutex</td></tr> +<!--DbEnv::mutex_set_align--><tr><td><a href="../api_cxx/mutex_set_align.html">DbEnv::mutex_set_align</a></td><td>Configure mutex alignment</td></tr> +<!--DbEnv::mutex_set_increment--><tr><td><a href="../api_cxx/mutex_set_max.html">DbEnv::mutex_set_increment</a></td><td>Configure number of additional mutexes</td></tr> +<!--DbEnv::mutex_set_max--><tr><td><a href="../api_cxx/mutex_set_max.html">DbEnv::mutex_set_max</a></td><td>Configure total number of mutexes</td></tr> +<!--DbEnv::mutex_set_tas_spins--><tr><td><a href="../api_cxx/mutex_set_tas_spins.html">DbEnv::mutex_set_tas_spins</a></td><td>Configure test-and-set mutex spin count</td></tr> +<!--DbEnv::mutex_stat--><tr><td><a href="../api_cxx/mutex_stat.html">DbEnv::mutex_stat</a></td><td>Mutex statistics</td></tr> +<!--DbEnv::mutex_unlock--><tr><td><a href="../api_cxx/mutex_unlock.html">DbEnv::mutex_unlock</a></td><td>Unlock a mutex</td></tr> <!--DbEnv::open--><tr><td><a href="../api_cxx/env_open.html">DbEnv::open</a></td><td>Open an environment</td></tr> <!--DbEnv::remove--><tr><td><a href="../api_cxx/env_remove.html">DbEnv::remove</a></td><td>Remove an environment</td></tr> <!--DbEnv::rep_elect--><tr><td><a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a></td><td>Hold a replication election</td></tr> <!--DbEnv::rep_process_message--><tr><td><a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a></td><td>Process a replication message</td></tr> +<!--DbEnv::rep_set_config--><tr><td><a href="../api_cxx/rep_config.html">DbEnv::rep_set_config</a></td><td>Configure the replication subsystem</td></tr> +<!--DbEnv::rep_set_limit--><tr><td><a href="../api_cxx/rep_limit.html">DbEnv::rep_set_limit</a></td><td>Limit data sent in response to a single message</td></tr> +<!--DbEnv::rep_set_nsites--><tr><td><a href="../api_cxx/rep_nsites.html">DbEnv::rep_set_nsites</a></td><td>Configure replication group site count</td></tr> +<!--DbEnv::rep_set_priority--><tr><td><a href="../api_cxx/rep_priority.html">DbEnv::rep_set_priority</a></td><td>Configure replication site priority</td></tr> +<!--DbEnv::rep_set_timeout--><tr><td><a href="../api_cxx/rep_timeout.html">DbEnv::rep_set_timeout</a></td><td>Configure replication timeouts</td></tr> +<!--DbEnv::rep_set_transport--><tr><td><a href="../api_cxx/rep_transport.html">DbEnv::rep_set_transport</a></td><td>Configure replication transport callback</td></tr> <!--DbEnv::rep_start--><tr><td><a href="../api_cxx/rep_start.html">DbEnv::rep_start</a></td><td>Configure an environment for replication</td></tr> <!--DbEnv::rep_stat--><tr><td><a href="../api_cxx/rep_stat.html">DbEnv::rep_stat</a></td><td>Replication statistics</td></tr> +<!--DbEnv::rep_sync--><tr><td><a href="../api_cxx/rep_sync.html">DbEnv::rep_sync</a></td><td>Replication synchronization</td></tr> +<!--DbEnv::repmgr_add_remote_site--><tr><td><a href="../api_cxx/repmgr_remote_site.html">DbEnv::repmgr_add_remote_site</a></td><td>Specify the replication manager's remote sites</td></tr> +<!--DbEnv::repmgr_set_ack_policy--><tr><td><a href="../api_cxx/repmgr_ack_policy.html">DbEnv::repmgr_set_ack_policy</a></td><td>Specify the replication manager's client acknowledgement policy</td></tr> +<!--DbEnv::repmgr_set_local_site--><tr><td><a href="../api_cxx/repmgr_local_site.html">DbEnv::repmgr_set_local_site</a></td><td>Specify the replication manager's local site</td></tr> +<!--DbEnv::repmgr_site_list--><tr><td><a href="../api_cxx/repmgr_site_list.html">DbEnv::repmgr_site_list</a></td><td>List the sites and their status</td></tr> +<!--DbEnv::repmgr_start--><tr><td><a href="../api_cxx/repmgr_start.html">DbEnv::repmgr_start</a></td><td>Start the replication manager</td></tr> <!--DbEnv::set_alloc--><tr><td><a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a></td><td>Set local space allocation functions</td></tr> <!--DbEnv::set_app_dispatch--><tr><td><a href="../api_cxx/env_set_app_dispatch.html">DbEnv::set_app_dispatch</a></td><td>Configure application recovery</td></tr> <!--DbEnv::set_cachesize--><tr><td><a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a></td><td>Set the environment cache size</td></tr> -<!--DbEnv::set_cachesize--><tr><td><a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a></td><td>Set the environment cache size</td></tr> <!--DbEnv::set_data_dir--><tr><td><a href="../api_cxx/env_set_data_dir.html">DbEnv::set_data_dir</a></td><td>Set the environment data directory</td></tr> <!--DbEnv::set_encrypt--><tr><td><a href="../api_cxx/env_set_encrypt.html">DbEnv::set_encrypt</a></td><td>Set the environment cryptographic key</td></tr> <!--DbEnv::set_errcall--><tr><td><a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a>, <a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a></td><td>Set error and informational message callbacks</td></tr> <!--DbEnv::set_errfile--><tr><td><a href="../api_cxx/env_set_errfile.html">DbEnv::set_errfile</a>, <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a></td><td>Set error and informational message FILE</td></tr> <!--DbEnv::set_error_stream--><tr><td><a href="../api_cxx/env_set_error_stream.html">DbEnv::set_error_stream</a>, <a href="../api_cxx/env_set_msg_stream.html">DbEnv::set_message_stream</a></td><td>Set error and informational message output stream</td></tr> <!--DbEnv::set_errpfx--><tr><td><a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a></td><td>Set error message prefix</td></tr> +<!--DbEnv::set_event_notify--><tr><td><a href="../api_cxx/env_event_notify.html">DbEnv::set_event_notify</a></td><td>Set event notification callback</td></tr> <!--DbEnv::set_feedback--><tr><td><a href="../api_cxx/env_set_feedback.html">DbEnv::set_feedback</a></td><td>Set feedback callback</td></tr> <!--DbEnv::set_flags--><tr><td><a href="../api_cxx/env_set_flags.html">DbEnv::set_flags</a></td><td>Environment configuration</td></tr> +<!--DbEnv::set_isalive--><tr><td><a href="../api_cxx/env_set_isalive.html">DbEnv::set_isalive</a></td><td>Set thread is-alive callback</td></tr> <!--DbEnv::set_lg_bsize--><tr><td><a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a></td><td>Set log buffer size</td></tr> <!--DbEnv::set_lg_dir--><tr><td><a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a></td><td>Set the environment logging directory</td></tr> +<!--DbEnv::set_lg_filemode--><tr><td><a href="../api_cxx/env_set_lg_mode.html">DbEnv::set_lg_filemode</a></td><td>Set log file mode</td></tr> <!--DbEnv::set_lg_max--><tr><td><a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a></td><td>Set log file size</td></tr> <!--DbEnv::set_lg_regionmax--><tr><td><a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a></td><td>Set logging region size</td></tr> <!--DbEnv::set_lk_conflicts--><tr><td><a href="../api_cxx/env_set_lk_conflicts.html">DbEnv::set_lk_conflicts</a></td><td>Set lock conflicts matrix</td></tr> @@ -122,15 +146,14 @@ <!--DbEnv::set_lk_max_lockers--><tr><td><a href="../api_cxx/env_set_lk_max_lockers.html">DbEnv::set_lk_max_lockers</a></td><td>Set maximum number of lockers</td></tr> <!--DbEnv::set_lk_max_locks--><tr><td><a href="../api_cxx/env_set_lk_max_locks.html">DbEnv::set_lk_max_locks</a></td><td>Set maximum number of locks</td></tr> <!--DbEnv::set_lk_max_objects--><tr><td><a href="../api_cxx/env_set_lk_max_objects.html">DbEnv::set_lk_max_objects</a></td><td>Set maximum number of lock objects</td></tr> +<!--DbEnv::set_mp_max_openfd--><tr><td><a href="../api_cxx/memp_openfd.html">DbEnv::set_mp_max_openfd</a></td><td>Set the maximum number of open file descriptors</td></tr> +<!--DbEnv::set_mp_max_write--><tr><td><a href="../api_cxx/memp_maxwrite.html">DbEnv::set_mp_max_write</a></td><td>Set the maximum number of sequential disk writes</td></tr> <!--DbEnv::set_mp_mmapsize--><tr><td><a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a></td><td>Set maximum mapped-in database file size</td></tr> -<!--DbEnv::set_paniccall--><tr><td><a href="../api_cxx/env_set_paniccall.html">DbEnv::set_paniccall</a></td><td>Set panic callback</td></tr> -<!--DbEnv::set_rep_limit--><tr><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> -<!--DbEnv::set_rep_transport--><tr><td><a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a></td><td>Configure replication transport</td></tr> <!--DbEnv::set_rpc_server--><tr><td><a href="../api_cxx/env_set_rpc_server.html">DbEnv::set_rpc_server</a></td><td>Establish an RPC server connection</td></tr> <!--DbEnv::set_shm_key--><tr><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> -<!--DbEnv::set_tas_spins--><tr><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> -<!--DbEnv::set_timeout--><tr><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> -<!--DbEnv::set_timeout--><tr><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> +<!--DbEnv::set_thread_count--><tr><td><a href="../api_cxx/env_set_thread_count.html">DbEnv::set_thread_count</a></td><td>Set approximate thread count</td></tr> +<!--DbEnv::set_thread_id--><tr><td><a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a></td><td>Set thread of control ID function</td></tr> +<!--DbEnv::set_thread_id_string--><tr><td><a href="../api_cxx/env_set_thread_id_string.html">DbEnv::set_thread_id_string</a></td><td>Set thread of control ID format function</td></tr> <!--DbEnv::set_timeout--><tr><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> <!--DbEnv::set_tmp_dir--><tr><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> <!--DbEnv::set_tx_max--><tr><td><a href="../api_cxx/env_set_tx_max.html">DbEnv::set_tx_max</a></td><td>Set maximum number of transactions</td></tr> @@ -169,7 +192,7 @@ <!--DbSequence::get--><tr><td><a href="../api_cxx/seq_get.html">DbSequence::get</a></td><td>Get the next sequence element(s)</td></tr> <!--DbSequence::get_dbp--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::get_dbp</a></td><td>Return a handle for the underlying sequence database</td></tr> <!--DbSequence::get_key--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::get_key</a></td><td>Return the key for a sequence</td></tr> -<!--DbSequence::init_value--><tr><td><a href="../api_cxx/seq_init_value.html">DbSequence::init_value</a></td><td>Set the initial value of a sequence</td></tr> +<!--DbSequence::initial_value--><tr><td><a href="../api_cxx/seq_initial_value.html">DbSequence::initial_value</a></td><td>Set the initial value of a sequence</td></tr> <!--DbSequence::open--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::open</a></td><td>Open a sequence</td></tr> <!--DbSequence::remove--><tr><td><a href="../api_cxx/seq_remove.html">DbSequence::remove</a></td><td>Remove a sequence</td></tr> <!--DbSequence::set_cachesize--><tr><td><a href="../api_cxx/seq_set_cachesize.html">DbSequence::set_cachesize</a></td><td>Set the cache size of a sequence</td></tr> @@ -182,11 +205,12 @@ <!--DbTxn::discard--><tr><td><a href="../api_cxx/txn_discard.html">DbTxn::discard</a></td><td>Discard a prepared but not resolved transaction handle</td></tr> <!--DbTxn::id--><tr><td><a href="../api_cxx/txn_id.html">DbTxn::id</a></td><td>Return a transaction's ID</td></tr> <!--DbTxn::prepare--><tr><td><a href="../api_cxx/txn_prepare.html">DbTxn::prepare</a></td><td>Prepare a transaction for commit</td></tr> +<!--DbTxn::set_name--><tr><td><a href="../api_cxx/txn_set_name.html">DbTxn::set_name</a></td><td>Associate a string with a transaction</td></tr> <!--DbTxn::set_timeout--><tr><td><a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a></td><td>Set transaction timeout</td></tr> <!--db_strerror--><tr><td><a href="../api_cxx/env_strerror.html">DbEnv::strerror</a></td><td>Error strings</td></tr> <!--db_version--><tr><td><a href="../api_cxx/env_version.html">DbEnv::version</a></td><td>Return version information</td></tr> <!--log_compare--><tr><td><a href="../api_cxx/log_compare.html">DbEnv::log_compare</a></td><td>Compare two Log Sequence Numbers</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/cxx_pindex.html b/db/docs/api_cxx/cxx_pindex.html index d98ef63da..7bb989153 100644 --- a/db/docs/api_cxx/cxx_pindex.html +++ b/db/docs/api_cxx/cxx_pindex.html @@ -14,6 +14,7 @@ <tr><td align=right>Building a small memory footprint library </td><td> <a href="../ref/build_unix/small.html#--disable-queue">--disable-queue</a></td></tr> <tr><td align=right>Building a small memory footprint library </td><td> <a href="../ref/build_unix/small.html#--disable-replication">--disable-replication</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--disable-shared">--disable-shared</a></td></tr> +<tr><td align=right>QNX </td><td> <a href="../ref/build_unix/qnx.html#--disable-shared">--disable-shared</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--disable-static">--disable-static</a></td></tr> <tr><td align=right>Building a small memory footprint library </td><td> <a href="../ref/build_unix/small.html#--disable-statistics">--disable-statistics</a></td></tr> <tr><td align=right>Building a small memory footprint library </td><td> <a href="../ref/build_unix/small.html#--disable-verify">--disable-verify</a></td></tr> @@ -26,6 +27,7 @@ <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-dump185">--enable-dump185</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-java">--enable-java</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-posixmutexes">--enable-posixmutexes</a></td></tr> +<tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-pthread_api">--enable-pthread_api</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-rpc">--enable-rpc</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-smallbuild">--enable-smallbuild</a></td></tr> <tr><td align=right>Building a small memory footprint library </td><td> <a href="../ref/build_unix/small.html#--enable-smallbuild">--enable-smallbuild</a></td></tr> @@ -34,8 +36,6 @@ <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-uimutexes">--enable-uimutexes</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--enable-umrw">--enable-umrw</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--with-mutex=MUTEX">--with-mutex=MUTEX</a></td></tr> -<tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--with-mutexalign=ALIGNMENT">--with-mutexalign=ALIGNMENT</a></td></tr> -<tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--with-rpm=ARCHIVE">--with-rpm=ARCHIVE</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--with-tcl=DIR">--with-tcl=DIR</a></td></tr> <tr><td align=right>Configuring Berkeley DB </td><td> <a href="../ref/build_unix/conf.html#--with-uniquename=NAME">--with-uniquename=NAME</a></td></tr> <tr><td align=right></td><td> <a href="../ref/install/file.html#2">/etc/magic</a></td></tr> @@ -53,15 +53,16 @@ <tr><td align=right>introduction to the </td><td> <a href="../ref/mp/intro.html#4">buffer</a> pool subsystem</td></tr> <tr><td align=right>turn off system </td><td> <a href="../api_cxx/memp_fopen.html#2">buffering</a></td></tr> <tr><td align=right>turn off system </td><td> <a href="../api_cxx/env_set_flags.html#3">buffering</a> for database files</td></tr> +<tr><td align=right>turn off system </td><td> <a href="../api_cxx/env_set_flags.html#5">buffering</a> for database files</td></tr> <tr><td align=right>turn off system </td><td> <a href="../api_cxx/env_set_flags.html#4">buffering</a> for log files</td></tr> -<tr><td align=right>turn off system </td><td> <a href="../api_cxx/env_set_flags.html#5">buffering</a> for log files</td></tr> +<tr><td align=right>turn off system </td><td> <a href="../api_cxx/env_set_flags.html#6">buffering</a> for log files</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/intro.html#3">building</a> for QNX</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/intro.html#2">building</a> for UNIX</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/notes.html#2">building</a> for UNIX FAQ</td></tr> <tr><td align=right></td><td> <a href="../ref/build_vxworks/intro.html#2">building</a> for VxWorks</td></tr> <tr><td align=right></td><td> <a href="../ref/build_vxworks/introae.html#2">building</a> for VxWorks AE</td></tr> <tr><td align=right></td><td> <a href="../ref/build_vxworks/faq.html#2">building</a> for VxWorks FAQ</td></tr> -<tr><td align=right></td><td> <a href="../ref/build_win/intro.html#2">building</a> for Win32</td></tr> +<tr><td align=right></td><td> <a href="../ref/build_win/intro.html#2">building</a> for Windows</td></tr> <tr><td align=right></td><td> <a href="../ref/build_win/faq.html#2">building</a> for Windows FAQ</td></tr> <tr><td align=right>selecting a </td><td> <a href="../ref/am_conf/byteorder.html#2">byte</a> order</td></tr> <tr><td align=right>configuring the </td><td> <a href="../ref/build_unix/conf.html#8">C++</a> API</td></tr> @@ -69,16 +70,16 @@ <tr><td align=right>selecting a </td><td> <a href="../ref/am_conf/cachesize.html#2">cache</a> size</td></tr> <tr><td align=right>introduction to the memory </td><td> <a href="../ref/mp/intro.html#3">cache</a> subsystem</td></tr> <tr><td align=right></td><td> <a href="../ref/transapp/archival.html#3">catastrophic</a> recovery</td></tr> -<tr><td align=right>Patches, Updates and </td><td> <a href="http://www.sleepycat.com/update/index.html">Change</a> logs</td></tr> +<tr><td align=right>Patches, Updates and </td><td> <a href="http://www.oracle.com/technology/software/products/berkeley-db/db/index.html">Change</a> logs</td></tr> <tr><td align=right>database page </td><td> <a href="../api_cxx/db_set_flags.html#2">checksum</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am/curclose.html#2">closing</a> a cursor</td></tr> <tr><td align=right></td><td> <a href="../ref/am/close.html#2">closing</a> a database</td></tr> -<tr><td align=right>database </td><td> <a href="../ref/am_misc/faq.html#3">compaction</a></td></tr> <tr><td align=right>specifying a Btree </td><td> <a href="../ref/am_conf/bt_compare.html#2">comparison</a> function</td></tr> <tr><td align=right>changing </td><td> <a href="../ref/build_unix/flags.html#2">compile</a> or load options</td></tr> <tr><td align=right></td><td> <a href="../ref/cam/intro.html#2">Concurrent</a> Data Store</td></tr> <tr><td align=right>database environment </td><td> <a href="../ref/env/db_config.html#3">configuration</a></td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/conf.html#2">configuring</a> Berkeley DB for UNIX systems</td></tr> +<tr><td align=right></td><td> <a href="../ref/program/copy.html#2">copying</a> databases</td></tr> <tr><td align=right>salvaging </td><td> <a href="../ref/am/verify.html#4">corrupted</a> databases</td></tr> <tr><td align=right></td><td> <a href="../ref/am/count.html#2">counting</a> data items for a key</td></tr> <tr><td align=right>closing a </td><td> <a href="../ref/am/curclose.html#3">cursor</a></td></tr> @@ -87,7 +88,7 @@ <tr><td align=right>retrieving records with a </td><td> <a href="../ref/am/curget.html#3">cursor</a></td></tr> <tr><td align=right>storing records with a </td><td> <a href="../ref/am/curput.html#3">cursor</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am_misc/stability.html#2">cursor</a> stability</td></tr> -<tr><td align=right></td><td> <a href="../ref/transapp/read.html#3">cursor</a> stability</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#4">cursor</a> stability</td></tr> <tr><td align=right>database </td><td> <a href="../ref/am/cursor.html#2">cursors</a></td></tr> <tr><td align=right>Dbc::put </td><td> <a href="../api_cxx/dbc_put.html#DB_AFTER">DB_AFTER</a></td></tr> <tr><td align=right>Db::verify </td><td> <a href="../api_cxx/db_verify.html#DB_AGGRESSIVE">DB_AGGRESSIVE</a></td></tr> @@ -96,18 +97,10 @@ <tr><td align=right>DbEnv::log_archive </td><td> <a href="../api_cxx/log_archive.html#DB_ARCH_DATA">DB_ARCH_DATA</a></td></tr> <tr><td align=right>DbEnv::log_archive </td><td> <a href="../api_cxx/log_archive.html#DB_ARCH_LOG">DB_ARCH_LOG</a></td></tr> <tr><td align=right>DbEnv::log_archive </td><td> <a href="../api_cxx/log_archive.html#DB_ARCH_REMOVE">DB_ARCH_REMOVE</a></td></tr> -<tr><td align=right>Db::associate </td><td> <a href="../api_cxx/db_associate.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>Db::del </td><td> <a href="../api_cxx/db_del.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>Db::put </td><td> <a href="../api_cxx/db_put.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>Db::truncate </td><td> <a href="../api_cxx/db_truncate.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> <tr><td align=right>DbEnv::dbremove </td><td> <a href="../api_cxx/env_dbremove.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> <tr><td align=right>DbEnv::dbrename </td><td> <a href="../api_cxx/env_dbrename.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>DbSequence::get </td><td> <a href="../api_cxx/seq_get.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>DbSequence::open </td><td> <a href="../api_cxx/seq_open.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> -<tr><td align=right>DbSequence::remove </td><td> <a href="../api_cxx/seq_remove.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a></td></tr> <tr><td align=right>Dbc::put </td><td> <a href="../api_cxx/dbc_put.html#DB_BEFORE">DB_BEFORE</a></td></tr> <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_BTREE">DB_BTREE</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/dbt_class.html#3">DB_BUFFER_SMALL</a></td></tr> @@ -132,21 +125,11 @@ <tr><td align=right>Dbt </td><td> <a href="../api_cxx/dbt_class.html#DB_DBT_PARTIAL">DB_DBT_PARTIAL</a></td></tr> <tr><td align=right>Dbt </td><td> <a href="../api_cxx/dbt_class.html#DB_DBT_REALLOC">DB_DBT_REALLOC</a></td></tr> <tr><td align=right>Dbt </td><td> <a href="../api_cxx/dbt_class.html#DB_DBT_USERMEM">DB_DBT_USERMEM</a></td></tr> -<tr><td align=right>Db::cursor </td><td> <a href="../api_cxx/db_cursor.html#DB_DEGREE_2">DB_DEGREE_2</a></td></tr> -<tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_DEGREE_2">DB_DEGREE_2</a></td></tr> -<tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_DEGREE_2">DB_DEGREE_2</a></td></tr> -<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_DEGREE_2">DB_DEGREE_2</a></td></tr> <tr><td align=right>DbMpoolFile::open </td><td> <a href="../api_cxx/memp_fopen.html#DB_DIRECT">DB_DIRECT</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_DIRECT_DB">DB_DIRECT_DB</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_DIRECT_LOG">DB_DIRECT_LOG</a></td></tr> -<tr><td align=right>Db::cursor </td><td> <a href="../api_cxx/db_cursor.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>Db::join </td><td> <a href="../api_cxx/db_join.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> -<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_DIRTY_READ">DB_DIRTY_READ</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/db_associate.html#3">DB_DONOTINDEX</a></td></tr> +<tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_DSYNC_DB">DB_DSYNC_DB</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_DSYNC_LOG">DB_DSYNC_LOG</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_DUP">DB_DUP</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_DUPSORT">DB_DUPSORT</a></td></tr> @@ -155,6 +138,12 @@ <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_ENCRYPT">DB_ENCRYPT</a></td></tr> <tr><td align=right>Db::set_encrypt </td><td> <a href="../api_cxx/db_set_encrypt.html#DB_ENCRYPT_AES">DB_ENCRYPT_AES</a></td></tr> <tr><td align=right>DbEnv::set_encrypt </td><td> <a href="../api_cxx/env_set_encrypt.html#DB_ENCRYPT_AES">DB_ENCRYPT_AES</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_PANIC">DB_EVENT_PANIC</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_CLIENT">DB_EVENT_REP_CLIENT</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_MASTER">DB_EVENT_REP_MASTER</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_NEWMASTER">DB_EVENT_REP_NEWMASTER</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_STARTUPDONE">DB_EVENT_REP_STARTUPDONE</a></td></tr> +<tr><td align=right>DbEnv::set_event_notify </td><td> <a href="../api_cxx/env_event_notify.html#DB_EVENT_WRITE_FAILED">DB_EVENT_WRITE_FAILED</a></td></tr> <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_EXCL">DB_EXCL</a></td></tr> <tr><td align=right>DbSequence::open </td><td> <a href="../api_cxx/seq_open.html#DB_EXCL">DB_EXCL</a></td></tr> <tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_FAST_STAT">DB_FAST_STAT</a></td></tr> @@ -164,6 +153,8 @@ <tr><td align=right>DbEnv::log_put </td><td> <a href="../api_cxx/log_put.html#DB_FLUSH">DB_FLUSH</a></td></tr> <tr><td align=right>DbEnv::remove </td><td> <a href="../api_cxx/env_remove.html#DB_FORCE">DB_FORCE</a></td></tr> <tr><td align=right>DbEnv::txn_checkpoint </td><td> <a href="../api_cxx/txn_checkpoint.html#DB_FORCE">DB_FORCE</a></td></tr> +<tr><td align=right>Db::compact </td><td> <a href="../api_cxx/db_compact.html#DB_FREELIST_ONLY">DB_FREELIST_ONLY</a></td></tr> +<tr><td align=right>Db::compact </td><td> <a href="../api_cxx/db_compact.html#DB_FREE_SPACE">DB_FREE_SPACE</a></td></tr> <tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_GET_BOTH">DB_GET_BOTH</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_GET_BOTH">DB_GET_BOTH</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_GET_BOTH_RANGE">DB_GET_BOTH_RANGE</a></td></tr> @@ -171,6 +162,7 @@ <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_HASH">DB_HASH</a></td></tr> <tr><td align=right>File naming </td><td> <a href="../ref/env/naming.html#DB_HOME">DB_HOME</a></td></tr> <tr><td align=right>File naming </td><td> <a href="../ref/env/naming.html#db_home">db_home</a></td></tr> +<tr><td align=right>Db::associate </td><td> <a href="../api_cxx/db_associate.html#DB_IMMUTABLE_KEY">DB_IMMUTABLE_KEY</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_INIT_CDB">DB_INIT_CDB</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_INIT_LOCK">DB_INIT_LOCK</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_INIT_LOG">DB_INIT_LOG</a></td></tr> @@ -178,7 +170,6 @@ <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_INIT_REP">DB_INIT_REP</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_INIT_TXN">DB_INIT_TXN</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_INORDER">DB_INORDER</a></td></tr> -<tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_JOINENV">DB_JOINENV</a></td></tr> <tr><td align=right>Db::join </td><td> <a href="../api_cxx/db_join.html#DB_JOIN_ITEM">DB_JOIN_ITEM</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_JOIN_ITEM">DB_JOIN_ITEM</a></td></tr> <tr><td align=right>Db::join </td><td> <a href="../api_cxx/db_join.html#DB_JOIN_NOSORT">DB_JOIN_NOSORT</a></td></tr> @@ -189,6 +180,7 @@ <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_LAST">DB_LAST</a></td></tr> <tr><td align=right>DbLogc::get </td><td> <a href="../api_cxx/logc_get.html#DB_LAST">DB_LAST</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_LOCKDOWN">DB_LOCKDOWN</a></td></tr> +<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a></td></tr> <tr><td align=right></td><td> <a href="../ref/program/errorret.html#4">DB_LOCK_DEADLOCK</a></td></tr> <tr><td align=right>Error returns to applications </td><td> <a href="../ref/program/errorret.html#DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a></td></tr> <tr><td align=right>DbEnv::set_lk_detect </td><td> <a href="../api_cxx/env_set_lk_detect.html#DB_LOCK_DEFAULT">DB_LOCK_DEFAULT</a></td></tr> @@ -226,13 +218,11 @@ <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_LOG_AUTOREMOVE">DB_LOG_AUTOREMOVE</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_LOG_BUFFER_FULL">DB_LOG_BUFFER_FULL</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_LOG_INMEMORY">DB_LOG_INMEMORY</a></td></tr> -<tr><td align=right>DbMpoolFile::put </td><td> <a href="../api_cxx/memp_fput.html#DB_MPOOL_CLEAN">DB_MPOOL_CLEAN</a></td></tr> -<tr><td align=right>DbMpoolFile::set </td><td> <a href="../api_cxx/memp_fset.html#DB_MPOOL_CLEAN">DB_MPOOL_CLEAN</a></td></tr> <tr><td align=right>DbMpoolFile::get </td><td> <a href="../api_cxx/memp_fget.html#DB_MPOOL_CREATE">DB_MPOOL_CREATE</a></td></tr> -<tr><td align=right>DbMpoolFile::put </td><td> <a href="../api_cxx/memp_fput.html#DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a></td></tr> -<tr><td align=right>DbMpoolFile::set </td><td> <a href="../api_cxx/memp_fset.html#DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a></td></tr> +<tr><td align=right>DbMpoolFile::get </td><td> <a href="../api_cxx/memp_fget.html#DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a></td></tr> <tr><td align=right>DbMpoolFile::put </td><td> <a href="../api_cxx/memp_fput.html#DB_MPOOL_DISCARD">DB_MPOOL_DISCARD</a></td></tr> <tr><td align=right>DbMpoolFile::set </td><td> <a href="../api_cxx/memp_fset.html#DB_MPOOL_DISCARD">DB_MPOOL_DISCARD</a></td></tr> +<tr><td align=right>DbMpoolFile::get </td><td> <a href="../api_cxx/memp_fget.html#DB_MPOOL_EDIT">DB_MPOOL_EDIT</a></td></tr> <tr><td align=right>DbMpoolFile::get </td><td> <a href="../api_cxx/memp_fget.html#DB_MPOOL_LAST">DB_MPOOL_LAST</a></td></tr> <tr><td align=right>DbMpoolFile::get </td><td> <a href="../api_cxx/memp_fget.html#DB_MPOOL_NEW">DB_MPOOL_NEW</a></td></tr> <tr><td align=right>DbMpoolFile::set_flags </td><td> <a href="../api_cxx/memp_set_flags.html#DB_MPOOL_NOFILE">DB_MPOOL_NOFILE</a></td></tr> @@ -240,6 +230,12 @@ <tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_MULTIPLE">DB_MULTIPLE</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_MULTIPLE">DB_MULTIPLE</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_MULTIPLE_KEY">DB_MULTIPLE_KEY</a></td></tr> +<tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a></td></tr> +<tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_MULTIVERSION">DB_MULTIVERSION</a></td></tr> +<tr><td align=right>DbMpoolFile::open </td><td> <a href="../api_cxx/memp_fopen.html#DB_MULTIVERSION">DB_MULTIVERSION</a></td></tr> +<tr><td align=right>DbEnv::set_isalive </td><td> <a href="../api_cxx/env_set_isalive.html#DB_MUTEX_PROCESS_ONLY">DB_MUTEX_PROCESS_ONLY</a></td></tr> +<tr><td align=right>DbEnv::mutex_alloc </td><td> <a href="../api_cxx/mutex_alloc.html#DB_MUTEX_PROCESS_ONLY">DB_MUTEX_PROCESS_ONLY</a></td></tr> +<tr><td align=right>DbEnv::mutex_alloc </td><td> <a href="../api_cxx/mutex_alloc.html#DB_MUTEX_SELF_BLOCK">DB_MUTEX_SELF_BLOCK</a></td></tr> <tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_NEXT">DB_NEXT</a></td></tr> <tr><td align=right>DbLogc::get </td><td> <a href="../api_cxx/logc_get.html#DB_NEXT">DB_NEXT</a></td></tr> <tr><td align=right>DbEnv::txn_recover </td><td> <a href="../api_cxx/txn_recover.html#DB_NEXT">DB_NEXT</a></td></tr> @@ -256,6 +252,7 @@ <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_NOPANIC">DB_NOPANIC</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/env_set_rpc_server.html#2">DB_NOSERVER</a></td></tr> <tr><td align=right>DbEnv::set_rpc_server </td><td> <a href="../api_cxx/env_set_rpc_server.html#DB_NOSERVER">DB_NOSERVER</a></td></tr> +<tr><td align=right></td><td> <a href="../api_cxx/env_set_thread_id_string.html#2">DB_NOSERVER</a></td></tr> <tr><td align=right>DbEnv::set_rpc_server </td><td> <a href="../api_cxx/env_set_rpc_server.html#DB_NOSERVER_HOME">DB_NOSERVER_HOME</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/env_set_rpc_server.html#3">DB_NOSERVER_ID</a></td></tr> <tr><td align=right>DbEnv::set_rpc_server </td><td> <a href="../api_cxx/env_set_rpc_server.html#DB_NOSERVER_ID">DB_NOSERVER_ID</a></td></tr> @@ -281,24 +278,62 @@ <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_QUEUE">DB_QUEUE</a></td></tr> <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_RDONLY">DB_RDONLY</a></td></tr> <tr><td align=right>DbMpoolFile::open </td><td> <a href="../api_cxx/memp_fopen.html#DB_RDONLY">DB_RDONLY</a></td></tr> +<tr><td align=right>Db::cursor </td><td> <a href="../api_cxx/db_cursor.html#DB_READ_COMMITTED">DB_READ_COMMITTED</a></td></tr> +<tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_READ_COMMITTED">DB_READ_COMMITTED</a></td></tr> +<tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_READ_COMMITTED">DB_READ_COMMITTED</a></td></tr> +<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_READ_COMMITTED">DB_READ_COMMITTED</a></td></tr> +<tr><td align=right>Db::cursor </td><td> <a href="../api_cxx/db_cursor.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>Db::join </td><td> <a href="../api_cxx/db_join.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>Dbc::get </td><td> <a href="../api_cxx/dbc_get.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> +<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a></td></tr> <tr><td align=right>Db::open </td><td> <a href="../api_cxx/db_open.html#DB_RECNO">DB_RECNO</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_RECNUM">DB_RECNUM</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_RECOVER">DB_RECOVER</a></td></tr> <tr><td align=right>DbEnv::set_feedback </td><td> <a href="../api_cxx/env_set_feedback.html#DB_RECOVER">DB_RECOVER</a></td></tr> <tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_RECOVER_FATAL">DB_RECOVER_FATAL</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_REGION_INIT">DB_REGION_INIT</a></td></tr> +<tr><td align=right>DbEnv::open </td><td> <a href="../api_cxx/env_open.html#DB_REGISTER">DB_REGISTER</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_RENUMBER">DB_RENUMBER</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_ALL">DB_REPMGR_ACKS_ALL</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_ALL_PEERS">DB_REPMGR_ACKS_ALL_PEERS</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_NONE">DB_REPMGR_ACKS_NONE</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_ONE">DB_REPMGR_ACKS_ONE</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_ONE_PEER">DB_REPMGR_ACKS_ONE_PEER</a></td></tr> +<tr><td align=right>DbEnv::repmgr_set_ack_policy </td><td> <a href="../api_cxx/repmgr_ack_policy.html#DB_REPMGR_ACKS_QUORUM">DB_REPMGR_ACKS_QUORUM</a></td></tr> +<tr><td align=right>DbEnv::repmgr_site_list </td><td> <a href="../api_cxx/repmgr_site_list.html#DB_REPMGR_CONNECTED">DB_REPMGR_CONNECTED</a></td></tr> +<tr><td align=right>DbEnv::repmgr_site_list </td><td> <a href="../api_cxx/repmgr_site_list.html#DB_REPMGR_DISCONNECTED">DB_REPMGR_DISCONNECTED</a></td></tr> +<tr><td align=right>DbEnv::repmgr_add_remote_site </td><td> <a href="../api_cxx/repmgr_remote_site.html#DB_REPMGR_PEER">DB_REPMGR_PEER</a></td></tr> +<tr><td align=right>DbEnv::rep_set_timeout </td><td> <a href="../api_cxx/rep_timeout.html#DB_REP_ACK_TIMEOUT">DB_REP_ACK_TIMEOUT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_ANYWHERE">DB_REP_ANYWHERE</a></td></tr> <tr><td align=right>DbEnv::rep_start </td><td> <a href="../api_cxx/rep_start.html#DB_REP_CLIENT">DB_REP_CLIENT</a></td></tr> +<tr><td align=right>DbEnv::repmgr_start </td><td> <a href="../api_cxx/repmgr_start.html#DB_REP_CLIENT">DB_REP_CLIENT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_config </td><td> <a href="../api_cxx/rep_config.html#DB_REP_CONF_BULK">DB_REP_CONF_BULK</a></td></tr> +<tr><td align=right>DbEnv::rep_set_config </td><td> <a href="../api_cxx/rep_config.html#DB_REP_CONF_DELAYCLIENT">DB_REP_CONF_DELAYCLIENT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_config </td><td> <a href="../api_cxx/rep_config.html#DB_REP_CONF_NOAUTOINIT">DB_REP_CONF_NOAUTOINIT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_config </td><td> <a href="../api_cxx/rep_config.html#DB_REP_CONF_NOWAIT">DB_REP_CONF_NOWAIT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_timeout </td><td> <a href="../api_cxx/rep_timeout.html#DB_REP_CONNECTION_RETRY">DB_REP_CONNECTION_RETRY</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_DUPMASTER">DB_REP_DUPMASTER</a></td></tr> +<tr><td align=right>DbEnv::repmgr_start </td><td> <a href="../api_cxx/repmgr_start.html#DB_REP_ELECTION">DB_REP_ELECTION</a></td></tr> +<tr><td align=right>DbEnv::rep_set_timeout </td><td> <a href="../api_cxx/rep_timeout.html#DB_REP_ELECTION_RETRY">DB_REP_ELECTION_RETRY</a></td></tr> +<tr><td align=right>DbEnv::rep_set_timeout </td><td> <a href="../api_cxx/rep_timeout.html#DB_REP_ELECTION_TIMEOUT">DB_REP_ELECTION_TIMEOUT</a></td></tr> +<tr><td align=right>DbEnv::repmgr_start </td><td> <a href="../api_cxx/repmgr_start.html#DB_REP_FULL_ELECTION">DB_REP_FULL_ELECTION</a></td></tr> +<tr><td align=right></td><td> <a href="../api_cxx/db_put.html#2">DB_REP_HANDLE_DEAD</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_HOLDELECTION">DB_REP_HOLDELECTION</a></td></tr> +<tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_IGNORE">DB_REP_IGNORE</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_ISPERM">DB_REP_ISPERM</a></td></tr> +<tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_JOIN_FAILURE">DB_REP_JOIN_FAILURE</a></td></tr> +<tr><td align=right></td><td> <a href="../api_cxx/db_put.html#3">DB_REP_LOCKOUT</a></td></tr> <tr><td align=right>DbEnv::rep_start </td><td> <a href="../api_cxx/rep_start.html#DB_REP_MASTER">DB_REP_MASTER</a></td></tr> +<tr><td align=right>DbEnv::repmgr_start </td><td> <a href="../api_cxx/repmgr_start.html#DB_REP_MASTER">DB_REP_MASTER</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_NEWMASTER">DB_REP_NEWMASTER</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_NEWSITE">DB_REP_NEWSITE</a></td></tr> -<tr><td align=right>DbEnv::set_rep_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_NOBUFFER">DB_REP_NOBUFFER</a></td></tr> +<tr><td align=right>DbEnv::rep_set_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_NOBUFFER">DB_REP_NOBUFFER</a></td></tr> <tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_NOTPERM">DB_REP_NOTPERM</a></td></tr> -<tr><td align=right>DbEnv::set_rep_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a></td></tr> -<tr><td align=right>DbEnv::rep_process_message </td><td> <a href="../api_cxx/rep_message.html#DB_REP_STARTUPDONE">DB_REP_STARTUPDONE</a></td></tr> +<tr><td align=right>DbEnv::rep_set_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a></td></tr> +<tr><td align=right>DbEnv::rep_set_transport </td><td> <a href="../api_cxx/rep_transport.html#DB_REP_REREQUEST">DB_REP_REREQUEST</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/rep_elect.html#2">DB_REP_UNAVAIL</a></td></tr> <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_REVSPLITOFF">DB_REVSPLITOFF</a></td></tr> <tr><td align=right>Db::get </td><td> <a href="../api_cxx/db_get.html#DB_RMW">DB_RMW</a></td></tr> @@ -325,11 +360,15 @@ <tr><td align=right>DbEnv::lock_stat </td><td> <a href="../api_cxx/lock_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> <tr><td align=right>DbEnv::log_stat </td><td> <a href="../api_cxx/log_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> <tr><td align=right>DbEnv::memp_stat </td><td> <a href="../api_cxx/memp_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> +<tr><td align=right>DbEnv::mutex_stat </td><td> <a href="../api_cxx/mutex_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> <tr><td align=right>DbEnv::rep_stat </td><td> <a href="../api_cxx/rep_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> <tr><td align=right>DbEnv::txn_stat </td><td> <a href="../api_cxx/txn_stat.html#DB_STAT_ALL">DB_STAT_ALL</a></td></tr> +<tr><td align=right>Db::stat </td><td> <a href="../api_cxx/db_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> +<tr><td align=right>DbEnv::stat_print </td><td> <a href="../api_cxx/env_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbEnv::lock_stat </td><td> <a href="../api_cxx/lock_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbEnv::log_stat </td><td> <a href="../api_cxx/log_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbEnv::memp_stat </td><td> <a href="../api_cxx/memp_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> +<tr><td align=right>DbEnv::mutex_stat </td><td> <a href="../api_cxx/mutex_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbEnv::rep_stat </td><td> <a href="../api_cxx/rep_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbSequence::stat </td><td> <a href="../api_cxx/seq_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> <tr><td align=right>DbEnv::txn_stat </td><td> <a href="../api_cxx/txn_stat.html#DB_STAT_CLEAR">DB_STAT_CLEAR</a></td></tr> @@ -357,6 +396,9 @@ <tr><td align=right>Db::set_flags </td><td> <a href="../api_cxx/db_set_flags.html#DB_TXN_NOT_DURABLE">DB_TXN_NOT_DURABLE</a></td></tr> <tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_TXN_NOWAIT">DB_TXN_NOWAIT</a></td></tr> <tr><td align=right>DbEnv::set_app_dispatch </td><td> <a href="../api_cxx/env_set_app_dispatch.html#DB_TXN_PRINT">DB_TXN_PRINT</a></td></tr> +<tr><td align=right>Db::cursor </td><td> <a href="../api_cxx/db_cursor.html#DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a></td></tr> +<tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a></td></tr> +<tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a></td></tr> <tr><td align=right>DbEnv::txn_begin </td><td> <a href="../api_cxx/txn_begin.html#DB_TXN_SYNC">DB_TXN_SYNC</a></td></tr> <tr><td align=right>DbTxn::commit </td><td> <a href="../api_cxx/txn_commit.html#DB_TXN_SYNC">DB_TXN_SYNC</a></td></tr> <tr><td align=right>DbEnv::set_flags </td><td> <a href="../api_cxx/env_set_flags.html#DB_TXN_WRITE_NOSYNC">DB_TXN_WRITE_NOSYNC</a></td></tr> @@ -368,6 +410,7 @@ <tr><td align=right>DbEnv::remove </td><td> <a href="../api_cxx/env_remove.html#DB_USE_ENVIRON_ROOT">DB_USE_ENVIRON_ROOT</a></td></tr> <tr><td align=right>DbEnv::set_verbose </td><td> <a href="../api_cxx/env_set_verbose.html#DB_VERB_DEADLOCK">DB_VERB_DEADLOCK</a></td></tr> <tr><td align=right>DbEnv::set_verbose </td><td> <a href="../api_cxx/env_set_verbose.html#DB_VERB_RECOVERY">DB_VERB_RECOVERY</a></td></tr> +<tr><td align=right>DbEnv::set_verbose </td><td> <a href="../api_cxx/env_set_verbose.html#DB_VERB_REGISTER">DB_VERB_REGISTER</a></td></tr> <tr><td align=right>DbEnv::set_verbose </td><td> <a href="../api_cxx/env_set_verbose.html#DB_VERB_REPLICATION">DB_VERB_REPLICATION</a></td></tr> <tr><td align=right>DbEnv::set_verbose </td><td> <a href="../api_cxx/env_set_verbose.html#DB_VERB_WAITSFOR">DB_VERB_WAITSFOR</a></td></tr> <tr><td align=right>Db::set_feedback </td><td> <a href="../api_cxx/db_set_feedback.html#DB_VERIFY">DB_VERIFY</a></td></tr> @@ -380,14 +423,15 @@ <tr><td align=right></td><td> <a href="../ref/lock/dead.html#2">deadlocks</a></td></tr> <tr><td align=right>introduction to </td><td> <a href="../ref/debug/intro.html#2">debugging</a></td></tr> <tr><td align=right></td><td> <a href="../ref/debug/common.html#2">debugging</a> applications</td></tr> -<tr><td align=right></td><td> <a href="../ref/transapp/read.html#5">degree</a> 2 isolation</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#8">degree</a> 1 isolation</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#6">degree</a> 2 isolation</td></tr> <tr><td align=right></td><td> <a href="../ref/am_misc/stability.html#4">degrees</a> of isolation</td></tr> <tr><td align=right></td><td> <a href="../ref/am/delete.html#2">deleting</a> records</td></tr> <tr><td align=right></td><td> <a href="../ref/am/curdel.html#2">deleting</a> records with a cursor</td></tr> -<tr><td align=right></td><td> <a href="../ref/transapp/read.html#8">dirty</a> reads</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#10">dirty</a> reads</td></tr> <tr><td align=right></td><td> <a href="../ref/am_misc/diskspace.html#2">disk</a> space requirements</td></tr> <tr><td align=right></td><td> <a href="../ref/xa/intro.html#2">Distributed</a> Transactions</td></tr> -<tr><td align=right></td><td> <a href="../ref/am_misc/faq.html#5">double</a> buffering</td></tr> +<tr><td align=right></td><td> <a href="../ref/am_misc/faq.html#3">double</a> buffering</td></tr> <tr><td align=right></td><td> <a href="../api_cxx/db_set_flags.html#5">duplicate</a> data items</td></tr> <tr><td align=right>sorted </td><td> <a href="../api_cxx/db_set_flags.html#6">duplicate</a> data items</td></tr> <tr><td align=right></td><td> <a href="../ref/am_conf/dup.html#2">duplicate</a> data items</td></tr> @@ -396,12 +440,12 @@ <tr><td align=right></td><td> <a href="../ref/am/truncate.html#3">emptying</a> a database</td></tr> <tr><td align=right>database </td><td> <a href="../api_cxx/db_set_flags.html#3">encryption</a></td></tr> <tr><td align=right></td><td> <a href="../ref/env/encrypt.html#2">encryption</a></td></tr> -<tr><td align=right>turn off access to a database </td><td> <a href="../api_cxx/env_set_flags.html#11">environment</a></td></tr> +<tr><td align=right>turn off access to a database </td><td> <a href="../api_cxx/env_set_flags.html#12">environment</a></td></tr> <tr><td align=right>database </td><td> <a href="../ref/env/create.html#2">environment</a></td></tr> <tr><td align=right>use </td><td> <a href="../api_cxx/env_open.html#2">environment</a> constants in naming</td></tr> <tr><td align=right>use </td><td> <a href="../api_cxx/env_remove.html#2">environment</a> constants in naming</td></tr> <tr><td align=right>database </td><td> <a href="../ref/env/faq.html#2">environment</a> FAQ</td></tr> -<tr><td align=right>fault database </td><td> <a href="../api_cxx/env_set_flags.html#12">environment</a> in during open</td></tr> +<tr><td align=right>fault database </td><td> <a href="../api_cxx/env_set_flags.html#13">environment</a> in during open</td></tr> <tr><td align=right></td><td> <a href="../ref/program/environ.html#2">environment</a> variables</td></tr> <tr><td align=right>introduction to database </td><td> <a href="../ref/env/intro.html#2">environments</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am/join.html#2">equality</a> join</td></tr> @@ -415,10 +459,10 @@ <tr><td align=right>XA </td><td> <a href="../ref/xa/faq.html#2">FAQ</a></td></tr> <tr><td align=right>configuring without large </td><td> <a href="../ref/build_unix/conf.html#4">file</a> support</td></tr> <tr><td align=right></td><td> <a href="../ref/install/file.html#3">file</a> utility</td></tr> -<tr><td align=right>returning pages to the </td><td> <a href="../ref/am_misc/faq.html#4">filesystem</a></td></tr> <tr><td align=right>recovery and </td><td> <a href="../ref/transapp/filesys.html#2">filesystem</a> operations</td></tr> <tr><td align=right>remote </td><td> <a href="../ref/env/remote.html#2">filesystems</a></td></tr> <tr><td align=right>page </td><td> <a href="../ref/am_conf/h_ffactor.html#2">fill</a> factor</td></tr> +<tr><td align=right></td><td> <a href="../ref/program/ram.html#2">Flash</a> memory configurations</td></tr> <tr><td align=right>configuring a small memory </td><td> <a href="../ref/build_unix/conf.html#12">footprint</a> library</td></tr> <tr><td align=right>Berkeley DB </td><td> <a href="../ref/program/scope.html#3">free-threaded</a> handles</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/freebsd.html#2">FreeBSD</a></td></tr> @@ -430,7 +474,8 @@ <tr><td align=right></td><td> <a href="../ref/program/compatible.html#2">interface</a> compatibility</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/irix.html#2">IRIX</a></td></tr> <tr><td align=right>degrees of </td><td> <a href="../ref/am_misc/stability.html#5">isolation</a></td></tr> -<tr><td align=right>degree 2 </td><td> <a href="../ref/transapp/read.html#6">isolation</a></td></tr> +<tr><td align=right>degree 2 </td><td> <a href="../ref/transapp/read.html#5">isolation</a></td></tr> +<tr><td align=right>degree 1 </td><td> <a href="../ref/transapp/read.html#7">isolation</a></td></tr> <tr><td align=right>configuring the </td><td> <a href="../ref/build_unix/conf.html#10">Java</a> API</td></tr> <tr><td align=right></td><td> <a href="../ref/java/compat.html#2">Java</a> compatibility</td></tr> <tr><td align=right></td><td> <a href="../ref/java/conf.html#2">Java</a> configuration</td></tr> @@ -443,7 +488,7 @@ <tr><td align=right>changing compile or </td><td> <a href="../ref/build_unix/flags.html#3">load</a> options</td></tr> <tr><td align=right>DbEnv::lock_vec </td><td> <a href="../api_cxx/lock_vec.html#lock">lock</a></td></tr> <tr><td align=right>standard </td><td> <a href="../ref/lock/stdmode.html#2">lock</a> modes</td></tr> -<tr><td align=right>ignore </td><td> <a href="../api_cxx/env_set_flags.html#8">locking</a></td></tr> +<tr><td align=right>ignore </td><td> <a href="../api_cxx/env_set_flags.html#9">locking</a></td></tr> <tr><td align=right>page-level </td><td> <a href="../ref/lock/page.html#2">locking</a></td></tr> <tr><td align=right>two-phase </td><td> <a href="../ref/lock/twopl.html#2">locking</a></td></tr> <tr><td align=right></td><td> <a href="../ref/lock/nondb.html#2">locking</a> and non-Berkeley DB applications</td></tr> @@ -456,19 +501,22 @@ <tr><td align=right>sizing the </td><td> <a href="../ref/lock/max.html#2">locking</a> subsystem</td></tr> <tr><td align=right></td><td> <a href="../ref/lock/notxn.html#2">locking</a> without transactions</td></tr> <tr><td align=right></td><td> <a href="../ref/log/limits.html#2">log</a> file limits</td></tr> -<tr><td align=right>automatic </td><td> <a href="../api_cxx/env_set_flags.html#6">log</a> file removal</td></tr> +<tr><td align=right>automatic </td><td> <a href="../api_cxx/env_set_flags.html#7">log</a> file removal</td></tr> <tr><td align=right></td><td> <a href="../ref/transapp/logfile.html#2">log</a> file removal</td></tr> <tr><td align=right></td><td> <a href="../ref/log/config.html#2">logging</a> configuration</td></tr> <tr><td align=right>introduction to the </td><td> <a href="../ref/log/intro.html#2">logging</a> subsystem</td></tr> <tr><td align=right>retrieving Btree records by </td><td> <a href="../ref/am_conf/bt_recnum.html#3">logical</a> record @number</td></tr> -<tr><td align=right>in memory </td><td> <a href="../api_cxx/env_set_flags.html#7">logs</a></td></tr> +<tr><td align=right>in memory </td><td> <a href="../api_cxx/env_set_flags.html#8">logs</a></td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/macosx.html#2">Mac</a> OS X</td></tr> -<tr><td align=right>turn off database file </td><td> <a href="../api_cxx/env_set_flags.html#9">memory</a> mapping</td></tr> +<tr><td align=right>turn off database file </td><td> <a href="../api_cxx/env_set_flags.html#10">memory</a> mapping</td></tr> <tr><td align=right></td><td> <a href="../ref/mp/config.html#2">memory</a> pool configuration</td></tr> <tr><td align=right>introduction to the </td><td> <a href="../ref/mp/intro.html#2">memory</a> pool subsystem</td></tr> <tr><td align=right>configuring for </td><td> <a href="../ref/build_win/faq.html#4">MinGW</a></td></tr> <tr><td align=right></td><td> <a href="../ref/ext/mod.html#3">mod</a></td></tr> <tr><td align=right>DbEnv::lock_vec </td><td> <a href="../api_cxx/lock_vec.html#mode">mode</a></td></tr> +<tr><td align=right></td><td> <a href="../ref/program/copy.html#3">moving</a> databases</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#12">multiversion</a> concurrency control</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#13">MVCC</a></td></tr> <tr><td align=right>Berkeley DB library </td><td> <a href="../ref/program/namespace.html#2">name</a> spaces</td></tr> <tr><td align=right>file </td><td> <a href="../ref/env/naming.html#2">naming</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am/join.html#4">natural</a> join</td></tr> @@ -480,24 +528,24 @@ <tr><td align=right></td><td> <a href="../api_cxx/db_set_flags.html#10">ordered</a> retrieval of records from Queue databases</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/osf1.html#2">OSF/1</a></td></tr> <tr><td align=right>selecting a </td><td> <a href="../ref/am_conf/pagesize.html#2">page</a> size</td></tr> -<tr><td align=right>ignore database environment </td><td> <a href="../api_cxx/env_set_flags.html#10">panic</a></td></tr> +<tr><td align=right>ignore database environment </td><td> <a href="../api_cxx/env_set_flags.html#11">panic</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am_misc/partial.html#2">partial</a> record storage and retrieval</td></tr> -<tr><td align=right></td><td> <a href="http://www.sleepycat.com/update/index.html">Patches,</a> Updates and Change logs</td></tr> +<tr><td align=right></td><td> <a href="http://www.oracle.com/technology/software/products/berkeley-db/db/index.html">Patches,</a> Updates and Change logs</td></tr> <tr><td align=right></td><td> <a href="../ref/ext/perl.html#2">Perl</a></td></tr> <tr><td align=right>retrieved key/data </td><td> <a href="../ref/am_misc/perm.html#2">permanence</a></td></tr> <tr><td align=right></td><td> <a href="../ref/ext/php.html#2">PHP</a></td></tr> <tr><td align=right>task/thread </td><td> <a href="../ref/program/faq.html#2">priority</a></td></tr> -<tr><td align=right>Sleepycat Software's Berkeley DB </td><td> <a href="../ref/intro/products.html#2">products</a></td></tr> +<tr><td align=right>Berkeley DB </td><td> <a href="../ref/intro/products.html#2">products</a></td></tr> <tr><td align=right>building for </td><td> <a href="../ref/build_unix/intro.html#5">QNX</a></td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/qnx.html#2">QNX</a></td></tr> -<tr><td align=right>dirty </td><td> <a href="../ref/transapp/read.html#7">reads</a></td></tr> +<tr><td align=right>dirty </td><td> <a href="../ref/transapp/read.html#9">reads</a></td></tr> <tr><td align=right>accessing Btree records by </td><td> <a href="../api_cxx/db_set_flags.html#7">record</a> number</td></tr> <tr><td align=right>logical </td><td> <a href="../ref/am_conf/logrec.html#2">record</a> numbers</td></tr> <tr><td align=right>managing </td><td> <a href="../ref/am_conf/recno.html#2">record-based</a> databases</td></tr> <tr><td align=right>logically renumbering </td><td> <a href="../ref/am_conf/renumber.html#2">records</a></td></tr> <tr><td align=right>Berkeley DB </td><td> <a href="../ref/transapp/reclimit.html#2">recoverability</a></td></tr> <tr><td align=right></td><td> <a href="../api_cxx/db_set_flags.html#11">renumbering</a> records in Recno databases</td></tr> -<tr><td align=right></td><td> <a href="../ref/transapp/read.html#2">repeatable</a> read</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#2">repeatable</a> reads</td></tr> <tr><td align=right>introduction to </td><td> <a href="../ref/rep/intro.html#2">replication</a></td></tr> <tr><td align=right></td><td> <a href="../ref/xa/intro.html#3">Resource</a> Manager</td></tr> <tr><td align=right>XA </td><td> <a href="../ref/xa/xa_intro.html#3">Resource</a> Manager</td></tr> @@ -519,17 +567,17 @@ <tr><td align=right>disabling </td><td> <a href="../ref/build_unix/conf.html#5">shared</a> libraries</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/shlib.html#2">shared</a> libraries</td></tr> <tr><td align=right></td><td> <a href="../ref/program/appsignals.html#2">signal</a> handling</td></tr> -<tr><td align=right></td><td> <a href="http://www.sleepycat.com/">Sleepycat</a> Software</td></tr> +<tr><td align=right></td><td> <a href="../ref/transapp/read.html#11">snapshot</a> isolation</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/solaris.html#2">Solaris</a></td></tr> <tr><td align=right></td><td> <a href="../ref/distrib/layout.html#2">source</a> code layout</td></tr> <tr><td align=right>turn off reverse </td><td> <a href="../api_cxx/db_set_flags.html#9">splits</a> in Btree databases</td></tr> <tr><td align=right>cursor </td><td> <a href="../ref/am_misc/stability.html#3">stability</a></td></tr> -<tr><td align=right>cursor </td><td> <a href="../ref/transapp/read.html#4">stability</a></td></tr> +<tr><td align=right>cursor </td><td> <a href="../ref/transapp/read.html#3">stability</a></td></tr> <tr><td align=right>disabling </td><td> <a href="../ref/build_unix/conf.html#6">static</a> libraries</td></tr> <tr><td align=right>database </td><td> <a href="../ref/am/stat.html#2">statistics</a></td></tr> <tr><td align=right></td><td> <a href="../ref/am/put.html#2">storing</a> records</td></tr> <tr><td align=right></td><td> <a href="../ref/am/curput.html#2">storing</a> records with a cursor</td></tr> -<tr><td align=right>configure for </td><td> <a href="../api_cxx/env_set_flags.html#15">stress</a> testing</td></tr> +<tr><td align=right>configure for </td><td> <a href="../api_cxx/env_set_flags.html#16">stress</a> testing</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/sunos.html#2">SunOS</a></td></tr> <tr><td align=right>loading Berkeley DB with </td><td> <a href="../ref/tcl/intro.html#2">Tcl</a></td></tr> <tr><td align=right>using Berkeley DB with </td><td> <a href="../ref/tcl/using.html#2">Tcl</a></td></tr> @@ -548,8 +596,8 @@ <tr><td align=right>building </td><td> <a href="../ref/program/mt.html#2">threaded</a> applications</td></tr> <tr><td align=right>lock </td><td> <a href="../ref/lock/timeout.html#2">timeouts</a></td></tr> <tr><td align=right>transaction </td><td> <a href="../ref/lock/timeout.html#3">timeouts</a></td></tr> -<tr><td align=right>turn off synchronous </td><td> <a href="../api_cxx/env_set_flags.html#13">transaction</a> commit</td></tr> <tr><td align=right>turn off synchronous </td><td> <a href="../api_cxx/env_set_flags.html#14">transaction</a> commit</td></tr> +<tr><td align=right>turn off synchronous </td><td> <a href="../api_cxx/env_set_flags.html#15">transaction</a> commit</td></tr> <tr><td align=right></td><td> <a href="../ref/txn/config.html#2">transaction</a> configuration</td></tr> <tr><td align=right></td><td> <a href="../ref/transapp/faq.html#2">transaction</a> FAQ</td></tr> <tr><td align=right></td><td> <a href="../ref/txn/limits.html#2">transaction</a> limits</td></tr> @@ -569,11 +617,10 @@ <tr><td align=right>transaction </td><td> <a href="../ref/transapp/tune.html#3">tuning</a></td></tr> <tr><td align=right>configuring Berkeley DB with the </td><td> <a href="../ref/xa/xa_config.html#2">Tuxedo</a> System</td></tr> <tr><td align=right></td><td> <a href="../ref/build_unix/ultrix.html#2">Ultrix</a></td></tr> -<tr><td align=right></td><td> <a href="../ref/build_win/unicode.html#2">Unicode</a></td></tr> <tr><td align=right>building for </td><td> <a href="../ref/build_unix/intro.html#4">UNIX</a></td></tr> <tr><td align=right>building for </td><td> <a href="../ref/build_unix/notes.html#3">UNIX</a> FAQ</td></tr> <tr><td align=right>configuring Berkeley DB for </td><td> <a href="../ref/build_unix/conf.html#3">UNIX</a> systems</td></tr> -<tr><td align=right>Patches, </td><td> <a href="http://www.sleepycat.com/update/index.html">Updates</a> and Change logs</td></tr> +<tr><td align=right>Patches, </td><td> <a href="http://www.oracle.com/technology/software/products/berkeley-db/db/index.html">Updates</a> and Change logs</td></tr> <tr><td align=right></td><td> <a href="../ref/am/upgrade.html#2">upgrading</a> databases</td></tr> <tr><td align=right></td><td> <a href="../ref/upgrade.2.0/toc.html#2">Upgrading</a> to release 2.0</td></tr> <tr><td align=right></td><td> <a href="../ref/upgrade.3.0/toc.html#2">Upgrading</a> to release 3.0</td></tr> @@ -584,6 +631,8 @@ <tr><td align=right></td><td> <a href="../ref/upgrade.4.1/toc.html#2">Upgrading</a> to release 4.1</td></tr> <tr><td align=right></td><td> <a href="../ref/upgrade.4.2/toc.html#2">Upgrading</a> to release 4.2</td></tr> <tr><td align=right></td><td> <a href="../ref/upgrade.4.3/toc.html#2">Upgrading</a> to release 4.3</td></tr> +<tr><td align=right></td><td> <a href="../ref/upgrade.4.4/toc.html#2">Upgrading</a> to release 4.4</td></tr> +<tr><td align=right></td><td> <a href="../ref/upgrade.4.5/toc.html#2">Upgrading</a> to release 4.5</td></tr> <tr><td align=right></td><td> <a href="../ref/arch/utilities.html#2">utilities</a></td></tr> <tr><td align=right>database </td><td> <a href="../ref/am/verify.html#2">verification</a></td></tr> <tr><td align=right>building for </td><td> <a href="../ref/build_vxworks/faq.html#3">VxWorks</a> FAQ</td></tr> @@ -596,6 +645,6 @@ <tr><td align=right></td><td> <a href="../ref/env/region.html#2">__db.001</a></td></tr> </table> </center> -<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_associate.html b/db/docs/api_cxx/db_associate.html index 512889d59..967c68e5d 100644 --- a/db/docs/api_cxx/db_associate.html +++ b/db/docs/api_cxx/db_associate.html @@ -1,5 +1,5 @@ -<!--$Id: db_associate.so,v 10.37 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_associate.so,v 10.43 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -24,8 +24,8 @@ <p> int Db::associate(DbTxn *txnid, Db *secondary, - int (*callback)(Db *, const Dbt *, const Dbt *, Dbt *), - u_int32_t flags); + int (*callback)(Db *secondary, + const Dbt *key, const Dbt *data, Dbt *result), u_int32_t flags); </pre></h3> <hr size=1 noshade> <h3>Description: Db::associate</h3> @@ -79,8 +79,12 @@ iterations and range queries will reflect only the corresponding subset of the database. If this is not desirable, the application should ensure that the callback function is well-defined for all possible values and never returns DB_DONOTINDEX.</p> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> <dt><a name="DB_CREATE">DB_CREATE</a><dd>If the secondary database is empty, walk through the primary and create an index to it in the empty secondary. This operation is potentially @@ -97,15 +101,19 @@ another thread of control, until the Db::associate call has returned successfully in the first thread. If transactions are being used, Berkeley DB will perform appropriate locking and the application need not do any special operation ordering.</p> +<dt><a name="DB_IMMUTABLE_KEY">DB_IMMUTABLE_KEY</a><dd>Specifies the secondary key is immutable. +<p>This flag can be used to optimize updates when the secondary key in a +primary record will never be changed after the primary record is +inserted. For immutable secondary keys, a best effort is made to avoid +calling the secondary callback function when primary records are +updated. This optimization may reduce the overhead of update operations +significantly if the callback function is expensive.</p> +<p>Be sure to specify this flag only if the secondary key in the primary +record is never changed. If this rule is violated, the secondary index +will become corrupted, that is, it will become out of sync with the +primary.</p> </dl> -In addition, the following flag may be set by -bitwise inclusively <b>OR</b>'ing it into the <b>flags</b> parameter: -<dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::associate call within a transaction. If the call succeeds, -changes made by the operation will be recoverable. If the call fails, -the operation will have made no changes. -</dl> -<dt><b>primary</b><dd>The associate method called should be a method off a database handle for +<dt><b>primary</b><dd>The associate method called should be a method of a database handle for the primary database that is to be indexed. <dt><b>secondary</b><dd>The <b>secondary</b> parameter should be an open database handle of either a newly created and empty database that is to be used to store @@ -117,10 +125,15 @@ with the <a href="../api_cxx/env_open.html#DB_THREAD">DB_THREAD</a> flag it is s of control after the Db::associate method has returned. Note also that either secondary keys must be unique or the secondary database must be configured with support for duplicate data items. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <h3>Errors</h3> <p>The Db::associate method @@ -131,6 +144,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>If the secondary database handle has already been associated with this or @@ -147,6 +161,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_class.html b/db/docs/api_cxx/db_class.html index 01dae8395..61b611659 100644 --- a/db/docs/api_cxx/db_class.html +++ b/db/docs/api_cxx/db_class.html @@ -1,5 +1,5 @@ -<!--$Id: db_class.so,v 10.49 2004/08/18 02:33:48 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_class.so,v 10.52 2005/12/01 02:02:58 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -45,9 +45,9 @@ The handle should not be closed while any other handle that refers to the database is in use; for example, database handles must not be closed while cursor handles into the database remain open, or transactions that include operations on the database have not yet been committed or -aborted. Once the <a href="../api_cxx/db_close.html">Db::close</a>, <a href="../api_cxx/db_remove.html">Db::remove</a>, or -<a href="../api_cxx/db_rename.html">Db::rename</a> methods are called, the handle may not be accessed again, -regardless of the method's return.</p> +aborted. Once the <a href="../api_cxx/db_close.html">Db::close</a>, <a href="../api_cxx/db_remove.html">Db::remove</a>, +<a href="../api_cxx/db_rename.html">Db::rename</a>, or <a href="../api_cxx/db_verify.html">Db::verify</a> methods are called, the handle may +not be accessed again, regardless of the method's return.</p> <p>The constructor creates a Db object that is the handle for a Berkeley DB database. The constructor allocates memory internally; calling the <a href="../api_cxx/db_close.html">Db::close</a>, <a href="../api_cxx/db_remove.html">Db::remove</a> or <a href="../api_cxx/db_rename.html">Db::rename</a> methods will @@ -105,6 +105,6 @@ Db <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_close.html b/db/docs/api_cxx/db_close.html index 0a870b481..90529a2d7 100644 --- a/db/docs/api_cxx/db_close.html +++ b/db/docs/api_cxx/db_close.html @@ -1,5 +1,5 @@ <!--$Id: db_close.so,v 10.55 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -92,6 +92,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_compact.html b/db/docs/api_cxx/db_compact.html new file mode 100644 index 000000000..a3985945e --- /dev/null +++ b/db/docs/api_cxx/db_compact.html @@ -0,0 +1,146 @@ +<!--$Id: db_compact.so,v 1.6 2006/09/08 18:36:02 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: Db::compact</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>Db::compact</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +Db::compact(DbTxn *txnid, + Dbt *start, Dbt *stop, DB_COMPACT *c_data, u_int32_t flags, Dbt *end); +</pre></h3> +<hr size=1 noshade> +<h3>Description: Db::compact</h3> +<p>The Db::compact method compacts Btree and Recno access method +databases, and optionally returns unused Btree, Hash or Recno database +pages to the underlying filesystem.</p> +<p>The Db::compact 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>txnid</b><dd>If the operation is part of an application-specified transaction, the +<b>txnid</b> parameter is a transaction handle returned from +<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise NULL. If no transaction handle is +specified, but the operation occurs in a transactional database, the +operation will be implicitly transaction protected using multiple +transactions. These transactions will be periodically committed to +avoid locking large sections of the tree. Any deadlocks encountered +cause the compaction operation to retried from the point of the last +transaction commit. +<dt><b>start</b><dd>If non-NULL, the <b>start</b> parameter is the starting point for +compaction in a Btree or Recno database. Compaction will start at the +smallest key greater than or equal to the specified key. If NULL, +compaction will start at the beginning of the database. +<dt><b>stop</b><dd>If non-NULL, the <b>stop</b> parameter is the stopping point for +compaction in a Btree or Recno database. Compaction will stop at the +page with the smallest key greater than the specified key. If NULL, +compaction will stop at the end of the database. +<dt><b>c_data</b><dd><p>If non-NULL, the <b>c_data</b> parameter contains additional compaction +configuration parameters, and returns compaction operation statistics, +in a structure of type DB_COMPACT.</p> +<p>The following input configuration fields are available from the +DB_COMPACT structure:</p> +<dl compact> +<dt>int compact_fillpercent;<dd>If non-zero, the goal for filling pages, specified as a percentage +between 1 and 100. Any page in a Btree or Recno databases not at or +above this percentage full will be considered for compaction. The +default behavior is to consider every page for compaction, regardless +of its page fill percentage. +<dt>int compact_pages;<dd>If non-zero, the call will return after that number of pages have been +freed. +<dt>db_timeout_t compact_timeout;<dd>If non-zero, and no <b>txnid</b> parameter was specified, the lock +timeout set for implicit transactions, in microseconds. +</dl> +<p>The following output statistics fields are available from the +DB_COMPACT structure:</p> +<dl compact> +<dt>u_int32_t compact_deadlock;<dd>An output statistics parameter: if no <b>txnid</b> parameter was +specified, the number of deadlocks which occurred. +<dt>u_int32_t compact_pages_examine;<dd>An output statistics parameter: the number of database pages reviewed +during the compaction phase. +<dt>u_int32_t compact_pages_free;<dd>An output statistics parameter: the number of database pages freed during +the compaction phase. +<dt>u_int32_t compact_levels;<dd>An output statistics parameter: the number of levels removed from the +Btree or Recno database during the compaction phase. +<dt>u_int32_t compact_pages_truncated;<dd>An output statistics parameter: the number of database pages returned +to the filesystem. +</dl> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +one of the following values: +<dl compact> +<dt><a name="DB_FREELIST_ONLY">DB_FREELIST_ONLY</a><dd>Do no page compaction, only returning pages to the filesystem that are +already free and at the end of the file. This flag must be set if the +database is a Hash access method database. +<dt><a name="DB_FREE_SPACE">DB_FREE_SPACE</a><dd>Return pages to the filesystem when possible. +If this flag is not specified, pages emptied as a result of compaction +will be placed on the free list for re-use, but never returned to the +filesystem. +<p>Note that only pages at the end of a file can be returned to the +filesystem. Because of the one-pass nature of the compaction algorithm, +any unemptied page near the end of the file inhibits returning pages to +the file system. A repeated call to the Db::compact method with a low +<b>compact_fillpercent</b> may be used to return pages in this case.</p> +</dl> +<dt><b>end</b><dd>If non-NULL, the <b>end</b> parameter will be filled in with the +database key marking the end of the compaction operation in a Btree or +Recno database. This is generally the first key of the page where the +operation stopped. +</dl> +<h3>Errors</h3> +<p>The Db::compact method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election +unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. +</dl> +<dl compact> +<dt>EACCES<dd>An attempt was made to modify a read-only database. +</dl> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<p>If a transactional database environment operation was selected to +resolve a deadlock, the Db::compact method will fail and +either return <a href="../ref/program/errorret.html#DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a> or +throw a <a href="../api_cxx/deadlock_class.html">DbDeadlockException</a> exception.</p> +<p>If a Berkeley DB Concurrent Data Store database environment configured for lock timeouts was unable +to grant a lock in the allowed time, the Db::compact method will fail and +either return <a href="../ref/program/errorret.html#DB_LOCK_NOTGRANTED">DB_LOCK_NOTGRANTED</a> or +throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exception.</p> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/db_class.html">Db</a> +<h3>See Also</h3> +<a href="../api_cxx/db_list.html">Databases and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/db_cursor.html b/db/docs/api_cxx/db_cursor.html index 019a82906..77709be8a 100644 --- a/db/docs/api_cxx/db_cursor.html +++ b/db/docs/api_cxx/db_cursor.html @@ -1,5 +1,5 @@ -<!--$Id: db_cursor.so,v 10.47 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_cursor.so,v 10.53 2006/08/08 05:24:02 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -27,7 +27,9 @@ Db::cursor(DbTxn *txnid, Dbc **cursorp, u_int32_t flags); </pre></h3> <hr size=1 noshade> <h3>Description: Db::cursor</h3> -The Db::cursor method returns a created database cursor. +<p>The Db::cursor method returns a created database cursor.</p> +<p>Cursors may span threads, but only serially, that is, the application +must serialize access to the cursor handle.</p> <p>The Db::cursor method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on @@ -36,27 +38,38 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>cursorp</b><dd>The <b>cursorp</b> parameter references memory into which -a pointer to the allocated cursor is copied. +a pointer to the allocated cursor is copied. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_DEGREE_2">DB_DEGREE_2</a><dd>This cursor will have degree 2 isolation. This ensures the stability -of the current data item read by this cursor but permits data read -by this cursor to be modified or deleted prior to the commit of -the transaction for this cursor. -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>All read operations performed by the cursor may return modified but not -yet committed data. Silently ignored if the <a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> flag -was not specified when the underlying database was opened. +<dt><a name="DB_READ_COMMITTED">DB_READ_COMMITTED</a><dd>This cursor will have degree 2 isolation. This ensures the stability +of the current data item read by this cursor but permits data read by +this cursor to be modified or deleted prior to the commit of the +transaction for this cursor. +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>This cursor will have degree 1 isolation. Read operations performed by +the cursor may return modified but not yet committed data. Silently +ignored if the <a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not specified when +the underlying database was opened. <dt><a name="DB_WRITECURSOR">DB_WRITECURSOR</a><dd>Specify that the cursor will be used to update the database. The underlying database environment must have been opened using the <a href="../api_cxx/env_open.html#DB_INIT_CDB">DB_INIT_CDB</a> flag. +<dt><a name="DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a><dd>Specify that the cursor operate with read-only +<a href="../ref/transapp/read.html">snapshot isolation</a>. For databases +with the <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> flag set, data values will be read as +they are when the cursor is opened, without taking read locks. This +flag implicitly begins a transaction that is committed when the cursor +is closed. Silently ignored if <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> not set on the +underlying database or if a transaction is supplied in the <b>txnid</b> +parameter. </dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. To transaction-protect cursor operations, cursors must be opened and -closed within the context of a transaction, and the <b>txnid</b> -parameter specifies the transaction context in which the cursor may be -used. +<dt><b>txnid</b><dd>Cursor operations are not automatically transaction-protected, even if +the <a href="../api_cxx/env_set_flags.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a> flag is specified to the +<a href="../api_cxx/env_set_flags.html">DbEnv::set_flags</a> or <a href="../api_cxx/db_open.html">Db::open</a> methods. If cursor operations are +to be transaction-protected, the <b>txnid</b> parameter must be a +transaction handle returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. To +transaction-protect cursor operations, cursors must be opened and closed +within the context of a transaction, and the <b>txnid</b> parameter +specifies the transaction context in which the cursor may be used. </dl> <h3>Errors</h3> <p>The Db::cursor method @@ -67,6 +80,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>An @@ -81,6 +95,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_del.html b/db/docs/api_cxx/db_del.html index 1951faa0b..a9b0edacd 100644 --- a/db/docs/api_cxx/db_del.html +++ b/db/docs/api_cxx/db_del.html @@ -1,5 +1,5 @@ -<!--$Id: db_del.so,v 10.45 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_del.so,v 10.49 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -45,18 +45,17 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. <dt><b>key</b><dd>The key <a href="../api_cxx/dbt_class.html">Dbt</a> operated on. -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: -<dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::del call within a transaction. If the call succeeds, -changes made by the operation will be recoverable. If the call fails, -the operation will have made no changes. -</dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <h3>Errors</h3> <p>The Db::del method @@ -67,6 +66,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>DB_SECONDARY_BAD<dd>A secondary index references a nonexistent primary key. @@ -95,6 +95,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_err.html b/db/docs/api_cxx/db_err.html index a9ea77f1c..1b083aab4 100644 --- a/db/docs/api_cxx/db_err.html +++ b/db/docs/api_cxx/db_err.html @@ -1,6 +1,6 @@ <!--$Id: db_err.so,v 1.3 2002/08/18 21:15:48 bostic Exp $--> -<!--$Id: env_err.so,v 10.32 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_err.so,v 10.34 2006/04/27 20:17:47 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -32,8 +32,8 @@ Db::errx(const char *fmt, ...); <p>The <a href="../api_cxx/env_err.html">DbEnv::err</a>, <a href="../api_cxx/env_err.html">DbEnv::errx</a>, Db::err and Db::errx methods provide error-messaging functionality for applications written using the Berkeley DB library.</p> -<p>The <a href="../api_cxx/env_err.html">DbEnv::err</a> method constructs an error message consisting of the -following elements:</p> +<p>The Db::err and <a href="../api_cxx/env_err.html">DbEnv::err</a> methods constructs an error message +consisting of the following elements:</p> <blockquote><dl compact> <dt>An optional prefix string<dd>If no error callback function has been set using the <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a> method, any prefix string specified using the @@ -47,6 +47,10 @@ are converted for output. <b>error</b> value, as returned by the <a href="../api_cxx/env_strerror.html">DbEnv::strerror</a> method. </dl> </blockquote> +<p>The Db::errx and <a href="../api_cxx/env_err.html">DbEnv::errx</a> methods are the same as the +Db::err and <a href="../api_cxx/env_err.html">DbEnv::err</a> methods, except they do not append the +final separator characters and standard error string to the error +message.</p> <p>This constructed error message is then handled as follows:</p> <blockquote><p>If an error callback function has been set (see <a href="../api_cxx/db_set_errcall.html">Db::set_errcall</a> and <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a>), that function is called with two @@ -67,17 +71,6 @@ is written to stderr, the standard error output stream.</p></blockquote> string. <dt><b>fmt</b><dd>The <b>fmt</b> parameter is an optional printf-style message to display. </dl> -<p>The <a href="../api_cxx/env_err.html">DbEnv::errx</a> and Db::errx methods perform identically to the -<a href="../api_cxx/env_err.html">DbEnv::err</a> and Db::err methods, except that they do not append -the final separator characters and standard error string to the error -message.</p> -<h3>Parameters</h3> -<dl compact> -<dt><b>error</b><dd>The <b>error</b> parameter is the error value for which the -<a href="../api_cxx/env_err.html">DbEnv::err</a> and Db::err methods will display a explanatory -string. -<dt><b>fmt</b><dd>The <b>fmt</b> parameter is an optional printf-style message to display. -</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/db_class.html">Db</a> @@ -87,6 +80,6 @@ string. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_fd.html b/db/docs/api_cxx/db_fd.html index 15437bebc..b0440c39b 100644 --- a/db/docs/api_cxx/db_fd.html +++ b/db/docs/api_cxx/db_fd.html @@ -1,5 +1,5 @@ -<!--$Id: db_fd.so,v 10.30 2003/10/31 15:17:43 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_fd.so,v 10.31 2005/06/14 14:06:57 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -32,9 +32,7 @@ of the underlying database. A file descriptor referring to the same file will be returned to all processes that call <a href="../api_cxx/db_open.html">Db::open</a> with the same <b>file</b> parameter.</p> <p>This file descriptor may be safely used as a parameter to the -<b>fcntl</b>(2) and <b>flock</b>(2) locking functions. The file -descriptor is not necessarily associated with any of the underlying -files actually used by the access method.</p> +<b>fcntl</b>(2) and <b>flock</b>(2) locking functions.</p> <p>The Db::fd method only supports a coarse-grained form of locking. Applications should instead use the Berkeley DB lock manager where possible.</p> <p>The Db::fd method @@ -45,7 +43,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>fdp</b><dd>The <b>fdp</b> parameter references memory into which - the current file descriptor is copied. + the current file descriptor is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -56,6 +54,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_get.html b/db/docs/api_cxx/db_get.html index 7ac771a78..304b9e645 100644 --- a/db/docs/api_cxx/db_get.html +++ b/db/docs/api_cxx/db_get.html @@ -1,5 +1,5 @@ -<!--$Id: db_get.so,v 10.84 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_get.so,v 10.89 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -96,16 +96,6 @@ of type Btree, and it must have been created with the DB_RECNUM flag.</p> In addition, the following flags may be set by bitwise inclusively <b>OR</b>'ing them into the <b>flags</b> parameter: <dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::get call within a transaction. If the call -succeeds, changes made by the operation will be recoverable. If the -call fails, the operation will have made no changes. This flag may only -be specified with the DB_CONSUME and DB_CONSUME_WAIT -flags. -<dt><a name="DB_DEGREE_2">DB_DEGREE_2</a><dd>Perform the get operation with degree 2 isolation. -The read is not repeatable. -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>Read modified but not yet committed data. Silently ignored if the -<a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> flag was not specified when the underlying -database was opened. <dt><a name="DB_MULTIPLE">DB_MULTIPLE</a><dd>Return multiple data items in the buffer to which the <b>data</b> parameter refers. <p>In the case of Btree or Hash databases, all of the data items associated @@ -131,6 +121,12 @@ into secondary indices using the <a href="../api_cxx/db_associate.html">Db::asso <p>See <a href="../api_cxx/dbt_bulk_class.html">DbMultipleDataIterator</a> for more information.</p> +<dt><a name="DB_READ_COMMITTED">DB_READ_COMMITTED</a><dd>Perform the get operation with degree 2 isolation. The read is not +repeatable. +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>Perform the get operation with degree 1 isolation, reading modified but +not yet committed data. Silently ignored if the +<a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not specified when the underlying +database was opened. <dt><a name="DB_RMW">DB_RMW</a><dd>Acquire write locks instead of read locks when doing the retrieval. Setting this flag can eliminate deadlock during a read-modify-write cycle by acquiring the write lock during the read part of the cycle so @@ -143,9 +139,15 @@ transactions.</p> </dl> <dt><b>key</b><dd>The key <a href="../api_cxx/dbt_class.html">Dbt</a> operated on. <dt><b>pkey</b><dd>The <b>pkey</b> parameter is the return key from the primary database. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <h3>Errors</h3> <p>The Db::get method @@ -156,6 +158,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>DB_SECONDARY_BAD<dd>A secondary index references a nonexistent primary key. @@ -169,6 +172,9 @@ the Db::pget method was called with a <a href="../api_cxx/db_class.html">Db</a> refer to a secondary index; or if an invalid flag value or parameter was specified. </dl> +<p>If the requested item could not be returned due to undersized buffer, the Db::get method will fail and +either return DB_BUFFER_SMALL or +throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p> <p>If a transactional database environment operation was selected to resolve a deadlock, the Db::get method will fail and either return <a href="../ref/program/errorret.html#DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a> or @@ -182,9 +188,6 @@ timers were configured and the lock could not be granted before the wait-time ex the Db::get method will fail and either return DB_LOCK_NOTGRANTED or throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exception.</p> -<p>If the requested item could not be returned due to undersized buffer, the Db::get method will fail and -either return DB_BUFFER_SMALL or -throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/db_class.html">Db</a> @@ -194,6 +197,6 @@ throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_get_byteswapped.html b/db/docs/api_cxx/db_get_byteswapped.html index 93f7a04d9..50169a3d8 100644 --- a/db/docs/api_cxx/db_get_byteswapped.html +++ b/db/docs/api_cxx/db_get_byteswapped.html @@ -1,5 +1,5 @@ <!--$Id: db_get_byteswapped.so,v 10.23 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -67,6 +67,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_get_mpf.html b/db/docs/api_cxx/db_get_mpf.html index c7105270f..b92c1074f 100644 --- a/db/docs/api_cxx/db_get_mpf.html +++ b/db/docs/api_cxx/db_get_mpf.html @@ -1,5 +1,5 @@ -<!--$Id: db_get_mpf.so,v 1.7 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_get_mpf.so,v 1.8 2005/07/20 16:22:18 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -27,11 +27,9 @@ Db::get_mpf(); </pre></h3> <hr size=1 noshade> <h3>Description: Db::get_mpf</h3> -<p>The Db::get_mpf method returns the Db.get_mpf.</p> +<p>The Db::get_mpf method returns the handle for the cache file underlying the database.</p> <p>The Db::get_mpf method may be called at any time during the life of the application.</p> -<p>Db::get_mpf gives access to the <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> associated -with a <a href="../api_cxx/db_class.html">Db</a> object.</p> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/db_class.html">Db</a> @@ -41,6 +39,6 @@ with a <a href="../api_cxx/db_class.html">Db</a> object.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_get_type.html b/db/docs/api_cxx/db_get_type.html index f0a91157f..a519b8fb4 100644 --- a/db/docs/api_cxx/db_get_type.html +++ b/db/docs/api_cxx/db_get_type.html @@ -1,5 +1,5 @@ <!--$Id: db_get_type.so,v 10.27 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -42,7 +42,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>type</b><dd>The <b>type</b> parameter references memory into which - the type of the underlying access method is copied. + the type of the underlying access method is copied. </dl> <h3>Errors</h3> <p>The Db::get_type method @@ -63,6 +63,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_getenv.html b/db/docs/api_cxx/db_getenv.html index 868b5e8e6..2c501c008 100644 --- a/db/docs/api_cxx/db_getenv.html +++ b/db/docs/api_cxx/db_getenv.html @@ -1,5 +1,5 @@ -<!--$Id: db_getenv.so,v 10.8 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_getenv.so,v 10.9 2005/07/20 16:22:49 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -27,7 +27,7 @@ Db::get_env(); </pre></h3> <hr size=1 noshade> <h3>Description: Db::getenv</h3> -<p>The Db::getenv method returns the Db.getDbEnv.</p> +<p>The Db::getenv method returns the handle for the database environment underlying the database.</p> <p>The Db::getenv method may be called at any time during the life of the application.</p> <hr size=1 noshade> @@ -39,6 +39,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_join.html b/db/docs/api_cxx/db_join.html index f35f25665..08ca7c37f 100644 --- a/db/docs/api_cxx/db_join.html +++ b/db/docs/api_cxx/db_join.html @@ -1,5 +1,5 @@ -<!--$Id: db_join.so,v 10.56 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_join.so,v 10.57 2005/02/10 20:02:28 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -51,8 +51,8 @@ The data parameter is left unchanged. In addition, the following flag may be set by bitwise inclusively <b>OR</b>'ing it into the <b>flags</b> parameter: <dl compact> -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>Read modified but not yet committed data. Silently ignored if the -<a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> flag was not specified when the underlying +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>Read modified but not yet committed data. Silently ignored if the +<a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not specified when the underlying database was opened. <dt><a name="DB_RMW">DB_RMW</a><dd>Acquire write locks instead of read locks when doing the retrieval. Setting this flag can eliminate deadlock during a read-modify-write @@ -111,6 +111,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>DB_SECONDARY_BAD<dd>A secondary index references a nonexistent primary key. @@ -129,6 +130,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_key_range.html b/db/docs/api_cxx/db_key_range.html index 55f492548..7db750f40 100644 --- a/db/docs/api_cxx/db_key_range.html +++ b/db/docs/api_cxx/db_key_range.html @@ -1,5 +1,5 @@ <!--$Id: db_key_range.so,v 10.23 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -59,9 +59,15 @@ contains three elements of type double: <b>less</b>, <b>equal</b>, and field <b>less</b> is 0.05, 5% of the keys in the database are less than the <b>key</b> parameter. The value for <b>equal</b> will be zero if there is no matching key, and will be non-zero otherwise. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. The Db::key_range method does not retain the locks it acquires for the +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. The Db::key_range method does not retain the locks it acquires for the life of the transaction, so estimates may not be repeatable. <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. </dl> @@ -74,6 +80,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>If the underlying database was not of type Btree; or if an @@ -96,6 +103,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_list.html b/db/docs/api_cxx/db_list.html index 656e55685..f3d3c5fa4 100644 --- a/db/docs/api_cxx/db_list.html +++ b/db/docs/api_cxx/db_list.html @@ -1,5 +1,5 @@ <!--$Id: db_list.so,v 1.1 2002/08/30 20:00:48 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,20 +10,19 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Databases and Related Methods</h3> -<!--$Id: m4.methods,v 1.7 2004/11/03 15:52:01 bostic Exp $--> +<!--$Id: m4.methods,v 1.11 2006/08/25 16:40:00 bostic Exp $--> <table border=1 align=center> <tr><th>Database Operations</th><th>Description</th></tr> <!--Db::--><tr><td><a href="../api_cxx/db_class.html">Db</a></td><td>Create a database handle</td></tr> <!--Db::associate--><tr><td><a href="../api_cxx/db_associate.html">Db::associate</a></td><td>Associate a secondary index</td></tr> <!--Db::close--><tr><td><a href="../api_cxx/db_close.html">Db::close</a></td><td>Close a database</td></tr> -<!--Db::cursor--><tr><td><a href="../api_cxx/db_close.html">Db::close</a></td><td>Create a cursor</td></tr> +<!--Db::compact--><tr><td><a href="../api_cxx/db_compact.html">Db::compact</a></td><td>Compact a database</td></tr> +<!--Db::cursor--><tr><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor</td></tr> <!--Db::del--><tr><td><a href="../api_cxx/db_del.html">Db::del</a></td><td>Delete items from a database</td></tr> <!--Db::err--><tr><td><a href="../api_cxx/db_err.html">Db::err</a>, <a href="../api_cxx/db_err.html">Db::errx</a></td><td>Error message</td></tr> <!--Db::fd--><tr><td><a href="../api_cxx/db_fd.html">Db::fd</a></td><td>Return a file descriptor from a database</td></tr> <!--Db::get--><tr><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> <!--Db::get_byteswapped--><tr><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> -<!--Db::get_env--><tr><td><a href="../api_cxx/db_getenv.html">Db::getenv</a></td><td>Return database environment handle</td></tr> -<!--Db::get_mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return underlying <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle</td></tr> <!--Db::get_type--><tr><td><a href="../api_cxx/db_get_type.html">Db::get_type</a></td><td>Return the database type</td></tr> <!--Db::join--><tr><td><a href="../api_cxx/db_join.html">Db::join</a></td><td>Perform a database join on cursors</td></tr> <!--Db::key_range--><tr><td><a href="../api_cxx/db_key_range.html">Db::key_range</a></td><td>Return estimate of key location</td></tr> @@ -49,7 +48,6 @@ <!--Db::set_flags--><tr><td><a href="../api_cxx/db_set_flags.html">Db::set_flags</a></td><td>General database configuration</td></tr> <!--Db::set_lorder--><tr><td><a href="../api_cxx/db_set_lorder.html">Db::set_lorder</a></td><td>Set the database byte order</td></tr> <!--Db::set_pagesize--><tr><td><a href="../api_cxx/db_set_pagesize.html">Db::set_pagesize</a></td><td>Set the underlying database page size</td></tr> -<!--Db::set_paniccall--><tr><td><a href="../api_cxx/db_set_paniccall.html">Db::set_paniccall</a></td><td>Set panic callback</td></tr> <tr><th>Btree/Recno Configuration</th><th><br></th></tr> <!--Db::set_append_recno--><tr><td><a href="../api_cxx/db_set_append_recno.html">Db::set_append_recno</a></td><td>Set record append callback</td></tr> <!--Db::set_bt_compare--><tr><td><a href="../api_cxx/db_set_bt_compare.html">Db::set_bt_compare</a></td><td>Set a Btree comparison function</td></tr> @@ -66,6 +64,6 @@ <tr><th>Queue Configuration</th><th><br></th></tr> <!--Db::set_q_extentsize--><tr><td><a href="../api_cxx/db_set_q_extentsize.html">Db::set_q_extentsize</a></td><td>Set Queue database extent size</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_open.html b/db/docs/api_cxx/db_open.html index 9894c4e03..314095537 100644 --- a/db/docs/api_cxx/db_open.html +++ b/db/docs/api_cxx/db_open.html @@ -1,5 +1,5 @@ -<!--$Id: db_open.so,v 10.106 2004/10/06 19:16:06 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_open.so,v 10.119 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -56,7 +56,7 @@ repeatedly opening and closing the database for each new query.</p> 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. -If Db::open fails, the <a href="../api_cxx/db_close.html">Db::close</a> method should be called to +If Db::open fails, the <a href="../api_cxx/db_close.html">Db::close</a> method must be called to discard the <a href="../api_cxx/db_class.html">Db</a> handle. </p> <h3>Parameters</h3> @@ -71,40 +71,49 @@ in the same physical file, it is important to consider locking and memory cache issues; see <a href="../ref/am/opensub.html">Opening multiple databases in a single file</a> for more information. <p>In-memory databases never intended to be preserved on disk may be -created by setting both the <b>file</b> and <b>database</b> parameters -to NULL. Note that in-memory databases can only ever be shared by -sharing the single database handle that created them, in circumstances -where doing so is safe.</p> +created by setting the <b>file</b> parameter to NULL. If the +<b>database</b> parameter is also NULL, the database is strictly +temporary and cannot be opened by any other thread of control, thus the +database can only be accessed by sharing the single database handle that +created it, in circumstances where doing so is safe. If the +<b>database</b> parameter is not set to NULL, the database can be opened +by other threads of control and will be replicated to client sites in +any replication group.</p> <dt><b>file</b><dd>The <b>file</b> parameter is used as the name of an underlying file that -will be used to back the database. +will be used to back the database; see <a href="../ref/env/naming.html">File naming</a> for more information. <p>In-memory databases never intended to be preserved on disk may be -created by setting both the <b>file</b> and <b>database</b> parameters -to NULL. Note that in-memory databases can only ever be shared by -sharing the single database handle that created them, in circumstances -where doing so is safe.</p> -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +created by setting the <b>file</b> parameter to NULL.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> <dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::open call within a transaction. If the call -succeeds, the open operation will be recoverable. If the call fails, -no database will have been created. +succeeds, the open operation will be recoverable and all subsequent +database modification operations based on this handle will be +transactionally protected. If the call fails, no database will have +been created. <dt><a name="DB_CREATE">DB_CREATE</a><dd>Create the database. If the database does not already exist and the DB_CREATE flag is not specified, the Db::open will fail. -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>Support dirty reads; that is, read operations on the database may -request the return of modified but not yet committed data. This flag -must be specified on all <a href="../api_cxx/db_class.html">Db</a> handles used to perform dirty reads -or database updates, otherwise requests for dirty reads may not be -honored and the read may block. <dt><a name="DB_EXCL">DB_EXCL</a><dd>Return an error if the database already exists. The DB_EXCL flag is only meaningful when specified with the DB_CREATE flag. +<dt><a name="DB_MULTIVERSION">DB_MULTIVERSION</a><dd>Open the database with support for <a href="../ref/transapp/read.html">multiversion concurrency control</a>. This will cause updates to the +database to follow a copy-on-write protocol, which is required to +support snapshot isolation. The DB_MULTIVERSION flag requires +that the database be transactionally protected during its open and is +not supported by the queue format. <dt><a name="DB_NOMMAP">DB_NOMMAP</a><dd>Do not map this database into process memory (see the <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a> method for further information). <dt><a name="DB_RDONLY">DB_RDONLY</a><dd>Open the database for reading only. Any attempt to modify items in the database will fail, regardless of the actual permissions of any underlying files. +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>Support read operations with degree 1 isolation. Read operations on the +database may request the return of modified but not yet committed data. +This flag must be specified on all <a href="../api_cxx/db_class.html">Db</a> handles used to perform +dirty reads or database updates, otherwise requests for dirty reads may +not be honored and the read may block. <dt><a name="DB_THREAD">DB_THREAD</a><dd>Cause the <a href="../api_cxx/db_class.html">Db</a> handle returned by Db::open to be <i>free-threaded</i>; that is, concurrently usable by multiple threads in the address space. @@ -126,12 +135,18 @@ defaults, and is not further specified by Berkeley DB. System shared memory segments created by the database open are created with mode <b>mode</b>, unmodified by the process' umask value. If <b>mode</b> is 0, the database open will use a default mode of readable and writable by both owner and group.</p> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. Note that transactionally protected operations on a <a href="../api_cxx/db_class.html">Db</a> handle +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +DB_AUTO_COMMIT flag is specified, +the operation will be implicitly transaction protected. Note that transactionally protected operations on a <a href="../api_cxx/db_class.html">Db</a> handle requires the <a href="../api_cxx/db_class.html">Db</a> handle itself be transactionally protected -during its open. +during its open. Also note that the transaction must be committed before +the handle is closed; see <a href="../ref/program/scope.html">Berkeley DB +handles</a> for more information. <dt><b>type</b><dd>The <b>type</b> parameter is of type DBTYPE, and must be set to one of <a name="DB_BTREE">DB_BTREE</a>, <a name="DB_HASH">DB_HASH</a>, <a name="DB_QUEUE">DB_QUEUE</a>, <a name="DB_RECNO">DB_RECNO</a>, or <a name="DB_UNKNOWN">DB_UNKNOWN</a>. If <b>type</b> is @@ -186,6 +201,7 @@ invalid flag value or parameter was specified. <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <p>If a transactional database environment operation was selected to resolve a deadlock, the Db::open method will fail and @@ -202,9 +218,9 @@ name.</p> <h3>Parameters</h3> <dl compact> <dt><b>filenamep</b><dd>The <b>filenamep</b> parameter references memory into which -a pointer to the current filename is copied. +a pointer to the current filename is copied. <dt><b>dbnamep</b><dd>The <b>dbnamep</b> parameter references memory into which -a pointer to the current database name is copied. +a pointer to the current database name is copied. </dl> <p>The Db::get_database method may be called at any time during the life of the application.</p> @@ -243,6 +259,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_put.html b/db/docs/api_cxx/db_put.html index e73fce9b0..aa948d33e 100644 --- a/db/docs/api_cxx/db_put.html +++ b/db/docs/api_cxx/db_put.html @@ -1,5 +1,5 @@ -<!--$Id: db_put.so,v 10.54 2004/08/13 03:38:55 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_put.so,v 10.59 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -71,20 +71,20 @@ supports duplicates. database. </p> </dl> -In addition, the following flag may be set by -bitwise inclusively <b>OR</b>'ing it into the <b>flags</b> parameter: -<dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::put call within a transaction. If the call succeeds, -changes made by the operation will be recoverable. If the call fails, -the operation will have made no changes. -</dl> <dt><b>data</b><dd>The data <a href="../api_cxx/dbt_class.html">Dbt</a> operated on. <dt><b>key</b><dd>The key <a href="../api_cxx/dbt_class.html">Dbt</a> operated on. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> +<a name="2"><!--meow--></a> +<a name="3"><!--meow--></a> <h3>Errors</h3> <p>The Db::put method may fail and throw @@ -97,6 +97,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>If a record number of 0 was specified; @@ -126,6 +127,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_remove.html b/db/docs/api_cxx/db_remove.html index 16ebb9aa7..37c96adb9 100644 --- a/db/docs/api_cxx/db_remove.html +++ b/db/docs/api_cxx/db_remove.html @@ -1,6 +1,6 @@ <!--$Id: db_remove.so,v 10.3 2002/08/18 21:15:51 bostic Exp $--> -<!--$Id: env_dbremove.so,v 10.48 2004/08/29 19:27:38 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_dbremove.so,v 10.49 2004/12/16 19:13:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -57,8 +57,9 @@ failure, and returns 0 on success. <dt><b>database</b><dd>The <b>database</b> parameter is the database to be removed. <dt><b>file</b><dd>The <b>file</b> parameter is the physical file which contains the database(s) to be removed. -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. </dl> <h3>Environment Variables</h3> @@ -90,6 +91,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_rename.html b/db/docs/api_cxx/db_rename.html index 19c04d5d4..e46e6253f 100644 --- a/db/docs/api_cxx/db_rename.html +++ b/db/docs/api_cxx/db_rename.html @@ -1,6 +1,6 @@ <!--$Id: db_rename.so,v 10.3 2002/08/18 21:15:51 bostic Exp $--> -<!--$Id: env_dbrename.so,v 10.36 2004/08/29 19:27:38 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_dbrename.so,v 10.37 2004/12/16 19:13:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -60,8 +60,9 @@ failure, and returns 0 on success. <dt><b>database</b><dd>The <b>database</b> parameter is the database to be renamed. <dt><b>file</b><dd>The <b>file</b> parameter is the physical file which contains the database(s) to be renamed. -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. <dt><b>newname</b><dd>The <b>newname</b> parameter is the new name of the database or file. </dl> @@ -94,6 +95,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_alloc.html b/db/docs/api_cxx/db_set_alloc.html index d9da6c738..6f8197a29 100644 --- a/db/docs/api_cxx/db_set_alloc.html +++ b/db/docs/api_cxx/db_set_alloc.html @@ -1,6 +1,6 @@ <!--$Id: db_set_alloc.so,v 10.3 2002/08/18 21:15:51 bostic Exp $--> <!--$Id: env_set_alloc.so,v 1.22 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -92,6 +92,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_append_recno.html b/db/docs/api_cxx/db_set_append_recno.html index 09875438d..814c1cee0 100644 --- a/db/docs/api_cxx/db_set_append_recno.html +++ b/db/docs/api_cxx/db_set_append_recno.html @@ -1,5 +1,5 @@ -<!--$Id: db_set_append_recno.so,v 1.23 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_set_append_recno.so,v 1.24 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -23,8 +23,7 @@ #include <db_cxx.h> <p> int -Db::set_append_recno( - int (*db_append_recno_fcn)(DB *dbp, Dbt *data, db_recno_t recno)); +Db::set_append_recno(int (*db_append_recno_fcn)(DB *dbp, Dbt *data, db_recno_t recno)); </pre></h3> <hr size=1 noshade> <h3>Description: Db::set_append_recno</h3> @@ -60,6 +59,10 @@ DB_DBT_APPMALLOC, which indicates that Berkeley DB should free the memory when it is done with it.</p> <p>The callback function must return 0 on success and <b>errno</b> or a value outside of the Berkeley DB error name space on failure.</p> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <h3>Errors</h3> <p>The Db::set_append_recno method @@ -80,6 +83,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_bt_compare.html b/db/docs/api_cxx/db_set_bt_compare.html index bc2a30f8e..fd65aaf14 100644 --- a/db/docs/api_cxx/db_set_bt_compare.html +++ b/db/docs/api_cxx/db_set_bt_compare.html @@ -1,5 +1,5 @@ <!--$Id: db_set_bt_compare.so,v 10.49 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -92,6 +92,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_bt_minkey.html b/db/docs/api_cxx/db_set_bt_minkey.html index 14ca06749..7eb5a136a 100644 --- a/db/docs/api_cxx/db_set_bt_minkey.html +++ b/db/docs/api_cxx/db_set_bt_minkey.html @@ -1,5 +1,5 @@ <!--$Id: db_set_bt_minkey.so,v 10.38 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -90,6 +90,6 @@ leaf page in <b>bt_minkeyp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_bt_prefix.html b/db/docs/api_cxx/db_set_bt_prefix.html index e151bdc2a..eec5af02f 100644 --- a/db/docs/api_cxx/db_set_bt_prefix.html +++ b/db/docs/api_cxx/db_set_bt_prefix.html @@ -1,5 +1,5 @@ <!--$Id: db_set_bt_prefix.so,v 10.48 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -95,6 +95,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_cachesize.html b/db/docs/api_cxx/db_set_cachesize.html index 72200125d..4321c99e7 100644 --- a/db/docs/api_cxx/db_set_cachesize.html +++ b/db/docs/api_cxx/db_set_cachesize.html @@ -1,6 +1,6 @@ <!--$Id: db_set_cachesize.so,v 10.21 2002/08/18 21:15:53 bostic Exp $--> -<!--$Id: env_set_cachesize.so,v 10.49 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_cachesize.so,v 10.50 2005/01/10 07:18:43 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -38,17 +38,18 @@ pages accessed simultaneously, and is usually much larger.)</p> <p>The default cache size is 256KB, and may not be specified as less than 20KB. Any cache size less than 500MB is automatically increased by 25% to account for buffer pool overhead; cache sizes larger than 500MB are -used as specified. The current maximum size of a single cache is 4GB. -(All sizes are in powers-of-two, that is, 256KB is 2^18 not 256,000.) -For information on tuning the Berkeley DB cache size, see -<a href="../ref/am_conf/cachesize.html">Selecting a cache size</a>.</p> -<p>It is possible to specify caches to Berkeley DB larger than 4GB and/or large -enough they cannot be allocated contiguously on some architectures. For -example, some releases of Solaris limit the amount of memory that may -be allocated contiguously by a process. If <b>ncache</b> is 0 or 1, -the cache will be allocated contiguously in memory. If it is greater -than 1, the cache will be broken up into <b>ncache</b> equally sized, -separate pieces of memory.</p> +used as specified. The maximum size of a single cache is 4GB on 32-bit +systems and 10TB on 64-bit systems. (All sizes are in powers-of-two, +that is, 256KB is 2^18 not 256,000.) For information on tuning the Berkeley DB +cache size, see <a href="../ref/am_conf/cachesize.html">Selecting a +cache size</a>.</p> +<p>It is possible to specify caches to Berkeley DB large enough they cannot be +allocated contiguously on some architectures. For example, some +releases of Solaris limit the amount of memory that may be allocated +contiguously by a process. If <b>ncache</b> is 0 or 1, the cache will +be allocated contiguously in memory. If it is greater than 1, the cache +will be broken up into <b>ncache</b> equally sized, separate pieces of +memory.</p> <p>Because databases opened within Berkeley DB environments use the cache specified to the environment, it is an error to attempt to set a cache in a database created within an environment.</p> @@ -93,11 +94,11 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>bytesp</b><dd>The <b>bytesp</b> parameter references memory into which - the additional bytes of memory in the cache is copied. + the additional bytes of memory in the cache is copied. <dt><b>gbytesp</b><dd>The <b>gbytesp</b> parameter references memory into which - the gigabytes of memory in the cache is copied. + the gigabytes of memory in the cache is copied. <dt><b>ncachep</b><dd>The <b>ncachep</b> parameter references memory into which - the number of caches is copied. + the number of caches is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -108,6 +109,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_dup_compare.html b/db/docs/api_cxx/db_set_dup_compare.html index 4ff9166e1..6a5e30a0d 100644 --- a/db/docs/api_cxx/db_set_dup_compare.html +++ b/db/docs/api_cxx/db_set_dup_compare.html @@ -1,5 +1,5 @@ <!--$Id: db_set_dup_compare.so,v 10.50 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -90,6 +90,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_encrypt.html b/db/docs/api_cxx/db_set_encrypt.html index 99cb5cc63..75597da1d 100644 --- a/db/docs/api_cxx/db_set_encrypt.html +++ b/db/docs/api_cxx/db_set_encrypt.html @@ -1,6 +1,6 @@ <!--$Id: db_set_encrypt.so,v 10.3 2002/08/18 21:15:54 bostic Exp $--> <!--$Id: env_set_encrypt.so,v 10.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -94,6 +94,6 @@ encryption flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_errcall.html b/db/docs/api_cxx/db_set_errcall.html index 6a435d6c4..770975cf8 100644 --- a/db/docs/api_cxx/db_set_errcall.html +++ b/db/docs/api_cxx/db_set_errcall.html @@ -1,6 +1,6 @@ <!--$Id: db_set_errcall.so,v 10.10 2002/08/18 21:15:54 bostic Exp $--> -<!--$Id: env_set_errcall.so,v 10.37 2004/10/12 20:00:47 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errcall.so,v 10.39 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -51,6 +51,9 @@ as during application debugging.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_errcall method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a> method.</p> +<p>The Db::set_errcall method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> <p>The Db::set_errcall method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -63,6 +66,10 @@ reporting function. The function takes three parameters: <a href="../api_cxx/db_set_errpfx.html">Db::set_errpfx</a> or <a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a>). <dt><b>msg</b><dd>The <b>msg</b> parameter is the error message string. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -73,6 +80,6 @@ reporting function. The function takes three parameters: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_errfile.html b/db/docs/api_cxx/db_set_errfile.html index beb630c2d..47f457961 100644 --- a/db/docs/api_cxx/db_set_errfile.html +++ b/db/docs/api_cxx/db_set_errfile.html @@ -1,6 +1,6 @@ <!--$Id: db_set_errfile.so,v 10.10 2002/08/18 21:15:54 bostic Exp $--> -<!--$Id: env_set_errfile.so,v 10.34 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errfile.so,v 10.36 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -55,6 +55,9 @@ as during application debugging.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_errfile method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_errfile.html">DbEnv::set_errfile</a> method.</p> +<p>The Db::set_errfile method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> <p>The Db::set_errfile method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -64,9 +67,19 @@ displaying additional Berkeley DB error information. </dl> <hr size=1 noshade> <h3>Description: Db::get_errfile</h3> -<p>The Db::get_errfile method returns the .</p> +<p>The Db::get_errfile method returns the FILE *.</p> <p>The Db::get_errfile method may be called at any time during the life of the application.</p> +<p>The Db::get_errfile 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>errfilep</b><dd>The Db::get_errfile method returns the +FILE * in <b>errfilep</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/db_class.html">Db</a> @@ -76,6 +89,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_error_stream.html b/db/docs/api_cxx/db_set_error_stream.html index 76f6abf96..c4bb79d52 100644 --- a/db/docs/api_cxx/db_set_error_stream.html +++ b/db/docs/api_cxx/db_set_error_stream.html @@ -1,6 +1,6 @@ <!--$Id: db_set_error_stream.so,v 10.2 2002/08/18 21:15:54 bostic Exp $--> -<!--$Id: env_set_error_stream.so,v 10.29 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_error_stream.so,v 10.30 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -54,6 +54,11 @@ as during application debugging.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_error_stream method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_error_stream.html">DbEnv::set_error_stream</a> method.</p> +<p>The Db::set_error_stream method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> +<p>The Db::set_error_stream method may be called at any time during the life of the +application.</p> <h3>Parameters</h3> <dl compact> <dt><b>stream</b><dd>The <b>stream</b> parameter is the application-specified output stream to @@ -68,6 +73,6 @@ be used for additional error information. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_errpfx.html b/db/docs/api_cxx/db_set_errpfx.html index fafde76e8..ef8101b2b 100644 --- a/db/docs/api_cxx/db_set_errpfx.html +++ b/db/docs/api_cxx/db_set_errpfx.html @@ -1,6 +1,6 @@ <!--$Id: db_set_errpfx.so,v 10.10 2002/08/18 21:15:55 bostic Exp $--> -<!--$Id: env_set_errpfx.so,v 10.33 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errpfx.so,v 10.34 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,6 +39,9 @@ closed.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_errpfx method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a> method.</p> +<p>The Db::set_errpfx method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> <p>The Db::set_errpfx method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -70,6 +73,6 @@ error prefix in <b>errpfxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_feedback.html b/db/docs/api_cxx/db_set_feedback.html index c436c22c5..5f37e396b 100644 --- a/db/docs/api_cxx/db_set_feedback.html +++ b/db/docs/api_cxx/db_set_feedback.html @@ -1,6 +1,6 @@ <!--$Id: db_set_feedback.so,v 10.29 2003/10/19 01:27:11 bostic Exp $--> -<!--$Id: env_set_feedback.so,v 10.42 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_feedback.so,v 10.43 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -24,8 +24,7 @@ #include <db_cxx.h> <p> int -Db::set_feedback( - void (*db_feedback_fcn)(DB *dbp, int opcode, int percent)); +Db::set_feedback(void (*db_feedback_fcn)(DB *dbp, int opcode, int percent)); </pre></h3> <hr size=1 noshade> <h3>Description: Db::set_feedback</h3> @@ -59,6 +58,10 @@ parameter may take on any of the following values: <dt><b>percent</b><dd>The <b>percent</b> parameter is the percent of the operation that has been completed, specified as an integer value between 0 and 100. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -69,6 +72,6 @@ been completed, specified as an integer value between 0 and 100. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_flags.html b/db/docs/api_cxx/db_set_flags.html index dbac4c7bc..5067b3462 100644 --- a/db/docs/api_cxx/db_set_flags.html +++ b/db/docs/api_cxx/db_set_flags.html @@ -1,5 +1,5 @@ <!--$Id: db_set_flags.so,v 10.68 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -296,6 +296,6 @@ current flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_h_ffactor.html b/db/docs/api_cxx/db_set_h_ffactor.html index 948b8c306..0475e217d 100644 --- a/db/docs/api_cxx/db_set_h_ffactor.html +++ b/db/docs/api_cxx/db_set_h_ffactor.html @@ -1,5 +1,5 @@ <!--$Id: db_set_h_ffactor.so,v 10.37 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -88,6 +88,6 @@ hash table density in <b>h_ffactorp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_h_hash.html b/db/docs/api_cxx/db_set_h_hash.html index 3e2df3574..98537b5c1 100644 --- a/db/docs/api_cxx/db_set_h_hash.html +++ b/db/docs/api_cxx/db_set_h_hash.html @@ -1,5 +1,5 @@ <!--$Id: db_set_h_hash.so,v 10.40 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -77,6 +77,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_h_nelem.html b/db/docs/api_cxx/db_set_h_nelem.html index 30073a927..d4da2c4f6 100644 --- a/db/docs/api_cxx/db_set_h_nelem.html +++ b/db/docs/api_cxx/db_set_h_nelem.html @@ -1,5 +1,5 @@ <!--$Id: db_set_h_nelem.so,v 10.36 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -87,6 +87,6 @@ estimate of the final size of the hash table in <b>h_nelemp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_lorder.html b/db/docs/api_cxx/db_set_lorder.html index 2e4355370..add3c5d17 100644 --- a/db/docs/api_cxx/db_set_lorder.html +++ b/db/docs/api_cxx/db_set_lorder.html @@ -1,5 +1,5 @@ <!--$Id: db_set_lorder.so,v 10.38 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -92,6 +92,6 @@ database byte order in <b>lorderp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_msg_stream.html b/db/docs/api_cxx/db_set_msg_stream.html index 3131a2a42..6f75880d9 100644 --- a/db/docs/api_cxx/db_set_msg_stream.html +++ b/db/docs/api_cxx/db_set_msg_stream.html @@ -1,6 +1,6 @@ <!--$Id: db_set_msg_stream.so,v 1.1 2004/07/14 19:30:39 bostic Exp $--> -<!--$Id: env_set_msg_stream.so,v 10.4 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msg_stream.so,v 10.5 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -45,6 +45,11 @@ approaches.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_message_stream method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_msg_stream.html">DbEnv::set_message_stream</a> method.</p> +<p>The Db::set_message_stream method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> +<p>The Db::set_message_stream method may be called at any time during the life of the +application.</p> <h3>Parameters</h3> <dl compact> <dt><b>stream</b><dd>The <b>stream</b> parameter is the application-specified output stream to @@ -59,6 +64,6 @@ be used for additional message information. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_msgcall.html b/db/docs/api_cxx/db_set_msgcall.html index 878ae80ea..73d5acc7c 100644 --- a/db/docs/api_cxx/db_set_msgcall.html +++ b/db/docs/api_cxx/db_set_msgcall.html @@ -1,6 +1,6 @@ <!--$Id: db_set_msgcall.so,v 10.1 2004/04/16 19:01:56 bostic Exp $--> -<!--$Id: env_set_msgcall.so,v 10.5 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msgcall.so,v 10.7 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -23,8 +23,7 @@ <h3><pre> #include <db_cxx.h> <p> -void Db::set_msgcall( - void (*db_msgcall_fcn)(const DbEnv *dbenv, char *msg)); +void Db::set_msgcall(void (*db_msgcall_fcn)(const DbEnv *dbenv, char *msg)); </pre></h3> <hr size=1 noshade> <h3>Description: Db::set_msgcall</h3> @@ -45,6 +44,9 @@ to display the messages via a C library FILE *.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_msgcall method affects the entire environment and is equivalent to calling the DbEnv::set_msgcall method.</p> +<p>The Db::set_msgcall method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> <p>The Db::set_msgcall method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -55,6 +57,10 @@ reporting function. The function takes two parameters: <dt><b>dbenv</b><dd>The <b>dbenv</b> parameter is the enclosing database environment. <dt><b>msg</b><dd>The <b>msg</b> parameter is the message string. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -65,6 +71,6 @@ reporting function. The function takes two parameters: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_msgfile.html b/db/docs/api_cxx/db_set_msgfile.html index b0e2b62fb..787ce7e65 100644 --- a/db/docs/api_cxx/db_set_msgfile.html +++ b/db/docs/api_cxx/db_set_msgfile.html @@ -1,6 +1,6 @@ <!--$Id: db_set_msgfile.so,v 1.1 2004/07/14 19:30:39 bostic Exp $--> -<!--$Id: env_set_msgfile.so,v 10.5 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msgfile.so,v 10.7 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -46,6 +46,9 @@ approaches.</p> <p>For <a href="../api_cxx/db_class.html">Db</a> handles opened inside of Berkeley DB environments, calling the Db::set_msgfile method affects the entire environment and is equivalent to calling the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method.</p> +<p>The Db::set_msgfile method configures operations performed using the specified +<a href="../api_cxx/db_class.html">Db</a> handle, not all operations performed on the underlying +database.</p> <p>The Db::set_msgfile method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -55,9 +58,19 @@ displaying messages. </dl> <hr size=1 noshade> <h3>Description: Db::get_msgfile</h3> -<p>The Db::get_msgfile method returns the .</p> +<p>The Db::get_msgfile method returns the FILE *.</p> <p>The Db::get_msgfile method may be called at any time during the life of the application.</p> +<p>The Db::get_msgfile 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>msgfilep</b><dd>The Db::get_msgfile method returns the +FILE * in <b>msgfilep</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/db_class.html">Db</a> @@ -67,6 +80,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_pagesize.html b/db/docs/api_cxx/db_set_pagesize.html index e8c29ef3c..de4c2f96f 100644 --- a/db/docs/api_cxx/db_set_pagesize.html +++ b/db/docs/api_cxx/db_set_pagesize.html @@ -1,5 +1,5 @@ -<!--$Id: db_set_pagesize.so,v 10.39 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_set_pagesize.so,v 10.40 2005/12/16 01:19:35 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -45,9 +45,9 @@ If the database already exists when <a href="../api_cxx/db_open.html">Db::open</a> is called, the information specified to Db::set_pagesize will be ignored. </p> -If creating additional databases in a file, the page size specified must -be consistent with the existing databases in the file or an error will -be returned. +If creating additional databases in a single physical file, information +specified to Db::set_pagesize will be ignored and the page size +of the existing databases will be used. <p>The Db::set_pagesize method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on @@ -91,6 +91,6 @@ page size in <b>pagesizep</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_q_extentsize.html b/db/docs/api_cxx/db_set_q_extentsize.html index 0944ad04f..63f24adda 100644 --- a/db/docs/api_cxx/db_set_q_extentsize.html +++ b/db/docs/api_cxx/db_set_q_extentsize.html @@ -1,5 +1,5 @@ <!--$Id: db_set_q_extentsize.so,v 1.23 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -87,6 +87,6 @@ number of pages in an extent in <b>extentsizep</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_re_delim.html b/db/docs/api_cxx/db_set_re_delim.html index 0efa76b06..85d7173ed 100644 --- a/db/docs/api_cxx/db_set_re_delim.html +++ b/db/docs/api_cxx/db_set_re_delim.html @@ -1,5 +1,5 @@ <!--$Id: db_set_re_delim.so,v 10.39 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -87,6 +87,6 @@ delimiting byte in <b>delimp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_re_len.html b/db/docs/api_cxx/db_set_re_len.html index c67ca5363..61fca4731 100644 --- a/db/docs/api_cxx/db_set_re_len.html +++ b/db/docs/api_cxx/db_set_re_len.html @@ -1,5 +1,5 @@ <!--$Id: db_set_re_len.so,v 10.40 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -94,6 +94,6 @@ record length in <b>re_lenp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_re_pad.html b/db/docs/api_cxx/db_set_re_pad.html index 713196441..c099776d7 100644 --- a/db/docs/api_cxx/db_set_re_pad.html +++ b/db/docs/api_cxx/db_set_re_pad.html @@ -1,5 +1,5 @@ <!--$Id: db_set_re_pad.so,v 10.37 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -85,6 +85,6 @@ pad character in <b>re_padp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_set_re_source.html b/db/docs/api_cxx/db_set_re_source.html index 4e3f8d179..a6234502a 100644 --- a/db/docs/api_cxx/db_set_re_source.html +++ b/db/docs/api_cxx/db_set_re_source.html @@ -1,5 +1,5 @@ <!--$Id: db_set_re_source.so,v 10.42 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -89,8 +89,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>source</b><dd>The backing flat text database file for a Recno database. -<p>On Windows, the <b>source</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>source</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> </dl> <h3>Errors</h3> <p>The Db::set_re_source method @@ -116,6 +117,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_stat.html b/db/docs/api_cxx/db_stat.html index e26b1f013..8a3f19326 100644 --- a/db/docs/api_cxx/db_stat.html +++ b/db/docs/api_cxx/db_stat.html @@ -1,5 +1,5 @@ -<!--$Id: db_stat.so,v 10.88 2004/10/29 18:42:52 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_stat.so,v 10.89 2005/02/10 20:02:28 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,21 +39,28 @@ copied into the memory location to which it refers.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or one of the following values: <dl compact> -<dt><a name="DB_DEGREE_2">DB_DEGREE_2</a><dd>Database items read during this operation will have degree 2 isolation. -This ensures the stability of the data items read during the stat -operation but permits that data to be modified or deleted by other -transactions prior to the commit of the specified transaction. -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>Database items read during this operation may include modified but not -yet committed data. Silently ignored if the <a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> flag -was not specified when the underlying database was opened. <dt><a name="DB_FAST_STAT">DB_FAST_STAT</a><dd>Return only the values which do not require traversal of the database. Among other things, this flag makes it possible for applications to request key and record counts without incurring the performance penalty of traversing the entire database. +<dt><a name="DB_READ_COMMITTED">DB_READ_COMMITTED</a><dd>Database items read during this operation will have degree 2 isolation. +This ensures the stability of the data items read during the stat +operation but permits that data to be modified or deleted by other +transactions prior to the commit of the specified transaction. +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>Database items read during this operation will have degree 1 isolation, +including modified but not yet committed data. Silently ignored if the +<a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not specified when the underlying +database was opened. </dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <p>Statistical structures are stored in allocated memory. If application-specific allocation routines have been declared (see <a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a> for more @@ -199,6 +206,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>An @@ -206,7 +214,7 @@ invalid flag value or parameter was specified. </dl> <hr size=1 noshade> <h3>Description: Db::stat_print</h3> -<p>The Db::stat_print method returns the +<p>The Db::stat_print method displays the database statistical information, as described for the Db::stat method. The information is printed to a specified output channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an @@ -221,10 +229,15 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> +<dt><a name="DB_FAST_STAT">DB_FAST_STAT</a><dd>Return only the values which do not require traversal of the database. +Among other things, this flag makes it possible for applications to +request key and record counts without incurring the performance penalty +of traversing the entire database. <dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. </dl> </dl> <hr size=1 noshade> @@ -236,6 +249,6 @@ the following value: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_sync.html b/db/docs/api_cxx/db_sync.html index 5fc73a3c9..7d1e41679 100644 --- a/db/docs/api_cxx/db_sync.html +++ b/db/docs/api_cxx/db_sync.html @@ -1,5 +1,5 @@ <!--$Id: db_sync.so,v 10.36 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -58,6 +58,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>An @@ -72,6 +73,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_truncate.html b/db/docs/api_cxx/db_truncate.html index f2a5bfcd2..0a182abe5 100644 --- a/db/docs/api_cxx/db_truncate.html +++ b/db/docs/api_cxx/db_truncate.html @@ -1,5 +1,5 @@ -<!--$Id: db_truncate.so,v 1.26 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_truncate.so,v 1.29 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -44,18 +44,17 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>countp</b><dd>The <b>countp</b> parameter references memory into which - the number of records discarded from the database is copied. -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: -<dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the Db::truncate call within a transaction. If the call succeeds, -changes made by the operation will be recoverable. If the call fails, -the operation will have made no changes. -</dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. + the number of records discarded from the database is copied. +<dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <h3>Errors</h3> <p>The Db::truncate method @@ -84,6 +83,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_upgrade.html b/db/docs/api_cxx/db_upgrade.html index c106f9037..7e3243101 100644 --- a/db/docs/api_cxx/db_upgrade.html +++ b/db/docs/api_cxx/db_upgrade.html @@ -1,5 +1,5 @@ <!--$Id: db_upgrade.so,v 10.37 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -101,6 +101,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/db_verify.html b/db/docs/api_cxx/db_verify.html index 223d2e8ae..621cc6309 100644 --- a/db/docs/api_cxx/db_verify.html +++ b/db/docs/api_cxx/db_verify.html @@ -1,5 +1,5 @@ -<!--$Id: db_verify.so,v 10.29 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: db_verify.so,v 10.30 2005/03/08 16:29:34 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -64,9 +64,10 @@ to be verified are found. the following value: <dl compact> <dt><a name="DB_SALVAGE">DB_SALVAGE</a><dd>Write the key/data pairs from all databases in the file to the file -stream named in the <b>outfile</b> parameter. The output format is the -same as that specified for the <a href="../utility/db_dump.html">db_dump</a> utility, and can be used -as input for the <a href="../utility/db_load.html">db_load</a> utility. +stream named in the <b>outfile</b> parameter. Key values are written +for Btree, Hash and Queue databases, but not for Recno databases. +<p>The output format is the same as that specified for the <a href="../utility/db_dump.html">db_dump</a> +utility, and can be used as input for the <a href="../utility/db_load.html">db_load</a> utility.</p> <p>Because the key/data pairs are output in page order as opposed to the sort order used by <a href="../utility/db_dump.html">db_dump</a>, using Db::verify to dump key/data pairs normally produces less than optimal loads for Btree databases.</p> @@ -143,6 +144,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_class.html b/db/docs/api_cxx/dbc_class.html index 1c63f983d..fc4cbb09a 100644 --- a/db/docs/api_cxx/dbc_class.html +++ b/db/docs/api_cxx/dbc_class.html @@ -1,5 +1,5 @@ <!--$Id: dbc_class.so,v 10.19 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -38,6 +38,6 @@ handle may not be accessed again, regardless of the method's return.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_close.html b/db/docs/api_cxx/dbc_close.html index d69c812ea..2664ca9b5 100644 --- a/db/docs/api_cxx/dbc_close.html +++ b/db/docs/api_cxx/dbc_close.html @@ -1,5 +1,5 @@ -<!--$Id: dbc_close.so,v 10.32 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: dbc_close.so,v 10.34 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -67,6 +67,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_count.html b/db/docs/api_cxx/dbc_count.html index f6a5b4079..f9f717496 100644 --- a/db/docs/api_cxx/dbc_count.html +++ b/db/docs/api_cxx/dbc_count.html @@ -1,5 +1,5 @@ <!--$Id: dbc_count.so,v 10.25 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -37,7 +37,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>countp</b><dd>The <b>countp</b> parameter references memory into which - the count of the number of duplicate data items is copied. + the count of the number of duplicate data items is copied. <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. </dl> <h3>Errors</h3> @@ -49,6 +49,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>If the cursor has not been initialized; or if an @@ -63,6 +64,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_del.html b/db/docs/api_cxx/dbc_del.html index c64ff0548..bd735bf7a 100644 --- a/db/docs/api_cxx/dbc_del.html +++ b/db/docs/api_cxx/dbc_del.html @@ -1,5 +1,5 @@ -<!--$Id: dbc_del.so,v 10.44 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: dbc_del.so,v 10.46 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -55,6 +55,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>DB_SECONDARY_BAD<dd>A secondary index references a nonexistent primary key. @@ -87,6 +88,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_dup.html b/db/docs/api_cxx/dbc_dup.html index 7ba5f9628..9c4eb6de2 100644 --- a/db/docs/api_cxx/dbc_dup.html +++ b/db/docs/api_cxx/dbc_dup.html @@ -1,5 +1,5 @@ <!--$Id: dbc_dup.so,v 10.32 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -58,6 +58,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>An @@ -72,6 +73,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_get.html b/db/docs/api_cxx/dbc_get.html index c647bf6a7..68bed52f6 100644 --- a/db/docs/api_cxx/dbc_get.html +++ b/db/docs/api_cxx/dbc_get.html @@ -1,5 +1,5 @@ -<!--$Id: dbc_get.so,v 10.112 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: dbc_get.so,v 10.114 2005/02/10 20:02:31 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -189,8 +189,8 @@ flag.</p> In addition, the following flags may be set by bitwise inclusively <b>OR</b>'ing them into the <b>flags</b> parameter: <dl compact> -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>Read modified but not yet committed data. Silently ignored if the -<a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> flag was not specified when the underlying +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>Read modified but not yet committed data. Silently ignored if the +<a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not specified when the underlying database was opened. <dt><a name="DB_MULTIPLE">DB_MULTIPLE</a><dd>Return multiple data items in the <b>data</b> parameter. <p>In the case of Btree or Hash databases, duplicate data items for the @@ -279,6 +279,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>DB_SECONDARY_BAD<dd>A secondary index references a nonexistent primary key. @@ -290,6 +291,9 @@ the Dbc::pget method was called with a cursor that does not refer to a secondary index; or if an invalid flag value or parameter was specified. </dl> +<p>If the requested item could not be returned due to undersized buffer, the Dbc::get method will fail and +either return DB_BUFFER_SMALL or +throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p> <p>If a transactional database environment operation was selected to resolve a deadlock, the Dbc::get method will fail and either return <a href="../ref/program/errorret.html#DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a> or @@ -298,9 +302,6 @@ throw a <a href="../api_cxx/deadlock_class.html">DbDeadlockException</a> excepti to grant a lock in the allowed time, the Dbc::get method will fail and either return <a href="../ref/program/errorret.html#DB_LOCK_NOTGRANTED">DB_LOCK_NOTGRANTED</a> or throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exception.</p> -<p>If the requested item could not be returned due to undersized buffer, the Dbc::get method will fail and -either return DB_BUFFER_SMALL or -throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/dbc_class.html">Dbc</a> @@ -310,6 +311,6 @@ throw a <a href="../api_cxx/memp_class.html">DbMemoryException</a> exception.</p <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_list.html b/db/docs/api_cxx/dbc_list.html index 49b2904b1..e3772cc00 100644 --- a/db/docs/api_cxx/dbc_list.html +++ b/db/docs/api_cxx/dbc_list.html @@ -1,5 +1,5 @@ <!--$Id: dbc_list.so,v 1.1 2002/08/30 20:00:49 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,10 +10,10 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Database Cursors and Related Methods</h3> -<!--$Id: m4.methods,v 1.3 2004/11/03 15:52:01 bostic Exp $--> +<!--$Id: m4.methods,v 1.4 2005/02/09 13:11:05 bostic Exp $--> <table border=1 align=center> <tr><th>Database Cursors and Related Methods</th><th>Description</th></tr> -<!--Db::cursor--><tr><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor handle</td></tr> +<!--Db::cursor--><tr><td><a href="../api_cxx/db_cursor.html">Db::cursor</a></td><td>Create a cursor</td></tr> <!--DbCursor::close--><tr><td><a href="../api_cxx/dbc_close.html">Dbc::close</a></td><td>Close a cursor</td></tr> <!--DbCursor::count--><tr><td><a href="../api_cxx/dbc_count.html">Dbc::count</a></td><td>Return count of duplicates</td></tr> <!--DbCursor::del--><tr><td><a href="../api_cxx/dbc_del.html">Dbc::del</a></td><td>Delete by cursor</td></tr> @@ -21,6 +21,6 @@ <!--DbCursor::get--><tr><td><a href="../api_cxx/dbc_get.html">Dbc::get</a>, <a href="../api_cxx/dbc_get.html">Dbc::pget</a></td><td>Retrieve by cursor</td></tr> <!--DbCursor::put--><tr><td><a href="../api_cxx/dbc_put.html">Dbc::put</a></td><td>Store by cursor</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbc_put.html b/db/docs/api_cxx/dbc_put.html index f364db07f..b9a952dc2 100644 --- a/db/docs/api_cxx/dbc_put.html +++ b/db/docs/api_cxx/dbc_put.html @@ -1,5 +1,5 @@ -<!--$Id: dbc_put.so,v 10.58 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: dbc_put.so,v 10.60 2006/09/13 14:30:52 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -125,6 +125,7 @@ the following non-zero errors:</p> <dl compact> <dt>DB_REP_HANDLE_DEAD<dd>The database handle has been invalidated because a replication election unrolled a committed transaction. +<dt>DB_REP_LOCKOUT<dd>The operation was blocked by client/master synchronization. </dl> <dl compact> <dt>EINVAL<dd>If the DB_AFTER, DB_BEFORE or DB_CURRENT flags @@ -162,6 +163,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbt_bulk_class.html b/db/docs/api_cxx/dbt_bulk_class.html index 307745185..9acd12223 100644 --- a/db/docs/api_cxx/dbt_bulk_class.html +++ b/db/docs/api_cxx/dbt_bulk_class.html @@ -1,5 +1,5 @@ <!--$Id: dbt_bulk_class.so,v 1.15 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -158,6 +158,6 @@ original bulk retrieval buffer. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbt_class.html b/db/docs/api_cxx/dbt_class.html index feb978c9e..b0638fa78 100644 --- a/db/docs/api_cxx/dbt_class.html +++ b/db/docs/api_cxx/dbt_class.html @@ -1,6 +1,6 @@ <!--$Id: dbt_class.so,v 10.1 2002/08/24 18:22:30 bostic Exp $--> -<!--$Id: dbt_cxx.so,v 10.69 2004/10/14 15:58:43 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: dbt_cxx.so,v 10.71 2005/04/01 01:53:16 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -189,7 +189,7 @@ information.</p> <h3>Description: Dbt::get_doff</h3> <p>Return the offset of the partial record, in bytes.</p> <hr size=1 noshade> -<h3>Description: Dbt::set_object</h3> +<h3>Description: Dbt::set_flags</h3> <p>Set the object flag value.</p> <h3>Parameters</h3> <dl compact> @@ -220,8 +220,9 @@ DB_DBT_REALLOC, and DB_DBT_USERMEM.</p> that is at least <b>ulen</b> bytes in length. If the length of the requested item is less than or equal to that number of bytes, the item is copied into the memory referred to by the <b>data</b> field. -Otherwise, the <b>size</b> field is set to the length needed for the -requested item, and the error DB_BUFFER_SMALL is returned. +Otherwise, the <b>size</b> fields of both the key and data Dbt +objects are set to the length needed for the requested item, and the +error DB_BUFFER_SMALL is returned. <p>It is an error to specify more than one of DB_DBT_MALLOC, DB_DBT_REALLOC, and DB_DBT_USERMEM.</p> </dl> @@ -271,12 +272,12 @@ bytes would be those specified by the put call.</p> </dl> </dl> <hr size=1 noshade> -<h3>Description: Dbt::set_object</h3> +<h3>Description: Dbt::get_flags</h3> <p>Return the object flag value.</p> </tt> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/dbt_package.html b/db/docs/api_cxx/dbt_package.html index 07ca6bc02..88bcfb497 100644 --- a/db/docs/api_cxx/dbt_package.html +++ b/db/docs/api_cxx/dbt_package.html @@ -1,5 +1,5 @@ <!--$Id: dbt_package.so,v 10.2 2004/08/29 14:00:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -17,6 +17,6 @@ <tr><td><a href="../api_cxx/dbt_bulk_class.html">DbMultipleKeyDataIterator</a></td><td>Next bulk get retrieval</td></tr> <tr><td><a href="../api_cxx/dbt_bulk_class.html">DbMultipleRecnoDataIterator</a></td><td>Next bulk get retrieval</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/deadlock_class.html b/db/docs/api_cxx/deadlock_class.html index 236b7c77a..b55697a1f 100644 --- a/db/docs/api_cxx/deadlock_class.html +++ b/db/docs/api_cxx/deadlock_class.html @@ -1,5 +1,5 @@ <!--$Id: deadlock_class.so,v 10.17 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -38,6 +38,6 @@ termination, and a DbDeadlockException is thrown to that thread.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_cdsgroup_begin.html b/db/docs/api_cxx/env_cdsgroup_begin.html new file mode 100644 index 000000000..1cc8af4cd --- /dev/null +++ b/db/docs/api_cxx/env_cdsgroup_begin.html @@ -0,0 +1,59 @@ +<!--$Id: env_cdsgroup_begin.so,v 1.2 2006/08/24 19:02:06 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::cdsgroup_begin</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::cdsgroup_begin</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::cdsgroup_begin(DbTxn **tid); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::cdsgroup_begin</h3> +<p>The DbEnv::cdsgroup_begin method allocates a locker ID in an +environment configured for Berkeley DB Concurrent Data Store applications. It copies a pointer to +a <a href="../api_cxx/txn_class.html">DbTxn</a> that uniquely identifies the locker ID into the memory +to which <b>tid</b> refers. Calling the <a href="../api_cxx/txn_commit.html">DbTxn::commit</a> method will +discard the allocated locker ID.</p> +<p>See <a href="../ref/cam/intro.html">Berkeley DB Concurrent Data Store applications</a> for more +information about when this is required.</p> +<p>The DbEnv::cdsgroup_begin method may be called at any time during the life of the +application.</p> +<p>The DbEnv::cdsgroup_begin 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. +</p> +<h3>Errors</h3> +<p>If the maximum number of lockers has been reached, the DbEnv::cdsgroup_begin method will fail and +either return ENOMEM or +throw a DbMemoryException.</p> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/txn_class.html">DbTxn</a> +<h3>See Also</h3> +<a href="../api_cxx/txn_list.html">Transaction Subsystem and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_class.html b/db/docs/api_cxx/env_class.html index 8e9b90287..d4c6a47d4 100644 --- a/db/docs/api_cxx/env_class.html +++ b/db/docs/api_cxx/env_class.html @@ -1,5 +1,5 @@ -<!--$Id: env_class.so,v 10.41 2004/08/18 02:33:48 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_class.so,v 10.45 2005/11/30 19:09:47 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,7 +39,7 @@ public: <p>The DbEnv object is the handle for a Berkeley DB environment -- a collection including support for some or all of caching, locking, logging and transaction subsystems, as well as databases and log files. -Methods off the DbEnv handle are used to configure the +Methods of the DbEnv handle are used to configure the environment as well as to operate on subsystems and databases in the environment.</p> <p>DbEnv handles are free-threaded if the <a href="../api_cxx/env_open.html#DB_THREAD">DB_THREAD</a> flag @@ -93,6 +93,6 @@ DbEnv <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_close.html b/db/docs/api_cxx/env_close.html index 303846928..ceb0e6d62 100644 --- a/db/docs/api_cxx/env_close.html +++ b/db/docs/api_cxx/env_close.html @@ -1,5 +1,5 @@ <!--$Id: env_close.so,v 10.38 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -78,6 +78,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_dbremove.html b/db/docs/api_cxx/env_dbremove.html index b4186551f..14219f092 100644 --- a/db/docs/api_cxx/env_dbremove.html +++ b/db/docs/api_cxx/env_dbremove.html @@ -1,5 +1,5 @@ -<!--$Id: env_dbremove.so,v 10.48 2004/08/29 19:27:38 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_dbremove.so,v 10.49 2004/12/16 19:13:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -48,8 +48,9 @@ failure, and returns 0 on success. <dt><b>database</b><dd>The <b>database</b> parameter is the database to be removed. <dt><b>file</b><dd>The <b>file</b> parameter is the physical file which contains the database(s) to be removed. -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or the following value: <dl compact> @@ -57,9 +58,14 @@ the following value: changes made by the operation will be recoverable. If the call fails, the operation will have made no changes. </dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +DB_AUTO_COMMIT flag is specified, +the operation will be implicitly transaction protected. </dl> <h3>Environment Variables</h3> <p>The @@ -98,6 +104,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_dbrename.html b/db/docs/api_cxx/env_dbrename.html index 50ee81bae..4ecdd706c 100644 --- a/db/docs/api_cxx/env_dbrename.html +++ b/db/docs/api_cxx/env_dbrename.html @@ -1,5 +1,5 @@ -<!--$Id: env_dbrename.so,v 10.36 2004/08/29 19:27:38 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_dbrename.so,v 10.37 2004/12/16 19:13:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -50,8 +50,9 @@ failure, and returns 0 on success. <dt><b>database</b><dd>The <b>database</b> parameter is the database to be renamed. <dt><b>file</b><dd>The <b>file</b> parameter is the physical file which contains the database(s) to be renamed. -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or the following value: <dl compact> @@ -60,9 +61,14 @@ changes made by the operation will be recoverable. If the call fails, the operation will have made no changes. </dl> <dt><b>newname</b><dd>The <b>newname</b> parameter is the new name of the database or file. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +DB_AUTO_COMMIT flag is specified, +the operation will be implicitly transaction protected. </dl> <h3>Environment Variables</h3> <p>The @@ -101,6 +107,6 @@ throw a <a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a> exc <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_err.html b/db/docs/api_cxx/env_err.html index cbf4836dd..638d6e0e6 100644 --- a/db/docs/api_cxx/env_err.html +++ b/db/docs/api_cxx/env_err.html @@ -1,5 +1,5 @@ -<!--$Id: env_err.so,v 10.32 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_err.so,v 10.34 2006/04/27 20:17:47 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -31,8 +31,8 @@ DbEnv::errx(const char *fmt, ...); <p>The DbEnv::err, DbEnv::errx, <a href="../api_cxx/db_err.html">Db::err</a> and <a href="../api_cxx/db_err.html">Db::errx</a> methods provide error-messaging functionality for applications written using the Berkeley DB library.</p> -<p>The DbEnv::err method constructs an error message consisting of the -following elements:</p> +<p>The <a href="../api_cxx/db_err.html">Db::err</a> and DbEnv::err methods constructs an error message +consisting of the following elements:</p> <blockquote><dl compact> <dt>An optional prefix string<dd>If no error callback function has been set using the <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a> method, any prefix string specified using the @@ -46,6 +46,10 @@ are converted for output. <b>error</b> value, as returned by the <a href="../api_cxx/env_strerror.html">DbEnv::strerror</a> method. </dl> </blockquote> +<p>The <a href="../api_cxx/db_err.html">Db::errx</a> and DbEnv::errx methods are the same as the +<a href="../api_cxx/db_err.html">Db::err</a> and DbEnv::err methods, except they do not append the +final separator characters and standard error string to the error +message.</p> <p>This constructed error message is then handled as follows:</p> <blockquote><p>If an error callback function has been set (see <a href="../api_cxx/db_set_errcall.html">Db::set_errcall</a> and <a href="../api_cxx/env_set_errcall.html">DbEnv::set_errcall</a>), that function is called with two @@ -66,17 +70,6 @@ DbEnv::err and <a href="../api_cxx/db_err.html">Db::err</a> methods will displ string. <dt><b>fmt</b><dd>The <b>fmt</b> parameter is an optional printf-style message to display. </dl> -<p>The DbEnv::errx and <a href="../api_cxx/db_err.html">Db::errx</a> methods perform identically to the -DbEnv::err and <a href="../api_cxx/db_err.html">Db::err</a> methods, except that they do not append -the final separator characters and standard error string to the error -message.</p> -<h3>Parameters</h3> -<dl compact> -<dt><b>error</b><dd>The <b>error</b> parameter is the error value for which the -DbEnv::err and <a href="../api_cxx/db_err.html">Db::err</a> methods will display a explanatory -string. -<dt><b>fmt</b><dd>The <b>fmt</b> parameter is an optional printf-style message to display. -</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a> @@ -86,6 +79,6 @@ string. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_event_notify.html b/db/docs/api_cxx/env_event_notify.html new file mode 100644 index 000000000..e0b28313e --- /dev/null +++ b/db/docs/api_cxx/env_event_notify.html @@ -0,0 +1,94 @@ +<!--$Id: env_event_notify.so,v 10.9 2006/06/27 22:49:29 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_event_notify</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_event_notify</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_event_notify(void (*db_event_fcn)(DB_ENV *dbenv, u_int32_t event, void *event_info)); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_event_notify</h3> +<p>The DbEnv::set_event_notify method configures a callback function which +is called to notify the process of specific Berkeley DB events.</p> +<p>The DbEnv::set_event_notify method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_event_notify method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_event_notify 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>db_event_fcn</b><dd>The <b>db_event_fcn</b> parameter is the application's event +notification function. The function takes three parameters: +<dl compact> +<dt>dbenv<dd>The <b>dbenv</b> parameter is the enclosing database environment handle. +<dt>event<dd>The <b>event</b> parameter is one of the following values: +<dl compact> +<dt><a name="DB_EVENT_PANIC">DB_EVENT_PANIC</a><dd>Errors can occur in the Berkeley DB library where the only solution is to shut +down the application and run recovery (for example, if Berkeley DB is unable +to allocate heap memory). In such cases, the Berkeley DB methods will +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>, +depending on the API configuration. +It is often easier to simply exit the application when such errors occur +rather than gracefully return up the stack. +<p>When <b>event</b> is set to DB_EVENT_PANIC, the database +environment has failed. All threads of control in the database +environment should exit the environment, and recovery should be run.</p> +<dt><a name="DB_EVENT_REP_CLIENT">DB_EVENT_REP_CLIENT</a><dd>The local site is now a replication client. +<dt><a name="DB_EVENT_REP_MASTER">DB_EVENT_REP_MASTER</a><dd>The local site is now the master site of its replication group. It is +the application's responsibility to begin acting as the master environment. +<dt><a name="DB_EVENT_REP_NEWMASTER">DB_EVENT_REP_NEWMASTER</a><dd>The replication group of which this site is a member has just established a +new master; the local site is not the new master. The +<b>event_info</b> parameter points to an integer containing the +environment ID of the new master. +<p>The DB_EVENT_REP_NEWMASTER event is provided only to applications using +the replication manager support.</p> +<dt><a name="DB_EVENT_REP_STARTUPDONE">DB_EVENT_REP_STARTUPDONE</a><dd>The client has completed startup synchronization and is now processing +live log records received from the master. +<dt><a name="DB_EVENT_WRITE_FAILED">DB_EVENT_WRITE_FAILED</a><dd>A Berkeley DB write to stable storage failed. +</dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> +<dt>event_info<dd>The <b>event_info</b> parameter may reference memory which contains +additional information describing an event. By default, +<b>event_info</b> is NULL; specific events may pass non-NULL values, +in which case the event will also describe the memory's structure. +</dl> +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_failchk.html b/db/docs/api_cxx/env_failchk.html new file mode 100644 index 000000000..83acfd93a --- /dev/null +++ b/db/docs/api_cxx/env_failchk.html @@ -0,0 +1,96 @@ +<!--$Id: env_failchk.so,v 10.5 2006/05/26 20:40:50 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::failchk</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::failchk</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::dbenv_failchk(u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::failchk</h3> +<p>The DbEnv::failchk method checks for threads of control (either a true +thread or a process) that have exited while manipulating Berkeley DB library +data structures, while holding a logical database lock, or with an +unresolved transaction (that is, a transaction that was never aborted +or committed). For more information, see <a href="../ref/cam/app.html">Architecting Data Store and Concurrent Data Store applications</a>, and +<a href="../ref/transapp/app.html">Architecting Transactional Data Store +applications</a>.</p> +<p>The DbEnv::failchk method is based on the "thread_id" and "is_alive" +functions specified to the <a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a> method. Applications +calling the DbEnv::failchk method must have already called the +<a href="../api_cxx/env_set_isalive.html">DbEnv::set_isalive</a> method, on the same <a href="../api_cxx/env_class.html">DbEnv</a>, and must have +configured their database environment using the +<a href="../api_cxx/env_set_thread_count.html">DbEnv::set_thread_count</a> method.</p> +<p>If DbEnv::failchk determines a thread of control exited while +holding database read locks, it will release those locks. If +DbEnv::failchk determines a thread of control exited with an +unresolved transaction, the transaction will be aborted. In either of +these cases, DbEnv::failchk will return 0 and the application may +continue to use the database environment.</p> +<p>In either of these cases, the DbEnv::failchk method will also report +the process and thread IDs associated with any released locks or +aborted transactions. The information is printed to a specified output +channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or +passed to an application callback function (see the +<a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a> method for more information).</p> +<p>If DbEnv::failchk determines a thread of control has exited such +that database environment recovery is required, it will return +<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>. In this case, the application should not +continue to use the database environment. For a further description as +to the actions the application should take when this failure occurs, see +<a href="../ref/cam/fail.html">Handling failure in Data Store and +Concurrent Data Store applications</a>, and +<a href="../ref/transapp/fail.html">Handling failure in Transactional +Data Store applications</a>.</p> +<p>The DbEnv::failchk method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::failchk 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. +</dl> +<h3>Errors</h3> +<p>The DbEnv::failchk method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_fileid_reset.html b/db/docs/api_cxx/env_fileid_reset.html new file mode 100644 index 000000000..b366b68cf --- /dev/null +++ b/db/docs/api_cxx/env_fileid_reset.html @@ -0,0 +1,76 @@ +<!--$Id: env_fileid_reset.so,v 1.3 2005/12/13 16:48:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::fileid_reset</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::fileid_reset</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::fileid_reset(const char *file, u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::fileid_reset</h3> +<p>The DbEnv::fileid_reset method allows database files to be copied, and +then the copy used in the same database environment as the original.</p> +<p>All databases contain an ID string used to identify the database in the +database environment cache. If a physical database file is copied, and +used in the same environment as another file with the same ID strings, +corruption can occur. The DbEnv::fileid_reset method creates new ID +strings for all of the databases in the physical file.</p> +<p>The DbEnv::fileid_reset method modifies the physical file, in-place. +Applications should not reset IDs in files that are currently in use.</p> +<p>The DbEnv::fileid_reset method may be called at any time during the life of the +application.</p> +<p>The DbEnv::fileid_reset 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>file</b><dd>The name of the physical file in which new file IDs are to be created. +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +the following value: +<dl compact> +<dt>DB_ENCRYPT<dd>The file contains encrypted databases. +</dl> +</dl> +<h3>Errors</h3> +<p>The DbEnv::fileid_reset method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_list.html b/db/docs/api_cxx/env_list.html index 798bd29a5..58486c7d0 100644 --- a/db/docs/api_cxx/env_list.html +++ b/db/docs/api_cxx/env_list.html @@ -1,5 +1,5 @@ <!--$Id: env_list.so,v 10.1 2002/08/30 20:00:50 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,16 +10,20 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Database Environments and Related Methods</h3> -<!--$Id: m4.methods,v 10.7 2004/11/03 15:52:01 bostic Exp $--> +<!--$Id: m4.methods,v 10.17 2006/08/25 16:40:00 bostic Exp $--> <table border=1 align=center> <tr><th>Database Environment Operations</th><th>Description</th></tr> <!--DbEnv::--><tr><td><a href="../api_cxx/env_class.html">DbEnv</a></td><td>Create an environment handle</td></tr> +<!--Db::get_env--><tr><td><a href="../api_cxx/db_getenv.html">Db::getenv</a></td><td>Return <a href="../api_cxx/db_class.html">Db</a>'s underlying <a href="../api_cxx/env_class.html">DbEnv</a> handle</td></tr> <!--DbEnv::close--><tr><td><a href="../api_cxx/env_close.html">DbEnv::close</a></td><td>Close an environment</td></tr> <!--DbEnv::dbremove--><tr><td><a href="../api_cxx/env_dbremove.html">DbEnv::dbremove</a></td><td>Remove a database</td></tr> <!--DbEnv::dbrename--><tr><td><a href="../api_cxx/env_dbrename.html">DbEnv::dbrename</a></td><td>Rename a database</td></tr> <!--DbEnv::err--><tr><td><a href="../api_cxx/env_err.html">DbEnv::err</a>, <a href="../api_cxx/env_err.html">DbEnv::errx</a></td><td>Error message</td></tr> +<!--DbEnv::failchk--><tr><td><a href="../api_cxx/env_failchk.html">DbEnv::failchk</a></td><td>Check for thread failure</td></tr> +<!--DbEnv::fileid_reset--><tr><td><a href="../api_cxx/env_fileid_reset.html">DbEnv::fileid_reset</a></td><td>Reset database file IDs</td></tr> <!--DbEnv::get_home--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_home</a></td><td>Return environment's home directory</td></tr> -<!--DbEnv::get_open_flags--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_open_flags</a></td><td>Return the flags with which the environment was opened</td></tr> +<!--DbEnv::get_open_flags--><tr><td><a href="../api_cxx/env_open.html">DbEnv::get_open_flags</a></td><td>Return flags with which the environment was opened</td></tr> +<!--DbEnv::lsn_reset--><tr><td><a href="../api_cxx/env_lsn_reset.html">DbEnv::lsn_reset</a></td><td>Reset database file LSNs</td></tr> <!--DbEnv::open--><tr><td><a href="../api_cxx/env_open.html">DbEnv::open</a></td><td>Open an environment</td></tr> <!--DbEnv::remove--><tr><td><a href="../api_cxx/env_remove.html">DbEnv::remove</a></td><td>Remove an environment</td></tr> <!--DbEnv::stat_print--><tr><td><a href="../api_cxx/env_stat.html">DbEnv::stat_print</a></td><td>Environment statistics</td></tr> @@ -35,16 +39,19 @@ <!--DbEnv::set_errfile--><tr><td><a href="../api_cxx/env_set_errfile.html">DbEnv::set_errfile</a>, <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a></td><td>Set error and informational message FILE</td></tr> <!--DbEnv::set_error_stream--><tr><td><a href="../api_cxx/env_set_error_stream.html">DbEnv::set_error_stream</a>, <a href="../api_cxx/env_set_msg_stream.html">DbEnv::set_message_stream</a></td><td>Set error and informational message output stream</td></tr> <!--DbEnv::set_errpfx--><tr><td><a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a></td><td>Set error message prefix</td></tr> +<!--DbEnv::set_event_notify--><tr><td><a href="../api_cxx/env_event_notify.html">DbEnv::set_event_notify</a></td><td>Set event notification callback</td></tr> <!--DbEnv::set_feedback--><tr><td><a href="../api_cxx/env_set_feedback.html">DbEnv::set_feedback</a></td><td>Set feedback callback</td></tr> <!--DbEnv::set_flags--><tr><td><a href="../api_cxx/env_set_flags.html">DbEnv::set_flags</a></td><td>Environment configuration</td></tr> -<!--DbEnv::set_paniccall--><tr><td><a href="../api_cxx/env_set_paniccall.html">DbEnv::set_paniccall</a></td><td>Set panic callback</td></tr> +<!--DbEnv::set_isalive--><tr><td><a href="../api_cxx/env_set_isalive.html">DbEnv::set_isalive</a></td><td>Set thread is-alive callback</td></tr> <!--DbEnv::set_rpc_server--><tr><td><a href="../api_cxx/env_set_rpc_server.html">DbEnv::set_rpc_server</a></td><td>Establish an RPC server connection</td></tr> <!--DbEnv::set_shm_key--><tr><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> -<!--DbEnv::set_tas_spins--><tr><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> +<!--DbEnv::set_thread_id--><tr><td><a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a></td><td>Set thread of control ID function</td></tr> +<!--DbEnv::set_thread_count--><tr><td><a href="../api_cxx/env_set_thread_count.html">DbEnv::set_thread_count</a></td><td>Set approximate thread count</td></tr> +<!--DbEnv::set_thread_id_string--><tr><td><a href="../api_cxx/env_set_thread_id_string.html">DbEnv::set_thread_id_string</a></td><td>Set thread of control ID format function</td></tr> <!--DbEnv::set_timeout--><tr><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> <!--DbEnv::set_tmp_dir--><tr><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> <!--DbEnv::set_verbose--><tr><td><a href="../api_cxx/env_set_verbose.html">DbEnv::set_verbose</a></td><td>Set verbose messages</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_lsn_reset.html b/db/docs/api_cxx/env_lsn_reset.html new file mode 100644 index 000000000..edbfe38ca --- /dev/null +++ b/db/docs/api_cxx/env_lsn_reset.html @@ -0,0 +1,82 @@ +<!--$Id: env_lsn_reset.so,v 1.4 2005/12/13 16:48:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::lsn_reset</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::lsn_reset</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::lsn_reset(const char *file, u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::lsn_reset</h3> +<p>The DbEnv::lsn_reset method allows database files to be moved from one +transactional database environment to another.</p> +<p>Database pages in transactional database environments contain references +to the environment's log files (that is, log sequence numbers, or LSNs). +Copying or moving a database file from one database environment to +another, and then modifying it, can result in data corruption if the +LSNs are not first cleared.</p> +<p>Note that LSNs should be reset before moving or copying the database +file into a new database environment, rather than moving or copying the +database file and then resetting the LSNs. Berkeley DB has consistency checks +that may be triggered if an application calls DbEnv::lsn_reset +on a database in a new environment when the database LSNs still reflect +the old environment.</p> +<p>The DbEnv::lsn_reset method modifies the physical file, in-place. +Applications should not reset LSNs in files that are currently in use.</p> +<p>The DbEnv::lsn_reset method may be called at any time during the life of the +application.</p> +<p>The DbEnv::lsn_reset 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>file</b><dd>The name of the physical file in which the LSNs are to be cleared. +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +the following value: +<dl compact> +<dt>DB_ENCRYPT<dd>The file contains encrypted databases. +</dl> +</dl> +<h3>Errors</h3> +<p>The DbEnv::lsn_reset method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_open.html b/db/docs/api_cxx/env_open.html index e63f2ce13..4958414b7 100644 --- a/db/docs/api_cxx/env_open.html +++ b/db/docs/api_cxx/env_open.html @@ -1,5 +1,5 @@ -<!--$Id: env_open.so,v 10.98 2004/10/14 15:07:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_open.so,v 10.111 2006/08/02 17:39:47 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -40,7 +40,7 @@ or more of the features of Berkeley DB.</p> 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. -If DbEnv::open fails, the <a href="../api_cxx/env_close.html">DbEnv::close</a> method should be called +If DbEnv::open fails, the <a href="../api_cxx/env_close.html">DbEnv::close</a> method must be called to discard the <a href="../api_cxx/env_class.html">DbEnv</a> handle. </p> <h3>Parameters</h3> @@ -51,8 +51,9 @@ resolution in general, see <a href="../ref/env/naming.html">Berkeley DB File Naming</a>. The environment variable <b>DB_HOME</b> may be used as the path of the database home, as described in <a href="../ref/env/naming.html">Berkeley DB File Naming</a>. -<p>On Windows, the <b>db_home</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>db_home</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter specifies the subsystems that are initialized and how the application's environment affects Berkeley DB file naming, among other things. @@ -60,11 +61,20 @@ The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>' or more of the following values: <p>Because there are a large number of flags that can be specified, they have been grouped together by functionality. The first group of flags -indicates which of the Berkeley DB subsystems should be initialized:</p> +indicates which of the Berkeley DB subsystems should be initialized.</p> +<p>The choice of subsystems initialized for a Berkeley DB database environment +is specified by the thread of control initially creating the +environment. Any subsequent thread of control joining the environment +will automatically be configured to use the same subsystems as were +created in the environment (unless the thread of control requests a +subsystem not available in the environment, which will fail). +Applications joining an environment, able to adapt to whatever +subsystems have been configured in the environment, should open the +environment without specifying any subsystem flags. Applications +joining an environment, requiring specific subsystems from their +environments, should open the environment specifying those specific +subsystem flags.</p> <dl compact> -<dt><a name="DB_JOINENV">DB_JOINENV</a><dd>Join an existing environment. This option allows applications to -join an existing environment without knowing which Berkeley DB subsystems -the environment supports. <dt><a name="DB_INIT_CDB">DB_INIT_CDB</a><dd>Initialize locking for the <a href="../ref/cam/intro.html">Berkeley DB Concurrent Data Store</a> product. In this mode, Berkeley DB provides multiple reader/single writer access. The only other subsystem that should be specified with the @@ -96,11 +106,14 @@ DB_INIT_TXN flag implies the DB_INIT_LOG flag. the environment is initialized:</p> <dl compact> <dt><a name="DB_RECOVER">DB_RECOVER</a><dd>Run normal recovery on this environment before opening it for normal -use. If this flag is set, the DB_CREATE flag must also be set -because the regions will be removed and re-created. +use. If this flag is set, the DB_CREATE and DB_INIT_TXN +flags must also be set, because the regions will be removed and +re-created, and transactions are required for application recovery. <dt><a name="DB_RECOVER_FATAL">DB_RECOVER_FATAL</a><dd>Run catastrophic recovery on this environment before opening it for -normal use. If this flag is set, the DB_CREATE flag must also -be set because the regions will be removed and re-created. +normal use. If this flag is set, the DB_CREATE and +DB_INIT_TXN flags must also be set, because the regions will be +removed and re-created, and transactions are required for application +recovery. </dl> <p>A standard part of the recovery process is to remove the existing Berkeley DB environment and create a new one in which to perform recovery. If the @@ -146,27 +159,45 @@ example, users with a user-ID of 0 on UNIX systems). <dt><a name="DB_CREATE">DB_CREATE</a><dd>Cause Berkeley DB subsystems to create any underlying files, as necessary. <dt><a name="DB_LOCKDOWN">DB_LOCKDOWN</a><dd>Lock shared Berkeley DB environment files and memory-mapped databases into memory. -<dt><a name="DB_PRIVATE">DB_PRIVATE</a><dd>Specify that the environment will only be accessed by a single process -(although that process may be multithreaded). This flag has two effects -on the Berkeley DB environment. First, all underlying data structures are -allocated from per-process memory instead of from shared memory that is -potentially accessible to more than a single process. Second, mutexes -are only configured to work between threads. +<dt><a name="DB_PRIVATE">DB_PRIVATE</a><dd>Allocate region memory from the heap instead of from memory backed by +the filesystem or system shared memory. +<p>This flag implies the environment will only be accessed by a single +process (although that process may be multithreaded). This flag has two +effects on the Berkeley DB environment. First, all underlying data structures +are allocated from per-process memory instead of from shared memory that +is accessible to more than a single process. Second, mutexes are only +configured to work between threads.</p> <p>This flag should not be specified if more than a single process is accessing the environment because it is likely to cause database corruption and unpredictable behavior. For example, if both a server -application and the Berkeley DB utility <a href="../utility/db_stat.html">db_stat</a> are expected to access -the environment, the DB_PRIVATE flag should not be -specified.</p> -<dt><a name="DB_SYSTEM_MEM">DB_SYSTEM_MEM</a><dd>Allocate memory from system shared memory instead of from memory backed -by the filesystem. See <a href="../ref/env/region.html">Shared Memory -Regions</a> for more information. +application and Berkeley DB utilities (for example, <a href="../utility/db_archive.html">db_archive</a>, +<a href="../utility/db_checkpoint.html">db_checkpoint</a> or <a href="../utility/db_stat.html">db_stat</a>) are expected to access the +environment, the DB_PRIVATE flag should not be specified.</p> +<p>See <a href="../ref/env/region.html">Shared Memory Regions</a> for more +information.</p> +<dt><a name="DB_REGISTER">DB_REGISTER</a><dd>Check to see if recovery needs to be performed before opening the +database environment. (For this check to be accurate, all processes +using the environment must specify DB_REGISTER when opening the +environment.) If recovery needs to be performed for any reason +(including the initial use of the DB_REGISTER flag), and +DB_RECOVER is also specified, recovery will be performed and the +open will proceed normally. If recovery needs to be performed and +DB_RECOVER is not specified, <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> will be +returned. If recovery does not need to be performed, the +DB_RECOVER flag will be ignored. See +<a href="../ref/transapp/app.html">Architecting Transactional Data Store +applications</a> for more information. +<dt><a name="DB_SYSTEM_MEM">DB_SYSTEM_MEM</a><dd>Allocate region memory from system shared memory instead of from heap +memory or memory backed by the filesystem. +<p>See <a href="../ref/env/region.html">Shared Memory Regions</a> for more +information.</p> <dt><a name="DB_THREAD">DB_THREAD</a><dd>Cause the <a href="../api_cxx/env_class.html">DbEnv</a> handle returned by DbEnv::open to be <i>free-threaded</i>; that is, concurrently usable by multiple threads in the address space. The DB_THREAD flag should be specified -if the <a href="../api_cxx/env_class.html">DbEnv</a> handle will be concurrently used by multiple -threads of control or if multiple DB handles, opened within the database -environment, will be used concurrently. +if the <a href="../api_cxx/env_class.html">DbEnv</a> handle will be concurrently used by more than one +thread in the process, or if any <a href="../api_cxx/db_class.html">Db</a> handles opened in the scope +of the <a href="../api_cxx/env_class.html">DbEnv</a> handle will be concurrently used by more than one +thread in the process. </dl> <dt><b>mode</b><dd>On Windows systems, the mode parameter is ignored. <p>On UNIX systems or in IEEE/ANSI Std 1003.1 (POSIX) environments, files created by Berkeley DB @@ -187,6 +218,10 @@ may fail and throw encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> +<dt>DB_RUNRECOVERY<dd>The DB_REGISTER flag was specified, a failure has occurred, and no +recovery flag was specified. +</dl> +<dl compact> <dt>DB_VERSION_MISMATCH<dd>The version of the Berkeley DB library doesn't match the version that created the database environment. </dl> @@ -201,8 +236,12 @@ An incorrectly formatted <b>NAME VALUE</b> entry or line was found; or if an invalid flag value or parameter was specified. </dl> <dl compact> -<dt>ENOSPC<dd>HP-UX only: a previously created Berkeley DB environment for this process still -exists. +<dt>ENOSPC<dd>HP-UX only: +Due to the constraints of the PA-RISC memory architecture, HP-UX does not +allow a process to map a file into its address space multiple times. +For this reason, each Berkeley DB environment may be opened only once by a +process on HP-UX; that is, calls to DbEnv::open will fail if the +specified Berkeley DB environment has been opened and not subsequently closed. </dl> <dl compact> <dt>ENOENT<dd>The file or directory does not exist. @@ -236,6 +275,6 @@ open method flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_remove.html b/db/docs/api_cxx/env_remove.html index 7bd166158..ea4474377 100644 --- a/db/docs/api_cxx/env_remove.html +++ b/db/docs/api_cxx/env_remove.html @@ -1,5 +1,5 @@ <!--$Id: env_remove.so,v 10.44 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -74,8 +74,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>db_home</b><dd>The <b>db_home</b> parameter names the database environment to be removed. -<p>On Windows, the <b>db_home</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>db_home</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> @@ -119,6 +120,6 @@ the following non-zero errors:</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_alloc.html b/db/docs/api_cxx/env_set_alloc.html index 7a288892c..0fc20ffcc 100644 --- a/db/docs/api_cxx/env_set_alloc.html +++ b/db/docs/api_cxx/env_set_alloc.html @@ -1,5 +1,5 @@ <!--$Id: env_set_alloc.so,v 1.22 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -99,6 +99,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_app_dispatch.html b/db/docs/api_cxx/env_set_app_dispatch.html index 8e5cfc1d9..6d643330e 100644 --- a/db/docs/api_cxx/env_set_app_dispatch.html +++ b/db/docs/api_cxx/env_set_app_dispatch.html @@ -1,5 +1,5 @@ <!--$Id: env_set_app_dispatch.so,v 10.54 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -100,6 +100,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_cachesize.html b/db/docs/api_cxx/env_set_cachesize.html index 07f2881cd..74692e0a6 100644 --- a/db/docs/api_cxx/env_set_cachesize.html +++ b/db/docs/api_cxx/env_set_cachesize.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_cachesize.so,v 10.49 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_cachesize.so,v 10.50 2005/01/10 07:18:43 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -38,21 +38,22 @@ pages accessed simultaneously, and is usually much larger.)</p> <p>The default cache size is 256KB, and may not be specified as less than 20KB. Any cache size less than 500MB is automatically increased by 25% to account for buffer pool overhead; cache sizes larger than 500MB are -used as specified. The current maximum size of a single cache is 4GB. -(All sizes are in powers-of-two, that is, 256KB is 2^18 not 256,000.) -For information on tuning the Berkeley DB cache size, see -<a href="../ref/am_conf/cachesize.html">Selecting a cache size</a>.</p> -<p>It is possible to specify caches to Berkeley DB larger than 4GB and/or large -enough they cannot be allocated contiguously on some architectures. For -example, some releases of Solaris limit the amount of memory that may -be allocated contiguously by a process. If <b>ncache</b> is 0 or 1, -the cache will be allocated contiguously in memory. If it is greater -than 1, the cache will be broken up into <b>ncache</b> equally sized, -separate pieces of memory.</p> -<p>The database environment's cache size may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_cachesize", one or more whitespace characters, -and the cache size specified in three parts: the gigabytes of cache, the +used as specified. The maximum size of a single cache is 4GB on 32-bit +systems and 10TB on 64-bit systems. (All sizes are in powers-of-two, +that is, 256KB is 2^18 not 256,000.) For information on tuning the Berkeley DB +cache size, see <a href="../ref/am_conf/cachesize.html">Selecting a +cache size</a>.</p> +<p>It is possible to specify caches to Berkeley DB large enough they cannot be +allocated contiguously on some architectures. For example, some +releases of Solaris limit the amount of memory that may be allocated +contiguously by a process. If <b>ncache</b> is 0 or 1, the cache will +be allocated contiguously in memory. If it is greater than 1, the cache +will be broken up into <b>ncache</b> equally sized, separate pieces of +memory.</p> +<p>The database environment's cache size may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_cachesize", one or more whitespace +characters, and the cache size specified in three parts: the gigabytes of cache, the additional bytes of cache, and the number of caches, also separated by whitespace characters. For example, "set_cachesize 2 524288000 3" would create a 2.5GB logical cache, split between three physical caches. @@ -105,11 +106,11 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>bytesp</b><dd>The <b>bytesp</b> parameter references memory into which - the additional bytes of memory in the cache is copied. + the additional bytes of memory in the cache is copied. <dt><b>gbytesp</b><dd>The <b>gbytesp</b> parameter references memory into which - the gigabytes of memory in the cache is copied. + the gigabytes of memory in the cache is copied. <dt><b>ncachep</b><dd>The <b>ncachep</b> parameter references memory into which - the number of caches is copied. + the number of caches is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -120,6 +121,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_data_dir.html b/db/docs/api_cxx/env_set_data_dir.html index adb0d7434..11823c1dc 100644 --- a/db/docs/api_cxx/env_set_data_dir.html +++ b/db/docs/api_cxx/env_set_data_dir.html @@ -1,5 +1,5 @@ <!--$Id: env_set_data_dir.so,v 10.28 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -41,10 +41,10 @@ path specified.</p> either by absolute paths or relative to the environment home directory. See <a href="../ref/env/naming.html">Berkeley DB File Naming</a> for more information.</p> -<p>The database environment's data directories may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_data_dir", one or more whitespace characters, -and the directory name. +<p>The database environment's data directories may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_data_dir", one or more whitespace +characters, and the directory name. </p> <p>The DbEnv::set_data_dir method configures operations performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying @@ -64,8 +64,9 @@ failure, and returns 0 on success. <dl compact> <dt><b>dir</b><dd>The <b>dir</b> parameter is a directory to be used as a location for database files. -<p>On Windows, the <b>dir</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>dir</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> </dl> <h3>Errors</h3> <p>The DbEnv::set_data_dir method @@ -101,6 +102,6 @@ NULL-terminated array of directories in <b>dirpp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_encrypt.html b/db/docs/api_cxx/env_set_encrypt.html index 34d0d0581..05f5be827 100644 --- a/db/docs/api_cxx/env_set_encrypt.html +++ b/db/docs/api_cxx/env_set_encrypt.html @@ -1,5 +1,5 @@ <!--$Id: env_set_encrypt.so,v 10.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -97,6 +97,6 @@ encryption flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_errcall.html b/db/docs/api_cxx/env_set_errcall.html index 2d415529c..a1bf2730a 100644 --- a/db/docs/api_cxx/env_set_errcall.html +++ b/db/docs/api_cxx/env_set_errcall.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_errcall.so,v 10.37 2004/10/12 20:00:47 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errcall.so,v 10.39 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -47,6 +47,9 @@ library FILE *. You should not mix these approaches.</p> <p>This error-logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.</p> +<p>The DbEnv::set_errcall method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> <p>The DbEnv::set_errcall method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -59,6 +62,10 @@ reporting function. The function takes three parameters: <a href="../api_cxx/db_set_errpfx.html">Db::set_errpfx</a> or <a href="../api_cxx/env_set_errpfx.html">DbEnv::set_errpfx</a>). <dt><b>msg</b><dd>The <b>msg</b> parameter is the error message string. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -69,6 +76,6 @@ reporting function. The function takes three parameters: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_errfile.html b/db/docs/api_cxx/env_set_errfile.html index bfbd66706..46370d6d3 100644 --- a/db/docs/api_cxx/env_set_errfile.html +++ b/db/docs/api_cxx/env_set_errfile.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_errfile.so,v 10.34 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errfile.so,v 10.36 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -53,6 +53,9 @@ a trailing <newline> character.</p> <p>This error logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.</p> +<p>The DbEnv::set_errfile method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> <p>The DbEnv::set_errfile method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -62,9 +65,19 @@ displaying additional Berkeley DB error information. </dl> <hr size=1 noshade> <h3>Description: DbEnv::get_errfile</h3> -<p>The DbEnv::get_errfile method returns the .</p> +<p>The DbEnv::get_errfile method returns the FILE *.</p> <p>The DbEnv::get_errfile method may be called at any time during the life of the application.</p> +<p>The DbEnv::get_errfile 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>errfilep</b><dd>The DbEnv::get_errfile method returns the +FILE * in <b>errfilep</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a> @@ -74,6 +87,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_error_stream.html b/db/docs/api_cxx/env_set_error_stream.html index 55c7785b1..85f0b1733 100644 --- a/db/docs/api_cxx/env_set_error_stream.html +++ b/db/docs/api_cxx/env_set_error_stream.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_error_stream.so,v 10.29 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_error_stream.so,v 10.30 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -50,6 +50,11 @@ You should not mix these approaches.</p> <p>This error-logging enhancement does not slow performance or significantly increase application size, and may be run during normal operation as well as during application debugging.</p> +<p>The DbEnv::set_error_stream method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_error_stream method may be called at any time during the life of the +application.</p> <h3>Parameters</h3> <dl compact> <dt><b>stream</b><dd>The <b>stream</b> parameter is the application-specified output stream to @@ -64,6 +69,6 @@ be used for additional error information. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_errpfx.html b/db/docs/api_cxx/env_set_errpfx.html index 19e9f7254..952f72a9c 100644 --- a/db/docs/api_cxx/env_set_errpfx.html +++ b/db/docs/api_cxx/env_set_errpfx.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_errpfx.so,v 10.33 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_errpfx.so,v 10.34 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -37,6 +37,9 @@ maintain a reference to it. Although this allows applications to modify the error message prefix at any time (without repeatedly calling the interfaces), it means the memory must be maintained until the handle is closed.</p> +<p>The DbEnv::set_errpfx method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> <p>The DbEnv::set_errpfx method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -68,6 +71,6 @@ error prefix in <b>errpfxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_feedback.html b/db/docs/api_cxx/env_set_feedback.html index fa611afd8..02f0f6d0d 100644 --- a/db/docs/api_cxx/env_set_feedback.html +++ b/db/docs/api_cxx/env_set_feedback.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_feedback.so,v 10.42 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_feedback.so,v 10.43 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -23,8 +23,7 @@ #include <db_cxx.h> <p> int -DbEnv::set_feedback( - void (*db_feedback_fcn)(DbEnv *dbenv, int opcode, int percent)); +DbEnv::set_feedback(void (*db_feedback_fcn)(DbEnv *dbenv, int opcode, int percent)); </pre></h3> <hr size=1 noshade> <h3>Description: DbEnv::set_feedback</h3> @@ -60,6 +59,10 @@ parameter may take on any of the following values: <dt><b>percent</b><dd>The <b>percent</b> parameter is the percent of the operation that has been completed, specified as an integer value between 0 and 100. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -70,6 +73,6 @@ been completed, specified as an integer value between 0 and 100. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_flags.html b/db/docs/api_cxx/env_set_flags.html index 5e18829bf..ffe93f00a 100644 --- a/db/docs/api_cxx/env_set_flags.html +++ b/db/docs/api_cxx/env_set_flags.html @@ -1,5 +1,5 @@ <!--$Id--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -31,10 +31,10 @@ DbEnv::get_flags(u_int32_t *flagsp) <hr size=1 noshade> <h3>Description: DbEnv::set_flags</h3> <p>Configure a database environment.</p> -<p>The database environment's flag values may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_flags", one or more whitespace characters, -and the method flag parameter as a string; for example, "set_flags +<p>The database environment's flag values may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_flags", one or more whitespace +characters, and the method flag parameter as a string; for example, "set_flags DB_TXN_NOSYNC". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done @@ -49,11 +49,9 @@ failure, and returns 0 on success. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>If set, operations for which no explicit transaction handle was -specified, and which modify databases in the database environment, will -be automatically enclosed within a transaction. If the call succeeds, -changes made by the operation will be recoverable. If the call fails, -the operation will have made no changes. +<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>If set, <a href="../api_cxx/db_class.html">Db</a> handle operations for which no explicit transaction +handle was specified, and which modify databases in the database +environment, will be automatically enclosed within a transaction. <p>Calling DbEnv::set_flags with the <a href="../api_cxx/env_set_flags.html#DB_AUTO_COMMIT">DB_AUTO_COMMIT</a> flag only affects the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle (and any other Berkeley DB handles opened within the scope of that handle). @@ -98,15 +96,37 @@ file.</p> <p>The DB_DIRECT_LOG flag may be used to configure Berkeley DB at any time during the life of the application.</p> <a name="5"><!--meow--></a> +<dt><a name="DB_DSYNC_DB">DB_DSYNC_DB</a><dd>Configure Berkeley DB to flush database writes to the backing disk before +returning from the write system call, rather than flushing database +writes explicitly in a separate system call, as necessary. This is only +available on some systems (for example, systems supporting the +IEEE/ANSI Std 1003.1 (POSIX) standard O_DSYNC flag, or systems supporting the Windows +FILE_FLAG_WRITE_THROUGH flag). This flag may result in inaccurate file +modification times and other file-level information for Berkeley DB database +files. This flag will almost certainly result in a performance decrease +on most systems. This flag is only applicable to certain filesysystem +(for example, the Veritas VxFS filesystem), where the filesystem's +support for trickling writes back to stable storage behaves badly (or +more likely, has been misconfigured). +<p>Calling DbEnv::set_flags with the DB_DSYNC_DB flag only affects +the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle (and any other Berkeley DB handles opened +within the scope of that handle). +For consistent behavior across the environment, all <a href="../api_cxx/env_class.html">DbEnv</a> +handles opened in the environment must either set the DB_DSYNC_DB flag +or the flag should be specified in the <b>DB_CONFIG</b> configuration +file.</p> +<p>The DB_DSYNC_DB flag may be used to configure Berkeley DB at any time during +the life of the application.</p> +<a name="6"><!--meow--></a> <dt><a name="DB_DSYNC_LOG">DB_DSYNC_LOG</a><dd>Configure Berkeley DB to flush log writes to the backing disk before returning from the write system call, rather than flushing log writes explicitly -in a separate system call. This is only available on some systems (for -example, systems supporting the IEEE/ANSI Std 1003.1 (POSIX) standard O_DSYNC flag, -or systems supporting the Win32 FILE_FLAG_WRITE_THROUGH flag). This -configuration may result in inaccurate file modification times and other -file-level information for Berkeley DB log files. This configuration may -offer a performance increase on some systems and a performance decrease -on others. +in a separate system call, as necessary. This is only available on some +systems (for example, systems supporting the IEEE/ANSI Std 1003.1 (POSIX) standard +O_DSYNC flag, or systems supporting the Windows FILE_FLAG_WRITE_THROUGH +flag). This flag may result in inaccurate file modification times and +other file-level information for Berkeley DB log files. This flag may offer +a performance increase on some systems and a performance decrease on +others. <p>Calling DbEnv::set_flags with the DB_DSYNC_LOG flag only affects the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle (and any other Berkeley DB handles opened within the scope of that handle). @@ -116,7 +136,7 @@ or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The DB_DSYNC_LOG flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="6"><!--meow--></a> +<a name="7"><!--meow--></a> <dt><a name="DB_LOG_AUTOREMOVE">DB_LOG_AUTOREMOVE</a><dd>If set, Berkeley DB will automatically remove log files that are no longer needed. Automatic log file removal is likely to make catastrophic recovery impossible. @@ -125,7 +145,7 @@ database environment, including all threads of control accessing the database environment.</p> <p>The DB_LOG_AUTOREMOVE flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="7"><!--meow--></a> +<a name="8"><!--meow--></a> <dt><a name="DB_LOG_INMEMORY">DB_LOG_INMEMORY</a><dd>If set, maintain transaction logs in memory rather than on disk. This means that transactions exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, database @@ -146,7 +166,7 @@ database environment, including all threads of control accessing the database environment.</p> <p>The DB_LOG_INMEMORY flag may be used to configure Berkeley DB only before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is called.</p> -<a name="8"><!--meow--></a> +<a name="9"><!--meow--></a> <dt><a name="DB_NOLOCKING">DB_NOLOCKING</a><dd>If set, Berkeley DB will grant all requested mutual exclusion mutexes and database locks without regard for their actual availability. This functionality should never be used for purposes other than debugging. @@ -156,7 +176,20 @@ within the scope of that handle). </p> <p>The DB_NOLOCKING flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="9"><!--meow--></a> +<dt><a name="DB_MULTIVERSION">DB_MULTIVERSION</a><dd>If set, all databases in the environment will be opened as if +DB_MULTIVERSION is passed to <a href="../api_cxx/db_open.html">Db::open</a>. This flag will +be ignored for queue databases for which DB_MULTIVERSION is not +supported. +<p>Calling DbEnv::set_flags with the DB_MULTIVERSION flag only affects +the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle (and any other Berkeley DB handles opened +within the scope of that handle). +For consistent behavior across the environment, all <a href="../api_cxx/env_class.html">DbEnv</a> +handles opened in the environment must either set the DB_MULTIVERSION flag +or the flag should be specified in the <b>DB_CONFIG</b> configuration +file.</p> +<p>The DB_MULTIVERSION flag may be used to configure Berkeley DB at any time during +the life of the application.</p> +<a name="10"><!--meow--></a> <dt><a name="DB_NOMMAP">DB_NOMMAP</a><dd>If set, Berkeley DB will copy read-only database files into the local cache instead of potentially mapping them into process memory (see the description of the <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a> method for further @@ -170,7 +203,7 @@ or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The DB_NOMMAP flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="10"><!--meow--></a> +<a name="11"><!--meow--></a> <dt><a name="DB_NOPANIC">DB_NOPANIC</a><dd>If set, Berkeley DB will ignore any panic state in the database environment. (Database environments in a panic state normally refuse all attempts to call Berkeley DB functions, returning <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>.) This @@ -193,7 +226,7 @@ within the scope of that handle). </p> <p>The DB_OVERWRITE flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="11"><!--meow--></a> +<a name="12"><!--meow--></a> <dt><a name="DB_PANIC_ENVIRONMENT">DB_PANIC_ENVIRONMENT</a><dd>If set, Berkeley DB will set the panic state for the database environment. (Database environments in a panic state normally refuse all attempts to call Berkeley DB functions, returning <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>.) This flag may @@ -205,7 +238,7 @@ database environment, including all threads of control accessing the database environment.</p> <p>The DB_PANIC_ENVIRONMENT flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="12"><!--meow--></a> +<a name="13"><!--meow--></a> <dt><a name="DB_REGION_INIT">DB_REGION_INIT</a><dd>In some applications, the expense of page-faulting the underlying shared memory regions can affect performance. (For example, if the page-fault occurs while holding a lock, other lock requests can convoy, and overall @@ -239,7 +272,7 @@ or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The <a href="../api_cxx/env_set_flags.html#DB_TIME_NOTGRANTED">DB_TIME_NOTGRANTED</a> flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="13"><!--meow--></a> +<a name="14"><!--meow--></a> <dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>If set, Berkeley DB will not write or synchronously flush the log on transaction commit. This means that transactions exhibit the ACI (atomicity, consistency, @@ -258,7 +291,20 @@ handles opened in the environment must either set the DB_TXN_NOSYNC flag or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The DB_TXN_NOSYNC flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="14"><!--meow--></a> +<dt><a name="DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a><dd>If set, all transactions in the environment will be started as if +DB_TXN_SNAPSHOT were passed to <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>, and all +non-transactional cursors will be opened as if DB_TXN_SNAPSHOT +were passed to <a href="../api_cxx/db_cursor.html">Db::cursor</a>. +<p>Calling DbEnv::set_flags with the DB_TXN_SNAPSHOT flag only affects +the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle (and any other Berkeley DB handles opened +within the scope of that handle). +For consistent behavior across the environment, all <a href="../api_cxx/env_class.html">DbEnv</a> +handles opened in the environment must either set the DB_TXN_SNAPSHOT flag +or the flag should be specified in the <b>DB_CONFIG</b> configuration +file.</p> +<p>The DB_TXN_SNAPSHOT flag may be used to configure Berkeley DB at any time during +the life of the application.</p> +<a name="15"><!--meow--></a> <dt><a name="DB_TXN_WRITE_NOSYNC">DB_TXN_WRITE_NOSYNC</a><dd>If set, Berkeley DB will write, but will not synchronously flush, the log on transaction commit. This means that transactions exhibit the ACI (atomicity, consistency, @@ -277,7 +323,7 @@ or the flag should be specified in the <b>DB_CONFIG</b> configuration file.</p> <p>The DB_TXN_WRITE_NOSYNC flag may be used to configure Berkeley DB at any time during the life of the application.</p> -<a name="15"><!--meow--></a> +<a name="16"><!--meow--></a> <dt><a name="DB_YIELDCPU">DB_YIELDCPU</a><dd>If set, Berkeley DB will yield the processor immediately after each page or mutex acquisition. This functionality should never be used for purposes other than stress testing. @@ -328,6 +374,6 @@ configuration flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_isalive.html b/db/docs/api_cxx/env_set_isalive.html new file mode 100644 index 000000000..b92e780c3 --- /dev/null +++ b/db/docs/api_cxx/env_set_isalive.html @@ -0,0 +1,86 @@ +<!--$Id: env_set_isalive.so,v 10.4 2006/01/27 16:13:48 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_isalive</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_isalive</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_isalive(int (*is_alive)(DbEnv *dbenv, pid_t pid, db_threadid_t tid, u_int32_t flags)); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_isalive</h3> +<p>Declare a function that returns if a thread of control (either a true +thread or a process) is still running. The DbEnv::set_isalive method +supports the <a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> method. For more information, see +<a href="../ref/cam/app.html">Architecting Data Store and Concurrent +Data Store applications</a>, and <a href="../ref/transapp/app.html">Architecting Transactional Data Store applications</a>.</p> +<p>The DbEnv::set_isalive method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_isalive method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_isalive 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>is_alive</b><dd>The <b>is_alive</b> parameter is a function which returns non-zero if +the thread of control, identified by the <b>pid</b> and <b>tid</b> +arguments, is still running. The function takes four arguments: +<dl compact> +<dt><b>dbenv</b><dd>The <b>dbenv</b> parameter is the enclosing database environment +handle, allowing application access to the application-private fields +of that object. +<dt><b>pid</b><dd>The <b>pid</b> parameter is a process ID returned by the function +specified to the <a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a> method. +<dt><b>tid</b><dd>The <b>tid</b> parameter is a thread ID returned by the function +specified to the <a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a> method. +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +the following value: +<dl compact> +<dt><a name="DB_MUTEX_PROCESS_ONLY">DB_MUTEX_PROCESS_ONLY</a><dd>Return only if the process is alive, the thread ID should be ignored. +</dl> +</dl> +</dl> +<h3>Errors</h3> +<p>The DbEnv::set_isalive method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_set_lg_bsize.html b/db/docs/api_cxx/env_set_lg_bsize.html index 35a62a0ac..4354a787e 100644 --- a/db/docs/api_cxx/env_set_lg_bsize.html +++ b/db/docs/api_cxx/env_set_lg_bsize.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_lg_bsize.so,v 10.35 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_lg_bsize.so,v 10.36 2006/08/30 10:04:48 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -32,11 +32,12 @@ DbEnv::get_lg_bsize(u_int32_t *lg_bsizep); <h3>Description: DbEnv::set_lg_bsize</h3> <p>Set the size of the in-memory log buffer, in bytes.</p> <p>When the logging subsystem is configured for on-disk logging, the -default size of the in-memory log buffer is 32KB. Log information is -stored in-memory until the storage space fills up or transaction commit -forces the information to be flushed to stable storage. In the presence -of long-running transactions or transactions producing large amounts of -data, larger buffer sizes can increase throughput.</p> +default size of the in-memory log buffer is approximately 32KB. Log +information is stored in-memory until the storage space fills up or +transaction commit forces the information to be flushed to stable +storage. In the presence of long-running transactions or transactions +producing large amounts of data, larger buffer sizes can increase +throughput.</p> <p>When the logging subsystem is configured for in-memory logging, the default size of the in-memory log buffer is 1MB. Log information is stored in-memory until the storage space fills up or transaction abort @@ -49,10 +50,10 @@ should ensure the in-memory log buffer size is large enough that no transaction will ever span the entire buffer, and avoid a state where the in-memory buffer is full and no space can be freed because a transaction that started in the first log "file" is still active.</p> -<p>The database environment's log buffer size may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lg_bsize", one or more whitespace characters, -and the size in bytes. +<p>The database environment's log buffer size may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lg_bsize", one or more whitespace +characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -108,6 +109,6 @@ size of the log buffer, in bytes in <b>lg_bsizep</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lg_dir.html b/db/docs/api_cxx/env_set_lg_dir.html index d3cb50830..d695f3192 100644 --- a/db/docs/api_cxx/env_set_lg_dir.html +++ b/db/docs/api_cxx/env_set_lg_dir.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lg_dir.so,v 10.25 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -38,10 +38,10 @@ environment home directory. See <a href="../ref/env/naming.html">Berkeley DB F <p>For the greatest degree of recoverability from system or application failure, database files and log files should be located on separate physical devices.</p> -<p>The database environment's logging directory may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lg_dir", one or more whitespace characters, -and the directory name. +<p>The database environment's logging directory may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lg_dir", one or more whitespace +characters, and the directory name. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -62,8 +62,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>dir</b><dd>The <b>dir</b> parameter is the directory used to store the logging files. -<p>On Windows, the <b>dir</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>dir</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> </dl> <h3>Errors</h3> <p>The DbEnv::set_lg_dir method @@ -99,6 +100,6 @@ log directory in <b>dirp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lg_max.html b/db/docs/api_cxx/env_set_lg_max.html index b172b10dc..0025b4aaa 100644 --- a/db/docs/api_cxx/env_set_lg_max.html +++ b/db/docs/api_cxx/env_set_lg_max.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lg_max.so,v 10.45 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -49,10 +49,10 @@ the in-memory buffer is full and no space can be freed because a transaction that started in the first log "file" is still active.</p> <p>See <a href="../ref/log/limits.html">Log File Limits</a> for more information.</p> -<p>The database environment's log file size may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lg_max", one or more whitespace characters, -and the size in bytes. +<p>The database environment's log file size may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lg_max", one or more whitespace +characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -109,6 +109,6 @@ maximum log file size in <b>lg_maxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lg_mode.html b/db/docs/api_cxx/env_set_lg_mode.html new file mode 100644 index 000000000..6f8eec36b --- /dev/null +++ b/db/docs/api_cxx/env_set_lg_mode.html @@ -0,0 +1,91 @@ +<!--$Id: env_set_lg_mode.so,v 1.1 2004/12/15 15:46:44 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_lg_filemode</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_lg_filemode</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_lg_filemode(int lg_mode); +<p> +int +DbEnv::get_lg_filemode(int *); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_lg_filemode</h3> +<p>Set the absolute file mode for created log files. This method is +<b>only</b> useful for the rare Berkeley DB application that does not +control its umask value.</p> +<p>Normally, if Berkeley DB applications set their umask appropriately, all +processes in the application suite will have read permission on the log +files created by any process in the application suite. However, if the +Berkeley DB application is a library, a process using the library might set +its umask to a value preventing other processes in the application suite +from reading the log files it creates. In this rare case, the +DbEnv::set_lg_filemode method can be used to set the mode of created +log files to an absolute value.</p> +<p>The database environment's log file mode may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lg_filemode", one or more whitespace +characters, and the absolute mode of created log files. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::set_lg_filemode method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::set_lg_filemode method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_lg_filemode 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>lg_filemode</b><dd>The <b>lg_filemode</b> parameter is the absolute mode of the created +log file. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::set_lg_filemode</h3> +<p>The DbEnv::set_lg_filemode method returns the log file mode.</p> +<p>The DbEnv::set_lg_filemode method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_lg_filemode 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>lg_modep</b><dd>The DbEnv::set_lg_filemode method returns the +log file mode in <b>lg_modep</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a>, <a href="../api_cxx/lsn_class.html">DbLsn</a> +<h3>See Also</h3> +<a href="../api_cxx/log_list.html">Logging Subsystem and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_set_lg_regionmax.html b/db/docs/api_cxx/env_set_lg_regionmax.html index eeb8d958d..3643ec74e 100644 --- a/db/docs/api_cxx/env_set_lg_regionmax.html +++ b/db/docs/api_cxx/env_set_lg_regionmax.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_lg_regionmax.so,v 10.22 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_lg_regionmax.so,v 10.23 2006/08/30 10:04:48 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -32,13 +32,14 @@ DbEnv::get_lg_regionmax(u_int32_t *lg_regionmaxp); <h3>Description: DbEnv::set_lg_regionmax</h3> <p>Set the size of the underlying logging area of the Berkeley DB environment, in bytes. By default, or if the value is set to 0, the default size is -60KB. The log region is used to store filenames, and so may need to be -increased in size if a large number of files will be opened and -registered with the specified Berkeley DB environment's log manager.</p> -<p>The database environment's log region size may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lg_regionmax", one or more whitespace characters, -and the size in bytes. +approximately 60KB. The log region is used to store filenames, and so +may need to be increased in size if a large number of files will be +opened and registered with the specified Berkeley DB environment's log +manager.</p> +<p>The database environment's log region size may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lg_regionmax", one or more whitespace +characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -94,6 +95,6 @@ size of the underlying logging subsystem region in <b>lg_regionmaxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lk_conflicts.html b/db/docs/api_cxx/env_set_lk_conflicts.html index 3ce8babf1..35570cc96 100644 --- a/db/docs/api_cxx/env_set_lk_conflicts.html +++ b/db/docs/api_cxx/env_set_lk_conflicts.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lk_conflicts.so,v 10.43 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -83,9 +83,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>lk_conflictsp</b><dd>The <b>lk_conflictsp</b> parameter references memory into which -a pointer to the current conflicts array is copied. +a pointer to the current conflicts array is copied. <dt><b>lk_modesp</b><dd>The <b>lk_modesp</b> parameter references memory into which - the size of the current conflicts array is copied. + the size of the current conflicts array is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -96,6 +96,6 @@ a pointer to the current conflicts array is copied. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lk_detect.html b/db/docs/api_cxx/env_set_lk_detect.html index c8b896d95..fbde86a08 100644 --- a/db/docs/api_cxx/env_set_lk_detect.html +++ b/db/docs/api_cxx/env_set_lk_detect.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_lk_detect.so,v 10.48 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_lk_detect.so,v 10.50 2006/02/27 14:51:30 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -35,19 +35,18 @@ occurs, and specify what lock request(s) should be rejected. As transactions acquire locks on behalf of a single locker ID, rejecting a lock request associated with a transaction normally requires the transaction be aborted.</p> -<p>The database environment's deadlock detector configuration may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lk_detect", one or more whitespace characters, -and the method <b>detect</b> parameter as a string; for example, +<p>The database environment's deadlock detector configuration may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lk_detect", one or more whitespace +characters, and the method <b>detect</b> parameter as a string; for example, "set_lk_detect DB_LOCK_OLDEST". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <p>The DbEnv::set_lk_detect method configures a database environment, not only operations performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> -<p>Although the DbEnv::set_lk_detect method may be called at any time during the life of -the application, it should normally be called before making calls to the -<a href="../api_c/env_class.html">db_env_create</a> or <a href="../api_c/db_class.html">db_create</a> methods.</p> +<p>The DbEnv::set_lk_detect method may be called at any time during the life of the +application.</p> <p>The DbEnv::set_lk_detect method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on @@ -79,7 +78,7 @@ may fail and throw encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> -<dt>EINVAL<dd>If the method was called after <a href="../api_cxx/env_open.html">DbEnv::open</a> was called; or if an +<dt>EINVAL<dd>An invalid flag value or parameter was specified. </dl> <hr size=1 noshade> @@ -106,6 +105,6 @@ deadlock detector configuration in <b>lk_detectp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lk_max_lockers.html b/db/docs/api_cxx/env_set_lk_max_lockers.html index 91ad31dc4..f4a06a486 100644 --- a/db/docs/api_cxx/env_set_lk_max_lockers.html +++ b/db/docs/api_cxx/env_set_lk_max_lockers.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lk_max_lockers.so,v 1.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -35,10 +35,10 @@ environment. This value is used by <a href="../api_cxx/env_open.html">DbEnv::op much space to allocate for various lock-table data structures. The default value is 1000 lockers. For specific information on configuring the size of the lock subsystem, see <a href="../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> -<p>The database environment's maximum number of lockers may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lk_max_lockers", one or more whitespace characters, -and the number of lockers. +<p>The database environment's maximum number of lockers may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lk_max_lockers", one or more whitespace +characters, and the number of lockers. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -94,6 +94,6 @@ maximum number of lockers in <b>lk_maxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lk_max_locks.html b/db/docs/api_cxx/env_set_lk_max_locks.html index 8383ac004..e72170586 100644 --- a/db/docs/api_cxx/env_set_lk_max_locks.html +++ b/db/docs/api_cxx/env_set_lk_max_locks.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lk_max_locks.so,v 10.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -36,10 +36,10 @@ allocate for various lock-table data structures. The default value is 1000 locks. For specific information on configuring the size of the lock subsystem, see <a href="../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> -<p>The database environment's maximum number of locks may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lk_max_locks", one or more whitespace characters, -and the number of locks. +<p>The database environment's maximum number of locks may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lk_max_locks", one or more whitespace +characters, and the number of locks. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -95,6 +95,6 @@ maximum number of locks in <b>lk_maxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_lk_max_objects.html b/db/docs/api_cxx/env_set_lk_max_objects.html index 770aba038..17069d8df 100644 --- a/db/docs/api_cxx/env_set_lk_max_objects.html +++ b/db/docs/api_cxx/env_set_lk_max_objects.html @@ -1,5 +1,5 @@ <!--$Id: env_set_lk_max_objects.so,v 1.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -35,10 +35,10 @@ environment. This value is used by <a href="../api_cxx/env_open.html">DbEnv::op much space to allocate for various lock-table data structures. The default value is 1000 objects. For specific information on configuring the size of the lock subsystem, see <a href="../ref/lock/max.html">Configuring locking: sizing the system</a>.</p> -<p>The database environment's maximum number of objects may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lk_max_objects", one or more whitespace characters, -and the number of objects. +<p>The database environment's maximum number of objects may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lk_max_objects", one or more whitespace +characters, and the number of objects. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -94,6 +94,6 @@ maximum number of locked objects in <b>lk_maxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_mp_mmapsize.html b/db/docs/api_cxx/env_set_mp_mmapsize.html index cf23f7ef9..ac2577d2d 100644 --- a/db/docs/api_cxx/env_set_mp_mmapsize.html +++ b/db/docs/api_cxx/env_set_mp_mmapsize.html @@ -1,5 +1,5 @@ <!--$Id: env_set_mp_mmapsize.so,v 10.40 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -41,10 +41,10 @@ in immense process sizes in the presence of large databases.</p> <p>The DbEnv::get_mp_mmapsize method sets the maximum file size, in bytes, for a file to be mapped into the process address space. If no value is specified, it defaults to 10MB.</p> -<p>The database environment's maximum mapped file size may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_mp_mmapsize", one or more whitespace characters, -and the size in bytes. +<p>The database environment's maximum mapped file size may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_mp_mmapsize", one or more whitespace +characters, and the size in bytes. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -96,6 +96,6 @@ maximum file map size in <b>mp_mmapsizep</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_msg_stream.html b/db/docs/api_cxx/env_set_msg_stream.html index d9a193c27..cd5815394 100644 --- a/db/docs/api_cxx/env_set_msg_stream.html +++ b/db/docs/api_cxx/env_set_msg_stream.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_msg_stream.so,v 10.4 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msg_stream.so,v 10.5 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -41,6 +41,11 @@ or the <a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a> and <a h capture the additional error information in a way that does not use either output streams or C library FILE *'s. You should not mix these approaches.</p> +<p>The DbEnv::set_message_stream method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_message_stream method may be called at any time during the life of the +application.</p> <h3>Parameters</h3> <dl compact> <dt><b>stream</b><dd>The <b>stream</b> parameter is the application-specified output stream to @@ -55,6 +60,6 @@ be used for additional message information. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_msgcall.html b/db/docs/api_cxx/env_set_msgcall.html index 3c8bdf26c..4da39490b 100644 --- a/db/docs/api_cxx/env_set_msgcall.html +++ b/db/docs/api_cxx/env_set_msgcall.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_msgcall.so,v 10.5 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msgcall.so,v 10.7 2006/05/17 20:47:46 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -22,8 +22,7 @@ <h3><pre> #include <db_cxx.h> <p> -void DbEnv::set_msgcall( - void (*db_msgcall_fcn)(const DbEnv *dbenv, const char *msg)); +void DbEnv::set_msgcall(void (*db_msgcall_fcn)(const DbEnv *dbenv, const char *msg)); </pre></h3> <hr size=1 noshade> <h3>Description: DbEnv::set_msgcall</h3> @@ -41,6 +40,9 @@ manner.</p> <a href="../api_cxx/db_set_msg_stream.html">Db::set_message_stream</a> methods to display the messages via an output stream, or the <a href="../api_cxx/db_set_msgfile.html">Db::set_msgfile</a> or <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> methods to display the messages via a C library FILE *.</p> +<p>The DbEnv::set_msgcall method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> <p>The DbEnv::set_msgcall method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -51,6 +53,10 @@ reporting function. The function takes two parameters: <dt><b>dbenv</b><dd>The <b>dbenv</b> parameter is the enclosing database environment. <dt><b>msg</b><dd>The <b>msg</b> parameter is the message string. </dl> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -61,6 +67,6 @@ reporting function. The function takes two parameters: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_msgfile.html b/db/docs/api_cxx/env_set_msgfile.html index 42cf5b20b..fdcc4a8a5 100644 --- a/db/docs/api_cxx/env_set_msgfile.html +++ b/db/docs/api_cxx/env_set_msgfile.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_msgfile.so,v 10.5 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_msgfile.so,v 10.7 2006/02/10 22:54:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -44,6 +44,9 @@ stream, or the <a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a> to capture the additional error information in a way that does not use either output streams or C library FILE *'s. You should not mix these approaches.</p> +<p>The DbEnv::set_msgfile method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> <p>The DbEnv::set_msgfile method may be called at any time during the life of the application.</p> <h3>Parameters</h3> @@ -53,9 +56,19 @@ displaying messages. </dl> <hr size=1 noshade> <h3>Description: DbEnv::get_msgfile</h3> -<p>The DbEnv::get_msgfile method returns the .</p> +<p>The DbEnv::get_msgfile method returns the FILE *.</p> <p>The DbEnv::get_msgfile method may be called at any time during the life of the application.</p> +<p>The DbEnv::get_msgfile 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>msgfilep</b><dd>The DbEnv::get_msgfile method returns the +FILE * in <b>msgfilep</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a> @@ -65,6 +78,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_rpc_server.html b/db/docs/api_cxx/env_set_rpc_server.html index 64e812c3e..da69cd9bd 100644 --- a/db/docs/api_cxx/env_set_rpc_server.html +++ b/db/docs/api_cxx/env_set_rpc_server.html @@ -1,5 +1,5 @@ <!--$Id: env_set_rpc_server.so,v 10.29 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -86,6 +86,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_shm_key.html b/db/docs/api_cxx/env_set_shm_key.html index 6cdb186f2..3245f6fd8 100644 --- a/db/docs/api_cxx/env_set_shm_key.html +++ b/db/docs/api_cxx/env_set_shm_key.html @@ -1,5 +1,5 @@ <!--$Id: env_set_shm_key.so,v 10.28 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -52,10 +52,10 @@ the same segment IDs when creating different Berkeley DB environments. In addition, by using the same segment IDs each time the environment is created, previously created segments will be removed, and the set of segments on the system will not grow without bound.</p> -<p>The database environment's base segment ID may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_shm_key", one or more whitespace characters, -and the ID. +<p>The database environment's base segment ID may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_shm_key", one or more whitespace +characters, and the ID. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -112,6 +112,6 @@ base segment ID in <b>shm_keyp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_thread_count.html b/db/docs/api_cxx/env_set_thread_count.html new file mode 100644 index 000000000..39bd833e6 --- /dev/null +++ b/db/docs/api_cxx/env_set_thread_count.html @@ -0,0 +1,98 @@ +<!--$Id: env_set_thread_count.so,v 10.1 2006/05/26 20:14:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_thread_count</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_thread_count</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_thread_count(u_int32_t count); +<p> +int +DbEnv::get_thread_count(u_int32_t *countp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_thread_count</h3> +<p>Declare an approximate number of threads in the database environment. +The DbEnv::set_thread_count method must be called prior to opening the +database environment if the <a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> method will be used. The +DbEnv::set_thread_count method does not set the maximum number of +threads but is used to determine memory sizing and the thread control +block reclamation policy.</p> +<p>The database environment's thread count may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_thread_count", one or more whitespace +characters, and the thread count. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::set_thread_count method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_thread_count method may not be called after the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is +called. +</p> +<p>The DbEnv::set_thread_count 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>count</b><dd>The <b>count</b> parameter is an approximate thread count for the +database environment. +</dl> +<h3>Errors</h3> +<p>The DbEnv::set_thread_count method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>If the method was called after <a href="../api_cxx/env_open.html">DbEnv::open</a> was called; or if an +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::get_thread_count</h3> +<p>The DbEnv::get_thread_count method returns the thread count.</p> +<p>The DbEnv::get_thread_count method may be called at any time during the life of the +application.</p> +<p>The DbEnv::get_thread_count 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>countp</b><dd>The DbEnv::get_thread_count method returns the +thread count in <b>countp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_set_thread_id.html b/db/docs/api_cxx/env_set_thread_id.html new file mode 100644 index 000000000..54a0feb64 --- /dev/null +++ b/db/docs/api_cxx/env_set_thread_id.html @@ -0,0 +1,126 @@ +<!--$Id: env_set_thread_id.so,v 10.9 2006/08/24 16:32:23 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_thread_id</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_thread_id</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_thread_id(void (*thread_id)(DbEnv *dbenv, pid_t *pid, db_threadid_t *tid)); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_thread_id</h3> +<p>Declare a function that returns a unique identifier pair for the current +thread of control. The DbEnv::set_thread_id method supports the +<a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> method. For more information, see +<a href="../ref/cam/app.html">Architecting Data Store and Concurrent +Data Store applications</a>, and <a href="../ref/transapp/app.html">Architecting Transactional Data Store applications</a>.</p> +<p>The DbEnv::set_thread_id method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_thread_id method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_thread_id 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>thread_id</b><dd>The <b>thread_id</b> parameter is a function which returns a unique +identifier pair for a thread of control in a Berkeley DB application. The +function takes three arguments: +<dl compact> +<dt><b>dbenv</b><dd>The <b>dbenv</b> parameter is the enclosing database environment +handle, allowing application access to the application-private fields +of that object. +<dt><b>pid</b><dd>The <b>pid</b> points to a memory location of type pid_t. The +process ID of the current thread of control may be returned in +this memory location. +<dt><b>tid</b><dd>The <b>tid</b> points to a memory location of type db_threadid_t. The +thread ID of the current thread of control may be returned in this +memory location. +</dl> +</dl> +<p>The standard system library calls to return process and thread IDs are +often sufficient for this purpose (for example, getpid() and +pthread_self() on POSIX systems or GetCurrentThreadID on Windows +systems). However, if the Berkeley DB application dynamically creates +processes or threads, some care may be necessary in assigning unique +IDs. In most threading systems, process and thread IDs are available +for re-use as soon as the process or thread exits. If a new process or +thread is created between the time of process or thread exit, and the +<a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> method is run, it may be possible for +<a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> to not detect that a thread of control exited +without properly releasing all Berkeley DB resources.</p> +<p>It may be possible to handle this problem by inhibiting process or +thread creation between thread of control exit and calling +<a href="../api_cxx/env_failchk.html">DbEnv::failchk</a>. Alternatively, the <b>thread_id</b> function +must be constructed to not re-use <b>pid</b>/<b>tid</b> pairs. For +example, in a single process application, the returned process ID might +be used as an incremental counter, with the returned thread ID set to +the actual thread ID. Obviously, the <b>is_alive</b> function +specified to the <a href="../api_cxx/env_set_isalive.html">DbEnv::set_isalive</a> method must be compatible with any +<b>thread_id</b> function specified to DbEnv::set_thread_id.</p> +<p>The db_threadid_t type is configured to be the same type as a standard +thread identifier, in Berkeley DB configurations where this type is known (for +example, systems supporting pthread_t or thread_t, or DWORD on Windows). +If the Berkeley DB configuration process is unable to determine the type of a +standard thread identifier, the db_thread_t type is set to uintmax_t (or +the largest available unsigned integral type, on systems lacking the +uintmax_t type). Applications running on systems lacking a detectable +standard thread type, and which are also using thread APIs where a +thread identifier is not an integral value and so will not fit into the +configured db_threadid_t type, must either translate between the +db_threadid_t type and the thread identifier (mapping the thread +identifier to a unique identifier of the appropriate size), or modify +the Berkeley DB sources to use an appropriate db_threadid_t type. Note: we +do not currently know of any systems where this is necessary. If your +application has to solve this problem, please contact our support group +and let us know.</p> +<p>If no <b>thread_id</b> function is specified by the application, the +Berkeley DB library will identify threads of control by using the taskIdSelf() +call on VxWorks, the getpid() and GetCurrentThreadID() calls on Windows, +the getpid() and pthread_self() calls when the Berkeley DB library has been +configured for POSIX pthreads or Solaris LWP threads, the getpid() and +thr_self() calls when the Berkeley DB library has been configured for UI +threads, and otherwise getpid().</p> +<h3>Errors</h3> +<p>The DbEnv::set_thread_id method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_set_thread_id_string.html b/db/docs/api_cxx/env_set_thread_id_string.html new file mode 100644 index 000000000..87eb34c57 --- /dev/null +++ b/db/docs/api_cxx/env_set_thread_id_string.html @@ -0,0 +1,88 @@ +<!--$Id: env_set_thread_id_string.so,v 10.1 2005/10/20 17:16:02 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::set_thread_id_string</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::set_thread_id_string</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::set_thread_id(char *(*thread_id_string)(DbEnv *dbenv, + pid_t pid, db_threadid_t tid, char *buf)); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::set_thread_id_string</h3> +<p>Declare a function that formats a process ID and thread ID identifier +pair for display into a caller-supplied buffer. The function must +return a reference to the caller-specified buffer. The +DbEnv::set_thread_id_string method supports the +<a href="../api_cxx/env_set_thread_id.html">DbEnv::set_thread_id</a> method.</p> +<p>The DbEnv::set_thread_id_string method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::set_thread_id_string method may be called at any time during the life of the +application.</p> +<p>The DbEnv::set_thread_id_string 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>thread_id_string</b><dd>The <b>thread_id_string</b> parameter is a function which returns a +buffer in which is an identifier pair formatted for display. The +function takes four arguments: +<dl compact> +<dt><b>dbenv</b><dd>The <b>dbenv</b> parameter is the enclosing database environment +handle, allowing application access to the application-private fields +of that object. +<dt><b>pid</b><dd>The <b>pid</b> argument is a process ID. +<dt><b>tid</b><dd>The <b>tid</b> argument is a thread ID. +<dt><b>buf</b><dd><a name="2"><!--meow--></a> +The <b>buf</b> argument is character array of at least +DB_THREADID_STRLEN bytes in length, into which the identifier +pair should be formatted. +</dl> +</dl> +<p>If no <b>thread_id_string</b> function is specified, the default +routine displays the identifier pair as "pid/tid", that is, the process +ID represented as an unsigned integer value, a slash ('/') character, +then the thread ID represented as an unsigned integer value.</p> +<h3>Errors</h3> +<p>The DbEnv::set_thread_id_string method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/env_set_timeout.html b/db/docs/api_cxx/env_set_timeout.html index 096a6781f..7f42abccb 100644 --- a/db/docs/api_cxx/env_set_timeout.html +++ b/db/docs/api_cxx/env_set_timeout.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_timeout.so,v 10.23 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_timeout.so,v 10.24 2005/05/20 15:07:45 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -32,8 +32,8 @@ DbEnv::get_timeout(db_timeout_t *timeoutp, u_int32_t flag); <h3>Description: DbEnv::set_timeout</h3> <p>The DbEnv::set_timeout method sets timeout values for locks or transactions in the database environment.</p> -<p>Timeouts are checked whenever a thread of control blocks on a lock or -when deadlock detection is performed. (In the case of +<p>All timeouts are checked whenever a thread of control blocks on a lock +or when deadlock detection is performed. (In the case of DB_SET_LOCK_TIMEOUT, the lock is one requested explicitly through the Lock subsystem interfaces. In the case of DB_SET_TXN_TIMEOUT, the lock is one requested on behalf of a @@ -59,18 +59,18 @@ failure, and returns 0 on success. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to one of the following values: <dl compact> <dt><a name="DB_SET_LOCK_TIMEOUT">DB_SET_LOCK_TIMEOUT</a><dd>Set the timeout value for locks in this database environment. -<p>The database environment's lock timeout value may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_lock_timeout", one or more whitespace characters, -and the lock timeout value. +<p>The database environment's lock timeout value may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_lock_timeout", one or more whitespace +characters, and the lock timeout value. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> <dt><a name="DB_SET_TXN_TIMEOUT">DB_SET_TXN_TIMEOUT</a><dd>Set the timeout value for transactions in this database environment. -<p>The database environment's transaction timeout value may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_txn_timeout", one or more whitespace characters, -and the transaction timeout value. +<p>The database environment's transaction timeout value may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_txn_timeout", one or more whitespace +characters, and the transaction timeout value. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -107,7 +107,7 @@ failure, and returns 0 on success. <dt><a name="DB_SET_TXN_TIMEOUT">DB_SET_TXN_TIMEOUT</a><dd>Return the timeout value for transactions in this database environment. </dl> <dt><b>timeoutp</b><dd>The <b>timeoutp</b> parameter references memory into which - the timeout value of the specified <b>flag</b> parameter is copied. + the timeout value of the specified <b>flag</b> parameter is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -118,6 +118,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_tmp_dir.html b/db/docs/api_cxx/env_set_tmp_dir.html index cacb15f7a..c6678fcba 100644 --- a/db/docs/api_cxx/env_set_tmp_dir.html +++ b/db/docs/api_cxx/env_set_tmp_dir.html @@ -1,5 +1,5 @@ <!--$Id: env_set_tmp_dir.so,v 10.26 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -55,10 +55,10 @@ all temporary files.</p> <a href="../api_cxx/env_open.html#DB_USE_ENVIRON">DB_USE_ENVIRON</a> or <a href="../api_cxx/env_open.html#DB_USE_ENVIRON_ROOT">DB_USE_ENVIRON_ROOT</a> flags were specified.</p> <p>Note: the GetTempPath interface is only checked on Win/32 platforms.</p> -<p>The database environment's temporary file directory may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_tmp_dir", one or more whitespace characters, -and the directory name. +<p>The database environment's temporary file directory may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_tmp_dir", one or more whitespace +characters, and the directory name. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -80,8 +80,9 @@ failure, and returns 0 on success. <dl compact> <dt><b>dir</b><dd>The <b>dir</b> parameter is the directory to be used to store temporary files. -<p>On Windows, the <b>dir</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>dir</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> </dl> <h3>Errors</h3> <p>The DbEnv::set_tmp_dir method @@ -117,6 +118,6 @@ database environment temporary file directory in <b>dirp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_tx_max.html b/db/docs/api_cxx/env_set_tx_max.html index 5448e8328..08c310f50 100644 --- a/db/docs/api_cxx/env_set_tx_max.html +++ b/db/docs/api_cxx/env_set_tx_max.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_tx_max.so,v 10.45 2004/09/28 15:04:22 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_tx_max.so,v 10.47 2006/06/19 22:25:31 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -34,15 +34,19 @@ DbEnv::get_tx_max(u_int32_t *tx_maxp); active transactions. This value bounds the size of the memory allocated for transactions. Child transactions are counted as active until they either commit or abort.</p> +<p>Transactions that update multiversion databases are not freed until the +last page version that the transaction created is flushed from cache. +This means that applications using multi-version concurrency control may +need a transaction for each page in cache, in the extreme case.</p> <p>When all of the memory available in the database environment for transactions is in use, calls to <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a> will fail (until some -active transactions complete). If this interface is never called, -the database environment is configured to support at least 20 active +active transactions complete). If this interface is never called, the +database environment is configured to support at least 100 active transactions.</p> -<p>The database environment's number of active transactions may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_tx_max", one or more whitespace characters, -and the number of transactions. +<p>The database environment's number of active transactions may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_tx_max", one or more whitespace +characters, and the number of transactions. Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done before that time.</p> @@ -99,6 +103,6 @@ number of active transactions in <b>tx_maxp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_tx_timestamp.html b/db/docs/api_cxx/env_set_tx_timestamp.html index fd5ea85fd..790ab5c6c 100644 --- a/db/docs/api_cxx/env_set_tx_timestamp.html +++ b/db/docs/api_cxx/env_set_tx_timestamp.html @@ -1,5 +1,5 @@ <!--$Id: env_set_tx_timestamp.so,v 10.29 2004/09/28 15:04:23 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -89,6 +89,6 @@ recovery timestamp in <b>timestampp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_set_verbose.html b/db/docs/api_cxx/env_set_verbose.html index e4f2c48ad..54f303b35 100644 --- a/db/docs/api_cxx/env_set_verbose.html +++ b/db/docs/api_cxx/env_set_verbose.html @@ -1,5 +1,5 @@ -<!--$Id: env_set_verbose.so,v 10.48 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: env_set_verbose.so,v 10.52 2005/12/28 16:10:51 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -34,11 +34,11 @@ DbEnv::get_verbose(u_int32_t which, int *onoffp); and debugging messages in the Berkeley DB message output on and off. To see the additional messages, verbose messages must also be configured for the application. For more information on verbose messages, see the -<a href="../api_cxx/db_set_errfile.html">Db::set_errfile</a> method.</p> -<p>The database environment's messages may also be set using the environment's -<b>DB_CONFIG</b> file. The syntax of the entry in that file is a -single line with the string "set_verbose", one or more whitespace characters, -and the method <b>which</b> parameter as a string; for example, +<a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method.</p> +<p>The database environment's messages may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_verbose", one or more whitespace +characters, and the method <b>which</b> parameter as a string; for example, "set_verbose DB_VERB_RECOVERY". Because the <b>DB_CONFIG</b> file is read when the database environment is opened, it will silently overrule configuration done @@ -61,8 +61,10 @@ messages are output. <dl compact> <dt><a name="DB_VERB_DEADLOCK">DB_VERB_DEADLOCK</a><dd>Display additional information when doing deadlock detection. <dt><a name="DB_VERB_RECOVERY">DB_VERB_RECOVERY</a><dd>Display additional information when performing recovery. +<dt><a name="DB_VERB_REGISTER">DB_VERB_REGISTER</a><dd>Display additional information concerning support for the +<a href="../api_cxx/env_open.html#DB_REGISTER">DB_REGISTER</a> flag to the <a href="../api_cxx/env_open.html">DbEnv::open</a> method. <dt><a name="DB_VERB_REPLICATION">DB_VERB_REPLICATION</a><dd>Display additional information when processing replication messages. -<p>Note, to get complete replication logging when debugging replication +<p>To get complete replication logging when debugging replication applications, you must also configure and build the Berkeley DB library with the <a href="../ref/build_unix/conf.html">--enable-diagnostic</a> configuration option as well as call the DbEnv::set_verbose method.</p> @@ -80,12 +82,12 @@ the following non-zero errors:</p> invalid flag value or parameter was specified. </dl> <hr size=1 noshade> -<h3>Description: dbenv_get_verbose</h3> -<p>The DbEnv::get_verbose method returns whether the specified <b>which</b> +<h3>Description: <a href="../api_cxx/env_set_verbose.html">DbEnv::get_verbose</a></h3> +<p>The <a href="../api_cxx/env_set_verbose.html">DbEnv::get_verbose</a> method returns whether the specified <b>which</b> parameter is currently set or not.</p> -<p>The DbEnv::get_verbose method may be called at any time during the life of the +<p>The <a href="../api_cxx/env_set_verbose.html">DbEnv::get_verbose</a> method may be called at any time during the life of the application.</p> -<p>The DbEnv::get_verbose method +<p>The <a href="../api_cxx/env_set_verbose.html">DbEnv::get_verbose</a> 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. @@ -95,7 +97,8 @@ failure, and returns 0 on success. <dt><b>which</b><dd>The <b>which</b> parameter is the message value for which configuration is being checked. <dt><b>onoffp</b><dd>The <b>onoffp</b> parameter references memory into which - the configuration of the specified <b>which</b> parameter is copied. + the configuration of the specified <b>which</b> parameter is copied. If the returned <b>onoff</b> value is zero, the parameter is off; +otherwise on. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -106,6 +109,6 @@ is being checked. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_stat.html b/db/docs/api_cxx/env_stat.html index a56f98d74..34583a0ad 100644 --- a/db/docs/api_cxx/env_stat.html +++ b/db/docs/api_cxx/env_stat.html @@ -1,5 +1,5 @@ <!--$Id: env_stat.so,v 10.5 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -27,7 +27,7 @@ DbEnv::stat_print(u_int32_t flags); </pre></h3> <hr size=1 noshade> <h3>Description: DbEnv::stat_print</h3> -<p>The DbEnv::stat_print method returns the +<p>The DbEnv::stat_print method displays the default statistical information. The information is printed to a specified output channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an @@ -42,14 +42,11 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> <dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. -</dl> -In addition, the following flag may be set by -bitwise inclusively <b>OR</b>'ing it into the <b>flags</b> parameter: -<dl compact> +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. <dt><a name="DB_STAT_SUBSYSTEM">DB_STAT_SUBSYSTEM</a><dd>Display information for all configured subsystems. </dl> </dl> @@ -62,6 +59,6 @@ bitwise inclusively <b>OR</b>'ing it into the <b>flags</b> parameter: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_strerror.html b/db/docs/api_cxx/env_strerror.html index 7bd6bae1d..eb9cfea1d 100644 --- a/db/docs/api_cxx/env_strerror.html +++ b/db/docs/api_cxx/env_strerror.html @@ -1,5 +1,5 @@ <!--$Id: env_strerror.so,v 8.13 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -50,6 +50,6 @@ string is wanted. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/env_version.html b/db/docs/api_cxx/env_version.html index f69707718..8e867a5d5 100644 --- a/db/docs/api_cxx/env_version.html +++ b/db/docs/api_cxx/env_version.html @@ -1,5 +1,5 @@ <!--$Id: env_version.so,v 10.26 2004/09/28 15:04:20 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -47,6 +47,6 @@ is copied to the memory to which it refers. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/exc_package.html b/db/docs/api_cxx/exc_package.html index 2ff788b56..4861a717c 100644 --- a/db/docs/api_cxx/exc_package.html +++ b/db/docs/api_cxx/exc_package.html @@ -1,5 +1,5 @@ <!--$Id: exc_package.so,v 10.1 2004/08/27 13:49:28 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -18,6 +18,6 @@ <tr><td><a href="../api_cxx/memp_class.html">DbMemoryException</a></td><td>Exception Class for insufficient memory</td></tr> <tr><td><a href="../api_cxx/runrec_class.html">DbRunRecoveryException</a></td><td>Exception Class for failures requiring recovery</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/except_class.html b/db/docs/api_cxx/except_class.html index b11a931dd..756595b57 100644 --- a/db/docs/api_cxx/except_class.html +++ b/db/docs/api_cxx/except_class.html @@ -1,5 +1,5 @@ <!--$Id: except_class.so,v 10.38 2004/09/28 15:04:19 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -60,6 +60,6 @@ not appear in the database.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/frame.html b/db/docs/api_cxx/frame.html index dd70c69b3..3f1a25891 100644 --- a/db/docs/api_cxx/frame.html +++ b/db/docs/api_cxx/frame.html @@ -1,8 +1,8 @@ -<!--$Id: frame.so,v 10.7 2004/11/08 18:07:47 bostic Exp $--> +<!--$Id: frame.so,v 10.8 2005/04/19 17:44:03 bostic Exp $--> <html> <head> <title> -Berkeley DB API (Version: 4.3.27) +Berkeley DB API (Version: 4.5.20) </title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> @@ -12,7 +12,7 @@ Berkeley DB API (Version: 4.3.27) <frame src="api_core.html" name="method" title= -"Berkeley DB API (Version: 4.3.27)"> +"Berkeley DB API (Version: 4.5.20)"> <noframes> <meta http-equiv="refresh" content="0;url=api_index.html"> </noframes> diff --git a/db/docs/api_cxx/lock_class.html b/db/docs/api_cxx/lock_class.html index 821c89965..37abbbbde 100644 --- a/db/docs/api_cxx/lock_class.html +++ b/db/docs/api_cxx/lock_class.html @@ -1,5 +1,5 @@ <!--$Id: lock_class.so,v 10.21 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -44,6 +44,6 @@ for a single lock, and has no methods of its own.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_detect.html b/db/docs/api_cxx/lock_detect.html index a40a7b2d2..b1b945d97 100644 --- a/db/docs/api_cxx/lock_detect.html +++ b/db/docs/api_cxx/lock_detect.html @@ -1,5 +1,5 @@ <!--$Id: lock_detect.so,v 10.49 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -77,6 +77,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_get.html b/db/docs/api_cxx/lock_get.html index 12885c5cc..ff6c2f16f 100644 --- a/db/docs/api_cxx/lock_get.html +++ b/db/docs/api_cxx/lock_get.html @@ -1,5 +1,5 @@ <!--$Id: lock_get.so,v 10.53 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -101,6 +101,6 @@ throw a DbMemoryException.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_id.html b/db/docs/api_cxx/lock_id.html index 2353ed97c..67510468e 100644 --- a/db/docs/api_cxx/lock_id.html +++ b/db/docs/api_cxx/lock_id.html @@ -1,5 +1,5 @@ <!--$Id: lock_id.so,v 10.33 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -40,7 +40,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>idp</b><dd>The <b>idp</b> parameter references memory into which - the allocated locker ID is copied. + the allocated locker ID is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -51,6 +51,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_id_free.html b/db/docs/api_cxx/lock_id_free.html index 149da764f..2910fc160 100644 --- a/db/docs/api_cxx/lock_id_free.html +++ b/db/docs/api_cxx/lock_id_free.html @@ -1,5 +1,5 @@ <!--$Id: lock_id_free.so,v 10.14 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -57,6 +57,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_list.html b/db/docs/api_cxx/lock_list.html index ff01d8a69..a0720601f 100644 --- a/db/docs/api_cxx/lock_list.html +++ b/db/docs/api_cxx/lock_list.html @@ -1,5 +1,5 @@ <!--$Id: lock_list.so,v 1.1 2002/08/30 20:00:51 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,7 +10,7 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Locking Subsystem and Related Methods</h3> -<!--$Id: m4.methods,v 1.5 2004/11/03 15:52:01 bostic Exp $--> +<!--$Id: m4.methods,v 1.6 2006/08/08 05:15:56 mjc Exp $--> <table border=1 align=center> <tr><th>Locking Subsystem and Related Methods</th><th>Description</th></tr> <!--DbDeadlockException--><tr><td><a href="../api_cxx/deadlock_class.html">DbDeadlockException</a></td><td>Deadlock exception</td></tr> @@ -21,6 +21,7 @@ <!--DbEnv::lock_put--><tr><td><a href="../api_cxx/lock_put.html">DbEnv::lock_put</a></td><td>Release a lock</td></tr> <!--DbEnv::lock_stat--><tr><td><a href="../api_cxx/lock_stat.html">DbEnv::lock_stat</a></td><td>Return lock subsystem statistics</td></tr> <!--DbEnv::lock_vec--><tr><td><a href="../api_cxx/lock_vec.html">DbEnv::lock_vec</a></td><td>Acquire/release locks</td></tr> +<!--DbEnv::cdsgroup_begin--><tr><td><a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a></td><td>Get a locker ID in Berkeley DB Concurrent Data Store</td></tr> <!--DbLockNotGrantedException--><tr><td><a href="../api_cxx/lockng_class.html">DbLockNotGrantedException</a></td><td>Lock-not-granted exception</td></tr> <!--DbLock--><tr><td><a href="../api_cxx/lock_class.html">DbLock</a></td><td>Lock object</td></tr> <tr><th>Locking Subsystem Configuration</th><th><br></th></tr> @@ -31,6 +32,6 @@ <!--DbEnv::set_lk_max_objects--><tr><td><a href="../api_cxx/env_set_lk_max_objects.html">DbEnv::set_lk_max_objects</a></td><td>Set maximum number of lock objects</td></tr> <!--DbEnv::set_timeout--><tr><td><a href="../api_cxx/env_set_timeout.html">DbEnv::set_timeout</a></td><td>Set lock and transaction timeout</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_put.html b/db/docs/api_cxx/lock_put.html index 37e714b49..9a6412019 100644 --- a/db/docs/api_cxx/lock_put.html +++ b/db/docs/api_cxx/lock_put.html @@ -1,5 +1,5 @@ <!--$Id: lock_put.so,v 10.37 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -56,6 +56,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_stat.html b/db/docs/api_cxx/lock_stat.html index 920011aa5..de730af45 100644 --- a/db/docs/api_cxx/lock_stat.html +++ b/db/docs/api_cxx/lock_stat.html @@ -1,5 +1,5 @@ -<!--$Id: lock_stat.so,v 10.62 2004/09/17 17:13:12 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: lock_stat.so,v 10.65 2005/07/20 16:26:38 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -57,9 +57,12 @@ individually freed.</p> <dt>u_int32_t st_maxnobjects;<dd>The maximum number of lock objects at any one time. <dt>u_int32_t st_nrequests;<dd>The total number of locks requested. <dt>u_int32_t st_nreleases;<dd>The total number of locks released. -<dt>u_int32_t st_nnowaits;<dd>The total number of lock requests failing because -<a href="../api_cxx/lock_vec.html#DB_LOCK_NOWAIT">DB_LOCK_NOWAIT</a> was set. -<dt>u_int32_t st_nconflicts;<dd>The total number of locks not immediately available due to conflicts. +<dt>u_int32_t st_nupgrade;<dd>The total number of locks upgraded. +<dt>u_int32_t st_ndowngrade;<dd>The total number of locks downgraded. +<dt>u_int32_t st_lock_wait;<dd>The number of lock requests not immediately available due to conflicts, +for which the thread of control waited. +<dt>u_int32_t st_lock_nowait;<dd>The number of lock requests not immediately available due to conflicts, +for which the thread of control did not wait. <dt>u_int32_t st_ndeadlocks;<dd>The number of deadlocks. <dt>u_int32_t st_locktimeout;<dd>Lock timeout value. <dt>u_int32_t st_nlocktimeouts;<dd>The number of lock requests that have timed out. @@ -69,9 +72,9 @@ component of <b>st_ndeadlocks</b>, the total number of deadlocks detected. <dt>roff_t st_regsize;<dd>The size of the lock region, in bytes. <dt>u_int32_t st_region_wait;<dd>The number of times that a thread of control was forced to wait before -obtaining the region lock. +obtaining the lock region mutex. <dt>u_int32_t st_region_nowait;<dd>The number of times that a thread of control was able to obtain -the region lock without waiting. +the lock region mutex without waiting. </dl> <p>The DbEnv::lock_stat method either returns a non-zero error value @@ -86,7 +89,7 @@ the following value: <dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. </dl> <dt><b>statp</b><dd>The <b>statp</b> parameter references memory into which -a pointer to the allocated statistics structure is copied. +a pointer to the allocated statistics structure is copied. </dl> <h3>Errors</h3> <p>The DbEnv::lock_stat method @@ -130,6 +133,6 @@ of the following values: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lock_vec.html b/db/docs/api_cxx/lock_vec.html index d90a144c5..746587ff5 100644 --- a/db/docs/api_cxx/lock_vec.html +++ b/db/docs/api_cxx/lock_vec.html @@ -1,5 +1,5 @@ <!--$Id: lock_vec.so,v 10.69 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -163,6 +163,6 @@ throw a DbMemoryException.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lockng_class.html b/db/docs/api_cxx/lockng_class.html index 603f5ed6f..8fc73e26f 100644 --- a/db/docs/api_cxx/lockng_class.html +++ b/db/docs/api_cxx/lockng_class.html @@ -1,5 +1,5 @@ <!--$Id: lockng_class.so,v 1.14 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -70,6 +70,6 @@ called, and returns the index of the failed DB_LOCKREQ when <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_archive.html b/db/docs/api_cxx/log_archive.html index 5b229b551..8ce3120b3 100644 --- a/db/docs/api_cxx/log_archive.html +++ b/db/docs/api_cxx/log_archive.html @@ -1,5 +1,5 @@ <!--$Id: log_archive.so,v 10.49 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -110,6 +110,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_compare.html b/db/docs/api_cxx/log_compare.html index 216f1909d..5b0ef3ab5 100644 --- a/db/docs/api_cxx/log_compare.html +++ b/db/docs/api_cxx/log_compare.html @@ -1,5 +1,5 @@ <!--$Id: log_compare.so,v 10.22 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -49,6 +49,6 @@ to be compared. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_cursor.html b/db/docs/api_cxx/log_cursor.html index e18d90c9b..205e81a0b 100644 --- a/db/docs/api_cxx/log_cursor.html +++ b/db/docs/api_cxx/log_cursor.html @@ -1,5 +1,5 @@ <!--$Id: log_cursor.so,v 10.12 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -36,7 +36,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>cursorp</b><dd>The <b>cursorp</b> parameter references memory into which -a pointer to the created log cursor is copied. +a pointer to the created log cursor is copied. <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. </dl> <h3>Errors</h3> @@ -58,6 +58,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_file.html b/db/docs/api_cxx/log_file.html index 557c9f6e1..ab48e1c80 100644 --- a/db/docs/api_cxx/log_file.html +++ b/db/docs/api_cxx/log_file.html @@ -1,5 +1,5 @@ <!--$Id: log_file.so,v 10.34 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -49,7 +49,7 @@ failure, and returns 0 on success. <a href="../api_cxx/lsn_class.html">DbLsn</a> object for which a filename is wanted. <dt><b>namep</b><dd>The <b>namep</b> parameter references memory into which - the name of the file containing the record named by <b>lsn</b> is copied. + the name of the file containing the record named by <b>lsn</b> is copied. <dt><b>len</b><dd>The <b>len</b> parameter is the length of the <b>namep</b> buffer in bytes. If <b>namep</b> is too short to hold the filename, DbEnv::log_file will fail. (Log filenames are normally quite short, @@ -74,6 +74,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_flush.html b/db/docs/api_cxx/log_flush.html index 6df36b365..9e3717f37 100644 --- a/db/docs/api_cxx/log_flush.html +++ b/db/docs/api_cxx/log_flush.html @@ -1,5 +1,5 @@ <!--$Id: log_flush.so,v 10.31 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -58,6 +58,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_list.html b/db/docs/api_cxx/log_list.html index 20c54ad5d..1804953c1 100644 --- a/db/docs/api_cxx/log_list.html +++ b/db/docs/api_cxx/log_list.html @@ -1,5 +1,5 @@ <!--$Id: log_list.so,v 1.1 2002/08/30 20:00:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,7 +10,7 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Logging Subsystem and Related Methods</h3> -<!--$Id: m4.methods,v 1.4 2004/11/03 15:52:01 bostic Exp $--> +<!--$Id: m4.methods,v 1.6 2005/09/30 19:00:24 bostic Exp $--> <table border=1 align=center> <tr><th>Logging Subsystem and Related Methods</th><th>Description</th></tr> <!--DbLsn--><tr><td><a href="../api_cxx/lsn_class.html">DbLsn</a></td><td>Log Sequence Numbers</td></tr> @@ -18,6 +18,7 @@ <!--DbEnv::log_archive--><tr><td><a href="../api_cxx/log_archive.html">DbEnv::log_archive</a></td><td>List log and database files</td></tr> <!--DbEnv::log_file--><tr><td><a href="../api_cxx/log_file.html">DbEnv::log_file</a></td><td>Map Log Sequence Numbers to log files</td></tr> <!--DbEnv::log_flush--><tr><td><a href="../api_cxx/log_flush.html">DbEnv::log_flush</a></td><td>Flush log records</td></tr> +<!--DbEnv::log_printf--><tr><td><a href="../api_cxx/log_printf.html">DbEnv::log_printf</a></td><td>Append informational message to the log</td></tr> <!--DbEnv::log_put--><tr><td><a href="../api_cxx/log_put.html">DbEnv::log_put</a></td><td>Write a log record</td></tr> <!--DbEnv::log_stat--><tr><td><a href="../api_cxx/log_stat.html">DbEnv::log_stat</a></td><td>Return log subsystem statistics</td></tr> <tr><th>Logging Subsystem Cursors</th><th><br></th></tr> @@ -28,9 +29,10 @@ <tr><th>Logging Subsystem Configuration</th><th><br></th></tr> <!--DbEnv::set_lg_bsize--><tr><td><a href="../api_cxx/env_set_lg_bsize.html">DbEnv::set_lg_bsize</a></td><td>Set log buffer size</td></tr> <!--DbEnv::set_lg_dir--><tr><td><a href="../api_cxx/env_set_lg_dir.html">DbEnv::set_lg_dir</a></td><td>Set the environment logging directory</td></tr> +<!--DbEnv::set_lg_filemode--><tr><td><a href="../api_cxx/env_set_lg_mode.html">DbEnv::set_lg_filemode</a></td><td>Set log file mode</td></tr> <!--DbEnv::set_lg_max--><tr><td><a href="../api_cxx/env_set_lg_max.html">DbEnv::set_lg_max</a></td><td>Set log file size</td></tr> <!--DbEnv::set_lg_regionmax--><tr><td><a href="../api_cxx/env_set_lg_regionmax.html">DbEnv::set_lg_regionmax</a></td><td>Set logging region size</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_printf.html b/db/docs/api_cxx/log_printf.html new file mode 100644 index 000000000..f9333cd6b --- /dev/null +++ b/db/docs/api_cxx/log_printf.html @@ -0,0 +1,73 @@ +<!--$Id: log_printf.so,v 1.1 2005/09/30 19:00:24 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::log_printf</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::log_printf</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::log_printf(DB_TXN *txnid, const char *fmt, ...); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::log_printf</h3> +<p>The DbEnv::log_printf method appends an informational message to the Berkeley DB +database environment log files.</p> +<p>The DbEnv::log_printf method allows applications to include information in +the database environment log files, for later review using the +<a href="../utility/db_printlog.html">db_printlog</a> utility. This method is intended for debugging and +performance tuning.</p> +<p>The DbEnv::log_printf 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>txnid</b><dd>If the logged message refers to an application-specified transaction, +the <b>txnid</b> parameter is a transaction handle returned from +<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise NULL. +<dt><b>fmt</b><dd>A format string that specifies how subsequent arguments (or arguments +accessed via the variable-length argument facilities of stdarg(3)) are +converted for output. The format string may contain any formatting +directives supported by the underlying C library vsnprintf(3) +function. +</dl> +<h3>Errors</h3> +<p>The DbEnv::log_printf method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a>, <a href="../api_cxx/lsn_class.html">DbLsn</a> +<h3>See Also</h3> +<a href="../api_cxx/log_list.html">Logging Subsystem and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/log_put.html b/db/docs/api_cxx/log_put.html index bf26c120d..737e2e6fb 100644 --- a/db/docs/api_cxx/log_put.html +++ b/db/docs/api_cxx/log_put.html @@ -1,5 +1,5 @@ <!--$Id: log_put.so,v 10.41 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -53,7 +53,7 @@ that all records with <a href="../api_cxx/lsn_class.html">DbLsn</a> values less one being "put" are on disk before DbEnv::log_put returns. </dl> <dt><b>lsn</b><dd>The <b>lsn</b> parameter references memory into which - the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the put record is copied. + the <a href="../api_cxx/lsn_class.html">DbLsn</a> of the put record is copied. </dl> <h3>Errors</h3> <p>The <a href="../api_cxx/log_flush.html">DbEnv::log_flush</a> method @@ -74,6 +74,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/log_stat.html b/db/docs/api_cxx/log_stat.html index 027dd2622..32d0cdab6 100644 --- a/db/docs/api_cxx/log_stat.html +++ b/db/docs/api_cxx/log_stat.html @@ -1,5 +1,5 @@ -<!--$Id: log_stat.so,v 10.53 2004/09/17 17:13:12 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: log_stat.so,v 10.57 2005/10/28 19:45:34 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -47,7 +47,8 @@ individually freed.</p> <dt>u_int32_t st_version;<dd>The version of the log file type. <dt>int st_mode;<dd>The mode of any created log files. <dt>u_int32_t st_lg_bsize;<dd>The in-memory log record cache size. -<dt>u_int32_t st_lg_size;<dd>The current log file size. +<dt>u_int32_t st_lg_size;<dd>The log file size. +<dt>u_int32_t st_record;<dd>The number of records written to this log. <dt>u_int32_t st_w_mbytes;<dd>The number of megabytes written to this log. <dt>u_int32_t st_w_bytes;<dd>The number of bytes over and above <b>st_w_mbytes</b> written to this log. <dt>u_int32_t st_wc_mbytes;<dd>The number of megabytes written to this log since the last checkpoint. @@ -56,6 +57,7 @@ since the last checkpoint. <dt>u_int32_t st_wcount;<dd>The number of times the log has been written to disk. <dt>u_int32_t st_wcount_fill;<dd>The number of times the log has been written to disk because the in-memory log record cache filled up. +<dt>u_int32_t st_rcount;<dd>The number of times the log has been read from disk. <dt>u_int32_t st_scount;<dd>The number of times the log has been flushed to disk. <dt>u_int32_t st_cur_file;<dd>The current log file number. <dt>u_int32_t st_cur_offset;<dd>The byte offset in the current log file. @@ -64,11 +66,11 @@ in-memory log record cache filled up. <dt>u_int32_t st_maxcommitperflush;<dd>The maximum number of commits contained in a single log flush. <dt>u_int32_t st_mincommitperflush;<dd>The minimum number of commits contained in a single log flush that contained a commit. -<dt>roff_t st_regsize;<dd>The size of the region, in bytes. +<dt>roff_t st_regsize;<dd>The size of the log region, in bytes. <dt>u_int32_t st_region_wait;<dd>The number of times that a thread of control was forced to wait before -obtaining the region lock. +obtaining the log region mutex. <dt>u_int32_t st_region_nowait;<dd>The number of times that a thread of control was able to obtain -the region lock without waiting. +the log region mutex without waiting. </dl> <p>The DbEnv::log_stat method either returns a non-zero error value @@ -83,7 +85,7 @@ the following value: <dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. </dl> <dt><b>statp</b><dd>The <b>statp</b> parameter references memory into which -a pointer to the allocated statistics structure is copied. +a pointer to the allocated statistics structure is copied. </dl> <h3>Errors</h3> <p>The DbEnv::log_stat method @@ -97,7 +99,7 @@ invalid flag value or parameter was specified. </dl> <hr size=1 noshade> <h3>Description: DbEnv::log_stat_print</h3> -<p>The DbEnv::log_stat_print method returns the +<p>The DbEnv::log_stat_print method displays the logging subsystem statistical information, as described for the DbEnv::log_stat method. The information is printed to a specified output channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an @@ -112,10 +114,11 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> <dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. </dl> </dl> <hr size=1 noshade> @@ -127,6 +130,6 @@ the following value: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/logc_class.html b/db/docs/api_cxx/logc_class.html index bc6e7725f..e118ce2df 100644 --- a/db/docs/api_cxx/logc_class.html +++ b/db/docs/api_cxx/logc_class.html @@ -1,5 +1,5 @@ <!--$Id: logc_class.so,v 1.8 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -40,6 +40,6 @@ return.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/logc_close.html b/db/docs/api_cxx/logc_close.html index 478bb47d9..51e871000 100644 --- a/db/docs/api_cxx/logc_close.html +++ b/db/docs/api_cxx/logc_close.html @@ -1,5 +1,5 @@ <!--$Id: logc_close.so,v 10.13 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -58,6 +58,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/logc_get.html b/db/docs/api_cxx/logc_get.html index cebb31795..ae4d6d836 100644 --- a/db/docs/api_cxx/logc_get.html +++ b/db/docs/api_cxx/logc_get.html @@ -1,5 +1,5 @@ <!--$Id: logc_get.so,v 10.48 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -107,6 +107,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/lsn_class.html b/db/docs/api_cxx/lsn_class.html index c0e378615..93a0a00c3 100644 --- a/db/docs/api_cxx/lsn_class.html +++ b/db/docs/api_cxx/lsn_class.html @@ -1,5 +1,5 @@ <!--$Id: lsn_class.so,v 10.21 2004/08/13 03:38:57 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,6 +39,6 @@ the other specifies an offset in the log file.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_class.html b/db/docs/api_cxx/memp_class.html index cac910732..24183716a 100644 --- a/db/docs/api_cxx/memp_class.html +++ b/db/docs/api_cxx/memp_class.html @@ -1,5 +1,5 @@ <!--$Id: memp_class.so,v 10.20 2004/10/14 15:58:43 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -48,6 +48,6 @@ is still in scope and has not been deleted.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fclose.html b/db/docs/api_cxx/memp_fclose.html index 9062b6ef9..bd79adc89 100644 --- a/db/docs/api_cxx/memp_fclose.html +++ b/db/docs/api_cxx/memp_fclose.html @@ -1,5 +1,5 @@ <!--$Id: memp_fclose.so,v 10.33 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -53,6 +53,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fcreate.html b/db/docs/api_cxx/memp_fcreate.html index 9a6972648..0e0e34907 100644 --- a/db/docs/api_cxx/memp_fcreate.html +++ b/db/docs/api_cxx/memp_fcreate.html @@ -1,5 +1,5 @@ <!--$Id: memp_fcreate.so,v 10.12 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -49,6 +49,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fget.html b/db/docs/api_cxx/memp_fget.html index 6ee003a54..7d3e33458 100644 --- a/db/docs/api_cxx/memp_fget.html +++ b/db/docs/api_cxx/memp_fget.html @@ -1,5 +1,5 @@ -<!--$Id: memp_fget.so,v 10.43 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_fget.so,v 10.48 2006/09/13 14:30:54 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -23,7 +23,8 @@ #include <db_cxx.h> <p> int -DbMpoolFile::get(db_pgno_t *pgnoaddr, u_int32_t flags, void **pagep); +DbMpoolFile::get(db_pgno_t *pgnoaddr, + DbTxn *txnid, u_int32_t flags, void **pagep); </pre></h3> <hr size=1 noshade> <h3>Description: DbMpoolFile::get</h3> @@ -53,6 +54,15 @@ or more of the following values: <dt><a name="DB_MPOOL_CREATE">DB_MPOOL_CREATE</a><dd>If the specified page does not exist, create it. In this case, the <a href="memp_register.html#pgin">pgin</a> method, if specified, is called. +<dt><a name="DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a><dd>The page will be modified and must be written to the source file before +being evicted from the pool. For files open with the +<a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> flag set, a new copy of the page will be made +if this is the first time the specified transaction is modifying it. +<dt><a name="DB_MPOOL_EDIT">DB_MPOOL_EDIT</a><dd>The page will be modified and must be written to the source file before +being evicted from the pool. No copy of the page will be made, regardless +of the <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> setting. This flag is only intended for +use in situations where a transaction handle is not available, such as during +aborts or recovery. <dt><a name="DB_MPOOL_LAST">DB_MPOOL_LAST</a><dd>Return the last page of the source file, and copy its page number into the memory location to which <b>pgnoaddr</b> refers. <dt><a name="DB_MPOOL_NEW">DB_MPOOL_NEW</a><dd>Create a new page in the file, and copy its page number into the memory @@ -63,7 +73,7 @@ location to which <b>pgnoaddr</b> refers. In this case, the <p>The DB_MPOOL_CREATE, DB_MPOOL_LAST, and DB_MPOOL_NEW flags are mutually exclusive.</p> <dt><b>pagep</b><dd>The <b>pagep</b> parameter references memory into which -a pointer to the returned page is copied. +a pointer to the returned page is copied. <dt><b>pgnoaddr</b><dd>If the <b>flags</b> parameter is set to DB_MPOOL_LAST or DB_MPOOL_NEW, the page number of the created page is copied into the memory location to which the <b>pgnoaddr</b> parameter @@ -71,6 +81,13 @@ refers. Otherwise, the <b>pgnoaddr</b> parameter is the page to create or retrieve. <p><b>Page numbers begin at 0; that is, the first page in the file is page number 0, not page number 1.</b></p> +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise NULL. A transaction is +required if the file is open for multiversion concurrency control by +passing <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> to <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> and the +DB_MPOOL_DIRTY, DB_MPOOL_CREATE or +DB_MPOOL_NEW flags were specified. Otherwise it is ignored. </dl> <h3>Errors</h3> <p>The DbMpoolFile::get method @@ -79,6 +96,10 @@ may fail and throw encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> +<dt>EACCES<dd>The DB_MPOOL_DIRTY or DB_MPOOL_EDIT flag was set and +the source file was not opened for writing. +</dl> +<dl compact> <dt>EAGAIN<dd>The page reference count has overflowed. (This should never happen unless there is a bug in the application.) </dl> @@ -86,9 +107,13 @@ unless there is a bug in the application.) <dt>EINVAL<dd>If the DB_MPOOL_NEW flag was set, and the source file was not opened for writing; more than one of DB_MPOOL_CREATE, DB_MPOOL_LAST, and -DB_MPOOL_NEW was set; or if an +DB_MPOOL_NEW was set.; or if an invalid flag value or parameter was specified. </dl> +<dl compact> +<dt>DB_LOCK_DEADLOCK<dd>For transactions configured with <a href="../api_cxx/txn_begin.html#DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a>, the page has +been modified since the transaction began. +</dl> <p>If the cache is full, and no more pages will fit in the pool, the DbMpoolFile::get method will fail and either return ENOMEM or throw a DbMemoryException.</p> @@ -101,6 +126,6 @@ throw a DbMemoryException.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fopen.html b/db/docs/api_cxx/memp_fopen.html index 07cc22511..b10470969 100644 --- a/db/docs/api_cxx/memp_fopen.html +++ b/db/docs/api_cxx/memp_fopen.html @@ -1,5 +1,5 @@ -<!--$Id: memp_fopen.so,v 10.51 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_fopen.so,v 10.53 2006/08/08 05:24:05 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,8 +39,9 @@ failure, and returns 0 on success. <b>file</b> is NULL, a private temporary file is created that cannot be shared with any other process (although it may be shared with other threads of control in the same process). -<p>On Windows, the <b>file</b> argument will be interpreted as a UTF-8 -string, which is equivalent to ASCII for Latin characters.</p> +<p>When using a Unicode build on Windows (the default), the <b>file</b> +argument will be interpreted as a UTF-8 string, which is equivalent to +ASCII for Latin characters.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> @@ -50,6 +51,8 @@ fail. <a name="2"><!--meow--></a> <dt><a name="DB_DIRECT">DB_DIRECT</a><dd>If set and supported by the system, turn off system buffering of the file to avoid double caching. +<dt><a name="DB_MULTIVERSION">DB_MULTIVERSION</a><dd>Open the file with support for <a href="../ref/transapp/read.html">multiversion concurrency control</a>. Calls to <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a> which +dirty pages will cause copies to be made in the cache. <dt><a name="DB_NOMMAP">DB_NOMMAP</a><dd>Always copy this file into the local cache instead of potentially mapping it into process memory (see the description of the <a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a> method for further information). @@ -101,6 +104,6 @@ throw a DbMemoryException.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fput.html b/db/docs/api_cxx/memp_fput.html index e4051e506..4c3f9ae9f 100644 --- a/db/docs/api_cxx/memp_fput.html +++ b/db/docs/api_cxx/memp_fput.html @@ -1,5 +1,5 @@ -<!--$Id: memp_fput.so,v 10.31 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_fput.so,v 10.33 2006/09/11 23:31:27 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -41,14 +41,9 @@ address previously returned by <a href="../api_cxx/memp_fget.html">DbMpoolFile:: <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_MPOOL_CLEAN">DB_MPOOL_CLEAN</a><dd>Clear any previously set modification information (that is, don't bother -writing the page back to the source file). -<dt><a name="DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a><dd>The page has been modified and must be written to the source file before -being evicted from the pool. <dt><a name="DB_MPOOL_DISCARD">DB_MPOOL_DISCARD</a><dd>The page is unlikely to be useful in the near future, and should be discarded before other pages in the pool. </dl> -<p>The DB_MPOOL_CLEAN and DB_MPOOL_DIRTY flags are mutually exclusive.</p> </dl> <h3>Errors</h3> <p>The DbMpoolFile::put method @@ -57,14 +52,8 @@ may fail and throw encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> -<dt>EACCES<dd>The <a href="../api_cxx/memp_fput.html#DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a> flag was set and the source file was not -opened for writing. -</dl> -<dl compact> <dt>EINVAL<dd>If the <b>pgaddr</b> parameter does not refer to a page returned by -<a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>; -more than one of the <a href="../api_cxx/memp_fput.html#DB_MPOOL_CLEAN">DB_MPOOL_CLEAN</a> and <a href="../api_cxx/memp_fput.html#DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a> -flags was set; or if an +<a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>; or if an invalid flag value or parameter was specified. </dl> <hr size=1 noshade> @@ -76,6 +65,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fset.html b/db/docs/api_cxx/memp_fset.html index 18b780d9f..4c1bc1033 100644 --- a/db/docs/api_cxx/memp_fset.html +++ b/db/docs/api_cxx/memp_fset.html @@ -1,5 +1,5 @@ <!--$Id: memp_fset.so,v 10.30 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -41,14 +41,9 @@ address previously returned by <a href="../api_cxx/memp_fget.html">DbMpoolFile:: <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_MPOOL_CLEAN">DB_MPOOL_CLEAN</a><dd>Clear any previously set modification information (that is, don't bother -writing the page back to the source file). -<dt><a name="DB_MPOOL_DIRTY">DB_MPOOL_DIRTY</a><dd>The page has been modified and must be written to the source file before -being evicted from the pool. <dt><a name="DB_MPOOL_DISCARD">DB_MPOOL_DISCARD</a><dd>The page is unlikely to be useful in the near future, and should be discarded before other pages in the pool. </dl> -<p>The DB_MPOOL_CLEAN and DB_MPOOL_DIRTY flags are mutually exclusive.</p> </dl> <h3>Errors</h3> <p>The DbMpoolFile::set method @@ -69,6 +64,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_fsync.html b/db/docs/api_cxx/memp_fsync.html index 4685e2fea..c33dc840c 100644 --- a/db/docs/api_cxx/memp_fsync.html +++ b/db/docs/api_cxx/memp_fsync.html @@ -1,5 +1,5 @@ <!--$Id: memp_fsync.so,v 10.35 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -46,6 +46,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_list.html b/db/docs/api_cxx/memp_list.html index 211eec229..d300fad59 100644 --- a/db/docs/api_cxx/memp_list.html +++ b/db/docs/api_cxx/memp_list.html @@ -1,5 +1,5 @@ <!--$Id: memp_list.so,v 1.1 2002/08/30 20:01:28 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,19 +10,19 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Memory Pools and Related Methods</h3> -<!--$Id: m4.methods,v 1.7 2004/11/03 15:52:02 bostic Exp $--> +<!--$Id: m4.methods,v 1.9 2006/08/25 16:40:01 bostic Exp $--> <table border=1 align=center> <tr><th>Memory Pools and Related Methods</th><th>Description</th></tr> -<!--Db::mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return the database's memory pool handle</td></tr> +<!--Db::mpf--><tr><td><a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a></td><td>Return <a href="../api_cxx/db_class.html">Db</a>'s underlying <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle</td></tr> <!--DbEnv::memp_stat--><tr><td><a href="../api_cxx/memp_stat.html">DbEnv::memp_stat</a></td><td>Return memory pool statistics</td></tr> <!--DbEnv::memp_sync--><tr><td><a href="../api_cxx/memp_sync.html">DbEnv::memp_sync</a></td><td>Flush pages from a memory pool</td></tr> <!--DbEnv::memp_trickle--><tr><td><a href="../api_cxx/memp_trickle.html">DbEnv::memp_trickle</a></td><td>Trickle flush pages from a memory pool</td></tr> <!--DbMemoryException--><tr><td><a href="../api_cxx/memp_class.html">DbMemoryException</a></td><td>Insufficient memory exception</td></tr> <tr><th>Memory Pool Configuration</th><th><br></th></tr> <!--DbEnv::memp_register--><tr><td><a href="../api_cxx/memp_register.html">DbEnv::memp_register</a></td><td>Register input/output functions for a file in a memory pool</td></tr> -<!--DbEnv::memp_set_max_openfd--><tr><td><a href="../api_cxx/memp_openfd.html">DbEnv::set_max_openfd</a></td><td>Set the maximum number of open file descriptors</td></tr> -<!--DbEnv::memp_set_max_write--><tr><td><a href="../api_cxx/memp_maxwrite.html">DbEnv::set_max_write</a></td><td>Set the maximum number of sequential disk writes</td></tr> <!--DbEnv::set_cachesize--><tr><td><a href="../api_cxx/env_set_cachesize.html">DbEnv::set_cachesize</a></td><td>Set the environment cache size</td></tr> +<!--DbEnv::set_mp_max_openfd--><tr><td><a href="../api_cxx/memp_openfd.html">DbEnv::set_mp_max_openfd</a></td><td>Set the maximum number of open file descriptors</td></tr> +<!--DbEnv::set_mp_max_write--><tr><td><a href="../api_cxx/memp_maxwrite.html">DbEnv::set_mp_max_write</a></td><td>Set the maximum number of sequential disk writes</td></tr> <!--DbEnv::set_mp_mmapsize--><tr><td><a href="../api_cxx/env_set_mp_mmapsize.html">DbEnv::set_mp_mmapsize</a></td><td>Set maximum mapped-in database file size</td></tr> <tr><th>Memory Pool Files</th><th><br></th></tr> <!--DbEnv::memp_fcreate--><tr><td><a href="../api_cxx/memp_fcreate.html">DbEnv::memp_fcreate</a></td><td>Create a memory pool file handle</td></tr> @@ -43,6 +43,6 @@ <!--DbMpoolFile::set_pgcookie--><tr><td><a href="../api_cxx/memp_set_pgcookie.html">DbMpoolFile::set_pgcookie</a></td><td>Set file cookie for pgin/pgout</td></tr> <!--DbMpoolFile::set_priority--><tr><td><a href="../api_cxx/memp_set_priority.html">DbMpoolFile::set_priority</a></td><td>Set memory pool file priority</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_maxwrite.html b/db/docs/api_cxx/memp_maxwrite.html index 60364aa6d..0c54e094a 100644 --- a/db/docs/api_cxx/memp_maxwrite.html +++ b/db/docs/api_cxx/memp_maxwrite.html @@ -1,17 +1,17 @@ -<!--$Id: memp_maxwrite.so,v 10.2 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_maxwrite.so,v 10.4 2006/04/26 16:55:20 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbEnv::set_max_write</title> +<title>Berkeley DB: DbEnv::set_mp_max_write</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <table width="100%"><tr valign=top> <td> -<h3>DbEnv::set_max_write</h3> +<h3>DbEnv::set_mp_max_write</h3> </td> <td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> @@ -23,17 +23,17 @@ #include <db_cxx.h> <p> int -DbEnv::memp_set_max_write(int maxwrite, int maxwrite_sleep); +DbEnv::set_mp_max_write(int maxwrite, int maxwrite_sleep); <p> int -DbEnv::memp_get_max_write(int *maxwritep, int *maxwrite_sleepp); +DbEnv::get_mp_max_write(int *maxwritep, int *maxwrite_sleepp); </pre></h3> <hr size=1 noshade> -<h3>Description: DbEnv::set_max_write</h3> -<p>The DbEnv::set_max_write method limits the number of sequential write +<h3>Description: DbEnv::set_mp_max_write</h3> +<p>The DbEnv::set_mp_max_write method limits the number of sequential write operations scheduled by the library when flushing dirty pages from the cache.</p> -<p>The DbEnv::set_max_write method +<p>The DbEnv::set_mp_max_write 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. @@ -41,12 +41,13 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>maxwrite</b><dd>The maximum number of sequential write operations scheduled by the -library when flushing dirty pages from the cache. +library when flushing dirty pages from the cache, or 0 if there is +no limitation on the number of sequential write operations. <dt><b>maxwrite_sleep</b><dd>The number of microseconds the thread of control should pause before scheduling further write operations. </dl> <h3>Errors</h3> -<p>The DbEnv::set_max_write method +<p>The DbEnv::set_mp_max_write method may fail and throw <a href="../api_cxx/except_class.html">DbException</a>, encapsulating one of the following non-zero errors, or return one of @@ -56,12 +57,12 @@ the following non-zero errors:</p> invalid flag value or parameter was specified. </dl> <hr size=1 noshade> -<h3>Description: DbEnv::get_max_write</h3> -<p>The DbEnv::get_max_write method returns the current maximum number of +<h3>Description: DbEnv::get_mp_max_write</h3> +<p>The DbEnv::get_mp_max_write method returns the current maximum number of sequential write operations and microseconds to pause.</p> -<p>The DbEnv::get_max_write method may be called at any time during the life of the +<p>The DbEnv::get_mp_max_write method may be called at any time during the life of the application.</p> -<p>The DbEnv::get_max_write method +<p>The DbEnv::get_mp_max_write 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. @@ -69,9 +70,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>maxwritep</b><dd>The <b>maxwritep</b> parameter references memory into which - the maximum number of sequential write operations is copied. + the maximum number of sequential write operations is copied. <dt><b>maxwrite_sleepp</b><dd>The <b>maxwrite_sleepp</b> parameter references memory into which - the microseconds to pause before scheduling further write operations is copied. + the microseconds to pause before scheduling further write operations is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -82,6 +83,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_openfd.html b/db/docs/api_cxx/memp_openfd.html index 9d81dc760..bc45eeb99 100644 --- a/db/docs/api_cxx/memp_openfd.html +++ b/db/docs/api_cxx/memp_openfd.html @@ -1,17 +1,17 @@ -<!--$Id: memp_openfd.so,v 10.2 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_openfd.so,v 10.3 2005/03/08 14:36:15 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbEnv::set_max_openfd</title> +<title>Berkeley DB: DbEnv::set_mp_max_openfd</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <table width="100%"><tr valign=top> <td> -<h3>DbEnv::set_max_openfd</h3> +<h3>DbEnv::set_mp_max_openfd</h3> </td> <td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> @@ -23,17 +23,17 @@ #include <db_cxx.h> <p> int -DbEnv::memp_set_max_openfd(int maxopenfd); +DbEnv::set_mp_max_openfd(int maxopenfd); <p> int -DbEnv::memp_get_max_openfd(int *maxopenfdp); +DbEnv::get_mp_max_openfd(int *maxopenfdp); </pre></h3> <hr size=1 noshade> -<h3>Description: DbEnv::set_max_openfd</h3> -<p>The DbEnv::set_max_openfd method limits the number of file descriptors +<h3>Description: DbEnv::set_mp_max_openfd</h3> +<p>The DbEnv::set_mp_max_openfd method limits the number of file descriptors the library will open concurrently when flushing dirty pages from the cache.</p> -<p>The DbEnv::set_max_openfd method +<p>The DbEnv::set_mp_max_openfd 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. @@ -44,7 +44,7 @@ failure, and returns 0 on success. by the library when flushing dirty pages from the cache. </dl> <h3>Errors</h3> -<p>The DbEnv::set_max_openfd method +<p>The DbEnv::set_mp_max_openfd method may fail and throw <a href="../api_cxx/except_class.html">DbException</a>, encapsulating one of the following non-zero errors, or return one of @@ -54,18 +54,18 @@ the following non-zero errors:</p> invalid flag value or parameter was specified. </dl> <hr size=1 noshade> -<h3>Description: DbEnv::get_max_openfd</h3> -<p>The DbEnv::get_max_openfd method returns the maximum number of file descriptors open.</p> -<p>The DbEnv::get_max_openfd method may be called at any time during the life of the +<h3>Description: DbEnv::get_mp_max_openfd</h3> +<p>The DbEnv::get_mp_max_openfd method returns the maximum number of file descriptors open.</p> +<p>The DbEnv::get_mp_max_openfd method may be called at any time during the life of the application.</p> -<p>The DbEnv::get_max_openfd method +<p>The DbEnv::get_mp_max_openfd 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. </p> <h3>Parameters</h3> <dl compact> -<dt><b>maxopenfdp</b><dd>The DbEnv::get_max_openfd method returns the +<dt><b>maxopenfdp</b><dd>The DbEnv::get_mp_max_openfd method returns the maximum number of file descriptors open in <b>maxopenfdp</b>. </dl> <hr size=1 noshade> @@ -77,6 +77,6 @@ maximum number of file descriptors open in <b>maxopenfdp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_register.html b/db/docs/api_cxx/memp_register.html index b1385445e..1feaf0bdf 100644 --- a/db/docs/api_cxx/memp_register.html +++ b/db/docs/api_cxx/memp_register.html @@ -1,5 +1,5 @@ <!--$Id: memp_register.so,v 10.38 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -82,6 +82,6 @@ the Berkeley DB library).</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_clear_len.html b/db/docs/api_cxx/memp_set_clear_len.html index 828892a8e..e970073e2 100644 --- a/db/docs/api_cxx/memp_set_clear_len.html +++ b/db/docs/api_cxx/memp_set_clear_len.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_clear_len.so,v 10.16 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_clear_len.so,v 10.18 2005/11/30 19:46:21 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -33,8 +33,8 @@ DbMpoolFile::get_clear_len(u_int32_t *lenp); <p>The DbMpoolFile::set_clear_len method sets the number of initial bytes in a page that should be set to nul when the page is created as a result of the <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> +specified to <a href="../api_cxx/memp_fget.html">DbMpoolFile::get</a>. If no clear length is specified, the +entire page is cleared when it is created.</p> <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> <p>The DbMpoolFile::set_clear_len method may not be called after the <a href="../api_cxx/memp_fopen.html">DbMpoolFile::open</a> method is @@ -57,9 +57,19 @@ the entire page being set to nul bytes. </dl> <hr size=1 noshade> <h3>Description: DbMpoolFile::get_clear_len</h3> -<p>The DbMpoolFile::get_clear_len method returns the .</p> +<p>The DbMpoolFile::get_clear_len method returns the bytes to be cleared.</p> <p>The DbMpoolFile::get_clear_len method may be called at any time during the life of the application.</p> +<p>The DbMpoolFile::get_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>lenp</b><dd>The DbMpoolFile::get_clear_len method returns the +bytes to be cleared in <b>lenp</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> @@ -69,6 +79,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_fileid.html b/db/docs/api_cxx/memp_set_fileid.html index 53711e951..3bab6f092 100644 --- a/db/docs/api_cxx/memp_set_fileid.html +++ b/db/docs/api_cxx/memp_set_fileid.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_fileid.so,v 10.13 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_fileid.so,v 10.14 2005/04/14 13:08:06 sue Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -73,12 +73,12 @@ Unique file identifiers must be a DB_FILE_ID_LEN length array of bytes. <h3>Description: DbMpoolFile::get_fileid</h3> <p>The DbMpoolFile::get_fileid method copies the file's identifier into the memory location referenced by <b>fileid</b>.</p> -<p>The <a href="../api_cxx/env_set_data_dir.html">DbEnv::get_data_dirs</a> method +<p>The DbMpoolFile::get_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. </p> -<p>The <a href="../api_cxx/env_set_data_dir.html">DbEnv::get_data_dirs</a> method may be called at any time during the life of the +<p>The DbMpoolFile::get_fileid method may be called at any time during the life of the application.</p> <hr size=1 noshade> <h3>Class</h3> @@ -89,6 +89,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_flags.html b/db/docs/api_cxx/memp_set_flags.html index 757bc2f88..0742e8f1a 100644 --- a/db/docs/api_cxx/memp_set_flags.html +++ b/db/docs/api_cxx/memp_set_flags.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_flags.so,v 1.17 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_flags.so,v 1.18 2005/09/17 16:30:18 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -47,9 +47,13 @@ of the following values: <dt><a name="DB_MPOOL_NOFILE">DB_MPOOL_NOFILE</a><dd>If set, no backing temporary file will be opened for in-memory databases, even if they expand to fill the entire cache. Attempts to create new file pages after the cache has been filled will fail. +<p>The DB_MPOOL_NOFILE flag 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> <p>The DB_MPOOL_NOFILE flag may be used to configure Berkeley DB at any time during the life of the application.</p> <dt><a name="DB_MPOOL_UNLINK">DB_MPOOL_UNLINK</a><dd>If set, remove the file when the last reference to it is closed. +<p>The DB_MPOOL_NOFILE flag 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> <p>The DB_MPOOL_UNLINK flag may be used to configure Berkeley DB at any time during the life of the application.</p> </dl> @@ -81,6 +85,6 @@ flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_ftype.html b/db/docs/api_cxx/memp_set_ftype.html index fa978e582..464f67dbf 100644 --- a/db/docs/api_cxx/memp_set_ftype.html +++ b/db/docs/api_cxx/memp_set_ftype.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_ftype.so,v 10.16 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_ftype.so,v 10.17 2005/11/30 19:46:21 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -54,9 +54,19 @@ and output processing. The <b>ftype</b> must be the same as a </dl> <hr size=1 noshade> <h3>Description: DbMpoolFile::get_ftype</h3> -<p>The DbMpoolFile::get_ftype method returns the .</p> +<p>The DbMpoolFile::get_ftype method returns the file type.</p> <p>The DbMpoolFile::get_ftype method may be called at any time during the life of the application.</p> +<p>The DbMpoolFile::get_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>ftypep</b><dd>The DbMpoolFile::get_ftype method returns the +file type in <b>ftypep</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> @@ -66,6 +76,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_lsn_offset.html b/db/docs/api_cxx/memp_set_lsn_offset.html index 2244072fc..09f42311c 100644 --- a/db/docs/api_cxx/memp_set_lsn_offset.html +++ b/db/docs/api_cxx/memp_set_lsn_offset.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_lsn_offset.so,v 10.16 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_lsn_offset.so,v 10.17 2005/04/14 17:57:54 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -55,9 +55,19 @@ log sequence number on the file's pages. </dl> <hr size=1 noshade> <h3>Description: DbMpoolFile::get_lsn_offset</h3> -<p>The DbMpoolFile::get_lsn_offset method returns the .</p> +<p>The DbMpoolFile::get_lsn_offset method returns the log sequence number byte offset.</p> <p>The DbMpoolFile::get_lsn_offset method may be called at any time during the life of the application.</p> +<p>The DbMpoolFile::get_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>lsn_offsetp</b><dd>The DbMpoolFile::get_lsn_offset method returns the +log sequence number byte offset in <b>lsn_offsetp</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> @@ -67,6 +77,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_maxsize.html b/db/docs/api_cxx/memp_set_maxsize.html index 488e0f40e..102053a6f 100644 --- a/db/docs/api_cxx/memp_set_maxsize.html +++ b/db/docs/api_cxx/memp_set_maxsize.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_maxsize.so,v 1.14 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_maxsize.so,v 1.15 2005/09/17 16:30:18 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -37,6 +37,8 @@ limit has been reached will fail.</p> DbMpoolFile::set_maxsize method using the <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle stored in the <b>mpf</b> field of the <a href="../api_cxx/db_class.html">Db</a> handle. Attempts to insert new items into the database after the limit has been reached may fail.</p> +<p>The DbMpoolFile::set_maxsize 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> <p>The DbMpoolFile::set_maxsize method may be called at any time during the life of the application.</p> <p>The DbMpoolFile::set_maxsize method @@ -63,9 +65,9 @@ application.</p> <h3>Parameters</h3> <dl compact> <dt><b>bytesp</b><dd>The <b>bytesp</b> parameter references memory into which - the additional bytes of memory in the maximum file size is copied. + the additional bytes of memory in the maximum file size is copied. <dt><b>gbytesp</b><dd>The <b>gbytesp</b> parameter references memory into which - the gigabytes of memory in the maximum file size is copied. + the gigabytes of memory in the maximum file size is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -76,6 +78,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_pgcookie.html b/db/docs/api_cxx/memp_set_pgcookie.html index ae9ff48fc..8d8b7ab4d 100644 --- a/db/docs/api_cxx/memp_set_pgcookie.html +++ b/db/docs/api_cxx/memp_set_pgcookie.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_pgcookie.so,v 10.16 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_pgcookie.so,v 10.17 2005/11/30 19:46:21 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -55,9 +55,19 @@ pages. </dl> <hr size=1 noshade> <h3>Description: DbMpoolFile::get_pgcookie</h3> -<p>The DbMpoolFile::get_pgcookie method returns the .</p> +<p>The DbMpoolFile::get_pgcookie method returns the byte string.</p> <p>The DbMpoolFile::get_pgcookie method may be called at any time during the life of the application.</p> +<p>The DbMpoolFile::get_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>dbt</b><dd>The DbMpoolFile::get_pgcookie method returns a reference to the +byte string in <b>dbt</b>. +</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> @@ -67,6 +77,6 @@ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_set_priority.html b/db/docs/api_cxx/memp_set_priority.html index 263223e4b..cde1c365b 100644 --- a/db/docs/api_cxx/memp_set_priority.html +++ b/db/docs/api_cxx/memp_set_priority.html @@ -1,5 +1,5 @@ -<!--$Id: memp_set_priority.so,v 10.22 2004/09/28 15:04:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_set_priority.so,v 10.23 2005/08/12 17:05:52 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,6 +39,8 @@ does not guarantee pages will be treated in a specific way.</p> <p>To set the priority for the pages belonging to a particular database, call the DbMpoolFile::set_priority method using the <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> handle returned by calling the <a href="../api_cxx/db_get_mpf.html">Db::get_mpf</a> method.</p> +<p>The DbMpoolFile::set_priority 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> <p>The DbMpoolFile::set_priority method may be called at any time during the life of the application.</p> <p>The DbMpoolFile::set_priority method @@ -82,6 +84,6 @@ cache priority in <b>priorityp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_stat.html b/db/docs/api_cxx/memp_stat.html index 093f7cbda..0d0651621 100644 --- a/db/docs/api_cxx/memp_stat.html +++ b/db/docs/api_cxx/memp_stat.html @@ -1,5 +1,5 @@ -<!--$Id: memp_stat.so,v 10.63 2004/09/28 18:18:30 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_stat.so,v 10.67 2006/09/11 16:56:44 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -52,6 +52,10 @@ The following DB_MPOOL_STAT fields will be filled in:</p> <dt>size_t st_bytes;<dd>Bytes of cache (total cache size is st_gbytes + st_bytes). <dt>u_int32_t st_ncache;<dd>Number of caches. <dt>roff_t st_regsize;<dd>Individual cache size, in bytes. +<dt>size_t st_mmapsize;<dd>Maximum memory-mapped file size. +<dt>int st_maxopenfd;<dd>Maximum open file descriptors. +<dt>int st_maxwrite;<dd>Maximum sequential buffer writes. +<dt>int st_maxwrite_sleep;<dd>Sleep after writing maximum sequential buffers. <dt>u_int32_t st_map;<dd>Requested pages mapped into the process' address space (there is no available information about whether or not this request caused disk I/O, although examining the application page fault rate may be helpful). @@ -68,27 +72,30 @@ although examining the application page fault rate may be helpful). <dt>u_int32_t st_page_dirty;<dd>Dirty pages currently in the cache. <dt>u_int32_t st_hash_buckets;<dd>Number of hash buckets in buffer hash table. <dt>u_int32_t st_hash_searches;<dd>Total number of buffer hash table lookups. -<dt>u_int32_t st_hash_longest;<dd>The longest chain ever encountered in buffer hash table lookups. +<dt>u_int32_t st_hash_longest;<dd>Longest chain ever encountered in buffer hash table lookups. <dt>u_int32_t st_hash_examined;<dd>Total number of hash elements traversed during hash table lookups. -<dt>u_int32_t st_hash_nowait;<dd>The number of times that a thread of control was able to obtain a hash +<dt>u_int32_t st_hash_nowait;<dd>Number of times that a thread of control was able to obtain a hash bucket lock without waiting. -<dt>u_int32_t st_hash_wait;<dd>The number of times that a thread of control was forced to wait before +<dt>u_int32_t st_hash_wait;<dd>Number of times that a thread of control was forced to wait before obtaining a hash bucket lock. -<dt>u_int32_t st_hash_max_wait;<dd>The maximum number of times any hash bucket lock was waited for by a +<dt>u_int32_t st_hash_max_nowait;<dd>The number of times a thread of control was able to obtain the hash +bucket lock without waiting on the bucket which had the maximum number +of times that a thread of control needed to wait. +<dt>u_int32_t st_hash_max_wait;<dd>Maximum number of times any hash bucket lock was waited for by a thread of control. -<dt>u_int32_t st_region_wait;<dd>The number of times that a thread of control was forced to wait before -obtaining a region lock. -<dt>u_int32_t st_region_nowait;<dd>The number of times that a thread of control was able to obtain a region -lock without waiting. +<dt>u_int32_t st_region_wait;<dd>Number of times that a thread of control was forced to wait before +obtaining a cache region mutex. +<dt>u_int32_t st_region_nowait;<dd>Number of times that a thread of control was able to obtain a cache +region mutex without waiting. +<dt>u_int32_t st_mvcc_frozen;<dd>Number of buffers frozen. +<dt>u_int32_t st_mvcc_thawed;<dd>Number of buffers thawed. +<dt>u_int32_t st_mvcc_freed;<dd>Number of frozen buffers freed. <dt>u_int32_t st_alloc;<dd>Number of page allocations. <dt>u_int32_t st_alloc_buckets;<dd>Number of hash buckets checked during allocation. <dt>u_int32_t st_alloc_max_buckets;<dd>Maximum number of hash buckets checked during an allocation. <dt>u_int32_t st_alloc_pages;<dd>Number of pages checked during allocation. <dt>u_int32_t st_alloc_max_pages;<dd>Maximum number of pages checked during an allocation. -<dt>u_int32_t st_mmapsize;<dd>Maximum memory-mapped file size. -<dt>u_int32_t st_maxopenfd;<dd>Maximum open file descriptors. -<dt>u_int32_t st_maxwrite;<dd>Maximum sequential buffer writes. -<dt>u_int32_t st_maxwrite_sleep;<dd>Sleep after writing maximum sequential buffers. +<dt>u_int32_t st_io_wait;<dd>Number of operations blocked waiting for I/O to complete. </dl> The <b>flags</b> parameter must be set to 0 or the following value: @@ -126,9 +133,9 @@ the following value: <dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. </dl> <dt><b>fsp</b><dd>The <b>fsp</b> parameter references memory into which -a pointer to the allocated per-file statistics structures is copied. +a pointer to the allocated per-file statistics structures is copied. <dt><b>gsp</b><dd>The <b>gsp</b> parameter references memory into which -a pointer to the allocated global statistics structure is copied. +a pointer to the allocated global statistics structure is copied. </dl> <h3>Errors</h3> <p>The DbEnv::memp_stat method @@ -169,6 +176,6 @@ of the following values: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_sync.html b/db/docs/api_cxx/memp_sync.html index d66302c6d..f2d7c8065 100644 --- a/db/docs/api_cxx/memp_sync.html +++ b/db/docs/api_cxx/memp_sync.html @@ -1,5 +1,5 @@ -<!--$Id: memp_sync.so,v 10.41 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: memp_sync.so,v 10.42 2004/11/12 02:55:19 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -52,17 +52,6 @@ a certain time have been written to disk. than the <b>lsn</b> parameter are written to disk. If <b>lsn</b> is NULL, all modified pages in the pool are written to disk.</p> </dl> -<h3>Errors</h3> -<p>The DbEnv::memp_sync method -may fail and throw -<a href="../api_cxx/except_class.html">DbException</a>, -encapsulating one of the following non-zero errors, or return one of -the following non-zero errors:</p> -<dl compact> -<dt>EINVAL<dd>If the DbEnv::memp_sync function was called without logging having been -initialized in the environment; or if an -invalid flag value or parameter was specified. -</dl> <hr size=1 noshade> <h3>Class</h3> <a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/mempfile_class.html">DbMpoolFile</a> @@ -72,6 +61,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/memp_trickle.html b/db/docs/api_cxx/memp_trickle.html index d809b6d6e..45378320e 100644 --- a/db/docs/api_cxx/memp_trickle.html +++ b/db/docs/api_cxx/memp_trickle.html @@ -1,5 +1,5 @@ <!--$Id: memp_trickle.so,v 10.36 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -42,7 +42,7 @@ failure, and returns 0 on success. <dl compact> <dt><b>nwrotep</b><dd>The <b>nwrotep</b> parameter references memory into which the number of pages written to reach the specified -percentage is copied. +percentage is copied. <dt><b>percent</b><dd>The <b>percent</b> parameter is the percent of the pages in the cache that should be clean. </dl> @@ -65,6 +65,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/mempfile_class.html b/db/docs/api_cxx/mempfile_class.html index 388cee9c8..70c412804 100644 --- a/db/docs/api_cxx/mempfile_class.html +++ b/db/docs/api_cxx/mempfile_class.html @@ -1,5 +1,5 @@ <!--$Id: mempfile_class.so,v 10.24 2004/08/13 03:38:58 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -67,6 +67,6 @@ calls in a purely C++ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/mutex_alloc.html b/db/docs/api_cxx/mutex_alloc.html new file mode 100644 index 000000000..b42d72cf6 --- /dev/null +++ b/db/docs/api_cxx/mutex_alloc.html @@ -0,0 +1,78 @@ +<!--$Id: mutex_alloc.so,v 10.2 2006/01/27 16:13:49 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_alloc</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_alloc</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_alloc(u_int32_t flags, db_mutex_t *mutexp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_alloc</h3> +<p>The DbEnv::mutex_alloc method allocates a mutex and returns a reference to +it into the memory specified by <b>mutexp</b>.</p> +<p>The DbEnv::mutex_alloc method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::mutex_alloc 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +the following value: +<dl compact> +<dt><a name="DB_MUTEX_PROCESS_ONLY">DB_MUTEX_PROCESS_ONLY</a><dd>The mutex is associated with a single process. The <a href="../api_cxx/env_failchk.html">DbEnv::failchk</a> method +will release mutexes held by any process which has exited. +<dt><a name="DB_MUTEX_SELF_BLOCK">DB_MUTEX_SELF_BLOCK</a><dd>The mutex must be self-blocking. That is, if a thread of control locks +the mutex and then attempts to lock the mutex again, the thread of +control will block until another thread of control releases the original +lock on the mutex, allowing the original thread of control to lock the +mutex the second time. Attempting to re-acquire a mutex for which the +DB_MUTEX_SELF_BLOCK flag was not specified will result in +undefined behavior. +</dl> +<dt><b>mutexp</b><dd>The <b>mutexp</b> parameter references memory into which + the mutex reference is copied. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_alloc method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_free.html b/db/docs/api_cxx/mutex_free.html new file mode 100644 index 000000000..b6c8bfd05 --- /dev/null +++ b/db/docs/api_cxx/mutex_free.html @@ -0,0 +1,64 @@ +<!--$Id: mutex_free.so,v 10.1 2005/07/20 16:33:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_free</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_free</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_free(db_mutex_t mutex); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_free</h3> +<p>The DbEnv::mutex_free method discards a mutex allocated by <a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a>.</p> +<p>The DbEnv::mutex_free method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::mutex_free 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>mutex</b><dd>The <b>mutex</b> parameter is a mutex previously allocated by +<a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a>. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_free method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_list.html b/db/docs/api_cxx/mutex_list.html new file mode 100644 index 000000000..0b09b1b06 --- /dev/null +++ b/db/docs/api_cxx/mutex_list.html @@ -0,0 +1,29 @@ +<!--$Id: mutex_list.so,v 10.1 2005/07/20 16:33:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: Berkeley DB: Mutexes and Related Methods</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<h3 align=center>Berkeley DB: Mutexes and Related Methods</h3> +<!--$Id: m4.methods,v 10.1 2005/07/20 16:33:59 bostic Exp $--> +<table border=1 align=center> +<tr><th>Mutexes and Related Methods</th><th>Description</th></tr> +<!--DbEnv::mutex_alloc--><tr><td><a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a></td><td>Allocate a mutex</td></tr> +<!--DbEnv::mutex_free--><tr><td><a href="../api_cxx/mutex_free.html">DbEnv::mutex_free</a></td><td>Free a mutex</td></tr> +<!--DbEnv::mutex_lock--><tr><td><a href="../api_cxx/mutex_lock.html">DbEnv::mutex_lock</a></td><td>Lock a mutex</td></tr> +<!--DbEnv::mutex_stat--><tr><td><a href="../api_cxx/mutex_stat.html">DbEnv::mutex_stat</a></td><td>Mutex statistics</td></tr> +<!--DbEnv::mutex_unlock--><tr><td><a href="../api_cxx/mutex_unlock.html">DbEnv::mutex_unlock</a></td><td>Unlock a mutex</td></tr> +<tr><th>Mutex Configuration</th><th><br></th></tr> +<!--DbEnv::mutex_set_align--><tr><td><a href="../api_cxx/mutex_set_align.html">DbEnv::mutex_set_align</a></td><td>Configure mutex alignment</td></tr> +<!--DbEnv::mutex_set_increment--><tr><td><a href="../api_cxx/mutex_set_max.html">DbEnv::mutex_set_increment</a></td><td>Configure number of additional mutexes</td></tr> +<!--DbEnv::mutex_set_max--><tr><td><a href="../api_cxx/mutex_set_max.html">DbEnv::mutex_set_max</a></td><td>Configure total number of mutexes</td></tr> +<!--DbEnv::mutex_set_tas_spins--><tr><td><a href="../api_cxx/mutex_set_tas_spins.html">DbEnv::mutex_set_tas_spins</a></td><td>Configure test-and-set mutex spin count</td></tr> +</table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_lock.html b/db/docs/api_cxx/mutex_lock.html new file mode 100644 index 000000000..b1b70816a --- /dev/null +++ b/db/docs/api_cxx/mutex_lock.html @@ -0,0 +1,66 @@ +<!--$Id: mutex_lock.so,v 10.1 2005/07/20 16:33:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_lock</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_lock</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_lock(db_mutex_t mutex); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_lock</h3> +<p>The DbEnv::mutex_lock method locks the mutex allocated by +<a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a>. The thread of control calling DbEnv::mutex_lock +will block until the lock is available.</p> +<p>The DbEnv::mutex_lock method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::mutex_lock 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>mutex</b><dd>The <b>mutex</b> parameter is a mutex previously allocated by +<a href="../api_cxx/mutex_alloc.html">DbEnv::mutex_alloc</a>. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_lock method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_set_align.html b/db/docs/api_cxx/mutex_set_align.html new file mode 100644 index 000000000..a8f659d4c --- /dev/null +++ b/db/docs/api_cxx/mutex_set_align.html @@ -0,0 +1,99 @@ +<!--$Id: mutex_set_align.so,v 10.1 2005/07/20 16:34:00 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_set_align</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_set_align</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_set_align(u_int32_t align); +<p> +int +DbEnv::mutex_get_align(u_int32_t *alignp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_set_align</h3> +<p>Set the mutex alignment, in bytes.</p> +<p>It is sometimes advantageous to align mutexes on specific byte +boundaries in order to minimize cache line collisions. The +DbEnv::mutex_set_align method specifies an alignment for mutexes allocated +by Berkeley DB.</p> +<p>The database environment's mutex alignment may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "mutex_set_align", one or more whitespace +characters, and the mutex alignment in bytes. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::mutex_set_align method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::mutex_set_align method may not be called after the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is +called. +If the database environment already exists when +<a href="../api_cxx/env_open.html">DbEnv::open</a> is called, the information specified to DbEnv::mutex_set_align +will be ignored. +</p> +<p>The DbEnv::mutex_set_align 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>align</b><dd>The <b>align</b> parameter is the mutex alignment, in bytes. The mutex +alignment must be a power-of-two. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_set_align method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_get_align</h3> +<p>The DbEnv::mutex_get_align method returns the mutex alignment, in bytes.</p> +<p>The DbEnv::mutex_get_align method may be called at any time during the life of the +application.</p> +<p>The DbEnv::mutex_get_align 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>alignp</b><dd>The DbEnv::mutex_get_align method returns the +mutex alignment, in bytes in <b>alignp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_set_max.html b/db/docs/api_cxx/mutex_set_max.html new file mode 100644 index 000000000..c65040152 --- /dev/null +++ b/db/docs/api_cxx/mutex_set_max.html @@ -0,0 +1,167 @@ +<!--$Id: mutex_set_max.so,v 10.3 2005/08/03 21:24:59 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_set_max</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_set_max</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_set_increment(u_int32_t increment); +<p> +int +DbEnv::mutex_get_increment(u_int32_t *incrementp); +int +DbEnv::mutex_set_max(u_int32_t max); +<p> +int +DbEnv::mutex_get_max(u_int32_t *maxp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_set_max</h3> +<p>Configure the total number of mutexes to allocate.</p> +<p>Berkeley DB allocates a default number of mutexes based on the initial +configuration of the database environment. That default calculation may +be too small if the application has an unusual need for mutexes (for +example, if the application opens an unexpectedly large number of +databases) or too large (if the application is trying to minimize its +memory footprint). The DbEnv::mutex_set_max method is used to specify an +absolute number of mutexes to allocate.</p> +<p>Calling the DbEnv::mutex_set_max method discards any value previously +set using the DbEnv::mutex_set_increment method.</p> +<p>The database environment's total number of mutexes may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "mutex_set_max", one or more whitespace +characters, and the total number of mutexes. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::mutex_set_max method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::mutex_set_max method may not be called after the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is +called. +If the database environment already exists when +<a href="../api_cxx/env_open.html">DbEnv::open</a> is called, the information specified to DbEnv::mutex_set_max +will be ignored. +</p> +<p>The DbEnv::mutex_set_max 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>max</b><dd>The <b>max</b> parameter is the absolute number of mutexes to +allocate. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_set_max method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_get_max</h3> +<p>The DbEnv::mutex_get_max method returns the total number of mutexes allocated.</p> +<p>The DbEnv::mutex_get_max method may be called at any time during the life of the +application.</p> +<p>The DbEnv::mutex_get_max 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>maxp</b><dd>The DbEnv::mutex_get_max method returns the +total number of mutexes allocated in <b>maxp</b>. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_set_increment</h3> +<p>Configure the number of additional mutexes to allocate.</p> +<p>Additionally, an application may want to allocate mutexes for its own +use. The DbEnv::mutex_set_increment method is used to add a number of +mutexes to the default allocation.</p> +<p>Calling the DbEnv::mutex_set_increment method discards any value previously +set using the DbEnv::mutex_set_max method.</p> +<p>The database environment's number of additional mutexes may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "mutex_set_increment", one or more whitespace +characters, and the number of additional mutexes. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::mutex_set_increment method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::mutex_set_increment method may not be called after the <a href="../api_cxx/env_open.html">DbEnv::open</a> method is +called. +If the database environment already exists when +<a href="../api_cxx/env_open.html">DbEnv::open</a> is called, the information specified to DbEnv::mutex_set_increment +will be ignored. +</p> +<p>The DbEnv::mutex_set_increment 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>increment</b><dd>The <b>increment</b> parameter is the number of additional mutexes to +allocate. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_set_increment method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_get_increment</h3> +<p>The DbEnv::mutex_get_increment method returns the number of additional mutexes to allocate.</p> +<p>The DbEnv::mutex_get_increment method may be called at any time during the life of the +application.</p> +<p>The DbEnv::mutex_get_increment 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>incrementp</b><dd>The DbEnv::mutex_get_increment method returns the +number of additional mutexes to allocate in <b>incrementp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_set_tas_spins.html b/db/docs/api_cxx/mutex_set_tas_spins.html new file mode 100644 index 000000000..b8f688d87 --- /dev/null +++ b/db/docs/api_cxx/mutex_set_tas_spins.html @@ -0,0 +1,94 @@ +<!--$Id: mutex_set_tas_spins.so,v 10.30 2005/07/20 16:34:01 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_set_tas_spins</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_set_tas_spins</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_set_tas_spins(u_int32_t tas_spins); +<p> +int +DbEnv::mutex_get_tas_spins(u_int32_t *, tas_spinsp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_set_tas_spins</h3> +<p>Specify that test-and-set mutexes should spin <b>tas_spins</b> times +without blocking. The value defaults to 1 on uniprocessor systems and +to 50 times the number of processors on multiprocessor systems.</p> +<p>The database environment's test-and-set spin count may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "set_tas_spins", one or more whitespace +characters, and the number of spins. +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::mutex_set_tas_spins method configures operations performed using the specified +<a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying +database environment.</p> +<p>The DbEnv::mutex_set_tas_spins method may be called at any time during the life of the +application.</p> +<p>The DbEnv::mutex_set_tas_spins 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>tas_spins</b><dd>The <b>tas_spins</b> parameter is the number of spins test-and-set +mutexes should execute before blocking. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_set_tas_spins method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_get_tas_spins</h3> +<p>The DbEnv::mutex_get_tas_spins method returns the test-and-set spin count.</p> +<p>The DbEnv::mutex_get_tas_spins method may be called at any time during the life of the +application.</p> +<p>The DbEnv::mutex_get_tas_spins 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>tas_spinsp</b><dd>The DbEnv::mutex_get_tas_spins method returns the +test-and-set spin count in <b>tas_spinsp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_stat.html b/db/docs/api_cxx/mutex_stat.html new file mode 100644 index 000000000..ca82a24f0 --- /dev/null +++ b/db/docs/api_cxx/mutex_stat.html @@ -0,0 +1,118 @@ +<!--$Id: mutex_stat.so,v 10.2 2005/11/08 11:43:55 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_stat</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_stat</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_stat(DB_MUTEX_STAT **statp, u_int32_t flags); +<p> +int +DbEnv::mutex_stat_print(u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_stat</h3> +<p>The DbEnv::mutex_stat method returns the mutex subsystem statistics.</p> +<p>The DbEnv::mutex_stat method creates a statistical structure of type +DB_MUTEX_STAT and copies a pointer to it into a user-specified memory +location.</p> +<p>Statistical structures are stored in allocated memory. If application-specific allocation +routines have been declared (see <a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a> for more +information), they are used to allocate the memory; otherwise, the +standard C library <b>malloc</b>(3) is used. The caller is +responsible for deallocating the memory. To deallocate the memory, free +the memory reference; references inside the returned memory need not be +individually freed.</p> +<p>The following DB_MUTEX_STAT fields will be filled in:</p> +<dl compact> +<dt>u_int32_t st_mutex_align;<dd>The mutex alignment, in bytes. +<dt>u_int32_t st_mutex_tas_spins;<dd>The number of times test-and-set mutexes will spin without blocking. +<dt>int st_mutex_cnt;<dd>The total number of mutexes configured. +<dt>u_int32_t st_mutex_free;<dd>The number of mutexes currently available. +<dt>u_int32_t st_mutex_inuse;<dd>The number of mutexes currently in use. +<dt>u_int32_t st_mutex_inuse_max;<dd>The maximum number of mutexes ever in use. +<dt>roff_t st_regsize;<dd>The size of the mutex region, in bytes. +<dt>u_int32_t st_region_wait;<dd>The number of times that a thread of control was forced to wait before +obtaining the mutex region mutex. +<dt>u_int32_t st_region_nowait;<dd>The number of times that a thread of control was able to obtain +the mutex region mutex without waiting. +</dl> +<p>The DbEnv::mutex_stat 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or +the following value: +<dl compact> +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. +</dl> +<dt><b>statp</b><dd>The <b>statp</b> parameter references memory into which +a pointer to the allocated statistics structure is copied. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_stat method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_stat_print</h3> +<p>The DbEnv::mutex_stat_print method displays the +mutex subsystem statistical information, as described for the DbEnv::mutex_stat method. +The information is printed to a specified output channel (see the +<a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an +application callback function (see the <a href="../api_cxx/env_set_msgcall.html">DbEnv::set_msgcall</a> method for +more information).</p> +<p>The DbEnv::mutex_stat_print method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::mutex_stat_print 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: +<dl compact> +<dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. +</dl> +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/mutex_unlock.html b/db/docs/api_cxx/mutex_unlock.html new file mode 100644 index 000000000..8c2244199 --- /dev/null +++ b/db/docs/api_cxx/mutex_unlock.html @@ -0,0 +1,65 @@ +<!--$Id: mutex_unlock.so,v 10.1 2005/07/20 16:34:02 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::mutex_unlock</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::mutex_unlock</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::mutex_unlock(db_mutex_t mutex); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::mutex_unlock</h3> +<p>The DbEnv::mutex_unlock method unlocks the mutex locked by +<a href="../api_cxx/mutex_lock.html">DbEnv::mutex_lock</a>.</p> +<p>The DbEnv::mutex_unlock method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::mutex_unlock 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>mutex</b><dd>The <b>mutex</b> parameter is a mutex previously locked by +<a href="../api_cxx/mutex_lock.html">DbEnv::mutex_lock</a>. +</dl> +<h3>Errors</h3> +<p>The DbEnv::mutex_unlock method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/env_list.html">Database Environments and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/object.html b/db/docs/api_cxx/object.html index 998189610..e1b081b0d 100644 --- a/db/docs/api_cxx/object.html +++ b/db/docs/api_cxx/object.html @@ -1,4 +1,4 @@ -<!--$Id: object.so,v 10.14 2004/11/04 21:28:28 bostic Exp $--> +<!--$Id: object.so,v 10.18 2005/09/13 19:23:43 gmf Exp $--> <html> <head> <title>Berkeley DB API</title> @@ -24,6 +24,7 @@ href="../api_cxx/cxx_pindex.html" <a target="method" href="lock_list.html">Locking</a><br> <a target="method" href="log_list.html">Logging</a><br> <a target="method" href="memp_list.html">Memory Pool</a><br> +<a target="method" href="mutex_list.html">Mutexes</a><br> <a target="method" href="rep_list.html">Replication</a><br> <a target="method" href="seq_list.html">Sequences</a><br> <a target="method" href="txn_list.html">Transactions</a><br> diff --git a/db/docs/api_cxx/pindex.src b/db/docs/api_cxx/pindex.src index ceb1c9f0a..1f012c39e 100644 --- a/db/docs/api_cxx/pindex.src +++ b/db/docs/api_cxx/pindex.src @@ -1,33 +1,35 @@ __APIREL__/api_cxx/db_associate.html__OCT__2 @DB_DBT_APPMALLOC __APIREL__/api_cxx/db_associate.html__OCT__3 @DB_DONOTINDEX __APIREL__/api_cxx/db_associate.html__OCT__DB_CREATE Db::associate@DB_CREATE -__APIREL__/api_cxx/db_associate.html__OCT__DB_AUTO_COMMIT Db::associate@DB_AUTO_COMMIT +__APIREL__/api_cxx/db_associate.html__OCT__DB_IMMUTABLE_KEY Db::associate@DB_IMMUTABLE_KEY __APIREL__/api_cxx/db_class.html__OCT__DB_CXX_NO_EXCEPTIONS Db@DB_CXX_NO_EXCEPTIONS __APIREL__/api_cxx/db_class.html__OCT__DB_XA_CREATE Db@DB_XA_CREATE __APIREL__/api_cxx/db_close.html__OCT__DB_NOSYNC Db::close@DB_NOSYNC -__APIREL__/api_cxx/db_cursor.html__OCT__DB_DEGREE_2 Db::cursor@DB_DEGREE_2 -__APIREL__/api_cxx/db_cursor.html__OCT__DB_DIRTY_READ Db::cursor@DB_DIRTY_READ +__APIREL__/api_cxx/db_compact.html__OCT__DB_FREELIST_ONLY Db::compact@DB_FREELIST_ONLY +__APIREL__/api_cxx/db_compact.html__OCT__DB_FREE_SPACE Db::compact@DB_FREE_SPACE +__APIREL__/api_cxx/db_cursor.html__OCT__DB_READ_COMMITTED Db::cursor@DB_READ_COMMITTED +__APIREL__/api_cxx/db_cursor.html__OCT__DB_READ_UNCOMMITTED Db::cursor@DB_READ_UNCOMMITTED __APIREL__/api_cxx/db_cursor.html__OCT__DB_WRITECURSOR Db::cursor@DB_WRITECURSOR -__APIREL__/api_cxx/db_del.html__OCT__DB_AUTO_COMMIT Db::del@DB_AUTO_COMMIT +__APIREL__/api_cxx/db_cursor.html__OCT__DB_TXN_SNAPSHOT Db::cursor@DB_TXN_SNAPSHOT __APIREL__/api_cxx/db_get.html__OCT__DB_CONSUME Db::get@DB_CONSUME __APIREL__/api_cxx/db_get.html__OCT__DB_CONSUME_WAIT Db::get@DB_CONSUME_WAIT __APIREL__/api_cxx/db_get.html__OCT__DB_GET_BOTH Db::get@DB_GET_BOTH __APIREL__/api_cxx/db_get.html__OCT__DB_SET_RECNO Db::get@DB_SET_RECNO -__APIREL__/api_cxx/db_get.html__OCT__DB_AUTO_COMMIT Db::get@DB_AUTO_COMMIT -__APIREL__/api_cxx/db_get.html__OCT__DB_DEGREE_2 Db::get@DB_DEGREE_2 -__APIREL__/api_cxx/db_get.html__OCT__DB_DIRTY_READ Db::get@DB_DIRTY_READ __APIREL__/api_cxx/db_get.html__OCT__DB_MULTIPLE Db::get@DB_MULTIPLE +__APIREL__/api_cxx/db_get.html__OCT__DB_READ_COMMITTED Db::get@DB_READ_COMMITTED +__APIREL__/api_cxx/db_get.html__OCT__DB_READ_UNCOMMITTED Db::get@DB_READ_UNCOMMITTED __APIREL__/api_cxx/db_get.html__OCT__DB_RMW Db::get@DB_RMW __APIREL__/api_cxx/db_join.html__OCT__DB_JOIN_ITEM Db::join@DB_JOIN_ITEM -__APIREL__/api_cxx/db_join.html__OCT__DB_DIRTY_READ Db::join@DB_DIRTY_READ +__APIREL__/api_cxx/db_join.html__OCT__DB_READ_UNCOMMITTED Db::join@DB_READ_UNCOMMITTED __APIREL__/api_cxx/db_join.html__OCT__DB_RMW Db::join@DB_RMW __APIREL__/api_cxx/db_join.html__OCT__DB_JOIN_NOSORT Db::join@DB_JOIN_NOSORT __APIREL__/api_cxx/db_open.html__OCT__DB_AUTO_COMMIT Db::open@DB_AUTO_COMMIT __APIREL__/api_cxx/db_open.html__OCT__DB_CREATE Db::open@DB_CREATE -__APIREL__/api_cxx/db_open.html__OCT__DB_DIRTY_READ Db::open@DB_DIRTY_READ __APIREL__/api_cxx/db_open.html__OCT__DB_EXCL Db::open@DB_EXCL +__APIREL__/api_cxx/db_open.html__OCT__DB_MULTIVERSION Db::open@DB_MULTIVERSION __APIREL__/api_cxx/db_open.html__OCT__DB_NOMMAP Db::open@DB_NOMMAP __APIREL__/api_cxx/db_open.html__OCT__DB_RDONLY Db::open@DB_RDONLY +__APIREL__/api_cxx/db_open.html__OCT__DB_READ_UNCOMMITTED Db::open@DB_READ_UNCOMMITTED __APIREL__/api_cxx/db_open.html__OCT__DB_THREAD Db::open@DB_THREAD __APIREL__/api_cxx/db_open.html__OCT__DB_TRUNCATE Db::open@DB_TRUNCATE __APIREL__/api_cxx/db_open.html__OCT__DB_BTREE Db::open@DB_BTREE @@ -38,7 +40,8 @@ __APIREL__/api_cxx/db_open.html__OCT__DB_UNKNOWN Db::open@DB_UNKNOWN __APIREL__/api_cxx/db_put.html__OCT__DB_APPEND Db::put@DB_APPEND __APIREL__/api_cxx/db_put.html__OCT__DB_NODUPDATA Db::put@DB_NODUPDATA __APIREL__/api_cxx/db_put.html__OCT__DB_NOOVERWRITE Db::put@DB_NOOVERWRITE -__APIREL__/api_cxx/db_put.html__OCT__DB_AUTO_COMMIT Db::put@DB_AUTO_COMMIT +__APIREL__/api_cxx/db_put.html__OCT__2 @DB_REP_HANDLE_DEAD +__APIREL__/api_cxx/db_put.html__OCT__3 @DB_REP_LOCKOUT __APIREL__/api_cxx/db_set_encrypt.html__OCT__DB_ENCRYPT_AES Db::set_encrypt@DB_ENCRYPT_AES __APIREL__/api_cxx/db_set_feedback.html__OCT__DB_UPGRADE Db::set_feedback@DB_UPGRADE __APIREL__/api_cxx/db_set_feedback.html__OCT__DB_VERIFY Db::set_feedback@DB_VERIFY @@ -65,11 +68,12 @@ __APIREL__/api_cxx/db_set_flags.html__OCT__11 @renumbering records in Recno data __APIREL__/api_cxx/db_set_flags.html__OCT__DB_RENUMBER Db::set_flags@DB_RENUMBER __APIREL__/api_cxx/db_set_flags.html__OCT__12 pre-loading @text files into Recno databases __APIREL__/api_cxx/db_set_flags.html__OCT__DB_SNAPSHOT Db::set_flags@DB_SNAPSHOT -__APIREL__/api_cxx/db_stat.html__OCT__DB_DEGREE_2 Db::stat@DB_DEGREE_2 -__APIREL__/api_cxx/db_stat.html__OCT__DB_DIRTY_READ Db::stat@DB_DIRTY_READ +__APIREL__/api_cxx/db_stat.html__OCT__DB_FAST_STAT Db::stat@DB_FAST_STAT +__APIREL__/api_cxx/db_stat.html__OCT__DB_READ_COMMITTED Db::stat@DB_READ_COMMITTED +__APIREL__/api_cxx/db_stat.html__OCT__DB_READ_UNCOMMITTED Db::stat@DB_READ_UNCOMMITTED __APIREL__/api_cxx/db_stat.html__OCT__DB_FAST_STAT Db::stat@DB_FAST_STAT __APIREL__/api_cxx/db_stat.html__OCT__DB_STAT_ALL Db::stat@DB_STAT_ALL -__APIREL__/api_cxx/db_truncate.html__OCT__DB_AUTO_COMMIT Db::truncate@DB_AUTO_COMMIT +__APIREL__/api_cxx/db_stat.html__OCT__DB_STAT_CLEAR Db::stat@DB_STAT_CLEAR __APIREL__/api_cxx/db_upgrade.html__OCT__DB_DUPSORT Db::upgrade@DB_DUPSORT __APIREL__/api_cxx/db_upgrade.html__OCT__DB_OLD_VERSION Db::upgrade@DB_OLD_VERSION __APIREL__/api_cxx/db_verify.html__OCT__2 @DB_VERIFY_BAD @@ -100,7 +104,7 @@ __APIREL__/api_cxx/dbc_get.html__OCT__DB_PREV_NODUP Dbc::get@DB_PREV_NODUP __APIREL__/api_cxx/dbc_get.html__OCT__DB_SET Dbc::get@DB_SET __APIREL__/api_cxx/dbc_get.html__OCT__DB_SET_RANGE Dbc::get@DB_SET_RANGE __APIREL__/api_cxx/dbc_get.html__OCT__DB_SET_RECNO Dbc::get@DB_SET_RECNO -__APIREL__/api_cxx/dbc_get.html__OCT__DB_DIRTY_READ Dbc::get@DB_DIRTY_READ +__APIREL__/api_cxx/dbc_get.html__OCT__DB_READ_UNCOMMITTED Dbc::get@DB_READ_UNCOMMITTED __APIREL__/api_cxx/dbc_get.html__OCT__DB_MULTIPLE Dbc::get@DB_MULTIPLE __APIREL__/api_cxx/dbc_get.html__OCT__DB_MULTIPLE_KEY Dbc::get@DB_MULTIPLE_KEY __APIREL__/api_cxx/dbc_get.html__OCT__DB_RMW Dbc::get@DB_RMW @@ -114,7 +118,12 @@ __APIREL__/api_cxx/env_class.html__OCT__DB_CXX_NO_EXCEPTIONS DbEnv@DB_CXX_NO_EXC __APIREL__/api_cxx/env_class.html__OCT__DB_RPCCLIENT DbEnv@DB_RPCCLIENT __APIREL__/api_cxx/env_dbremove.html__OCT__DB_AUTO_COMMIT DbEnv::dbremove@DB_AUTO_COMMIT __APIREL__/api_cxx/env_dbrename.html__OCT__DB_AUTO_COMMIT DbEnv::dbrename@DB_AUTO_COMMIT -__APIREL__/api_cxx/env_open.html__OCT__DB_JOINENV DbEnv::open@DB_JOINENV +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_PANIC DbEnv::set_event_notify@DB_EVENT_PANIC +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_REP_CLIENT DbEnv::set_event_notify@DB_EVENT_REP_CLIENT +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_REP_MASTER DbEnv::set_event_notify@DB_EVENT_REP_MASTER +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_REP_NEWMASTER DbEnv::set_event_notify@DB_EVENT_REP_NEWMASTER +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_REP_STARTUPDONE DbEnv::set_event_notify@DB_EVENT_REP_STARTUPDONE +__APIREL__/api_cxx/env_event_notify.html__OCT__DB_EVENT_WRITE_FAILED DbEnv::set_event_notify@DB_EVENT_WRITE_FAILED __APIREL__/api_cxx/env_open.html__OCT__DB_INIT_CDB DbEnv::open@DB_INIT_CDB __APIREL__/api_cxx/env_open.html__OCT__DB_INIT_LOCK DbEnv::open@DB_INIT_LOCK __APIREL__/api_cxx/env_open.html__OCT__DB_INIT_LOG DbEnv::open@DB_INIT_LOG @@ -129,6 +138,7 @@ __APIREL__/api_cxx/env_open.html__OCT__DB_USE_ENVIRON_ROOT DbEnv::open@DB_USE_EN __APIREL__/api_cxx/env_open.html__OCT__DB_CREATE DbEnv::open@DB_CREATE __APIREL__/api_cxx/env_open.html__OCT__DB_LOCKDOWN DbEnv::open@DB_LOCKDOWN __APIREL__/api_cxx/env_open.html__OCT__DB_PRIVATE DbEnv::open@DB_PRIVATE +__APIREL__/api_cxx/env_open.html__OCT__DB_REGISTER DbEnv::open@DB_REGISTER __APIREL__/api_cxx/env_open.html__OCT__DB_SYSTEM_MEM DbEnv::open@DB_SYSTEM_MEM __APIREL__/api_cxx/env_open.html__OCT__DB_THREAD DbEnv::open@DB_THREAD __APIREL__/api_cxx/env_open.html__OCT__3 @DB_VERSION_MISMATCH @@ -150,36 +160,42 @@ __APIREL__/api_cxx/env_set_flags.html__OCT__3 turn off system @buffering for dat __APIREL__/api_cxx/env_set_flags.html__OCT__DB_DIRECT_DB DbEnv::set_flags@DB_DIRECT_DB __APIREL__/api_cxx/env_set_flags.html__OCT__4 turn off system @buffering for log files __APIREL__/api_cxx/env_set_flags.html__OCT__DB_DIRECT_LOG DbEnv::set_flags@DB_DIRECT_LOG -__APIREL__/api_cxx/env_set_flags.html__OCT__5 turn off system @buffering for log files +__APIREL__/api_cxx/env_set_flags.html__OCT__5 turn off system @buffering for database files +__APIREL__/api_cxx/env_set_flags.html__OCT__DB_DSYNC_DB DbEnv::set_flags@DB_DSYNC_DB +__APIREL__/api_cxx/env_set_flags.html__OCT__6 turn off system @buffering for log files __APIREL__/api_cxx/env_set_flags.html__OCT__DB_DSYNC_LOG DbEnv::set_flags@DB_DSYNC_LOG -__APIREL__/api_cxx/env_set_flags.html__OCT__6 automatic @log file removal +__APIREL__/api_cxx/env_set_flags.html__OCT__7 automatic @log file removal __APIREL__/api_cxx/env_set_flags.html__OCT__DB_LOG_AUTOREMOVE DbEnv::set_flags@DB_LOG_AUTOREMOVE -__APIREL__/api_cxx/env_set_flags.html__OCT__7 in memory @logs +__APIREL__/api_cxx/env_set_flags.html__OCT__8 in memory @logs __APIREL__/api_cxx/env_set_flags.html__OCT__DB_LOG_INMEMORY DbEnv::set_flags@DB_LOG_INMEMORY __APIREL__/api_cxx/env_set_flags.html__OCT__DB_LOG_BUFFER_FULL DbEnv::set_flags@DB_LOG_BUFFER_FULL -__APIREL__/api_cxx/env_set_flags.html__OCT__8 ignore @locking +__APIREL__/api_cxx/env_set_flags.html__OCT__9 ignore @locking __APIREL__/api_cxx/env_set_flags.html__OCT__DB_NOLOCKING DbEnv::set_flags@DB_NOLOCKING -__APIREL__/api_cxx/env_set_flags.html__OCT__9 turn off database file @memory mapping +__APIREL__/api_cxx/env_set_flags.html__OCT__DB_MULTIVERSION DbEnv::set_flags@DB_MULTIVERSION +__APIREL__/api_cxx/env_set_flags.html__OCT__10 turn off database file @memory mapping __APIREL__/api_cxx/env_set_flags.html__OCT__DB_NOMMAP DbEnv::set_flags@DB_NOMMAP -__APIREL__/api_cxx/env_set_flags.html__OCT__10 ignore database environment @panic +__APIREL__/api_cxx/env_set_flags.html__OCT__11 ignore database environment @panic __APIREL__/api_cxx/env_set_flags.html__OCT__DB_NOPANIC DbEnv::set_flags@DB_NOPANIC __APIREL__/api_cxx/env_set_flags.html__OCT__DB_OVERWRITE DbEnv::set_flags@DB_OVERWRITE -__APIREL__/api_cxx/env_set_flags.html__OCT__11 turn off access to a database @environment +__APIREL__/api_cxx/env_set_flags.html__OCT__12 turn off access to a database @environment __APIREL__/api_cxx/env_set_flags.html__OCT__DB_PANIC_ENVIRONMENT DbEnv::set_flags@DB_PANIC_ENVIRONMENT -__APIREL__/api_cxx/env_set_flags.html__OCT__12 fault database @environment in during open +__APIREL__/api_cxx/env_set_flags.html__OCT__13 fault database @environment in during open __APIREL__/api_cxx/env_set_flags.html__OCT__DB_REGION_INIT DbEnv::set_flags@DB_REGION_INIT __APIREL__/api_cxx/env_set_flags.html__OCT__DB_TIME_NOTGRANTED DbEnv::set_flags@DB_TIME_NOTGRANTED -__APIREL__/api_cxx/env_set_flags.html__OCT__13 turn off synchronous @transaction commit -__APIREL__/api_cxx/env_set_flags.html__OCT__DB_TXN_NOSYNC DbEnv::set_flags@DB_TXN_NOSYNC __APIREL__/api_cxx/env_set_flags.html__OCT__14 turn off synchronous @transaction commit +__APIREL__/api_cxx/env_set_flags.html__OCT__DB_TXN_NOSYNC DbEnv::set_flags@DB_TXN_NOSYNC +__APIREL__/api_cxx/env_set_flags.html__OCT__DB_TXN_SNAPSHOT DbEnv::set_flags@DB_TXN_SNAPSHOT +__APIREL__/api_cxx/env_set_flags.html__OCT__15 turn off synchronous @transaction commit __APIREL__/api_cxx/env_set_flags.html__OCT__DB_TXN_WRITE_NOSYNC DbEnv::set_flags@DB_TXN_WRITE_NOSYNC -__APIREL__/api_cxx/env_set_flags.html__OCT__15 configure for @stress testing +__APIREL__/api_cxx/env_set_flags.html__OCT__16 configure for @stress testing __APIREL__/api_cxx/env_set_flags.html__OCT__DB_YIELDCPU DbEnv::set_flags@DB_YIELDCPU +__APIREL__/api_cxx/env_set_isalive.html__OCT__DB_MUTEX_PROCESS_ONLY DbEnv::set_isalive@DB_MUTEX_PROCESS_ONLY __APIREL__/api_cxx/env_set_rpc_server.html__OCT__DB_NOSERVER DbEnv::set_rpc_server@DB_NOSERVER __APIREL__/api_cxx/env_set_rpc_server.html__OCT__DB_NOSERVER_ID DbEnv::set_rpc_server@DB_NOSERVER_ID __APIREL__/api_cxx/env_set_rpc_server.html__OCT__DB_NOSERVER_HOME DbEnv::set_rpc_server@DB_NOSERVER_HOME __APIREL__/api_cxx/env_set_rpc_server.html__OCT__2 @DB_NOSERVER __APIREL__/api_cxx/env_set_rpc_server.html__OCT__3 @DB_NOSERVER_ID +__APIREL__/api_cxx/env_set_thread_id_string.html__OCT__2 @DB_NOSERVER __APIREL__/api_cxx/env_set_timeout.html__OCT__DB_SET_LOCK_TIMEOUT DbEnv::set_timeout@DB_SET_LOCK_TIMEOUT __APIREL__/api_cxx/env_set_timeout.html__OCT__DB_SET_TXN_TIMEOUT DbEnv::set_timeout@DB_SET_TXN_TIMEOUT __APIREL__/api_cxx/env_set_timeout.html__OCT__DB_SET_LOCK_TIMEOUT DbEnv::set_timeout@DB_SET_LOCK_TIMEOUT @@ -187,9 +203,11 @@ __APIREL__/api_cxx/env_set_timeout.html__OCT__DB_SET_TXN_TIMEOUT DbEnv::set_time __APIREL__/api_cxx/env_set_tmp_dir.html__OCT__2 @temporary files __APIREL__/api_cxx/env_set_verbose.html__OCT__DB_VERB_DEADLOCK DbEnv::set_verbose@DB_VERB_DEADLOCK __APIREL__/api_cxx/env_set_verbose.html__OCT__DB_VERB_RECOVERY DbEnv::set_verbose@DB_VERB_RECOVERY +__APIREL__/api_cxx/env_set_verbose.html__OCT__DB_VERB_REGISTER DbEnv::set_verbose@DB_VERB_REGISTER __APIREL__/api_cxx/env_set_verbose.html__OCT__DB_VERB_REPLICATION DbEnv::set_verbose@DB_VERB_REPLICATION __APIREL__/api_cxx/env_set_verbose.html__OCT__DB_VERB_WAITSFOR DbEnv::set_verbose@DB_VERB_WAITSFOR __APIREL__/api_cxx/env_stat.html__OCT__DB_STAT_ALL DbEnv::stat_print@DB_STAT_ALL +__APIREL__/api_cxx/env_stat.html__OCT__DB_STAT_CLEAR DbEnv::stat_print@DB_STAT_CLEAR __APIREL__/api_cxx/env_stat.html__OCT__DB_STAT_SUBSYSTEM DbEnv::stat_print@DB_STAT_SUBSYSTEM __APIREL__/api_cxx/env_set_lk_detect.html__OCT__DB_LOCK_DEFAULT DbEnv::set_lk_detect@DB_LOCK_DEFAULT __APIREL__/api_cxx/env_set_lk_detect.html__OCT__DB_LOCK_EXPIRE DbEnv::set_lk_detect@DB_LOCK_EXPIRE @@ -239,6 +257,7 @@ __APIREL__/api_cxx/log_archive.html__OCT__DB_ARCH_REMOVE DbEnv::log_archive@DB_A __APIREL__/api_cxx/log_put.html__OCT__DB_FLUSH DbEnv::log_put@DB_FLUSH __APIREL__/api_cxx/log_stat.html__OCT__DB_STAT_CLEAR DbEnv::log_stat@DB_STAT_CLEAR __APIREL__/api_cxx/log_stat.html__OCT__DB_STAT_ALL DbEnv::log_stat@DB_STAT_ALL +__APIREL__/api_cxx/log_stat.html__OCT__DB_STAT_CLEAR DbEnv::log_stat@DB_STAT_CLEAR __APIREL__/api_cxx/logc_get.html__OCT__DB_CURRENT DbLogc::get@DB_CURRENT __APIREL__/api_cxx/logc_get.html__OCT__DB_FIRST DbLogc::get@DB_FIRST __APIREL__/api_cxx/logc_get.html__OCT__DB_LAST DbLogc::get@DB_LAST @@ -247,19 +266,18 @@ __APIREL__/api_cxx/logc_get.html__OCT__DB_PREV DbLogc::get@DB_PREV __APIREL__/api_cxx/logc_get.html__OCT__DB_SET DbLogc::get@DB_SET __APIREL__/api_cxx/memp_fget.html__OCT__2 @DB_PAGE_NOTFOUND __APIREL__/api_cxx/memp_fget.html__OCT__DB_MPOOL_CREATE DbMpoolFile::get@DB_MPOOL_CREATE +__APIREL__/api_cxx/memp_fget.html__OCT__DB_MPOOL_DIRTY DbMpoolFile::get@DB_MPOOL_DIRTY +__APIREL__/api_cxx/memp_fget.html__OCT__DB_MPOOL_EDIT DbMpoolFile::get@DB_MPOOL_EDIT __APIREL__/api_cxx/memp_fget.html__OCT__DB_MPOOL_LAST DbMpoolFile::get@DB_MPOOL_LAST __APIREL__/api_cxx/memp_fget.html__OCT__DB_MPOOL_NEW DbMpoolFile::get@DB_MPOOL_NEW __APIREL__/api_cxx/memp_fopen.html__OCT__DB_CREATE DbMpoolFile::open@DB_CREATE __APIREL__/api_cxx/memp_fopen.html__OCT__2 turn off system @buffering __APIREL__/api_cxx/memp_fopen.html__OCT__DB_DIRECT DbMpoolFile::open@DB_DIRECT +__APIREL__/api_cxx/memp_fopen.html__OCT__DB_MULTIVERSION DbMpoolFile::open@DB_MULTIVERSION __APIREL__/api_cxx/memp_fopen.html__OCT__DB_NOMMAP DbMpoolFile::open@DB_NOMMAP __APIREL__/api_cxx/memp_fopen.html__OCT__DB_ODDFILESIZE DbMpoolFile::open@DB_ODDFILESIZE __APIREL__/api_cxx/memp_fopen.html__OCT__DB_RDONLY DbMpoolFile::open@DB_RDONLY -__APIREL__/api_cxx/memp_fput.html__OCT__DB_MPOOL_CLEAN DbMpoolFile::put@DB_MPOOL_CLEAN -__APIREL__/api_cxx/memp_fput.html__OCT__DB_MPOOL_DIRTY DbMpoolFile::put@DB_MPOOL_DIRTY __APIREL__/api_cxx/memp_fput.html__OCT__DB_MPOOL_DISCARD DbMpoolFile::put@DB_MPOOL_DISCARD -__APIREL__/api_cxx/memp_fset.html__OCT__DB_MPOOL_CLEAN DbMpoolFile::set@DB_MPOOL_CLEAN -__APIREL__/api_cxx/memp_fset.html__OCT__DB_MPOOL_DIRTY DbMpoolFile::set@DB_MPOOL_DIRTY __APIREL__/api_cxx/memp_fset.html__OCT__DB_MPOOL_DISCARD DbMpoolFile::set@DB_MPOOL_DISCARD __APIREL__/api_cxx/memp_set_flags.html__OCT__DB_MPOOL_NOFILE DbMpoolFile::set_flags@DB_MPOOL_NOFILE __APIREL__/api_cxx/memp_set_flags.html__OCT__DB_MPOOL_UNLINK DbMpoolFile::set_flags@DB_MPOOL_UNLINK @@ -273,38 +291,68 @@ __APIREL__/api_cxx/memp_stat.html__OCT__DB_STAT_CLEAR DbEnv::memp_stat@DB_STAT_C __APIREL__/api_cxx/memp_stat.html__OCT__DB_STAT_ALL DbEnv::memp_stat@DB_STAT_ALL __APIREL__/api_cxx/memp_stat.html__OCT__DB_STAT_MEMP_HASH DbEnv::memp_stat@DB_STAT_MEMP_HASH __APIREL__/api_cxx/memp_class.html__OCT__DB_BUFFER_SMALL DbMemoryException@DB_BUFFER_SMALL +__APIREL__/api_cxx/mutex_alloc.html__OCT__DB_MUTEX_PROCESS_ONLY DbEnv::mutex_alloc@DB_MUTEX_PROCESS_ONLY +__APIREL__/api_cxx/mutex_alloc.html__OCT__DB_MUTEX_SELF_BLOCK DbEnv::mutex_alloc@DB_MUTEX_SELF_BLOCK +__APIREL__/api_cxx/mutex_stat.html__OCT__DB_STAT_CLEAR DbEnv::mutex_stat@DB_STAT_CLEAR +__APIREL__/api_cxx/mutex_stat.html__OCT__DB_STAT_ALL DbEnv::mutex_stat@DB_STAT_ALL +__APIREL__/api_cxx/mutex_stat.html__OCT__DB_STAT_CLEAR DbEnv::mutex_stat@DB_STAT_CLEAR +__APIREL__/api_cxx/rep_config.html__OCT__DB_REP_CONF_BULK DbEnv::rep_set_config@DB_REP_CONF_BULK +__APIREL__/api_cxx/rep_config.html__OCT__DB_REP_CONF_DELAYCLIENT DbEnv::rep_set_config@DB_REP_CONF_DELAYCLIENT +__APIREL__/api_cxx/rep_config.html__OCT__DB_REP_CONF_NOAUTOINIT DbEnv::rep_set_config@DB_REP_CONF_NOAUTOINIT +__APIREL__/api_cxx/rep_config.html__OCT__DB_REP_CONF_NOWAIT DbEnv::rep_set_config@DB_REP_CONF_NOWAIT __APIREL__/api_cxx/rep_elect.html__OCT__2 @DB_REP_UNAVAIL __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_DUPMASTER DbEnv::rep_process_message@DB_REP_DUPMASTER __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_HOLDELECTION DbEnv::rep_process_message@DB_REP_HOLDELECTION +__APIREL__/api_cxx/rep_message.html__OCT__DB_REP_IGNORE DbEnv::rep_process_message@DB_REP_IGNORE __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_ISPERM DbEnv::rep_process_message@DB_REP_ISPERM +__APIREL__/api_cxx/rep_message.html__OCT__DB_REP_JOIN_FAILURE DbEnv::rep_process_message@DB_REP_JOIN_FAILURE __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_NEWMASTER DbEnv::rep_process_message@DB_REP_NEWMASTER __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_NEWSITE DbEnv::rep_process_message@DB_REP_NEWSITE __APIREL__/api_cxx/rep_message.html__OCT__DB_REP_NOTPERM DbEnv::rep_process_message@DB_REP_NOTPERM -__APIREL__/api_cxx/rep_message.html__OCT__DB_REP_STARTUPDONE DbEnv::rep_process_message@DB_REP_STARTUPDONE __APIREL__/api_cxx/rep_start.html__OCT__DB_REP_CLIENT DbEnv::rep_start@DB_REP_CLIENT __APIREL__/api_cxx/rep_start.html__OCT__DB_REP_MASTER DbEnv::rep_start@DB_REP_MASTER __APIREL__/api_cxx/rep_stat.html__OCT__DB_STAT_CLEAR DbEnv::rep_stat@DB_STAT_CLEAR __APIREL__/api_cxx/rep_stat.html__OCT__DB_STAT_ALL DbEnv::rep_stat@DB_STAT_ALL +__APIREL__/api_cxx/rep_stat.html__OCT__DB_STAT_CLEAR DbEnv::rep_stat@DB_STAT_CLEAR +__APIREL__/api_cxx/rep_timeout.html__OCT__DB_REP_ACK_TIMEOUT DbEnv::rep_set_timeout@DB_REP_ACK_TIMEOUT +__APIREL__/api_cxx/rep_timeout.html__OCT__DB_REP_ELECTION_TIMEOUT DbEnv::rep_set_timeout@DB_REP_ELECTION_TIMEOUT +__APIREL__/api_cxx/rep_timeout.html__OCT__DB_REP_ELECTION_RETRY DbEnv::rep_set_timeout@DB_REP_ELECTION_RETRY +__APIREL__/api_cxx/rep_timeout.html__OCT__DB_REP_CONNECTION_RETRY DbEnv::rep_set_timeout@DB_REP_CONNECTION_RETRY __APIREL__/api_cxx/rep_transport.html__OCT__2 @DB_EID_BROADCAST -__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_NOBUFFER DbEnv::set_rep_transport@DB_REP_NOBUFFER -__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_PERMANENT DbEnv::set_rep_transport@DB_REP_PERMANENT -__APIREL__/api_cxx/seq_get.html__OCT__DB_AUTO_COMMIT DbSequence::get@DB_AUTO_COMMIT +__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_ANYWHERE DbEnv::rep_set_transport@DB_REP_ANYWHERE +__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_NOBUFFER DbEnv::rep_set_transport@DB_REP_NOBUFFER +__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_PERMANENT DbEnv::rep_set_transport@DB_REP_PERMANENT +__APIREL__/api_cxx/rep_transport.html__OCT__DB_REP_REREQUEST DbEnv::rep_set_transport@DB_REP_REREQUEST +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_ALL DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_ALL +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_ALL_PEERS DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_ALL_PEERS +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_NONE DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_NONE +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_ONE DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_ONE +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_ONE_PEER DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_ONE_PEER +__APIREL__/api_cxx/repmgr_ack_policy.html__OCT__DB_REPMGR_ACKS_QUORUM DbEnv::repmgr_set_ack_policy@DB_REPMGR_ACKS_QUORUM +__APIREL__/api_cxx/repmgr_remote_site.html__OCT__DB_REPMGR_PEER DbEnv::repmgr_add_remote_site@DB_REPMGR_PEER +__APIREL__/api_cxx/repmgr_site_list.html__OCT__DB_REPMGR_CONNECTED DbEnv::repmgr_site_list@DB_REPMGR_CONNECTED +__APIREL__/api_cxx/repmgr_site_list.html__OCT__DB_REPMGR_DISCONNECTED DbEnv::repmgr_site_list@DB_REPMGR_DISCONNECTED +__APIREL__/api_cxx/repmgr_start.html__OCT__DB_REP_MASTER DbEnv::repmgr_start@DB_REP_MASTER +__APIREL__/api_cxx/repmgr_start.html__OCT__DB_REP_CLIENT DbEnv::repmgr_start@DB_REP_CLIENT +__APIREL__/api_cxx/repmgr_start.html__OCT__DB_REP_ELECTION DbEnv::repmgr_start@DB_REP_ELECTION +__APIREL__/api_cxx/repmgr_start.html__OCT__DB_REP_FULL_ELECTION DbEnv::repmgr_start@DB_REP_FULL_ELECTION __APIREL__/api_cxx/seq_get.html__OCT__DB_TXN_NOSYNC DbSequence::get@DB_TXN_NOSYNC -__APIREL__/api_cxx/seq_open.html__OCT__DB_AUTO_COMMIT DbSequence::open@DB_AUTO_COMMIT __APIREL__/api_cxx/seq_open.html__OCT__DB_CREATE DbSequence::open@DB_CREATE __APIREL__/api_cxx/seq_open.html__OCT__DB_EXCL DbSequence::open@DB_EXCL __APIREL__/api_cxx/seq_open.html__OCT__DB_THREAD DbSequence::open@DB_THREAD +__APIREL__/api_cxx/seq_open.html__OCT__DB_THREAD DbSequence::open@DB_THREAD +__APIREL__/api_cxx/seq_remove.html__OCT__DB_TXN_NOSYNC DbSequence::remove@DB_TXN_NOSYNC __APIREL__/api_cxx/seq_set_flags.html__OCT__DB_SEQ_DEC DbSequence::set_flags@DB_SEQ_DEC __APIREL__/api_cxx/seq_set_flags.html__OCT__DB_SEQ_INC DbSequence::set_flags@DB_SEQ_INC __APIREL__/api_cxx/seq_set_flags.html__OCT__DB_SEQ_WRAP DbSequence::set_flags@DB_SEQ_WRAP __APIREL__/api_cxx/seq_stat.html__OCT__DB_STAT_CLEAR DbSequence::stat@DB_STAT_CLEAR __APIREL__/api_cxx/seq_stat.html__OCT__DB_STAT_CLEAR DbSequence::stat@DB_STAT_CLEAR -__APIREL__/api_cxx/seq_remove.html__OCT__DB_AUTO_COMMIT DbSequence::remove@DB_AUTO_COMMIT -__APIREL__/api_cxx/seq_remove.html__OCT__DB_TXN_NOSYNC DbSequence::remove@DB_TXN_NOSYNC -__APIREL__/api_cxx/txn_begin.html__OCT__DB_DEGREE_2 DbEnv::txn_begin@DB_DEGREE_2 -__APIREL__/api_cxx/txn_begin.html__OCT__DB_DIRTY_READ DbEnv::txn_begin@DB_DIRTY_READ +__APIREL__/api_cxx/txn_begin.html__OCT__DB_READ_COMMITTED DbEnv::txn_begin@DB_READ_COMMITTED +__APIREL__/api_cxx/txn_begin.html__OCT__DB_READ_UNCOMMITTED DbEnv::txn_begin@DB_READ_UNCOMMITTED __APIREL__/api_cxx/txn_begin.html__OCT__DB_TXN_NOSYNC DbEnv::txn_begin@DB_TXN_NOSYNC __APIREL__/api_cxx/txn_begin.html__OCT__DB_TXN_NOWAIT DbEnv::txn_begin@DB_TXN_NOWAIT +__APIREL__/api_cxx/txn_begin.html__OCT__DB_TXN_SNAPSHOT DbEnv::txn_begin@DB_TXN_SNAPSHOT +__APIREL__/api_cxx/txn_begin.html__OCT__DB_LOCK_DEADLOCK DbEnv::txn_begin@DB_LOCK_DEADLOCK __APIREL__/api_cxx/txn_begin.html__OCT__DB_TXN_SYNC DbEnv::txn_begin@DB_TXN_SYNC __APIREL__/api_cxx/txn_checkpoint.html__OCT__DB_FORCE DbEnv::txn_checkpoint@DB_FORCE __APIREL__/api_cxx/txn_commit.html__OCT__DB_TXN_NOSYNC DbTxn::commit@DB_TXN_NOSYNC @@ -316,3 +364,4 @@ __APIREL__/api_cxx/txn_set_timeout.html__OCT__DB_SET_LOCK_TIMEOUT DbTxn::set_tim __APIREL__/api_cxx/txn_set_timeout.html__OCT__DB_SET_TXN_TIMEOUT DbTxn::set_timeout@DB_SET_TXN_TIMEOUT __APIREL__/api_cxx/txn_stat.html__OCT__DB_STAT_CLEAR DbEnv::txn_stat@DB_STAT_CLEAR __APIREL__/api_cxx/txn_stat.html__OCT__DB_STAT_ALL DbEnv::txn_stat@DB_STAT_ALL +__APIREL__/api_cxx/txn_stat.html__OCT__DB_STAT_CLEAR DbEnv::txn_stat@DB_STAT_CLEAR diff --git a/db/docs/api_cxx/rep_config.html b/db/docs/api_cxx/rep_config.html new file mode 100644 index 000000000..ceaeb0d77 --- /dev/null +++ b/db/docs/api_cxx/rep_config.html @@ -0,0 +1,111 @@ +<!--$Id: rep_config.so,v 1.3 2006/07/14 23:08:59 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::rep_set_config</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::rep_set_config</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::rep_set_config(u_int32_t which, int onoff); +<p> +int +DbEnv::rep_get_config(u_int32_t which, int *onoffp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_set_config</h3> +<p>The DbEnv::rep_set_config method method configures the Berkeley DB replication +subsystem.</p> +<p>The database environment's replication subsystem may also be configured using the +environment's <b>DB_CONFIG</b> file. The syntax of the entry in that +file is a single line with the string "rep_set_config", one or more whitespace +characters, and the method <b>which</b> parameter as a string; for example, +"rep_set_config REP_CONF_NOWAIT". +Because the <b>DB_CONFIG</b> file is read when the database +environment is opened, it will silently overrule configuration done +before that time.</p> +<p>The DbEnv::rep_set_config method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::rep_set_config method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_set_config 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>onoff</b><dd>If the <b>onoff</b> parameter is zero, the configuration flag is turned +off. Otherwise, it is turned on. +<dt><b>which</b><dd>The <b>which</b> parameter must be set to one of the following values: +<dl compact> +<dt><a name="DB_REP_CONF_BULK">DB_REP_CONF_BULK</a><dd>The replication master sends groups of records to the clients in a +single network transfer (defaults to off). +<dt><a name="DB_REP_CONF_DELAYCLIENT">DB_REP_CONF_DELAYCLIENT</a><dd>The client should delay synchronizing to a newly declared master +(defaults to off). Clients configured in this way will remain +unsynchronized until the application calls the <a href="../api_cxx/rep_sync.html">DbEnv::rep_sync</a> method. +<dt><a name="DB_REP_CONF_NOAUTOINIT">DB_REP_CONF_NOAUTOINIT</a><dd>The replication master will not automatically re-initialize outdated +clients (defaults to off). +<p>The DB_REP_CONF_NOAUTOINIT flag is not supported by Replication +Manager.</p> +<dt><a name="DB_REP_CONF_NOWAIT">DB_REP_CONF_NOWAIT</a><dd>Berkeley DB method calls that would normally block while clients are in +recovery will return errors immediately (defaults to off). +</dl> +</dl> +<h3>Errors</h3> +<p>The DbEnv::rep_set_config method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_get_config</h3> +<p>The DbEnv::rep_get_config method returns whether the specified <b>which</b> +parameter is currently set or not.</p> +<p>The DbEnv::rep_get_config method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_get_config 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>which</b><dd>The <b>which</b> parameter is the message value for which configuration +is being checked. +<dt><b>onoffp</b><dd>The <b>onoffp</b> parameter references memory into which + the configuration of the specified <b>which</b> parameter is copied. If the returned <b>onoff</b> value is zero, the parameter is off; +otherwise on. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/rep_elect.html b/db/docs/api_cxx/rep_elect.html index 39748891c..673c62bce 100644 --- a/db/docs/api_cxx/rep_elect.html +++ b/db/docs/api_cxx/rep_elect.html @@ -1,5 +1,5 @@ -<!--$Id: rep_elect.so,v 1.21 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_elect.so,v 1.24 2006/06/23 01:28:47 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -23,50 +23,80 @@ #include <db_cxx.h> <p> int -DbEnv::rep_elect(int nsites, int nvotes, - int priority, u_int32_t timeout, int *envid, u_int32_t flags); +DbEnv::rep_elect(int nsites, int nvotes, int *envid, u_int32_t flags); </pre></h3> <hr size=1 noshade> <h3>Description: DbEnv::rep_elect</h3> <p>The DbEnv::rep_elect method holds an election for the master of a replication group.</p> +<p>The DbEnv::rep_elect method is not called by most replication +applications. It should only be called by applications implementing +their own network transport layer, explicitly holding replication group +elections and handling replication messages outside of the replication +manager framework.</p> <p>If the election is successful, the new master's ID may be the ID of the -previous master, or the ID of the current environment. The application -is responsible for adjusting its usage of the other environments in the -replication group, including directing all database updates to the newly -selected master, in accordance with the results of this election.</p> +previous master, or the ID of the current replication site. The +application is responsible for adjusting its relationship to the other +database environments in the replication group, including directing all +database updates to the newly selected master, in accordance with the +results of this election.</p> <p>The thread of control that calls the DbEnv::rep_elect method must not be the thread of control that processes incoming messages; processing the incoming messages is necessary to successfully complete an election.</p> <h3>Parameters</h3> <dl compact> <dt><b>envid</b><dd>The <b>envid</b> parameter references memory into which - the newly elected master's ID is copied. -<dt><b>nsites</b><dd>The <b>nsites</b> parameter indicates the number of environments that -the application believes are in the replication group. This number is -used by Berkeley DB to avoid having two masters active simultaneously, even -in the case of a network partition. During an election, a new master -cannot be elected unless more than half of <b>nsites</b> agree on the -new master. Thus, in the face of a network partition, the side of the -partition with more than half the environments will elect a new master -and continue, while the environments communicating with fewer than half -the other environments will fail to find a new master. -<dt><b>nvotes</b><dd>The <b>nvotes</b> parameter indicates the number of votes required by -the application to successfully elect a new master. It must be a -positive integer, no greater than <b>nsites</b>, or 0 if the election -should use a simple majority of the <b>nsites</b> value as the -requirement. A warning is given if half or fewer votes are required to -win an election as that can potentially lead to multiple masters in the -face of a network partition. -<dt><b>priority</b><dd>The <b>priority</b> parameter is the priority of this environment. It -must be a positive integer, or 0 if this environment is not permitted -to become a master (see <a href="../ref/rep/pri.html">Replication -environment priorities</a> for more information). -<dt><b>timeout</b><dd>The <b>timeout</b> parameter specifies a timeout period for an election. -If the election has not completed after <b>timeout</b> microseconds, the -election will fail. + the newly elected master's ID is copied. +<dt><b>nsites</b><dd>The <b>nsites</b> parameter specifies the number of replication sites +expected to participate in the election. Once the current site has +election information from that many sites, it will short-circuit the +election and immediately cast its vote for a new master. The +<b>nsites</b> parameter must be a positive integer, no less than +<b>nvotes</b>, or 0 if the election should use the value previously set +using the <a href="../api_cxx/rep_nsites.html">DbEnv::rep_set_nsites</a> method. +<dt><b>nvotes</b><dd>The <b>nvotes</b> parameter specifies the minimum number of replication +sites from which the current site must have election information, before +the current site will cast a vote for a new master. The <b>nvotes</b> +parameter must be a positive integer and no greater than <b>nsites</b>, +or 0 if the election should use the value ((<b>nsites</b> / 2) + 1) as +the <b>nvotes</b> argument. <dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. </dl> +<p>Elections are done in two parts: first, replication sites collect +information from the other replication sites they know about, and +second, replication sites cast their votes for a new master. The second +phase is triggered by one of two things: either the replication site +gets election information from <b>nsites</b> sites, or the election +<b>timeout</b> expires. Once the second phase is triggered, the +replication site will cast a vote for the new master of its choice if, +and only if, the site has election information from at least +<b>nvotes</b> sites. If a site receives <b>nvotes</b> votes for it +to become the new master, then it will become the new master.</p> +<p>We recommend <b>nvotes</b> be set to at least:</p> +<blockquote><pre>(sites participating in the election / 2) + 1</pre></blockquote> +<p>to ensure there are never more than two masters active at the same time +even in the case of a network partition. When a network partitions, the +side of the partition with more than half the environments will elect a +new master and continue, while the environments communicating with fewer +than half of the environments will fail to find a new master, as no site +can get <b>nvotes</b> votes.</p> +<p>We recommend <b>nsites</b> be set to:</p> +<blockquote><pre>number of sites in the replication group - 1</pre></blockquote> +<p>when choosing a new master after a current master fails. This allows +the group to reach a consensus without having to wait for the timeout +to expire.</p> +<p>When choosing a master from among a group of client +sites all restarting at the same time, it makes more sense to set +<b>nsites</b> to the total number of sites in the group, since there is no +known missing site. Furthermore, in order to ensure the best choice +from among sites that may take longer to boot than the local site, +setting <b>nvotes</b> also to this same total number of sites will +guarantee that every site in the group is considered. (See the +<a href="../ref/rep/elect.html">Elections</a> +section in the Berkeley DB Reference Guide for more information.)</p> +<p>Setting <b>nsites</b> to lower values can increase the speed of an +election, but can also result in election failure, and is usually not +recommended.</p> <a name="2"><!--meow--></a> <h3>Errors</h3> <p>The DbEnv::rep_elect method @@ -76,7 +106,8 @@ encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> <dt>DB_REP_UNAVAIL<dd>The replication group was unable to elect a master, or was unable to -complete the election in the specified <b>timeout</b> period. +complete the election in the election timeout period (see +<a href="../api_cxx/rep_timeout.html">DbEnv::rep_set_timeout</a> method for more information). </dl> <hr size=1 noshade> <h3>Class</h3> @@ -87,6 +118,6 @@ complete the election in the specified <b>timeout</b> period. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_limit.html b/db/docs/api_cxx/rep_limit.html index bb52806f7..de5b162f8 100644 --- a/db/docs/api_cxx/rep_limit.html +++ b/db/docs/api_cxx/rep_limit.html @@ -1,17 +1,17 @@ -<!--$Id: rep_limit.so,v 1.18 2004/09/28 15:04:22 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_limit.so,v 1.22 2006/03/15 19:39:22 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbEnv::set_rep_limit</title> +<title>Berkeley DB: DbEnv::rep_set_limit</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <table width="100%"><tr valign=top> <td> -<h3>DbEnv::set_rep_limit</h3> +<h3>DbEnv::rep_set_limit</h3> </td> <td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> @@ -23,20 +23,22 @@ #include <db_cxx.h> <p> int -DbEnv::set_rep_limit(u_int32_t gbytes, u_int32_t bytes); +DbEnv::rep_set_limit(u_int32_t gbytes, u_int32_t bytes); <p> int -DbEnv::get_rep_limit(u_int32_t *gbytesp, u_int32_t *bytesp); +DbEnv::rep_get_limit(u_int32_t *gbytesp, u_int32_t *bytesp); </pre></h3> <hr size=1 noshade> -<h3>Description: DbEnv::set_rep_limit</h3> -<p>The DbEnv::set_rep_limit method imposes a byte-count limit on the amount of data -that will be transmitted from a site in a single call to <a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> method.</p> -<p>The DbEnv::set_rep_limit method configures a database environment, not only operations +<h3>Description: DbEnv::rep_set_limit</h3> +<p>The DbEnv::rep_set_limit method sets a byte-count limit on the amount of data +that will be transmitted from a site in response to a single message +processed by the <a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> method. The limit is not a hard limit, +and the record that exceeds the limit is the last record to be sent.</p> +<p>The DbEnv::rep_set_limit method configures a database environment, not only operations performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> -<p>The DbEnv::set_rep_limit method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has -been called.</p> -<p>The DbEnv::set_rep_limit method +<p>The DbEnv::rep_set_limit method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_set_limit 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. @@ -49,10 +51,10 @@ number of bytes that will be sent in a single call to <a href="../api_cxx/rep_me number of bytes that will be sent in a single call to <a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a> method. </dl> <hr size=1 noshade> -<h3>Description: dbenv_get_rep_limit</h3> -<p>The DbEnv::get_rep_limit method may be called at any time during the life of the +<h3>Description: rep_get_limit</h3> +<p>The DbEnv::rep_get_limit method may be called at any time during the life of the application.</p> -<p>The DbEnv::get_rep_limit method +<p>The DbEnv::rep_get_limit 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. @@ -60,9 +62,9 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>bytesp</b><dd>The <b>bytesp</b> parameter references memory into which - the additional bytes of memory in the current transmit limit is copied. + the additional bytes of memory in the current transmit limit is copied. <dt><b>gbytesp</b><dd>The <b>gbytesp</b> parameter references memory into which - the gigabytes of memory in the in the current transmit limit is copied. + the gigabytes of memory in the in the current transmit limit is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -73,6 +75,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_list.html b/db/docs/api_cxx/rep_list.html index 251fefd29..f9cc9ebe5 100644 --- a/db/docs/api_cxx/rep_list.html +++ b/db/docs/api_cxx/rep_list.html @@ -1,5 +1,5 @@ <!--$Id: rep_list.so,v 1.1 2002/08/30 20:02:36 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,17 +10,29 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Replication and Related Methods</h3> -<!--$Id: m4.methods,v 1.3 2004/11/02 20:04:10 bostic Exp $--> +<!--$Id: m4.methods,v 1.8 2006/09/07 16:17:58 bostic Exp $--> <table border=1 align=center> -<tr><th>Replication and Related Methods</th><th>Description</th></tr> +<tr><th>Replication Manager Methods</th><th>Description</th></tr> +<!--DbEnv::repmgr_add_remote_site--><tr><td><a href="../api_cxx/repmgr_remote_site.html">DbEnv::repmgr_add_remote_site</a></td><td>Specify the replication manager's remote sites</td></tr> +<!--DbEnv::repmgr_set_ack_policy--><tr><td><a href="../api_cxx/repmgr_ack_policy.html">DbEnv::repmgr_set_ack_policy</a></td><td>Specify the replication manager's client acknowledgement policy</td></tr> +<!--DbEnv::repmgr_set_local_site--><tr><td><a href="../api_cxx/repmgr_local_site.html">DbEnv::repmgr_set_local_site</a></td><td>Specify the replication manager's local site</td></tr> +<!--DbEnv::repmgr_site_list--><tr><td><a href="../api_cxx/repmgr_site_list.html">DbEnv::repmgr_site_list</a></td><td>List the sites and their status</td></tr> +<!--DbEnv::repmgr_start--><tr><td><a href="../api_cxx/repmgr_start.html">DbEnv::repmgr_start</a></td><td>Start the replication manager</td></tr> +<tr><th>Base Replication API</th><th><br></th></tr> <!--DbEnv::rep_elect--><tr><td><a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a></td><td>Hold a replication election</td></tr> <!--DbEnv::rep_process_message--><tr><td><a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a></td><td>Process a replication message</td></tr> +<!--DbEnv::rep_start--><tr><td><a href="../api_cxx/rep_start.html">DbEnv::rep_start</a></td><td>Configure an environment for replication</td></tr> +<tr><th>Additional Replication Methods</th><th><br></th></tr> <!--DbEnv::rep_stat--><tr><td><a href="../api_cxx/rep_stat.html">DbEnv::rep_stat</a></td><td>Replication statistics</td></tr> +<!--DbEnv::rep_sync--><tr><td><a href="../api_cxx/rep_sync.html">DbEnv::rep_sync</a></td><td>Replication synchronization</td></tr> <tr><th>Replication Configuration</th><th><br></th></tr> -<!--DbEnv::rep_start--><tr><td><a href="../api_cxx/rep_start.html">DbEnv::rep_start</a></td><td>Configure an environment for replication</td></tr> -<!--DbEnv::set_rep_limit--><tr><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> -<!--DbEnv::set_rep_transport--><tr><td><a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a></td><td>Configure replication transport</td></tr> +<!--DbEnv::rep_set_config--><tr><td><a href="../api_cxx/rep_config.html">DbEnv::rep_set_config</a></td><td>Configure the replication subsystem</td></tr> +<!--DbEnv::rep_set_limit--><tr><td><a href="../api_cxx/rep_limit.html">DbEnv::rep_set_limit</a></td><td>Limit data sent in response to a single message</td></tr> +<!--DbEnv::rep_set_nsites--><tr><td><a href="../api_cxx/rep_nsites.html">DbEnv::rep_set_nsites</a></td><td>Configure replication group site count</td></tr> +<!--DbEnv::rep_set_priority--><tr><td><a href="../api_cxx/rep_priority.html">DbEnv::rep_set_priority</a></td><td>Configure replication site priority</td></tr> +<!--DbEnv::rep_set_timeout--><tr><td><a href="../api_cxx/rep_timeout.html">DbEnv::rep_set_timeout</a></td><td>Configure replication timeouts</td></tr> +<!--DbEnv::rep_set_transport--><tr><td><a href="../api_cxx/rep_transport.html">DbEnv::rep_set_transport</a></td><td>Configure replication transport callback</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_message.html b/db/docs/api_cxx/rep_message.html index aa4d39ef5..d05a31b3a 100644 --- a/db/docs/api_cxx/rep_message.html +++ b/db/docs/api_cxx/rep_message.html @@ -1,5 +1,5 @@ -<!--$Id: rep_message.so,v 1.30 2004/08/13 03:39:02 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_message.so,v 1.38 2006/06/24 00:33:22 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -29,6 +29,11 @@ DbEnv::rep_process_message(Dbt *control, Dbt *rec, int *envid, DbLsn *ret_lsnp) <h3>Description: DbEnv::rep_process_message</h3> <p>The DbEnv::rep_process_message method processes an incoming replication message sent by a member of the replication group to the local database environment.</p> +<p>The DbEnv::rep_process_message method is not called by most replication +applications. It should only be called by applications implementing +their own network transport layer, explicitly holding replication group +elections and handling replication messages outside of the replication +manager framework.</p> <p>For implementation reasons, all incoming replication messages must be processed using the same <a href="../api_cxx/env_class.html">DbEnv</a> handle. It is not required that a single thread of control process all messages, only that all threads @@ -49,13 +54,25 @@ will either return DB_REP_HOLDELECTION or throw an exception that encapsulates DB_REP_HOLDELECTION if 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_IGNORE">DB_REP_IGNORE</a><dd> +<p>The DbEnv::rep_process_message method will return DB_REP_IGNORE if this message cannot be processed. +This is an indication that this message is irrelevant to the current +replication state (for example, an old message +from a previous generation arrives and is processed late). +</p> <dt><a name="DB_REP_ISPERM">DB_REP_ISPERM</a><dd> <p>The DbEnv::rep_process_message method will return DB_REP_ISPERM if processing this message results in the processing of records that are permanent. The maximum LSN of the permanent records stored is returned. </p> +<dt><a name="DB_REP_JOIN_FAILURE">DB_REP_JOIN_FAILURE</a><dd> +<p>The DbEnv::rep_process_message method will return DB_REP_JOIN_FAILURE if a new master has been chosen but the client is unable to synchronize +with the new master (possibly because the client has been configured +with the <a href="../api_cxx/rep_config.html#DB_REP_CONF_NOAUTOINIT">DB_REP_CONF_NOAUTOINIT</a> flag to turn-off automatic +internal initialization). +</p> <dt><a name="DB_REP_NEWMASTER">DB_REP_NEWMASTER</a><dd> -<p>The DbEnv::rep_process_message method will return DB_REP_NEWMASTER if a new master has been elected. +<p>The DbEnv::rep_process_message method will return DB_REP_NEWMASTER if a new master has been chosen. 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 @@ -71,14 +88,9 @@ channel with this new environment. <dt><a name="DB_REP_NOTPERM">DB_REP_NOTPERM</a><dd> <p>The DbEnv::rep_process_message method will return DB_REP_NOTPERM if a message carrying a <a href="../api_cxx/rep_transport.html#DB_REP_PERMANENT">DB_REP_PERMANENT</a> flag was processed successfully, but was not written to disk. -The LSN of this record is returned. -The application should take whatever action is deemed necessary to -retain its recoverability characteristics. -</p> -<dt><a name="DB_REP_STARTUPDONE">DB_REP_STARTUPDONE</a><dd> -<p>The DbEnv::rep_process_message method will return DB_REP_STARTUPDONE if the system detects that a client completed startup synchronization. -The client application knows that this client is now processing -live log records received from the master. +The LSN of this record is returned. The application should take +whatever action is deemed necessary to retain its recoverability +characteristics. </p> </dl> <p>Unless otherwise specified, the DbEnv::rep_process_message method @@ -97,7 +109,7 @@ corresponds to the environment that sent the message to be processed information). <dt><b>rec</b><dd>The <b>rec</b> parameter should reference a copy of the <b>rec</b> parameter specified by Berkeley DB on the sending environment. -<dt><b>ret_lsn</b><dd>If DbEnv::rep_process_message method returns DB_REP_NOTPERM then the <b>ret_lsnp</b> +<dt><b>ret_lsnp</b><dd>If DbEnv::rep_process_message method returns DB_REP_NOTPERM then the <b>ret_lsnp</b> parameter will contain the log sequence number of this permanent log message that could not be written to disk. If DbEnv::rep_process_message method returns DB_REP_ISPERM then the <b>ret_lsnp</b> parameter will contain @@ -114,6 +126,6 @@ cases the value of <b>ret_lsnp</b> is undefined. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_nsites.html b/db/docs/api_cxx/rep_nsites.html new file mode 100644 index 000000000..bfdc3c35e --- /dev/null +++ b/db/docs/api_cxx/rep_nsites.html @@ -0,0 +1,79 @@ +<!--$Id: rep_nsites.so,v 1.2 2006/06/23 01:28:47 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::rep_set_nsites</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::rep_set_nsites</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::rep_set_nsites(int nsites); +<p> +int +DbEnv::rep_get_nsites(int *nsitesp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_set_nsites</h3> +<p>The DbEnv::rep_set_nsites method specifies the total number of sites +in a replication group.</p> +<p>The DbEnv::rep_set_nsites method is typically called by applications which +use the Berkeley DB library "replication manager" support. (However, see +also the <a href="../api_cxx/rep_elect.html">DbEnv::rep_elect</a> man page, the description of the <b>nsites</b> +parameter.)</p> +<p>The DbEnv::rep_set_nsites method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::rep_set_nsites method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_set_nsites 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>nsites</b><dd>A positive integer specifying the total number of sites in the replication +group. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_get_nsites</h3> +<p>The DbEnv::rep_get_nsites method returns the total number of sites in the replication group.</p> +<p>The DbEnv::rep_get_nsites method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_get_nsites 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>nsitesp</b><dd>The DbEnv::rep_get_nsites method returns the +total number of sites in the replication group in <b>nsitesp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/rep_priority.html b/db/docs/api_cxx/rep_priority.html new file mode 100644 index 000000000..98e464bbf --- /dev/null +++ b/db/docs/api_cxx/rep_priority.html @@ -0,0 +1,77 @@ +<!--$Id: rep_priority.so,v 1.1 2006/03/15 19:39:22 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::rep_set_priority</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::rep_set_priority</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::rep_set_priority(int priority); +int +DbEnv::rep_get_priority(int *priorityp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_set_priority</h3> +<p>The DbEnv::rep_set_priority method specifies the database environment's +priority in replication group elections. The priority must be a +positive integer, or 0 if this environment cannot be a replication +group master.</p> +<p>The DbEnv::rep_set_priority method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::rep_set_priority method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_set_priority 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>priority</b><dd>The priority of this database environment in the replication group. The +priority must be a positive integer, or 0 if this environment cannot be +a replication group master. (See <a href="../ref/rep/pri.html">Replication environment priorities</a> for more information). +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_get_priority</h3> +<p>The DbEnv::rep_get_priority method returns the database environment priority.</p> +<p>The DbEnv::rep_get_priority method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_get_priority 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>priorityp</b><dd>The DbEnv::rep_get_priority method returns the +database environment priority in <b>priorityp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/rep_start.html b/db/docs/api_cxx/rep_start.html index 1dd14500d..c9dc432f0 100644 --- a/db/docs/api_cxx/rep_start.html +++ b/db/docs/api_cxx/rep_start.html @@ -1,5 +1,5 @@ -<!--$Id: rep_start.so,v 1.16 2004/08/13 03:39:02 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_start.so,v 1.17 2006/03/15 19:39:22 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -28,15 +28,20 @@ DbEnv::rep_start(Dbt *cdata, u_int32_t flags); <hr size=1 noshade> <h3>Description: DbEnv::rep_start</h3> <p>The DbEnv::rep_start method configures the database environment as a client -or master in a group of replicated database environments. Replication -master environments are the only database environments where replicated -databases may be modified. Replication client environments are -read-only as long as they are clients. Replication client environments -may be upgraded to be replication master environments in the case that -the current master fails or there is no master present.</p> +or master in a group of replicated database environments.</p> +<p>The DbEnv::rep_start method is not called by most replication +applications. It should only be called by applications implementing +their own network transport layer, explicitly holding replication group +elections and handling replication messages outside of the replication +manager framework.</p> +<p>Replication master environments are the only database environments where +replicated databases may be modified. Replication client environments +are read-only as long as they are clients. Replication client +environments may be upgraded to be replication master environments in +the case that the current master fails or there is no master present.</p> <p>The enclosing database environment must already have been opened by calling the <a href="../api_cxx/env_open.html">DbEnv::open</a> method and must already have been configured -to send replication messages by calling the <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a> method.</p> +to send replication messages by calling the <a href="../api_cxx/rep_transport.html">DbEnv::rep_set_transport</a> method.</p> <p>The DbEnv::rep_start method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on @@ -44,11 +49,11 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>cdata</b><dd>The <b>cdata</b> parameter is an opaque data item that is sent over -the communication infrastructure when the client or master comes online -(see <a href="../ref/rep/newsite.html">Connecting to a new site</a> for -more information). If no such information is useful, <b>cdata</b> -should be NULL. +<dt><b>cdata</b><dd>The <b>cdata</b> parameter is an opaque data item that is sent over the +communication infrastructure when the client comes online (see +<a href="../ref/rep/newsite.html">Connecting to a new site</a> for more +information). If no such information is useful, <b>cdata</b> should +be NULL. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to one of the following values: <dl compact> <dt><a name="DB_REP_CLIENT">DB_REP_CLIENT</a><dd>Configure the environment as a replication client. @@ -63,7 +68,7 @@ encapsulating one of the following non-zero errors, or return one of the following non-zero errors:</p> <dl compact> <dt>EINVAL<dd>If the database environment was not already configured to communicate with -a replication group by a call to <a href="../api_cxx/rep_transport.html">DbEnv::set_rep_transport</a>; +a replication group by a call to <a href="../api_cxx/rep_transport.html">DbEnv::rep_set_transport</a>; the database environment was not already opened; or if an invalid flag value or parameter was specified. </dl> @@ -76,6 +81,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_stat.html b/db/docs/api_cxx/rep_stat.html index 3fcc60930..0844a45de 100644 --- a/db/docs/api_cxx/rep_stat.html +++ b/db/docs/api_cxx/rep_stat.html @@ -1,5 +1,5 @@ -<!--$Id: rep_stat.so,v 10.32 2004/08/13 03:39:02 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_stat.so,v 10.39 2005/11/11 19:00:31 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -43,19 +43,45 @@ the memory reference; references inside the returned memory need not be individually freed.</p> <p>The following DB_REP_STAT fields will be filled in:</p> <dl compact> -<dt>u_int32_t st_status;<dd>The current replication mode. Set to <a href="../api_cxx/rep_start.html#DB_REP_MASTER">DB_REP_MASTER</a> if the -environment is a replication master, <a href="../api_cxx/rep_start.html#DB_REP_CLIENT">DB_REP_CLIENT</a> if the -environment is a replication client, or 0 if replication is not -configured. -<dt>DB_LSN st_next_lsn;<dd>In replication environments configured as masters, the next LSN expected. -In replication environments configured as clients, the next LSN to be used. -<dt>DB_LSN st_waiting_lsn;<dd>The LSN of the first log record we have after missing log records -being waited for, or 0 if no log records are currently missing. +<dt>u_int32_t st_bulk_fills;<dd>The number of times the bulk buffer filled up, forcing the buffer content +to be sent. +<dt>u_int32_t st_bulk_overflows;<dd>The number of times a record was bigger than the entire bulk buffer, +and therefore had to be sent as a singleton. +<dt>u_int32_t st_bulk_records;<dd>The number of records added to a bulk buffer. +<dt>u_int32_t st_bulk_transfers;<dd>The number of bulk buffers transferred (via a call to the +application's <b>send</b> function). +<dt>u_int32_t st_client_rerequests;<dd>The number of times this client site received a "re-request" message, +indicating that a request it previously sent to another client could +not be serviced by that client. (Compare to +<b>st_client_svc_miss</b>.) +<dt>u_int32_t st_client_svc_miss;<dd>The number of "request" type messages received by this client that +could not be processed, forcing the originating requester to try sending +the request to the master (or another client). +<dt>u_int32_t st_client_svc_req;<dd>The number of "request" type messages received by this client. +("Request" messages are usually sent from a client to the master, but a +message marked with the <a href="../api_cxx/rep_transport.html#DB_REP_ANYWHERE">DB_REP_ANYWHERE</a> flag in the invocation +of the application's <b>send</b> function may be sent to another client +instead.) <dt>u_int32_t st_dupmasters;<dd>The number of duplicate master conditions detected. +<dt>u_int32_t st_egen;<dd>The current election generation number. +<dt>u_int32_t st_election_cur_winner;<dd>The election winner. +<dt>u_int32_t st_election_gen;<dd>The election generation number. +<dt>DB_LSN st_election_lsn;<dd>The maximum LSN of election winner. +<dt>u_int32_t st_election_nsites;<dd>The number sites responding to this site during the last election. +<dt>u_int32_t st_election_nvotes;<dd>The number of votes required in the last election. +<dt>u_int32_t st_election_priority;<dd>The election priority. +<dt>u_int32_t st_election_sec;<dd>The number of seconds the last election took (the total election time +is <b>st_election_sec</b> plus <b>st_election_usec</b>). +<dt>u_int32_t st_election_status;<dd>The current election phase (0 if no election is in progress). +<dt>u_int32_t st_election_tiebreaker;<dd>The election tiebreaker value. +<dt>u_int32_t st_election_usec;<dd>The number of microseconds the last election took (the total election +time is <b>st_election_sec</b> plus <b>st_election_usec</b>). +<dt>u_int32_t st_election_votes;<dd>The number of votes received in the last election. +<dt>u_int32_t st_elections;<dd>The number of elections held. +<dt>u_int32_t st_elections_won;<dd>The number of elections won. <dt>u_int32_t st_env_id;<dd>The current environment ID. <dt>u_int32_t st_env_priority;<dd>The current environment priority. <dt>u_int32_t st_gen;<dd>The current generation number. -<dt>u_int32_t st_egen;<dd>The current election generation number. <dt>u_int32_t st_log_duplicated;<dd>The number of duplicate log records received. <dt>u_int32_t st_log_queued;<dd>The number of log records currently queued. <dt>u_int32_t st_log_queued_max;<dd>The maximum number of log records ever queued at once. @@ -70,31 +96,28 @@ being waited for, or 0 if no log records are currently missing. <dt>u_int32_t st_msgs_send_failures;<dd>The number of failed message sends. <dt>u_int32_t st_msgs_sent;<dd>The number of messages sent. <dt>u_int32_t st_newsites;<dd>The number of new site messages received. -<dt>int st_nsites;<dd>The number of sites believed to be in the replication group. -<dt>u_int32_t st_outdated;<dd>The number of outdated conditions detected. +<dt>DB_LSN st_next_lsn;<dd>In replication environments configured as masters, the next LSN expected. +In replication environments configured as clients, the next LSN to be used. <dt>u_int32_t st_next_pg;<dd>The next page number we expect to receive. -<dt>u_int32_t st_waiting_pg;<dd>The page number of the first page we have after missing pages -being waited for, or 0 if no pages are currently missing. +<dt>int st_nsites;<dd>The number of sites used in the last election. +<dt>u_int32_t st_nthrottles;<dd>Transmission limited. This indicates the number of times that data +transmission was stopped to limit the amount of data sent in response +to a single call to <a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>. +<dt>u_int32_t st_outdated;<dd>The number of outdated conditions detected. <dt>u_int32_t st_pg_duplicated;<dd>The number of duplicate pages received. <dt>u_int32_t st_pg_records;<dd>The number of pages received and stored. <dt>u_int32_t st_pg_requested;<dd>The number of pages missed and requested from the master. <dt>u_int32_t st_startup_complete;<dd>The client site has completed its startup procedures and is now handling live records from the master. +<dt>u_int32_t st_status;<dd>The current replication mode. Set to <a href="../api_cxx/repmgr_start.html#DB_REP_MASTER">DB_REP_MASTER</a> if the +environment is a replication master, <a href="../api_cxx/repmgr_start.html#DB_REP_CLIENT">DB_REP_CLIENT</a> if the +environment is a replication client, or 0 if replication is not +configured. <dt>u_int32_t st_txns_applied;<dd>The number of transactions applied. -<dt>u_int32_t st_elections;<dd>The number of elections held. -<dt>u_int32_t st_elections_won;<dd>The number of elections won. -<dt>u_int32_t st_election_status;<dd>The current election phase (0 if no election is in progress). -<dt>u_int32_t st_election_cur_winner;<dd>The election winner. -<dt>u_int32_t st_election_gen;<dd>The election generation number. -<dt>DB_LSN st_election_lsn;<dd>The maximum LSN of election winner. -<dt>u_int32_t st_election_nsites;<dd>The number sites expected to participate in elections. -<dt>u_int32_t st_election_nvotes;<dd>The number of votes required to complete the election. -<dt>u_int32_t st_nthrottles;<dd>Transmission limited. This indicates the number of times that data -transmission was stopped to limit the amount of data sent in response -to a single call to <a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>. -<dt>u_int32_t st_election_priority;<dd>The election priority. -<dt>u_int32_t st_election_tiebreaker;<dd>The election tiebreaker value. -<dt>u_int32_t st_election_votes;<dd>The votes received this election round. +<dt>DB_LSN st_waiting_lsn;<dd>The LSN of the first log record we have after missing log records +being waited for, or 0 if no log records are currently missing. +<dt>u_int32_t st_waiting_pg;<dd>The page number of the first page we have after missing pages +being waited for, or 0 if no pages are currently missing. </dl> <p>The DbEnv::rep_stat method either returns a non-zero error value @@ -109,7 +132,7 @@ the following value: <dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. </dl> <dt><b>statp</b><dd>The <b>statp</b> parameter references memory into which -a pointer to the allocated statistics structure is copied. +a pointer to the allocated statistics structure is copied. </dl> <h3>Errors</h3> <p>The DbEnv::rep_stat method @@ -123,7 +146,7 @@ invalid flag value or parameter was specified. </dl> <hr size=1 noshade> <h3>Description: DbEnv::rep_stat_print</h3> -<p>The DbEnv::rep_stat_print method returns the +<p>The DbEnv::rep_stat_print method displays the replication subsystem statistical information, as described for the DbEnv::rep_stat method. The information is printed to a specified output channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an @@ -138,10 +161,11 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> <dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. </dl> </dl> <hr size=1 noshade> @@ -153,6 +177,6 @@ the following value: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/rep_sync.html b/db/docs/api_cxx/rep_sync.html new file mode 100644 index 000000000..23bc82f79 --- /dev/null +++ b/db/docs/api_cxx/rep_sync.html @@ -0,0 +1,63 @@ +<!--$Id: rep_sync.so,v 1.9 2006/07/12 20:32:35 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::rep_sync</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::rep_sync</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::rep_sync(u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_sync</h3> +<p>The DbEnv::rep_sync method forces master synchronization to begin for this +client. This method is the other half of setting the +<a href="../api_cxx/rep_config.html#DB_REP_CONF_DELAYCLIENT">DB_REP_CONF_DELAYCLIENT</a> flag via the <a href="../api_cxx/rep_config.html">DbEnv::rep_set_config</a> method.</p> +<p>If an application has configured delayed master synchronization, the +application must synchronize explicitly (otherwise the client will +remain out-of-date and will ignore all database changes forwarded from +the replication group master). The DbEnv::rep_sync method may be called any +time after the client application learns that the new master has been +established, either by receiving a <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_NEWMASTER">DB_EVENT_REP_NEWMASTER</a> event +notification, or from a <a href="../api_cxx/rep_message.html#DB_REP_NEWMASTER">DB_REP_NEWMASTER</a> return code from +<a href="../api_cxx/rep_message.html">DbEnv::rep_process_message</a>.</p> +<p>The DbEnv::rep_sync method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::rep_sync 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/rep_timeout.html b/db/docs/api_cxx/rep_timeout.html new file mode 100644 index 000000000..ebe203f09 --- /dev/null +++ b/db/docs/api_cxx/rep_timeout.html @@ -0,0 +1,102 @@ +<!--$Id: rep_timeout.so,v 1.3 2006/06/30 23:05:16 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::rep_set_timeout</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::rep_set_timeout</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::rep_set_timeout(int which, u_int32_t timeout); +<p> +int +DbEnv::rep_get_timeout(int which, u_int32_t *timeoutp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_set_timeout</h3> +<p>The DbEnv::rep_set_timeout method specifies a variety of replication timeout +values.</p> +<p>The DbEnv::rep_set_timeout method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::rep_set_timeout method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>which</b><dd>The <b>which</b> parameter must be set to one of the following values: +<dl compact> +<dt><a name="DB_REP_ACK_TIMEOUT">DB_REP_ACK_TIMEOUT</a><dd>Configure the amount of time the replication manager's transport +function waits to collect enough acknowledgments from replication group +clients, before giving up and returning a failure indication. The +default wait time is 1 second. +<dt><a name="DB_REP_ELECTION_TIMEOUT">DB_REP_ELECTION_TIMEOUT</a><dd>The timeout period for an election. The default timeout is 2 seconds. +<dt><a name="DB_REP_ELECTION_RETRY">DB_REP_ELECTION_RETRY</a><dd>Configure the amount of time the replication manager will wait before +retrying a failed election. The default wait time is 10 seconds. +<dt><a name="DB_REP_CONNECTION_RETRY">DB_REP_CONNECTION_RETRY</a><dd>Configure the amount of time the replication manager will wait before +trying to re-establish a connection to another site after a communication +failure. The default wait time is 30 seconds. +</dl> +<dt><b>timeout</b><dd>The <b>timeout</b> parameter is the timeout value. It must be specified +as an unsigned 32-bit number of microseconds, limiting the maximum timeout +to roughly 71 minutes. +</dl> +<h3>Errors</h3> +<p>The DbEnv::rep_set_timeout method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::rep_get_timeout</h3> +<p>The DbEnv::rep_get_timeout method returns the timeout value for the specified +<b>which</b> parameter.</p> +<p>The DbEnv::rep_get_timeout method may be called at any time during the life of the +application.</p> +<p>The DbEnv::rep_get_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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>which</b><dd>The <b>which</b> parameter is the timeout value for which the value +is being returned. +<dt><b>timeoutp</b><dd>The <b>timeoutp</b> parameter references memory into which + the timeout value of the specified <b>which</b> parameter is copied. The returned <b>timeout</b> value is in microseconds. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/rep_transport.html b/db/docs/api_cxx/rep_transport.html index 2d6d28773..8b6928618 100644 --- a/db/docs/api_cxx/rep_transport.html +++ b/db/docs/api_cxx/rep_transport.html @@ -1,17 +1,17 @@ -<!--$Id: rep_transport.so,v 1.31 2004/08/13 03:39:02 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: rep_transport.so,v 1.35 2006/06/05 23:03:53 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> <head> -<title>Berkeley DB: DbEnv::set_rep_transport</title> +<title>Berkeley DB: DbEnv::rep_set_transport</title> <meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> <meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> </head> <body bgcolor=white> <table width="100%"><tr valign=top> <td> -<h3>DbEnv::set_rep_transport</h3> +<h3>DbEnv::rep_set_transport</h3> </td> <td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> @@ -23,21 +23,26 @@ #include <db_cxx.h> <p> int -DbEnv::set_rep_transport(int envid, +DbEnv::rep_set_transport(int envid, int (*send)(DB_ENV *dbenv, const Dbt *control, const Dbt *rec, const DbLsn *lsnp, int envid, u_int32_t flags)); </pre></h3> <hr size=1 noshade> -<h3>Description: DbEnv::set_rep_transport</h3> -<p>The DbEnv::set_rep_transport method initializes the communication infrastructure +<h3>Description: DbEnv::rep_set_transport</h3> +<p>The DbEnv::rep_set_transport method initializes the communication infrastructure for a database environment participating in a replicated application.</p> -<p>The DbEnv::set_rep_transport method configures operations performed using the specified +<p>The DbEnv::rep_set_transport method is not called by most replication +applications. It should only be called by applications implementing +their own network transport layer, explicitly holding replication group +elections and handling replication messages outside of the replication +manager framework.</p> +<p>The DbEnv::rep_set_transport method configures operations performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle, not all operations performed on the underlying database environment.</p> -<p>The DbEnv::set_rep_transport method may be called at any time during the life of the +<p>The DbEnv::rep_set_transport method may be called at any time during the life of the application.</p> -<p>The DbEnv::set_rep_transport method +<p>The DbEnv::rep_set_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. @@ -45,7 +50,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>envid</b><dd>The <b>envid</b> parameter is the local environment's ID. It must be -a positive integer and uniquely identify this Berkeley DB database environment +a non-negative integer and uniquely identify this Berkeley DB database environment (see <a href="../ref/rep/id.html">Replication environment IDs</a> for more information). <dt><b>send</b><dd>The <b>send</b> callback function is used to transmit data using the @@ -74,6 +79,8 @@ cases, the sending site should not be asked to process the message.</p> <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> +<dt><a name="DB_REP_ANYWHERE">DB_REP_ANYWHERE</a><dd>The message is a client request that can be satisfied by another client +as well as by the master. <dt><a name="DB_REP_NOBUFFER">DB_REP_NOBUFFER</a><dd>The record being sent should be transmitted immediately and not buffered or delayed. <dt><a name="DB_REP_PERMANENT">DB_REP_PERMANENT</a><dd>The record being sent is critical for maintaining database integrity @@ -81,20 +88,25 @@ or delayed. application should take appropriate action to enforce the reliability guarantees it has chosen, such as waiting for acknowledgement from one or more clients. +<dt><a name="DB_REP_REREQUEST">DB_REP_REREQUEST</a><dd>The message is a client request that has already been made and to which +no response was received. </dl> </dl> <p>It may sometimes be useful to pass application-specific data to the <b>send</b> function; see <a href="../ref/env/faq.html">Environment FAQ</a> for a discussion on how to do this.</p> -The <b>send</b> function should not call back down into Berkeley DB. The -<b>send</b> function must return 0 on success and non-zero on failure. -If the <b>send</b> function fails, the message being sent is necessary -to maintain database integrity, and the local log is not configured for -synchronous flushing, the local log will be flushed; otherwise, any -error from the <b>send</b> function will be ignored. +<p>The <b>send</b> function must return 0 on success and non-zero on +failure. If the <b>send</b> function fails, the message being sent is +necessary to maintain database integrity, and the local log is not +configured for synchronous flushing, the local log will be flushed; +otherwise, any error from the <b>send</b> function will be ignored.</p> +<p>Berkeley DB is not re-entrant. Callback functions should not attempt to make +library calls (for example, to release locks or close open handles). +Re-entering Berkeley DB is not guaranteed to work correctly, and the results +are undefined.</p> </dl> <h3>Errors</h3> -<p>The DbEnv::set_rep_transport method +<p>The DbEnv::rep_set_transport method may fail and throw <a href="../api_cxx/except_class.html">DbException</a>, encapsulating one of the following non-zero errors, or return one of @@ -112,6 +124,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/repmgr_ack_policy.html b/db/docs/api_cxx/repmgr_ack_policy.html new file mode 100644 index 000000000..25dda52a5 --- /dev/null +++ b/db/docs/api_cxx/repmgr_ack_policy.html @@ -0,0 +1,102 @@ +<!--$Id: repmgr_ack_policy.so,v 1.5 2006/09/07 19:26:44 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::repmgr_set_ack_policy</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::repmgr_set_ack_policy</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::repmgr_set_ack_policy(int ack_policy); +<p> +int +DbEnv::repmgr_get_ack_policy(int *ack_policyp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_set_ack_policy</h3> +<p>The DbEnv::repmgr_set_ack_policy method specifies how master and client sites +will handle acknowledgment of replication messages which are necessary +for "permanent" records. The current implementation requires all +sites in a replication group configure the same acknowledgement +policy.</p> +<p>The DbEnv::repmgr_set_ack_policy method configures a database environment, not only operations +performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p> +<p>The DbEnv::repmgr_set_ack_policy method may be called at any time during the life of the +application.</p> +<p>The DbEnv::repmgr_set_ack_policy 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>ack_policy</b><dd>The <b>ack_policy</b> parameter must be set to one of the following +values: +<dl compact> +<dt><a name="DB_REPMGR_ACKS_ALL">DB_REPMGR_ACKS_ALL</a><dd>The master should wait until all replication clients have acknowledged +each permanent replication message. +<dt><a name="DB_REPMGR_ACKS_ALL_PEERS">DB_REPMGR_ACKS_ALL_PEERS</a><dd>The master should wait until all electable peers have acknowledged each +permanent replication message (where "electable peer" means a client +capable of being subsequently elected master of the replication +group). +<dt><a name="DB_REPMGR_ACKS_NONE">DB_REPMGR_ACKS_NONE</a><dd>The master should not wait for any client replication message +acknowledgments. +<dt><a name="DB_REPMGR_ACKS_ONE">DB_REPMGR_ACKS_ONE</a><dd>The master should wait until at least one client site has acknowledged +each permanent replication message. +<dt><a name="DB_REPMGR_ACKS_ONE_PEER">DB_REPMGR_ACKS_ONE_PEER</a><dd>The master should wait until at least one electable peer has +acknowledged each permanent replication message (where "electable peer" +means a client capable of being subsequently elected master of the +replication group). +<dt><a name="DB_REPMGR_ACKS_QUORUM">DB_REPMGR_ACKS_QUORUM</a><dd>The master should wait until it has received acknowledgements from the +minimum number of electable peers sufficient to ensure that the effect +of the permanent record remains durable if an election is held (where +"electable peer" means a client capable of being subsequently elected +master of the replication group). This is the default acknowledgement +policy. +</dl> +<p>Waiting for client acknowledgements is always limited by the +<a href="../api_cxx/rep_timeout.html#DB_REP_ACK_TIMEOUT">DB_REP_ACK_TIMEOUT</a> specified by <a href="../api_cxx/rep_timeout.html">DbEnv::rep_set_timeout</a>.</p> +</dl> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_get_ack_policy</h3> +<p>The DbEnv::repmgr_get_ack_policy method returns the replication manager's client acknowledgment policy.</p> +<p>The DbEnv::repmgr_get_ack_policy method may be called at any time during the life of the +application.</p> +<p>The DbEnv::repmgr_get_ack_policy 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>ack_policyp</b><dd>The DbEnv::repmgr_get_ack_policy method returns the +replication manager's client acknowledgment policy in <b>ack_policyp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/repmgr_local_site.html b/db/docs/api_cxx/repmgr_local_site.html new file mode 100644 index 000000000..98059f90d --- /dev/null +++ b/db/docs/api_cxx/repmgr_local_site.html @@ -0,0 +1,56 @@ +<!--$Id: repmgr_local_site.so,v 1.2 2006/04/27 18:07:38 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::repmgr_set_local_site</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::repmgr_set_local_site</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::repmgr_set_add_site(const char *host, u_int port, u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_set_local_site</h3> +<p>The DbEnv::repmgr_set_local_site method specifies the host identification +string and port number for the local system.</p> +<p>The DbEnv::repmgr_set_local_site method must be called before the <a href="../api_cxx/repmgr_start.html">DbEnv::repmgr_start</a> method has been +called.</p> +<p>The DbEnv::repmgr_set_local_site 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter is currently unused, and must be set to 0. +<dt><b>host</b><dd>The site's host identification string, generally a TCP/IP host name. +<dt><b>port</b><dd>The port number on which the local site is listening. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/repmgr_remote_site.html b/db/docs/api_cxx/repmgr_remote_site.html new file mode 100644 index 000000000..7bf3e0782 --- /dev/null +++ b/db/docs/api_cxx/repmgr_remote_site.html @@ -0,0 +1,68 @@ +<!--$Id: repmgr_remote_site.so,v 1.5 2006/09/08 18:33:38 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::repmgr_add_remote_site</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::repmgr_add_remote_site</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::repmgr_add_remote_site(const char *host, u_int port, int *eidp, u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_add_remote_site</h3> +<p>The DbEnv::repmgr_add_remote_site method adds a new replication site to the +replication manager's list of known sites. It is not necessary for +all sites in a replication group to know about all other sites in the +group.</p> +<p>The DbEnv::repmgr_add_remote_site method may be called at any time during the life of the +application.</p> +<p>The DbEnv::repmgr_add_remote_site 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>eidp</b><dd>If <b>eidp</b> is non-NULL, the +environment ID assigned to the remote site is +returned in the memory location referenced by <b>eidp</b>. +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: +<dl compact> +<dt><a name="DB_REPMGR_PEER">DB_REPMGR_PEER</a><dd>Specifying the DB_REPMGR_PEER flag configures client-to-client +synchronization with the specified remote site. +<p>Currently, the replication manager framework only supports a single client +peer, and the last specified peer is used.</p> +</dl> +<dt><b>host</b><dd>The site's host identification string, generally a TCP/IP host name. +<dt><b>port</b><dd>The port number on which the remote site is receiving. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/repmgr_site_list.html b/db/docs/api_cxx/repmgr_site_list.html new file mode 100644 index 000000000..1217cb903 --- /dev/null +++ b/db/docs/api_cxx/repmgr_site_list.html @@ -0,0 +1,77 @@ +<!--$Id: repmgr_site_list.so,v 1.7 2006/09/11 16:57:54 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::repmgr_site_list</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::repmgr_site_list</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::repmgr_site_list(u_int *countp, DB_REPMGR_SITE **listp); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_site_list</h3> +<p>The DbEnv::repmgr_site_list method returns the status of the sites currently +known by the replication manager.</p> +<p>The DbEnv::repmgr_site_list method creates a statistical structure of type +DB_REPMGR_SITE and copies a pointer to it into a user-specified memory +location.</p> +<p>Statistical structures are stored in allocated memory. If application-specific allocation +routines have been declared (see <a href="../api_cxx/env_set_alloc.html">DbEnv::set_alloc</a> for more +information), they are used to allocate the memory; otherwise, the +standard C library <b>malloc</b>(3) is used. The caller is +responsible for deallocating the memory. To deallocate the memory, free +the memory reference; references inside the returned memory need not be +individually freed.</p> +<p>The following DB_REPMGR_SITE fields will be filled in:</p> +<dl compact> +<dt>int eid;<dd>Environment ID assigned by the replication manager. +This is the same value that is passed to the application's +event notification function for the <a href="../api_cxx/env_event_notify.html#DB_EVENT_REP_NEWMASTER">DB_EVENT_REP_NEWMASTER</a> event. +<dt>char host[];<dd>Nul-terminated host name. +<dt>u_int port;<dd>TCP/IP port number. +<dt>u_int32_t status;<dd>One of the following list of constants: <a name="DB_REPMGR_CONNECTED">DB_REPMGR_CONNECTED</a>, +<a name="DB_REPMGR_DISCONNECTED">DB_REPMGR_DISCONNECTED</a>. +</dl> +<p>The DbEnv::repmgr_site_list method may be called at any time during the life of the +application.</p> +<p>The DbEnv::repmgr_site_list 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>countp</b><dd>A count of the returned structures will be stored into the memory +referenced by <b>countp</b>. +<dt><b>listp</b><dd>A reference to an array of structures will be stored into the memory +referenced by <b>listp</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/repmgr_start.html b/db/docs/api_cxx/repmgr_start.html new file mode 100644 index 000000000..9d34984a9 --- /dev/null +++ b/db/docs/api_cxx/repmgr_start.html @@ -0,0 +1,97 @@ +<!--$Id: repmgr_start.so,v 1.3 2006/07/14 23:08:18 alanb Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbEnv::repmgr_start</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbEnv::repmgr_start</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbEnv::repmgr_start(int nthreads, u_int32_t flags); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbEnv::repmgr_start</h3> +<p>The DbEnv::repmgr_start method starts the replication manager.</p> +<p>There are two ways to build Berkeley DB replication applications: the most +common approach is to use the Berkeley DB library "replication manager" +support, where the Berkeley DB library manages the replication group, +including network transport, all replication message processing and +acknowledgment, and group elections. Applications using the replication +manager support generally make the following calls:</p> +<ol> +<p><li>Call <a href="../api_cxx/repmgr_local_site.html">DbEnv::repmgr_set_local_site</a> to configure the local site in the +replication group. +<p><li>Call <a href="../api_cxx/repmgr_remote_site.html">DbEnv::repmgr_add_remote_site</a> to configure the remote site(s) in +the replication group. +<p><li>Call <a href="../api_cxx/repmgr_ack_policy.html">DbEnv::repmgr_set_ack_policy</a> to configure the message +acknowledgment policy which provides the replication group's +transactional needs. +<p><li>Call <a href="../api_cxx/rep_priority.html">DbEnv::rep_set_priority</a> to configure the local site's election +priority. +<p><li>Call DbEnv::repmgr_start to start the replication application. +</ol> +<p>For more information on building replication manager applications, +please see the "Replication Manager Getting Started Guide" included in +the Berkeley DB documentation.</p> +<p>Applications with special needs (for example, applications using network +protocols not supported by the Berkeley DB replication manager), must perform +additional configuration and call other Berkeley DB replication methods. For +more information on building advanced replication applications, please +see the "Advanced Replication Applications Guide" included in the Berkeley DB +documentation.</p> +<p>The DbEnv::repmgr_start method may not be called before the <a href="../api_cxx/env_open.html">DbEnv::open</a> method has +been called.</p> +<p>The DbEnv::repmgr_start 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to one of the following values: +<dl compact> +<dt><a name="DB_REP_MASTER">DB_REP_MASTER</a><dd>Start as a master site, and do not call for an election. Note there +must never be more than a single master in any replication group, and +only one site at a time should ever be started with the +DB_REP_MASTER flag specified. +<dt><a name="DB_REP_CLIENT">DB_REP_CLIENT</a><dd>Start as a client site, and do not call for an election. +<dt><a name="DB_REP_ELECTION">DB_REP_ELECTION</a><dd>Start as a client, and call for an election if no master is found. +<dt><a name="DB_REP_FULL_ELECTION">DB_REP_FULL_ELECTION</a><dd>Start as a client, and call for an election if no master is found. +<p>The <a href="../api_cxx/repmgr_start.html#DB_REP_FULL_ELECTION">DB_REP_FULL_ELECTION</a> flag configures a single special +election on startup, where a master will only be confirmed if all +members of the replication group vote. Subsequent elections will revert +to only requiring a simple majority to elect a new master.</p> +</dl> +<dt><b>nthreads</b><dd>Specify the number of threads of control created and dedicated to processing +replication messages. In addition to these message processing threads, +the replication manager creates and manages a few of its own threads of +control. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a> +<h3>See Also</h3> +<a href="../api_cxx/rep_list.html">Replication and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/runrec_class.html b/db/docs/api_cxx/runrec_class.html index a3f4a46a9..b10d2a956 100644 --- a/db/docs/api_cxx/runrec_class.html +++ b/db/docs/api_cxx/runrec_class.html @@ -1,5 +1,5 @@ <!--$Id: runrec_class.so,v 10.19 2004/08/13 03:38:56 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -39,6 +39,6 @@ occurs, recovery should be performed.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_class.html b/db/docs/api_cxx/seq_class.html index 2241514a5..8cfbfca06 100644 --- a/db/docs/api_cxx/seq_class.html +++ b/db/docs/api_cxx/seq_class.html @@ -1,5 +1,5 @@ <!--$Id: seq_class.so,v 1.12 2004/10/18 19:46:31 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -67,6 +67,6 @@ DbSequence <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_close.html b/db/docs/api_cxx/seq_close.html index fca3d7c35..42f64fc64 100644 --- a/db/docs/api_cxx/seq_close.html +++ b/db/docs/api_cxx/seq_close.html @@ -1,5 +1,5 @@ <!--$Id: seq_close.so,v 1.2 2004/08/13 03:39:02 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -59,6 +59,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_get.html b/db/docs/api_cxx/seq_get.html index dd5934093..bc8efc2da 100644 --- a/db/docs/api_cxx/seq_get.html +++ b/db/docs/api_cxx/seq_get.html @@ -1,5 +1,5 @@ -<!--$Id: seq_get.so,v 1.8 2004/08/28 23:44:22 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: seq_get.so,v 1.11 2005/08/09 14:23:30 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -34,15 +34,15 @@ values in the sequence handle then they will be returned. Otherwise the next value will be fetched from the database and incremented (decremented) by enough to cover the <b>delta</b> and the next batch of cached values.</p> -<p>If the underlying database handle was opened in a transaction then -either the <b>txnid</b> parameter must be a valid transaction handle or -DB_AUTO_COMMIT must be specified. The <b>txnid</b> handle must be NULL -if the sequence handle was opened with a non-zero cache size.</p> <p>For maximum concurrency a non-zero cache size should be specified prior -to opening the sequence handle and DB_AUTO_COMMIT | DB_TXN_NOSYNC should -be specified each DbSequence::get method call.</p> -<p>The DbSequence::get method will return EINVAL if the record in the database is not a valid sequence record, -or the sequences have overflowed is range. +to opening the sequence handle and <a href="../api_cxx/env_set_flags.html#DB_TXN_NOSYNC">DB_TXN_NOSYNC</a> should be +specified for each DbSequence::get method call.</p> +<p>By default, sequence ranges do not wrap; to cause the sequence to wrap +around the beginning or end of its range, specify the <a href="../api_cxx/seq_set_flags.html#DB_SEQ_WRAP">DB_SEQ_WRAP</a> +flag to the <a href="../api_cxx/seq_set_flags.html">DbSequence::set_flags</a> method.</p> +<p>The DbSequence::get method will return EINVAL if the record in the database is not a valid sequence +record, or the sequence has reached the beginning or end of its range +and is not configured to wrap. </p> <h3>Parameters</h3> <dl compact> @@ -50,17 +50,32 @@ or the sequences have overflowed is range. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>If the database -must be updated the update will be enclosed in a transaction -and will be recoverable. -<dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>If a DB_AUTO_COMMIT -triggers a transaction, do not synchronously flush the log. +<dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>If the operation is implicitly transaction protected (the <b>txnid</b> +argument is NULL but the operation occurs to a transactional database), +do not synchronously flush the log when the transaction commits. </dl> <dt><b>retp</b><dd><b>retp</b> points to the memory to hold the return value from the sequence. -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. No <b>txnid</b> handle may be specified if the sequence handle was +opened with a non-zero cache size. +<p>If the underlying database handle was opened in a transaction, calling +DbSequence::get may result in changes to the sequence object; these +changes will be automatically committed in a transaction internal to the +Berkeley DB library. If the thread of control calling DbSequence::get has +an active transaction, which holds locks on the same database as the +one in which the sequence object is stored, it is possible for a thread +of control calling DbSequence::get to self-deadlock because the active +transaction's locks conflict with the internal transaction's locks. +For this reason, it is often preferable for sequence objects to be +stored in their own database.</p> </dl> <hr size=1 noshade> <h3>Class</h3> @@ -71,6 +86,6 @@ the <b>txnid</b> parameter is a transaction handle returned from <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_initial_value.html b/db/docs/api_cxx/seq_initial_value.html new file mode 100644 index 000000000..95af3518e --- /dev/null +++ b/db/docs/api_cxx/seq_initial_value.html @@ -0,0 +1,64 @@ +<!--$Id: seq_initial_value.so,v 1.6 2004/11/29 15:30:23 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbSequence::initial_value</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbSequence::initial_value</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbSequence::initial_value(db_seq_t value); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbSequence::initial_value</h3> +<p>Set the initial value for a sequence. This call is only effective when +the sequence is being created.</p> +<p>The DbSequence::initial_value method may not be called after the +<a href="../api_cxx/seq_open.html">DbSequence::open</a> method is called.</p> +<p>The DbSequence::initial_value 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>value</b><dd>The initial value to set. +</dl> +<h3>Errors</h3> +<p>The DbSequence::initial_value method +may fail and throw +<a href="../api_cxx/except_class.html">DbException</a>, +encapsulating one of the following non-zero errors, or return one of +the following non-zero errors:</p> +<dl compact> +<dt>EINVAL<dd>An +invalid flag value or parameter was specified. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/seq_class.html">DbSequence</a> +<h3>See Also</h3> +<a href="../api_cxx/seq_list.html">Sequences and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/seq_list.html b/db/docs/api_cxx/seq_list.html index fd7372e18..72430a117 100644 --- a/db/docs/api_cxx/seq_list.html +++ b/db/docs/api_cxx/seq_list.html @@ -1,5 +1,5 @@ <!--$Id: seq_list.so,v 1.2 2004/08/18 02:34:52 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,7 +10,7 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Sequences and Related Methods</h3> -<!--$Id: m4.methods,v 1.6 2004/11/02 20:04:10 bostic Exp $--> +<!--$Id: m4.methods,v 1.7 2004/11/29 15:34:22 bostic Exp $--> <table border=1 align=center> <tr><th>Sequences and Related Methods</th><th>Description</th></tr> <!--DbSequence::--><tr><td><a href="../api_cxx/seq_class.html">DbSequence</a></td><td>Create a sequence handle</td></tr> @@ -18,7 +18,7 @@ <!--DbSequence::get--><tr><td><a href="../api_cxx/seq_get.html">DbSequence::get</a></td><td>Get the next sequence element(s)</td></tr> <!--DbSequence::get_dbp--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::get_dbp</a></td><td>Return a handle for the underlying sequence database</td></tr> <!--DbSequence::get_key--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::get_key</a></td><td>Return the key for a sequence</td></tr> -<!--DbSequence::init_value--><tr><td><a href="../api_cxx/seq_init_value.html">DbSequence::init_value</a></td><td>Set the initial value of a sequence</td></tr> +<!--DbSequence::initial_value--><tr><td><a href="../api_cxx/seq_initial_value.html">DbSequence::initial_value</a></td><td>Set the initial value of a sequence</td></tr> <!--DbSequence::open--><tr><td><a href="../api_cxx/seq_open.html">DbSequence::open</a></td><td>Open a sequence</td></tr> <!--DbSequence::remove--><tr><td><a href="../api_cxx/seq_remove.html">DbSequence::remove</a></td><td>Remove a sequence</td></tr> <!--DbSequence::stat--><tr><td><a href="../api_cxx/seq_stat.html">DbSequence::stat</a></td><td>Return sequence statistics</td></tr> @@ -27,6 +27,6 @@ <!--DbSequence::set_flags--><tr><td><a href="../api_cxx/seq_set_flags.html">DbSequence::set_flags</a></td><td>Set the flags for a sequence</td></tr> <!--DbSequence::set_range--><tr><td><a href="../api_cxx/seq_set_range.html">DbSequence::set_range</a></td><td>Set the range for a sequence</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_open.html b/db/docs/api_cxx/seq_open.html index f7f04f159..bfee02ecc 100644 --- a/db/docs/api_cxx/seq_open.html +++ b/db/docs/api_cxx/seq_open.html @@ -1,5 +1,5 @@ -<!--$Id: seq_open.so,v 1.7 2004/09/28 15:04:22 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: seq_open.so,v 1.9 2005/01/20 01:15:15 ubell Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -44,10 +44,6 @@ the persistent sequence data. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>Enclose the DbSequence::open call within a transaction. If the call -succeeds, the open operation will be recoverable. If the -<a href="../api_cxx/env_open.html#DB_CREATE">DB_CREATE</a> flag is specified and the call fails, no sequence will -have been created. <dt><a name="DB_CREATE">DB_CREATE</a><dd>Create the sequence. If the sequence does not already exist and the DB_CREATE flag is not specified, the DbSequence::open will fail. <dt><a name="DB_EXCL">DB_EXCL</a><dd>Return an error if the sequence already exists. The <a href="../api_cxx/db_open.html#DB_EXCL">DB_EXCL</a> @@ -55,13 +51,20 @@ flag is only meaningful when specified with the <a href="../api_cxx/env_open.htm flag. <dt><a name="DB_THREAD">DB_THREAD</a><dd>Cause the <a href="../api_cxx/seq_class.html">DbSequence</a> handle returned by DbSequence::open to be <i>free-threaded</i>; that is, usable by multiple threads within a -single address space. +single address space. Note that if multiple threads create multiple +sequences using the same database handle that handle must have been +opened specifying <a name="DB_THREAD">DB_THREAD</a>. </dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -(other than by specifying the DB_AUTO_COMMIT flag), -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. Note that transactionally protected operations on a <a href="../api_cxx/seq_class.html">DbSequence</a> -handle require the <a href="../api_cxx/seq_class.html">DbSequence</a> handle itself be transactionally +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. Transactionally protected operations on a <a href="../api_cxx/seq_class.html">DbSequence</a> handle +require the <a href="../api_cxx/seq_class.html">DbSequence</a> handle itself be transactionally protected during its open if the open creates the sequence. </dl> <hr size=1 noshade> @@ -70,7 +73,7 @@ protected during its open if the open creates the sequence. <h3>Parameters</h3> <dl compact> <dt><b>dbp</b><dd>The <b>dbp</b> parameter references memory into which -a pointer to the database handle is copied. +a pointer to the database handle is copied. </dl> <p>The DbSequence::get_dbp method may be called at any time during the life of the application.</p> @@ -85,7 +88,7 @@ failure, and returns 0 on success. <h3>Parameters</h3> <dl compact> <dt><b>key</b><dd>The <b>key</b> parameter references memory into which -a pointer to the key data is copied. +a pointer to the key data is copied. </dl> <p>The DbSequence::get_key method may be called at any time during the life of the application.</p> @@ -103,6 +106,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_remove.html b/db/docs/api_cxx/seq_remove.html index d915c7777..3c79239de 100644 --- a/db/docs/api_cxx/seq_remove.html +++ b/db/docs/api_cxx/seq_remove.html @@ -1,5 +1,5 @@ -<!--$Id: seq_remove.so,v 1.5 2004/08/18 02:34:52 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: seq_remove.so,v 1.6 2004/12/16 19:13:04 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -42,14 +42,19 @@ failure, and returns 0 on success. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_AUTO_COMMIT">DB_AUTO_COMMIT</a><dd>The remove -will be enclosed in a transaction and will be recoverable. -<dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>If a DB_AUTO_COMMIT -triggers a transaction, do not synchronously flush the log. +<dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>If the operation is implicitly transaction protected (the <b>txnid</b> +argument is NULL but the operation occurs to a transactional database), +do not synchronously flush the log when the transaction commits. </dl> -<dt><b>txnid</b><dd>If the operation is to be transaction-protected, -the <b>txnid</b> parameter is a transaction handle returned from -<a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; otherwise, NULL. +<dt><b>txnid</b><dd>If the operation is part of an application-specified +transaction, the <b>txnid</b> parameter is a transaction handle +returned from <a href="../api_cxx/txn_begin.html">DbEnv::txn_begin</a>; if the operation is part of a Berkeley DB Concurrent Data Store +group, the <b>txnid</b> parameter is a handle returned from +<a href="../api_cxx/env_cdsgroup_begin.html">DbEnv::cdsgroup_begin</a>; otherwise NULL. If no transaction handle is +specified, but the +operation occurs in a transactional +database, +the operation will be implicitly transaction protected. </dl> <h3>Errors</h3> <p>The DbSequence::remove method @@ -70,6 +75,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_set_cachesize.html b/db/docs/api_cxx/seq_set_cachesize.html index 1f737b6c8..effe7d110 100644 --- a/db/docs/api_cxx/seq_set_cachesize.html +++ b/db/docs/api_cxx/seq_set_cachesize.html @@ -1,5 +1,5 @@ <!--$Id: seq_set_cachesize.so,v 1.8 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -75,6 +75,6 @@ current cache size in <b>sizep</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_set_flags.html b/db/docs/api_cxx/seq_set_flags.html index 6f18d3fc3..67070d33f 100644 --- a/db/docs/api_cxx/seq_set_flags.html +++ b/db/docs/api_cxx/seq_set_flags.html @@ -1,5 +1,5 @@ <!--$Id: seq_set_flags.so,v 1.7 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -88,6 +88,6 @@ current flags in <b>flagsp</b>. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_set_range.html b/db/docs/api_cxx/seq_set_range.html index 9b1bb0270..1f38d71ed 100644 --- a/db/docs/api_cxx/seq_set_range.html +++ b/db/docs/api_cxx/seq_set_range.html @@ -1,5 +1,5 @@ <!--$Id: seq_set_range.so,v 1.6 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -78,6 +78,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/seq_stat.html b/db/docs/api_cxx/seq_stat.html index 2cfef1099..7e385c2eb 100644 --- a/db/docs/api_cxx/seq_stat.html +++ b/db/docs/api_cxx/seq_stat.html @@ -1,5 +1,5 @@ <!--$Id: seq_stat.so,v 1.8 2004/09/07 15:37:41 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -95,6 +95,6 @@ of the following values: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_abort.html b/db/docs/api_cxx/txn_abort.html index 607a07912..f768d09ee 100644 --- a/db/docs/api_cxx/txn_abort.html +++ b/db/docs/api_cxx/txn_abort.html @@ -1,5 +1,5 @@ <!--$Id: txn_abort.so,v 10.39 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -52,6 +52,6 @@ failure, and returns 0 on success. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_begin.html b/db/docs/api_cxx/txn_begin.html index 2cfc96707..08c49fbfe 100644 --- a/db/docs/api_cxx/txn_begin.html +++ b/db/docs/api_cxx/txn_begin.html @@ -1,5 +1,5 @@ -<!--$Id: txn_begin.so,v 10.72 2004/08/18 02:31:21 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: txn_begin.so,v 10.78 2006/09/13 14:30:57 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -35,7 +35,7 @@ handle.</p> <p><b>Note: Transactions may only span threads if they do so serially; that is, each transaction must be active in only a single thread of control at a time. This restriction holds for parents of nested -transactions as well; not two children may be concurrently active in +transactions as well; no two children may be concurrently active in more than one thread of control at any one time.</b></p> <p><b>Note: Cursors may not span transactions; that is, each cursor must be opened and closed within a single transaction.</b></p> @@ -53,13 +53,14 @@ failure, and returns 0 on success. <dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one or more of the following values: <dl compact> -<dt><a name="DB_DEGREE_2">DB_DEGREE_2</a><dd>This transaction will have degree 2 isolation. This provides for cursor +<dt><a name="DB_READ_COMMITTED">DB_READ_COMMITTED</a><dd>This transaction will have degree 2 isolation. This provides for cursor stability but not repeatable reads. Data items which have been previously read by this transaction may be deleted or modified by other transactions before this transaction completes. -<dt><a name="DB_DIRTY_READ">DB_DIRTY_READ</a><dd>All read operations performed by the transaction may read modified but -not yet committed data. Silently ignored if the <a href="../api_cxx/db_open.html#DB_DIRTY_READ">DB_DIRTY_READ</a> -flag was not specified when the underlying database was opened. +<dt><a name="DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a><dd>This transaction will have degree 1 isolation. Read operations +performed by the transaction may read modified but not yet committed +data. Silently ignored if the <a href="../api_cxx/db_open.html#DB_READ_UNCOMMITTED">DB_READ_UNCOMMITTED</a> flag was not +specified when the underlying database was opened. <dt><a name="DB_TXN_NOSYNC">DB_TXN_NOSYNC</a><dd>Do not synchronously flush the log when this transaction commits or prepares. This means the transaction will exhibit the ACI (atomicity, consistency, and isolation) properties, but not D (durability); that is, @@ -72,6 +73,14 @@ overrides that setting.</p> of this transaction, cause the operation to return DB_LOCK_DEADLOCK or throw a <a href="../api_cxx/deadlock_class.html">DbDeadlockException</a> immediately instead of blocking on the lock. +<dt><a name="DB_TXN_SNAPSHOT">DB_TXN_SNAPSHOT</a><dd>This transaction will execute with <a href="../ref/transapp/read.html">snapshot isolation</a>. For databases with the <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> +flag set, data values will be read as they are when the transaction +begins, without taking read locks. Silently ignored for operations on +databases with <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a> not set on the underlying +database (read locks are acquired). +<p>The error <a name="DB_LOCK_DEADLOCK">DB_LOCK_DEADLOCK</a> will be returned from update +operations if a snapshot transaction attempts to update data +which was modified after the snapshot transaction read it.</p> <dt><a name="DB_TXN_SYNC">DB_TXN_SYNC</a><dd>Synchronously flush the log when this transaction commits or prepares. This means the transaction will exhibit all of the ACID (atomicity, consistency, isolation, and durability) properties. @@ -100,6 +109,6 @@ throw a DbMemoryException.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_checkpoint.html b/db/docs/api_cxx/txn_checkpoint.html index 2668fc211..d5038f0c2 100644 --- a/db/docs/api_cxx/txn_checkpoint.html +++ b/db/docs/api_cxx/txn_checkpoint.html @@ -1,5 +1,5 @@ -<!--$Id: txn_checkpoint.so,v 10.48 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: txn_checkpoint.so,v 10.49 2005/03/02 22:57:15 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -27,8 +27,10 @@ DbEnv::txn_checkpoint(u_int32_t kbyte, u_int32_t min, u_int32_t flags) const; </pre></h3> <hr size=1 noshade> <h3>Description: DbEnv::txn_checkpoint</h3> -<p>The DbEnv::txn_checkpoint method flushes the underlying memory pool, writes -a checkpoint record to the log, and then flushes the log.</p> +<p>If there has been any logging activity in the database environment since +the last checkpoint, the DbEnv::txn_checkpoint method flushes the underlying +memory pool, writes a checkpoint record to the log, and then flushes the +log.</p> <p>The DbEnv::txn_checkpoint method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on @@ -67,6 +69,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_class.html b/db/docs/api_cxx/txn_class.html index ffc57889d..73311cb46 100644 --- a/db/docs/api_cxx/txn_class.html +++ b/db/docs/api_cxx/txn_class.html @@ -1,5 +1,5 @@ -<!--$Id: txn_class.so,v 10.24 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: txn_class.so,v 10.25 2005/05/17 15:25:50 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -33,7 +33,7 @@ public: </pre></h3> <hr size=1 noshade> <h3>Description: DbTxn</h3> -<p>The DbTxn object is the handle for a transaction. Methods off +<p>The DbTxn object is the handle for a transaction. Methods of the DbTxn handle are used to configure, abort and commit the transaction. DbTxn handles are provided to <a href="../api_cxx/db_class.html">Db</a> methods in order to transactionally protect those database operations.</p> @@ -70,6 +70,6 @@ calls in a purely C++ application.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_commit.html b/db/docs/api_cxx/txn_commit.html index 11c7be811..be53f7096 100644 --- a/db/docs/api_cxx/txn_commit.html +++ b/db/docs/api_cxx/txn_commit.html @@ -1,5 +1,5 @@ <!--$Id: txn_commit.so,v 10.49 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -80,6 +80,6 @@ method overrides both of those settings.</p> <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_discard.html b/db/docs/api_cxx/txn_discard.html index 9393f96b8..c3f743bec 100644 --- a/db/docs/api_cxx/txn_discard.html +++ b/db/docs/api_cxx/txn_discard.html @@ -1,5 +1,5 @@ <!--$Id: txn_discard.so,v 10.16 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -66,6 +66,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_id.html b/db/docs/api_cxx/txn_id.html index cbd797fbf..9f2da7876 100644 --- a/db/docs/api_cxx/txn_id.html +++ b/db/docs/api_cxx/txn_id.html @@ -1,5 +1,5 @@ <!--$Id: txn_id.so,v 10.21 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -40,6 +40,6 @@ to the <a href="../api_cxx/lock_get.html">DbEnv::lock_get</a> or <a href="../api <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_list.html b/db/docs/api_cxx/txn_list.html index 99da21d0c..f25365c96 100644 --- a/db/docs/api_cxx/txn_list.html +++ b/db/docs/api_cxx/txn_list.html @@ -1,5 +1,5 @@ <!--$Id: txn_list.so,v 1.3 2004/11/02 20:04:11 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -10,7 +10,7 @@ </head> <body bgcolor=white> <h3 align=center>Berkeley DB: Transaction Subsystem and Related Methods</h3> -<!--$Id: m4.methods,v 1.5 2004/11/03 15:52:02 bostic Exp $--> +<!--$Id: m4.methods,v 1.6 2005/03/16 21:26:51 bostic Exp $--> <table border=1 align=center> <tr><th>Transaction Subsystem and Related Methods</th><th>Description</th></tr> <!--DbEnv::txn_checkpoint--><tr><td><a href="../api_cxx/txn_checkpoint.html">DbEnv::txn_checkpoint</a></td><td>Checkpoint the transaction subsystem</td></tr> @@ -28,8 +28,9 @@ <!--DbTxn::discard--><tr><td><a href="../api_cxx/txn_discard.html">DbTxn::discard</a></td><td>Discard a prepared but not resolved transaction handle</td></tr> <!--DbTxn::id--><tr><td><a href="../api_cxx/txn_id.html">DbTxn::id</a></td><td>Return a transaction's ID</td></tr> <!--DbTxn::prepare--><tr><td><a href="../api_cxx/txn_prepare.html">DbTxn::prepare</a></td><td>Prepare a transaction for commit</td></tr> +<!--DbTxn::set_name--><tr><td><a href="../api_cxx/txn_set_name.html">DbTxn::set_name</a></td><td>Associate a string with a transaction</td></tr> <!--DbTxn::set_timeout--><tr><td><a href="../api_cxx/txn_set_timeout.html">DbTxn::set_timeout</a></td><td>Set transaction timeout</td></tr> </table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_prepare.html b/db/docs/api_cxx/txn_prepare.html index 01448a95c..0fba00631 100644 --- a/db/docs/api_cxx/txn_prepare.html +++ b/db/docs/api_cxx/txn_prepare.html @@ -1,5 +1,5 @@ <!--$Id: txn_prepare.so,v 10.35 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -62,6 +62,6 @@ transactions must be resolved. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_recover.html b/db/docs/api_cxx/txn_recover.html index 4d30ae730..9fa7649f9 100644 --- a/db/docs/api_cxx/txn_recover.html +++ b/db/docs/api_cxx/txn_recover.html @@ -1,5 +1,5 @@ <!--$Id: txn_recover.so,v 10.25 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -69,7 +69,7 @@ array. starting where the last call to DbEnv::txn_recover left off. </dl> <dt><b>preplist</b><dd>The <b>preplist</b> parameter references memory into which - the list of transactions to be resolved by the application is copied. + the list of transactions to be resolved by the application is copied. </dl> <hr size=1 noshade> <h3>Class</h3> @@ -80,6 +80,6 @@ starting where the last call to DbEnv::txn_recover left off. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_set_name.html b/db/docs/api_cxx/txn_set_name.html new file mode 100644 index 000000000..ab365560a --- /dev/null +++ b/db/docs/api_cxx/txn_set_name.html @@ -0,0 +1,78 @@ +<!--$Id: txn_set_name.so,v 10.2 2005/05/17 04:01:01 mjc Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> +<!--All rights reserved.--> +<!--See the file LICENSE for redistribution information.--> +<html> +<head> +<title>Berkeley DB: DbTxn::set_name</title> +<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> +<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> +</head> +<body bgcolor=white> +<table width="100%"><tr valign=top> +<td> +<h3>DbTxn::set_name</h3> +</td> +<td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a> +<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> +</tr></table> +<hr size=1 noshade> +<tt> +<h3><pre> +#include <db_cxx.h> +<p> +int +DbTxn::set_name(const char *name); +<p> +int +DbTxn::get_name(const char **namep); +</pre></h3> +<hr size=1 noshade> +<h3>Description: DbTxn::set_name</h3> +<p>The DbTxn::set_name method associates the specified string with the +transaction. The string is returned by <a href="../api_cxx/txn_stat.html">DbEnv::txn_stat</a> and displayed +by <a href="../api_cxx/txn_stat.html">DbEnv::txn_stat_print</a>.</p> +<p>If the database environment has been configured for logging and the +Berkeley DB library was configured with +<a href="../ref/build_unix/conf.html#--enable-diagnostic">--enable-diagnostic</a>, a debugging log record is written including the +transaction ID and the name.</p> +<p>The DbTxn::set_name method may be called at any time during the life of the +application.</p> +<p>The DbTxn::set_name 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>name</b><dd>The <b>name</b> parameter is the string to associate with the +transaction. +</dl> +<hr size=1 noshade> +<h3>Description: DbTxn::get_name</h3> +<p>The DbTxn::get_name method returns the string associated with the transaction.</p> +<p>The DbTxn::get_name method may be called at any time during the life of the +application.</p> +<p>The DbTxn::get_name 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. +</p> +<h3>Parameters</h3> +<dl compact> +<dt><b>namep</b><dd>The DbTxn::get_name method returns a reference to the +string associated with the transaction in <b>namep</b>. +</dl> +<hr size=1 noshade> +<h3>Class</h3> +<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/txn_class.html">DbTxn</a> +<h3>See Also</h3> +<a href="../api_cxx/txn_list.html">Transaction Subsystem and Related Methods</a> +</tt> +<table width="100%"><tr><td><br></td><td align=right> +<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> +</td></tr></table> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> +</body> +</html> diff --git a/db/docs/api_cxx/txn_set_timeout.html b/db/docs/api_cxx/txn_set_timeout.html index f61034af2..3e1efa18e 100644 --- a/db/docs/api_cxx/txn_set_timeout.html +++ b/db/docs/api_cxx/txn_set_timeout.html @@ -1,5 +1,5 @@ -<!--$Id: txn_set_timeout.so,v 10.20 2004/08/13 03:39:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: txn_set_timeout.so,v 10.21 2005/05/20 15:07:45 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -29,8 +29,8 @@ DbTxn::set_timeout(db_timeout_t timeout, u_int32_t flags); <h3>Description: DbTxn::set_timeout</h3> <p>The DbTxn::set_timeout method sets timeout values for locks or transactions for the specified transaction.</p> -<p>Timeouts are checked whenever a thread of control blocks on a lock or -when deadlock detection is performed. In the case of +<p>All Timeouts are checked whenever a thread of control blocks on a lock +or when deadlock detection is performed. In the case of DB_SET_LOCK_TIMEOUT, the timeout is for any single lock request. In the case of DB_SET_TXN_TIMEOUT, the timeout is for the life of the transaction. As timeouts are only checked when the lock request @@ -78,6 +78,6 @@ invalid flag value or parameter was specified. <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> diff --git a/db/docs/api_cxx/txn_stat.html b/db/docs/api_cxx/txn_stat.html index f615203f3..d2da587ed 100644 --- a/db/docs/api_cxx/txn_stat.html +++ b/db/docs/api_cxx/txn_stat.html @@ -1,5 +1,5 @@ -<!--$Id: txn_stat.so,v 10.61 2004/09/28 17:57:03 bostic Exp $--> -<!--Copyright 1997-2004 by Sleepycat Software, Inc.--> +<!--$Id: txn_stat.so,v 10.66 2006/08/22 14:28:22 bostic Exp $--> +<!--Copyright 1997-2006 by Oracle Corporation--> <!--All rights reserved.--> <!--See the file LICENSE for redistribution information.--> <html> @@ -49,26 +49,45 @@ since the Epoch, returned by the IEEE/ANSI Std 1003.1 (POSIX) <b>time</b> functi <dt>u_int32_t st_last_txnid;<dd>The last transaction ID allocated. <dt>u_int32_t st_maxtxns;<dd>The maximum number of active transactions configured. <dt>u_int32_t st_nactive;<dd>The number of transactions that are currently active. +<dt>u_int32_t st_nsnapshot;<dd>The number of transactions on the snapshot list. These are transactions +which modified a database opened with <a href="../api_cxx/db_open.html#DB_MULTIVERSION">DB_MULTIVERSION</a>, +and which have committed or aborted, but the copies of pages they +created are still in the cache. <dt>u_int32_t st_maxnactive;<dd>The maximum number of active transactions at any one time. +<dt>u_int32_t st_maxnsnapshot;<dd>The maximum number of transactions on the snapshot list at any one time. <dt>u_int32_t st_nbegins;<dd>The number of transactions that have begun. <dt>u_int32_t st_naborts;<dd>The number of transactions that have aborted. <dt>u_int32_t st_ncommits;<dd>The number of transactions that have committed. <dt>u_int32_t st_nrestores;<dd>The number of transactions that have been restored. -<dt>roff_t st_regsize;<dd>The size of the region, in bytes. +<dt>roff_t st_regsize;<dd>The size of the transaction region, in bytes. <dt>u_int32_t st_region_wait;<dd>The number of times that a thread of control was forced to wait before -obtaining the region lock. +obtaining the transaction region mutex. <dt>u_int32_t st_region_nowait;<dd>The number of times that a thread of control was able to obtain -the region lock without waiting. +the transaction region mutex without waiting. <dt>DB_TXN_ACTIVE *st_txnarray;<dd>A pointer to an array of <b>st_nactive</b> DB_TXN_ACTIVE structures, describing the currently active transactions. The following fields of the DB_TXN_ACTIVE structure will be filled in: <dl compact> <dt>u_int32_t txnid;<dd>The transaction ID of the transaction. <dt>u_int32_t parentid;<dd>The transaction ID of the parent transaction (or 0, if no parent). +<dt>pid_t pid;<dd>The process ID of the originator of the transaction. +<dt>uintmax_t tid;<dd>The thread of control ID of the originator of the transaction. <dt>DbLsn lsn;<dd>The current log sequence number when the transaction was begun. -<dt>u_int32_t xa_status;<dd>If the transaction is an XA transaction, the status of the transaction, -otherwise 0. -<dt>u_int8_t xid[DB_XIDDATASIZE];<dd>If the transaction is an XA transaction, the transaction's XA ID. +<dt>DbLsn read_lsn;<dd>The log sequence number of reads for snapshot transactions. +<dt>u_int32_t mvcc_ref;<dd>The number of buffer copies created by this transaction that remain in cache. +<dt>u_int32_t status;<dd>One of the following list of constants: TXN_ABORTED, TXN_COMMITTED, +TXN_PREPARED, TXN_RUNNING. +<dt>u_int32_t xa_status;<dd>If the transaction is an XA transaction, the <b>xa_status</b> of the +transaction will be one of the following list of constants: +TXN_XA_ABORTED, TXN_XA_DEADLOCKED, TXN_XA_ENDED, TXN_XA_PREPARED, +TXN_XA_STARTED, or TXN_XA_SUSPENDED. Otherwise, the <b>xa_status</b> +will be 0. +<dt>u_int8_t xid[DB_XIDDATASIZE];<dd>If the transaction is an XA transaction, the transaction's XA ID. If +the transaction was prepared separately from the XA interfaces, the +transaction's Global ID. Otherwise, the <b>xid</b> contents are +undefined. +<dt>char name[];<dd>If a name was specified for the transaction, up to the first 50 bytes +of that name, followed by a nul termination byte. </dl> </dl> <p>The DbEnv::txn_stat method @@ -84,7 +103,7 @@ the following value: <dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after returning their values. </dl> <dt><b>statp</b><dd>The <b>statp</b> parameter references memory into which -a pointer to the allocated statistics structure is copied. +a pointer to the allocated statistics structure is copied. </dl> <h3>Errors</h3> <p>The DbEnv::txn_stat method @@ -98,7 +117,7 @@ invalid flag value or parameter was specified. </dl> <hr size=1 noshade> <h3>Description: DbEnv::txn_stat_print</h3> -<p>The DbEnv::txn_stat_print method returns the +<p>The DbEnv::txn_stat_print method displays the transaction subsystem statistical information, as described for the DbEnv::txn_stat method. The information is printed to a specified output channel (see the <a href="../api_cxx/env_set_msgfile.html">DbEnv::set_msgfile</a> method for more information), or passed to an @@ -113,10 +132,11 @@ failure, and returns 0 on success. </p> <h3>Parameters</h3> <dl compact> -<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or -the following value: +<dt><b>flags</b><dd>The <b>flags</b> parameter must be set to 0 or by bitwise inclusively <b>OR</b>'ing together one +or more of the following values: <dl compact> <dt><a name="DB_STAT_ALL">DB_STAT_ALL</a><dd>Display all available information. +<dt><a name="DB_STAT_CLEAR">DB_STAT_CLEAR</a><dd>Reset statistics after displaying their values. </dl> </dl> <hr size=1 noshade> @@ -128,6 +148,6 @@ the following value: <table width="100%"><tr><td><br></td><td align=right> <a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> </td></tr></table> -<p><font size=1><a href="../sleepycat/legal.html">Copyright (c) 1996-2004</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font> +<p><font size=1>Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.</font> </body> </html> |