|
from small one page howto to huge articles all in one place
poll results
Last additions:
May 25th. 2007:
|
You are here: manpages
GETNETENT
Section: Linux Programmer's Manual (3) Updated: 1993-05-15 Index
Return to Main Contents
NAME
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent -
get network entry
SYNOPSIS
#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
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
endnetent()
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 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
4.3BSD, POSIX.1-2001.
SEE ALSO
getprotoent(3),
getservent(3),
networks(5)
RFC 1101
COLOPHON
This page is part of release 3.05 of the Linux
man-pages
project.
A description of the project,
and information about reporting bugs,
can be found at
http://www.kernel.org/doc/man-pages/.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- FILES
-
- CONFORMING TO
-
- SEE ALSO
-
- COLOPHON
-
Please read "Why adblockers are bad".
Ärger mit Freenet.de
|
other Ads
Other free services
.
.
|