php-doc-en/reference/sem/reference.xml
Andrioli Darvin 0132bc2657 Typo fix
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@97548 c90b9560-bf6c-de11-be94-00142212c4b1
2002-09-30 19:50:45 +00:00

124 lines
3.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<reference id="ref.sem">
<title>Semaphore, Shared Memory and IPC Functions</title>
<titleabbrev>Semaphore</titleabbrev>
<partintro>
<section id="sem.intro">
&reftitle.intro;
<para>
This module provides wrappers for the System V IPC family of functions.
It includes semaphores, shared memory and inter-process messaging (IPC).
</para>
<para>
Semaphores may be used to provide exclusive access to
resources on the current machine, or to limit the number of
processes that may simultaneously use a resource.
</para>
<para>
This module provides also shared memory functions using System V
shared memory. Shared memory may be used to provide access to
global variables. Different httpd-daemons and even other programs
(such as Perl, C, ...) are able to access this data to provide a
global data-exchange. Remember, that shared memory is NOT safe
against simultaneous access. Use semaphores for synchronization.
<table>
<title>Limits of Shared Memory by the Unix OS</title>
<tgroup cols="2">
<tbody>
<row>
<entry>SHMMAX</entry>
<entry>max size of shared memory, normally 131072 bytes</entry>
</row>
<row>
<entry>SHMMIN</entry>
<entry>minimum size of shared memory, normally 1 byte</entry>
</row>
<row>
<entry>SHMMNI</entry>
<entry>
max amount of shared memory segments on a system,
normally 100
</entry>
</row>
<row>
<entry>SHMSEG</entry>
<entry>
max amount of shared memory segments per process, normally 6
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
The messaging functions may be used to send and receive messages to/from
other processes. They provide a simple and effective means of exchanging
data between processes, without the need for setting up an alternative
using unix domain sockets.
</para>
<note>
<simpara>
These functions do not work on Windows systems.
</simpara>
</note>
</section>
<section id="sem.requirements">
&reftitle.required;
&no.requirement;
</section>
<section id="sem.installation">
&reftitle.install;
<para>
Support for this functions are not enabled by default.
To enable System V semaphore support compile PHP with the option
<option role="configure">--enable-sysvsem</option>.
To enable the System V shared memory support compile PHP with the option
<option role="configure">--enable-sysvshm</option>.
To enable the System V messages support compile PHP with the option
<option role="configure">--enable-sysvmsg</option>.
</para>
</section>
&reference.sem.ini;
<section id="sem.resources">
&reftitle.resources;
<para>
</para>
</section>
<section id="sem.constants">
&reftitle.constants;
&no.constants;
</section>
</partintro>
&reference.sem.functions;
</reference>
<!-- 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:"../../../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
-->