NAME    [Toc]    [Back]

       getnetent, getnetent_r - Get a network entry

SYNOPSIS    [Toc]    [Back]

       #include <netdb.h>

       struct netent *getnetent(
               void );

       [Tru64 UNIX]  The following obsolete function is supported
       in order to maintain backward compatibility with  previous
       versions  of  the operating system.  You should not use it
       in new designs.  int getnetent_r(
               struct netent *net,
               struct netent_data *net_data );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       getnetent():  XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       [Tru64 UNIX]  Points to the netent structure.  The netdb.h
       header   file   defines   the  netent  structure.   [Tru64
       UNIX]  Is data for the  networks  database.   The  netdb.h
       header file defines the netent_data structure.

DESCRIPTION    [Toc]    [Back]

       The  getnetent() function retrieves network information by
       opening  and  sequentially  reading   either   the   local
       /etc/networks  file  or  the NIS distributed networks file
       for the requested information. To determine which file  or
       files  to  search, and in which order, the system uses the
       switches in the /etc/svc.conf file.

       The getnetent() function returns a  pointer  to  a  netent
       structure, which contains the equivalent fields for a network
 description line in the networks  file.   The  netent
       structure is defined in the netdb.h header file.

       Use  the  endnetent()  function to close the /etc/networks
       file.

       The getnetent() return value points to static data,  which
       is  overwritten by any subsequently called functions using
       the same structure.

NOTES    [Toc]    [Back]

       The getnetent() function returns a pointer to  thread-specific
  data.  Subsequent  calls  to this function from the
       same thread overwrite this data.

       [Tru64 UNIX]  The getnetent_r() function  is  an  obsolete
       reentrant  version  of  the  getnetent() function.   It is
       supported in order to maintain backward compatibility with
       previous  versions  of the operating system and should not
       be used in new designs.  Note that you must set the net_fp
       field  of  the  netent_data  structure  to NULL before its
       first access by either the setnetent_r() or  getnetent_r()
       function.

RETURN VALUES    [Toc]    [Back]

       Upon   successful  completion,  the  getnetent()  function
       returns a pointer to a netent structure.  If it  fails  or
       reaches the end of the /etc/networks name file, it returns
       a null pointer.

       [Tru64  UNIX]  Upon  successful  completion,  the   getnetent_r()
 function stores the netent structure in the location
 pointed to by net, and returns a value of  0  (zero).
       Upon failure, it returns a value of -1.

ERRORS    [Toc]    [Back]

       Current  industry standards do not define error values for
       the getnetent() function.

       [Tru64 UNIX]  If any of the following  conditions  occurs,
       the getnetent_r() function sets errno to the corresponding
       value:

       The netent or net_data parameter is invalid.   The  search
       failed (EOF).

FILES    [Toc]    [Back]

       This file is the Internet network name database file. Each
       record in the file occupies a single line  and  has  three
       fields: the official network name, the network number, and
       alias.  The database service selection configuration file.

SEE ALSO    [Toc]    [Back]

       Functions: getnetbyaddr(3), getnetbyname(3), setnetent(3),
       endnetent(3).

       Files: networks(4), svc.conf(4).

       Networks: nis_intro(7).

       Standards: standards(5).

       Network Programmer's Guide



                                                     getnetent(3)