summaryrefslogtreecommitdiff
path: root/reference/C/MAN/setegid.htm
diff options
context:
space:
mode:
authorTobias Klauser <tklauser@distanz.ch>2008-01-27 11:37:44 +0100
committerTobias Klauser <tklauser@xenon.tklauser.home>2008-01-27 11:37:44 +0100
commit7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch)
treeb1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/MAN/setegid.htm
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/MAN/setegid.htm')
-rw-r--r--reference/C/MAN/setegid.htm98
1 files changed, 98 insertions, 0 deletions
diff --git a/reference/C/MAN/setegid.htm b/reference/C/MAN/setegid.htm
new file mode 100644
index 0000000..d1dd511
--- /dev/null
+++ b/reference/C/MAN/setegid.htm
@@ -0,0 +1,98 @@
+<TITLE>setegid</TITLE>
+<body bgcolor="#ffffcc">
+<hr>
+<pre>
+
+
+
+<h3>SETREGID(2) Linux Programmer's Manual SETREGID(2)
+</h3>
+
+<h3>NAME
+</h3> setregid, setegid - set real and / or effective group ID
+
+<h3>SYNOPSIS
+</h3> #include &lt;unistd.h&gt;
+
+ int setregid(gid_t rgid, gid_t egid);
+ int setegid(gid_t egid);
+
+<h3>DESCRIPTION
+</h3> setregid sets real and effective group ID's of the current
+ process. Un-privileged users may change the real group ID
+ to the effective group ID and vice-versa.
+
+ Prior to Linux 1.1.38, the saved ID paradigm, when used
+ with setregid or setegid was broken. Starting at 1.1.38,
+ it is also possible to set the effective group ID from the
+ saved user ID.
+
+ Only the super-user may make other changes.
+
+ Supplying a value of -1 for either the real or effective
+ group ID forces the system to leave that ID unchanged.
+
+ Currently (libc-4.x.x), setegid(egid) is functionally
+ equivalent to setregid(-1, egid).
+
+ If the real group ID is changed or the effective group ID
+ is set to a value not equal to the previous real group ID,
+ the saved group ID will be set to the new effective group
+ ID.
+
+<h3>RETURN VALUE
+</h3> On success, zero is returned. On error, -1 is returned,
+ and errno is set appropriately.
+
+<h3>ERRORS
+</h3> EPERM The current process is not the super-user and
+ changes other than (i) swapping the effective
+ group ID with the real group ID or (ii) setting
+ one to the value of the other or (iii) setting the
+ effective group ID to the value of the saved group
+ ID was specified.
+
+<h3>HISTORY
+</h3> The setregid function call appeared in BSD 4.2.
+
+<h3>CONFORMING TO
+</h3> BSD 4.3
+
+</pre>
+<hr>
+<h3>SEE ALSO
+</h3><p>
+<a href=getgid.htm>getgid</a>,
+<a href=setgid.htm>setgid</a>,
+<pre>
+
+
+
+
+
+<h3>Linux 1.1.38 2nd August 1994 1
+</h3>
+
+ </pre>
+<P>
+<hr>
+<p>
+<center>
+<table border=2 width=80%>
+<tr align=center>
+<td width=25%>
+<a href=../cref.html>Top</a>
+</td><td width=25%>
+<a href=../master_index.html>Master Index</a>
+</td><td width=25%>
+<a href=../SYNTAX/keywords.html>Keywords</a>
+</td><td width=25%>
+<a href=../FUNCTIONS/funcref.htm>Functions</a>
+</td>
+</tr>
+</table>
+</center>
+<p>
+<hr>
+
+This manual page was brought to you by <i>mjl_man V-2.0</i>