1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>DbEnv::set_verbose()</title> 7 <link rel="stylesheet" href="apiReference.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB C++ API Reference" /> 10 <link rel="up" href="env.html" title="Chapter 5. The DbEnv Handle" /> 11 <link rel="prev" href="envset_tmp_dir.html" title="DbEnv::set_tmp_dir()" /> 12 <link rel="next" href="envstat.html" title="DbEnv::stat_print()" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">DbEnv::set_verbose()</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="envset_tmp_dir.html">Prev</a> </td> 22 <th width="60%" align="center">Chapter 5. 23 The DbEnv Handle 24 </th> 25 <td width="20%" align="right"> <a accesskey="n" href="envstat.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="sect1" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title" style="clear: both"><a id="envset_verbose"></a>DbEnv::set_verbose()</h2> 35 </div> 36 </div> 37 </div> 38 <pre class="programlisting">#include <db_cxx.h> 39 40int 41DbEnv::set_verbose(u_int32_t which, int onoff); </pre> 42 <p> 43 The <code class="methodname">DbEnv::set_verbose()</code> method turns specific additional 44 informational and debugging messages in the Berkeley DB message output 45 on and off. To see the additional messages, verbose messages must 46 also be configured for the application. For more information on 47 verbose messages, see the <a class="xref" href="envset_msgfile.html" title="DbEnv::set_msgfile()">DbEnv::set_msgfile()</a> 48 method. 49 </p> 50 <p> 51 The database environment's messages may also be configured using the 52 environment's <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file. The 53 syntax of the entry in that file is a single line with the string 54 "set_verbose", one or more whitespace characters, and the method 55 <span class="bold"><strong>which</strong></span> parameter as a string; for 56 example, "set_verbose DB_VERB_RECOVERY". Because the <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file is 57 read when the database environment is opened, it will silently 58 overrule configuration done before that time. 59 </p> 60 <p> 61 The <code class="methodname">DbEnv::set_verbose()</code> method configures operations performed 62 using the specified <a class="link" href="env.html" title="Chapter 5. The DbEnv Handle">DbEnv</a> handle, not all 63 operations performed on the underlying database environment. 64 </p> 65 <p> 66 The <code class="methodname">DbEnv::set_verbose()</code> method may be called at any time during the 67 life of the application. 68 </p> 69 <p> 70 The <code class="methodname">DbEnv::set_verbose()</code> <span> 71 72 <span> 73 method either returns a non-zero error value or throws an 74 exception that encapsulates a non-zero error value on 75 failure, and returns 0 on success. 76 </span> 77 </span> 78 </p> 79 <div class="sect2" lang="en" xml:lang="en"> 80 <div class="titlepage"> 81 <div> 82 <div> 83 <h3 class="title"><a id="id1675441"></a>Parameters</h3> 84 </div> 85 </div> 86 </div> 87 <div class="sect3" lang="en" xml:lang="en"> 88 <div class="titlepage"> 89 <div> 90 <div> 91 <h4 class="title"><a id="id1676422"></a>onoff</h4> 92 </div> 93 </div> 94 </div> 95 <p> 96 If the <span class="bold"><strong>onoff</strong></span> parameter is set to 97 non-zero, the additional messages are output. 98 </p> 99 </div> 100 <div class="sect3" lang="en" xml:lang="en"> 101 <div class="titlepage"> 102 <div> 103 <div> 104 <h4 class="title"><a id="id1676569"></a>which</h4> 105 </div> 106 </div> 107 </div> 108 <p> 109 The <span class="bold"><strong>which</strong></span> parameter must be set to 110 one of the following values: 111 </p> 112 <div class="itemizedlist"> 113 <ul type="disc"> 114 <li> 115 <p><a id="set_verbose_DB_VERB_DEADLOCK"></a> 116 <code class="literal">DB_VERB_DEADLOCK</code> 117 </p> 118 <p> 119 Display additional information when doing deadlock detection. 120 </p> 121 </li> 122 <li> 123 <p><a id="set_verbose_DB_VERB_FILEOPS"></a> 124 <code class="literal">DB_VERB_FILEOPS</code> 125 </p> 126 <p> 127 Display additional information when performing filesystem operations 128 such as open, close or rename. May not be available on all platforms. 129 </p> 130 </li> 131 <li> 132 <p><a id="set_verbose_DB_VERB_FILEOPS_ALL"></a> 133 <code class="literal">DB_VERB_FILEOPS_ALL</code> 134 </p> 135 <p> 136 Display additional information when performing all filesystem 137 operations, including read and write. May not be available on all 138 platforms. 139 </p> 140 </li> 141 <li> 142 <p><a id="set_verbose_DB_VERB_RECOVERY"></a> 143 <code class="literal">DB_VERB_RECOVERY</code> 144 </p> 145 <p> 146 Display additional information when performing recovery. 147 </p> 148 </li> 149 <li> 150 <p><a id="set_verbose_DB_VERB_REGISTER"></a> 151 <code class="literal">DB_VERB_REGISTER</code> 152 </p> 153 <p> 154 Display additional information concerning support for the 155 <a class="link" href="envopen.html#envopen_DB_REGISTER">DB_REGISTER</a> flag to 156 the <a class="xref" href="envopen.html" title="DbEnv::open()">DbEnv::open()</a> 157 method. 158 </p> 159 </li> 160 <li> 161 <p><a id="set_verbose_DB_VERB_REPLICATION"></a> 162 <code class="literal">DB_VERB_REPLICATION</code> 163 </p> 164 <p> 165 Display all detailed information about replication. This includes the 166 information displayed by all of the other DB_VERB_REP_* and 167 DB_VERB_REPMGR_* values. 168 </p> 169 </li> 170 <li> 171 <p><a id="set_verbose_DB_VERB_REP_ELECT"></a> 172 <code class="literal">DB_VERB_REP_ELECT</code> 173 </p> 174 <p> 175 Display detailed information about replication elections. 176 </p> 177 </li> 178 <li> 179 <p><a id="set_verbose_DB_VERB_REP_LEASE"></a> 180 <code class="literal">DB_VERB_REP_LEASE</code> 181 </p> 182 <p> 183 Display detailed information about replication master leases. 184 </p> 185 </li> 186 <li> 187 <p><a id="set_verbose_DB_VERB_REP_MISC"></a> 188 <code class="literal">DB_VERB_REP_MISC</code> 189 </p> 190 <p> 191 Display detailed information about general replication processing not 192 covered by the other DB_VERB_REP_* values. 193 </p> 194 </li> 195 <li> 196 <p><a id="set_verbose_DB_VERB_REP_MSGS"></a> 197 <code class="literal">DB_VERB_REP_MSGS</code> 198 </p> 199 <p> 200 Display detailed information about replication message processing. 201 </p> 202 </li> 203 <li> 204 <p><a id="set_verbose_DB_VERB_REP_SYNC"></a> 205 <code class="literal">DB_VERB_REP_SYNC</code> 206 </p> 207 <p> 208 Display detailed information about replication client synchronization. 209 </p> 210 </li> 211 <li> 212 <p><a id="set_verbose_DB_VERB_REPMGR_CONNFAIL"></a> 213 <code class="literal">DB_VERB_REPMGR_CONNFAIL</code> 214 </p> 215 <p> 216 Display detailed information about Replication Manager connection 217 failures. 218 </p> 219 </li> 220 <li> 221 <p><a id="set_verbose_DB_VERB_REPMGR_MISC"></a> 222 <code class="literal">DB_VERB_REPMGR_MISC</code> 223 </p> 224 <p> 225 Display detailed information about general Replication Manager 226 processing. 227 </p> 228 </li> 229 <li> 230 <p><a id="set_verbose_DB_VERB_WAITSFOR"></a> 231 <code class="literal">DB_VERB_WAITSFOR</code> 232 </p> 233 <p> 234 Display the waits-for table when doing deadlock detection. 235 </p> 236 </li> 237 </ul> 238 </div> 239 </div> 240 </div> 241 <div class="sect2" lang="en" xml:lang="en"> 242 <div class="titlepage"> 243 <div> 244 <div> 245 <h3 class="title"><a id="id1676583"></a>Errors</h3> 246 </div> 247 </div> 248 </div> 249 <p> 250 The <code class="methodname">DbEnv::set_verbose()</code> <span> 251 252 <span> 253 method may fail and throw a <a class="link" href="dbexception.html" title="Chapter 6. The DbException Class">DbException</a> 254 exception, encapsulating one of the following non-zero errors, or return one 255 of the following non-zero errors: 256 </span> 257 </span> 258 </p> 259 <div class="sect3" lang="en" xml:lang="en"> 260 <div class="titlepage"> 261 <div> 262 <div> 263 <h4 class="title"><a id="id1676603"></a>EINVAL</h4> 264 </div> 265 </div> 266 </div> 267 <p> 268 An invalid flag value or parameter was specified. 269 </p> 270 </div> 271 </div> 272 <div class="sect2" lang="en" xml:lang="en"> 273 <div class="titlepage"> 274 <div> 275 <div> 276 <h3 class="title"><a id="id1676558"></a>Class</h3> 277 </div> 278 </div> 279 </div> 280 <p> 281 <a class="link" href="env.html" title="Chapter 5. The DbEnv Handle">DbEnv</a> 282 </p> 283 </div> 284 <div class="sect2" lang="en" xml:lang="en"> 285 <div class="titlepage"> 286 <div> 287 <div> 288 <h3 class="title"><a id="id1676585"></a>See Also</h3> 289 </div> 290 </div> 291 </div> 292 <p> 293 <a class="xref" href="env.html#envlist" title="Database Environments and Related Methods">Database Environments and Related Methods</a> 294 </p> 295 </div> 296 </div> 297 <div class="navfooter"> 298 <hr /> 299 <table width="100%" summary="Navigation footer"> 300 <tr> 301 <td width="40%" align="left"><a accesskey="p" href="envset_tmp_dir.html">Prev</a> </td> 302 <td width="20%" align="center"> 303 <a accesskey="u" href="env.html">Up</a> 304 </td> 305 <td width="40%" align="right"> <a accesskey="n" href="envstat.html">Next</a></td> 306 </tr> 307 <tr> 308 <td width="40%" align="left" valign="top">DbEnv::set_tmp_dir() </td> 309 <td width="20%" align="center"> 310 <a accesskey="h" href="index.html">Home</a> 311 </td> 312 <td width="40%" align="right" valign="top"> DbEnv::stat_print()</td> 313 </tr> 314 </table> 315 </div> 316 </body> 317</html> 318