summaryrefslogtreecommitdiff
path: root/docs/api_reference/C/repstart.html
diff options
context:
space:
mode:
authorLorry Tar Creator <lorry-tar-importer@baserock.org>2015-02-17 17:25:57 +0000
committer <>2015-03-17 16:26:24 +0000
commit780b92ada9afcf1d58085a83a0b9e6bc982203d1 (patch)
tree598f8b9fa431b228d29897e798de4ac0c1d3d970 /docs/api_reference/C/repstart.html
parent7a2660ba9cc2dc03a69ddfcfd95369395cc87444 (diff)
downloadberkeleydb-master.tar.gz
Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz.HEADdb-6.1.23master
Diffstat (limited to 'docs/api_reference/C/repstart.html')
-rw-r--r--docs/api_reference/C/repstart.html47
1 files changed, 28 insertions, 19 deletions
diff --git a/docs/api_reference/C/repstart.html b/docs/api_reference/C/repstart.html
index c8df279d..039b1de9 100644
--- a/docs/api_reference/C/repstart.html
+++ b/docs/api_reference/C/repstart.html
@@ -8,20 +8,20 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB C API Reference" />
<link rel="up" href="rep.html" title="Chapter 10.  Replication Methods" />
- <link rel="prev" href="reptransport.html" title="DB_ENV-&gt;rep_set_transport()" />
+ <link rel="prev" href="repset_view.html" title="DB_ENV-&gt;rep_set_view()" />
<link rel="next" href="repstat.html" title="DB_ENV-&gt;rep_stat()" />
</head>
<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>
<th colspan="3" align="center">DB_ENV-&gt;rep_start()</th>
</tr>
<tr>
- <td width="20%" align="left"><a accesskey="p" href="reptransport.html">Prev</a> </td>
+ <td width="20%" align="left"><a accesskey="p" href="repset_view.html">Prev</a> </td>
<th width="60%" align="center">Chapter 10. 
Replication Methods
</th>
@@ -59,16 +59,20 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
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. If master leases are in use, this method cannot be
- used to appoint a master, and should only be used to configure a database
- environment as a master as the result of an election.
+ master present. Replication view environments are always read-only
+ and can never become master environments. If master leases are in
+ use, this method cannot be used to appoint a master, and should only
+ be used to configure a database environment as a master as the result
+ of an election.
</p>
<p>
The enclosing database environment must already have been opened by
calling the <a class="xref" href="envopen.html" title="DB_ENV-&gt;open()">DB_ENV-&gt;open()</a> method and must
already have been configured to send replication messages by calling
the <a class="xref" href="reptransport.html" title="DB_ENV-&gt;rep_set_transport()">DB_ENV-&gt;rep_set_transport()</a>
- method.
+ method. If you are starting a view, you must have called the
+ <a class="xref" href="repset_view.html" title="DB_ENV-&gt;rep_set_view()">DB_ENV-&gt;rep_set_view()</a> method
+ before opening the enclosing database environment.
</p>
<p>
The <code class="methodname">DB_ENV-&gt;rep_start()</code> <span>
@@ -82,7 +86,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp62182552"></a>Parameters</h3>
+ <h3 class="title"><a id="idp3883320"></a>Parameters</h3>
</div>
</div>
</div>
@@ -90,7 +94,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp62152824"></a>cdata</h4>
+ <h4 class="title"><a id="idp3875784"></a>cdata</h4>
</div>
</div>
</div>
@@ -105,7 +109,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp62213008"></a>flags</h4>
+ <h4 class="title"><a id="idp3924904"></a>flags</h4>
</div>
</div>
</div>
@@ -120,7 +124,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<code class="literal">DB_REP_CLIENT</code>
</p>
<p>
- Configure the environment as a replication client.
+ Configure the environment as a replication client or view.
</p>
</li>
<li>
@@ -139,7 +143,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp62223448"></a>Errors</h3>
+ <h3 class="title"><a id="idp3948224"></a>Errors</h3>
</div>
</div>
</div>
@@ -155,7 +159,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp62227744"></a>DB_REP_UNAVAIL</h4>
+ <h4 class="title"><a id="idp3953016"></a>DB_REP_UNAVAIL</h4>
</div>
</div>
</div>
@@ -171,7 +175,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp62230248"></a>EINVAL</h4>
+ <h4 class="title"><a id="idp3953336"></a>EINVAL</h4>
</div>
</div>
</div>
@@ -182,7 +186,12 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
the database environment was not already opened;
this method is called from a Replication Manager application; outstanding
master leases are granted; this method is used to appoint a new master when
- master leases are in use; or if an invalid flag value or parameter was specified.
+ master leases are in use; a view is being started
+ without having called the
+ <a class="xref" href="repset_view.html" title="DB_ENV-&gt;rep_set_view()">DB_ENV-&gt;rep_set_view()</a>
+ method before opening the database environment;
+ or if an invalid flag value or parameter was
+ specified.
</p>
</div>
</div>
@@ -190,7 +199,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp62229496"></a>Class</h3>
+ <h3 class="title"><a id="idp3939848"></a>Class</h3>
</div>
</div>
</div>
@@ -202,7 +211,7 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp62231440"></a>See Also</h3>
+ <h3 class="title"><a id="idp3955352"></a>See Also</h3>
</div>
</div>
</div>
@@ -215,14 +224,14 @@ DB_ENV-&gt;rep_start(DB_ENV *env, DBT *cdata, u_int32_t flags); </pre>
<hr />
<table width="100%" summary="Navigation footer">
<tr>
- <td width="40%" align="left"><a accesskey="p" href="reptransport.html">Prev</a> </td>
+ <td width="40%" align="left"><a accesskey="p" href="repset_view.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="rep.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="repstat.html">Next</a></td>
</tr>
<tr>
- <td width="40%" align="left" valign="top">DB_ENV-&gt;rep_set_transport() </td>
+ <td width="40%" align="left" valign="top">DB_ENV-&gt;rep_set_view() </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>