Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

getnetgrent(3) [osf1 man page]

getnetgrent(3)						     Library Functions Manual						    getnetgrent(3)

getnetgrent, setnetgrent, endnetgrent, innetgr - get network group entry 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 routine accesses the netgroup file and checks to see if the specified input parameters match an entry in the file. The routine returns 1 if it matches an entry, or 0 if it does not. Any of the three strings; machine, user, or domain can be NULL, which signifies any string in that position is valid. The getnetgrent routine 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 machinep, userp or domainp is returned as a NULL pointer, it signifies any string is valid. The getnetgrent routine allocates space for the name by using the malloc routine. This space is released when an endnetgrent call is made. The getnetgrent routine returns 1 if it succeeds in obtaining another member of the network group, or 0 if it reaches the end of the group. The setnetgrent routine 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. The endnetgrent routine releases the space allocated during the getnetgrent calls. Note that the netgroup file is distributed by NIS and exists in its original, readable form on the NIS master server only. NIS slave servers distribute copies of the netgroup maps created from the original on the master. FILES
/var/yp/src/netgroup /var/yp/domain/netgroup /var/yp/domain/netgroup.byuser /var/yp/domain/netgroup.byhost delim off getnetgrent(3)

Check Out this Related Man Page

GETNETGRENT(3)						   BSD Library Functions Manual 					    GETNETGRENT(3)

getnetgrent, innetgr, setnetgrent, endnetgrent -- netgroup database operations LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <netgroup.h> int getnetgrent(const char **host, const char **user, const char **domain); int innetgr(const char *netgroup, const char *host, const char *user, const char *domain); void setnetgrent(const char *netgroup); void endnetgrent(void); DESCRIPTION
These functions operate on the netgroup database file which is described in netgroup(5). The database defines a set of netgroups, each made up of one or more triples: (host, user, domain) that defines a combination of host, user and domain. Any of the three fields may be specified as ``wildcards'' that match any string. The function getnetgrent() sets the three pointer arguments to the strings of the next member of the current netgroup. If any of the string pointers are NULL that field is considered a wildcard. The functions setnetgrent() and endnetgrent() set the current netgroup and terminate the current netgroup respectively. If setnetgrent() is called with a different netgroup than the previous call, an implicit endnetgrent() is implied. setnetgrent() also sets the offset to the first member of the netgroup. The function innetgr() searches for a match of all fields within the specified group. If any of the host, user, or domain arguments are NULL those fields will match any string value in the netgroup member. RETURN VALUES
The function getnetgrent() returns 0 for ``no more netgroup members'' and 1 otherwise. The function innetgr() returns 1 for a successful match and 0 otherwise. The functions setnetgrent() and endnetgrent() have no return value. FILES
/etc/netgroup netgroup database file SEE ALSO
netgroup(5), nsswitch.conf(5) BUGS
The function getnetgrent() returns pointers to dynamically allocated data areas that are free'd when the function endnetgrent() is called. BSD
January 16, 1999 BSD
Man Page