getnetent(3N)           LIBRARY FUNCTIONS           getnetent(3N)



NAME
     getnetent, getnetbyaddr, getnetbyname, setnetent,  endnetent
     - get network entry

SYNOPSIS
     #include <netdb.h>
     struct netent *getnetent()
     struct netent *getnetbyname(name)
     char *name;
     struct netent *getnetbyaddr(net, type)
     long net;
     int type;
     setnetent(stayopen)
     int stayopen;
     endnetent()

DESCRIPTION
     getnetent(), getnetbyname(), and getnetbyaddr() each  return
     a pointer to an object with the following structure contain-
     ing the broken-out fields of a  line  in  the  network  data
     base, /etc/networks.
          struct    netent {
               char *nname;  /* official name of net */
               char **naliases;   /* alias list */
               int  naddrtype;    /* net number type */
               long nnet;         /* net number */
          };
     The members of this structure are:

          n_name              The official name of the network.

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

          n_addrtype          The  type  of  the  network  number
                              returned; currently only AFINET.

          n_net               The   network   number.     Network
                              numbers  are  returned  in  machine
                              byte order.
     getnetent() reads the next line of  the  file,  opening  the
     file  if necessary.  setnetent() opens and rewinds the file.
     If the stayopen flag is non-zero, the net data base will not
     be  closed  after each call to getnetent() (either directly,
     or indirectly through one  of  the  other  "getnet"  calls).
     endnetent()  closes  the  file.   getnetbyname() and getnet-
     byaddr() sequentially search from the beginning of the  file
     until  a matching net name or net address and type is found,
     or until EOF is encountered.  Network numbers  are  supplied
     in host order.





                                                                1

getnetent(3N)           LIBRARY FUNCTIONS           getnetent(3N)



FILES
     /etc/networks

SEE ALSO
     networks(4)

DIAGNOSTICS
     A NULL pointer is returned on EOF or error.

BUGS
     All information is contained in a static area so it must  be
     copied  if it is to be saved.  Only Internet network numbers
     are currently understood.










































                                                                2