GETNETENT
Section: Linux Programmer's Manual (3)
Updated: May 15, 1993
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 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.
- 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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- FILES
-
- CONFORMING TO
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 12:23:38 GMT, March 22, 2025