Edit File - File Manager

Edit File: env_set_rpc_server.html

<html>
<head>
<title>Berkeley DB: DB_ENV-&gt;set_rpc_server</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>
DB_ENV-&gt;set_rpc_server
</td>
<td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a>
<a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a></td>
</tr></table>
<hr size=1 noshade>
<tt>
<pre>
#include &lt;db.h&gt;

int
DB_ENV-&gt;set_rpc_server(DB_ENV *dbenv, CLIENT *client, char *host,
 long cl_timeout, long sv_timeout, u_int32_t flags);
</pre>
<hr size=1 noshade>
Description: DB_ENV-&gt;set_rpc_server
Establishes a connection for this dbenv to a RPC server.
When the DB_ENV-&gt;set_rpc_server method has been called, subsequent calls
to Berkeley DB library interfaces may return or throw exceptions encapsulating
<a name="DB_NOSERVER">DB_NOSERVER</a>, <a name="DB_NOSERVER_ID">DB_NOSERVER_ID</a>, or <a name="DB_NOSERVER_HOME">DB_NOSERVER_HOME</a>.
The DB_ENV-&gt;set_rpc_server method configures operations performed using the specified
<a href="../../db4-devel-4.7.25/api_c/env_class.html">DB_ENV</a> handle, not all operations performed on the underlying
database environment.
The DB_ENV-&gt;set_rpc_server method may not be called after the <a href="../../db4-devel-4.7.25/api_c/env_open.html">DB_ENV-&gt;open</a> method is
called.

The DB_ENV-&gt;set_rpc_server method
returns a non-zero error value on failure
and 0 on success.

Parameters 
 cl_timeout<ul compact><li><a name="2"></a>
The cl_timeout parameter specifies the number of seconds the client
should wait for results to come back from the server. Once the timeout
has expired on any communication with the server, DB_NOSERVER will
be returned. If this value is zero, a default timeout is used.</ul>
 client<ul compact><li>If the client channel has been provided by the application then
Berkeley DB will use it as its connection and the host and
cl_timeout fields are ignored.</ul>
 host<ul compact><li>The host parameter is the host to which the Berkeley DB server will
connect and create a channel for communication.</ul>
 flags<ul compact><li>The flags parameter is currently unused, and must be set to 0.</ul>
<a name="3"></a>
 sv_timeout<ul compact><li>The sv_timeout parameter specifies the number of seconds the server
should allow a client connection to remain idle before assuming that the
client is gone. Once that timeout has been reached, the server releases
all resources associated with that client connection. Subsequent attempts
by that client to communicate with the server result in
DB_NOSERVER_ID, indicating that an invalid identifier has been
given to the server. This value can be considered a hint to the server.
The server may alter this value based on its own policies or allowed
values. If this value is zero, a default timeout is used.</ul>
 
 Errors
The DB_ENV-&gt;set_rpc_server method
may fail and return one of the following non-zero errors:
 
EINVAL<ul compact><li>An
invalid flag value or parameter was specified.</ul>
 
<hr size=1 noshade>
 Class
<a href="../../db4-devel-4.7.25/api_c/env_class.html">DB_ENV</a>
 See Also
<a href="../../db4-devel-4.7.25/api_c/env_list.html">Database Environments and Related Methods</a>
</tt>
<table width="100%"><tr><td> </td><td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a><a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a>
</td></tr></table>
Copyright (c) 1996,2008 Oracle. All rights reserved.
</body>
</html>

Back to File Manager