You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ji...@apache.org on 2010/09/27 19:22:58 UTC
svn commit: r1001824 - /httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml
Author: jim
Date: Mon Sep 27 17:22:58 2010
New Revision: 1001824
URL: http://svn.apache.org/viewvc?rev=1001824&view=rev
Log:
Update doccos and explain clear/clean of shared mem
as well as persist
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml
Modified: httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml?rev=1001824&r1=1001823&r2=1001824&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_slotmem_shm.xml Mon Sep 27 17:22:58 2010
@@ -34,6 +34,13 @@
in which the datasets are organized in "slots."
</p>
+ <p>All shared memory is cleared and cleaned with each
+ restart, whether graceful or not. The data itself is
+ stored and restored within a file noted by the <code>name</code>
+ parameter in the <code>create</code> and <code>attach</code>
+ calls.
+ </p>
+
<p><code>mod_slotmem_shm</code> provides the following API functions:
</p>
@@ -42,10 +49,19 @@
<dd>call the callback on all worker slots</dd>
<dt>apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool)</dt>
- <dd>create a new slotmem with each item size is item_size.</dd>
+ <dd>create a new slotmem with each item size is item_size. <code>name</code> is the filename for the persistant store of
+ the shared memory. Values are:
+ <dl>
+ <dt><code>anonymous</code></dt>
+ <dd><code>$server_root/logs/anonymous.slotmem</code></dd>
+ <dt><code>:module_name.c</code></dt>
+ <dd><code>$server_root/logs/module_name.c.slotmem</code></dd>
+ <dt><code>"absolute-file-name"</code></dt>
+ <dd><code>$absolute-file-name.slotmem</code></dd>
+ </dl>
<dt>apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool)</dt>
- <dd>attach to an existing slotmem.</dd>
+ <dd>attach to an existing slotmem. See <code>create</code> for description of <code>name</code> parameter.</dd>
<dt>apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void**mem)</dt>
<dd>get the direct pointer to the memory associated with this worker slot.</dd>