Sophie

Sophie

distrib > Mandriva > 2007.0 > x86_64 > media > main-release > by-pkgid > a4c98df40e78f6c892308fd6841f950a > files > 117

lib64db4.2-devel-4.2.52-11mdv2007.0.x86_64.rpm

<!--$Id: env_set_verbose.so,v 10.45 2003/11/08 19:17:33 bostic Exp $-->
<!--Copyright 1997-2003 by Sleepycat Software, Inc.-->
<!--All rights reserved.-->
<!--See the file LICENSE for redistribution information.-->
<html>
<head>
<title>Berkeley DB: DB_ENV-&gt;set_verbose</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<a name="2"><!--meow--></a>
<table width="100%"><tr valign=top>
<td>
<h3>DB_ENV-&gt;set_verbose</h3>
</td>
<td align=right>
<a href="../../db42-devel-4.2.52/api_c/api_index.html"><img src="../../db42-4.2.52/images/api.gif" alt="API"></a>
<a href="../../db42-devel-4.2.52/ref/toc.html"><img src="../../db42-4.2.52/images/ref.gif" alt="Ref"></a>
</td></tr></table>
<hr size=1 noshade>
<tt>
<h3><pre>
#include &lt;db.h&gt;
<p>
int
DB_ENV-&gt;set_verbose(DB_ENV *dbenv, u_int32_t which, int onoff);
<p>
int
DB_ENV-&gt;get_verbose(DB_ENV *dbenv, u_int32_t which, int *onoffp);
</pre></h3>
<hr size=1 noshade>
<h3>Description: DB_ENV-&gt;set_verbose</h3>
<a name="3"><!--meow--></a>
<p>The DB_ENV-&gt;set_verbose method turns specific additional informational
and debugging messages in the Berkeley DB message output on and off.  To see
the additional messages, verbose messages must also be configured for
the application.  For more information on verbose messages, see the
<a href="../../db42-devel-4.2.52/api_c/db_set_errfile.html">DB-&gt;set_errfile</a> method.</p>
<p>The database environment's messages may also be set using the environment's
<b>DB_CONFIG</b> file.  The syntax of the entry in that file is a
single line with the string "set_verbose", one or more whitespace characters,
and the method <b>which</b> parameter as a string; for example,
"set_verbose DB_VERB_CHKPOINT".
Because the <b>DB_CONFIG</b> file is read when the database
environment is opened, it will silently overrule configuration done
before that time.</p>
<p>The DB_ENV-&gt;set_verbose method configures operations performed using the specified
<a href="../../db42-devel-4.2.52/api_c/env_class.html">DB_ENV</a> handle, not all operations performed on the underlying
database environment.</p>
<p>The DB_ENV-&gt;set_verbose method may be called at any time during the life of the
application.</p>
<p>The DB_ENV-&gt;set_verbose method
returns a non-zero error value on failure
and 0 on success.
</p>
<h3>Parameters</h3>
<p><dl compact>
<p><dt><b>onoff</b><dd>
If the <b>onoff</b> parameter is set to non-zero, the additional messages are output.
<p><dt><b>which</b><dd>
The <b>which</b> parameter must be set to one of the following values:
<p><dl compact>
<p><dt><a name="DB_VERB_CHKPOINT">DB_VERB_CHKPOINT</a><dd>Display checkpoint location information when searching the log for
checkpoints.
<p><dt><a name="DB_VERB_DEADLOCK">DB_VERB_DEADLOCK</a><dd>Display additional information when doing deadlock detection.
<p><dt><a name="DB_VERB_RECOVERY">DB_VERB_RECOVERY</a><dd>Display additional information when performing recovery.
<p><dt><a name="DB_VERB_REPLICATION">DB_VERB_REPLICATION</a><dd>Display additional information when processing replication messages.
<p>Note, to get complete replication logging when debugging replication
applications, you must also configure and build the Berkeley DB library with
the <a href="../../db42-devel-4.2.52/ref/build_unix/conf.html">--enable-diagnostic</a>
configuration option as well as call the DB_ENV-&gt;set_verbose method.</p>
<p><dt><a name="DB_VERB_WAITSFOR">DB_VERB_WAITSFOR</a><dd>Display the waits-for table when doing deadlock detection.
</dl>
</dl>
<h3>Errors</h3>
<p>The DB_ENV-&gt;set_verbose method
may fail and return one of the following non-zero errors:</p>
<p><dl compact>
<p><dt>EINVAL<dd>An
invalid flag value or parameter was specified.
</dl>
<hr size=1 noshade>
<h3>Description: dbenv_get_verbose</h3>
<p>The DB_ENV-&gt;get_verbose method returns whether the specified <b>which</b>
parameter is currently set or not.</p>
<p>The DB_ENV-&gt;get_verbose method may be called at any time during the life of the
application.</p>
<p>The DB_ENV-&gt;get_verbose method
returns a non-zero error value on failure
and 0 on success.
</p>
<h3>Parameters</h3>
<p><dl compact>
<p><dt><b>which</b><dd>
The <b>which</b> parameter is the message value for which configuration
is being checked.
<p><dt><b>onoffp</b><dd>
The <b>onoffp</b> parameter references memory into which
 the configuration of the specified <b>which</b> parameter is copied.
</dl>
<hr size=1 noshade>
<h3>Class</h3>
<a href="../../db42-devel-4.2.52/api_c/env_class.html">DB_ENV</a>
<h3>See Also</h3>
<a href="../../db42-devel-4.2.52/api_c/env_list.html">Database Environments and Related Methods</a>
</tt>
<table width="100%"><tr><td><br></td><td align=right>
<a href="../../db42-devel-4.2.52/api_c/api_index.html"><img src="../../db42-4.2.52/images/api.gif" alt="API"></a><a href="../../db42-devel-4.2.52/ref/toc.html"><img src="../../db42-4.2.52/images/ref.gif" alt="Ref"></a>
</td></tr></table>
<p><font size=1><a href="../../db42-devel-4.2.52/sleepycat/legal.html">Copyright (c) 1996-2003</a> <a href="http://www.sleepycat.com">Sleepycat Software, Inc.</a> - All rights reserved.</font>
</body>
</html>