Rewrote various parts.

This commit is contained in:
Michael Kerrisk 2007-12-27 15:19:31 +00:00
parent 1e48734a07
commit 5a3dd911f2
1 changed files with 17 additions and 9 deletions

View File

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