Skip to content

Traduce pcntl_getqos_class y pcntl_setqos_class (sync EN #5506) #520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
PhilDaiguille merged 1 commit into from
Apr 24, 2026
+216 −1
Merged

Traduce pcntl_getqos_class y pcntl_setqos_class (sync EN #5506) #520

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion appendices/migration84/new-functions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ceeec43d340a7f0e0910d7eeeb0850af72ab34d9 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<sect1 xml:id="migration84.new-functions">
<title>Nuevas funciones</title>
Expand Down Expand Up @@ -122,6 +122,7 @@
<member><function>pcntl_getcpuaffinity</function></member>
<member><function>pcntl_getqos_class</function></member>
<member><function>pcntl_setns</function></member>
<member><function>pcntl_setqos_class</function></member>
<member><function>pcntl_waitid</function></member>
</simplelist>
</sect2>
Expand Down
71 changes: 71 additions & 0 deletions reference/pcntl/functions/pcntl_getqos_class.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.pcntl-getqos-class" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_getqos_class</refname>
<refpurpose>Obtiene la clase QoS del hilo actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>Pcntl\QosClass</type><methodname>pcntl_getqos_class</methodname>
<void/>
</methodsynopsis>
<simpara>
Recupera la clase QoS.
</simpara>
<note>
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
</note>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Devuelve el valor <enumname>Pcntl\QosClass</enumname>.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza un <classname>Error</classname> si la llamada subyacente a
<literal>pthread_get_qos_class_np()</literal> falla.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_setqos_class</function></member>
<member><enumname>Pcntl\QosClass</enumname></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
-->
143 changes: 143 additions & 0 deletions reference/pcntl/functions/pcntl_setqos_class.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,143 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.pcntl-setqos-class" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_setqos_class</refname>
<refpurpose>Establece la clase QoS del hilo actual</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>pcntl_setqos_class</methodname>
<methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer><constant>Pcntl\QosClass::Default</constant></initializer></methodparam>
</methodsynopsis>
<simpara>
Establece la clase QoS.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>qos_class</parameter></term>
<listitem>
<para>
La clase de calidad de servicio que se asignará al hilo actual. El
sistema operativo la utiliza como indicación para planificar el tiempo
de CPU, la prioridad de E/S y el consumo de energía: las clases más
altas tienen preferencia sobre las más bajas. Véase
<enumname>Pcntl\QosClass</enumname> para los casos disponibles.
</para>
<para>
<variablelist>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInteractive</constant></term>
<listitem>
<simpara>
Prioridad más alta. Destinada al trabajo que impulsa directamente
una interfaz de usuario y debe completarse prácticamente al
instante para evitar un retraso perceptible, como la gestión de
eventos o el dibujado.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInitiated</constant></term>
<listitem>
<simpara>
Prioridad alta, justo por debajo de <constant>UserInteractive</constant>.
Destinada al trabajo que el usuario ha iniciado explícitamente y
está esperando activamente, que se espera completar en unos pocos
segundos.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Default</constant></term>
<listitem>
<simpara>
Prioridad estándar, utilizada cuando no se aplica ninguna clase
más específica. Se ejecuta después del trabajo de mayor prioridad
pero antes de <constant>Utility</constant> y
<constant>Background</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Utility</constant></term>
<listitem>
<simpara>
Prioridad más baja, destinada al trabajo de larga duración del
que el usuario es consciente pero que no está esperando
activamente, como descargas, importaciones o cálculos por lotes.
Se planifica de manera eficiente energéticamente.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Background</constant></term>
<listitem>
<simpara>
Prioridad más baja, destinada al trabajo del que el usuario no es
consciente, como la precarga, la indexación o el mantenimiento.
Altamente optimizado para la eficiencia energética y puede
aplazarse cuando el sistema está bajo carga.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
</variablelist>
<note>
<simpara>Esta función solo está disponible en plataformas Apple.</simpara>
</note>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
&return.void;
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza un <classname>Error</classname> si la llamada subyacente a
<literal>pthread_set_qos_class_self_np()</literal> falla.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_getqos_class</function></member>
<member><enumname>Pcntl\QosClass</enumname></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
-->