getnetconfig(3N)               DG/UX R4.11MU05              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).

       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)
       Network Programmer's Guide
       System Administrator's Guide


Licensed material--property of copyright holder(s)