VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-20 23:31:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(ru): Updated to English revision

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@351529 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Sergey Panteleev
2020-11-23 08:48:48 +00:00
parent e84be413cc
commit 0f9540c7a6
11 changed files with 359 additions and 143 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
reference/sem/functions/msg-get-queue.xml
View File

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 140520df708e705135b1738e0cdb3a251e7b21c1 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-get-queue"> <refentry xml:id="function.msg-get-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>msg_get_queue</refname> <refname>msg_get_queue</refname>
<refpurpose>Создание или подключение к очереди сообщений</refpurpose> <refpurpose>Создание или подключение к очереди сообщений</refpurpose>
@ -12,14 +12,14 @@
<refsect1 role="description"> <refsect1 role="description">
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>resource</type><methodname>msg_get_queue</methodname> <type class="union"><type>SysvMessageQueue</type><type>false</type></type><methodname>msg_get_queue</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam> <methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>perms</parameter><initializer>0666</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>msg_get_queue</function> возвращает идентификатор, который используется для <function>msg_get_queue</function> возвращает идентификатор, который используется для
доступа к очереди сообщений System V с указанным ключом <parameter>key</parameter>. доступа к очереди сообщений System V с указанным ключом <parameter>key</parameter>.
Первый вызов создаёт очередь сообщений с необязательными правами <parameter>perms</parameter>. Первый вызов создаёт очередь сообщений с необязательными правами <parameter>permissions</parameter>.
Второй и последующие вызовы <function>msg_get_queue</function> для того же <parameter>key</parameter> Второй и последующие вызовы <function>msg_get_queue</function> для того же <parameter>key</parameter>
будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же
очередь сообщений. очередь сообщений.
@ -39,11 +39,11 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>perms</parameter></term> <term><parameter>permissions</parameter></term>
<listitem> <listitem>
<para> <para>
Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует, Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует,
параметр <parameter>perms</parameter> игнорируется. параметр <parameter>permissions</parameter> игнорируется.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -54,8 +54,33 @@
<refsect1 role="returnvalues"> <refsect1 role="returnvalues">
&reftitle.returnvalues; &reftitle.returnvalues;
<para> <para>
Возвращает дескриптор ресурса, который может быть использован для доступа к очереди Возвращает экземпляр <classname>SysvMessageQueue</classname>, который может быть использован для доступа к очереди
сообщений System V. сообщений System V, &return.falseforfailure;.
</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>8.0.0</entry>
<entry>
В случае успешного выполнения функция теперь возвращает экземпляр <classname>SysvMessageQueue</classname>;
ранее возвращался ресурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para> </para>
</refsect1> </refsect1>
@ -73,7 +98,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

75
reference/sem/functions/msg-receive.xml
View File

