Wrapped long lines, wrapped at sentence boundaries; stripped trailing

[thirdparty/man-pages.git] / man2 / setuid.2

diff --git a/man2/setuid.2 b/man2/setuid.2
index 017c981b11182d28174049f54a795f35696038f3..80cbc3e66122e454781e42bd5f5ced3775284f21 100644 (file)
--- a/man2/setuid.2
+++ b/man2/setuid.2
@@ -8,7 +8,7 @@
 .\" manual under the conditions for verbatim copying, provided that the
 .\" entire resulting derived work is distributed under the terms of a
 .\" permission notice identical to this one.
-.\" 
+.\"
 .\" Since the Linux kernel and libraries are constantly changing, this
 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
 .\" responsibility for errors or omissions, or for damages resulting from
@@ -16,11 +16,11 @@
 .\" have taken the same level of care in the production of this manual,
 .\" which is licensed free of charge, as they might when working
 .\" professionally.
-.\" 
+.\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.\" Fri Jul 29th 12:56:44 BST 1994  Wilf. <G.Wilford@ee.surrey.ac.uk> 
+.\" Fri Jul 29th 12:56:44 BST 1994  Wilf. <G.Wilford@ee.surrey.ac.uk>
 .\" Changes inspired by patch from Richard Kettlewell
 .\"   <richard@greenend.org.uk>, aeb 970616.
 .\" Modified, 27 May 2004, Michael Kerrisk <mtk-manpages@gmx.net>
@@ -40,7 +40,7 @@ sets the effective user ID of the current process.
 If the effective UID of the caller is root,
 the real UID and saved set-user-ID are also set.
 .PP
-Under Linux, 
+Under Linux,
 .BR setuid ()
 is implemented like the POSIX version with the _POSIX_SAVED_IDS feature.
 This allows a set-user-ID (other than root) program to drop all of its user
@@ -48,22 +48,24 @@ privileges, do some un-privileged work, and then re-engage the original
 effective user ID in a secure manner.
 .PP
 If the user is root or the program is set-user-ID-root, special care must be
-taken. The 
+taken.
+The
 .BR setuid ()
 function checks the effective user ID of the caller and if it is
 the superuser, all process related user ID's are set to
-.IR uid . 
+.IR uid .
 After this has occurred, it is impossible for the program to regain root
 privileges.
 .PP
 Thus, a set-user-ID-root program wishing to temporarily drop root
 privileges, assume the identity of a non-root user, and then regain
-root privileges afterwards cannot use 
+root privileges afterwards cannot use
 .BR setuid ().
 You can accomplish this with the (non-POSIX, BSD) call
 .BR seteuid ().
 .SH "RETURN VALUE"
-On success, zero is returned.  On error, \-1 is returned, and
+On success, zero is returned.
+On error, \-1 is returned, and
 .I errno
 is set appropriately.
 .SH ERRORS
@@ -71,7 +73,7 @@ is set appropriately.
 .B EAGAIN
 The
 .I uid
-does not match the current uid and 
+does not match the current uid and
 .I uid
 brings process over it's NPROC rlimit.
 .TP
@@ -82,13 +84,14 @@ capability) and
 .I uid
 does not match the real UID or saved set-user-ID of the calling process.
 .SH "CONFORMING TO"
-SVr4, POSIX.1-2001.  
+SVr4, POSIX.1-2001.
 Not quite compatible with the 4.4BSD call, which
-sets all of the real, saved, and effective user IDs.  
+sets all of the real, saved, and effective user IDs.
 .\" SVr4 documents an additional EINVAL error condition.
 .SH "LINUX-SPECIFIC REMARKS"
 Linux has the concept of filesystem user ID, normally equal to the
-effective user ID.  The
+effective user ID.
+The
 .BR setuid ()
 call also sets the filesystem user ID of the current process.
 See