<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Apache Portable Runtime Utility Library: SDBM library</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.4 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</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><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
<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></td></tr>
<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
<tr><td class="memItemLeft" nowrap 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"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap 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#gfabaf97932efa0eebfb1cc6b692a111f">APR_SDBM_DIRFEXT</a> ".dir"</td></tr>
<tr><td class="memItemLeft" nowrap 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#ga03fa1d1183240ca0845c54cc07df557">APR_SDBM_PAGFEXT</a> ".pag"</td></tr>
<tr><td class="memItemLeft" nowrap 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#gd42d896bab08b5e210f489fa59656807">APR_SDBM_INSERT</a> 0</td></tr>
<tr><td class="memItemLeft" nowrap 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#g84e2252c9ddf5e6c64ed1be43d2d0e53">APR_SDBM_REPLACE</a> 1</td></tr>
<tr><td class="memItemLeft" nowrap 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#g64cd385609059cf151e54c7046d92ec3">APR_SDBM_INSERTDUP</a> 2</td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap 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#g08c6121b4159ae86cec6e915e1e5d758">apr_sdbm_open</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#gf684c3a70d2c9ebe02bb1e2fffe23e1e">apr_sdbm_close</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
<tr><td class="memItemLeft" nowrap 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#g2c2edd6a123d8ca2a6334fa8874b724d">apr_sdbm_lock</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db, int type)</td></tr>
<tr><td class="memItemLeft" nowrap 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#gb96a7e08ddac3cb6bff97a822b68de14">apr_sdbm_unlock</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
<tr><td class="memItemLeft" nowrap 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#g7d9eae450e9f9a2f1bcf626a3f8ca43f">apr_sdbm_fetch</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#gc12993b882c50afa0777945ea4a88572">apr_sdbm_store</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#g5744462c07c40d26c275beaeb902ff9c">apr_sdbm_delete</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#ge5410d9dc681393e597f492f30c6447f">apr_sdbm_firstkey</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#g77d7f848ccb68e9f465a988d0af80911">apr_sdbm_nextkey</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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" nowrap 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#gbad67008f83fd219173acc5abdd0b42d">apr_sdbm_rdonly</a> (<a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> *db)</td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="gfabaf97932efa0eebfb1cc6b692a111f"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_DIRFEXT" ref="gfabaf97932efa0eebfb1cc6b692a111f" 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
</div>
</div><p>
<a class="anchor" name="gd42d896bab08b5e210f489fa59656807"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_INSERT" ref="gd42d896bab08b5e210f489fa59656807" 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
</div>
</div><p>
<a class="anchor" name="g64cd385609059cf151e54c7046d92ec3"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_INSERTDUP" ref="g64cd385609059cf151e54c7046d92ec3" 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
</div>
</div><p>
<a class="anchor" name="ga03fa1d1183240ca0845c54cc07df557"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_PAGFEXT" ref="ga03fa1d1183240ca0845c54cc07df557" 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
</div>
</div><p>
<a class="anchor" name="g84e2252c9ddf5e6c64ed1be43d2d0e53"></a><!-- doxytag: member="apr_sdbm.h::APR_SDBM_REPLACE" ref="g84e2252c9ddf5e6c64ed1be43d2d0e53" 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
</div>
</div><p>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="gf24cdea6e4884036a40484259efa68c6"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_t" ref="gf24cdea6e4884036a40484259efa68c6" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> <a class="el" href="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Structure for referencing an sdbm
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="gf684c3a70d2c9ebe02bb1e2fffe23e1e"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_close" ref="gf684c3a70d2c9ebe02bb1e2fffe23e1e" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Close an sdbm file previously opened by apr_sdbm_open <dl compact><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>
</dl>
</div>
</div><p>
<a class="anchor" name="g5744462c07c40d26c275beaeb902ff9c"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_delete" ref="g5744462c07c40d26c275beaeb902ff9c" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Delete an sdbm record value by key <dl compact><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>
</dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>It is not an error to delete a non-existent record. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g7d9eae450e9f9a2f1bcf626a3f8ca43f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_fetch" ref="g7d9eae450e9f9a2f1bcf626a3f8ca43f" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Fetch an sdbm record value by key <dl compact><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>
</dl>
</div>
</div><p>
<a class="anchor" name="ge5410d9dc681393e597f492f30c6447f"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_firstkey" ref="ge5410d9dc681393e597f492f30c6447f" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieve the first record key from a dbm <dl compact><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>
</dl>
<dl class="remark" compact><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><p>
<a class="anchor" name="g2c2edd6a123d8ca2a6334fa8874b724d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_lock" ref="g2c2edd6a123d8ca2a6334fa8874b724d" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Lock an sdbm database for concurency of multiple operations <dl compact><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 <pre>
APR_FLOCK_SHARED
APR_FLOCK_EXCLUSIVE
</pre> </td></tr>
</table>
</dl>
<dl class="remark" compact><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><p>
<a class="anchor" name="g77d7f848ccb68e9f465a988d0af80911"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_nextkey" ref="g77d7f848ccb68e9f465a988d0af80911" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieve the next record key from an sdbm <dl compact><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>
</dl>
</div>
</div><p>
<a class="anchor" name="g08c6121b4159ae86cec6e915e1e5d758"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_open" ref="g08c6121b4159ae86cec6e915e1e5d758" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Open an sdbm database by file name <dl compact><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) <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>
</dl>
<dl class="remark" compact><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><p>
<a class="anchor" name="gbad67008f83fd219173acc5abdd0b42d"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_rdonly" ref="gbad67008f83fd219173acc5abdd0b42d" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns true if the sdbm database opened for read-only access <dl compact><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>
</dl>
</div>
</div><p>
<a class="anchor" name="gc12993b882c50afa0777945ea4a88572"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_store" ref="gc12993b882c50afa0777945ea4a88572" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">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 width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Store an sdbm record value by key <dl compact><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 <pre>
APR_SDBM_INSERT return an error if the record exists
APR_SDBM_REPLACE overwrite any existing record for key
</pre> </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="gb96a7e08ddac3cb6bff97a822b68de14"></a><!-- doxytag: member="apr_sdbm.h::apr_sdbm_unlock" ref="gb96a7e08ddac3cb6bff97a822b68de14" 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="group___a_p_r___util___d_b_m___s_d_b_m.html#gf24cdea6e4884036a40484259efa68c6">apr_sdbm_t</a> * </td>
<td class="paramname"> <em>db</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Release an sdbm lock previously aquired by apr_sdbm_lock <dl compact><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>
</dl>
</div>
</div><p>
<hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 24 02:22:55 2008 for Apache Portable Runtime Utility Library by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
bdcd72668be70f58bf0aa7c2102b0734
>
files
>
129
