Skip to content

Commit 842c680

Browse files
committed
initial translation in eio/functions
1 parent fdcc3c6 commit 842c680

File tree

5 files changed

+554
-0
lines changed

5 files changed

+554
-0
lines changed

Diff for: reference/eio/functions/eio-dup2.xml

+100
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
3+
4+
<refentry xml:id="function.eio-dup2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>eio_dup2</refname>
7+
<refpurpose>Duplica um descritor de arquivo</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>resource</type><methodname>eio_dup2</methodname>
14+
<methodparam><type>mixed</type><parameter>fd</parameter></methodparam>
15+
<methodparam><type>mixed</type><parameter>fd2</parameter></methodparam>
16+
<methodparam
17+
choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
18+
<methodparam
19+
choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
20+
<methodparam
21+
choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
22+
23+
</methodsynopsis>
24+
<para>
25+
<function>eio_dup2</function> duplica um descritor de arquivo.
26+
</para>
27+
28+
</refsect1>
29+
30+
<refsect1 role="parameters">
31+
&reftitle.parameters;
32+
<variablelist>
33+
<varlistentry>
34+
<term><parameter>fd</parameter></term>
35+
<listitem>
36+
<para>
37+
Fluxo de origem, recurso de Socket ou descritor numérico de arquivo.
38+
</para>
39+
</listitem>
40+
</varlistentry>
41+
<varlistentry>
42+
<term><parameter>fd2</parameter></term>
43+
<listitem>
44+
<para>
45+
Fluxo de destino, recurso de Socket ou descritor numérico de arquivo.
46+
</para>
47+
</listitem>
48+
</varlistentry>
49+
<varlistentry>
50+
<term><parameter>pri</parameter></term>
51+
<listitem>
52+
&eio.request.pri.values;
53+
</listitem>
54+
</varlistentry>
55+
<varlistentry>
56+
<term><parameter>callback</parameter></term>
57+
<listitem>
58+
&eio.callback.proto;
59+
</listitem>
60+
</varlistentry>
61+
<varlistentry>
62+
<term><parameter>data</parameter></term>
63+
<listitem>
64+
<para>
65+
Variável arbitrária passada para <parameter>callback</parameter>.
66+
</para>
67+
</listitem>
68+
</varlistentry>
69+
</variablelist>
70+
</refsect1>
71+
72+
<refsect1 role="returnvalues">
73+
&reftitle.returnvalues;
74+
<para>
75+
<function>eio_dup2</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
76+
</para>
77+
</refsect1>
78+
79+
</refentry>
80+
81+
<!-- Keep this comment at the end of the file
82+
Local variables:
83+
mode: sgml
84+
sgml-omittag:t
85+
sgml-shorttag:t
86+
sgml-minimize-attributes:nil
87+
sgml-always-quote-attributes:t
88+
sgml-indent-step:1
89+
sgml-indent-data:t
90+
indent-tabs-mode:nil
91+
sgml-parent-document:nil
92+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
93+
sgml-exposed-tags:nil
94+
sgml-local-catalogs:nil
95+
sgml-local-ecat-files:nil
96+
End:
97+
vim600: syn=xml fen fdm=syntax fdl=2 si
98+
vim: et tw=78 syn=sgml
99+
vi: ts=1 sw=1
100+
-->

Diff for: reference/eio/functions/eio-event-loop.xml

+99
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
3+
4+
<refentry xml:id="function.eio-event-loop" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>eio_event_loop</refname>
7+
<refpurpose>Consulta a libeio até que todas as requisições tenham concluído</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>bool</type><methodname>eio_event_loop</methodname>
14+
<void />
15+
</methodsynopsis>
16+
<para>
17+
<function>eio_event_loop</function> consulta a libeio até que todas as requisições tenham concluído.
18+
</para>
19+
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
&no.function.parameters;
25+
</refsect1>
26+
27+
<refsect1 role="returnvalues">
28+
&reftitle.returnvalues;
29+
<para>
30+
<function>eio_event_loop</function> retorna &true; em caso de sucesso,&return.falseforfailure;.
31+
</para>
32+
</refsect1>
33+
34+
<refsect1 role="examples">
35+
&reftitle.examples;
36+
<example>
37+
<title>Exemplo de <function>eio_event_loop</function></title>
38+
<programlisting role="php">
39+
<![CDATA[
40+
<?php
41+
$temp_filename = "eio-temp-file.tmp";
42+
touch($temp_filename);
43+
44+
/* Função chamada quando eio_chmod() terminar */
45+
function my_chmod_callback($data, $result) {
46+
global $temp_filename;
47+
48+
if ($result == 0 && !is_readable($temp_filename) && is_writable($temp_filename)) {
49+
echo "eio_chmod_ok";
50+
}
51+
52+
@unlink($temp_filename);
53+
}
54+
55+
eio_chmod($temp_filename, 0200, EIO_PRI_DEFAULT, "my_chmod_callback");
56+
eio_event_loop();
57+
?>
58+
]]>
59+
</programlisting>
60+
&example.outputs.similar;
61+
<screen>
62+
<![CDATA[
63+
eio_chmod_ok
64+
]]>
65+
</screen>
66+
</example>
67+
68+
</refsect1>
69+
70+
71+
<refsect1 role="seealso">
72+
&reftitle.seealso;
73+
<simplelist>
74+
<member><function>eio_poll</function></member>
75+
</simplelist>
76+
</refsect1>
77+
78+
</refentry>
79+
80+
<!-- Keep this comment at the end of the file
81+
Local variables:
82+
mode: sgml
83+
sgml-omittag:t
84+
sgml-shorttag:t
85+
sgml-minimize-attributes:nil
86+
sgml-always-quote-attributes:t
87+
sgml-indent-step:1
88+
sgml-indent-data:t
89+
indent-tabs-mode:nil
90+
sgml-parent-document:nil
91+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
92+
sgml-exposed-tags:nil
93+
sgml-local-catalogs:nil
94+
sgml-local-ecat-files:nil
95+
End:
96+
vim600: syn=xml fen fdm=syntax fdl=2 si
97+
vim: et tw=78 syn=sgml
98+
vi: ts=1 sw=1
99+
-->

