<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!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/xhtml;charset=UTF-8"/>
<title>Apache Portable Runtime Utility Library: SDBM library</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.3 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
</div>
<div class="contents">
<h1>SDBM library<br/>
<small>
[<a class="el" href="group___a_p_r___util___d_b_m.html">DBM routines</a>]</small>
</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a></td></tr>
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gafabaf97932efa0eebfb1cc6b692a111f">APR_SDBM_DIRFEXT</a> ".dir"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gaa03fa1d1183240ca0845c54cc07df557">APR_SDBM_PAGFEXT</a> ".pag"</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gad42d896bab08b5e210f489fa59656807">APR_SDBM_INSERT</a> 0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga84e2252c9ddf5e6c64ed1be43d2d0e53">APR_SDBM_REPLACE</a> 1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga64cd385609059cf151e54c7046d92ec3">APR_SDBM_INSERTDUP</a> 2</td></tr>
<tr><td colspan="2"><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gaf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a></td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga08c6121b4159ae86cec6e915e1e5d758">apr_sdbm_open</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> **db, const char *name, apr_int32_t mode, apr_fileperms_t perms, apr_pool_t *p)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gaf684c3a70d2c9ebe02bb1e2fffe23e1e">apr_sdbm_close</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga2c2edd6a123d8ca2a6334fa8874b724d">apr_sdbm_lock</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, int type)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gab96a7e08ddac3cb6bff97a822b68de14">apr_sdbm_unlock</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga7d9eae450e9f9a2f1bcf626a3f8ca43f">apr_sdbm_fetch</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *value, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gac12993b882c50afa0777945ea4a88572">apr_sdbm_store</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> value, int opt)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga5744462c07c40d26c275beaeb902ff9c">apr_sdbm_delete</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, const <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> key)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gae5410d9dc681393e597f492f30c6447f">apr_sdbm_firstkey</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *key)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#ga77d7f848ccb68e9f465a988d0af80911">apr_sdbm_nextkey</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db, <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> *key)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gabad67008f83fd219173acc5abdd0b42d">apr_sdbm_rdonly</a> (<a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> *db)</td></tr>
</table>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="gafabaf97932efa0eebfb1cc6b692a111f"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_DIRFEXT" ref="gafabaf97932efa0eebfb1cc6b692a111f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_SDBM_DIRFEXT ".dir"</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>SDBM Directory file extension </p>
</div>
</div>
<a class="anchor" id="gad42d896bab08b5e210f489fa59656807"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_INSERT" ref="gad42d896bab08b5e210f489fa59656807" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_SDBM_INSERT 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Insert </p>
</div>
</div>
<a class="anchor" id="ga64cd385609059cf151e54c7046d92ec3"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_INSERTDUP" ref="ga64cd385609059cf151e54c7046d92ec3" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_SDBM_INSERTDUP 2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Insert with duplicates </p>
</div>
</div>
<a class="anchor" id="gaa03fa1d1183240ca0845c54cc07df557"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_PAGFEXT" ref="gaa03fa1d1183240ca0845c54cc07df557" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_SDBM_PAGFEXT ".pag"</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>SDBM page file extension </p>
</div>
</div>
<a class="anchor" id="ga84e2252c9ddf5e6c64ed1be43d2d0e53"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_REPLACE" ref="ga84e2252c9ddf5e6c64ed1be43d2d0e53" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_SDBM_REPLACE 1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Replace </p>
</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gaf24cdea6e4884036a40484259efa68c6"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_t" ref="gaf24cdea6e4884036a40484259efa68c6" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> <a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure for referencing an sdbm </p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gaf684c3a70d2c9ebe02bb1e2fffe23e1e"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_close" ref="gaf684c3a70d2c9ebe02bb1e2fffe23e1e" args="(apr_sdbm_t *db)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_close </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Close an sdbm file previously opened by apr_sdbm_open </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database to close </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5744462c07c40d26c275beaeb902ff9c"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_delete" ref="ga5744462c07c40d26c275beaeb902ff9c" args="(apr_sdbm_t *db, const apr_sdbm_datum_t key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_delete </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> </td>
<td class="paramname"> <em>key</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Delete an sdbm record value by key </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key datum of the record to delete </td></tr>
</table>
</dd>
</dl>
<dl class="remark"><dt><b>Remarks:</b></dt><dd>It is not an error to delete a non-existent record. </dd></dl>
</div>
</div>
<a class="anchor" id="ga7d9eae450e9f9a2f1bcf626a3f8ca43f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_fetch" ref="ga7d9eae450e9f9a2f1bcf626a3f8ca43f" args="(apr_sdbm_t *db, apr_sdbm_datum_t *value, apr_sdbm_datum_t key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_fetch </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> * </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> </td>
<td class="paramname"> <em>key</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Fetch an sdbm record value by key </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value datum retrieved for this record </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key datum to find this record </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gae5410d9dc681393e597f492f30c6447f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_firstkey" ref="gae5410d9dc681393e597f492f30c6447f" args="(apr_sdbm_t *db, apr_sdbm_datum_t *key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_firstkey </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> * </td>
<td class="paramname"> <em>key</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve the first record key from a dbm </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key datum of the first record </td></tr>
</table>
</dd>
</dl>
<dl class="remark"><dt><b>Remarks:</b></dt><dd>The keys returned are not ordered. To traverse the list of keys for an sdbm opened with APR_SHARELOCK, the caller must use apr_sdbm_lock prior to retrieving the first record, and hold the lock until after the last call to apr_sdbm_nextkey. </dd></dl>
</div>
</div>
<a class="anchor" id="ga2c2edd6a123d8ca2a6334fa8874b724d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_lock" ref="ga2c2edd6a123d8ca2a6334fa8874b724d" args="(apr_sdbm_t *db, int type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_lock </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>type</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Lock an sdbm database for concurency of multiple operations </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database to lock </td></tr>
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>The lock type </p>
<pre>
APR_FLOCK_SHARED
APR_FLOCK_EXCLUSIVE
</pre> </td></tr>
</table>
</dd>
</dl>
<dl class="remark"><dt><b>Remarks:</b></dt><dd>Calls to apr_sdbm_lock may be nested. All apr_sdbm functions perform implicit locking. Since an APR_FLOCK_SHARED lock cannot be portably promoted to an APR_FLOCK_EXCLUSIVE lock, apr_sdbm_store and apr_sdbm_delete calls will fail if an APR_FLOCK_SHARED lock is held. The apr_sdbm_lock call requires the database to be opened with the APR_SHARELOCK mode value. </dd></dl>
</div>
</div>
<a class="anchor" id="ga77d7f848ccb68e9f465a988d0af80911"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_nextkey" ref="ga77d7f848ccb68e9f465a988d0af80911" args="(apr_sdbm_t *db, apr_sdbm_datum_t *key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_nextkey </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> * </td>
<td class="paramname"> <em>key</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve the next record key from an sdbm </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key datum of the next record </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga08c6121b4159ae86cec6e915e1e5d758"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_open" ref="ga08c6121b4159ae86cec6e915e1e5d758" args="(apr_sdbm_t **db, const char *name, apr_int32_t mode, apr_fileperms_t perms, apr_pool_t *p)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_open </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> ** </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_int32_t </td>
<td class="paramname"> <em>mode</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_fileperms_t </td>
<td class="paramname"> <em>perms</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>p</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Open an sdbm database by file name </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The newly opened database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The sdbm file to open </td></tr>
<tr><td valign="top"></td><td valign="top"><em>mode</em> </td><td>The flag values (APR_READ and APR_BINARY flags are implicit) </p>
<pre>
APR_WRITE open for read-write access
APR_CREATE create the sdbm if it does not exist
APR_TRUNCATE empty the contents of the sdbm
APR_EXCL fail for APR_CREATE if the file exists
APR_DELONCLOSE delete the sdbm when closed
APR_SHARELOCK support locking across process/machines
</pre> </td></tr>
<tr><td valign="top"></td><td valign="top"><em>perms</em> </td><td>Permissions to apply to if created </td></tr>
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to use when creating the sdbm </td></tr>
</table>
</dd>
</dl>
<dl class="remark"><dt><b>Remarks:</b></dt><dd>The sdbm name is not a true file name, as sdbm appends suffixes for seperate data and index files. </dd></dl>
</div>
</div>
<a class="anchor" id="gabad67008f83fd219173acc5abdd0b42d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_rdonly" ref="gabad67008f83fd219173acc5abdd0b42d" args="(apr_sdbm_t *db)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_sdbm_rdonly </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns true if the sdbm database opened for read-only access </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database to test </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gac12993b882c50afa0777945ea4a88572"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_store" ref="gac12993b882c50afa0777945ea4a88572" args="(apr_sdbm_t *db, apr_sdbm_datum_t key, apr_sdbm_datum_t value, int opt)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_store </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__sdbm__datum__t.html">apr_sdbm_datum_t</a> </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>opt</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Store an sdbm record value by key </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key datum to store this record by </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value datum to store in this record </td></tr>
<tr><td valign="top"></td><td valign="top"><em>opt</em> </td><td>The method used to store the record </p>
<pre>
APR_SDBM_INSERT return an error if the record exists
APR_SDBM_REPLACE overwrite any existing record for key
</pre> </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab96a7e08ddac3cb6bff97a822b68de14"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_unlock" ref="gab96a7e08ddac3cb6bff97a822b68de14" args="(apr_sdbm_t *db)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_sdbm_unlock </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__sdbm__t.html">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Release an sdbm lock previously aquired by apr_sdbm_lock </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>The database to unlock </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Wed Feb 1 12:19:48 2012 for Apache Portable Runtime Utility Library by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
7c859c6f61469ed11e2ab179848b0178
>
files
>
162
