pcntl-setpriority.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4ecb2c1b4ba1b51c5e9678a7908e001df9bc92f5 Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.pcntl-setpriority" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pcntl_setpriority</refname>
  <refpurpose>Change la priorité d'un processus</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>pcntl_setpriority</methodname>
   <methodparam><type>int</type><parameter>priority</parameter></methodparam>
   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>process_id</parameter><initializer>&null;</initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>PRIO_PROCESS</constant></initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>pcntl_setpriority</function> change la priorité de
   <parameter>process_id</parameter> à <parameter>priority</parameter>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>priority</parameter></term>
     <listitem>
      <para>
       <parameter>priority</parameter> est généralement une valeur allant de 
       <literal>-20</literal> à <literal>20</literal>. La priorité par défaut
       est &zero; tandis qu'une valeur numérique plus petite
       favorise une meilleure planification. Comme les niveaux de priorité
       changent entre les types de systèmes et les versions de kernel, lisez
       la page de manuel getpriority(2) de votre système pour des détails 
       spécifiques.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>process_id</parameter></term>
     <listitem>
      <para>
       Si &null;, l'identifiant du processus courant est utilisé.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       Une constante parmi <constant>PRIO_PGRP</constant>, <constant>PRIO_USER</constant>,
       <constant>PRIO_PROCESS</constant>,
       <constant>PRIO_DARWIN_BG</constant> ou <constant>PRIO_DARWIN_THREAD</constant>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <parameter>process_id</parameter> est désormais nullable.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pcntl_getpriority</function></member>
    <member><function>pcntl_setpriority</function></member>
   </simplelist>
  </para>
 </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
-->