setgrent()

Rewind to the start of the group database file

Synopsis:

#include <grp.h>

int setgrent( void );

Library:

libc

Description:

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 a valid error for the fopen() call.

Classification:

Standard Unix

See also:

endgrent(), getgrent()