getgroups(2): Remove mention of <sys/param.h> and refer to sysconf(3).

Because {NGROUPS_MAX} may become variable, its value should be obtained
using sysconf(3). If a #define is used anyway, it should be obtained by
including <limits.h> as that is in POSIX like getgroups(2) itself is.
<sys/param.h> is not in POSIX.

MFC after:	1 week
This commit is contained in:
Jilles Tjoelker 2011-01-21 22:15:17 +00:00
parent cd2895aab0
commit 198c89c306
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=217704

View File

@ -28,7 +28,7 @@
.\" @(#)getgroups.2 8.2 (Berkeley) 4/16/94
.\" $FreeBSD$
.\"
.Dd March 5, 1999
.Dd January 21, 2011
.Dt GETGROUPS 2
.Os
.Sh NAME
@ -37,7 +37,6 @@
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In sys/param.h
.In unistd.h
.Ft int
.Fn getgroups "int gidsetlen" "gid_t *gidset"
@ -66,6 +65,12 @@ is zero,
returns the number of supplementary group IDs associated with
the calling process without modifying the array pointed to by
.Fa gidset .
.Pp
The value of
.Dv {NGROUPS_MAX}
should be obtained using
.Xr sysconf 3
to avoid hard-coding it into the executable.
.Sh RETURN VALUES
A successful call returns the number of groups in the group set.
A value of -1 indicates that an error occurred, and the error
@ -88,7 +93,8 @@ an invalid address.
.El
.Sh SEE ALSO
.Xr setgroups 2 ,
.Xr initgroups 3
.Xr initgroups 3 ,
.Xr sysconf 3
.Sh STANDARDS
The
.Fn getgroups