From fdcc3c6319433fecb0e55e990cc5250a4db9752f Mon Sep 17 00:00:00 2001
From: Leonardo Lara Rodrigues <leonardo.lara.rodrigues@gmail.com>
Date: Thu, 6 Feb 2025 12:59:09 -0300
Subject: [PATCH] initial translation in eio/functions

---
 reference/eio/functions/eio-busy.xml   | 100 ++++++++++++++++
 reference/eio/functions/eio-cancel.xml | 127 ++++++++++++++++++++
 reference/eio/functions/eio-chmod.xml  | 108 +++++++++++++++++
 reference/eio/functions/eio-chown.xml  | 117 +++++++++++++++++++
 reference/eio/functions/eio-close.xml  |  98 ++++++++++++++++
 reference/eio/functions/eio-custom.xml | 154 +++++++++++++++++++++++++
 6 files changed, 704 insertions(+)
 create mode 100644 reference/eio/functions/eio-busy.xml
 create mode 100644 reference/eio/functions/eio-cancel.xml
 create mode 100644 reference/eio/functions/eio-chmod.xml
 create mode 100644 reference/eio/functions/eio-chown.xml
 create mode 100644 reference/eio/functions/eio-close.xml
 create mode 100644 reference/eio/functions/eio-custom.xml

