cvs: phpdoc /en/reference/memcache/functions memcache-addserver.xml

mikl Sun Feb 5 12:00:06 2006 UTC Modified files: /phpdoc/en/reference/memcache/functions memcache-addserver.xml Log: Added description of failover behaviour and more information on the effect of the "retry_interval" parameter http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/memcache/functions/memcache-addserver.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/memcache/functions/memcache-addserver.xml diff -u phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.4 phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.5 --- phpdoc/en/reference/memcache/functions/memcache-addserver.xml:1.4 Sun Dec 25 22:33:24 2005 +++ phpdoc/en/reference/memcache/functions/memcache-addserver.xml Sun Feb 5 12:00:06 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.Memcache-addServer"> <refnamediv> <refname>Memcache::addServer</refname> @@ -27,6 +27,14 @@ <function>Memcache::close</function>. You can also use the <function>memcache_add_server</function> function. </para> + + <para> + Failover may occur at any stage in any of the methods, as long as other + servers are available the request the user won't notice. Any kind of + socket or Memcached server level errors (except out-of-memory) may trigger + the failover. Normal client errors such as adding an existing key will not + trigger a failover. + </para> <note> <para> @@ -94,6 +102,14 @@ parameter has any effect when this extension is loaded dynamically via <function>dl</function>. </para> + <para> + Each failed connection struct has its own timeout and before it has expired + the struct will be skipped when selecting backends to serve a request. Once + expired the connection will be successfully reconnected or marked as failed + for another <parameter>retry_interval</parameter> seconds. The typical + effect is that each webserver child will retry the connection about every + <parameter>retry_interval</parameter> seconds when serving a page. + </para> </listitem> </varlistentry> </variablelist>