execve.2, exec.3: Consistently use the term 'pathname' (not 'path')

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

diff --git a/man2/getuid.2 b/man2/getuid.2
index 655ee69930d635065acac50f5f375d557d86888e..ca2ccecc4d41406dfd17c75c286470b09ec80287 100644 (file)
--- a/man2/getuid.2
+++ b/man2/getuid.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
 .\"
+.\" %%%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.
@@ -10,7 +9,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
@@ -18,35 +17,77 @@
 .\" 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.
+.\" %%%LICENSE_END
 .\"
 .\" Historical remark, aeb, 2004-06-05
-.TH GETUID 2 1993-07-23 "Linux 0.99.11" "Linux Programmer's Manual"
+.TH GETUID 2 2019-03-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 getuid, geteuid \- get user identity
 .SH SYNOPSIS
 .B #include <unistd.h>
 .br
 .B #include <sys/types.h>
-.sp
+.PP
 .B uid_t getuid(void);
 .br
 .B uid_t geteuid(void);
 .SH DESCRIPTION
 .BR getuid ()
-returns the real user ID of the current process.
-
+returns the real user ID of the calling process.
+.PP
 .BR geteuid ()
-returns the effective user ID of the current process.
+returns the effective user ID of the calling process.
 .SH ERRORS
 These functions are always successful.
-.SH "CONFORMING TO"
-POSIX, 4.3BSD.
-.SH HISTORY
-In Unix V6 the \fBgetuid()\fP call returned (euid << 8) + uid.
-Unix V7 introduced separate calls \fBgetuid()\fP and \fBgeteuid()\fP.
-.SH "SEE ALSO"
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, 4.3BSD.
+.SH NOTES
+.SS History
+In UNIX\ V6 the
+.BR getuid ()
+call returned
+.IR "(euid << 8) + uid" .
+UNIX\ V7 introduced separate calls
+.BR getuid ()
+and
+.BR geteuid ().
+.PP
+The original Linux
+.BR getuid ()
+and
+.BR geteuid ()
+system calls supported only 16-bit user IDs.
+Subsequently, Linux 2.4 added
+.BR getuid32 ()
+and
+.BR geteuid32 (),
+supporting 32-bit IDs.
+The glibc
+.BR getuid ()
+and
+.BR geteuid ()
+wrapper functions transparently deal with the variations across kernel versions.
+.PP
+On Alpha, instead of a pair of
+.BR getuid ()
+and
+.BR geteuid ()
+system calls, a single
+.BR getxuid ()
+system call is provided, which returns a pair of real and effective UIDs.
+The glibc
+.BR getuid ()
+and
+.BR geteuid ()
+wrapper functions transparently deal with this.
+See
+.BR syscall (2)
+for details regarding register mapping.
+.SH SEE ALSO
+.BR getresuid (2),
 .BR setreuid (2),
-.BR setuid (2)
+.BR setuid (2),
+.BR credentials (7)