manual page first distributed with 4.2BSD

SCCS-vsn: lib/libc/sys/getgid.2 5.1

diff --git a/usr/src/lib/libc/sys/getgid.2 b/usr/src/lib/libc/sys/getgid.2
new file mode 100644 (file)
index 0000000..bd9a24a
--- /dev/null
+++ b/usr/src/lib/libc/sys/getgid.2
@@ -0,0 +1,34 @@
+.\" Copyright (c) 1983 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)getgid.2    5.1 (Berkeley) %G%
+.\"
+.TH GETGID 2 "12 February 1983"
+.UC 5
+.SH NAME
+getgid, getegid \- get group identity
+.SH SYNOPSIS
+.nf
+.ft B
+gid = getgid()
+int gid;
+.PP
+.ft B
+egid = getegid()
+int egid;
+.fi
+.SH DESCRIPTION
+.I Getgid
+returns the real group ID of the current process,
+.I getegid
+the effective group ID.
+.PP
+The real group ID is specified at login time.
+.PP
+The effective group ID is more transient, and determines
+additional access permission during execution of a
+``set-group-ID'' process, and it is for such processes
+that \fIgetgid\fP is most useful.
+.SH "SEE ALSO"
+getuid(2), setregid(2), setgid(3)