docs(ru): Updated to English revision

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

View File

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 140520df708e705135b1738e0cdb3a251e7b21c1 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $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>
<refname>msg_get_queue</refname>
<refpurpose>Создание или подключение к очереди сообщений</refpurpose>
@ -12,14 +12,14 @@
<refsect1 role="description">
&reftitle.description;
<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 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>
<para>
<function>msg_get_queue</function> возвращает идентификатор, который используется для
доступа к очереди сообщений System V с указанным ключом <parameter>key</parameter>.
Первый вызов создаёт очередь сообщений с необязательными правами <parameter>perms</parameter>.
Первый вызов создаёт очередь сообщений с необязательными правами <parameter>permissions</parameter>.
Второй и последующие вызовы <function>msg_get_queue</function> для того же <parameter>key</parameter>
будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же
очередь сообщений.
@ -39,11 +39,11 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>perms</parameter></term>
<term><parameter>permissions</parameter></term>
<listitem>
<para>
Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует,
параметр <parameter>perms</parameter> игнорируется.
параметр <parameter>permissions</parameter> игнорируется.
</para>
</listitem>
</varlistentry>
@ -54,11 +54,36 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает дескриптор ресурса, который может быть использован для доступа к очереди
сообщений System V.
Возвращает экземпляр <classname>SysvMessageQueue</classname>, который может быть использован для доступа к очереди
сообщений 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>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -73,7 +98,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

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

View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $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>
<refname>msg_remove_queue</refname>
<refpurpose>Удаление очереди сообщений</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<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>
<para>
<function>msg_remove_queue</function> удаляет очередь сообщений, указанную в
@ -30,7 +30,7 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
Дескриптор ресурса очереди сообщений
Очередь сообщений.
</para>
</listitem>
</varlistentry>
@ -44,6 +44,31 @@
&return.success;
</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 role="seealso">
&reftitle.seealso;
@ -58,7 +83,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

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

View File

@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f7e33278a909d7f7bf491f77cb10c93581091736 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $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>
<refname>msg_set_queue</refname>
<refpurpose>Установка информации в структуре данных очереди сообщений</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<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>
</methodsynopsis>
<para>
@ -36,7 +36,7 @@
<term><parameter>queue</parameter></term>
<listitem>
<para>
Дескриптор ресурса очереди сообщений.
Очередь сообщений.
</para>
</listitem>
</varlistentry>
@ -58,6 +58,31 @@
&return.success;
</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 role="seealso">
&reftitle.seealso;
@ -72,7 +97,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

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

View File

@ -1,8 +1,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 -->
<!-- $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>
<refname>sem_acquire</refname>
<refpurpose>Захват семафора</refpurpose>
@ -12,8 +12,8 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>sem_acquire</methodname>
<methodparam><type>resource</type><parameter>sem_identifier</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>nowait</parameter><initializer>&false;</initializer></methodparam>
<methodparam><type>SysvSemaphore</type><parameter>semaphore</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>non_blocking</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>sem_acquire</function> блокируется (при необходимости) до момента захвата
@ -31,15 +31,15 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>sem_identifier</parameter></term>
<term><parameter>semaphore</parameter></term>
<listitem>
<para>
<parameter>sem_identifier</parameter> - это ресурс семафора, полученный из <function>sem_get</function>.
<parameter>semaphore</parameter> - семафор.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nowait</parameter></term>
<term><parameter>non_blocking</parameter></term>
<listitem>
<para>
Указывает, должен ли процесс ждать для захвата семафора.
@ -72,9 +72,10 @@
</thead>
<tbody>
<row>
<entry>5.6.1</entry>
<entry>8.0.0</entry>
<entry>
Добавлен параметр <parameter>$nowait</parameter>.
Параметр <parameter>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
@ -94,7 +95,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@ -1,8 +1,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 -->
<!-- $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>
<refname>sem_get</refname>
<refpurpose>Получение идентификатора семафора</refpurpose>
@ -11,11 +11,11 @@
<refsect1 role="description">
&reftitle.description;
<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 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>auto_release</parameter><initializer>1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>auto_release</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
<function>sem_get</function> возвращает идентификатор, который может быть использован
@ -53,7 +53,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>perm</parameter></term>
<term><parameter>permissions</parameter></term>
<listitem>
<para>
Права доступа к семафору. В действительности, устанавливается только если процесс
@ -80,6 +80,38 @@
</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>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">
&reftitle.notes;
<warning>
@ -105,7 +137,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@ -1,8 +1,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 -->
<!-- $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>
<refname>sem_release</refname>
<refpurpose>Освобождение семафора</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<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>
<para>
<function>sem_release</function> освобождает семафор, если он был захвачен вызывающим
@ -28,10 +28,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>sem_identifier</parameter></term>
<term><parameter>semaphore</parameter></term>
<listitem>
<para>
Ресурс семафора, возвращённый <function>sem_get</function>.
Семафор, возвращённый <function>sem_get</function>.
</para>
</listitem>
</varlistentry>
@ -46,6 +46,31 @@
</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>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -57,7 +82,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@ -1,8 +1,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 -->
<!-- $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>
<refname>sem_remove</refname>
<refpurpose>Удаление семафора</refpurpose>
@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<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>
<para>
<function>sem_remove</function> удаляет указанный семафор.
@ -27,10 +27,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>sem_identifier</parameter></term>
<term><parameter>semaphore</parameter></term>
<listitem>
<para>
Идентификатор семафора, возвращённый <function>sem_get</function>.
Cемафор, возвращённый <function>sem_get</function>.
</para>
</listitem>
</varlistentry>
@ -45,6 +45,31 @@
</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>semaphore</parameter> теперь ожидает экземпляр <classname>SysvSemaphore</classname>;
ранее ожидался русурс (<type>resource</type>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -57,7 +82,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

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