GETNETENT(3N-SVR4)  RISC/os Reference Manual   GETNETENT(3N-SVR4)



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 *n_name;        /* official name of net */
               char **n_aliases;    /* alias list */
               int  n_addrtype;     /* net number type */
               long n_net;          /* 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 AF_INET.

          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.




                        Printed 11/19/92                   Page 1

GETNETENT(3N-SVR4)  RISC/os Reference Manual   GETNETENT(3N-SVR4)



     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.

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.





























 Page 2                 Printed 11/19/92