Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (a - e) endgrent(3)
NAME
endgrent - Closes the group database
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL
G-series native OSS processes: /G/system/sysnn/zsecsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL
H-series OSS processes: /G/system/zdllnnn/zsecdll
SYNOPSIS
#include <grp.h>
void endgrent(void);
DESCRIPTION
The getgrent( ), getgrgid(), getgrnam( ), setgrent(), and endgrent() functions are used to
access group attributes.
The getgrent( ) function returns information about the next group in the database.
The getgrgid() function returns information about the group in the database whose group ID
matches the value specified in the gid parameter.
The getgrnam() function returns information about the group in the database whose group name
matches the name specified in the name parameter.
The setgrent() function resets the group name key so that the next call to getgrent() returns
information for the first group entry in the database.
The endgrent() function resets the group name key so that the next call to getgrent() returns
information for the first group entry in the database.
The endgrent() function can be called only by native processes.
Database Structure
Traditional UNIX implementations access user and group information by sequentially reading
unstructured files. In contrast, an HP NonStop server stores user and group information in struc-
tured, key-sequenced, Enscribe files.
RETURN VALUES
The endgrent() function returns no value.
ERRORS
The endgrent() function does not set errno.
RELATED INFORMATION
Functions: getgrent(3), getgrgid(3), getgrnam(3), getpwent(3), setgrent(3).
STANDARDS CONFORMANCE
The HP implementation of this function does not return errno values.
527192-005 Hewlett-Packard Company 1−69