Skip to content

Commit 310a6f1

Browse files
lacatoirelacatoire
authored
[Sync EN] pcntl: Fix duplicate documentation for pcntl_getqos_class and pcntl_setqos_class (#789)
1 parent a393b4b commit 310a6f1

2 files changed

Lines changed: 95 additions & 23 deletions

File tree

‎reference/pcntl/functions/pcntl-getqos-class.xml‎

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f Maintainer: lacatoire Status: ready -->
2+
<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: lacatoire Status: ready -->
33
<refentry xml:id="function.pcntl-getqos-class" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>pcntl_getqos_class</refname>
6-
<refpurpose>Obtiene la clase de calidad de servicio actual del proceso</refpurpose>
6+
<refpurpose>Obtiene la clase de calidad de servicio del hilo actual</refpurpose>
77
</refnamediv>
88

99
<refsect1 role="description">
@@ -13,11 +13,12 @@
1313
<void/>
1414
</methodsynopsis>
1515
<simpara>
16-
Devuelve la clase de calidad de servicio (<acronym>QoS</acronym>) actual
17-
del proceso llamante. Esta función solo está disponible en macOS, que
18-
utiliza las clases <acronym>QoS</acronym> para gestionar la eficiencia
19-
energética y el rendimiento.
16+
Recupera la clase de calidad de servicio (<acronym>QoS</acronym>) del
17+
hilo actual.
2018
</simpara>
19+
<note>
20+
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
21+
</note>
2122
</refsect1>
2223

2324
<refsect1 role="parameters">
@@ -28,15 +29,24 @@
2829
<refsect1 role="returnvalues">
2930
&reftitle.returnvalues;
3031
<simpara>
31-
Devuelve un valor de la enumeración <classname>Pcntl\QosClass</classname>
32-
que representa la clase <acronym>QoS</acronym> actual.
32+
Devuelve la clase <acronym>QoS</acronym> actual como un
33+
<enumname>Pcntl\QosClass</enumname>.
34+
</simpara>
35+
</refsect1>
36+
37+
<refsect1 role="errors">
38+
&reftitle.errors;
39+
<simpara>
40+
Lanza un <exceptionname>Error</exceptionname> si la llamada subyacente a
41+
<literal>pthread_get_qos_class_np()</literal> falla.
3342
</simpara>
3443
</refsect1>
3544

3645
<refsect1 role="seealso">
3746
&reftitle.seealso;
3847
<simplelist>
3948
<member><function>pcntl_setqos_class</function></member>
49+
<member><enumname>Pcntl\QosClass</enumname></member>
4050
</simplelist>
4151
</refsect1>
4252

‎reference/pcntl/functions/pcntl-setqos-class.xml‎

Lines changed: 77 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,20 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f Maintainer: lacatoire Status: ready -->
2+
<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: lacatoire Status: ready -->
33
<refentry xml:id="function.pcntl-setqos-class" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>pcntl_setqos_class</refname>
6-
<refpurpose>Establece la clase de calidad de servicio del proceso</refpurpose>
6+
<refpurpose>Establece la clase de calidad de servicio del hilo actual</refpurpose>
77
</refnamediv>
88

99
<refsect1 role="description">
1010
&reftitle.description;
1111
<methodsynopsis>
1212
<type>void</type><methodname>pcntl_setqos_class</methodname>
13-
<methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer>Pcntl\QosClass::Default</initializer></methodparam>
13+
<methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer><constant>Pcntl\QosClass::Default</constant></initializer></methodparam>
1414
</methodsynopsis>
1515
<simpara>
1616
Establece la clase de calidad de servicio (<acronym>QoS</acronym>) del
17-
proceso llamante. Esta función solo está disponible en macOS, que utiliza
18-
las clases <acronym>QoS</acronym> para gestionar la eficiencia energética
19-
y el rendimiento.
17+
hilo actual.
2018
</simpara>
2119
</refsect1>
2220

@@ -27,19 +25,74 @@
2725
<term><parameter>qos_class</parameter></term>
2826
<listitem>
2927
<simpara>
30-
La clase <acronym>QoS</acronym> a establecer. Debe ser uno de los
31-
valores de la enumeración <classname>Pcntl\QosClass</classname>:
28+
La clase de calidad de servicio a asignar al hilo actual. El sistema
29+
operativo la utiliza como una indicación para planificar el tiempo de
30+
CPU, la prioridad de E/S y el consumo de energía, donde las clases
31+
superiores tienen prioridad sobre las inferiores. Véase
32+
<enumname>Pcntl\QosClass</enumname> para los casos disponibles.
3233
</simpara>
33-
<simplelist>
34-
<member><literal>Pcntl\QosClass::UserInteractive</literal></member>
35-
<member><literal>Pcntl\QosClass::UserInitiated</literal></member>
36-
<member><literal>Pcntl\QosClass::Default</literal></member>
37-
<member><literal>Pcntl\QosClass::Utility</literal></member>
38-
<member><literal>Pcntl\QosClass::Background</literal></member>
39-
</simplelist>
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 controla directamente
40+
una interfaz de usuario y debe completarse prácticamente al instante
41+
para evitar retrasos perceptibles, como la gestión de eventos o el
42+
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 está
52+
esperando activamente, que se espera que se complete 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 más
62+
específica. Se ejecuta después del trabajo de mayor prioridad pero
63+
antes de <constant>Utility</constant> y <constant>Background</constant>.
64+
</simpara>
65+
</listitem>
66+
</varlistentry>
67+
<varlistentry>
68+
<term><constant>Pcntl\QosClass::Utility</constant></term>
69+
<listitem>
70+
<simpara>
71+
Prioridad inferior, destinada al trabajo de larga duración del que el
72+
usuario es consciente pero que no está esperando activamente, como
73+
descargas, importaciones o cálculos masivos. Se planifica de forma
74+
eficiente energéticamente.
75+
</simpara>
76+
</listitem>
77+
</varlistentry>
78+
<varlistentry>
79+
<term><constant>Pcntl\QosClass::Background</constant></term>
80+
<listitem>
81+
<simpara>
82+
Prioridad más baja, destinada al trabajo del que el usuario no es
83+
consciente, como la precarga, la indexación o el mantenimiento. Muy
84+
optimizada para la eficiencia energética y puede aplazarse cuando el
85+
sistema está bajo carga.
86+
</simpara>
87+
</listitem>
88+
</varlistentry>
89+
</variablelist>
4090
</listitem>
4191
</varlistentry>
4292
</variablelist>
93+
<note>
94+
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
95+
</note>
4396
</refsect1>
4497

4598
<refsect1 role="returnvalues">
@@ -49,10 +102,19 @@
49102
</simpara>
50103
</refsect1>
51104

105+
<refsect1 role="errors">
106+
&reftitle.errors;
107+
<simpara>
108+
Lanza un <exceptionname>Error</exceptionname> si la llamada subyacente a
109+
<literal>pthread_set_qos_class_self_np()</literal> falla.
110+
</simpara>
111+
</refsect1>
112+
52113
<refsect1 role="seealso">
53114
&reftitle.seealso;
54115
<simplelist>
55116
<member><function>pcntl_getqos_class</function></member>
117+
<member><enumname>Pcntl\QosClass</enumname></member>
56118
</simplelist>
57119
</refsect1>
58120

0 commit comments

Comments
 (0)