INITGROUPS

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc
BSD 4.2  

NAME

initgroups - initialize group access list  

SYNOPSIS

Fd #include <unistd.h> Ft int Fn initgroups const char *name int basegid  

DESCRIPTION

The Fn initgroups function reads through the group file and sets up, using the setgroups(2) call, the group access list for the user specified in Fa name . The Fa basegid is automatically included in the groups list. Typically this value is given as the group number from the password file.  

RETURN VALUES

The Fn initgroups function returns -1 if it was not invoked by the super-user.  

FILES

/etc/group

 

SEE ALSO

setgroups(2)  

HISTORY

The function appeared in BSD 4.2  

BUGS

The Fn initgroups function uses the routines based on getgrent(3). If the invoking program uses any of these routines, the group structure will be overwritten in the call to Fn initgroups .


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
FILES
SEE ALSO
HISTORY
BUGS

This document was created by man2html, using the manual pages.
Time: 06:43:28 GMT, May 19, 2025