Diff for: reference/eio/functions/eio-fallocate.xml

+132
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: a4fe8cf4c7712c4af6d2b0dc2e3d7090f53f4e21 Maintainer: leonardolara Status: ready -->
3+
4+
<refentry xml:id="function.eio-fallocate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>eio_fallocate</refname>
7+
<refpurpose>Permite ao chamador manipular diretamente o espaço alocado
8+
em disco para um arquivo</refpurpose>
9+
</refnamediv>
10+
11+
<refsect1 role="description">
12+
&reftitle.description;
13+
<methodsynopsis>
14+
<type>resource</type><methodname>eio_fallocate</methodname>
15+
<methodparam><type>mixed</type><parameter>fd</parameter></methodparam>
16+
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
17+
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
18+
<methodparam><type>int</type><parameter>length</parameter></methodparam>
19+
<methodparam
20+
choice="opt"><type>int</type><parameter>pri</parameter><initializer>EIO_PRI_DEFAULT</initializer></methodparam>
21+
<methodparam
22+
choice="opt"><type>callable</type><parameter>callback</parameter><initializer>NULL</initializer></methodparam>
23+
<methodparam
24+
choice="opt"><type>mixed</type><parameter>data</parameter><initializer>NULL</initializer></methodparam>
25+
26+
</methodsynopsis>
27+
28+
<para>
29+
<function>eio_fallocate</function> permite ao chamador manipular diretamente o espaço alocado
30+
em disco para o arquivo especificado elo descrito de arquivo <parameter>fd</parameter> para o
31+
intervalo de byte iniciando em <parameter>offset</parameter> e continuando pelo númer de bytes
32+
informado em <parameter>length</parameter>.
33+
</para>
34+
35+
<note xmlns="http://docbook.org/ns/docbook">
36+
<title>O arquivo deve ser aberto para escrita</title>
37+
<para><constant>EIO_O_CREAT</constant> deve ser combinado através de uma operação lógica
38+
<emphasis>OR</emphasis> com <constant>EIO_O_WRONLY</constant> ou
39+
<constant>EIO_O_RDWR</constant>
40+
</para>
41+
</note>
42+
43+
</refsect1>
44+
45+
<refsect1 role="parameters">
46+
&reftitle.parameters;
47+
<variablelist>
48+
<varlistentry>
49+
<term><parameter>fd</parameter></term>
50+
<listitem>
51+
<para>
52+
Fluxo, recurso de socket ou descritor numérico de arquivo, por exemplo, retornado por <function>eio_open</function>.
53+
</para>
54+
</listitem>
55+
</varlistentry>
56+
<varlistentry>
57+
<term><parameter>mode</parameter></term>
58+
<listitem>
59+
<para>Atualmente apenas uma opção de modo é suportada:
60+
<constant>EIO_FALLOC_FL_KEEP_SIZE</constant> (o mesmo que a constante POSIX
61+
<constant>FALLOC_FL_KEEP_SIZE</constant>).
62+
</para>
63+
</listitem>
64+
</varlistentry>
65+
<varlistentry>
66+
<term><parameter>offset</parameter></term>
67+
<listitem>
68+
<para>
69+
Especifica o início do intervalo de bytes.
70+
</para>
71+
</listitem>
72+
</varlistentry>
73+
<varlistentry>
74+
<term><parameter>length</parameter></term>
75+
<listitem>
76+
<para>
77+
Especifica o comprimento do intervalo de bytes.
78+
</para>
79+
</listitem>
80+
</varlistentry>
81+
<varlistentry>
82+
<term><parameter>pri</parameter></term>
83+
<listitem>
84+
&eio.request.pri.values;
85+
</listitem>
86+
</varlistentry>
87+
<varlistentry>
88+
<term><parameter>callback</parameter></term>
89+
<listitem>
90+
&eio.callback.proto;
91+
</listitem>
92+
</varlistentry>
93+
<varlistentry>
94+
<term><parameter>data</parameter></term>
95+
<listitem>
96+
<para>
97+
Variável arbitrária passada para <parameter>callback</parameter>.
98+
</para>
99+
</listitem>
100+
</varlistentry>
101+
</variablelist>
102+
</refsect1>
103+
104+
<refsect1 role="returnvalues">
105+
&reftitle.returnvalues;
106+
<para>
107+
<function>eio_fallocate</function> retorna o recurso da requisição em caso de sucesso,&return.falseforfailure;.
108+
</para>
109+
</refsect1>
110+
111+
</refentry>
112+
113+
<!-- Keep this comment at the end of the file
114+
Local variables:
115+
mode: sgml
116+
sgml-omittag:t
117+
sgml-shorttag:t
118+
sgml-minimize-attributes:nil
119+
sgml-always-quote-attributes:t
120+
sgml-indent-step:1
121+
sgml-indent-data:t
122+
indent-tabs-mode:nil
123+
sgml-parent-document:nil
124+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
125+
sgml-exposed-tags:nil
126+
sgml-local-catalogs:nil
127+
sgml-local-ecat-files:nil
128+
End:
129+
vim600: syn=xml fen fdm=syntax fdl=2 si
130+
vim: et tw=78 syn=sgml
131+
vi: ts=1 sw=1
132+
-->

0 commit comments

Comments
 (0)