X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman2%2Fsetresuid.2;h=83a528a58982a823a6fbfe08522619c806f500de;hb=c22bb444e1a8f4a0e08a82e80ea4ad06593869da;hp=20f0227440a64f616323bb0be03f8373c9f5dc77;hpb=8fbe23d0114c8804c4cfb5b6c57f3ca09c8fee1d;p=linuxjm%2FLDP_man-pages.git diff --git a/original/man2/setresuid.2 b/original/man2/setresuid.2 index 20f02274..83a528a5 100644 --- 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, -.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 . 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/.