cynic Mon Feb 5 04:45:56 2001 EDT
Added files:
/phpdoc/cs/functions sem.xml
Log:
should be completely translated
Index: phpdoc/cs/functions/sem.xml
+++ phpdoc/cs/functions/sem.xml
<reference id="ref.sem">
<title>Funkce pro pr�ci se semafory a sd�lenou pam�t�</title>
<titleabbrev>Semaphore</titleabbrev>
<partintro>
<para>
Tato extenze poskytuje semaforov� funkce vyu��vaj�c� System V semafory.
Semafory se daj� pou��vat k poskytov�n� exkluzivn�ho p��stupu k prost�edk�m
na dan�m syst�mu, nebo k omezen� po�tu proces�, kter� mohou sou�asn� pou��vat
ur�it� prost�edek.
</para>
<para>
Tato extenze tak� poskytuje funkce pro pr�ci se sd�lenou pam�t� vyu��vaj�c�
System V sd�lenou pam�. Sd�len� pm�t se d� pou��vat k poskytov�n� p��stupu
ke glob�ln�m prom�nn�m. R�zn� httpd-daemoni a dokonce i jin� programy (nap�.
Perl, C, ...) mohou k t�mto dat�m p�istupovat, a vytvo�it tak glob�ln� v�m�nu
dat. Pamatujte, �e sd�len� pam� <emphasis>nen�</emphasis> chr�n�na proti
simult�n�m p��stup�m. K synchronizaci pou�ijte semafory.
<table>
<title>Omezen� sd�len� pam�ti syst�mem Unix</title>
<tgroup cols="2">
<tbody>
<row>
<entry>SHMMAX</entry>
<entry>max. velikost sd�len� pam�ti, norm�ln� 131072 byt�</entry>
</row>
<row>
<entry>SHMMIN</entry>
<entry>min. velikost sd�len� pam�ti, norm�lne 1 byte</entry>
</row>
<row>
<entry>SHMMNI</entry>
<entry>max. po�et segment� sd�len� pam�ti, norm�ln� 100</entry>
</row>
<row>
<entry>SHMSEG</entry>
<entry>max. po�et segment� sd�len� pam�ti na proces, norm�ln� 6</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<note>
<simpara>
Tyto funkce nefunguj� na Windows.
</simpara>
</note>
</partintro>
<refentry id="function.sem-get">
<refnamediv>
<refname>sem_get</refname>
<refpurpose>Z�skat id semaforu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>sem_get</function></funcdef>
<paramdef>int <parameter>key</parameter></paramdef>
<paramdef>int
<parameter><optional>max_acquire</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>perm</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� idenfifik�tor semaforu nebo <literal>false</literal>.
</para>
<para>
<function>sem_get</function> vrac� id, kter� se d� pou��t k p��stupu k
System V semaforu s dan�m kl��em. Podle pot�eby se vytvo�� nov� semafor
s p��stupov�mi pr�vy definovan�mi v <parameter>perm</parameter> (default je
0666). Po�et proces�, kter� mohou tento semafor z�skat sou�asn� je
<parameter>max_acquire</parameter> (default je 1). Tato hodnota je ale
nastavena pouze pokud tento proces zjist�, �e k tomuto semaforu nen� sou�asn�
p�ipojen jin� proces.
</para>
<para>
Druh� vol�n� <function>sem_get</function> se stejn�m <parameter>key</parameter>
vr�t� jin� identifik�tor semaforu, ale oba identifik�tory ukazuj� na stejn�
semafor.
</para>
<para>
Viz tak�: <function>sem_acquire</function> a
<function>sem_release</function>.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.sem-acquire">
<refnamediv>
<refname>sem_acquire</refname>
<refpurpose>Z�skat semafor</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>sem_acquire</function></funcdef>
<paramdef>int <parameter>sem_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�i �sp�chu vrac� <literal>true</literal>, p�i chyb�
<literal>false</literal>.
</para>
<para>
<function>sem_acquire</function> blokuje (pokud je opt�eba) a� do z�sk�n�
semaforu. Proces pokou�ej�c� se z�skat semafor, kter� u� z�skal bude
blokovat nav�ky, pokud by z�sk�n� tohoto semaforu zp�sobilo p�ekro�en� jeho
hodnoty max_acquire.
</para>
<para>
Po zpracov�n� po�adavku se v�echny z�skan�, ale explicitn� neuvoln�n�
semafoty uvoln� automaticky, a vygeneruje se varov�n�.
</para>
<para>
Viz tak�: <function>sem_get</function> a
<function>sem_release</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.sem-release">
<refnamediv>
<refname>sem_release</refname>
<refpurpose>Uvolnit semafor</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>sem_release</function></funcdef>
<paramdef>int <parameter>sem_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�i �sp�chu vrac� <literal>true</literal>, jinak <literal>false</literal>.
</para>
<para>
<function>sem_release</function> uvol�� semafor, pokud ho volaj�c� proces
dr��, jinak se vygeneruje varov�n�.
</para>
<para>
Po uvoln�n� m��e b�t semafor znovu z�sk�n pomoc�
<function>sem_acquire</function>.
</para>
<para>
Viz tak�: <function>sem_get</function> a
<function>sem_acquire</function>.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.shm-attach">
<refnamediv>
<refname>shm_attach</refname>
<refpurpose>Vytvo�it nebo otev��t segment sd�len� pam�ti</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_attach</function></funcdef>
<paramdef>int <parameter>key</parameter></paramdef>
<paramdef>int
<parameter><optional>memsize</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>perm</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>shm_attach</function> vrac� id, kter� se d� pou��t k p��stupu k
System V sd�len� pam�ti s dan�m kl��em; prvn� vol�n� vytvo�� segment pam�ti
o velikosti mem_size (default: sysvshm.init_mem v <link
linkend="configuration.file">konfigura�n�m souboru</link>, jinak
10000 byt�) a s voliteln�mi pr�vy (default: 0666).
</para>
<para>
Druh� vol�n� <function>shm_attach</function> se stejn�m
<parameter>key</parameter> vr�t� jin� identifik�to, ale oba ukazuj� na
stejnou sd�lenou pam�. <parameter>memsize</parameter> a
<parameter>perm</parameter> se v takov�m p��pad� ignoruj�.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.shm-detach">
<refnamediv>
<refname>shm_detach</refname>
<refpurpose>Odpojit se od segmentu sd�len� pam�ti</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_detach</function></funcdef>
<paramdef>int <parameter>shm_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>shm_detach</function> odpojuje od sd�len� pam�ti identifikovan�
<parameter>shm_identifier</parameter> vytvo�en�m
<function>shm_attach</function>. Pamatujte, �e tato sd�len� pam� d�l
existuje a dr�� si data.
</para>
</refsect1>
</refentry>
<refentry id="function.shm-remove">
<refnamediv>
<refname>shm_remove</refname>
<refpurpose>Odstranit sd�lenou pam� ze syst�mu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_remove</function></funcdef>
<paramdef>int <parameter>shm_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Odstran� sd�lenou pam� z UNIXov�ho syst�mu. V�echna data v n� budou zni�ena.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.shm-put-var">
<refnamediv>
<refname>shm_put_var</refname>
<refpurpose>Vlo�it nebo modifikovat prom�nnou do sd�len� pam�ti</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_put_var</function></funcdef>
<paramdef>int <parameter>shm_identifier</parameter></paramdef>
<paramdef>int <parameter>variable_key</parameter></paramdef>
<paramdef>mixed <parameter>variable</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vlo�� nebo modifikuje <parameter>variable</parameter> s dan�m
<parameter>variable_key</parameter>. V�echny typy prom�nn�ch (double,
int, string, array) jsou podporov�ny.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.shm-get-var">
<refnamediv>
<refname>shm_get_var</refname>
<refpurpose>Vr�tit prom�nnou ze sd�len� pam�ti</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>shm_get_var</function></funcdef>
<paramdef>int <parameter>id</parameter></paramdef>
<paramdef>int <parameter>variable_key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>shm_get_var</function> vrac� prom�nnou s dan�m
<parameter>variable_key</parameter>. Prom�nn� z�st�v� ve sd�len� pam�ti.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.shm-remove-var">
<refnamediv>
<refname>shm_remove_var</refname>
<refpurpose>Odstranit prom�nnou ze sd�len� pam�ti</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_remove_var</function></funcdef>
<paramdef>int <parameter>id</parameter></paramdef>
<paramdef>int <parameter>variable_key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Odstran� prom�nnou s dan�m<parameter>variable_key</parameter> a uvoln�
zabranou pam�.
</para>
<note>
<simpara>
Tato funkce nefunguje na Windows.
</simpara>
</note>
</refsect1>
</refentry>
</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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
