setgrent()

Rewind to the start of the group database file

Synopsis:

#include <grp.h>

int setgrent( void );

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The setgrent() function rewinds to the start of the group name database file. It's provided for programs that make multiple lookups in the group database (using the getgrgid() and getgrnam() calls) to avoid the default opening and closing of the group database for each access.

Returns:

0: Success.
-1: An error occurred.

Errors:

The setgrent() function uses fopen(). As a result, errno can be set to an error for the fopen() call.

Classification:

POSIX 1003.1 XSI

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	No
Thread	No