Skip to content

Commit 16619e0

Browse files
lacatoirelacatoire
authored
sync-en: traduit pcntl_getqos_class et pcntl_setqos_class (#2760)
1 parent 8b52ba4 commit 16619e0

3 files changed

Lines changed: 215 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: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
33
<!-- Reviewed: yes -->
44
<sect1 xml:id="migration84.new-functions">
55
<title>Nouvelles fonctions</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>Récupère la classe QoS du thread courant</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+
Récupère la classe QoS.
17+
</simpara>
18+
<note>
19+
<simpara>Cette fonction n'est disponible que sur les plateformes 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+
Retourne la valeur <enumname>Pcntl\QosClass</enumname>.
32+
</simpara>
33+
</refsect1>
34+
35+
<refsect1 role="errors">
36+
&reftitle.errors;
37+
<simpara>
38+
Lance une <classname>Error</classname> si l'appel sous-jacent à
39+
<literal>pthread_get_qos_class_np()</literal> échoue.
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: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
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>Définit la classe QoS du thread courant</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+
Définit la classe 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 classe de qualité de service à affecter au thread courant. Le
28+
système d'exploitation l'utilise comme indication pour ordonnancer le
29+
temps CPU, la priorité des entrées/sorties et la consommation d'énergie :
30+
les classes les plus élevées préemptent les plus basses. Se référer à
31+
<enumname>Pcntl\QosClass</enumname> pour les cas disponibles.
32+
</para>
33+
<para>
34+
<variablelist>
35+
<varlistentry>
36+
<term><constant>Pcntl\QosClass::UserInteractive</constant></term>
37+
<listitem>
38+
<simpara>
39+
Priorité la plus élevée. Destinée au travail qui pilote directement
40+
une interface utilisateur et doit se terminer quasi instantanément
41+
pour éviter tout délai perçu, comme la gestion d'événements ou le
42+
rendu.
43+
</simpara>
44+
</listitem>
45+
</varlistentry>
46+
<varlistentry>
47+
<term><constant>Pcntl\QosClass::UserInitiated</constant></term>
48+
<listitem>
49+
<simpara>
50+
Priorité élevée, juste en dessous de <constant>UserInteractive</constant>.
51+
Destinée au travail explicitement initié par l'utilisateur et sur
52+
lequel il attend activement une réponse, censée aboutir en quelques
53+
secondes.
54+
</simpara>
55+
</listitem>
56+
</varlistentry>
57+
<varlistentry>
58+
<term><constant>Pcntl\QosClass::Default</constant></term>
59+
<listitem>
60+
<simpara>
61+
Priorité standard, utilisée quand aucune classe plus spécifique ne
62+
s'applique. S'exécute après le travail à plus haute priorité mais
63+
avant <constant>Utility</constant> et <constant>Background</constant>.
64+
</simpara>
65+
</listitem>
66+
</varlistentry>
67+
<varlistentry>
68+
<term><constant>Pcntl\QosClass::Utility</constant></term>
69+
<listitem>
70+
<simpara>
71+
Priorité plus basse, destinée au travail de longue durée dont
72+
l'utilisateur est conscient mais qu'il n'attend pas activement,
73+
comme des téléchargements, des imports ou des calculs en masse.
74+
Ordonnancé de manière économe en énergie.
75+
</simpara>
76+
</listitem>
77+
</varlistentry>
78+
<varlistentry>
79+
<term><constant>Pcntl\QosClass::Background</constant></term>
80+
<listitem>
81+
<simpara>
82+
Priorité la plus basse, destinée au travail dont l'utilisateur n'est
83+
pas conscient, comme du préchargement, de l'indexation ou de la
84+
maintenance. Très optimisé pour l'efficacité énergétique et
85+
susceptible d'être différé lorsque le système est sous charge.
86+
</simpara>
87+
</listitem>
88+
</varlistentry>
89+
</variablelist>
90+
</para>
91+
</listitem>
92+
</varlistentry>
93+
</variablelist>
94+
<note>
95+
<simpara>Cette fonction n'est disponible que sur les plateformes Apple.</simpara>
96+
</note>
97+
</refsect1>
98+
99+
<refsect1 role="returnvalues">
100+
&reftitle.returnvalues;
101+
<simpara>
102+
&return.void;
103+
</simpara>
104+
</refsect1>
105+
106+
<refsect1 role="errors">
107+
&reftitle.errors;
108+
<simpara>
109+
Lance une <classname>Error</classname> si l'appel sous-jacent à
110+
<literal>pthread_set_qos_class_self_np()</literal> échoue.
111+
</simpara>
112+
</refsect1>
113+
114+
<refsect1 role="seealso">
115+
&reftitle.seealso;
116+
<simplelist>
117+
<member><function>pcntl_getqos_class</function></member>
118+
<member><enumname>Pcntl\QosClass</enumname></member>
119+
</simplelist>
120+
</refsect1>
121+
122+
</refentry>
123+
<!-- Keep this comment at the end of the file
124+
Local variables:
125+
mode: sgml
126+
sgml-omittag:t
127+
sgml-shorttag:t
128+
sgml-minimize-attributes:nil
129+
sgml-always-quote-attributes:t
130+
sgml-indent-step:1
131+
sgml-indent-data:t
132+
indent-tabs-mode:nil
133+
sgml-parent-document:nil
134+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
135+
sgml-exposed-tags:nil
136+
sgml-local-catalogs:nil
137+
sgml-local-ecat-files:nil
138+
End:
139+
vim600: syn=xml fen fdm=syntax fdl=2 si
140+
vim: et tw=78 syn=sgml
141+
vi: ts=1 sw=1
142+
-->

0 commit comments

Comments
 (0)