Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

setgroups(2)							  setgroups(2)

NAME
       setgroups - set group access list

SYNOPSIS
DESCRIPTION
       sets the group access list of the current user process according to the
       array gidset.  The parameter ngroups indicates the number of entries in
       the array and must be no more than

       Only  a	user  with  the	 privilege can set new groups by adding to the
       group access list of the current user  process;	any  user  can	delete
       groups from it.

   Security Restrictions
       Some or all of the actions associated with this system call require the
       privilege.  Processes owned by the superuser have this privilege.  Pro‐
       cesses  owned by other users may have this privilege, depending on sys‐
       tem configuration.  See privileges(5) for more information about privi‐
       leged access on systems that support fine-grained privileges.

RETURN VALUE
       Upon successful completion, returns 0; otherwise it returns −1 and sets
       to indicate the error.

ERRORS
       fails if any of the following conditions are encountered:

	      The caller     is	 not  a	 user  with  the  privilege  and   has
			     attempted to set new groups.

	      The address specified for
			     gidset is outside the process address space.  The
			     reliable detection of this error  is  implementa‐
			     tion dependent.

	      ngroups	     is greater than or not positive.

	      An entry in    gidset is not a valid group ID.

AUTHOR
       was developed by the University of California, Berkeley.

SEE ALSO
       getgroups(2), initgroups(3C), privileges(5).

STANDARDS CONFORMANCE
								  setgroups(2)

Vote for polarhome