@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3bc212c744fce74a36f3345ccd4a95bb3754ccd8 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xml:id="function.msg-receive" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-receive">
<refnamediv> <refnamediv>
<refname>msg_receive</refname> <refname>msg_receive</refname>
<refpurpose>Получение сообщения из очереди сообщений</refpurpose> <refpurpose>Получение сообщения из очереди сообщений</refpurpose>
@ -13,18 +12,18 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>msg_receive</methodname> <type>bool</type><methodname>msg_receive</methodname>
<methodparam><type>resource</type><parameter>queue</parameter></methodparam> <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
<methodparam><type>int</type><parameter>desiredmsgtype</parameter></methodparam> <methodparam><type>int</type><parameter>desired_message_type</parameter></methodparam>
<methodparam><type>int</type><parameter role="reference">msgtype</parameter></methodparam> <methodparam><type>int</type><parameter role="reference">received_message_type</parameter></methodparam>
<methodparam><type>int</type><parameter>maxsize</parameter></methodparam> <methodparam><type>int</type><parameter>max_message_size</parameter></methodparam>
<methodparam><type>mixed</type><parameter role="reference">message</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">message</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>unserialize</parameter><initializer>&true;</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>unserialize</parameter><initializer>&true;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter role="reference">errorcode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>msg_receive</function> получает первое сообщение из задаваемой параметром <function>msg_receive</function> получает первое сообщение из задаваемой параметром
<parameter>queue</parameter> очереди сообщений с типом, указанным в <parameter>desiredmsgtype</parameter>. <parameter>queue</parameter> очереди сообщений с типом, указанным в <parameter>desired_message_type</parameter>.
</para> </para>
</refsect1> </refsect1>
@ -36,19 +35,19 @@
<term><parameter>queue</parameter></term> <term><parameter>queue</parameter></term>
<listitem> <listitem>
<para> <para>
Идентификатор ресурса очереди. Очередь сообщений.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>desiredmsgtype</parameter></term> <term><parameter>desired_message_type</parameter></term>
<listitem> <listitem>
<para> <para>
Если в <parameter>desiredmsgtype</parameter> указано 0, возвращается первое Если в <parameter>desired_message_type</parameter> указано 0, возвращается первое
сообщение из очереди. Если <parameter>desiredmsgtype</parameter> больше 0, то сообщение из очереди. Если <parameter>desired_message_type</parameter> больше 0, то
возвращается первое сообщение с указанным типом. Если <parameter>desiredmsgtype</parameter> возвращается первое сообщение с указанным типом. Если <parameter>desired_message_type</parameter>
меньше 0, то возвращается первое сообщение с типом, меньшим или равным по модулю меньше 0, то возвращается первое сообщение с типом, меньшим или равным по модулю
указанному в <parameter>desiredmsgtype</parameter>. Если нет сообщений, указанному в <parameter>desired_message_type</parameter>. Если нет сообщений,
соответствующих критериям, ваш скрипт ожидает их появления в очереди. соответствующих критериям, ваш скрипт ожидает их появления в очереди.
Вы можете изменить это поведение, указав <constant>MSG_IPC_NOWAIT</constant> в Вы можете изменить это поведение, указав <constant>MSG_IPC_NOWAIT</constant> в
параметре <parameter>flags</parameter>. параметре <parameter>flags</parameter>.
@ -56,7 +55,7 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>msgtype</parameter></term> <term><parameter>received_message_type</parameter></term>
<listitem> <listitem>
<para> <para>
В этом параметре сохраняется тип полученного сообщения. В этом параметре сохраняется тип полученного сообщения.
@ -64,10 +63,10 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>maxsize</parameter></term> <term><parameter>max_message_size</parameter></term>
<listitem> <listitem>
<para> <para>
Максимальный размер принимаемого сообщения задаётся в <parameter>maxsize</parameter>; Максимальный размер принимаемого сообщения задаётся в <parameter>max_message_size</parameter>;
если сообщение в очереди больше этого размера, то функция завершается ошибкой если сообщение в очереди больше этого размера, то функция завершается ошибкой
(если вы не установите <parameter>flags</parameter> как описано ниже). (если вы не установите <parameter>flags</parameter> как описано ниже).
</para> </para>
@ -113,7 +112,7 @@
<row> <row>
<entry><constant>MSG_IPC_NOWAIT</constant></entry> <entry><constant>MSG_IPC_NOWAIT</constant></entry>
<entry> <entry>
Если нет сообщений, удовлетворяющих условиям <parameter>desiredmsgtype</parameter>, Если нет сообщений, удовлетворяющих условиям <parameter>desired_message_type</parameter>,
возвращаться немедленно, а не ждать. Функция завершается ошибкой и возвращает возвращаться немедленно, а не ждать. Функция завершается ошибкой и возвращает
целочисленное значение <constant>MSG_ENOMSG</constant>. целочисленное значение <constant>MSG_ENOMSG</constant>.
</entry> </entry>
@ -122,15 +121,15 @@
<entry><constant>MSG_EXCEPT</constant></entry> <entry><constant>MSG_EXCEPT</constant></entry>
<entry> <entry>
Использование этого флага в комбинации с указынным в Использование этого флага в комбинации с указынным в
<parameter>desiredmsgtype</parameter> положительным значением, <parameter>desired_message_type</parameter> положительным значением,
позволяет получить первое сообщение, тип которого не равен значению позволяет получить первое сообщение, тип которого не равен значению
<parameter>desiredmsgtype</parameter>.</entry> <parameter>desired_message_type</parameter>.</entry>
</row> </row>
<row> <row>
<entry><constant>MSG_NOERROR</constant></entry> <entry><constant>MSG_NOERROR</constant></entry>
<entry> <entry>
Если размер сообщения превышает <parameter>maxsize</parameter>, Если размер сообщения превышает <parameter>max_message_size</parameter>,
то установка этого флага приводит к усечению сообщения до <parameter>maxsize</parameter> то установка этого флага приводит к усечению сообщения до <parameter>max_message_size</parameter>
без сигнализирования об ошибке. без сигнализирования об ошибке.
</entry> </entry>
</row> </row>
@ -141,10 +140,10 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>errorcode</parameter></term> <term><parameter>error_code</parameter></term>
<listitem> <listitem>
<para> <para>
Если функция завершается аварийно, необязательный параметр <parameter>errorcode</parameter> Если функция завершается аварийно, необязательный параметр <parameter>error_code</parameter>
будет содержать значение системной переменной errno. будет содержать значение системной переменной errno.
</para> </para>
</listitem> </listitem>
@ -166,6 +165,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -179,7 +203,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

