|
|
1.1 root 1: .TH GETGROUPS 2 "7 July 1983"
2: .UC 4
3: .SH NAME
4: getgroups \- get group access list
5: .SH SYNOPSIS
6: .nf
7: .ft B
8: #include <sys/param.h>
9: .PP
10: .ft B
11: ngrps = getgroups(gsize, gidset)
12: int ngrps, gsize, *gidset;
13: .fi
14: .SH DESCRIPTION
15: .I Getgroups
16: gets the current group access list of the user process
17: and stores it in the array
18: .IR gidset .
19: The parameter
20: .I gsize
21: indicates the number of entries which may be placed in
22: .I gidset .
23: The return value is the number of entries in
24: .I gidset
25: that were filled.
26: No more than NGROUPS, as defined in
27: .RI < sys/param.h >,
28: will ever
29: be returned.
30: .SH "RETURN VALUE
31: A value of \-1 indicates that an error occurred, and the error
32: code is stored in the global variable \fIerrno\fP\|.
33: .SH "ERRORS
34: The possible errors for \fIgetgroups\fP are:
35: .TP 15
36: [EFAULT]
37: The argument \fIgidset\fP is an invalid addresses.
38: .TP 15
39: [EINVAL]
40: The size of \fIgidset\fP as specified by \fIgsize\fP is too small to
41: accomodate the entire group access list.
42: .SH "SEE ALSO
43: setgroups(2), initgroups(3)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.