sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update the proc_nice() documentation to reflect the Windows support in 7.2

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@340496 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Kalle Sommer Nielsen 2016-10-16 04:14:47 +00:00
parent 7e4167f3f2
commit 6dccfde5ef
1 changed files with 128 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

131
reference/exec/functions/proc-nice.xml
View file

@ -33,8 +33,65 @@
<term><parameter>increment</parameter></term>
<listitem>
<para>
The increment value of the priority change.
The new priority value, the value of this may differ on platforms.
</para>
<para>
on Unix, a low value, such as <literal>-20</literal> means high priority
wheras a positive value have a lower priority.
</para>
<para>
For Windows the <parameter>increment</parameter> parameter have the
following meanings:
</para>
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry valign="top">Priority class</entry>
<entry valign="top">Possible values</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>REALTIME_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 23</literal>
</entry>
</row>
<row>
<entry valign="top"><constant>HIGH_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 12</literal>
</entry>
</row>
<row>
<entry valign="top"><constant>ABOVE_NORMAL_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 9</literal>
</entry>
</row>
<row>
<entry valign="top"><constant>NORMAL_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 7</literal> &amp;
<parameter>increment</parameter> <literal>&lt; 4</literal>
</entry>
</row>
<row>
<entry valign="top"><constant>IDLE_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 5</literal>
</entry>
</row>
<row>
<entry valign="top"><constant>BELOW_NORMAL_PRIORITY_CLASS</constant></entry>
<entry valign="top">
<parameter>increment</parameter> <literal>&gt; 3</literal>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</listitem>
</varlistentry>
</variablelist>
@ -50,6 +107,64 @@
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Using <function>proc_open</function> to set the process priority to high</title>
<programlisting role="php">
<![CDATA[
<?php
// Windows
proc_nice(12);
// Unix
proc_nice(-20)
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[some_option] => aeiou
[PWD] => /tmp
[SHLVL] => 1
[_] => /usr/local/bin/php
)
command returned 0
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
This function is now available on Windows.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
@ -57,8 +172,18 @@
<para>
<function>proc_nice</function> will only exist if your system has 'nice'
capabilities. 'nice' conforms to: SVr4, SVID EXT, AT&amp;T, X/OPEN, BSD
4.3. This means that <function>proc_nice</function> is not available
on Windows.
4.3.
</para>
</note>
<note>
<title>Windows only</title>
<para>
The values of <parameter>increment</parameter> tries to mimic the output of
the <literal>wmic</literal>.
</para>
<para>
On Windows this function will only change the <emphasis>current</emphasis> process
priority, even if PHP was compiled using thread safety.
</para>
</note>
</refsect1>