Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page		 

getnetgrent(3)


NAME

  getnetgrent, setnetgrent, endnetgrent, innetgr - Get network group entry


SYNOPSIS

  #include <unistd.h>

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

  void setnetgrent(
	  char *netgroup );

  void endnetgrent(
	  void );

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


LIBRARY

  Standard C Library (libc.so, libc.a)


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

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page