X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman2%2Fsetuid.2;h=506cca086a718e6074e8086a2b68e120cefba6e1;hb=110dba020f489b75aff2497105f7970c05e2b87c;hp=1095c3ac26fe536c390245d975d2744bbdee21bc;hpb=c03a7a882c608ebf399d1b044ce7a6daa922351a;p=linuxjm%2FLDP_man-pages.git diff --git a/original/man2/setuid.2 b/original/man2/setuid.2 index 1095c3ac..506cca08 100644 --- a/original/man2/setuid.2 +++ b/original/man2/setuid.2 @@ -1,5 +1,6 @@ .\" Copyright (C), 1994, Graeme W. Wilford (Wilf). .\" +.\" %%%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. @@ -19,13 +20,14 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" Fri Jul 29th 12:56:44 BST 1994 Wilf. .\" Changes inspired by patch from Richard Kettlewell .\" , aeb 970616. .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements -.TH SETUID 2 2010-02-21 "Linux" "Linux Programmer's Manual" +.TH SETUID 2 2010-11-22 "Linux" "Linux Programmer's Manual" .SH NAME setuid \- set user identity .SH SYNOPSIS @@ -65,7 +67,7 @@ root privileges afterward cannot use .BR setuid (). You can accomplish this with .BR seteuid (2). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -87,29 +89,47 @@ The user is not privileged (Linux: does not have the capability) and .I uid does not match the real UID or saved set-user-ID of the calling process. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. Not quite compatible with the 4.4BSD call, which sets all of the real, saved, and effective user IDs. .\" SVr4 documents an additional EINVAL error condition. .SH NOTES -.SS Linux Notes -Linux has the concept of file system user ID, normally equal to the +Linux has the concept of the filesystem user ID, normally equal to the effective user ID. The .BR setuid () -call also sets the file system user ID of the calling process. +call also sets the filesystem user ID of the calling process. See .BR setfsuid (2). .PP If .I uid -is different from the old effective uid, the process will +is different from the old effective UID, the process will be forbidden from leaving core dumps. -.SH "SEE ALSO" + +The original Linux +.BR setuid () +system call supported only 16-bit user IDs. +Subsequently, Linux 2.4 added +.BR setuid32 () +supporting 32-bit IDs. +The glibc +.BR setuid () +wrapper function transparently deals with the variation across kernel versions. +.SH SEE ALSO .BR getuid (2), .BR seteuid (2), .BR setfsuid (2), .BR setreuid (2), .BR capabilities (7), .BR credentials (7) +.SH COLOPHON +This page is part of release 3.68 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/.