getnetent(3N)                    UNIX System V                    getnetent(3N)


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

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

DESCRIPTION
      getnetent, getnetbyname, and getnetbyaddr each return a pointer to an
      object with the following structure containing the broken-out fields of a
      line in the network data base, /etc/networks.

      The structure netent include the following members:

            char     *nname;          /* official name of net */
            char     **naliases;      /* alias list */
            int      naddrtype;       /* net type */
            unsigned long  nnet;      /* network 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 getnetbyaddr 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.





10/89                                                                    Page 1

getnetent(3N)                    UNIX System V                    getnetent(3N)


FILES
      /etc/networks

SEE ALSO
      networks(4)

DIAGNOSTICS
      A NULL pointer is returned on EOF or error.

NOTES
      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.










































Page 2                                                                    10/89