samesch Fri Feb 23 13:08:30 2001 EDT
Modified files:
/phpdoc/de/functions posix.xml
Log:
added permanently (cvs told me to do so ;-)
Index: phpdoc/de/functions/posix.xml
diff -u /dev/null phpdoc/de/functions/posix.xml:1.6
--- /dev/null Fri Feb 23 13:08:30 2001
+++ phpdoc/de/functions/posix.xml Fri Feb 23 13:08:30 2001
@@ -0,0 +1,854 @@
+ <reference id="ref.posix">
+ <title>POSIX Funktionen</title>
+ <titleabbrev>POSIX</titleabbrev>
+
+ <partintro>
+ <para>
+ Dieses Modul enth�lt 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
+ Verf�gung. 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>posix_kill</function></funcdef>
+ <paramdef>int <parameter>pid</parameter></paramdef>
+ <paramdef>int <parameter>sig</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion sendet das Signal <parameter>sig</parameter> zum
+ Prozess mit der Prozesskennung (Prozess-ID)
+ <parameter>pid</parameter>. Sie gibt FALSE zur�ck, 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 zus�tzliche Informationen �ber negative Prozess-IDs, die
+ speziellen pid 0 und -1 und die Signalnummer 0 enth�lt.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getpid">
+ <refnamediv>
+ <refname>posix_getpid</refname>
+ <refpurpose>Liefert die aktuelle Prozesskennung</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getpid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die Prozesskennung des aktuellen Prozesses
+ zur�ck.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getppid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die Prozesskennung des Elternprozesses des
+ aktuellen Prozesses zur�ck.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getuid">
+ <refnamediv>
+ <refname>posix_getuid</refname>
+ <refpurpose>
+ Liefert die wirkliche Benutzer-ID des aktuellen Prozesses
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getuid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die numerische wirkliche Benutzer-ID des
+ aktuellen Prozesses zur�ck. F�r Informationen, wie die
+ Benutzer-ID in einen gebr�uchlichen 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_geteuid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die numerische effektive Benutzer-ID des
+ aktuellen Prozesses zur�ck. F�r Informationen, wie die
+ Benutzer-ID in einen gebr�uchlichen 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 wirkliche Gruppen-ID des aktuellen Prozesses
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getgid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die numerische wirkliche Gruppen-ID des
+ aktuellen Prozesses zur�ck. F�r Informationen, wie die Gruppen-ID
+ in einen gebr�uchlichen 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getegid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt die numerische effektive Gruppen-ID des
+ aktuellen Prozesses zur�ck.
+ </para>
+ <para>
+ F�r Informationen, wie die Gruppen-ID in einen gebr�uchlichen
+ 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 effektive Benutzer-ID des aktuellen Prozesses
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>posix_setuid</function></funcdef>
+ <paramdef>int <parameter>uid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion setzt die wirkliche Benutzer-ID
+ <parameter>uid</parameter> des aktuellen Prozesses. Es handelt
+ sich um eine privilegierte Funktion, f�r die Sie die
+ entspechenden Berechtigungen (normalerweise root) auf Ihrem
+ System ben�tigen, um diese Funktion ausf�hren zu k�nnen.
+ </para>
+ <para>
+ Gibt bei Erfolg TRUE und andernfalls FALSE zur�ck.
+ </para>
+ <para>
+ Siehe auch: <function>posix_setgid</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-setgid">
+ <refnamediv>
+ <refname>posix_setgid</refname>
+ <refpurpose>
+ Setzt die effektive Gruppen-ID des aktuellen Prozesses
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>posix_setgid</function></funcdef>
+ <paramdef>int <parameter>gid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion setzt die wirkliche Gruppen-ID
+ <parameter>gid</parameter> des aktuellen Prozesses. Es handelt
+ sich um eine privilegierte Funktion, f�r die Sie die
+ entspechenden Berechtigungen (normalerweise root) auf Ihrem
+ System ben�tigen, um diese Funktion ausf�hren zu k�nnen.
+ </para>
+ <para>
+ Gibt bei Erfolg TRUE und andernfalls FALSE zur�ck.
+ </para>
+ <para>
+ Siehe auch: <function>posix_setuid</function>.
+ </para>
+ <para>
+ Set the real group ID of the current process. This is a
+ privileged function and you need appropriate privileges (usually
+ root) on your system to be able to perform this function. The
+ appropriate order of function calls is
+ <function>posix_setgid</function> first,
+ <function>posix_setuid</function> last.</para>
+ <para>
+ Returns TRUE on success, FALSE otherwise.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getgroups">
+ <refnamediv>
+ <refname>posix_getgroups</refname>
+ <refpurpose>
+ Return the group set of the current process
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getgroups</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns an array of integers containing the numeric group ids of
+ the group set of the current process. See also
+ <function>posix_getgrgid</function> for information on how to
+ convert this into useable group names.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getlogin">
+ <refnamediv>
+ <refname>posix_getlogin</refname>
+ <refpurpose>Return login name</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>posix_getlogin</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns the login name of the user owning the current process.
+ See <function>posix_getpwnam</function> for information how to
+ get more information about this user.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getpgrp">
+ <refnamediv>
+ <refname>posix_getpgrp</refname>
+ <refpurpose>
+ Return the current process group identifier
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getpgrp</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Return the process group identifier of the current process. See
+ POSIX.1 and the getpgrp(2) manual page on your POSIX system for
+ more information on process groups.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-setsid">
+ <refnamediv>
+ <refname>posix_setsid</refname>
+ <refpurpose>Make the current process a session leader</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_setsid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Make the current process a session leader. See POSIX.1 and
+ the setsid(2) manual page on your POSIX system for more
+ informations on process groups and job control. Returns
+ the session id.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-setpgid">
+ <refnamediv>
+ <refname>posix_setpgid</refname>
+ <refpurpose>set process group id for job control</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_setpgid</function></funcdef>
+ <paramdef>int <parameter>pid</parameter></paramdef>
+ <paramdef>int <parameter>pgid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Let the process <parameter>pid</parameter> join the process
+ group <parameter>pgid</parameter>. See POSIX.1 and
+ the setsid(2) manual page on your POSIX system for more
+ informations on process groups and job control. Returns
+ TRUE on success, FALSE otherwise.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getpgid">
+ <refnamediv>
+ <refname>posix_getpgid</refname>
+ <refpurpose>Get process group id for job control</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getpgid</function></funcdef>
+ <paramdef>int <parameter>pid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns the process group identifier of the process
+ <parameter>pid</parameter>.</para>
+ <para>
+ This is not a POSIX function, but is common on BSD and System V
+ systems. If your system does not support this function at system
+ level, this PHP function will always return FALSE.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getsid">
+ <refnamediv>
+ <refname>posix_getsid</refname>
+ <refpurpose>Get the current sid of the process</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>posix_getsid</function></funcdef>
+ <paramdef>int <parameter>pid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Return the sid of the process <parameter>pid</parameter>.
+ If <parameter>pid</parameter> is 0, the sid of the
+ current process is returned.</para>
+ <para>
+ This is not a POSIX function, but is common on System V
+ systems. If your system does not support this function at system
+ level, this PHP function will always return FALSE.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-uname">
+ <refnamediv>
+ <refname>posix_uname</refname>
+ <refpurpose>Get system name</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_uname</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns a hash of strings with information about the
+ system. The indices of the hash are
+ <itemizedlist>
+ <listitem><simpara>
+ sysname - operating system name (e.g. Linux)
+ </simpara></listitem>
+ <listitem><simpara>
+ nodename - system name (e.g. valiant)
+ </simpara></listitem>
+ <listitem><simpara>
+ release - operating system release (e.g. 2.2.10)
+ </simpara></listitem>
+ <listitem><simpara>
+ version - operating system version (e.g. #4 Tue Jul 20
+ 17:01:36 MEST 1999)
+ </simpara></listitem>
+ <listitem><simpara>
+ machine - system architecture (e.g. i586)
+ </simpara></listitem>
+ <listitem><simpara>
+ domainname - DNS domainname (e.g. php.net)
+ </simpara></listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ domainname is a GNU extension and not part of POSIX.1, so this
+ field is only available on GNU systems or when using the GNU libc.
+ </para>
+ <para>
+ Posix requires that you must not make any assumptions about the
+ format of the values, e.g. you cannot rely on three digit version
+ numbers or anything else returned by this function.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-times">
+ <refnamediv>
+ <refname>posix_times</refname>
+ <refpurpose>Get process times</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_times</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns a hash of strings with information about the
+ current process CPU usage. The indices of the hash are
+ <itemizedlist>
+ <listitem><simpara>
+ ticks - the number of clock ticks that have elapsed since
+ reboot.
+ </simpara></listitem>
+ <listitem><simpara>
+ utime - user time used by the current process.
+ </simpara></listitem>
+ <listitem><simpara>
+ stime - system time used by the current process.
+ </simpara></listitem>
+ <listitem><simpara>
+ cutime - user time used by current process and children.
+ </simpara></listitem>
+ <listitem><simpara>
+ cstime - system time used by current process and children.
+ </simpara></listitem>
+ </itemizedlist></para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-ctermid">
+ <refnamediv>
+ <refname>posix_ctermid</refname>
+ <refpurpose>Get path name of controlling terminal</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>posix_ctermid</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-ttyname">
+ <refnamediv>
+ <refname>posix_ttyname</refname>
+ <refpurpose>Determine terminal device name</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>posix_ttyname</function></funcdef>
+ <paramdef>int <parameter>fd</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-isatty">
+ <refnamediv>
+ <refname>posix_isatty</refname>
+ <refpurpose>
+ Determine if a file descriptor is an interactive terminal
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>posix_isatty</function></funcdef>
+ <paramdef>int <parameter>fd</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getcwd">
+ <refnamediv>
+ <refname>posix_getcwd</refname>
+ <refpurpose>Pathname of current directory</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>posix_getcwd</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written ASAP.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-mkfifo">
+ <refnamediv>
+ <refname>posix_mkfifo</refname>
+ <refpurpose>
+ Create a fifo special file (a named pipe)
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>posix_getcwd</function></funcdef>
+ <paramdef>string <parameter>pathname</parameter></paramdef>
+ <paramdef>int <parameter>mode</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written ASAP..</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getgrnam">
+ <refnamediv>
+ <refname>posix_getgrnam</refname>
+ <refpurpose>Return info about a group by name</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getgrnam</function></funcdef>
+ <paramdef>string <parameter>name</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getgrgid">
+ <refnamediv>
+ <refname>posix_getgrgid</refname>
+ <refpurpose>Return info about a group by group id</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getgrgid</function></funcdef>
+ <paramdef>int <parameter>gid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written.</para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getpwnam">
+ <refnamediv>
+ <refname>posix_getpwnam</refname>
+ <refpurpose>Return info about a user by username</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getpwnam</function></funcdef>
+ <paramdef>string <parameter>username</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns an associative array containing information about a
+ user referenced by an alphanumeric username, passed in the
+ <parameter>username</parameter> parameter.
+ </para>
+ <para>
+ The array elements returned are:
+ <table>
+ <title>The user information array</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Element</entry>
+ <entry>Beschreibung</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>name</entry>
+ <entry>
+ The name element contains the username of the user. This is
+ a short, usually less than 16 character "handle" of the user,
+ not her real, full name. This should be the same as the
+ <parameter>username</parameter> parameter used when calling the
+ function, and hence redundant.
+ </entry>
+ </row>
+ <row>
+ <entry>passwd</entry>
+ <entry>
+ The passwd element contains the user's password in an encrypted
+ format. Often, for example on a system employing "shadow"
+ passwords, an asterisk is returned instead.
+ </entry>
+ </row>
+ <row>
+ <entry>uid</entry>
+ <entry>
+ User ID of the user in numeric form.
+ </entry>
+ </row>
+ <row>
+ <entry>gid</entry>
+ <entry>
+ The group ID of the user. Use the function
+ <function>posix_getgrgid</function> to resolve the
+ group name and a list of its members.
+ </entry>
+ </row>
+ <row>
+ <entry>gecos</entry>
+ <entry>
+ GECOS is an obsolete term that refers to the finger information
+ field on a Honeywell batch processing system. The field, however,
+ lives on, and its contents have been formalized by POSIX. The
+ field contains a comma separated list containing the user's full
+ name, office phone, office number, and home phone number. On most
+ systems, only the user's full name is available.
+ </entry>
+ </row>
+ <row>
+ <entry>dir</entry>
+ <entry>
+ This element contains the absolute path to the
+ home directory of the user.
+ </entry>
+ </row>
+ <row>
+ <entry>shell</entry>
+ <entry>
+ The shell element contains the absolute path to the executable of
+ the user's default shell.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getpwuid">
+ <refnamediv>
+ <refname>posix_getpwuid</refname>
+ <refpurpose>Return info about a user by user id</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getpwuid</function></funcdef>
+ <paramdef>int <parameter>uid</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Returns an associative array containing information about a
+ user referenced by a numeric user ID, passed in the
+ <parameter>uid</parameter> parameter.
+ </para>
+ <para>
+ The array elements returned are:
+ <table>
+ <title>The user information array</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Element</entry>
+ <entry>Beschreibung</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>name</entry>
+ <entry>
+ The name element contains the username of the user. This is
+ a short, usually less than 16 character "handle" of the user,
+ not her real, full name.
+ </entry>
+ </row>
+ <row>
+ <entry>passwd</entry>
+ <entry>
+ The passwd element contains the user's password in an encrypted
+ format. Often, for example on a system employing "shadow"
+ passwords, an asterisk is returned instead.
+ </entry>
+ </row>
+ <row>
+ <entry>uid</entry>
+ <entry>
+ User ID, should be the same as the <parameter>uid</parameter>
+ parameter used when calling the function, and hence redundant.
+ </entry>
+ </row>
+ <row>
+ <entry>gid</entry>
+ <entry>
+ The group ID of the user. Use the function
+ <function>posix_getgrgid</function> to resolve the
+ group name and a list of its members.
+ </entry>
+ </row>
+ <row>
+ <entry>gecos</entry>
+ <entry>
+ GECOS is an obsolete term that refers to the finger information
+ field on a Honeywell batch processing system. The field, however,
+ lives on, and its contents have been formalized by POSIX. The
+ field contains a comma separated list containing the user's full
+ name, office phone, office number, and home phone number. On most
+ systems, only the user's full name is available.
+ </entry>
+ </row>
+ <row>
+ <entry>dir</entry>
+ <entry>
+ This element contains the absolute path to the
+ home directory of the user.
+ </entry>
+ </row>
+ <row>
+ <entry>shell</entry>
+ <entry>
+ The shell element contains the absolute path to the executable of
+ the user's default shell.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.posix-getrlimit">
+ <refnamediv>
+ <refname>posix_getrlimit</refname>
+ <refpurpose>Return info about system ressource limits</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>posix_getrlimit</function></funcdef>
+ <paramdef>void <parameter></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Needs to be written ASAP.</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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
