GETNETGRENT(3N)         COMMAND REFERENCE         GETNETGRENT(3N)



NAME
     getnetgrent, setnetgrent, endnetgrent, innetgr - A Yellow
     Page utility that gets network group entries

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

     setnetgrent(netgroup)
     char *netgroup;

     endnetgrent()

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

DESCRIPTION
     The innetgr utility returns 1 or 0, depending on whether
     netgroup contains the machine, user, domain triple as a
     member.  Any of the three strings: machine, user, or domain
     can be NULL, signifying a wildcard.

     The getnetgrent utility 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, acting similarly for userp and
     domainp.  If any of machinep , userp or domainp is returned
     as a NULL pointer, it signifies a wildcard. The getnetgrent
     utility  will malloc space for the name; this space is
     released when an endnetgrent call is made.  Utility
     getnetgrent returns a 1 if it succeeds in obtaining another
     member of the network group, or it returns 0 if it has
     reached the end of the group.

     The utility 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,
     an endnetgrent call is implied; endnetgrent frees the space
     allocated during the getnetgrent calls.

     Note that for getnetgrent, setnetgrent, endnetgrent, and
     innetgr to run successfully, domainname(1) must be defined,
     portmap(8c) must be running, and the Yellow Pages must be
     running and must have executed a ypbind(8).

FILES
     /etc/netgroup
     /etc/yp/domain/netgroup
     /etc/yp/domain/netgroup.byuser
     /etc/yp/domain/netgroup.byhost




Printed 3/13/89                                                 1

GETNETGRENT(3N)         COMMAND REFERENCE         GETNETGRENT(3N)



CAVEATS
     When the netgroup is invalid getnetgrent does not change the
     argument to a null pointer; instead, getnetgrent returns 0
     indicating end-of-group; setnetgrent does not give a return
     value or reset the netgroup pointer to null (no message is
     given for failure) and will only work properly if
     domainname(1) is defined, if portmap(8c) is running, and if
     the Yellow Pages are running and have executed a ypbind(8).

SEE ALSO
     domainname(1), ypbind(8), ypset(8).












































Printed 3/13/89                                                 2

%%index%%
na:432,159;
sy:591,2238;
de:2829,3527;
fi:6356,337;
ca:7197,939;
se:8136,209;
%%index%%000000000111