34
reference/sem/functions/msg-remove-queue.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-remove-queue"> <refentry xml:id="function.msg-remove-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>msg_remove_queue</refname> <refname>msg_remove_queue</refname>
<refpurpose>Удаление очереди сообщений</refpurpose> <refpurpose>Удаление очереди сообщений</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>msg_remove_queue</methodname> <type>bool</type><methodname>msg_remove_queue</methodname>
<methodparam><type>resource</type><parameter>queue</parameter></methodparam> <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>msg_remove_queue</function> удаляет очередь сообщений, указанную в <function>msg_remove_queue</function> удаляет очередь сообщений, указанную в
@ -30,7 +30,7 @@
<term><parameter>queue</parameter></term> <term><parameter>queue</parameter></term>
<listitem> <listitem>
<para> <para>
Дескриптор ресурса очереди сообщений Очередь сообщений.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -45,6 +45,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -58,7 +83,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

49
reference/sem/functions/msg-send.xml
View File

@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xml:id="function.msg-send" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-send">
<refnamediv> <refnamediv>
<refname>msg_send</refname> <refname>msg_send</refname>
<refpurpose>Отправка сообщения в очередь сообщений</refpurpose> <refpurpose>Отправка сообщения в очередь сообщений</refpurpose>
@ -13,16 +12,16 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>msg_send</methodname> <type>bool</type><methodname>msg_send</methodname>
<methodparam><type>resource</type><parameter>queue</parameter></methodparam> <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
<methodparam><type>int</type><parameter>msgtype</parameter></methodparam> <methodparam><type>int</type><parameter>message_type</parameter></methodparam>
<methodparam><type>mixed</type><parameter>message</parameter></methodparam> <methodparam><type class="union"><type>string</type><type>int</type><type>float</type><type>bool</type></type><parameter>message</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>serialize</parameter><initializer>&true;</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>serialize</parameter><initializer>&true;</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>blocking</parameter><initializer>&true;</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>blocking</parameter><initializer>&true;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter role="reference">errorcode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>msg_send</function> отправляет сообщение <parameter>message</parameter> <function>msg_send</function> отправляет сообщение <parameter>message</parameter>
с типом <parameter>msgtype</parameter> (должно быть больше 0) в очередь сообщений, с типом <parameter>message_type</parameter> (должно быть больше 0) в очередь сообщений,
указанную параметром <parameter>queue</parameter>. указанную параметром <parameter>queue</parameter>.
</para> </para>
</refsect1> </refsect1>
@ -35,12 +34,12 @@
<term><parameter>queue</parameter></term> <term><parameter>queue</parameter></term>
<listitem> <listitem>
<para> <para>
Идентификатор ресурса очереди. Очередь сообщений.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>msgtype</parameter></term> <term><parameter>message_type</parameter></term>
<listitem> <listitem>
<para> <para>
Тип сообщения. Должно быть больше 0. Тип сообщения. Должно быть больше 0.
@ -86,14 +85,14 @@
Это называется блокировкой; вы можете отключить эту возможность, Это называется блокировкой; вы можете отключить эту возможность,
установив для <parameter>blocking</parameter> значение &false;, в этом случае установив для <parameter>blocking</parameter> значение &false;, в этом случае
<function>msg_send</function> будет немедленно возвращать &false; если сообщение <function>msg_send</function> будет немедленно возвращать &false; если сообщение
слишком велико, и устанавливать необязательный параметр <parameter>errorcode</parameter> слишком велико, и устанавливать необязательный параметр <parameter>error_code</parameter>
в значение <constant>MSG_EAGAIN</constant>, что будет указывать вам на в значение <constant>MSG_EAGAIN</constant>, что будет указывать вам на
необходимость попробовать отправить сообщение несколько позже. необходимость попробовать отправить сообщение несколько позже.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>errorcode</parameter></term> <term><parameter>error_code</parameter></term>
<listitem> <listitem>
<para> <para>
Если функция отработает неудачно, то этот код будет записан в системную переменную errno. Если функция отработает неудачно, то этот код будет записан в системную переменную errno.
@ -117,6 +116,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -130,7 +154,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

