<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>DB_ENV->set_data_len()</title> <link rel="stylesheet" href="apiReference.css" type="text/css" /> <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="env.html" title="Chapter 5. The DB_ENV Handle" /> <link rel="prev" href="envset_data_dir.html" title="DB_ENV->set_data_dir()" /> <link rel="next" href="envset_create_dir.html" title="DB_ENV->set_create_dir()" /> </head> <body> <div xmlns="" class="navheader"> <div class="libver"> <p>Library Version 11.2.5.3</p> </div> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">DB_ENV->set_data_len()</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="envset_data_dir.html">Prev</a> </td> <th width="60%" align="center">Chapter 5. The DB_ENV Handle </th> <td width="20%" align="right"> <a accesskey="n" href="envset_create_dir.html">Next</a></td> </tr> </table> <hr /> </div> <div class="sect1" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a id="envset_data_len"></a>DB_ENV->set_data_len()</h2> </div> </div> </div> <pre class="programlisting">#include <db.h> int DB_ENV->set_data_len(DB_ENV *dbenv, u_int32_t bytes); </pre> <p> Limits the amount of data displayed when <a class="xref" href="lockstat_print.html" title="DB_ENV->lock_stat_print()">DB_ENV->lock_stat_print()</a> is called with the <code class="literal">DB_STAT_ALL</code> or <code class="literal">DB_STAT_LOCK_OBJECTS</code> flag. </p> <p> This method is explicitly called in the <a class="xref" href="db_printlog.html" title="db_printlog">db_printlog</a> and <a class="xref" href="db_dump.html" title="db_dump">db_dump</a> utilities when using the <span class="bold"><strong>-D</strong></span> command line option. When used in this manner it will set the maximum number of bytes to display for each key/data item. These utilities run in their own environment context. </p> <p> If you want to call this method from the primary application and have it set the maximum number of bytes to display for each key/data item, then you must bring the db_dump/db_printlog code into the primary application and ensure that the same environment handle is used throughout. </p> <p> This limit may also be configured using the environment's <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file. In this case, the limit will equally affect your application code, as well as the command line utilities noted above without modification to their code. The syntax of the entry in that file is a single line with the string "set_data_len", one or more whitespace characters, and the limit in bytes that you want to set. </p> <p> The <code class="methodname">DB_ENV->set_data_len()</code> method configures operations performed using the specified <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> handle, not all operations performed on the underlying database environment. </p> <p> The <code class="methodname">DB_ENV->set_data_len()</code> method may be called at any time during the life of the application. </p> <p> The <code class="methodname">DB_ENV->set_data_len()</code> <span> <span> method returns a non-zero error value on failure and 0 on success. </span> </span> </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="idp51883568"></a>Parameters</h3> </div> </div> </div> <div class="sect3" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h4 class="title"><a id="idp51883760"></a>bytes</h4> </div> </div> </div> <p> The <span class="bold"><strong>bytes</strong></span> parameter identifies the maximum number of bytes to display when dumping the database or printing the log. The value specified here must be greater than <code class="literal">0</code>. </p> </div> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="idp51865040"></a>Class</h3> </div> </div> </div> <p> <a class="link" href="env.html" title="Chapter 5. The DB_ENV Handle">DB_ENV</a> </p> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a id="idp51865520"></a>See Also</h3> </div> </div> </div> <p> <a class="xref" href="env.html#envlist" title="Database Environments and Related Methods">Database Environments and Related Methods</a> </p> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="envset_data_dir.html">Prev</a> </td> <td width="20%" align="center"> <a accesskey="u" href="env.html">Up</a> </td> <td width="40%" align="right"> <a accesskey="n" href="envset_create_dir.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">DB_ENV->set_data_dir() </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> DB_ENV->set_create_dir()</td> </tr> </table> </div> </body> </html>