unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.2BSD)
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)
       long net;

       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 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 is found, or until
       EOF is encountered.  Network numbers are supplied in host order.

FILES
       /etc/networks

SEE ALSO
       networks(5)

DIAGNOSTICS
       Null pointer (0) 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 under-
       stood.  Expecting network numbers to fit in no more  than  32  bits  is
       probably naive.



4th Berkeley Distribution       9 February 1983                  GETNETENT(3N)