Return to setgroups.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/setgroups.2, revision 1.1.1.2

1.1       root        1: .TH SETGROUPS 2 "7 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: setgroups \- set group access list
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: #include <sys/param.h>
                      9: .PP
                     10: .ft B
                     11: setgroups(ngroups, gidset)
                     12: int ngroups, *gidset;
                     13: .fi
                     14: .SH DESCRIPTION
                     15: .I Setgroups
                     16: sets the group access list of the current user process
                     17: according to the array 
                     18: .IR gidset .
                     19: The parameter
                     20: .I ngroups
                     21: indicates the number of entries in the array and must be no
                     22: more than NGRPS, as defined in
                     23: .RI < sys/param.h >.
                     24: .PP
                     25: Only the super-user may set new groups.
                     26: .SH "RETURN VALUE
                     27: A 0 value is returned on success, \-1 on error, with
                     28: a error code stored in \fIerrno\fP.
                     29: .SH "ERRORS
1.1.1.2 ! root       30: The \fIsetgroups\fP call fails if:
1.1       root       31: .TP 15
                     32: [EPERM]
                     33: The caller is not the super-user.
                     34: .TP 15
                     35: [EFAULT]
                     36: The address specified for \fIgidset\fP is outside the process
                     37: address space.
                     38: .SH "SEE ALSO
                     39: getgroups(2), initgroups(3X)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.