diff options
| author | Lorry Tar Creator <lorry-tar-importer@baserock.org> | 2015-02-17 17:25:57 +0000 |
|---|---|---|
| committer | <> | 2015-03-17 16:26:24 +0000 |
| commit | 780b92ada9afcf1d58085a83a0b9e6bc982203d1 (patch) | |
| tree | 598f8b9fa431b228d29897e798de4ac0c1d3d970 /docs/api_reference/C/envopen.html | |
| parent | 7a2660ba9cc2dc03a69ddfcfd95369395cc87444 (diff) | |
| download | berkeleydb-master.tar.gz | |
Diffstat (limited to 'docs/api_reference/C/envopen.html')
| -rw-r--r-- | docs/api_reference/C/envopen.html | 60 |
1 files changed, 40 insertions, 20 deletions
diff --git a/docs/api_reference/C/envopen.html b/docs/api_reference/C/envopen.html index 477276a8..c1a7cb52 100644 --- a/docs/api_reference/C/envopen.html +++ b/docs/api_reference/C/envopen.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> @@ -76,7 +76,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp59652824"></a>Parameters</h3> + <h3 class="title"><a id="idp1286232"></a>Parameters</h3> </div> </div> </div> @@ -84,7 +84,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59651280"></a>db_home</h4> + <h4 class="title"><a id="idp1290056"></a>db_home</h4> </div> </div> </div> @@ -110,7 +110,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59658896"></a>flags</h4> + <h4 class="title"><a id="idp1298536"></a>flags</h4> </div> </div> </div> @@ -361,6 +361,9 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <p> Lock shared Berkeley DB environment files and memory-mapped databases into memory. + If the operating systems does not support the + <code class="function">mlock()</code> system call, + then this flag has no effect. </p> </li> <li> @@ -499,13 +502,15 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <p> Cause the <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> - handle returned by <code class="methodname">DB_ENV->open()</code> to be <span class="emphasis"><em>free-threaded;</em></span> that is, + handle returned by + <code class="methodname">DB_ENV->open()</code> to be + <span class="emphasis"><em>free-threaded;</em></span> that is, concurrently usable by multiple threads in the - address space. The <code class="literal">DB_THREAD </code> - flag should be specified if the - <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> handle will be - concurrently used by more than one thread in the - process, or if any + address space. The + <code class="literal">DB_THREAD </code> flag should be + specified if the <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> + handle will be concurrently used by more than + one thread in the process, or if any <a class="link" href="db.html" title="Chapter 2. The DB Handle">DB</a> handles opened in the scope of the <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> handle will be @@ -513,7 +518,22 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre process. </p> <p> - This flag is required when using the Replication Manager. + If this flag is specified, then any database + opened using this environment handle will also + be free-threaded. + </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> + <p> + This flag is required when using the + Replication Manager. </p> <p> You can also specify this flag in the <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> @@ -536,7 +556,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59682816"></a>mode</h4> + <h4 class="title"><a id="idp1319296"></a>mode</h4> </div> </div> </div> @@ -565,7 +585,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp59633048"></a>Errors</h3> + <h3 class="title"><a id="idp1271864"></a>Errors</h3> </div> </div> </div> @@ -581,7 +601,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59716256"></a>DB_RUNRECOVERY</h4> + <h4 class="title"><a id="idp1345040"></a>DB_RUNRECOVERY</h4> </div> </div> </div> @@ -596,7 +616,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59674432"></a>DB_VERSION_MISMATCH</h4> + <h4 class="title"><a id="idp1329752"></a>DB_VERSION_MISMATCH</h4> </div> </div> </div> @@ -609,7 +629,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59728944"></a>EAGAIN</h4> + <h4 class="title"><a id="idp1369440"></a>EAGAIN</h4> </div> </div> </div> @@ -621,7 +641,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59729368"></a>EINVAL</h4> + <h4 class="title"><a id="idp1369864"></a>EINVAL</h4> </div> </div> </div> @@ -639,7 +659,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp59684168"></a>ENOENT</h4> + <h4 class="title"><a id="idp1322840"></a>ENOENT</h4> </div> </div> </div> @@ -652,7 +672,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp59715200"></a>Class</h3> + <h3 class="title"><a id="idp1353904"></a>Class</h3> </div> </div> </div> @@ -664,7 +684,7 @@ DB_ENV->open(DB_ENV *dbenv, char *db_home, u_int32_t flags, int mode); </pre <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp59715432"></a>See Also</h3> + <h3 class="title"><a id="idp1353056"></a>See Also</h3> </div> </div> </div> |