GETNETGRENT(3Y)                                                GETNETGRENT(3Y)


NAME
     getnetgrent, innetgr, setnetgrent, endnetgrent - get NIS network group
     entry

SYNOPSIS
     #include <netdb.h>

     int innetgr(char *netgroup, char *machine, char *user, char *domain);

     int getnetgrent(char **machinep, char **userp, char **domainp);

     void setnetgrent(char *netgroup);

     void endnetgrent(void);

DESCRIPTION
     Innetgr returns 1 or 0, depending on whether netgroup contains the
     machine, user, or domain triple as a member.  Any of the three strings
     machine, user, or domain can be NULL, in which case it signifies a wild
     card.

     Getnetgrent returns the next member of a network group.  After the call,
     machinep will contain a pointer to a string containing the name of the
     machine part of the network group member, and similarly for userp and
     domainp.  If any of machinep, userp or domainp is returned as a NULL
     pointer, it signifies a wild card. Getnetgrent will malloc(3) space for
     the name.  This space is released when a endnetgrent call is made.
     Getnetgrent returns 1 if it succeeding in obtaining another member of the
     network group, 0 if it has reached the end of the group.

     Setnetgrent establishes the network group from which getnetgrent will
     obtain members, and also restarts calls to getnetgrent from the beginning
     of the list.  If the previous setnetgrent call was to a different network
     group and there has been no intervening call to endnetgrent, an
     endnetgrent call is implied.  Endnetgrent frees the space allocated
     during the getnetgrent calls.

NOTE
     The Mips ABI specifies nothing but local files so applications which wish
     to use anything else must compile with libc prior to libnsl in the
     library list.

FILES
     /etc/netgroup  database used to create NIS netgroup maps. This file
               is ignored if NIS is not running.


                                                                        Page 1