innetgr, getnetgrent, setnetgrent, or endnetgrent Subroutine

Purpose

Handles the group network entries.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>

void setnetgrent (NetGroup)
char *NetGroup

void endnetgrent ()

Description

The innetgr subroutine is threadsafe in AIX® 4.3 and later. However, the return value points to static data that is overwritten by subsequent calls. This data must be copied to be saved for use by subsequent calls.

The innetgr subroutine returns 1 or 0, depending on if netgroup contains the machine, user, domain triple as a member. Any of these three strings; machine, user, or domain, can be NULL, in which case it signifies a wild card.

The getnetgrent subroutine returns the next member of a network group. After the call, machinepointer will contain a pointer to a string containing the name of the machine part of the network group member, and similarly for userpointer and domainpointer. If any of machinepointer, userpointer, or domainpointer is returned as a NULL pointer, it signifies a wild card. The getnetgrent subroutine uses malloc to allocate space for the name. This space is released when the endnetgrent subroutine is called. getnetgrent returns 1 if it succeeded in obtaining another member of the network group or 0 when it has reached the end of the group.

The setnetgrent subroutine establishes the network group from which the getnetgrent subroutine will obtain members, and also restarts calls to the getnetgrent subroutine from the beginnning of the list. If the previous setnetgrent() call was to a different network group, an endnetgrent() call is implied. endnetgrent() frees the space allocated during the getnetgrent() calls.

Parameters

Return Values

Files