setnetgrent_r Subroutine

Purpose

Handles the group network entries.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>
int setnetgrent_r(NetGroup,ptr)
char *NetGroup;
void **ptr;

Description

The setnetgrent_r subroutine functions the same as the setnetgrent subroutine.

The setnetgrent_r subroutine establishes the network group from which the getnetgrent_r subroutine will obtain members. This subroutine also restarts calls to the getnetgrent_r subroutine from the beginnning of the list. If the previous setnetgrent_r call was to a different network group, an endnetgrent_r call is implied. The endnetgrent_r subroutine frees the space allocated during the getnetgrent_r calls.

Parameters

Item Description
NetGroup Points to a network group.
ptr Keeps the function threadsafe.

Return Values

The setnetgrent_r subroutine returns a 0 if successful and a -1 if unsuccessful.

Files

Item Description
/etc/netgroup Contains network groups recognized by the system.
/usr/include/netdb.h Contains the network database structures.