Skip to content

Documente pcntl_getqos_class et pcntl_setqos_class (sync EN #5506) #2760

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
lacatoire merged 1 commit into from
Apr 24, 2026
+215 −1
Merged

Documente pcntl_getqos_class et pcntl_setqos_class (sync EN #5506) #2760

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: Fan2Shrek Status: ready -->
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<sect1 xml:id="migration84.new-functions">
<title>Nouvelles fonctions</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>Récupère la classe QoS du thread courant</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>Pcntl\QosClass</type><methodname>pcntl_getqos_class</methodname>
<void/>
</methodsynopsis>
<simpara>
Récupère la classe QoS.
</simpara>
<note>
<simpara>Cette fonction n'est disponible que sur les plateformes Apple.</simpara>
</note>
</refsect1>

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

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Retourne la valeur <enumname>Pcntl\QosClass</enumname>.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lance une <classname>Error</classname> si l'appel sous-jacent à
<literal>pthread_get_qos_class_np()</literal> échoue.
</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
-->
142 changes: 142 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,142 @@
<?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>Définit la classe QoS du thread courant</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>
Définit la classe QoS.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>qos_class</parameter></term>
<listitem>
<para>
La classe de qualité de service à affecter au thread courant. Le
système d'exploitation l'utilise comme indication pour ordonnancer le
temps CPU, la priorité des entrées/sorties et la consommation d'énergie :
les classes les plus élevées préemptent les plus basses. Se référer à
<enumname>Pcntl\QosClass</enumname> pour les cas disponibles.
</para>
<para>
<variablelist>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInteractive</constant></term>
<listitem>
<simpara>
Priorité la plus élevée. Destinée au travail qui pilote directement
une interface utilisateur et doit se terminer quasi instantanément
pour éviter tout délai perçu, comme la gestion d'événements ou le
rendu.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInitiated</constant></term>
<listitem>
<simpara>
Priorité élevée, juste en dessous de <constant>UserInteractive</constant>.
Destinée au travail explicitement initié par l'utilisateur et sur
lequel il attend activement une réponse, censée aboutir en quelques
secondes.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Default</constant></term>
<listitem>
<simpara>
Priorité standard, utilisée quand aucune classe plus spécifique ne
s'applique. S'exécute après le travail à plus haute priorité mais
avant <constant>Utility</constant> et <constant>Background</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Utility</constant></term>
<listitem>
<simpara>
Priorité plus basse, destinée au travail de longue durée dont
l'utilisateur est conscient mais qu'il n'attend pas activement,
comme des téléchargements, des imports ou des calculs en masse.
Ordonnancé de manière économe en énergie.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Background</constant></term>
<listitem>
<simpara>
Priorité la plus basse, destinée au travail dont l'utilisateur n'est
pas conscient, comme du préchargement, de l'indexation ou de la
maintenance. Très optimisé pour l'efficacité énergétique et
susceptible d'être différé lorsque le système est sous charge.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
</variablelist>
<note>
<simpara>Cette fonction n'est disponible que sur les plateformes Apple.</simpara>
</note>
</refsect1>

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

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lance une <classname>Error</classname> si l'appel sous-jacent à
<literal>pthread_set_qos_class_self_np()</literal> échoue.
</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
-->
Loading