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



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

SYNOPSIS
   Headers
     For -systype sysv:

     #include <bsd/sys/types.h>
     #include <bsd/netdb.h>

     For -systype bsd43:

     #include <netdb.h>

   Declarations
     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 containing
     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 */
              unsigned 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.



                         Printed 1/15/91                   Page 1

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



     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 getnetbyname or getnetbyaddr.

     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
     Null pointer (0) returned on EOF or error.

ERRORS
     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.  Expecting network numbers to fit
     in no more than 32 bits is probably naive.

NOTE
     When these routines are used in a program which is compiled
     in -systype sysv, they are not resolved by libc.a.  See
     intro(3-SysV) for more information.



















 Page 2                  Printed 1/15/91