From f536c1ef0f94ed83e8c5e1f549438a2f4d932a82 Mon Sep 17 00:00:00 2001
From: Boris Lytochkin <lytboris@php.net>
Date: Sun, 17 Jul 2011 20:17:49 +0000
Subject: [PATCH] docs for noOIDIncreasingCheck parameter

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@313344 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/snmp/snmp.xml | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/reference/snmp/snmp.xml b/reference/snmp/snmp.xml
index 47476a28a2..f0c66d9908 100644
--- a/reference/snmp/snmp.xml
+++ b/reference/snmp/snmp.xml
@@ -61,6 +61,11 @@
      <type>int</type>
      <varname linkend="snmp.props.oid_output_format">oid_output_format</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>bool</type>
+     <varname linkend="snmp.props.noOIDIncreasingCheck">noOIDIncreasingCheck</varname>
+    </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type>array</type>
@@ -200,7 +205,7 @@
      <listitem>
       <para>Controls the way enum values are printed</para>
       <para>
-       Parameter toggles if snmpwalk/snmpget etc. should automatically lookup enum values
+       Parameter toggles if walk/get etc. should automatically lookup enum values
        in the MIB and return them together with their human readable string.
       </para>
      </listitem>
@@ -225,6 +230,23 @@
       </table>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="snmp.props.noOIDIncreasingCheck">
+     <term><varname>noOIDIncreasingCheck</varname></term>
+     <listitem>
+      <para>Controls disabling check for increasing OID while walking OID tree</para>
+      <para>
+       Some <acronym>SNMP</acronym> agents are known for returning OIDs out
+       of order but can complete the walk anyway. Other agents return OIDs
+       that are out of order and can cause <methodname>SNMP::walk</methodname>
+       to loop indefinitely until memory limit will be reached.
+       PHP SNMP library by default performs OID increasing check and stops
+       walking on OID tree when it detects possible loop with issuing warning
+       about non-increasing OID faced.
+       Set <varname>noOIDIncreasingCheck</varname> to &true; to disable this
+       check.
+      </para>
+     </listitem>
+    </varlistentry>
     <varlistentry xml:id="snmp.props.info">
      <term><varname>info</varname></term>
      <listitem>