Edit File - File Manager

Edit File: set_func_yield.html

<html>
<head>
<title>Berkeley DB: db_env_set_func_yield</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_set_func_yield
</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_set_func_yield(int (*func_yield)(u_long secs, u_long usecs));
</pre>
<hr size=1 noshade>
Description: db_env_set_func_yield
The Berkeley DB library requires the ability to yield the processor from the
current thread of control to any other waiting threads of control.
The func_yield function must be able to cause the rescheduling
of all participants in the current Berkeley DB environment, whether threaded
or not. It may be incorrect to supply a thread yield function
if more than a single process is operating in the Berkeley DB environment.
This is because many thread-yield functions will not allow other
processes to run, and the contested lock may be held by another process,
not by another thread.
The db_env_set_func_yield method configures all operations performed by a process and
all of its threads of control, not operations confined to a single
database environment.
Although the db_env_set_func_yield 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="../../db4-devel-4.7.25/api_c/env_class.html">db_env_create</a> or <a href="../../db4-devel-4.7.25/api_c/db_class.html">db_create</a> methods.
The db_env_set_func_yield method
returns a non-zero error value on failure
and 0 on success.

Parameters 
 func_yield<ul compact><li>The func_yield parameter is the function which yields the processor.
The secs parameter is the number of seconds to pause before the
thread of control should run again, or 0.
The usecs parameter is the number of microseconds to pause
before the thread of control should run again, or 0.
The func_yield function must return the value of errno on
failure and 0 on success.</ul>
 
 See Also
<a href="../../db4-devel-4.7.25/ref/program/runtime.html">Run-time configuration</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