getgid(2) — Linux manual page

getgid(2)                  System Calls Manual                 getgid(2)

NAME

       getgid, getegid - get group identity

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <unistd.h>

       gid_t getgid(void);
       gid_t getegid(void);

DESCRIPTION

       getgid() returns the real group ID of the calling process.

       getegid() returns the effective group ID of the calling process.

ERRORS

       These functions are always successful and never modify errno.

VERSIONS

       On Alpha, instead of a pair of getgid() and getegid() system
       calls, a single getxgid() system call is provided, which returns
       a pair of real and effective GIDs.  The glibc getgid() and
       getegid() wrapper functions transparently deal with this.  See
       syscall(2) for details regarding register mapping.

STANDARDS

       POSIX.1-2008.

HISTORY

       POSIX.1-2001, 4.3BSD.

       The original Linux getgid() and getegid() system calls supported
       only 16-bit group IDs.  Subsequently, Linux 2.4 added getgid32()
       and getegid32(), supporting 32-bit IDs.  The glibc getgid() and
       getegid() wrapper functions transparently deal with the
       variations across kernel versions.

SEE ALSO

       getresgid(2), setgid(2), setregid(2), credentials(7)

COLOPHON

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.9.1.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2024-06-26.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

Linux man-pages 6.9.1          2024-05-02                      getgid(2)

Pages that refer to this page: groups(1@@shadow-utils), ps(1), strace(1), getgroups(2), setgid(2), setreuid(2), syscalls(2), group_member(3), id_t(3type), credentials(7), signal-safety(7), user_namespaces(7)