unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETNETENT(3N)                                                    GETNETENT(3N)



NAME
       getnetent,  getnetbyaddr, getnetbyname, setnetent, endnetent - get net-
       work entry

SYNOPSIS
       #include <&lt;netdb.h>&gt;

       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 */
                   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 neces-
       sary.

       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 setne-
       tent() (either directly, or indirectly through one of the  other  "get-
       net" calls).

       endnetent() closes the file.

       getnetbyname()  and  getnetbyaddr() sequentially search from the begin-
       ning of the file until a matching net name or net address and  type  is
       found,  or  until end-of-file is encountered.  Network numbers are sup-
       plied in host order.

FILES
       /etc/networks

SEE ALSO
       networks(5), ypserv(8)

DIAGNOSTICS
       A NULL pointer is returned on end-of-file 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.



                               14 December 1987                  GETNETENT(3N)