<!-- 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: MMAP (Memory Map) Routines</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="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>MMAP (Memory Map) Routines<br/>
<small>
[<a class="el" href="group___a_p_r.html">Apache Portability Runtime library</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__mmap__t.html">apr_mmap_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__apr__mmap.html#gac231fdf15d2d29802e0abbc5d0cf25b8">APR_MMAP_READ</a> 1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#gac2eb7f697d8bf190e630b85f967c8273">APR_MMAP_WRITE</a> 2</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga19d1916e7b64bfb1a969648fe7b0846a">APR_MMAP_THRESHOLD</a> 1</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga548e49b3c9e8265ad8ccf70994f4fe25">APR_MMAP_LIMIT</a> (4*1024*1024)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga4f469432098e986567576fd4c4ce5adc">APR_MMAP_CANDIDATE</a>(filelength) ((filelength >= APR_MMAP_THRESHOLD) && (filelength < APR_MMAP_LIMIT))</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__mmap__t.html">apr_mmap_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga766b01a3e1e0438d06dc88d76f826f80">apr_mmap_t</a></td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#gac6b103139be2e859741ec94cc6ad34cc">apr_mmap_create</a> (<a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> **newmmap, <a class="el" href="group__apr__file__io.html#gaa46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *file, apr_off_t offset, apr_size_t size, apr_int32_t flag, <a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *cntxt)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga9fcdbf8090e924a4e8f2b301519bb4c8">apr_mmap_dup</a> (<a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> **new_mmap, <a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> *old_mmap, <a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga4b67a2d22a07707897cc1183a1682040">apr_mmap_delete</a> (<a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> *mm)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__mmap.html#ga4c1d31bd9e911744bd5edb97e17210ec">apr_mmap_offset</a> (void **addr, <a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> *mm, apr_off_t offset)</td></tr>
</table>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ga4f469432098e986567576fd4c4ce5adc"></a><!-- doxytag: member="apr_mmap.h::APR_MMAP_CANDIDATE" ref="ga4f469432098e986567576fd4c4ce5adc" args="(filelength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_MMAP_CANDIDATE</td>
<td>(</td>
<td class="paramtype">filelength </td>
<td class="paramname"></td>
<td> ) </td>
<td> ((filelength >= APR_MMAP_THRESHOLD) && (filelength < APR_MMAP_LIMIT))</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Can this file be MMaped </p>
</div>
</div>
<a class="anchor" id="ga548e49b3c9e8265ad8ccf70994f4fe25"></a><!-- doxytag: member="apr_mmap.h::APR_MMAP_LIMIT" ref="ga548e49b3c9e8265ad8ccf70994f4fe25" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_MMAP_LIMIT (4*1024*1024)</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Maximum size of MMap region </p>
</div>
</div>
<a class="anchor" id="gac231fdf15d2d29802e0abbc5d0cf25b8"></a><!-- doxytag: member="apr_mmap.h::APR_MMAP_READ" ref="gac231fdf15d2d29802e0abbc5d0cf25b8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_MMAP_READ 1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>MMap opened for reading </p>
</div>
</div>
<a class="anchor" id="ga19d1916e7b64bfb1a969648fe7b0846a"></a><!-- doxytag: member="apr_mmap.h::APR_MMAP_THRESHOLD" ref="ga19d1916e7b64bfb1a969648fe7b0846a" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_MMAP_THRESHOLD 1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Files have to be at least this big before they're mmap()d. This is to deal with systems where the expense of doing an mmap() and an munmap() outweighs the benefit for small files. It shouldn't be set lower than 1. </p>
</div>
</div>
<a class="anchor" id="gac2eb7f697d8bf190e630b85f967c8273"></a><!-- doxytag: member="apr_mmap.h::APR_MMAP_WRITE" ref="gac2eb7f697d8bf190e630b85f967c8273" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_MMAP_WRITE 2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>MMap opened for writing </p>
</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga766b01a3e1e0438d06dc88d76f826f80"></a><!-- doxytag: member="apr_mmap.h::apr_mmap_t" ref="ga766b01a3e1e0438d06dc88d76f826f80" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> <a class="el" href="structapr__mmap__t.html">apr_mmap_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> </dd></dl>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gac6b103139be2e859741ec94cc6ad34cc"></a><!-- doxytag: member="apr_mmap.h::apr_mmap_create" ref="gac6b103139be2e859741ec94cc6ad34cc" args="(apr_mmap_t **newmmap, apr_file_t *file, apr_off_t offset, apr_size_t size, apr_int32_t flag, apr_pool_t *cntxt)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_mmap_create </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> ** </td>
<td class="paramname"> <em>newmmap</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__apr__file__io.html#gaa46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> * </td>
<td class="paramname"> <em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_off_t </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_size_t </td>
<td class="paramname"> <em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_int32_t </td>
<td class="paramname"> <em>flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> * </td>
<td class="paramname"> <em>cntxt</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create a new mmap'ed file out of an existing APR file. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newmmap</em> </td><td>The newly created mmap'ed file. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The file turn into an mmap. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The offset into the file to start the data pointer at. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The size of the file </td></tr>
<tr><td valign="top"></td><td valign="top"><em>flag</em> </td><td>bit-wise or of: </p>
<pre>
APR_MMAP_READ MMap opened for reading
APR_MMAP_WRITE MMap opened for writing
</pre> </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cntxt</em> </td><td>The pool to use when creating the mmap. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4b67a2d22a07707897cc1183a1682040"></a><!-- doxytag: member="apr_mmap.h::apr_mmap_delete" ref="ga4b67a2d22a07707897cc1183a1682040" args="(apr_mmap_t *mm)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_mmap_delete </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> * </td>
<td class="paramname"> <em>mm</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Remove a mmap'ed. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>mm</em> </td><td>The mmap'ed file. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga9fcdbf8090e924a4e8f2b301519bb4c8"></a><!-- doxytag: member="apr_mmap.h::apr_mmap_dup" ref="ga9fcdbf8090e924a4e8f2b301519bb4c8" args="(apr_mmap_t **new_mmap, apr_mmap_t *old_mmap, apr_pool_t *p)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_mmap_dup </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> ** </td>
<td class="paramname"> <em>new_mmap</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> * </td>
<td class="paramname"> <em>old_mmap</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> * </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>Duplicate the specified MMAP. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>new_mmap</em> </td><td>The structure to duplicate into. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>old_mmap</em> </td><td>The mmap to duplicate. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to use for new_mmap. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4c1d31bd9e911744bd5edb97e17210ec"></a><!-- doxytag: member="apr_mmap.h::apr_mmap_offset" ref="ga4c1d31bd9e911744bd5edb97e17210ec" args="(void **addr, apr_mmap_t *mm, apr_off_t offset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__errno.html#gaf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a> apr_mmap_offset </td>
<td>(</td>
<td class="paramtype">void ** </td>
<td class="paramname"> <em>addr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structapr__mmap__t.html">apr_mmap_t</a> * </td>
<td class="paramname"> <em>mm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_off_t </td>
<td class="paramname"> <em>offset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Move the pointer into the mmap'ed file to the specified offset. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>addr</em> </td><td>The pointer to the offset specified. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>mm</em> </td><td>The mmap'ed file. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The offset to move to. </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>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><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 Tue Feb 14 10:09:01 2012 for Apache Portable Runtime 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
>
e0236b39c613e86bcee76bad717809a5
>
files
>
208
