cvs: phpdoc-de /reference/posix/functions posix-ctermid.xml posix-get-last-error.xml posix-getcwd.xml posix-getegid.xml posix-geteuid.xml
posix-getgid.xml posix-getgrgid.xml posix-getgrnam.xml posix-getgroups.xml posix-getlogin.xml posix-getpgid.xml posix-getpgrp.xml
| From: | Martin Samesch | Date: | Thu, 09 Aug 2007 18:13:24 +0000 |
| Subject: | cvs: phpdoc-de /reference/posix/functions posix-ctermid.xml posix-get-last-error.xml posix-getcwd.xml posix-getegid.xml posix-geteuid.xml posix-getgid.xml posix-getgrgid.xml posix-getgrnam.xml posix-getgroups.xml posix-getlogin.xml posix-getpgid.xml posix-getpgrp.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2215@lists.php.net to get a copy of this message | ||
samesch Thu Aug 9 18:13:24 2007 UTC
Modified files:
/phpdoc-de/reference/posix/functions posix-ctermid.xml
posix-get-last-error.xml
posix-getcwd.xml
posix-getegid.xml
posix-geteuid.xml
posix-getgid.xml
posix-getgrgid.xml
posix-getgrnam.xml
posix-getgroups.xml
posix-getlogin.xml
posix-getpgid.xml
posix-getpgrp.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-ctermid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-ctermid.xml diff -u phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.6 phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-ctermid.xml Thu Aug 9 18:13:24 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-ctermid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_ctermid</refname> - <refpurpose>Liefert den Pfad des maßgebenden Terminals</refpurpose> + <refpurpose>Liefert den Pfad des kontrollierenden Terminals</refpurpose> </refnamediv> <refsect1 role="description"> @@ -14,7 +14,49 @@ <void/> </methodsynopsis> <para> - &warn.undocumented.func; + Gibt den Pfadnamen des aktuell kontrollierenden Terminals des Prozesses als + <type>Zeichenkette</type> zurück. Falls ein Fehler auftritt, wird errno + (Fehlernummer) gesetzt, das mittels + <function>posix_get_last_error</function> abgerufen werden kann. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei erfolgreicher Beendigung den Pfadnamen des aktuell + kontrollierenden Terminals als <type>Zeichenkette</type> zurück. + Andernfalls wird &false; zurückgegeben und errno gesetzt, das mittels + <function>posix_get_last_error</function> überprüft werden kann. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_ctermid</function> Beispiel</title> + <para> + Dieses Beispiel gibt den Pfad zum aktuellen TTY aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo "Ich laufe auf ".posix_ctermid(); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_ttyname</function></member> + <member><function>posix_get_last_error</function></member> + </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-get-last-error.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-get-last-error.xml diff -u phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.5 phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.6 --- phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.5 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-get-last-error.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-get-last-error" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_get_last_error</refname> @@ -15,9 +15,8 @@ </methodsynopsis> <para> Gibt die Fehlernummer zurück, die von der letzten fehlgeschlagenen - Posix-Funktion gesetzt wurde. Verwenden Sie - <function>posix_strerror</function>, wenn Sie die Systemmeldung haben - wollen, die zu errno gehört. + Posix-Funktion gesetzt wurde. Die zu errno gehörende Fehlermeldung des + Systems kann mit <function>posix_strerror</function> abgerufen werden. </para> </refsect1> @@ -30,6 +29,28 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_get_last_error</function> Beispiel</title> + <para> + In diesem Beispiel wird versucht, eine falsche Prozess-ID zu killen, was + den letzten Fehler setzt. Anschließend lassen wir uns die Nummer des + letzten Fehlers anzeigen. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +posix_kill(999459,SIGKILL); +echo 'Der zurückgegebene Fehler war '.posix_get_last_error(); // Der zurückgegebene Fehler war ... +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getcwd.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getcwd.xml diff -u phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.8 phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.9 --- phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.8 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getcwd.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getcwd" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getcwd</refname> @@ -15,17 +15,59 @@ </methodsynopsis> <para> Gibt den absoluten Pfadnamen des aktuellen Arbeitsverzeichnisses des - Skripts zurück. + Skripts zurück. Falls ein Fehler auftritt, wird errno (Fehlernummer) + gesetzt, das mittels <function>posix_get_last_error</function> abgerufen + werden kann. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt den absoluten Pfadnamen zurück oder &false;, falls ein Fehler auftrat. + Gibt bei Erfolg den absoluten Pfadnamen als <type>Zeichenkette</type> + zurück. Falls ein Fehler auftritt, wird &false; zurückgegeben und errno + gesetzt, das mittels <function>posix_get_last_error</function> überprüft + werden kann. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getcwd</function> Beispiel</title> + <para> + Dieses Beispiel gibt den absoluten Pfad des aktuellen + Arbeitsverzeichnisses des Skripts aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Das aktuelle Arbeitsverzeichnis ist '.posix_getcwd(); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Diese Funktion schlägt fehl, wenn + <itemizedlist> + <listitem> + <simpara>es keine Lese- oder Suchberechtigung gibt</simpara> + </listitem> + <listitem> + <simpara>der Pfadname nicht mehr existiert</simpara> + </listitem> + </itemizedlist> + </para> + </note> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getegid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getegid.xml diff -u phpdoc-de/reference/posix/functions/posix-getegid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getegid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getegid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getegid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getegid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getegid</refname> @@ -21,7 +21,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Gruppen-ID zurück. + Gibt die effektive Gruppen-ID als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getegid</function> Beispiel</title> + <para> + Dieses Beispiel gibt die effektive Gruppen-ID aus, nachdem sie mittels + <function>posix_setegid</function> geändert wurde. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +posix_setegid(40); +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +echo 'Meine effektive Gruppen-ID ist '.posix_getegid(); //40 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <para> + <function>posix_getegid</function> unterscheidet sich von + <function>posix_getgid</function> insofern, dass die effektive Gruppen-ID + durch einen aufrufenden Prozess, der <function>posix_setegid</function> + verwendet, geändert werden kann. </para> </refsect1> @@ -34,6 +67,8 @@ wie die Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden kann. </member> + <member><function>posix_getgid</function></member> + <member><function>posix_setgid</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-geteuid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-geteuid.xml diff -u phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.6 phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-geteuid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-geteuid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_geteuid</refname> @@ -26,10 +26,48 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die ID als Ganzzahl zurück. + Gibt die Benutzer-ID als <type>Ganzzahl</type> zurück. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_geteuid</function> Beispiel</title> + <para> + Dieses Beispiel gibt die aktuelle Benutzer-ID aus, setzt danach die + effektive Benutzer-ID mittels <function>posix_seteuid</function> auf eine + andere ID und zeigt dann anhand von realer und effektiver ID den + Unterschied. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo posix_getuid()."\n"; //10001 +echo posix_geteuid()."\n"; //10001 +posix_seteuid(10000); +echo posix_getuid()."\n"; //10001 +echo posix_geteuid()."\n"; //10000 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getpwuid</function></member> + <member><function>posix_getuid</function></member> + <member><function>posix_setuid</function></member> + <member>POSIX GETEUID(2)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getgid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getgid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getgid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgid</refname> @@ -14,17 +14,52 @@ <void/> </methodsynopsis> <para> - Gibt die reale numerische Gruppen-ID des aktuellen Prozesses zurück. Bei - <function>posix_getgrgid</function> finden Sie Informationen darüber, wie - die Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden - kann. + Gibt die reale numerische Gruppen-ID des aktuellen Prozesses zurück. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die ID als Ganzzahl zurück. + Gibt die reale Gruppen-ID als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgid</function> Beispiel</title> + <para> + Dieses Beispiel gibt auch nach Änderung der effektiven Gruppen-ID die + reale Gruppen-ID aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +posix_setegid(40); +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +echo 'Meine effektive Gruppen-ID ist '.posix_getegid(); //40 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <function>posix_getgrgid</function> für Informationen darüber, wie die + Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden kann. + </member> + <member><function>posix_getegid</function></member> + <member><function>posix_setgid</function></member> + <member>POSIX GETGID(2)-Manpage</member> + </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgrgid.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgrgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.9 phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.10 --- phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.9 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgrgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgrgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgrgid</refname> @@ -37,10 +37,51 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt ein <type>Array</type> mit Informationen über eine Gruppe zurück oder - &false;, falls ein Fehler auftrat. Falls <parameter>gid</parameter> keine - Zahl ist, gibt sie &null; zurück und erzeugt einen - <constant>E_WARNING</constant>-Fehler. + Die Elemente des zurückgegebenen Arrays sind: + <table> + <title>Das Array mit Gruppeninformationen</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Element</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry> + Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei + nicht um den wirklichen, kompletten Namen, sondern um einen kurzen + "Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. + </entry> + </row> + <row> + <entry>passwd</entry> + <entry> + Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter + Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter + verwendet werden, wird stattdessen ein Sternchen zurückgegeben. + </entry> + </row> + <row> + <entry>gid</entry> + <entry> + Die Gruppen-ID - sollte dieselbe sein wie der Parameter + <parameter>gid</parameter>, der beim Aufruf der Funktion verwendet + wurde und ist von daher redundant. + </entry> + </row> + <row> + <entry>members</entry> + <entry> + Besteht aus einem <type>Array</type> von <type>Zeichenketten</type> + aller Gruppenmitglieder. + </entry> + </row> + </tbody> + </tgroup> + </table> </para> </refsect1> @@ -60,7 +101,7 @@ <entry>4.2.0</entry> <entry> Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der - Gruppenmitglieder angab und die Namen der Mitglieder wurden mit + Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit numerischen Indizes zurückgegeben. </entry> </row> @@ -85,7 +126,6 @@ $gruppeninfo = posix_getgrgid($gruppenid); print_r($gruppeninfo); - ?> ]]> </programlisting> @@ -114,9 +154,11 @@ <para> <simplelist> <member><function>posix_getegid</function></member> + <member><function>posix_getgrnam</function></member> <member><function>filegroup</function></member> <member><function>stat</function></member> <member><link linkend="ini.safe-mode-gid">safe_mode_gid</link></member> + <member>POSIX GETGRNAM(3)-Manpage</member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgrnam.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgrnam.xml diff -u phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.7 phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.8 --- phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.7 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgrnam.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgrnam" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgrnam</refname> @@ -14,7 +14,7 @@ <methodparam><type>string</type><parameter>Gruppenname</parameter></methodparam> </methodsynopsis> <para> - &warn.undocumented.func; + Gibt Informationen über die durch Gruppenname angegebene Gruppe zurück. </para> </refsect1> @@ -26,6 +26,7 @@ <term><parameter>Gruppenname</parameter></term> <listitem> <para> + Der Name der Gruppe </para> </listitem> </varlistentry> @@ -33,6 +34,131 @@ </para> </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Elemente des zurückgegebenen Arrays sind: + <table> + <title>Das Array mit Gruppeninformationen</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Element</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry> + Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei + nicht um den wirklichen, kompletten Namen, sondern um einen kurzen + "Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. Er + sollte derselbe sein wie der Parameter <parameter>name</parameter>, + der beim Aufruf der Funktion verwendet wurde und ist von daher + redundant. + </entry> + </row> + <row> + <entry>passwd</entry> + <entry> + Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter + Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter + verwendet werden, wird stattdessen ein Sternchen zurückgegeben. + </entry> + </row> + <row> + <entry>gid</entry> + <entry>Die Gruppen-ID in numerischem Format</entry> + </row> + <row> + <entry>members</entry> + <entry> + Besteht aus einem <type>Array</type> von <type>Zeichenketten</type> + aller Gruppenmitglieder. + </entry> + </row> + </tbody> + </tgroup> + </table> + </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>4.2.0</entry> + <entry> + Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der + Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit + numerischen Indizes zurückgegeben. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgrnam</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$gruppeninfo = posix_getgrnam("toons"); + +print_r($gruppeninfo); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [name] => toons + [passwd] => x + [members] => Array + ( + [0] => tom + [1] => jerry + ) + [gid] => 42 +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getegid</function></member> + <member><function>posix_getgrgid</function></member> + <member><function>filegroup</function></member> + <member><function>stat</function></member> + <member><link linkend="ini.safe-mode-gid">safe_mode_gid</link></member> + <member>POSIX GETGRNAM(3)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgroups.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgroups.xml diff -u phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.6 phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgroups.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgroups" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgroups</refname> @@ -26,6 +26,46 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgroups</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$gruppen = posix_getgroups(); + +print_r($gruppen); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [0] => 4 + [1] => 20 + [2] => 24 + [3] => 25 + [4] => 29 + [5] => 30 + [6] => 33 + [7] => 44 + [8] => 46 + [9] => 104 + [10] => 109 + [11] => 110 + [12] => 1000 +) +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getlogin.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getlogin.xml diff -u phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.6 phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getlogin.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getlogin" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getlogin</refname> @@ -21,7 +21,23 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt den Loginnamen der Benutzerin als Zeichenkette zurück. + Gibt den Loginnamen der Benutzerin als <type>Zeichenkette</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getlogin</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo posix_getlogin(); //apache +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -30,6 +46,7 @@ <para> <simplelist> <member><function>posix_getpwnam</function></member> + <member>POSIX GETLOGIN(3)-Manpage</member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getpgid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getpgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getpgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getpgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getpgid</refname> @@ -38,7 +38,24 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Kennung als Ganzzahl zurück. + Gibt die Kennung als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getpgid</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$pid = posix_getppid(); +echo posix_getpgid($pid); //35 +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -46,13 +63,24 @@ &reftitle.notes; <note> <para> - Dies ist keine POSIX-Funktion, ist aber auf BSD- und System V-Systemen - gängig. Falls Ihr System diese Funktion nicht auf der Systemebene - unterstützt, gibt diese PHP-Funktion immer &false; zurück. + Dies ist keine POSIX-Funktion, aber sie ist auf BSD- und System V-Systemen + gängig. Falls Ihr System diese Funktion nicht unterstützt, wird sie + während der Übersetzung nicht eingebunden. Ob es die Funktion gibt, kann + mittels <function>function_exists</function> überprüft werden. </para> </note> </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getppid</function></member> + <member> SETPGID(2)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getpgrp.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getpgrp.xml diff -u phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.6 phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getpgrp.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getpgrp" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getpgrp</refname> @@ -21,7 +21,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Kennung als Ganzzahl zurück. + Gibt die Kennung als <type>Ganzzahl</type> zurück. </para> </refsect1> @@ -30,8 +30,8 @@ <para> <simplelist> <member> - Sehen Sie sich dazu POSIX.1 und die getpgrp(2)-Manpage auf Ihrem - POSIX-System an, um mehr Informationen über Prozessgruppen zu erhalten. + Die POSIX.1- und die getpgrp(2)-Manpage auf dem POSIX-System um mehr + Informationen über Prozessgruppen zu erhalten. </member> </simplelist> </para>
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-ctermid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-ctermid.xml diff -u phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.6 phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-ctermid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-ctermid.xml Thu Aug 9 18:13:24 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-ctermid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_ctermid</refname> - <refpurpose>Liefert den Pfad des maßgebenden Terminals</refpurpose> + <refpurpose>Liefert den Pfad des kontrollierenden Terminals</refpurpose> </refnamediv> <refsect1 role="description"> @@ -14,7 +14,49 @@ <void/> </methodsynopsis> <para> - &warn.undocumented.func; + Gibt den Pfadnamen des aktuell kontrollierenden Terminals des Prozesses als + <type>Zeichenkette</type> zurück. Falls ein Fehler auftritt, wird errno + (Fehlernummer) gesetzt, das mittels + <function>posix_get_last_error</function> abgerufen werden kann. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt bei erfolgreicher Beendigung den Pfadnamen des aktuell + kontrollierenden Terminals als <type>Zeichenkette</type> zurück. + Andernfalls wird &false; zurückgegeben und errno gesetzt, das mittels + <function>posix_get_last_error</function> überprüft werden kann. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_ctermid</function> Beispiel</title> + <para> + Dieses Beispiel gibt den Pfad zum aktuellen TTY aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo "Ich laufe auf ".posix_ctermid(); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_ttyname</function></member> + <member><function>posix_get_last_error</function></member> + </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-get-last-error.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-get-last-error.xml diff -u phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.5 phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.6 --- phpdoc-de/reference/posix/functions/posix-get-last-error.xml:1.5 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-get-last-error.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-get-last-error" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_get_last_error</refname> @@ -15,9 +15,8 @@ </methodsynopsis> <para> Gibt die Fehlernummer zurück, die von der letzten fehlgeschlagenen - Posix-Funktion gesetzt wurde. Verwenden Sie - <function>posix_strerror</function>, wenn Sie die Systemmeldung haben - wollen, die zu errno gehört. + Posix-Funktion gesetzt wurde. Die zu errno gehörende Fehlermeldung des + Systems kann mit <function>posix_strerror</function> abgerufen werden. </para> </refsect1> @@ -30,6 +29,28 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_get_last_error</function> Beispiel</title> + <para> + In diesem Beispiel wird versucht, eine falsche Prozess-ID zu killen, was + den letzten Fehler setzt. Anschließend lassen wir uns die Nummer des + letzten Fehlers anzeigen. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +posix_kill(999459,SIGKILL); +echo 'Der zurückgegebene Fehler war '.posix_get_last_error(); // Der zurückgegebene Fehler war ... +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getcwd.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getcwd.xml diff -u phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.8 phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.9 --- phpdoc-de/reference/posix/functions/posix-getcwd.xml:1.8 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getcwd.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getcwd" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getcwd</refname> @@ -15,17 +15,59 @@ </methodsynopsis> <para> Gibt den absoluten Pfadnamen des aktuellen Arbeitsverzeichnisses des - Skripts zurück. + Skripts zurück. Falls ein Fehler auftritt, wird errno (Fehlernummer) + gesetzt, das mittels <function>posix_get_last_error</function> abgerufen + werden kann. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt den absoluten Pfadnamen zurück oder &false;, falls ein Fehler auftrat. + Gibt bei Erfolg den absoluten Pfadnamen als <type>Zeichenkette</type> + zurück. Falls ein Fehler auftritt, wird &false; zurückgegeben und errno + gesetzt, das mittels <function>posix_get_last_error</function> überprüft + werden kann. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getcwd</function> Beispiel</title> + <para> + Dieses Beispiel gibt den absoluten Pfad des aktuellen + Arbeitsverzeichnisses des Skripts aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Das aktuelle Arbeitsverzeichnis ist '.posix_getcwd(); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Diese Funktion schlägt fehl, wenn + <itemizedlist> + <listitem> + <simpara>es keine Lese- oder Suchberechtigung gibt</simpara> + </listitem> + <listitem> + <simpara>der Pfadname nicht mehr existiert</simpara> + </listitem> + </itemizedlist> + </para> + </note> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getegid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getegid.xml diff -u phpdoc-de/reference/posix/functions/posix-getegid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getegid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getegid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getegid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getegid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getegid</refname> @@ -21,7 +21,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Gruppen-ID zurück. + Gibt die effektive Gruppen-ID als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getegid</function> Beispiel</title> + <para> + Dieses Beispiel gibt die effektive Gruppen-ID aus, nachdem sie mittels + <function>posix_setegid</function> geändert wurde. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +posix_setegid(40); +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +echo 'Meine effektive Gruppen-ID ist '.posix_getegid(); //40 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <para> + <function>posix_getegid</function> unterscheidet sich von + <function>posix_getgid</function> insofern, dass die effektive Gruppen-ID + durch einen aufrufenden Prozess, der <function>posix_setegid</function> + verwendet, geändert werden kann. </para> </refsect1> @@ -34,6 +67,8 @@ wie die Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden kann. </member> + <member><function>posix_getgid</function></member> + <member><function>posix_setgid</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-geteuid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-geteuid.xml diff -u phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.6 phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-geteuid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-geteuid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-geteuid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_geteuid</refname> @@ -26,10 +26,48 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die ID als Ganzzahl zurück. + Gibt die Benutzer-ID als <type>Ganzzahl</type> zurück. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_geteuid</function> Beispiel</title> + <para> + Dieses Beispiel gibt die aktuelle Benutzer-ID aus, setzt danach die + effektive Benutzer-ID mittels <function>posix_seteuid</function> auf eine + andere ID und zeigt dann anhand von realer und effektiver ID den + Unterschied. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo posix_getuid()."\n"; //10001 +echo posix_geteuid()."\n"; //10001 +posix_seteuid(10000); +echo posix_getuid()."\n"; //10001 +echo posix_geteuid()."\n"; //10000 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getpwuid</function></member> + <member><function>posix_getuid</function></member> + <member><function>posix_setuid</function></member> + <member>POSIX GETEUID(2)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getgid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getgid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getgid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgid</refname> @@ -14,17 +14,52 @@ <void/> </methodsynopsis> <para> - Gibt die reale numerische Gruppen-ID des aktuellen Prozesses zurück. Bei - <function>posix_getgrgid</function> finden Sie Informationen darüber, wie - die Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden - kann. + Gibt die reale numerische Gruppen-ID des aktuellen Prozesses zurück. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die ID als Ganzzahl zurück. + Gibt die reale Gruppen-ID als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgid</function> Beispiel</title> + <para> + Dieses Beispiel gibt auch nach Änderung der effektiven Gruppen-ID die + reale Gruppen-ID aus. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +posix_setegid(40); +echo 'Meine reale Gruppen-ID ist '.posix_getgid(); //20 +echo 'Meine effektive Gruppen-ID ist '.posix_getegid(); //40 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <function>posix_getgrgid</function> für Informationen darüber, wie die + Gruppen-ID in einen gebräuchlichen Gruppennamen umgewandelt werden kann. + </member> + <member><function>posix_getegid</function></member> + <member><function>posix_setgid</function></member> + <member>POSIX GETGID(2)-Manpage</member> + </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgrgid.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgrgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.9 phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.10 --- phpdoc-de/reference/posix/functions/posix-getgrgid.xml:1.9 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgrgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgrgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgrgid</refname> @@ -37,10 +37,51 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt ein <type>Array</type> mit Informationen über eine Gruppe zurück oder - &false;, falls ein Fehler auftrat. Falls <parameter>gid</parameter> keine - Zahl ist, gibt sie &null; zurück und erzeugt einen - <constant>E_WARNING</constant>-Fehler. + Die Elemente des zurückgegebenen Arrays sind: + <table> + <title>Das Array mit Gruppeninformationen</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Element</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry> + Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei + nicht um den wirklichen, kompletten Namen, sondern um einen kurzen + "Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. + </entry> + </row> + <row> + <entry>passwd</entry> + <entry> + Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter + Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter + verwendet werden, wird stattdessen ein Sternchen zurückgegeben. + </entry> + </row> + <row> + <entry>gid</entry> + <entry> + Die Gruppen-ID - sollte dieselbe sein wie der Parameter + <parameter>gid</parameter>, der beim Aufruf der Funktion verwendet + wurde und ist von daher redundant. + </entry> + </row> + <row> + <entry>members</entry> + <entry> + Besteht aus einem <type>Array</type> von <type>Zeichenketten</type> + aller Gruppenmitglieder. + </entry> + </row> + </tbody> + </tgroup> + </table> </para> </refsect1> @@ -60,7 +101,7 @@ <entry>4.2.0</entry> <entry> Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der - Gruppenmitglieder angab und die Namen der Mitglieder wurden mit + Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit numerischen Indizes zurückgegeben. </entry> </row> @@ -85,7 +126,6 @@ $gruppeninfo = posix_getgrgid($gruppenid); print_r($gruppeninfo); - ?> ]]> </programlisting> @@ -114,9 +154,11 @@ <para> <simplelist> <member><function>posix_getegid</function></member> + <member><function>posix_getgrnam</function></member> <member><function>filegroup</function></member> <member><function>stat</function></member> <member><link linkend="ini.safe-mode-gid">safe_mode_gid</link></member> + <member>POSIX GETGRNAM(3)-Manpage</member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgrnam.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgrnam.xml diff -u phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.7 phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.8 --- phpdoc-de/reference/posix/functions/posix-getgrnam.xml:1.7 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgrnam.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgrnam" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgrnam</refname> @@ -14,7 +14,7 @@ <methodparam><type>string</type><parameter>Gruppenname</parameter></methodparam> </methodsynopsis> <para> - &warn.undocumented.func; + Gibt Informationen über die durch Gruppenname angegebene Gruppe zurück. </para> </refsect1> @@ -26,6 +26,7 @@ <term><parameter>Gruppenname</parameter></term> <listitem> <para> + Der Name der Gruppe </para> </listitem> </varlistentry> @@ -33,6 +34,131 @@ </para> </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Elemente des zurückgegebenen Arrays sind: + <table> + <title>Das Array mit Gruppeninformationen</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Element</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry> + Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei + nicht um den wirklichen, kompletten Namen, sondern um einen kurzen + "Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. Er + sollte derselbe sein wie der Parameter <parameter>name</parameter>, + der beim Aufruf der Funktion verwendet wurde und ist von daher + redundant. + </entry> + </row> + <row> + <entry>passwd</entry> + <entry> + Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter + Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter + verwendet werden, wird stattdessen ein Sternchen zurückgegeben. + </entry> + </row> + <row> + <entry>gid</entry> + <entry>Die Gruppen-ID in numerischem Format</entry> + </row> + <row> + <entry>members</entry> + <entry> + Besteht aus einem <type>Array</type> von <type>Zeichenketten</type> + aller Gruppenmitglieder. + </entry> + </row> + </tbody> + </tgroup> + </table> + </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>4.2.0</entry> + <entry> + Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der + Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit + numerischen Indizes zurückgegeben. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgrnam</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$gruppeninfo = posix_getgrnam("toons"); + +print_r($gruppeninfo); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [name] => toons + [passwd] => x + [members] => Array + ( + [0] => tom + [1] => jerry + ) + [gid] => 42 +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getegid</function></member> + <member><function>posix_getgrgid</function></member> + <member><function>filegroup</function></member> + <member><function>stat</function></member> + <member><link linkend="ini.safe-mode-gid">safe_mode_gid</link></member> + <member>POSIX GETGRNAM(3)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getgroups.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getgroups.xml diff -u phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.6 phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getgroups.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getgroups.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getgroups" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getgroups</refname> @@ -26,6 +26,46 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getgroups</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$gruppen = posix_getgroups(); + +print_r($gruppen); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Array +( + [0] => 4 + [1] => 20 + [2] => 24 + [3] => 25 + [4] => 29 + [5] => 30 + [6] => 33 + [7] => 44 + [8] => 46 + [9] => 104 + [10] => 109 + [11] => 110 + [12] => 1000 +) +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getlogin.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getlogin.xml diff -u phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.6 phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getlogin.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getlogin.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getlogin" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getlogin</refname> @@ -21,7 +21,23 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt den Loginnamen der Benutzerin als Zeichenkette zurück. + Gibt den Loginnamen der Benutzerin als <type>Zeichenkette</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getlogin</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo posix_getlogin(); //apache +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -30,6 +46,7 @@ <para> <simplelist> <member><function>posix_getpwnam</function></member> + <member>POSIX GETLOGIN(3)-Manpage</member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getpgid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getpgid.xml diff -u phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.6 phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getpgid.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getpgid.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getpgid" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getpgid</refname> @@ -38,7 +38,24 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Kennung als Ganzzahl zurück. + Gibt die Kennung als <type>Ganzzahl</type> zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>posix_getpgid</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$pid = posix_getppid(); +echo posix_getpgid($pid); //35 +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -46,13 +63,24 @@ &reftitle.notes; <note> <para> - Dies ist keine POSIX-Funktion, ist aber auf BSD- und System V-Systemen - gängig. Falls Ihr System diese Funktion nicht auf der Systemebene - unterstützt, gibt diese PHP-Funktion immer &false; zurück. + Dies ist keine POSIX-Funktion, aber sie ist auf BSD- und System V-Systemen + gängig. Falls Ihr System diese Funktion nicht unterstützt, wird sie + während der Übersetzung nicht eingebunden. Ob es die Funktion gibt, kann + mittels <function>function_exists</function> überprüft werden. </para> </note> </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>posix_getppid</function></member> + <member> SETPGID(2)-Manpage</member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/functions/posix-getpgrp.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/posix/functions/posix-getpgrp.xml diff -u phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.6 phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.7 --- phpdoc-de/reference/posix/functions/posix-getpgrp.xml:1.6 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/functions/posix-getpgrp.xml Thu Aug 9 18:13:24 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.posix-getpgrp" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>posix_getpgrp</refname> @@ -21,7 +21,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Gibt die Kennung als Ganzzahl zurück. + Gibt die Kennung als <type>Ganzzahl</type> zurück. </para> </refsect1> @@ -30,8 +30,8 @@ <para> <simplelist> <member> - Sehen Sie sich dazu POSIX.1 und die getpgrp(2)-Manpage auf Ihrem - POSIX-System an, um mehr Informationen über Prozessgruppen zu erhalten. + Die POSIX.1- und die getpgrp(2)-Manpage auf dem POSIX-System um mehr + Informationen über Prozessgruppen zu erhalten. </member> </simplelist> </para>