getgroups Linux system call

Read the caller’s supplementary group IDs.

In Linux 7.3, getgroups is defined in the system call table of 12 of the 12 bundled ABIs.

Number on each ABI Linux 7.3

getgroups in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641150x73sys_getgroupssyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:127Open
i386800x50sys_getgroups16int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:95Open
AArch641580x9esys_getgroupssvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:195Open
ARM EABI800x50sys_getgroups16svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:96Open
RISC-V 641580x9esys_getgroupsecalla7a0, a1, a2, a3, a4, a5syscall.tbl:195Open
LoongArch 641580x9esys_getgroupssyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:195Open
PowerPC 64800x50sys_getgroupsscr0r3, r4, r5, r6, r7, r8syscall.tbl:111Open
PowerPC 32800x50sys_getgroupsscr0r3, r4, r5, r6, r7, r8syscall.tbl:111Open
IBM Z (s390x)2050xcdsys_getgroupssvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:164Open
MIPS o3240800xff0sys_getgroupssyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:92Open
MIPS n3261130x17e1sys_getgroupssyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:123Open
MIPS n6451130x13f9sys_getgroupssyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:123Open

Argument locations are the ABI’s calling convention for ARG1–ARG6 in order, not an assignment made for this call. On 32-bit ABIs, 64-bit values may occupy multiple registers and require alignment; assembly wrappers may reorder them. See syscall(2). A table entry does not mean the call exists in every kernel: most optional calls return ENOSYS when the matching configuration option or architecture support is not built.

Kernel declaration

asmlinkage long sys_getgroups(int gidsetsize, gid_t __user *grouplist);

x86-64, AArch64, RISC-V 64, LoongArch 64, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n32, MIPS n64 · Declaration: include/linux/syscalls.h:712

asmlinkage long sys_getgroups16(int gidsetsize, old_gid_t __user *grouplist);

i386, ARM EABI · Declaration: include/linux/syscalls.h:1180

Signatures are kernel declarations and may differ from the C library wrappers.

Manual page

getgroups(2)

Bundled kernel releases

Bundled releases whose tables define getgroups
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912all 12
Linux 4.155all 5
Linux 3.74all 4
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163all 3
Linux 2.6.122all 2
Linux 1.01all 1

Each release is a separate snapshot, and older releases bundle fewer ABIs. This table does not claim the release in which the call first appeared. Numbers are listed where a release differs from Linux 7.3.