1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
<?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>
|
