<?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_MPOOLFILE->set_clear_len</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Berkeley DB Upgrade Guide" />
<link rel="up" href="upgrade_4_4_toc.html" title="Chapter 6. Upgrading Berkeley DB 4.3 applications to Berkeley DB 4.4" />
<link rel="prev" href="upgrade_4_4_mutex.html" title="mutexes" />
<link rel="next" href="upgrade_4_4_lockstat.html" title="lock statistics" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">DB_MPOOLFILE->set_clear_len</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="upgrade_4_4_mutex.html">Prev</a> </td>
<th width="60%" align="center">Chapter 6. Upgrading Berkeley DB 4.3 applications to Berkeley DB 4.4</th>
<td width="20%" align="right"> <a accesskey="n" href="upgrade_4_4_lockstat.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="upgrade_4_4_clear"></a>DB_MPOOLFILE->set_clear_len</h2>
</div>
</div>
</div>
<p>The meaning of a 0 "clear length" argument to the
<a href="../api_reference/C/mempset_clear_len.html" class="olink">DB_MPOOLFILE->set_clear_len()</a> method changed in the Berkeley DB 4.4 release. In
previous releases, specifying a length of 0 was equivalent to the
default, and the entire created page was cleared. Unfortunately, this
left no way to specify that no part of the page needed to be cleared.
In the 4.4 release, specifying a "clear length" argument of 0 means that
no part of the page need be cleared.</p>
<p>Applications specifying a 0 "clear length" argument to the
<a href="../api_reference/C/mempset_clear_len.html" class="olink">DB_MPOOLFILE->set_clear_len()</a> method should simply remove the call, as the
default behavior is to clear the entire created page.</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="upgrade_4_4_mutex.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="upgrade_4_4_toc.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="upgrade_4_4_lockstat.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">mutexes </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> lock statistics</td>
</tr>
</table>
</div>
</body>
</html>
