GETNETCONFIG(3N-SVR4)RISC/os Reference ManualETNETCONFIG(3N-SVR4)



NAME
     getnetconfig, endnetconfig, freenetconfigent, setnetconfig -
          network configuration database components

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 data-
     base, /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



                        Printed 11/19/92                   Page 1

GETNETCONFIG(3N-SVR4)RISC/os Reference ManualETNETCONFIG(3N-SVR4)



     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 previ-
     ously).

     freenetconfigent(netconfigp) frees the netconfig structure
     pointed to by netconfigp (previously returned by getnetcon-
     figent()).

SEE ALSO
     netconfig(4), getnetpath(3N), environ(5).
     Network Programmer's Guide.
     System Administrator's Guide.






































 Page 2                 Printed 11/19/92