Return to getgroups.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/getgroups.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)getgroups.2 6.4 (Berkeley) 4/10/87
                      6: .\"
                      7: .TH GETGROUPS 2 "April 10, 1987"
                      8: .UC 5
                      9: .SH NAME
                     10: getgroups \- get group access list
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: #include <sys/param.h>
                     15: .PP
                     16: .ft B
                     17: ngroups = getgroups(gidsetlen, gidset)
                     18: int ngroups, gidsetlen, *gidset;
                     19: .fi
                     20: .SH DESCRIPTION
                     21: .I Getgroups
                     22: gets the current group access list of the user process
                     23: and stores it in the array 
                     24: .IR gidset .
                     25: The parameter
                     26: .I gidsetlen
                     27: indicates the number of entries that may be placed in 
                     28: .IR gidset.
                     29: .I Getgroups
                     30: returns the actual number of groups returned in
                     31: .IR gidset .
                     32: No more than NGROUPS, as defined in
                     33: .RI < sys/param.h >,
                     34: will ever
                     35: be returned.
                     36: .SH "RETURN VALUE
                     37: A successful call returns the number of groups in the group set.
                     38: A value of \-1 indicates that an error occurred, and the error
                     39: code is stored in the global variable \fIerrno\fP\|.
                     40: .SH "ERRORS
                     41: The possible errors for \fIgetgroup\fP are:
                     42: .TP 15
                     43: [EINVAL]
                     44: The argument
                     45: .I gidsetlen
                     46: is smaller than the number of groups in the group set.
                     47: .TP
                     48: [EFAULT]
                     49: The argument \fIgidset\fP specifies
                     50: an invalid address.
                     51: .SH "SEE ALSO
                     52: setgroups(2), initgroups(3)
                     53: .SH BUGS
                     54: The
                     55: .I gidset
                     56: array should be of type
                     57: .BR gid_t ,
                     58: but remains integer for compatibility with earlier systems.

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