34
reference/sem/functions/msg-set-queue.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-set-queue"> <refentry xml:id="function.msg-set-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>msg_set_queue</refname> <refname>msg_set_queue</refname>
<refpurpose>Установка информации в структуре данных очереди сообщений</refpurpose> <refpurpose>Установка информации в структуре данных очереди сообщений</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>msg_set_queue</methodname> <type>bool</type><methodname>msg_set_queue</methodname>
<methodparam><type>resource</type><parameter>queue</parameter></methodparam> <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
<methodparam><type>array</type><parameter>data</parameter></methodparam> <methodparam><type>array</type><parameter>data</parameter></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
@ -36,7 +36,7 @@
<term><parameter>queue</parameter></term> <term><parameter>queue</parameter></term>
<listitem> <listitem>
<para> <para>
Дескриптор ресурса очереди сообщений. Очередь сообщений.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -59,6 +59,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -72,7 +97,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

41
reference/sem/functions/msg-stat-queue.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes --> <!-- Reviewed: yes -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-stat-queue"> <refentry xml:id="function.msg-stat-queue" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>msg_stat_queue</refname> <refname>msg_stat_queue</refname>
<refpurpose>Получение информации из структуры данных очереди сообщений</refpurpose> <refpurpose>Получение информации из структуры данных очереди сообщений</refpurpose>
@ -11,8 +11,8 @@
<refsect1 role="description"> <refsect1 role="description">
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>array</type><methodname>msg_stat_queue</methodname> <type class="union"><type>array</type><type>false</type></type><methodname>msg_stat_queue</methodname>
<methodparam><type>resource</type><parameter>queue</parameter></methodparam> <methodparam><type>SysvMessageQueue</type><parameter>queue</parameter></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>msg_stat_queue</function> возвращает мета-данные очереди сообщений, <function>msg_stat_queue</function> возвращает мета-данные очереди сообщений,
@ -29,7 +29,7 @@
<term><parameter>queue</parameter></term> <term><parameter>queue</parameter></term>
<listitem> <listitem>
<para> <para>
Дескриптор ресурса очереди сообщений. Очередь сообщений.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -40,7 +40,7 @@
<refsect1 role="returnvalues"> <refsect1 role="returnvalues">
&reftitle.returnvalues; &reftitle.returnvalues;
<para> <para>
Возвращаемое значение является массивом, ключи и значения которого означают следующее: В случае успешного выполнения возвращаемое значение представляет собой массив, ключи и значения которого означают следующее:
<table> <table>
<title>Структура массива для msg_stat_queue</title> <title>Структура массива для msg_stat_queue</title>
<tgroup cols="2"> <tgroup cols="2">
@ -111,6 +111,34 @@
</tgroup> </tgroup>
</table> </table>
</para> </para>
<para>
Возвращает &false; в случае возникновения ошибки.
</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>8.0.0</entry>
<entry>
Параметр <parameter>queue</parameter> теперь ожидает экземпляр <classname>SysvMessageQueue</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1> </refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
@ -126,7 +154,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

