From 0f0ebc869b3da7577e2d6b47d68d41a9c0045e80 Mon Sep 17 00:00:00 2001
From: Nuno Lopes <nlopess@php.net>
Date: Fri, 16 Jan 2004 16:08:35 +0000
Subject: [PATCH] added session.gc_divisor. Patch by Antony Dovgal

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@148867 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/info/functions/ini-set.xml |  7 +++++-
 reference/session/ini.xml            | 34 ++++++++++++++++++++++++----
 2 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/reference/info/functions/ini-set.xml b/reference/info/functions/ini-set.xml
index e644ee6698..192e2e8e14 100644
--- a/reference/info/functions/ini-set.xml
+++ b/reference/info/functions/ini-set.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.30 $ -->
+<!-- $Revision: 1.31 $ -->
 <!-- splitted from ./en/functions/info.xml, last change in rev 1.23 -->
   <refentry id="function.ini-set">
    <refnamediv>
@@ -652,6 +652,11 @@
            <entry>"1"</entry>
            <entry>PHP_INI_ALL</entry>
           </row>
+          <row>
+           <entry>session.gc_divisor</entry>
+           <entry>"100"</entry>
+           <entry>PHP_INI_ALL</entry>
+          </row>
           <row>
            <entry>session.gc_maxlifetime</entry>
            <entry>"1440"</entry>
diff --git a/reference/session/ini.xml b/reference/session/ini.xml
index ff62b28e0d..a15907f8c3 100644
--- a/reference/session/ini.xml
+++ b/reference/session/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
 <section id="session.configuration">
  &reftitle.runtime;
  &extension.runtime;
@@ -40,6 +40,11 @@
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
+    <row>
+     <entry>session.gc_divisor</entry>
+     <entry>"100"</entry>
+     <entry>PHP_INI_ALL</entry>
+    </row>
     <row>
      <entry>session.gc_maxlifetime</entry>
      <entry>"1440"</entry>
@@ -264,13 +269,34 @@
    </term>
    <listitem>
     <simpara>
-     <literal>session.gc_probability</literal> specifies the
-     probability that the gc (garbage collection) routine is started
-     on each request in percent. Defaults to <literal>1</literal>.
+     <literal>session.gc_probability</literal> in conjunction with
+     <literal>session.gc_divisor</literal> is used to manage probability
+     that the gc (garbage collection) routine is started.
+     Defaults to <literal>1</literal>. See <link
+     linkend="ini.session.gc-divisor">session.gc_divisor</link> for details.
     </simpara>
    </listitem>
   </varlistentry>
 
+  <varlistentry id="ini.session.gc-divisor">
+   <term>
+    <parameter>session.gc_divisor</parameter>
+    <type>integer</type>
+   </term>
+   <listitem>
+    <simpara>
+     <literal>session.gc_divisor</literal> coupled with 
+     <literal>session.gc_probability</literal> defines the probability 
+     that the gc (garbage collection) process is started on every session 
+     initialization.
+     The probability is calculated by using gc_probability/gc_divisor,
+     e.g. 1/100 means there is a 1% chance that the GC process starts
+     on each request.
+     <literal>session.gc_divisor</literal> defaults to <literal>100</literal>.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  
   <varlistentry id="ini.session.gc-maxlifetime">
    <term>
     <parameter>session.gc_maxlifetime</parameter>