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

  man pages->Tru64 Unix man pages -> initgroups (3)              



NAME    [Toc]    [Back]

       initgroups - Initialize concurrent group set

SYNOPSIS    [Toc]    [Back]

       int initgroups(
               char *user,
               gid_t base_gid );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies the user whose groups are to be used to initialize
 the group  set.   Specifies  an  additional  group  to
       include in the group set.

DESCRIPTION    [Toc]    [Back]

       The  initgroups() function reads the defined group membership
 of the specified user and sets the  concurrent  group
       set  of  the  current  process to that value. The base_gid
       parameter is always included in the concurrent group  set,
       and is normally the principal user's group. If the user is
       in more than NGROUPS_MAX groups, only  NGROUPS_MAX  groups
       are set, including the base_gid group.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion,  the  initgroups()  function
       returns 0 (zero). If the initgroups() function fails, 1 is
       returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If  the  initgroups()  function fails, errno may be set to
       the following value: The calling process does not have the
       appropriate  privilege  in its current effective privilege

CAUTION    [Toc]    [Back]

       The initgroups() function uses the sia_get_groups()  function
  to  set  up  the  group  array.  If the program that
       invokes initgroups() uses any  of  these  functions,  then
       calling  initgroups()  overwrites  the static group structure.

SEE ALSO    [Toc]    [Back]

       Functions:    getgroups(2),    setgroups(2),     getgid(2)

       Commands: groups(1)

[ Back ]
 Similar pages
Name OS Title
initgroups OpenBSD initialize supplementary group IDs
initgroups NetBSD initialize supplementary group IDs
initgroups FreeBSD initialize group access list
initgroups IRIX initialize group access list
initgroups Linux initialize the supplementary group access list
cvs OpenBSD Concurrent Versions System
cvs FreeBSD Concurrent Versions System
cvsconfig Linux The GNU Concurrent Versions System
cvs Linux Concurrent Versions System
cvs-pserver Linux The GNU Concurrent Versions System
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service