GETNETGRENT(3Y)						       GETNETGRENT(3Y)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111