Skip to content

Commit

Permalink
Update Pcntl functions to En (#1042)
Browse files Browse the repository at this point in the history
* Create pcntl-getcpuaffinity.xml

* Update pcntl-getcpuaffinity.xml Change maintainer

* Update pcntl-getcpuaffinity.xml Уточнил формулировку

* Create pcntl-setcpuaffinity.xml
  • Loading branch information
mmalferov authored Jan 31, 2025
1 parent e98423b commit 037bacb
Show file tree
Hide file tree
Showing 2 changed files with 176 additions and 0 deletions.
84 changes: 84 additions & 0 deletions reference/pcntl/functions/pcntl-getcpuaffinity.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 262ca5a53247283e8e927a4a52367474e7f9838a Maintainer: malferov Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pcntl-getcpuaffinity" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_getcpuaffinity</refname>
<refpurpose>Получает информацию о привязке процессора к процессу</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>bool</type><type>array</type></type><methodname>pcntl_getcpuaffinity</methodname>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>pid</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<simpara>
Функция извлекает информацию о привязке центрального процессора к процессу с идентификатором <parameter>pid</parameter>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>pid</parameter></term>
<listitem>
<simpara>
При передаче значения &null; функция присвоит параметру значение, равное идентификатору текущего процесса.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Функция возвращает маску соответствия процессора процессу, &return.falseforfailure;.
</simpara>
&return.falseproblem;
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Функция выбрасывает ошибку <classname>ValueError</classname>, когда
в аргументе <parameter>pid</parameter> передают недопустимый идентификатор процесса
или не удалось создать маску процессора.
</simpara>
<simpara>
Функция выдаёт ошибку уровня <constant>E_WARNING</constant>,
если в аргументе <parameter>pid</parameter> передали идентификатор процесса, для которого
у текущего пользователь нет разрешений.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_setcpuaffinity</function></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
-->
92 changes: 92 additions & 0 deletions reference/pcntl/functions/pcntl-setcpuaffinity.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5af24e453c46b4b8611cca1dfc1b8628ae9fd368 Maintainer: malferov Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pcntl-setcpuaffinity" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_setcpuaffinity</refname>
<refpurpose>Устанавливает связку процессора с процессом</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>pcntl_setcpuaffinity</methodname>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>pid</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter>hmask</parameter></methodparam>
</methodsynopsis>
<simpara>
Функция устанавливает соответствие процессора процессу с идентификатором <parameter>pid</parameter>.
Функция устанавливает связку по маске соответствия процессора, которую указали в аргументе
<parameter>hmask</parameter>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>pid</parameter></term>
<listitem>
<simpara>
При передаче значения &null; функция присвоит параметру значение, равное идентификатору текущего процесса.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>hmask</parameter></term>
<listitem>
<simpara>
Маска привязки к процессору, которая состоит из одного или набора идентификаторов процессора для привязки процесса.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

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

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Функция выбрасывает ошибку <classname>TypeError</classname>,
если какой-то идентификатор центрального процессора в маске <parameter>hmask</parameter> оказался недопустимым.
Функция выбрасывает ошибку <classname>ValueError</classname>,
если в аргументе <parameter>pid</parameter> передали недопустимый идентификатор процесса
или не удалось создать маску процессора.
</simpara>
</refsect1>

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

0 comments on commit 037bacb

Please sign in to comment.