*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> getnetent (3)              



NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <netdb.h>

       struct netent *getnetent(void);

       struct netent *getnetbyname(const char *name);

       struct netent *getnetbyaddr(long net, int type);

       void setnetent(int stayopen);

       void endnetent(void);

DESCRIPTION    [Toc]    [Back]

       The getnetent() function reads the next line from  the  file  /etc/net-
       works  and  returns a structure netent containing the broken out fields
       from the line.  The /etc/networks file is opened if necessary.

       The getnetbyname() function returns a netent  structure	for  the  line
       from /etc/networks that matches the network name.

       The  getnetbyaddr()  function  returns  a netent structure for the line
       that matches the network number net of type type.

       The setnetent() function opens and rewinds the /etc/networks file.   If
       stayopen is true (1), then the file will not be closed between calls to
       getnetbyname() and getnetbyaddr().

       The endservent() function closes /etc/networks.

       The netent structure is defined in <netdb.h> as follows:

	      struct netent {
		      char    *n_name;		/* official network name */
		      char    **n_aliases;	/* alias list */
		      int     n_addrtype;	/* net address type */
		      unsigned long int n_net;	/* network number */

       The members of the netent structure are:

       n_name The official name of the network.

	      A zero terminated list of alternative names for the network.

	      The type of the network number; always AF_INET.

       n_net  The network number in host byte order.

RETURN VALUE    [Toc]    [Back]

       The getnetent(), getnetbyname() and getnetbyaddr() functions return the
       netent  structure,  or  a NULL pointer if an error occurs or the end of
       the file is reached.

FILES    [Toc]    [Back]

       /etc/networks	       networks database file

CONFORMING TO    [Toc]    [Back]

       BSD 4.3

SEE ALSO    [Toc]    [Back]

       getprotoent(3), getservent(3), networks(5)
       RFC 1101

BSD				  1993-05-15			  GETNETENT(3)
[ Back ]
 Similar pages
Name OS Title
getnetbyname_r Tru64 Get a network entry by name
getnetent_r Tru64 Get a network entry
getnetbyname Tru64 Get a network entry by name
getnetent Tru64 Get a network entry
gethostbyaddr FreeBSD get network host entry
getnetgrent Tru64 Get network group entry
endhostent NetBSD get network host entry
endhostent OpenBSD get network host entry
getnetgrent IRIX get NIS network group entry
sethostent NetBSD get network host entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service