1<!--$Id: memp_maxwrite.so,v 10.6 2007/11/08 16:28:12 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB: DB_ENV->set_mp_max_write</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td> 13<b>DB_ENV->set_mp_max_write</b> 14</td> 15<td align=right> 16<a href="../api_c/api_core.html"><img src="../images/api.gif" alt="API"></a> 17<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> 18</tr></table> 19<hr size=1 noshade> 20<tt> 21<b><pre> 22#include <db.h> 23<p> 24int 25DB_ENV->set_mp_max_write(DB_ENV *env, int maxwrite, db_timeout_t maxwrite_sleep); 26<p> 27int 28DB_ENV->get_mp_max_write(DB_ENV *env, int *maxwritep, db_timeout_t *maxwrite_sleepp); 29</pre></b> 30<hr size=1 noshade> 31<b>Description: DB_ENV->set_mp_max_write</b> 32<p>The DB_ENV->set_mp_max_write method limits the number of sequential write 33operations scheduled by the library when flushing dirty pages from the 34cache.</p> 35<p>The database environment's maximum number of sequential write operations may also be configured using the 36environment's <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file. The syntax of the entry in that 37file is a single line with the string "set_mp_max_write", one or more whitespace 38characters, and the maximum number of sequential writes and the number of microseconds 39to sleep, also separated by whitespace characters. 40Because the <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file is read when the database environment 41is opened, it will silently overrule configuration done before that 42time.</p> 43<p>The DB_ENV->set_mp_max_write method configures a database environment, not only operations 44performed using the specified <a href="../api_c/env_class.html">DB_ENV</a> handle.</p> 45<p>The DB_ENV->set_mp_max_write method 46returns a non-zero error value on failure 47and 0 on success. 48</p> 49<b>Parameters</b> <br> 50 <b>maxwrite</b><ul compact><li>The maximum number of sequential write operations scheduled by the 51library when flushing dirty pages from the cache, or 0 if there is 52no limitation on the number of sequential write operations.</ul> 53 <b>maxwrite_sleep</b><ul compact><li>The number of microseconds the thread of control should pause before 54scheduling further write operations. It must be specified as an 55unsigned 32-bit number of microseconds, limiting the maximum pause to 56roughly 71 minutes.</ul> 57<br> 58<br><b>Errors</b> 59<p>The DB_ENV->set_mp_max_write method 60may fail and return one of the following non-zero errors:</p> 61<br> 62<b>EINVAL</b><ul compact><li>An 63invalid flag value or parameter was specified.</ul> 64<br> 65<hr size=1 noshade> 66<b>Description: DB_ENV->get_mp_max_write</b> 67<p>The DB_ENV->get_mp_max_write method returns the current maximum number of 68sequential write operations and microseconds to pause.</p> 69<p>The DB_ENV->get_mp_max_write method may be called at any time during the life of the 70application.</p> 71<p>The DB_ENV->get_mp_max_write method 72returns a non-zero error value on failure 73and 0 on success. 74</p> 75<b>Parameters</b> <br> 76 <b>maxwritep</b><ul compact><li>The <b>maxwritep</b> parameter references memory into which 77 the maximum number of sequential write operations is copied.</ul> 78 <b>maxwrite_sleepp</b><ul compact><li>The <b>maxwrite_sleepp</b> parameter references memory into which 79 the microseconds to pause before scheduling further write operations is copied.</ul> 80<br> 81<hr size=1 noshade> 82<br><b>Class</b> 83<a href="../api_c/env_class.html">DB_ENV</a>, <a href="../api_c/mempfile_class.html">DB_MPOOLFILE</a> 84<br><b>See Also</b> 85<a href="../api_c/memp_list.html">Memory Pools and Related Methods</a> 86</tt> 87<table width="100%"><tr><td><br></td><td align=right> 88<a href="../api_c/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> 89</td></tr></table> 90<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 91</body> 92</html> 93