20
reference/sem/functions/sem-acquire.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: rjhdby Status: ready --> <!-- EN-Revision: 105769eb557af47e5f2d0bea47457827114942fa Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey --> <!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-acquire"> <refentry xml:id="function.sem-acquire" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>sem_acquire</refname> <refname>sem_acquire</refname>
<refpurpose>Захват семафора</refpurpose> <refpurpose>Захват семафора</refpurpose>
@ -12,8 +12,8 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>sem_acquire</methodname> <type>bool</type><methodname>sem_acquire</methodname>
<methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam> <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>nowait</parameter><initializer>&false;</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>non_blocking</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>sem_acquire</function> блокируется (при необходимости) до момента захвата <function>sem_acquire</function> блокируется (при необходимости) до момента захвата
@ -31,15 +31,15 @@
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><parameter>sem_identifier</parameter></term> <term><parameter>semaphore</parameter></term>
<listitem> <listitem>
<para> <para>
<parameter>sem_identifier</parameter> - это ресурс семафора, полученный из <function>sem_get</function>. <parameter>semaphore</parameter> - семафор.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>nowait</parameter></term> <term><parameter>non_blocking</parameter></term>
<listitem> <listitem>
<para> <para>
Указывает, должен ли процесс ждать для захвата семафора. Указывает, должен ли процесс ждать для захвата семафора.
@ -72,9 +72,10 @@
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry>5.6.1</entry> <entry>8.0.0</entry>
<entry> <entry>
Добавлен параметр <parameter>$nowait</parameter>. Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry> </entry>
</row> </row>
</tbody> </tbody>
@ -94,7 +95,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

