<?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>set_cache_max</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="configuration_reference.html" title="Appendix B. DB_CONFIG Parameter Reference" />
<link rel="prev" href="set_cachesize_parameter.html" title="set_cachesize" />
<link rel="next" href="set_create_dir_parameter.html" title="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">set_cache_max</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="set_cachesize_parameter.html">Prev</a> </td>
<th width="60%" align="center">Appendix B. DB_CONFIG Parameter Reference</th>
<td width="20%" align="right"> <a accesskey="n" href="set_create_dir_parameter.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="set_cache_max_parameter"></a>set_cache_max</h2>
</div>
</div>
</div>
<p>
Sets the maximum size that the <code class="literal">set_cachesize</code>
parameter is allowed to set. The specified size is rounded to the
nearest multiple of the cache region size, which is the
initial cache size divided by the number of regions specified
to the <code class="literal">set_cachesize</code> parameter. If no value
is specified, it defaults to the initial cache size.
</p>
<p>
The syntax of this parameter in the <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file is a
single line with the string
<code class="literal">set_cache_max</code>, one or more whitespace
characters, and the maximum cache size in bytes, specified
in two parts: the gigabytes of cache and the additional
bytes of cache. For example:
</p>
<pre class="programlisting">set_cache_max 2 524288000</pre>
<p>
Sets the maximum cache size to 2.5GB.
</p>
<p>
This parameter can be changed with a simple restart of your
application; you do not need to re-create your environment for it
to be changed.
</p>
<p> For more information, see <a class="xref" href="envset_cache_max.html" title="DbEnv::set_cache_max()">DbEnv::set_cache_max()</a>.</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="set_cachesize_parameter.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="configuration_reference.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="set_create_dir_parameter.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">set_cachesize </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> set_create_dir</td>
</tr>
</table>
</div>
</body>
</html>
