netbsd man page for getgid

GETGID(2)						      BSD System Calls Manual							 GETGID(2)

NAME
     getgid, getegid -- get group process identification

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <unistd.h>

     gid_t
     getgid(void);

     gid_t
     getegid(void);

DESCRIPTION
     The getgid() function returns the real group ID of the calling process, getegid() returns the effective group ID of the calling process.

     The real group ID is specified at login time.

     The real group ID is the group of the user who invoked the program.  As the effective group ID gives the process additional permissions dur-
     ing the execution of ``set-group-ID'' mode processes, getgid() is used to determine the real-group-id of the calling process.

ERRORS
     The getgid() and getegid() functions are always successful, and no return value is reserved to indicate an error.

SEE ALSO
     getuid(2), setgid(2), setgroups(2), setregid(2)

STANDARDS
     getgid() and getegid() conform to ISO/IEC 9945-1:1990 (``POSIX.1'').

HISTORY
     The getgid() function appeared in Version 4 AT&T UNIX.

BSD
								   April 3, 2010							       BSD