unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETNETGRENT(3N)                                                GETNETGRENT(3N)



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

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

       setnetgrent(netgroup)
       char *netgroup

       endnetgrent()

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

DESCRIPTION
       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 use  mal-
       loc(3V)  to allocate space for the name.  This space is released when a
       endnetgrent() call is made.  getnetgrent() returns 1 if it succeeded in
       obtaining  another member of the network group, 0 if it has reached the
       end of the group.

       getnetgrent() 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,  a  endnetgrent()  call is implied.  endnet-
       grent() frees the  space  allocated  during  the  getnetgrent()  calls.
       innetgr  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, in which case it signifies a wild
       card.

FILES
       /etc/netgroup

WARNINGS
       The Network Information Service (NIS) must be running when  using  get-
       netgrent(),  since  it  only  inspects  the NIS netgroup map, never the
       local files.

NOTES
       The Network Information Service (NIS) was formerly known as Sun  Yellow
       Pages  (YP).   The  functionality of the two remains the same; only the
       name has changed.



                               14 December 1987                GETNETGRENT(3N)