Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SETGROUPS(2)		    BSD	System Calls Manual		  SETGROUPS(2)

NAME
     setgroups -- set group access list

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <sys/param.h>
     #include <unistd.h>

     int
     setgroups(int ngroups, const gid_t	*gidset);

DESCRIPTION
     Setgroups() sets the group	access list of the current user	process	ac-
     cording to	the array gidset.  The parameter ngroups indicates the number
     of	entries	in the array and must be no more than NGROUPS, as defined in
     <sys/param.h>.

     Only the super-user may set new groups.

RETURN VALUES
     The setgroups() function returns the value	0 if successful; otherwise the
     value -1 is returned and the global variable errno	is set to indicate the
     error.

ERRORS
     The setgroups() call will fail if:

     [EPERM]		The caller is not the super-user.

     [EFAULT]		The address specified for gidset is outside the
			process	address	space.

SEE ALSO
     getgroups(2), initgroups(3)

HISTORY
     The setgroups() function call appeared in 4.2BSD.

BSD				April 16, 1994				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=setgroups&sektion=2&manpath=FreeBSD+5.0-RELEASE>

home | help