cvs: phpdoc-de /reference/shmop/functions shmop-close.xml shmop-delete.xml shmop-open.xml shmop-read.xml shmop-size.xml shmop-write.xml
| From: | Cornelia Boenigk | Date: | Tue, 08 Jul 2008 00:56:39 +0000 |
| Subject: | cvs: phpdoc-de /reference/shmop/functions shmop-close.xml shmop-delete.xml shmop-open.xml shmop-read.xml shmop-size.xml shmop-write.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2718@lists.php.net to get a copy of this message | ||
conni Tue Jul 8 00:56:39 2008 UTC
Modified files:
/phpdoc-de/reference/shmop/functions shmop-close.xml shmop-size.xml
shmop-read.xml shmop-open.xml
shmop-delete.xml
shmop-write.xml
Log:
alte Dateien mit neuer Struktur
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-close.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-close.xml diff -u phpdoc-de/reference/shmop/functions/shmop-close.xml:1.6 phpdoc-de/reference/shmop/functions/shmop-close.xml:1.7 --- phpdoc-de/reference/shmop/functions/shmop-close.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-close.xml Tue Jul 8 00:56:38 2008 @@ -1,44 +1,80 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_close</refname> - <refpurpose>Schliesst einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_close</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_close</function> wird benutzt, um einen gemeinsamen - Speicherblock zu schliessen. - </para> - <para> - <function>shmop_close</function> benötigt <parameter>shmid</parameter>, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. - </para> - <para> - <example> - <title>Einen gemeinsamen Speicherblock schliessen</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_close</refname> + <refpurpose>Schliesst einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>shmop_close</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_close</function> wird benutzt, um einen gemeinsamen + Speicherblock zu schliessen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen gemeinsamen Speicherblock schliessen</title> + <programlisting role="php"> <![CDATA[ <?php shmop_close($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wird der gemeinsame Speicherblock mit dem Bezeichner - <literal>$shm_id</literal> geschlossen. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wird der gemeinsame Speicherblock + <literal>$shm_id</literal> wieder geschlossen. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_open</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + + + + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-size.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-size.xml diff -u phpdoc-de/reference/shmop/functions/shmop-size.xml:1.2 phpdoc-de/reference/shmop/functions/shmop-size.xml:1.3 --- phpdoc-de/reference/shmop/functions/shmop-size.xml:1.2 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-size.xml Tue Jul 8 00:56:38 2008 @@ -1,49 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'size' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-size" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_size</refname> - <refpurpose>Gibt die Grösse des gemeinsamen Speicherblocks zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_size</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_size</function> wird benutzt, um die Grösse eines +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-size" xmlns="http://docbook.org/ns/docbook"> +<refnamediv> + <refname>shmop_size</refname> + <refpurpose>Gibt die Grösse des gemeinsamen Speicherblocks zurück</refpurpose> +</refnamediv> + +<refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_size</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_size</function> wird benutzt, um die Grösse eines gemeinsamen Speicherblocks in Byte zu ermitteln. - </para> - <para> - <function>shmop_size</function> benötigt shmid, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. Die Funktion liefert einen Integerwert zurück, welcher - angibt, wieviele Bytes von dem gemeinsamen Speicher belegt werden. - </para> - <para> - <example> - <title>Die Grösse des gemeinsamen Speicherblocks ermitteln</title> - <programlisting role="php"> + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner des gemeinsamen Speicherblocks, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird ein Integerwert der angibt, wieviele Bytes von dem + gemeinsamen Speicher belegt werden. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Die Größe des gemeinsamen Speicherbereichs ermitteln</title> + <programlisting role="php"> <![CDATA[ <?php $shm_size = shmop_size($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In dem Beispiel erhält die Variable <literal>$shm_size</literal> - die Grösse des durch <literal>$shm_id</literal> bezeichneten - gemeinsamen Speicherblocks in Byte. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In dem Beispiel erhält die Variable <literal>$shm_size</literal> + die Grösse des durch <literal>$shm_id</literal> bezeichneten + gemeinsamen Speicherblocks in Byte. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-read.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-read.xml diff -u phpdoc-de/reference/shmop/functions/shmop-read.xml:1.5 phpdoc-de/reference/shmop/functions/shmop-read.xml:1.6 --- phpdoc-de/reference/shmop/functions/shmop-read.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-read.xml Tue Jul 8 00:56:38 2008 @@ -1,50 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'shmop-read' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-read" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_read</refname> - <refpurpose>Daten aus dem gemeinsamen Speicherblock auslesen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>shmop_read</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam><type>int</type><parameter>count</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_read</function> liest einen String aus dem gemeinsamen Speicherblock. - </para> - <para> - <function>shmop_read</function> braucht 3 Parameter: shmid, die - Kennung des gemeinsamen Speicherblocks, der mit - <function>shmop_open</function> - erzeugt wurde, start gibt den Offset an, von wo ab gelesen werden - soll und count gibt die Anzahl der zu lesenden Bytes an. - </para> - <para> - <example> - <title>Aus dem gemeinsamen Speicher lesen</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-read" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_read</refname> + <refpurpose>Liest Daten aus einem gemeinsam genutzten Speicherbereich</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>shmop_read</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam><type>int</type><parameter>count</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_read</function> liest einen String aus einem gemeinsam + genutzten Speicherblock. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Offset, bei dem der Lesevorgang beginnen soll + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>count</parameter></term> + <listitem> + <para> + Die Anzahl der zu lesenden Bytes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt entweder die gelesenen Daten zurück oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Aus dem gemeinsamen Speicher lesen</title> + <programlisting role="php"> <![CDATA[ <?php $shm_data = shmop_read($shm_id, 0, 50); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherblock - in die Variable <literal>$shm_data</literal> eingelesen. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherblock + in die Variable <literal>$shm_data</literal> eingelesen. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_write</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-open.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-open.xml diff -u phpdoc-de/reference/shmop/functions/shmop-open.xml:1.6 phpdoc-de/reference/shmop/functions/shmop-open.xml:1.7 --- phpdoc-de/reference/shmop/functions/shmop-open.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-open.xml Tue Jul 8 00:56:38 2008 @@ -1,95 +1,149 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-open" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_open</refname> - <refpurpose>Erstellt oder öffnet einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_open</methodname> - <methodparam><type>int</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>flags</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_open</function> Kann einen gemeinsamen Speicherbereich erstellen oder öffnen. - </para> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-open" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_open</refname> + <refpurpose>Erstellt oder öffnet einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_open</methodname> + <methodparam><type>int</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>flags</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_open</function> Kann einen gemeinsamen Speicherbereich + erstellen oder öffnen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Die System-ID des gemeinsam genutzten Speicherblocks, dieser + Parameter kann als Dezimal- oder Hexadezimalzahl übergeben werden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Folgende Flags können benutzt werden: + <itemizedlist> + <listitem> + <simpara> + "a" zum Zugriff (access) auf einen gemeinsamen Speicherblock (setzt SHM_RDONLY für shmat). + Benutzen Sie dieses Flag, wenn Sie einen bestehenden gemeinsamen Speicherblock nur zum Lesen öffnen wollen. + </simpara> + </listitem> + <listitem> + <simpara> + "c" zum Erzeugen (create) eines gemeinsamen Speicherblocks + (setzt IPC_CREATE). Benutzen Sie dieses Flag, wenn Sie einen + neuen gemeinsamen Speicherblock erzeugen wollen oder, falls + bereits ein Segment mit derselben ID existiert, zum Öffnen + dieses Segments für Lese- und Schreibzugriffe. + </simpara> + </listitem> + <listitem> + <simpara> + "w" für Lese- und Schreibzugriffe. Benutzen Sie dieses Flag + wenn Sie in einen gemeinsamen Speicherbereich schreiben oder + daraus lesen müssen. Das wird meistens der Fall sein. + </simpara> + </listitem> + <listitem> + <simpara> + "n" zum Erzeugen eines neuen gemeinsamen Speichersegments + (setzt IPC_CREATE|IPC_EXCL). Benutzen Sie dieses Flag, wenn Sie + ein neues gemeinsames Speichersegment erzeugen wollen. Falls + schon ein Segment mit diesem Flag existiert, schlägt die Funktion + fehl. Dies ist aus Sicherheitsgründen nützlich, denn damit können + Sie vermeiden, dass konkurrierende Prozesse ausgenutzt werden. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Die Zugriffsberechtigungen für die gemeinsamen Speichersegmente sind + dieselben wie für Dateien. Diese Berechtigungen müssen als Oktalwerte + übergeben werden, zum Beispiel <literal>0644</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>size</parameter></term> + <listitem> + <para> + Die Größe des erzeugten gemeinsam genutzten Speicherbereichs in Byte. + </para> + </listitem> + </varlistentry> + </variablelist> + <note> <para> - <function>shmop_open</function> benötigt 4 Parameter: key, die - System-ID des gemeinsam genutzten Speicherblocks, dieser Parameter - kann als Dezimal- oder Hexadezimalzahl übergeben werden. Der - zweite Parameter bezeichnet die Flags, die man benutzen kann: - <itemizedlist> - <listitem> - <simpara> - "a" zum Zugriff (access) auf einen gemeinsamen Speicherblock (setzt SHM_RDONLY für shmat). - Benutzen Sie dieses Flag, wenn Sie einen bestehenden gemeinsamen Speicherblock zum Lesen öffnen wollen. - </simpara> - </listitem> - <listitem> - <simpara> - "c" zum Erstellen (create) eines gemeinsamen Speicherblocks - (setzt IPC_CREATE). Benutzen Sie dieses Flag, wenn Sie einen - neuen gemeinsamen Speicherblock erstellen wollen oder, falls - bereits ein Segment mit derselben ID existiert, zum Öffnen - dieses Segments für Lese- und Schreibzugriffe. - </simpara> - </listitem> - <listitem> - <simpara> - "w" für Lese- und Schreibzugriffe. Benutzen Sie dieses Flag - wenn Sie in einen gemeinsamen Speicherbereich schreiben oder - daraus lesen müssen. Das wird meistens der Fall sein. - </simpara> - </listitem> - <listitem> - <simpara> - "n" zum Erzeugen eines neuen gemeinsamen Speichersegments - (setzt IPC_CREATE|IPC_EXCL). Benutzen Sie dieses Flag, wenn - Sie ein neues gemeinsames Speichersegment erzeugen wollen. - Falls schon ein Segment mit diesem Flag existiert, schlägt - die Funktion fehl. Dies ist aus Sicherheitsgründen nützlich, - denn damit können Sie Sicherheitslöcher vermeiden. - </simpara> - </listitem> - </itemizedlist> - Der dritte Parameter ist der Modus, der die Zugriffsrechte, die - Sie dem gemeinsamen Speicher zuweisen wollen, angibt. Das sind - dieselben Zugriffsrechte wie für Dateien. Zugriffsrechte müssen - oktal angegeben werden, z.B. 0644. Der letzte Parameter gibt die - Grösse des gemeinsamen Speichers, den Sie erstellen wollen, in - Byte, an. - <note><simpara> - Beachten Sie: Der dritte und vierte Parameter muss als 0 - angegeben werden, wenn Sie ein existierendes gemeinsames - Speichersegment öffnen wollen. Bei Erfolg liefert die Funktion - <function>shmop_open</function> eine ID zurück, die Sie zum - Zugriff auf den erstellten gemeinsamen Speicher benutzen können. - </simpara></note> + Beachten Sie: der dritte und vierte Parameter sollten mit 0 angegeben + sein, falls Sie einen bereits existierenden Speicherbereich öffnen. </para> - <para> - <example> - <title>Einen neuen gemeinsamen Speicherblock erstellen</title> - <programlisting role="php"> + </note> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Bei Erfolg liefert die Funktion <function>shmop_open</function> eine ID + zurück, die Sie zum Zugriff auf den erstellten gemeinsamen Speicher benutzen + können. Bei einem Fehler wird &false; zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen neuen gemeinsamen Speicherblock erstellen</title> + <programlisting role="php"> <![CDATA[ <?php $shm_key = ftok(__FILE__, 't'); $shm_id = shmop_open($shm_key, "c", 0644, 100); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wurde ein gemeinsamer Speicherblock mit der - System-ID 0x0fff erstellt. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wurde ein gemeinsamer Speicherblock geöffnet. Die + System-ID wurde von der Funktion <function>ftok</function> zurückgegeben. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_close</function></member> + <member><function>shmop_delete</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-delete.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-delete.xml diff -u phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.7 phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.8 --- phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.7 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-delete.xml Tue Jul 8 00:56:38 2008 @@ -1,44 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-delete" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_delete</refname> - <refpurpose>Einen gemeinsamen Speicherblock löschen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_delete</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_delete</function> wird benutzt, um einen - gemeinsamen Speicherbereich zu löschen. - </para> - <para> - <function>shmop_delete</function> benötigt <parameter>shmid</parameter>, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. Bei Erfolg wird 1 zurückgegeben, bei Scheitern 0. - </para> - <para> - <example> - <title>Einen gemeinsamen Speicherblock löschen</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-delete" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_delete</refname> + <refpurpose>Einen gemeinsamen Speicherblock löschen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>shmop_delete</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_delete</function> wird benutzt, um einen + gemeinsamen Speicherbereich zu löschen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen gemeinsamen Speicherblock löschen</title> + <programlisting role="php"> <![CDATA[ <?php shmop_delete($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wird der gemeinsame Speicherblock mit der - Kennung <literal>$shm_id</literal> gelöscht. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wird der gemeinsame Speicherblock mit der + Kennung <literal>$shm_id</literal> gelöscht. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-write.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-write.xml diff -u phpdoc-de/reference/shmop/functions/shmop-write.xml:1.5 phpdoc-de/reference/shmop/functions/shmop-write.xml:1.6 --- phpdoc-de/reference/shmop/functions/shmop-write.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-write.xml Tue Jul 8 00:56:38 2008 @@ -1,53 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'shmop-write' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-write" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_write</refname> - <refpurpose>Schreibt Daten in einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_write</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_write</function> schreibt Daten in einen - gemeinsamen Speicherbereich. - </para> - <para> - <function>shmop_write</function> braucht 3 Parameter:shmid, die - Kennung des gemeinsamen Speicherblocks, der mit - <function>shmop_open</function> erzeugt wurde, data, ein String, - der in den gemeinsamen Speicher geschrieben werden soll und - offset, der angibt, von wo ab in den gemeinsamen Speicherblock - geschrieben werden soll. - </para> - <para> - <example> - <title>In den gemeinsamen Speicher schreiben</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-write" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_write</refname> + <refpurpose>Schreibt Daten in einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_write</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_write</function> schreibt Daten in einen gemeinsamen Speicherbereich. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + Ein String, der in den gemeinsamen Speicher geschrieben werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Gibt an, von welcher Position ab Daten in den gemeinsamen + Speicherbereich geschrieben werden sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Länge der geschriebenen Daten <parameter>data</parameter>, + oder &false; falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>In den gemeinsamen Speicher schreiben</title> + <programlisting role="php"> <![CDATA[ <?php $shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel werden die Daten der Variablen <literal>$my_string</literal> - in den gemeinsamen Speicherblock geschrieben. Die Variable - <literal>$shm_bytes_written</literal> enthält die Anzahl der geschriebenen Bytes. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel werden die Daten der Variablen <literal>$my_string</literal> + in den gemeinsamen Speicherblock geschrieben. Die Variable + <literal>$shm_bytes_written</literal> enthält die Anzahl der geschriebenen Bytes. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_read</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-close.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-close.xml diff -u phpdoc-de/reference/shmop/functions/shmop-close.xml:1.6 phpdoc-de/reference/shmop/functions/shmop-close.xml:1.7 --- phpdoc-de/reference/shmop/functions/shmop-close.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-close.xml Tue Jul 8 00:56:38 2008 @@ -1,44 +1,80 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_close</refname> - <refpurpose>Schliesst einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_close</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_close</function> wird benutzt, um einen gemeinsamen - Speicherblock zu schliessen. - </para> - <para> - <function>shmop_close</function> benötigt <parameter>shmid</parameter>, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. - </para> - <para> - <example> - <title>Einen gemeinsamen Speicherblock schliessen</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_close</refname> + <refpurpose>Schliesst einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>shmop_close</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_close</function> wird benutzt, um einen gemeinsamen + Speicherblock zu schliessen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen gemeinsamen Speicherblock schliessen</title> + <programlisting role="php"> <![CDATA[ <?php shmop_close($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wird der gemeinsame Speicherblock mit dem Bezeichner - <literal>$shm_id</literal> geschlossen. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wird der gemeinsame Speicherblock + <literal>$shm_id</literal> wieder geschlossen. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_open</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + + + + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-size.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-size.xml diff -u phpdoc-de/reference/shmop/functions/shmop-size.xml:1.2 phpdoc-de/reference/shmop/functions/shmop-size.xml:1.3 --- phpdoc-de/reference/shmop/functions/shmop-size.xml:1.2 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-size.xml Tue Jul 8 00:56:38 2008 @@ -1,49 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'size' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-size" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_size</refname> - <refpurpose>Gibt die Grösse des gemeinsamen Speicherblocks zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_size</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_size</function> wird benutzt, um die Grösse eines +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-size" xmlns="http://docbook.org/ns/docbook"> +<refnamediv> + <refname>shmop_size</refname> + <refpurpose>Gibt die Grösse des gemeinsamen Speicherblocks zurück</refpurpose> +</refnamediv> + +<refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_size</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_size</function> wird benutzt, um die Grösse eines gemeinsamen Speicherblocks in Byte zu ermitteln. - </para> - <para> - <function>shmop_size</function> benötigt shmid, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. Die Funktion liefert einen Integerwert zurück, welcher - angibt, wieviele Bytes von dem gemeinsamen Speicher belegt werden. - </para> - <para> - <example> - <title>Die Grösse des gemeinsamen Speicherblocks ermitteln</title> - <programlisting role="php"> + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner des gemeinsamen Speicherblocks, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird ein Integerwert der angibt, wieviele Bytes von dem + gemeinsamen Speicher belegt werden. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Die Größe des gemeinsamen Speicherbereichs ermitteln</title> + <programlisting role="php"> <![CDATA[ <?php $shm_size = shmop_size($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In dem Beispiel erhält die Variable <literal>$shm_size</literal> - die Grösse des durch <literal>$shm_id</literal> bezeichneten - gemeinsamen Speicherblocks in Byte. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In dem Beispiel erhält die Variable <literal>$shm_size</literal> + die Grösse des durch <literal>$shm_id</literal> bezeichneten + gemeinsamen Speicherblocks in Byte. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-read.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-read.xml diff -u phpdoc-de/reference/shmop/functions/shmop-read.xml:1.5 phpdoc-de/reference/shmop/functions/shmop-read.xml:1.6 --- phpdoc-de/reference/shmop/functions/shmop-read.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-read.xml Tue Jul 8 00:56:38 2008 @@ -1,50 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'shmop-read' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-read" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_read</refname> - <refpurpose>Daten aus dem gemeinsamen Speicherblock auslesen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>shmop_read</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam><type>int</type><parameter>count</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_read</function> liest einen String aus dem gemeinsamen Speicherblock. - </para> - <para> - <function>shmop_read</function> braucht 3 Parameter: shmid, die - Kennung des gemeinsamen Speicherblocks, der mit - <function>shmop_open</function> - erzeugt wurde, start gibt den Offset an, von wo ab gelesen werden - soll und count gibt die Anzahl der zu lesenden Bytes an. - </para> - <para> - <example> - <title>Aus dem gemeinsamen Speicher lesen</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-read" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_read</refname> + <refpurpose>Liest Daten aus einem gemeinsam genutzten Speicherbereich</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>shmop_read</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam><type>int</type><parameter>count</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_read</function> liest einen String aus einem gemeinsam + genutzten Speicherblock. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Offset, bei dem der Lesevorgang beginnen soll + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>count</parameter></term> + <listitem> + <para> + Die Anzahl der zu lesenden Bytes + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt entweder die gelesenen Daten zurück oder &false;, falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Aus dem gemeinsamen Speicher lesen</title> + <programlisting role="php"> <![CDATA[ <?php $shm_data = shmop_read($shm_id, 0, 50); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherblock - in die Variable <literal>$shm_data</literal> eingelesen. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherblock + in die Variable <literal>$shm_data</literal> eingelesen. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_write</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-open.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-open.xml diff -u phpdoc-de/reference/shmop/functions/shmop-open.xml:1.6 phpdoc-de/reference/shmop/functions/shmop-open.xml:1.7 --- phpdoc-de/reference/shmop/functions/shmop-open.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-open.xml Tue Jul 8 00:56:38 2008 @@ -1,95 +1,149 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-open" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_open</refname> - <refpurpose>Erstellt oder öffnet einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_open</methodname> - <methodparam><type>int</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>flags</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_open</function> Kann einen gemeinsamen Speicherbereich erstellen oder öffnen. - </para> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-open" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_open</refname> + <refpurpose>Erstellt oder öffnet einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_open</methodname> + <methodparam><type>int</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>flags</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_open</function> Kann einen gemeinsamen Speicherbereich + erstellen oder öffnen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Die System-ID des gemeinsam genutzten Speicherblocks, dieser + Parameter kann als Dezimal- oder Hexadezimalzahl übergeben werden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + Folgende Flags können benutzt werden: + <itemizedlist> + <listitem> + <simpara> + "a" zum Zugriff (access) auf einen gemeinsamen Speicherblock (setzt SHM_RDONLY für shmat). + Benutzen Sie dieses Flag, wenn Sie einen bestehenden gemeinsamen Speicherblock nur zum Lesen öffnen wollen. + </simpara> + </listitem> + <listitem> + <simpara> + "c" zum Erzeugen (create) eines gemeinsamen Speicherblocks + (setzt IPC_CREATE). Benutzen Sie dieses Flag, wenn Sie einen + neuen gemeinsamen Speicherblock erzeugen wollen oder, falls + bereits ein Segment mit derselben ID existiert, zum Öffnen + dieses Segments für Lese- und Schreibzugriffe. + </simpara> + </listitem> + <listitem> + <simpara> + "w" für Lese- und Schreibzugriffe. Benutzen Sie dieses Flag + wenn Sie in einen gemeinsamen Speicherbereich schreiben oder + daraus lesen müssen. Das wird meistens der Fall sein. + </simpara> + </listitem> + <listitem> + <simpara> + "n" zum Erzeugen eines neuen gemeinsamen Speichersegments + (setzt IPC_CREATE|IPC_EXCL). Benutzen Sie dieses Flag, wenn Sie + ein neues gemeinsames Speichersegment erzeugen wollen. Falls + schon ein Segment mit diesem Flag existiert, schlägt die Funktion + fehl. Dies ist aus Sicherheitsgründen nützlich, denn damit können + Sie vermeiden, dass konkurrierende Prozesse ausgenutzt werden. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Die Zugriffsberechtigungen für die gemeinsamen Speichersegmente sind + dieselben wie für Dateien. Diese Berechtigungen müssen als Oktalwerte + übergeben werden, zum Beispiel <literal>0644</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>size</parameter></term> + <listitem> + <para> + Die Größe des erzeugten gemeinsam genutzten Speicherbereichs in Byte. + </para> + </listitem> + </varlistentry> + </variablelist> + <note> <para> - <function>shmop_open</function> benötigt 4 Parameter: key, die - System-ID des gemeinsam genutzten Speicherblocks, dieser Parameter - kann als Dezimal- oder Hexadezimalzahl übergeben werden. Der - zweite Parameter bezeichnet die Flags, die man benutzen kann: - <itemizedlist> - <listitem> - <simpara> - "a" zum Zugriff (access) auf einen gemeinsamen Speicherblock (setzt SHM_RDONLY für shmat). - Benutzen Sie dieses Flag, wenn Sie einen bestehenden gemeinsamen Speicherblock zum Lesen öffnen wollen. - </simpara> - </listitem> - <listitem> - <simpara> - "c" zum Erstellen (create) eines gemeinsamen Speicherblocks - (setzt IPC_CREATE). Benutzen Sie dieses Flag, wenn Sie einen - neuen gemeinsamen Speicherblock erstellen wollen oder, falls - bereits ein Segment mit derselben ID existiert, zum Öffnen - dieses Segments für Lese- und Schreibzugriffe. - </simpara> - </listitem> - <listitem> - <simpara> - "w" für Lese- und Schreibzugriffe. Benutzen Sie dieses Flag - wenn Sie in einen gemeinsamen Speicherbereich schreiben oder - daraus lesen müssen. Das wird meistens der Fall sein. - </simpara> - </listitem> - <listitem> - <simpara> - "n" zum Erzeugen eines neuen gemeinsamen Speichersegments - (setzt IPC_CREATE|IPC_EXCL). Benutzen Sie dieses Flag, wenn - Sie ein neues gemeinsames Speichersegment erzeugen wollen. - Falls schon ein Segment mit diesem Flag existiert, schlägt - die Funktion fehl. Dies ist aus Sicherheitsgründen nützlich, - denn damit können Sie Sicherheitslöcher vermeiden. - </simpara> - </listitem> - </itemizedlist> - Der dritte Parameter ist der Modus, der die Zugriffsrechte, die - Sie dem gemeinsamen Speicher zuweisen wollen, angibt. Das sind - dieselben Zugriffsrechte wie für Dateien. Zugriffsrechte müssen - oktal angegeben werden, z.B. 0644. Der letzte Parameter gibt die - Grösse des gemeinsamen Speichers, den Sie erstellen wollen, in - Byte, an. - <note><simpara> - Beachten Sie: Der dritte und vierte Parameter muss als 0 - angegeben werden, wenn Sie ein existierendes gemeinsames - Speichersegment öffnen wollen. Bei Erfolg liefert die Funktion - <function>shmop_open</function> eine ID zurück, die Sie zum - Zugriff auf den erstellten gemeinsamen Speicher benutzen können. - </simpara></note> + Beachten Sie: der dritte und vierte Parameter sollten mit 0 angegeben + sein, falls Sie einen bereits existierenden Speicherbereich öffnen. </para> - <para> - <example> - <title>Einen neuen gemeinsamen Speicherblock erstellen</title> - <programlisting role="php"> + </note> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Bei Erfolg liefert die Funktion <function>shmop_open</function> eine ID + zurück, die Sie zum Zugriff auf den erstellten gemeinsamen Speicher benutzen + können. Bei einem Fehler wird &false; zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen neuen gemeinsamen Speicherblock erstellen</title> + <programlisting role="php"> <![CDATA[ <?php $shm_key = ftok(__FILE__, 't'); $shm_id = shmop_open($shm_key, "c", 0644, 100); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wurde ein gemeinsamer Speicherblock mit der - System-ID 0x0fff erstellt. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wurde ein gemeinsamer Speicherblock geöffnet. Die + System-ID wurde von der Funktion <function>ftok</function> zurückgegeben. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_close</function></member> + <member><function>shmop_delete</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-delete.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-delete.xml diff -u phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.7 phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.8 --- phpdoc-de/reference/shmop/functions/shmop-delete.xml:1.7 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-delete.xml Tue Jul 8 00:56:38 2008 @@ -1,44 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: conni Status: ready --> - <refentry xml:id="function.shmop-delete" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_delete</refname> - <refpurpose>Einen gemeinsamen Speicherblock löschen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_delete</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_delete</function> wird benutzt, um einen - gemeinsamen Speicherbereich zu löschen. - </para> - <para> - <function>shmop_delete</function> benötigt <parameter>shmid</parameter>, die Kennung - des gemeinsamen Speicherblocks, der mit <function>shmop_open</function> - erzeugt wurde. Bei Erfolg wird 1 zurückgegeben, bei Scheitern 0. - </para> - <para> - <example> - <title>Einen gemeinsamen Speicherblock löschen</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-delete" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_delete</refname> + <refpurpose>Einen gemeinsamen Speicherblock löschen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>shmop_delete</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_delete</function> wird benutzt, um einen + gemeinsamen Speicherbereich zu löschen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Einen gemeinsamen Speicherblock löschen</title> + <programlisting role="php"> <![CDATA[ <?php shmop_delete($shm_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel wird der gemeinsame Speicherblock mit der - Kennung <literal>$shm_id</literal> gelöscht. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel wird der gemeinsame Speicherblock mit der + Kennung <literal>$shm_id</literal> gelöscht. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/shmop/functions/shmop-write.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/shmop/functions/shmop-write.xml diff -u phpdoc-de/reference/shmop/functions/shmop-write.xml:1.5 phpdoc-de/reference/shmop/functions/shmop-write.xml:1.6 --- phpdoc-de/reference/shmop/functions/shmop-write.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/shmop/functions/shmop-write.xml Tue Jul 8 00:56:38 2008 @@ -1,53 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/shmop.xml, last change in rev 1.1 --> -<!-- last change to 'shmop-write' in en/ tree in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> -<!-- OLD-Revision: 1.15/EN.1.1 --> - <refentry xml:id="function.shmop-write" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>shmop_write</refname> - <refpurpose>Schreibt Daten in einen gemeinsamen Speicherblock</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>shmop_write</methodname> - <methodparam><type>int</type><parameter>shmid</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>shmop_write</function> schreibt Daten in einen - gemeinsamen Speicherbereich. - </para> - <para> - <function>shmop_write</function> braucht 3 Parameter:shmid, die - Kennung des gemeinsamen Speicherblocks, der mit - <function>shmop_open</function> erzeugt wurde, data, ein String, - der in den gemeinsamen Speicher geschrieben werden soll und - offset, der angibt, von wo ab in den gemeinsamen Speicherblock - geschrieben werden soll. - </para> - <para> - <example> - <title>In den gemeinsamen Speicher schreiben</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: conni Status: ready --> +<refentry xml:id="function.shmop-write" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>shmop_write</refname> + <refpurpose>Schreibt Daten in einen gemeinsamen Speicherblock</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>shmop_write</methodname> + <methodparam><type>int</type><parameter>shmid</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + <function>shmop_write</function> schreibt Daten in einen gemeinsamen Speicherbereich. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>shmid</parameter></term> + <listitem> + <para> + Der Bezeichner für den gemeinsamen Speicherblock, der von + <function>shmop_open</function> erzeugt wurde. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + Ein String, der in den gemeinsamen Speicher geschrieben werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Gibt an, von welcher Position ab Daten in den gemeinsamen + Speicherbereich geschrieben werden sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Länge der geschriebenen Daten <parameter>data</parameter>, + oder &false; falls ein Fehler auftrat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>In den gemeinsamen Speicher schreiben</title> + <programlisting role="php"> <![CDATA[ <?php $shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> ]]> - </programlisting> - </example> - </para> - <para> - In diesem Beispiel werden die Daten der Variablen <literal>$my_string</literal> - in den gemeinsamen Speicherblock geschrieben. Die Variable - <literal>$shm_bytes_written</literal> enthält die Anzahl der geschriebenen Bytes. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + In diesem Beispiel werden die Daten der Variablen <literal>$my_string</literal> + in den gemeinsamen Speicherblock geschrieben. Die Variable + <literal>$shm_bytes_written</literal> enthält die Anzahl der geschriebenen Bytes. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shmop_read</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: