From 5a3dd911f2176507fa187f525dcd943a03a4f01f Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Thu, 27 Dec 2007 15:19:31 +0000
Subject: [PATCH] Rewrote various parts.

---
 man2/getresuid.2 | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/man2/getresuid.2 b/man2/getresuid.2
index 26e924d55..34fb4e106 100644
--- a/man2/getresuid.2
+++ b/man2/getresuid.2
@@ -1,6 +1,7 @@
 .\" Hey Emacs! This file is -*- nroff -*- source.
 .\"
 .\" Copyright (C) 1997 Andries Brouwer (aeb@cwi.nl)
+.\" and Copyright (c) 2007, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
@@ -23,9 +24,9 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
 .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com>
-.TH GETRESUID 2 2003-05-26 "Linux" "Linux Programmer's Manual"
+.TH GETRESUID 2 2007-12-28 "Linux" "Linux Programmer's Manual"
 .SH NAME
-getresuid, getresgid \- get real, effective and saved user or group ID
+getresuid, getresgid \- get real, effective and saved user/group IDs
 .SH SYNOPSIS
 .B #define _GNU_SOURCE
 .br
@@ -36,11 +37,15 @@ getresuid, getresgid \- get real, effective and saved user or group ID
 .BI "int getresgid(gid_t *" rgid ", gid_t *" egid ", gid_t *" sgid );
 .SH DESCRIPTION
 .BR getresuid ()
+returns the real UID, the effective UID, and the saved set-user-ID
+of the calling process, in the arguments
+.IR ruid ,
+.IR euid ,
 and
+.IR suid ,
+respectively.
 .BR getresgid ()
-(both introduced in Linux 2.1.44)
-get the real UID, effective UID, and saved set-user-ID (resp. group ID's)
-of the current process.
+performs the analogous task for the process's group IDs.
 .SH "RETURN VALUE"
 On success, zero is returned.
 On error, \-1 is returned, and
@@ -51,17 +56,20 @@ is set appropriately.
 .B EFAULT
 One of the arguments specified an address outside the calling program's
 address space.
-.SH "CONFORMING TO"
-These calls are non-standard;
-they also appear on HP-UX and some of the BSDs.
+.SH VERSIONS
+These system calls appeared on Linux starting with kernel 2.1.44.
 
-The prototype is given by glibc since version 2.3.2
+The prototypes are given by glibc since version 2.3.2,
 provided
 .B _GNU_SOURCE
 is defined.
+.SH "CONFORMING TO"
+These calls are non-standard;
+they also appear on HP-UX and some of the BSDs.
 .SH "SEE ALSO"
 .BR getuid (2),
 .BR setresuid (2),
 .BR setreuid (2),
 .BR setuid (2),
+.BR credentials (7),
 .BR feature_test_macros (7)