Bug#295680: libc6: getgrname returns a result that doesn't belong to /etc/group

[Lars Wirzenius <liw@iki.fi>]

> The getgrname(3) man page says:
> 
>   The getgrnam() function returns a pointer to a structure containing the
>   group information from /etc/group for the entry that matches the  group
>   name name.

The glibc info document says this:

 -- Function: struct group * getgrnam (const char *NAME)
     This function returns a pointer to a statically-allocated structure
     containing information about the group whose group name is NAME.
     This structure may be overwritten by subsequent calls to
     `getgrnam'.

This is the official documentation for glibc; the manual pages are third-party
stuff and not authoritative. The Single Unix Specification, version 2, from 1997, 
agrees (http://www.opengroup.org/onlinepubs/007908799/xsh/getgrnam.html):

   The getgrnam() function searches the group database for an entry with a matching name

The "group database" here does not mean /etc/group only, but includes things
like NIS.

Thus, I think the Linux manual page saying that getgrnam uses /etc/group only
is a bug.