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