*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> setgroups (2)              



NAME    [Toc]    [Back]

     setgroups - set group access list

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <unistd.h>

     setgroups(int ngroups, const gid_t *gidset);

DESCRIPTION    [Toc]    [Back]

     setgroups() 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 the superuser may set new groups.

RETURN VALUES    [Toc]    [Back]

     A 0 value is returned on success, -1 on error, with an error
code stored
     in errno.

ERRORS    [Toc]    [Back]

     The setgroups() call will fail if:

     [EINVAL]       The  value  of  ngroups   is   greater   than

     [EPERM]       The caller is not the superuser.

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

SEE ALSO    [Toc]    [Back]

     getgroups(2), setgid(2), setregid(2), initgroups(3)

HISTORY    [Toc]    [Back]

     The setgroups() function call appeared in 4.2BSD.

OpenBSD     3.6                          April      16,      1994
[ Back ]
 Similar pages
Name OS Title
getgroups HP-UX get group access list
getgroups NetBSD get group access list
getgroups OpenBSD get group access list
setgroups Tru64 Set the group access list
getgroups FreeBSD get group access list
initgroups IRIX initialize group access list
getgroups IRIX get supplementary group access list IDs
initgroups FreeBSD initialize group access list
getgrouplist NetBSD calculate group access list
getgrouplist OpenBSD calculate group access list
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service