diff options
Diffstat (limited to 'docs/api_reference/C/dbopen.html')
| -rw-r--r-- | docs/api_reference/C/dbopen.html | 84 |
1 files changed, 59 insertions, 25 deletions
diff --git a/docs/api_reference/C/dbopen.html b/docs/api_reference/C/dbopen.html index d29f9821..1cc23c2d 100644 --- a/docs/api_reference/C/dbopen.html +++ b/docs/api_reference/C/dbopen.html @@ -14,7 +14,7 @@ <body> <div xmlns="" class="navheader"> <div class="libver"> - <p>Library Version 11.2.5.3</p> + <p>Library Version 12.1.6.1</p> </div> <table width="100%" summary="Navigation header"> <tr> @@ -83,7 +83,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp57876872"></a>Parameters</h3> + <h3 class="title"><a id="idm2755280"></a>Parameters</h3> </div> </div> </div> @@ -91,7 +91,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57870880"></a>txnid</h4> + <h4 class="title"><a id="idm2558624"></a>txnid</h4> </div> </div> </div> @@ -122,7 +122,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57881520"></a>file</h4> + <h4 class="title"><a id="idm566008"></a>file</h4> </div> </div> </div> @@ -148,7 +148,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57822920"></a>database</h4> + <h4 class="title"><a id="idm5743952"></a>database</h4> </div> </div> </div> @@ -160,7 +160,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, in a <span class="bold"><strong>file</strong></span> that was not initially created using a <span class="bold"><strong>database</strong></span> name. Further, the <span class="bold"><strong>database</strong></span> parameter is - not supported by the Queue format. Finally, when opening multiple + not supported by the Queue or Heap format. Finally, when opening multiple databases in the same physical file, it is important to consider locking and memory cache issues; see <a href="../../programmer_reference/am_opensub.html" class="olink">Opening multiple databases in a single file</a> @@ -186,7 +186,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57877688"></a>type</h4> + <h4 class="title"><a id="idm4402192"></a>type</h4> </div> </div> </div> @@ -213,7 +213,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57877896"></a>flags</h4> + <h4 class="title"><a id="idm7801896"></a>flags</h4> </div> </div> </div> @@ -322,13 +322,33 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <code class="methodname">DB->open()</code> to be <span class="emphasis"><em>free-threaded</em></span>; that is, concurrently usable by multiple threads in the - address space. + address space. You should use this flag only in + the absence of an encompassing environment. + </p> + <p> + When opening the database within an + encompassing environment, the database inherits + the state of this flag from the environment. + That is, if the encompassing environment is + threaded, then the database will also be + threaded. Note that it is an error to specify + this flag to the database open if the + encompassing environment is not threaded. </p> <p> Note that this flag is incompatible with the <a class="link" href="dbset_lk_exclusive.html" title="DB->set_lk_exclusive()">DB->set_lk_exclusive()</a> method. </p> + <p> + Be aware that enabling this flag will serialize + calls to DB when using the handle across + threads. If concurrent scaling is important to + your application we recommend opening separate + handles for each thread (and not specifying + this flag), rather than sharing handles between + threads. + </p> </li> <li> <p><a id="open_DB_TRUNCATE"></a> @@ -354,7 +374,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57909672"></a>mode</h4> + <h4 class="title"><a id="idm4443912"></a>mode</h4> </div> </div> </div> @@ -378,7 +398,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp57884624"></a>Environment Variables</h3> + <h3 class="title"><a id="idm3874280"></a>Environment Variables</h3> </div> </div> </div> @@ -390,8 +410,8 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <p> <code class="methodname">DB->open()</code> is affected by any database directory specified using the - <a class="xref" href="envset_data_dir.html" title="DB_ENV->set_data_dir()">DB_ENV->set_data_dir()</a> - method, or by setting the "set_data_dir" string in the + <a class="xref" href="envadd_data_dir.html" title="DB_ENV->add_data_dir()">DB_ENV->add_data_dir()</a> + method, or by setting the "add_data_dir" string in the environment's <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file. </p> <div class="itemizedlist"> @@ -416,7 +436,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp57929304"></a>Errors</h3> + <h3 class="title"><a id="idm2785760"></a>Errors</h3> </div> </div> </div> @@ -432,7 +452,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57905384"></a>DB_LOCK_DEADLOCK</h4> + <h4 class="title"><a id="idm7902288"></a>DB_LOCK_DEADLOCK</h4> </div> </div> </div> @@ -445,7 +465,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57873096"></a>DB_LOCK_NOTGRANTED</h4> + <h4 class="title"><a id="idm4619576"></a>DB_LOCK_NOTGRANTED</h4> </div> </div> </div> @@ -465,7 +485,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57882328"></a>ENOENT</h4> + <h4 class="title"><a id="idm6992304"></a>ENOENT</h4> </div> </div> </div> @@ -477,7 +497,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57932168"></a>ENOENT</h4> + <h4 class="title"><a id="idm5740896"></a>ENOENT</h4> </div> </div> </div> @@ -489,7 +509,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57926520"></a>DB_OLD_VERSION</h4> + <h4 class="title"><a id="idm3251088"></a>DB_OLD_VERSION</h4> </div> </div> </div> @@ -501,7 +521,21 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57933392"></a>EEXIST</h4> + <h4 class="title"><a id="idm4498328"></a>DB_META_CHKSUM_FAIL</h4> + </div> + </div> + </div> + <p> + Checksum mismatch detected on a database metadata page. + Either the database is corrupted or the file is not a Berkeley DB + database file. + </p> + </div> + <div class="sect3" lang="en" xml:lang="en"> + <div class="titlepage"> + <div> + <div> + <h4 class="title"><a id="idm4131928"></a>EEXIST</h4> </div> </div> </div> @@ -514,7 +548,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57927856"></a>EINVAL</h4> + <h4 class="title"><a id="idm5835112"></a>EINVAL</h4> </div> </div> </div> @@ -546,7 +580,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57926736"></a> DB_REP_HANDLE_DEAD</h4> + <h4 class="title"><a id="idm2508656"></a> DB_REP_HANDLE_DEAD</h4> </div> </div> </div> @@ -565,7 +599,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp57907680"></a>DB_REP_LOCKOUT</h4> + <h4 class="title"><a id="idm3915768"></a>DB_REP_LOCKOUT</h4> </div> </div> </div> @@ -578,7 +612,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp57906648"></a>Class</h3> + <h3 class="title"><a id="idm5478568"></a>Class</h3> </div> </div> </div> @@ -590,7 +624,7 @@ DB->open(DB *db, DB_TXN *txnid, const char *file, <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp57838264"></a>See Also</h3> + <h3 class="title"><a id="idm7773240"></a>See Also</h3> </div> </div> </div> |