Skip to content

Commit f927a6b

Browse files
lacatoirelacatoire
authored
sync-en: traduce pcntl_getqos_class y pcntl_setqos_class (#520)
1 parent 04d42c2 commit f927a6b

3 files changed

Lines changed: 216 additions & 1 deletion

File tree

‎appendices/migration84/new-functions.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: ceeec43d340a7f0e0910d7eeeb0850af72ab34d9 Maintainer: PhilDaiguille Status: ready -->
2+
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
33
<!-- Reviewed: yes -->
44
<sect1 xml:id="migration84.new-functions">
55
<title>Nuevas funciones</title>
@@ -122,6 +122,7 @@
122122
<member><function>pcntl_getcpuaffinity</function></member>
123123
<member><function>pcntl_getqos_class</function></member>
124124
<member><function>pcntl_setns</function></member>
125+
<member><function>pcntl_setqos_class</function></member>
125126
<member><function>pcntl_waitid</function></member>
126127
</simplelist>
127128
</sect2>

‎reference/pcntl/functions/pcntl_getqos_class.xml‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="function.pcntl-getqos-class" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>pcntl_getqos_class</refname>
6+
<refpurpose>Obtiene la clase QoS del hilo actual</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>Pcntl\QosClass</type><methodname>pcntl_getqos_class</methodname>
13+
<void/>
14+
</methodsynopsis>
15+
<simpara>
16+
Recupera la clase QoS.
17+
</simpara>
18+
<note>
19+
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
20+
</note>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
&no.function.parameters;
26+
</refsect1>
27+
28+
<refsect1 role="returnvalues">
29+
&reftitle.returnvalues;
30+
<simpara>
31+
Devuelve el valor <enumname>Pcntl\QosClass</enumname>.
32+
</simpara>
33+
</refsect1>
34+
35+
<refsect1 role="errors">
36+
&reftitle.errors;
37+
<simpara>
38+
Lanza un <classname>Error</classname> si la llamada subyacente a
39+
<literal>pthread_get_qos_class_np()</literal> falla.
40+
</simpara>
41+
</refsect1>
42+
43+
<refsect1 role="seealso">
44+
&reftitle.seealso;
45+
<simplelist>
46+
<member><function>pcntl_setqos_class</function></member>
47+
<member><enumname>Pcntl\QosClass</enumname></member>
48+
</simplelist>
49+
</refsect1>
50+
51+
</refentry>
52+
<!-- Keep this comment at the end of the file
53+
Local variables:
54+
mode: sgml
55+
sgml-omittag:t
56+
sgml-shorttag:t
57+
sgml-minimize-attributes:nil
58+
sgml-always-quote-attributes:t
59+
sgml-indent-step:1
60+
sgml-indent-data:t
61+
indent-tabs-mode:nil
62+
sgml-parent-document:nil
63+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
64+
sgml-exposed-tags:nil
65+
sgml-local-catalogs:nil
66+
sgml-local-ecat-files:nil
67+
End:
68+
vim600: syn=xml fen fdm=syntax fdl=2 si
69+
vim: et tw=78 syn=sgml
70+
vi: ts=1 sw=1
71+
-->

‎reference/pcntl/functions/pcntl_setqos_class.xml‎

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
3+
<refentry xml:id="function.pcntl-setqos-class" xmlns="http://docbook.org/ns/docbook">
4+
<refnamediv>
5+
<refname>pcntl_setqos_class</refname>
6+
<refpurpose>Establece la clase QoS del hilo actual</refpurpose>
7+
</refnamediv>
8+
9+
<refsect1 role="description">
10+
&reftitle.description;
11+
<methodsynopsis>
12+
<type>void</type><methodname>pcntl_setqos_class</methodname>
13+
<methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer><constant>Pcntl\QosClass::Default</constant></initializer></methodparam>
14+
</methodsynopsis>
15+
<simpara>
16+
Establece la clase QoS.
17+
</simpara>
18+
</refsect1>
19+
20+
<refsect1 role="parameters">
21+
&reftitle.parameters;
22+
<variablelist>
23+
<varlistentry>
24+
<term><parameter>qos_class</parameter></term>
25+
<listitem>
26+
<para>
27+
La clase de calidad de servicio que se asignará al hilo actual. El
28+
sistema operativo la utiliza como indicación para planificar el tiempo
29+
de CPU, la prioridad de E/S y el consumo de energía: las clases más
30+
altas tienen preferencia sobre las más bajas. Véase
31+
<enumname>Pcntl\QosClass</enumname> para los casos disponibles.
32+
</para>
33+
<para>
34+
<variablelist>
35+
<varlistentry>
36+
<term><constant>Pcntl\QosClass::UserInteractive</constant></term>
37+
<listitem>
38+
<simpara>
39+
Prioridad más alta. Destinada al trabajo que impulsa directamente
40+
una interfaz de usuario y debe completarse prácticamente al
41+
instante para evitar un retraso perceptible, como la gestión de
42+
eventos o el dibujado.
43+
</simpara>
44+
</listitem>
45+
</varlistentry>
46+
<varlistentry>
47+
<term><constant>Pcntl\QosClass::UserInitiated</constant></term>
48+
<listitem>
49+
<simpara>
50+
Prioridad alta, justo por debajo de <constant>UserInteractive</constant>.
51+
Destinada al trabajo que el usuario ha iniciado explícitamente y
52+
está esperando activamente, que se espera completar en unos pocos
53+
segundos.
54+
</simpara>
55+
</listitem>
56+
</varlistentry>
57+
<varlistentry>
58+
<term><constant>Pcntl\QosClass::Default</constant></term>
59+
<listitem>
60+
<simpara>
61+
Prioridad estándar, utilizada cuando no se aplica ninguna clase
62+
más específica. Se ejecuta después del trabajo de mayor prioridad
63+
pero antes de <constant>Utility</constant> y
64+
<constant>Background</constant>.
65+
</simpara>
66+
</listitem>
67+
</varlistentry>
68+
<varlistentry>
69+
<term><constant>Pcntl\QosClass::Utility</constant></term>
70+
<listitem>
71+
<simpara>
72+
Prioridad más baja, destinada al trabajo de larga duración del
73+
que el usuario es consciente pero que no está esperando
74+
activamente, como descargas, importaciones o cálculos por lotes.
75+
Se planifica de manera eficiente energéticamente.
76+
</simpara>
77+
</listitem>
78+
</varlistentry>
79+
<varlistentry>
80+
<term><constant>Pcntl\QosClass::Background</constant></term>
81+
<listitem>
82+
<simpara>
83+
Prioridad más baja, destinada al trabajo del que el usuario no es
84+
consciente, como la precarga, la indexación o el mantenimiento.
85+
Altamente optimizado para la eficiencia energética y puede
86+
aplazarse cuando el sistema está bajo carga.
87+
</simpara>
88+
</listitem>
89+
</varlistentry>
90+
</variablelist>
91+
</para>
92+
</listitem>
93+
</varlistentry>
94+
</variablelist>
95+
<note>
96+
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
97+
</note>
98+
</refsect1>
99+
100+
<refsect1 role="returnvalues">
101+
&reftitle.returnvalues;
102+
<simpara>
103+
&return.void;
104+
</simpara>
105+
</refsect1>
106+
107+
<refsect1 role="errors">
108+
&reftitle.errors;
109+
<simpara>
110+
Lanza un <classname>Error</classname> si la llamada subyacente a
111+
<literal>pthread_set_qos_class_self_np()</literal> falla.
112+
</simpara>
113+
</refsect1>
114+
115+
<refsect1 role="seealso">
116+
&reftitle.seealso;
117+
<simplelist>
118+
<member><function>pcntl_getqos_class</function></member>
119+
<member><enumname>Pcntl\QosClass</enumname></member>
120+
</simplelist>
121+
</refsect1>
122+
123+
</refentry>
124+
<!-- Keep this comment at the end of the file
125+
Local variables:
126+
mode: sgml
127+
sgml-omittag:t
128+
sgml-shorttag:t
129+
sgml-minimize-attributes:nil
130+
sgml-always-quote-attributes:t
131+
sgml-indent-step:1
132+
sgml-indent-data:t
133+
indent-tabs-mode:nil
134+
sgml-parent-document:nil
135+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
136+
sgml-exposed-tags:nil
137+
sgml-local-catalogs:nil
138+
sgml-local-ecat-files:nil
139+
End:
140+
vim600: syn=xml fen fdm=syntax fdl=2 si
141+
vim: et tw=78 syn=sgml
142+
vi: ts=1 sw=1
143+
-->

0 commit comments

Comments
 (0)