initgroups man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

initgroups(3C)		 Standard C Library Functions		initgroups(3C)

NAME
       initgroups - initialize the supplementary group access list

SYNOPSIS
       #include <grp.h>
       #include <sys/types.h>

       int initgroups(const char *name, gid_t basegid);

DESCRIPTION
       The  initgroups()  function  reads  the group database to get the group
       membership for the user specified by name, and initializes the  supple‐
       mentary	group access list of the calling process (see getgrnam(3C) and
       getgroups(2)). The basegid group ID is also included in the  supplemen‐
       tary  group  access  list. This is typically the real group ID from the
       user database.

       While scanning the group database, if the number of  groups,  including
       the  basegid  entry,  exceeds NGROUPS_MAX, subsequent group entries are
       ignored.

RETURN VALUES
       Upon successful completion, 0 is returned. Otherwise,  −1  is  returned
       and errno is set to indicate the error.

ERRORS
       The  initgroups()  function  will fail and not change the supplementary
       group access list if:

       EPERM	The {PRIV_PROC_SETID} privilege is not asserted in the	effec‐
		tive set of the calling process.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       getgroups(2), getgrnam(3C), attributes(5)

SunOS 5.11			  22 Mar 2004			initgroups(3C)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net