<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.posix">
  <title>POSIX Funktionen</title>
  <titleabbrev>POSIX</titleabbrev>

  <partintro>
   <para>
    Dieses Modul enthlt eine Schnittstelle zu den im IEEE 1003.1
    (POSIX.1) Standards Dokument definierten Funktionen, die durch
    andere Mittel nicht erreichbar sind. POSIX.1 definierte zum
    Beispiel auch die open(), read(), write() und close() Funktionen,
    die seit langer Zeit Bestandteil von PHP 3 sind. Trotzdem standen
    einige andere systemspezifische Funktionen bisher nicht zur
    Verfgung. Dieses Modul versucht hier Abhilfe zu schaffen, indem
    es einen einfachen Zugang zu diesen Funktionen bereitstellt.
   </para>
  </partintro>

  <refentry id="function.posix-kill">
   <refnamediv>
    <refname>posix_kill</refname>
    <refpurpose>Sendet einem Prozess ein Signal</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_kill</methodname>
     <methodparam><type>int</type><parameter>pid</parameter></methodparam>
     <methodparam><type>int</type><parameter>sig</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion sendet das Signal <parameter>sig</parameter> zum
     Prozess mit der Prozesskennung (Prozess-ID)
     <parameter>pid</parameter>. Sie gibt &false; zurck, wenn sie das
     Signal nicht senden konnte, andernfalls &true;.
    </para>
    <para>
     Sehen Sie sich dazu auch die kill(2)-Manpage Ihres POSIX-Systems
     an, die zustzliche Informationen ber negative Prozess-IDs, die
     speziellen pid 0 und -1 und die Signalnummer 0 enthlt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getpid">
   <refnamediv>
    <refname>posix_getpid</refname>
    <refpurpose>Liefert die aktuelle Prozesskennung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getpid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die Prozesskennung des aktuellen Prozesses
     zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getppid">
   <refnamediv>
    <refname>posix_getppid</refname>
    <refpurpose>
     Liefert die Prozesskennung des Elternprozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getppid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die Prozesskennung des Elternprozesses des
     aktuellen Prozesses zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getuid">
   <refnamediv>
    <refname>posix_getuid</refname>
    <refpurpose>
     Liefert die reale Benutzer-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getuid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die reale numerische Benutzer-ID des
     aktuellen Prozesses zurck.
    </para>
    <para>
     Fr Informationen darber, wie die Benutzer-ID in einen
     gebruchlichen Benutzernamen umgewandelt werden kann, siehe auch
     <function>posix_getpwuid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-geteuid">
   <refnamediv>
    <refname>posix_geteuid</refname>
    <refpurpose>
     Liefert die effektive Benutzer-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_geteuid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die effektive numerische Benutzer-ID des
     aktuellen Prozesses zurck.
    </para>
    <para>
     Fr Informationen darber, wie die Benutzer-ID in einen
     gebruchlichen Benutzernamen umgewandelt werden kann, siehe auch
     <function>posix_getpwuid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getgid">
   <refnamediv>
    <refname>posix_getgid</refname>
    <refpurpose>
     Liefert die reale Gruppen-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getgid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die reale numerische Gruppen-ID des
     aktuellen Prozesses zurck.
    </para>
    <para>
     Fr Informationen darber, wie die Gruppen-ID in einen
     gebruchlichen Gruppennamen umgewandelt werden kann, siehe auch
     <function>posix_getgrgid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getegid">
   <refnamediv>
    <refname>posix_getegid</refname>
    <refpurpose>
     Liefert die effektive Gruppen-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getegid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die effektive numerische Gruppen-ID des
     aktuellen Prozesses zurck.
    </para>
    <para>
     Fr Informationen darber, wie die Gruppen-ID in einen
     gebruchlichen Gruppennamen umgewandelt werden kann, siehe auch
     <function>posix_getgrgid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-setuid">
   <refnamediv>
    <refname>posix_setuid</refname> 
    <refpurpose>
     Setzt die Benutzer-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_setuid</methodname>
     <methodparam><type>int</type><parameter>uid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion setzt die reale Benutzer-ID
     <parameter>uid</parameter> des aktuellen Prozesses. Es handelt
     sich um eine privilegierte Funktion, fr die Sie die
     entspechenden Berechtigungen (normalerweise root) auf Ihrem
     System bentigen, um diese Funktion ausfhren zu knnen.
    </para>
    <para>
     Gibt bei Erfolg &true; und andernfalls &false; zurck.
    </para>
    <para>
     Siehe auch: <function>posix_setgid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-seteuid">
   <refnamediv>
    <refname>posix_seteuid</refname>
    <refpurpose>
     Setzt die effektive Benutzer-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_seteuid</methodname>
     <methodparam><type>int</type><parameter>uid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion setzt die effektive Benutzer-ID
     <parameter>uid</parameter> des aktuellen Prozesses. Es handelt
     sich um eine privilegierte Funktion, fr die Sie die
     entspechenden Berechtigungen (normalerweise root) auf Ihrem
     System bentigen, um diese Funktion ausfhren zu knnen.
    </para>
    <para>
     Gibt bei Erfolg &true; und andernfalls &false; zurck.
    </para>
    <para>
     Siehe auch: <function>posix_setgid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-setgid">
   <refnamediv>
    <refname>posix_setgid</refname> 
    <refpurpose>
     Setzt die Gruppen-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_setgid</methodname>
     <methodparam><type>int</type><parameter>gid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion setzt die reale Gruppen-ID
     <parameter>gid</parameter> des aktuellen Prozesses. Es handelt
     sich um eine privilegierte Funktion, fr die Sie die
     entspechenden Berechtigungen (normalerweise root) auf Ihrem
     System bentigen, um diese Funktion ausfhren zu knnen. Die
     sachgeme Reihenfolge der Funktionsaufrufe ist zuerst
     <function>posix_setgid</function> und zuletzt
     <function>posix_setuid</function>.
    </para>
    <para>
     Gibt bei Erfolg &true; und andernfalls &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-setegid">
   <refnamediv>
    <refname>posix_setegid</refname>
    <refpurpose>
     Setzt die effektive Gruppen-ID des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_setegid</methodname>
     <methodparam><type>int</type><parameter>gid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion setzt die effektive Gruppen-ID des aktuellen
     Prozesses. Es handelt sich um eine privilegierte Funktion, fr
     die Sie die entspechenden Berechtigungen (normalerweise root)
     auf Ihrem System bentigen, um diese Funktion ausfhren zu
     knnen.
    </para>
    <para>
     Gibt bei Erfolg &true; und andernfalls &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getgroups">
   <refnamediv>
    <refname>posix_getgroups</refname>
    <refpurpose>
     Liefert die Gruppenliste des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getgroups</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt ein Array von ganzen Zahlen zurck, das die
     numerischen Gruppen-IDs der Gruppenliste des aktuellen Prozesses
     enthlt.
    </para>
    <para>
     Fr Informationen darber, wie die Gruppen-IDs in gebruchliche
     Gruppennamen umgewandelt werden knnen, siehe auch
     <function>posix_getgrgid</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getlogin">
   <refnamediv>
    <refname>posix_getlogin</refname>
    <refpurpose>
     Liefert den Benutzernamen des Eigentmers des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>posix_getlogin</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt den Benutzernamen des Benutzers zurck, dem
     der aktuelle Prozess gehrt.
    </para>
    <para>
     Fr Informationen darber, wie mehr Informationen ber diesen
     Benutzer bekommen werden knnen, siehe
     <function>posix_getpwnam</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getpgrp">
   <refnamediv>
    <refname>posix_getpgrp</refname>
    <refpurpose>
     Liefert die Prozessgruppenkennung des aktuellen Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getpgrp</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die Prozessgruppenkennung des aktuellen
     Prozesses zurck. Sehen Sie sich dazu POSIX.1 und die
     getpgrp(2)-Manpage auf Ihrem POSIX-System an, um mehr
     Informationen ber Prozessgruppen zu erhalten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-setsid">
   <refnamediv>
    <refname>posix_setsid</refname>
    <refpurpose>
     Macht den aktuellen Prozess zum Prozessgruppen-Fhrer
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_setsid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion macht den aktuellen Prozess zum
     Prozessgruppen-Fhrer. Sehen Sie sich dazu POSIX.1 und die
     setsid(2)-Manpage auf Ihrem POSIX-System an, um mehr
     Informationen ber Prozessgruppen und Job-Kontrolle zu
     erhalten.
    </para>
    <para>
     Gibt die Session-ID zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-setpgid">
   <refnamediv>
    <refname>posix_setpgid</refname>
    <refpurpose>
     Setzt die Prozessgruppenkennung (Process Group ID) fr die
     Job-Kontrolle
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_setpgid</methodname>
     <methodparam><type>int</type><parameter>pid</parameter></methodparam>
     <methodparam><type>int</type><parameter>pgid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion fgt den Prozess <parameter>pid</parameter> der
     Prozessgruppe <parameter>pgid</parameter> hinzu. Sehen Sie sich
     dazu POSIX.1 und die setpgid(2)-Manpage auf Ihrem POSIX-System
     an, um mehr Informationen ber Prozessgruppen und Job-Kontrolle
     zu erhalten.
    </para>
    <para>
     Gibt bei Erfolg &true; und andernfalls &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getpgid">
   <refnamediv>
    <refname>posix_getpgid</refname>
    <refpurpose>
     Liefert die Prozessgruppenkennung (Process Group ID) fr die
     Job-Kontrolle
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getpgid</methodname>
     <methodparam><type>int</type><parameter>pid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die Prozessgruppenkennung des Prozzesses
     <parameter>pid</parameter> zurck.
    </para>
    <para>
     Dies ist keine POSIX-Funktion, ist aber auf BSD- und System
     V-Systemen gngig. Falls Ihr System diese Funktion nicht auf der
     Systemebene untersttzt, gibt diese PHP-Funktion immer &false;
     zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getsid">
   <refnamediv>
    <refname>posix_getsid</refname>
    <refpurpose>
     Liefert die aktuelle Session-ID (sid) des Prozesses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>int</type><methodname>posix_getsid</methodname>
     <methodparam><type>int</type><parameter>pid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion gibt die Session-ID des Prozesses
     <parameter>pid</parameter> zurck. Falls
     <parameter>pid</parameter> 0 ist, wird die Session-ID des
     aktuellen Prozesses zurckgegeben.
    </para>
    <para>
     Dies ist keine POSIX-Funktion, ist aber auf BSD- und System
     V-Systemen gngig. Falls Ihr System diese Funktion nicht auf der
     Systemebene untersttzt, gibt diese PHP-Funktion immer &false;
     zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-uname">
   <refnamediv>
    <refname>posix_uname</refname>
    <refpurpose>Liefert Auskunft ber das System</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_uname</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt eine Reihe von Daten mit Informationen ber
     das System zurck. Die Indizes dieser Daten sind
     <itemizedlist>
      <listitem><simpara>
        sysname - Name des Betriebssystems (z.B. Linux)
       </simpara></listitem>
      <listitem><simpara>
        nodename - Name des Systems (z.B. valiant)
       </simpara></listitem>
      <listitem><simpara>
        release - Release des Betriebssystems (z.B. 2.2.10)
       </simpara></listitem>
      <listitem><simpara>
        version - Version des Betriebssystems (z.B. #4 Tue Jul 20
        17:01:36 MEST 1999)
       </simpara></listitem>
      <listitem><simpara>
        machine - Systemarchitektur (z.B. i586)
       </simpara></listitem>
      <listitem><simpara>
        domainname - DNS Domainname (z.B. php.net)
       </simpara></listitem>
     </itemizedlist>
    </para>
    <para>
     domainname ist eine GNU-Erweiterung und nicht Teil von POSIX.1.
     Deshalb steht dieses Feld nur auf GNU-Systemen oder bei
     Verwendung der GNU libc zur Verfgung.
    </para>
    <para>
     Posix erfordert, dass Sie bezglich des Formats der Werte nichts
     voraussetzen drfen, z.B. knnen Sie sich weder darauf verlassen,
     dass die Release-Nummer aus drei Ziffern besteht noch auf
     irgendetwas anderes, das von dieser Funktion zurckgegeben wird.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-times">
   <refnamediv>
    <refname>posix_times</refname>
    <refpurpose>Liefert Rechenzeiten</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_times</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Diese Funktion gibt eine Reihe von Zahlenwerten mit Informationen
     ber die Auslastung der CPU durch den aktuellen Prozess zurck.
     Die Indizes dieser Zahlenwerte sind
     <itemizedlist>
      <listitem>
       <simpara>
        ticks - die Anzahl von Clock-Ticks, die seit dem Reboot
        verstrichen sind.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        utime - Benutzerzeit, die vom aktuellen Prozess verbraucht
        wurde.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        stime - Systemzeit, die vom aktuellen Prozess verbraucht
        wurde.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        cutime - Benutzerzeit, die vom aktuellen Prozess und dessen
        Kindprozessen verbraucht wurde.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        cstime - Systemzeit, die vom aktuellen Prozess und dessen
        Kindprozessen verbraucht wurde.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-ctermid">
   <refnamediv>
    <refname>posix_ctermid</refname>
    <refpurpose>Liefert den Pfad des magebenden Terminals</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>posix_ctermid</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Muss noch geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-ttyname">
   <refnamediv>
    <refname>posix_ttyname</refname>
    <refpurpose>Ermittelt den Namen des Terminal-Devices</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>posix_ttyname</methodname>
     <methodparam><type>int</type><parameter>fd</parameter></methodparam>
    </methodsynopsis>
    <para>
     Muss noch geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-isatty">
   <refnamediv>
    <refname>posix_isatty</refname>
    <refpurpose>
     Ermittelt, ob ein Datei-Deskriptor ein interaktives Terminal ist
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_isatty</methodname>
     <methodparam><type>int</type><parameter>fd</parameter></methodparam>
    </methodsynopsis>
    <para>
     Muss noch geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getcwd">
   <refnamediv>
    <refname>posix_getcwd</refname>
    <refpurpose>Pfadname des aktuellen Verzeichnisses</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>posix_getcwd</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Sollte ASAP geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-mkfifo">
   <refnamediv>
    <refname>posix_mkfifo</refname>
    <refpurpose>
      Erzeugt eine "FIFO special"-Datei (named pipe)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>bool</type><methodname>posix_mkfifo</methodname>
     <methodparam><type>string</type><parameter>Pfadname</parameter></methodparam>
     <methodparam><type>int</type><parameter>Modus</parameter></methodparam>
    </methodsynopsis>
    <para>
     Sollte ASAP geschrieben werden.
    </para>
       &note.sm.uidcheck.dir;
   </refsect1>
  </refentry>

  <refentry id="function.posix-getgrnam">
   <refnamediv>
    <refname>posix_getgrnam</refname>
    <refpurpose>
     Liefert zu einem Gruppennamen Informationen ber diese Gruppe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getgrnam</methodname>
     <methodparam><type>string</type><parameter>Gruppenname</parameter></methodparam>
    </methodsynopsis>
    <para>
     Muss noch geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getgrgid">
   <refnamediv>
    <refname>posix_getgrgid</refname>
    <refpurpose>
     Liefert zu einer Gruppen-ID Informationen ber diese Gruppe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getgrgid</methodname>
     <methodparam><type>int</type><parameter>gid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Muss noch geschrieben werden.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getpwnam">
   <refnamediv>
    <refname>posix_getpwnam</refname>
    <refpurpose>
     Liefert zu einem Benutzernamen Informationen ber diese
     Benutzerin
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getpwnam</methodname>
     <methodparam><type>string</type><parameter>Benutzername</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion gibt ein assoziatives Array zurck, das
     Informationen ber die Benutzerin enthlt, auf die der in
     <parameter>Benutzername</parameter> bergebene alphanumerische
     Benutzername verweist.
    </para>
    <para>
     Die Elemente des zurckgegebenen Array sind:
     <table>
      <title>Das Benutzerinformation-Array</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Element</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>name</entry>
         <entry>
          Das name-Element enthlt den Benutzernamen. Es handelt sich
          dabei nicht um ihren wirklichen, kompletten Namen, sondern
          um einen kurzen "Bezeichner" der Benutzerin mit
          normalerweise weniger als 16 Zeichen. Der Benutzername
          sollte der selbe wie der bei Aufruf der Funktion verwendete
          Parameter <parameter>Benutzername</parameter> sein und ist
          von daher redundant.
         </entry>
         <entry>
         </entry>
        </row>
        <row>
         <entry>passwd</entry>
         <entry>
          Das passwd-Element enthlt das verschlsselte Passwort der
          Benutzerin. Oft, zum Beispiel wenn auf einem System
          "shadow"-Passwrter verwendet werden, wird stattdessen ein
          Sternchen zurckgegeben.
         </entry>
        </row>
        <row>
         <entry>uid</entry>
         <entry>
          Die Benutzer-ID in numerischem Format.
         </entry>
        </row>
        <row>
         <entry>gid</entry>
         <entry>
          Die Gruppen-ID der Benutzerin. Benutzen Sie die Funktion
          <function>posix_getgrgid</function>, um den Gruppennamen und
          eine Liste der Gruppenmitglieder aufzulsen.
         </entry>
        </row>
        <row>
         <entry>gecos</entry>
         <entry>
          GECOS ist ein veralteter Begriff, der sich auf das
          finger-Informationsfeld auf einem Honeywell
          Stapelverarbeitungssystem bezieht. Das Feld gibt es aber
          immer noch und sein Inhalt wurde durch POSIX formalisiert.
          Es enthlt eine durch Komma getrennte Liste, bestehend aus
          dem kompletten Namen der Benutzerin, der Telefonnummer des
          Bros, der Zimmernummer des Bros und der privaten
          Telefonnummer. Auf den meisten Systemen ist nur der
          komplette Name der Benutzerin verfgbar.
         </entry>
        </row>
        <row>
         <entry>dir</entry>
         <entry>
          Dieses Element enthlt den absoluten Pfad des
          Homeverzeichnisses der Benutzerin.
         </entry>
        </row>
        <row>
         <entry>shell</entry>
         <entry>
          Das shell-Element enthlt den absoluten Pfad zur
          standardmigen Shell der Benutzerin.
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>    
   </refsect1>
  </refentry>
  
  <refentry id="function.posix-getpwuid">
   <refnamediv>
    <refname>posix_getpwuid</refname>
    <refpurpose>
     Liefert zu einer Benutzer-ID Informationen ber diese
     Benutzerin
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getpwuid</methodname>
     <methodparam><type>int</type><parameter>uid</parameter></methodparam>
    </methodsynopsis>
    <para>
     Diese Funktion gibt ein assoziatives Array zurck, das
     Informationen ber die Benutzerin enthlt, auf die die in
     <parameter>uid</parameter> bergebene numerische Benutzer-ID
     verweist.
    </para>
    <para>
     Die Elemente des zurckgegebenen Array sind:
     <table>
      <title>Das Benutzerinformation-Array</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Element</entry>
         <entry>Beschreibung</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>name</entry>
         <entry>
          Das name-Element enthlt den Benutzernamen. Es handelt sich
          dabei nicht um ihren wirklichen, kompletten Namen, sondern
          um einen kurzen "Bezeichner" der Benutzerin mit
          normalerweise weniger als 16 Zeichen.
         </entry>
        </row>
        <row>
         <entry>passwd</entry>
         <entry>
          Das passwd-Element enthlt das verschlsselte Passwort der
          Benutzerin. Oft, zum Beispiel wenn auf einem System
          "shadow"-Passwrter verwendet werden, wird stattdessen ein
          Sternchen zurckgegeben.
         </entry>
        </row>
        <row>
         <entry>uid</entry>
         <entry>
          Die Benutzer-ID sollte die selbe wie der Parameter
          <parameter>uid</parameter> sein und ist von daher redundant.
         </entry>
        </row>
        <row>
         <entry>gid</entry>
         <entry>
          Die Gruppen-ID der Benutzerin. Benutzen Sie die Funktion
          <function>posix_getgrgid</function>, um den Gruppennamen und
          eine Liste der Gruppenmitglieder aufzulsen.
         </entry>
        </row>
        <row>
         <entry>gecos</entry>
         <entry>
          GECOS ist ein veralteter Begriff, der sich auf das
          finger-Informationsfeld auf einem Honeywell
          Stapelverarbeitungssystem bezieht. Das Feld gibt es aber
          immer noch und sein Inhalt wurde durch POSIX formalisiert.
          Es enthlt eine durch Komma getrennte Liste, bestehend aus
          dem kompletten Namen der Benutzerin, der Telefonnummer des
          Bros, der Zimmernummer des Bros und der privaten
          Telefonnummer. Auf den meisten Systemen ist nur der
          komplette Name der Benutzerin verfgbar.
         </entry>
        </row>
        <row>
         <entry>dir</entry>
         <entry>
          Dieses Element enthlt den absoluten Pfad des
          Homeverzeichnisses der Benutzerin.
         </entry>
        </row>
        <row>
         <entry>shell</entry>
         <entry>
          Das shell-Element enthlt den absoluten Pfad zur
          standardmigen Shell der Benutzerin.
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.posix-getrlimit">
   <refnamediv>
    <refname>posix_getrlimit</refname>
    <refpurpose>
     Liefert Informationen ber Systemressourcen-Limits
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
    <methodsynopsis>
     <type>array</type><methodname>posix_getrlimit</methodname>
     <void/>
    </methodsynopsis>
    <para>
     Sollte ASAP geschrieben werden.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->