diff --git a/reference/eio/functions/eio-busy.xml b/reference/eio/functions/eio-busy.xml
new file mode 100644
index 000000000..780f63558
--- /dev/null
+++ b/reference/eio/functions/eio-busy.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-busy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_busy</refname>
+  <refpurpose>Aumenta artificialmente a carga. Pode ser útil em testes,
+  benchmarking</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_busy</methodname>
+   <methodparam><type>int</type><parameter>delay</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+  <function>eio_busy</function> aumenta artificialmente a carga levando
+  <parameter>delay</parameter> segundos para executar. Pode ser usado para depuração ou
+  benchmarking.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>delay</parameter></term>
+    <listitem>
+     <para>
+      Atraso em segundos.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+    <para>
+     Esta função de retorno é chamada quando todas as requisições do grupo forem concluídas.
+    </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+  <para>
+   <function>eio_busy</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso"> &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_nop</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/eio/functions/eio-cancel.xml b/reference/eio/functions/eio-cancel.xml
new file mode 100644
index 000000000..66e2621c9
--- /dev/null
+++ b/reference/eio/functions/eio-cancel.xml
@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b38591439b2afe309740774f5fa41cafe32c72b9 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-cancel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_cancel</refname>
+  <refpurpose>Cancela uma requisição</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>eio_cancel</methodname>
+   <methodparam><type>resource</type><parameter>req</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>eio_cancel</function> cancela uma requisição especificada por
+   <parameter>req</parameter>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>req</parameter></term>
+    <listitem>
+     <para>
+      O recurso da requisição.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+  &return.void;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>eio_cancel</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+ /* Função chamada quando eio_nop() termina */
+ function my_nop_cb($data, $result) {
+  echo "my_nop ", $data, "\n";
+ }
+
+// Esta chamada a eio_nop() será cancelada
+$req = eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "1");
+var_dump($req);
+eio_cancel($req);
+
+// Desta vez eio_nop() será processada
+eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "2");
+
+// Processa requisições
+eio_event_loop();
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+resource(4) of type (EIO Request Descriptor)
+my_nop 2
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_grp_cancel</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/eio/functions/eio-chmod.xml b/reference/eio/functions/eio-chmod.xml
new file mode 100644
index 000000000..bf1e8fad3
--- /dev/null
+++ b/reference/eio/functions/eio-chmod.xml
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-chmod" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_chmod</refname>
+  <refpurpose>Altera permissões de arquivo/diretório</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_chmod</methodname>
+   <methodparam><type>string</type><parameter>path</parameter></methodparam>
+   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+  <function>eio_chmod</function> altera permissões de arquivo ou diretório. As
+   novas permissões são especificadas por <parameter>mode</parameter>.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>path</parameter></term>
+    <listitem>
+     <para>
+      Caminho para o arquivo ou diretório de destino.
+      &eio.warn.relpath;
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>mode</parameter></term>
+    <listitem>
+     <para>
+      As novas permissões, por exemplo, <literal>0644</literal>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>eio_chmod</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_chown</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/eio/functions/eio-chown.xml b/reference/eio/functions/eio-chown.xml
new file mode 100644
index 000000000..402e75c93
--- /dev/null
+++ b/reference/eio/functions/eio-chown.xml
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-chown" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_chown</refname>
+  <refpurpose>Altera permissões de arquivo/diretório</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_chown</methodname>
+   <methodparam><type>string</type><parameter>path</parameter></methodparam>
+   <methodparam><type>int</type><parameter>uid</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>gid</parameter><initializer>-1</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Altera permissões de arquivo ou diretório.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>path</parameter></term>
+    <listitem>
+     <para>
+      Caminho para o arquivo ou diretório.
+      &eio.warn.relpath;
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>uid</parameter></term>
+    <listitem>
+     <para>
+      ID do usuário. Ignorado quando igual a -1.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>gid</parameter></term>
+    <listitem>
+     <para>
+      ID do grupo. Ignorado quando igual a -1.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>eio_chown</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_chmod</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/eio/functions/eio-close.xml b/reference/eio/functions/eio-close.xml
new file mode 100644
index 000000000..f4891078f
--- /dev/null
+++ b/reference/eio/functions/eio-close.xml
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-close" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_close</refname>
+  <refpurpose>Fecha arquivo</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_close</methodname>
+   <methodparam><type>mixed</type><parameter>fd</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+  <function>eio_close</function> fecha o arquivo especificado por
+  <parameter>fd</parameter>.
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>fd</parameter></term>
+    <listitem>
+     <para>
+      Descritor numérico de recurso de socket ou de arquivo.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>eio_close</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>eio_open</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/eio/functions/eio-custom.xml b/reference/eio/functions/eio-custom.xml
new file mode 100644
index 000000000..a0497136e
--- /dev/null
+++ b/reference/eio/functions/eio-custom.xml
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
+
+<refentry xml:id="function.eio-custom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>eio_custom</refname>
+  <refpurpose>Executa requisição personalizada como qualquer outra chamada <emphasis>eio_*</emphasis></refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>resource</type><methodname>eio_custom</methodname>
+   <methodparam><type>callable</type><parameter>execute</parameter></methodparam>
+   <methodparam><type>int</type><parameter>pri</parameter></methodparam>
+   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
+   <methodparam
+   choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>eio_custom</function> Executa requisição personalizada especificada por
+   <parameter>execute</parameter> processando-a como qualquer outra chamada <emphasis>eio_*</emphasis>.
+  </para>
+
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>execute</parameter></term>
+    <listitem>
+     <para>
+      Especifica a função de requisição que deve corresponder ao seguinte protótipo:
+
+      <programlisting><![CDATA[
+      mixed execute(mixed data);
+      ]]></programlisting>
+      <parameter>callback</parameter> é a chamada de retorno de conclusão de evento que deve corresponder ao
+      seguinte protótipo:
+      <programlisting><![CDATA[
+      void callback(mixed data, mixed result);
+      ]]></programlisting>
+
+     <parameter>data</parameter> são os dados passados para
+     <parameter>execute</parameter> através do argumento <parameter>data</parameter>
+      sem modificações.
+      <parameter>result</parameter> é o valor retornado por <parameter>execute</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>pri</parameter></term>
+    <listitem>
+    &eio.request.pri.values;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>callback</parameter></term>
+    <listitem>
+     &eio.callback.proto;
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>data</parameter></term>
+    <listitem>
+     <para>
+      Variável arbitrária passada para <parameter>callback</parameter>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>eio_custom</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de <function>eio_custom</function></title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+/* Função de retorno personalizada */
+function my_custom_callback($data, $result) {
+    var_dump($data);
+    var_dump(count($result));
+    var_dump($result['data_modified']);
+    var_dump($result['result']);
+}
+
+/* Requisição personalizada */
+function my_custom($data) {
+    var_dump($data);
+
+    $result  = array(
+        'result'        => 1001,
+        'data_modified' => "my custom data",
+    );
+
+    return $result;
+}
+
+$data = "my_custom_data";
+$req = eio_custom("my_custom", EIO_PRI_DEFAULT, "my_custom_callback", $data);
+var_dump($req);
+eio_event_loop();
+?>
+]]>
+</programlisting>
+&example.outputs.similar;
+<screen>
+ <![CDATA[
+resource(4) of type (EIO Request Descriptor)
+string(14) "my_custom_data"
+string(14) "my_custom_data"
+int(2)
+string(14) "my custom data"
+int(1001)
+ ]]>
+ </screen>
+  </example>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->