GETNETENT(T)        Linux Programmer's Manual        GETNETENT(T)



NAME
       getnetent,  getnetbyname,  getnetbyaddr, setnetent, endne-
       tent - get network entry

SYNOPSIS
       #include <netdb.h>

       struct netent *getnetent(t);

       struct netent *getnetbyname(const char *name);

       struct netent *getnetbyaddr(long net, int type);

       void setnetent(int stayopen);

       void endnetent(t);

DESCRIPTION
       The getnetent() function reads the next line from the file
       /etc/networks  and  returns  a structure netent containing
       the broken out fields from the  line.   The  /etc/networks
       file is opened if necessary.

       The getnetbyname() function returns a netent structure for
       the line from /etc/networks that matches the network name.

       The getnetbyaddr() function returns a netent structure for
       the line that matches the network number net of type type.

       The  setnetent()  function opens and rewinds the /etc/net-
       works file.  If stayopen is true (1), then the  file  will
       not  be closed between calls to getnetbyname() and getnet-
       byaddr().

       The endservent() function closes /etc/networks.

       The netent structure is defined in <netdb.h> as follows:

              struct netent {
                      char    *n_name;          /* official network name */
                      char    **n_aliases;      /* alias list */
                      int     n_addrtype;       /* net address type */
                      unsigned long int n_net;  /* network number */
              }

       The members of the netent structure are:

       n_name The official name of the network.

       n_aliases
              A zero terminated list of alternative names for the
              network.

       n_addrtype
              The type of the network number; always AF_INET.

       n_net  The network number in host byte order.

RETURN VALUE
       The  getnetent(),  getnetbyname() and getnetbyaddr() func-
       tions return the netent structure, or a NULL pointer if an
       error occurs or the end of the file is reached.

FILES
       /etc/networks
              networks database file

CONFORMING TO
       BSD 4.3

SEE ALSO
       getprotoent(t), getservent(t), networks(s)
       RFC 1101



BSD                         1993-05-15               GETNETENT(T)