getnetconfig(3N)    (Networking Services Architecture)     getnetconfig(3N)


   NAME
         getnetconfig - get network configuration database entry

   SYNOPSIS
         #include <netconfig.h>
         void *
         setnetconfig()
         struct netconfig *
         getnetconfig(handlep)
         void * handlep
         int
         endnetconfig(handlep)
         void * handlep
         struct netconfig *
         getnetconfigent(netid)
                 char * netid ;
         int
         freenetconfigent(netconfigp)
               struct netconfig * netconfigp ;

   DESCRIPTION
         The five library routines described on this page are part of the UNIX
         System V Network Selection component.  They provide application
         access to the system network configuration database, /etc/netconfig.
         In addition to the netconfig database and the routines for accessing
         it, Network Selection includes the environment variable NETPATH (see
         environ(5)) and the NETPATH access routines described in
         getnetpath(3N).

         A call to setnetconfig() has the effect of ``binding'' or
         ``rewinding'' the netconfig database.  setnetconfig() must be called
         before the first call to getnetconfig() and may be called at any
         other time.  setnetconfig() need not be called before a call to
         getnetconfigent().  setnetconfig() returns a unique handle to be used
         by getnetconfig().

         When first called, getnetconfig() returns a pointer to the current
         entry in the netconfig database, formatted as a struct netconfig.
         getnetconfig() can thus be used to search the entire netconfig file.
         getnetconfig() returns NULL at end of file.

         endnetconfig() should be called when processing is complete to
         release resources for reuse.  Programmers should be aware, however,
         that the last call to endnetconfig() frees all memory allocated by
         getnetconfig() for the struct netconfig data structure.
         endnetconfig() may not be called before setnetconfig().
         endnetconfig() returns 0 on success and -1 on failure (e.g., if
         setnetconfig() was not called previously).





   8/91                                                                 Page 1

   getnetconfig(3N)    (Networking Services Architecture)     getnetconfig(3N)


         getnetconfigent(netid) returns a pointer to the struct netconfig
         structure corresponding to netid.  It returns NULL if netid is
         invalid (i.e., does not name an entry in the netconfig database).  It
         returns NULL and sets errno in case of failure (e.g., if
         setnetconfig() was not called previously).

         freenetconfigent(netconfigp) frees the netconfig structure pointed to
         by netconfigp (previously returned by getnetconfigent()).

   SEE ALSO
         netconfig(4), getnetpath(3N), environ(5)
         Programmer's Guide: Networking Interfaces
         System Administrator's Guide








































   Page 2                                                                 8/91