getnetconfig(3N)

NAME
     getnetconfig - get network configuration database entry

SYNOPSIS
     #include <netconfig.h>
     void *setnetconfig(void);
     struct netconfig *getnetconfig(void *handlep);
     int endnetconfig(void *handlep);
     struct netconfig *getnetconfigent(char *netid);
     void freenetconfigent(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 netconfig structure.  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 (for
     example, if setnetconfig was not called previously).

     getnetconfigent returns a pointer to the netconfig structure
     corresponding to netid.  It returns NULL if netid is invalid (that is,
     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 frees the netconfig structure pointed to by netconfigp,
     previously returned by getnetconfigent.
SEE ALSO
     netconfig(4), getnetpath(3N), environ(5)