View Source: getnetent(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

GETNETENT
!!!GETNETENT
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
FILES
CONFORMING TO
SEE ALSO
----
!!NAME


getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - get network entry
!!SYNOPSIS


__#include
__''name''__);
struct netent *getnetbyaddr(long__ ''net''__, int__ ''type''__);
void setnetent(int__ ''stayopen''__);
void endnetent(void);
__
!!DESCRIPTION


The __getnetent()__ function reads the next line from the
file ''/etc/networks'' 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
'''' 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.


''n_aliases''


A zero terminated list of alternative names for the
network.


''n_addrtype''


The type of the network number; always AF_INET.


''n_net''


The network number in host byte order.
!!RETURN VALUE


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


/etc/networks networks database file
!!CONFORMING TO


BSD 4.3
!!SEE ALSO


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

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:22 am by "perry"

Edit PageHistory Diff Info LikePages