LDP: Update original to LDP v3.67

[linuxjm/LDP_man-pages.git] / original / man2 / setresuid.2

diff --git a/original/man2/setresuid.2 b/original/man2/setresuid.2
index 20f0227..83a528a 100644 (file)
--- a/original/man2/setresuid.2
+++ b/original/man2/setresuid.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (C) 1997 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,9 +20,10 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com>
-.TH SETRESUID 2 2007-07-26 "Linux" "Linux Programmer's Manual"
+.TH SETRESUID 2 2010-11-22 "Linux" "Linux Programmer's Manual"
 .SH NAME
 setresuid, setresgid \- set real, effective and saved user or group ID
 .SH SYNOPSIS
@@ -52,16 +52,16 @@ saved set-user-ID to arbitrary values.
 If one of the arguments equals \-1, the corresponding value is not changed.
 
 Regardless of what changes are made to the real UID, effective UID,
-and saved set-user-ID, the file system UID is always set to the same
+and saved set-user-ID, the filesystem UID is always set to the same
 value as the (possibly new) effective UID.
 
 Completely analogously,
 .BR setresgid ()
 sets the real GID, effective GID, and saved set-group-ID
-of the calling process (and always modifies the file system GID
+of the calling process (and always modifies the filesystem GID
 to be the same as the effective GID),
 with the same restrictions for unprivileged processes.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success, zero is returned.
 On error, \-1 is returned, and
 .I errno
@@ -80,14 +80,30 @@ The calling process is not privileged (did not have the \fBCAP_SETUID\fP
 capability) and tried to change the IDs to values that are not permitted.
 .SH VERSIONS
 These calls are available under Linux since Linux 2.1.44.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 These calls are nonstandard;
 they also appear on HP-UX and some of the BSDs.
 .SH NOTES
-Under HP-UX and FreeBSD the prototype is found in
+Under HP-UX and FreeBSD, the prototype is found in
 .IR <unistd.h> .
 Under Linux the prototype is provided by glibc since version 2.3.2.
-.SH "SEE ALSO"
+
+The original Linux
+.BR setresuid ()
+and
+.BR setresgid ()
+system calls supported only 16-bit user and group IDs.
+Subsequently, Linux 2.4 added
+.BR setresuid32 ()
+and
+.BR setresgid32 (),
+supporting 32-bit IDs.
+The glibc
+.BR setresuid ()
+and
+.BR setresgid ()
+wrapper functions transparently deal with the variations across kernel versions.
+.SH SEE ALSO
 .BR getresuid (2),
 .BR getuid (2),
 .BR setfsgid (2),
@@ -96,3 +112,12 @@ Under Linux the prototype is provided by glibc since version 2.3.2.
 .BR setuid (2),
 .BR capabilities (7),
 .BR credentials (7)
+.SH COLOPHON
+This page is part of release 3.67 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.