Sindbad~EG File Manager
<?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>DbMpoolFile::set_maxsize()</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="memp.html" title="Chapter 9. The DbMpoolFile Handle" />
<link rel="prev" href="mempset_lsn_offset.html" title="DbMpoolFile::set_lsn_offset()" />
<link rel="next" href="mempset_pgcookie.html" title="DbMpoolFile::set_pgcookie()" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 18.1.40</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">
<span xmlns="http://www.w3.org/1999/xhtml">DbMpoolFile::set_maxsize()</span>
</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="mempset_lsn_offset.html">Prev</a> </td>
<th width="60%" align="center">Chapter 9.
The DbMpoolFile Handle
</th>
<td width="20%" align="right"> <a accesskey="n" href="mempset_pgcookie.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="mempset_maxsize"></a>
<span>DbMpoolFile::set_maxsize()</span>
</h2>
</div>
</div>
</div>
<pre class="programlisting">#include <db_cxx.h>
int
DbMpoolFile::set_maxsize(u_int32_t gbytes, u_int32_t bytes); </pre>
<p>
Set the maximum size for the file to be
<span class="bold"><strong>gbytes</strong></span> gigabytes plus
<span class="bold"><strong>bytes</strong></span>. Attempts to set the file
size smaller than or equal to the page size removes the file size
limit. Attempts to allocate new pages in the file after the limit
has been reached will fail.
</p>
<p>
To set the maximum file size for a particular database, call the
<code class="methodname">DbMpoolFile::set_maxsize()</code> method using the
<a class="link" href="memp.html" title="Chapter 9. The DbMpoolFile Handle">DbMpoolFile</a> handle stored
in the <span class="bold"><strong>mpf</strong></span> field of the
<a class="link" href="db.html" title="Chapter 2. The Db Handle">Db</a> handle. Attempts to insert
new items into the database after the limit has been reached may fail.
</p>
<p>
The <code class="methodname">DbMpoolFile::set_maxsize()</code> method configures a file in the
cache, not only operations performed using the specified
<a class="link" href="memp.html" title="Chapter 9. The DbMpoolFile Handle">DbMpoolFile</a> handle.
</p>
<p>
The <code class="methodname">DbMpoolFile::set_maxsize()</code> method may be called at any time
during the life of the application.
</p>
<p>
The <code class="methodname">DbMpoolFile::set_maxsize()</code> <span>
<span>
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
</span>
</span>
</p>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idm139755611704320"></a>Parameters</h3>
</div>
</div>
</div>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="idm139755611703456"></a>bytes</h4>
</div>
</div>
</div>
<p>
The maximum size of the file is set to
<span class="bold"><strong>gbytes</strong></span> gigabytes plus
<span class="bold"><strong>bytes</strong></span>.
</p>
</div>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="idm139755611698176"></a>gbytes</h4>
</div>
</div>
</div>
<p>
The maximum size of the file is set to
<span class="bold"><strong>gbytes</strong></span> gigabytes plus
<span class="bold"><strong>bytes</strong></span>.
</p>
</div>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idm139755611766880"></a>Class</h3>
</div>
</div>
</div>
<p>
<a class="link" href="env.html" title="Chapter 5. The DbEnv Handle">DbEnv</a>, <a class="link" href="memp.html" title="Chapter 9. The DbMpoolFile Handle">DbMpoolFile</a>
</p>
</div>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="idm139755611693712"></a>See Also</h3>
</div>
</div>
</div>
<p>
<a class="xref" href="memp.html#memplist" title="Memory Pools and Related Methods">Memory Pools 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="mempset_lsn_offset.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="memp.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="mempset_pgcookie.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">
<span>DbMpoolFile::set_lsn_offset()</span>
</td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top">
<span>DbMpoolFile::set_pgcookie()</span>
</td>
</tr>
</table>
</div>
</body>
</html>
Sindbad File Manager Version 1.0, Coded By Sindbad EG ~ The Terrorists