45
reference/sem/functions/sem-get.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 54a343afdc91671e6dc77b8dceb2e8116223337d Maintainer: rjhdby Status: ready --> <!-- EN-Revision: 105769eb557af47e5f2d0bea47457827114942fa Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey --> <!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get"> <refentry xml:id="function.sem-get" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>sem_get</refname> <refname>sem_get</refname>
<refpurpose>Получение идентификатора семафора</refpurpose> <refpurpose>Получение идентификатора семафора</refpurpose>
@ -11,11 +11,11 @@
<refsect1 role="description"> <refsect1 role="description">
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>resource</type><methodname>sem_get</methodname> <type class="union"><type>SysvSemaphore</type><type>false</type></type><methodname>sem_get</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam> <methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>max_acquire</parameter><initializer>1</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>max_acquire</parameter><initializer>1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>auto_release</parameter><initializer>1</initializer></methodparam> <methodparam choice="opt"><type>bool</type><parameter>auto_release</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>sem_get</function> возвращает идентификатор, который может быть использован <function>sem_get</function> возвращает идентификатор, который может быть использован
@ -53,7 +53,7 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>perm</parameter></term> <term><parameter>permissions</parameter></term>
<listitem> <listitem>
<para> <para>
Права доступа к семафору. В действительности, устанавливается только если процесс Права доступа к семафору. В действительности, устанавливается только если процесс
@ -80,6 +80,38 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
В случае успешного выполнения функция возвращает экземпляр <classname>SysvSemaphore</classname>;
ранее возвращался ресурс (<type>resource</type>).
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Тип <parameter>auto_release</parameter> изменен с
целого числа (<type>int</type>) на логическое значение (<type>bool</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes"> <refsect1 role="notes">
&reftitle.notes; &reftitle.notes;
<warning> <warning>
@ -105,7 +137,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

36
reference/sem/functions/sem-release.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: 105769eb557af47e5f2d0bea47457827114942fa Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey --> <!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-release"> <refentry xml:id="function.sem-release" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>sem_release</refname> <refname>sem_release</refname>
<refpurpose>Освобождение семафора</refpurpose> <refpurpose>Освобождение семафора</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>sem_release</methodname> <type>bool</type><methodname>sem_release</methodname>
<methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam> <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>sem_release</function> освобождает семафор, если он был захвачен вызывающим <function>sem_release</function> освобождает семафор, если он был захвачен вызывающим
@ -28,10 +28,10 @@
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><parameter>sem_identifier</parameter></term> <term><parameter>semaphore</parameter></term>
<listitem> <listitem>
<para> <para>
Ресурс семафора, возвращённый <function>sem_get</function>. Семафор, возвращённый <function>sem_get</function>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -46,6 +46,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -57,7 +82,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

36
reference/sem/functions/sem-remove.xml
View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4efe5aed3d12acd22b3d5102725eff2ec4c7803c Maintainer: rjhdby Status: ready --> <!-- EN-Revision: 105769eb557af47e5f2d0bea47457827114942fa Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: sergey --> <!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ --> <!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-remove"> <refentry xml:id="function.sem-remove" xmlns="http://docbook.org/ns/docbook">
<refnamediv> <refnamediv>
<refname>sem_remove</refname> <refname>sem_remove</refname>
<refpurpose>Удаление семафора</refpurpose> <refpurpose>Удаление семафора</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>bool</type><methodname>sem_remove</methodname> <type>bool</type><methodname>sem_remove</methodname>
<methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam> <methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>sem_remove</function> удаляет указанный семафор. <function>sem_remove</function> удаляет указанный семафор.
@ -27,10 +27,10 @@
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><parameter>sem_identifier</parameter></term> <term><parameter>semaphore</parameter></term>
<listitem> <listitem>
<para> <para>
Идентификатор семафора, возвращённый <function>sem_get</function>. Cемафор, возвращённый <function>sem_get</function>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -45,6 +45,31 @@
</para> </para>
</refsect1> </refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
&reftitle.seealso; &reftitle.seealso;
<para> <para>
@ -57,7 +82,6 @@
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml

88
reference/sem/functions/shm-attach.xml
View File

@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: rjhdby Status: ready --> <!-- EN-Revision: 395ea247cf337110d795979e14841617aa9cefa9 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no --> <!-- Reviewed: no -->
<refentry xml:id="function.shm-attach" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-attach">
<refnamediv> <refnamediv>
<refname>shm_attach</refname> <refname>shm_attach</refname>
<refpurpose>Создаёт или открывает сегмент разделяемой памяти</refpurpose> <refpurpose>Создаёт или открывает сегмент разделяемой памяти</refpurpose>
@ -12,23 +11,23 @@
<refsect1 role="description"> <refsect1 role="description">
&reftitle.description; &reftitle.description;
<methodsynopsis> <methodsynopsis>
<type>resource</type><methodname>shm_attach</methodname> <type class="union"><type>SysvSharedMemory</type><type>false</type></type><methodname>shm_attach</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam> <methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>memsize</parameter></methodparam> <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>size</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
</methodsynopsis> </methodsynopsis>
<para> <para>
<function>shm_attach</function> возвращает идентификатор, который можно использовать <function>shm_attach</function> возвращает идентификатор, который можно использовать
для доступа к разделяемой памяти System V по заданному ключу <parameter>key</parameter>. Первый для доступа к разделяемой памяти System V по заданному ключу <parameter>key</parameter>. Первый
вызов создаёт сегмент размером <parameter>memsize</parameter> и опциональными битами прав доступа вызов создаёт сегмент размером <parameter>size</parameter> и опциональными битами прав доступа
<parameter>perm</parameter>. <parameter>permissions</parameter>.
</para> </para>
<para> <para>
Следующий вызов <function>shm_attach</function> с тем же ключём Следующий вызов <function>shm_attach</function> с тем же ключём
<parameter>key</parameter> вернёт другой идентификатор, но они оба будут <parameter>key</parameter> вернёт другой экземпляр <classname>SysvSharedMemory</classname>, но они оба будут
указывать на один и тот же сегмент разделяемой памяти. указывать на один и тот же сегмент разделяемой памяти.
Параметры <parameter>memsize</parameter> и Параметры <parameter>size</parameter> и
<parameter>perm</parameter> будут проигнорированы. <parameter>permissions</parameter> будут проигнорированы.
</para> </para>
</refsect1> </refsect1>
@ -45,7 +44,7 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>memsize</parameter></term> <term><parameter>size</parameter></term>
<listitem> <listitem>
<para> <para>
Размер памяти. Если не задан, то по умолчанию будет использоваться Размер памяти. Если не задан, то по умолчанию будет использоваться
@ -55,7 +54,7 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>perm</parameter></term> <term><parameter>permissions</parameter></term>
<listitem> <listitem>
<para> <para>
Опциональные биты прав доступа. По умолчанию 0666. Опциональные биты прав доступа. По умолчанию 0666.
@ -69,43 +68,37 @@
<refsect1 role="returnvalues"> <refsect1 role="returnvalues">
&reftitle.returnvalues; &reftitle.returnvalues;
<para> <para>
Возвращает идентификатор разделяемой памяти. Возвращает экземпляр <classname>SysvSharedMemory</classname> в случае усупешного выполнения, &return.falseforfailure;.
</para> </para>
</refsect1> </refsect1>
<refsect1 role="notes"> <refsect1 role="changelog">
&reftitle.notes; &reftitle.changelog;
<note> <informaltable>
<para> <tgroup cols="2">
До PHP 5.3.0. эта функция возвращала целое число. Что бы добиться <thead>
переносимости кода, можно использовать приведение к целому, таким образом: <row>
</para> <entry>&Version;</entry>
<para> <entry>&Description;</entry>
<example> </row>
<programlisting role="php"> </thead>
<![CDATA[ <tbody>
<?php <row>
// Создаём временный файл и возвращаем путь к нему <entry>8.0.0</entry>
$tmp = tempnam('/tmp', 'PHP'); <entry>
В случае успешного выполнения функция возвращает экземпляр <classname>SysvSharedMemory</classname>;
// Преобразуем в ключ-токен ранее возвращался ресурс (<type>resource</type>).
$key = ftok($tmp, 'a'); </entry>
</row>
// Присоединяем ресурс SHM <row>
$id = shm_attach($key); <entry>8.0.0</entry>
<entry>
if ($id === false) { <parameter>size</parameter> теперь допускает значение null.
die('Невозможно создать сегмент разделяемой памяти'); </entry>
} </row>
</tbody>
// Приводим к целому числу </tgroup>
$id = (integer) $id; </informaltable>
?>
]]>
</programlisting>
</example>
</para>
</note>
</refsect1> </refsect1>
<refsect1 role="seealso"> <refsect1 role="seealso">
@ -119,7 +112,6 @@ $id = (integer) $id;
</refsect1> </refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml