cvs: phpdoc /en/reference/apc ini.xml /en/reference/apc/functions apc-cache-info.xml
| From: | Lucas Nealan | Date: | Thu, 03 Jan 2008 09:54:40 +0000 |
| Subject: | cvs: phpdoc /en/reference/apc ini.xml /en/reference/apc/functions apc-cache-info.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-992@lists.php.net to get a copy of this message | ||
lucas Thu Jan 3 09:54:40 2008 UTC
Modified files:
/phpdoc/en/reference/apc ini.xml
/phpdoc/en/reference/apc/functions apc-cache-info.xml
Log:
added details of new apc.coredump_unmap ini directive and documentation of 'filehits'
value for the cache_type parameter to apc_cache_info.
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/apc/ini.xml?r1=1.16&r2=1.17&diff_format=u
Index: phpdoc/en/reference/apc/ini.xml
diff -u phpdoc/en/reference/apc/ini.xml:1.16 phpdoc/en/reference/apc/ini.xml:1.17
--- phpdoc/en/reference/apc/ini.xml:1.16 Sat Sep 29 22:54:33 2007
+++ phpdoc/en/reference/apc/ini.xml Thu Jan 3 09:54:40 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.16 $ -->
+<!-- $Revision: 1.17 $ -->
<section xml:id="apc.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
@@ -200,6 +200,12 @@
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since APC 3.0.14.</entry>
</row>
+ <row>
+ <entry>apc.coredump_unmap</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>Available since APC 3.0.16.</entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -669,6 +675,38 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry xml:id="ini.apc.coredump_unmap">
+ <term>
+ <parameter>apc.coredump_unmap</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ Enables APC handling of signals, such as SIGSEGV, that write
+ core files when signaled. When these signals are received,
+ APC will attempt to unmap the shared memory segment in order
+ to exclude it from the core file. This setting may improve
+ system stability when fatal signals are received and a large
+ APC shared memory segment is configured.
+ </para>
+ <warning>
+ <para>
+ This feature is potentially dangerous. Unmapping the shared
+ memory segment in a fatal signal handler may cause undefined
+ behaviour if a fatal error occurs.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Although some kernels may provide a facility to ignore various
+ types of shared memory when generating a core dump file, these
+ implementations may also ignore important shared memory segments
+ such as the Apache scoreboard.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/apc/functions/apc-cache-info.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/apc/functions/apc-cache-info.xml
diff -u phpdoc/en/reference/apc/functions/apc-cache-info.xml:1.6
phpdoc/en/reference/apc/functions/apc-cache-info.xml:1.7
--- phpdoc/en/reference/apc/functions/apc-cache-info.xml:1.6 Mon Dec 31 00:39:35 2007
+++ phpdoc/en/reference/apc/functions/apc-cache-info.xml Thu Jan 3 09:54:40 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<refentry xml:id="function.apc-cache-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>apc_cache_info</refname>
@@ -41,8 +41,17 @@
<listitem>
<para>
If <parameter>cache_type</parameter> is
"<literal>user</literal>",
- information about the user cache will be returned; otherwise,
- information about the system cache (cached files) will be returned.
+ information about the user cache will be returned.
+ </para>
+ <para>
+ If <parameter>cache_type</parameter> is
"<literal>filehits</literal>",
+ information about which files have been served from the bytecode cache
+ for the current request will be returned. This feature must be enabled at
+ compile time using <option
role="configure">--enable-filehits</option>.
+ </para>
+ <para>
+ If no <parameter>cache_type</parameter> is specified, information about
+ the system cache (cached files) will be returned.
</para>
</listitem>
</varlistentry>
@@ -78,6 +87,13 @@
The <parameter>limited</parameter> parameter was introduced.
</entry>
</row>
+ <row>
+ <entry>3.0.16</entry>
+ <entry>
+ The "<literal>filehits</literal>" option for the
+ <parameter>cache_type</parameter> parameter was introduced.
+ </entry>
+ </row>
</tbody>
</tgroup>
</informaltable>