From cb32853d408aae8ff15a8d5005362a02cf912fdb Mon Sep 17 00:00:00 2001
From: Hartmut Holzgraefe <hholzgra@php.net>
Date: Sun, 16 Dec 2001 11:51:32 +0000
Subject: [PATCH] added documentation for seteuid() and setegid()

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@65278 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/posix.xml | 59 ++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 56 insertions(+), 3 deletions(-)

diff --git a/functions/posix.xml b/functions/posix.xml
index 98361e0303..b3562f55e2 100644
--- a/functions/posix.xml
+++ b/functions/posix.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
  <reference id="ref.posix">
   <title>POSIX functions</title>
   <titleabbrev>POSIX</titleabbrev>
@@ -179,7 +179,7 @@
    <refnamediv>
     <refname>posix_setuid</refname> 
     <refpurpose>
-     Set the effective UID of the current process
+     Set the UID of the current process
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -202,11 +202,38 @@
    </refsect1>
   </refentry>
 
+  <refentry id="function.posix-seteuid">
+   <refnamediv>
+    <refname>posix_seteuid</refname> 
+    <refpurpose>
+     Set the effective UID of the current process
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>bool <function>posix_seteuid</function></funcdef>
+      <paramdef>int <parameter>uid</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     Set the real user 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.
+    </para>
+    <para>
+     Returns &true; on success, &false; otherwise. See also
+     <function>posix_setgid</function>.
+    </para>
+   </refsect1>
+  </refentry>
+
   <refentry id="function.posix-setgid">
    <refnamediv>
     <refname>posix_setgid</refname> 
     <refpurpose>
-     Set the effective GID of the current process
+     Set the GID of the current process
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -231,6 +258,32 @@
    </refsect1>
   </refentry>
 
+  <refentry id="function.posix-setegid">
+   <refnamediv>
+    <refname>posix_setegid</refname> 
+    <refpurpose>
+     Set the effective GID of the current process
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>bool <function>posix_setegid</function></funcdef>
+      <paramdef>int <parameter>gid</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     Set the effective 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.
+    </para>
+    <para>
+     Returns &true; on success, &false; otherwise.
+    </para>
+   </refsect1>
+  </refentry>
+
   <refentry id="function.posix-getgroups">
    <refnamediv>
     <refname>posix_getgroups</refname>