src/lib/libc/gen/initgroups.3, branch releng/8.0 FreeBSD source tree In preparation for raising NGROUPS and NGROUPS_MAX, change base 2009-06-19T15:58:24+00:00 Brooks Davis brooks@FreeBSD.org 2009-06-19T15:58:24+00:00 54404cfb13d40e474f72d3c75de1f4db3417df64 system callers of getgroups(), getgrouplist(), and setgroups() to allocate buffers dynamically. Specifically, allocate a buffer of size sysconf(_SC_NGROUPS_MAX)+1 (+2 in a few cases to allow for overflow). This (or similar gymnastics) is required for the code to actually follow the POSIX.1-2008 specification where {NGROUPS_MAX} may differ at runtime and where getgroups may return {NGROUPS_MAX}+1 results on systems like FreeBSD which include the primary group. In id(1), don't pointlessly add the primary group to the list of all groups, it is always the first result from getgroups(). In principle the old code was more portable, but this was only done in one of the two places where getgroups() was called to the overall effect was pointless. Document the actual POSIX requirements in the getgroups(2) and setgroups(2) manpages. We do not yet support a dynamic NGROUPS, but we may in the future. MFC after: 2 weeks 
system callers of getgroups(), getgrouplist(), and setgroups() to
allocate buffers dynamically.  Specifically, allocate a buffer of size
sysconf(_SC_NGROUPS_MAX)+1 (+2 in a few cases to allow for overflow).

This (or similar gymnastics) is required for the code to actually follow
the POSIX.1-2008 specification where {NGROUPS_MAX} may differ at runtime
and where getgroups may return {NGROUPS_MAX}+1 results on systems like
FreeBSD which include the primary group.

In id(1), don't pointlessly add the primary group to the list of all
groups, it is always the first result from getgroups().  In principle
the old code was more portable, but this was only done in one of the two
places where getgroups() was called to the overall effect was pointless.

Document the actual POSIX requirements in the getgroups(2) and
setgroups(2) manpages.  We do not yet support a dynamic NGROUPS, but we
may in the future.

MFC after:	2 weeks
Per Regents of the University of Calfornia letter, remove advertising 2007-01-09T00:28:16+00:00 Warner Losh imp@FreeBSD.org 2007-01-09T00:28:16+00:00 c879ae3536e6d92b8d96c8965c5b05fcb9541520 clause. # If I've done so improperly on a file, please let me know. 
clause.

# If I've done so improperly on a file, please let me know.
Use the proper type (gid_t) for (group)->gr_gid to be orthogonal 2002-01-22T17:32:53+00:00 Mark Murray markm@FreeBSD.org 2002-01-22T17:32:53+00:00 5567b258ebfb1a00cb9d07371894eae183e09a25 with uid_t usage and (user)->pw_uid. PR: 3242 
with uid_t usage and (user)->pw_uid.

PR:		3242
Do not write warning messages on stderr - a caller is expected to check 2001-11-28T10:55:02+00:00 Anton Berezin tobez@FreeBSD.org 2001-11-28T10:55:02+00:00 7d3346ca1f857d6078f948e03b83abae618820da the return code and errno instead. Those warnings did not do any good for daemonized users of initgroups(3), and confused cvs clients that communicated with non-root cvs pserver. The committed fix differs from the one suggested in the PR, and was submitted by ru. PR: 15421 Approved by: markm Discussed on: -stable, -current at various times 
the return code and errno instead.  Those warnings did not do any good
for daemonized users of initgroups(3), and confused cvs clients that
communicated with non-root cvs pserver.

The committed fix differs from the one suggested in the PR, and was
submitted by ru.

PR:		15421
Approved by:	markm
Discussed on:	-stable, -current at various times
mdoc(7) police: Use the new .In macro for #include statements. 2001-10-01T16:09:29+00:00 Ruslan Ermilov ru@FreeBSD.org 2001-10-01T16:09:29+00:00 32eef9aeb1f39a1623cea55da147c89abbd5b9a5 






mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10T13:41:46+00:00

Ruslan Ermilov
ru@FreeBSD.org

2001-07-10T13:41:46+00:00

a307d598387eeb7d775332066d996ab0dadf7e5f












Whitespace only change: trim trailing whitespace.
2000-10-30T13:23:19+00:00

Jeroen Ruigrok van der Werven
asmodai@FreeBSD.org

2000-10-30T13:23:19+00:00

5714e85318e33999ad2f1ff2a25c260b5796a3f9












Introduce ".Lb" macro to libc manpages.
2000-04-21T09:42:15+00:00

Alexey Zelkin
phantom@FreeBSD.org

2000-04-21T09:42:15+00:00

25bb73e063c17cd9048cf60100dbc0ac5177e94a

More libraries manpages updates following.





More libraries manpages updates following.







$Id$ -> $FreeBSD$
1999-08-28T00:22:10+00:00

Peter Wemm
peter@FreeBSD.org

1999-08-28T00:22:10+00:00

7f3dea244c40159a41ab22da77a434d7c5b5e85a












Add $Id$, to make it simpler for members of the translation teams to
1999-07-12T20:50:10+00:00

Nik Clayton
nik@FreeBSD.org

1999-07-12T20:50:10+00:00

fbc400a67a4e6979c5d99fe59d904cf08992a98f

track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

     .\"    $Id$
     .\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by:            bde





track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

     .\"    $Id$
     .\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by:            bde