setnetent(3)setnetent(3)NAME
setnetent, setnetent_r, endnetent, endnetent_r - Open, rewind, or close
the networks file
SYNOPSIS
#include <netdb.h>
void setnetent(
int stay_open );
void endnetent(
void );
[Tru64 UNIX] The following functions are supported in order to main‐
tain backward compatibility with previous versions of the operating
system. int setnetent_r(
int stay_open,
struct netent_data *net_data );
void endnetent_r(
struct netent_data *net_data );
The following definition of the setnetent() function does not conform
to current standards and is supported only for backward compatibility
(see standards(5)): int setnetent(
int stay_open );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
setnetent(): XNS4.0, XNS5.0
endnetent(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Specifies a value that indicates when to close the networks file. Spec‐
ifying a value of 0 (zero) closes the networks file after each call to
the getnetent() function. Specifying a nonzero value leaves the net‐
works database file open after each call. [Tru64 UNIX] For setne‐
tent_r() and endnetent_r() only, this points at a structure where set‐
netent_r() and endnetent_r() store information about the networks file.
DESCRIPTION
The setnetent() (set network entry) function opens the either the local
/etc/networks file or the NIS distributed networks file and sets the
file marker at the beginning of the file. To determine which file or
files to search, and in which order, the system uses the switches in
the /etc/svc.conf file.
The endnetent() function closes the networks file, previously opened
with the getnetent(), getnetbyaddr(), setnetent(), or getnetbyname()
function.
If the setnetent() function is called with a non-zero stay_open parame‐
ter, the connection remains until the endnetent() or exit() functions
are called.
NOTES
[Tru64 UNIX] The setnetent_r() function is the reentrant version of
the setnetent() function. It is supported in order to maintain back‐
ward compatibility with previous versions of the operating system. Upon
successful completion, the setnetent_r() function returns a value of 0
(zero). Otherwise, it returns a value of -1.
[Tru64 UNIX] Note that when you first call the setnetent_r() function,
you must set to NULL the net_fp field of the netent_data structure. The
netdb.h header file defines the netent_data structure.
[Tru64 UNIX] The endnetent_r() function is the reentrant version of
the endnetent() function. It is supported in order to maintain back‐
ward compatibility with previous versions of the operating system. The
netdb.h header file defines the netent_data structure.
RETURN VALUES
Upon successful completion, the backward compatible version of the set‐
netent() function returns a value of 1. Otherwise, it returns a value
of 0 (zero).
The setnetent(), endnetent(), and endnetent_r() functions do not return
a value.
ERRORS
Current industry standards do not define error values for the setne‐
tent() and endnetent() functions.
[Tru64 UNIX] If any of the following conditions occurs, the setne‐
tent_r() function sets errno to the corresponding value: If net_data is
invalid.
In addition, the setnetent(), backward compatible version of setne‐
tent(), and setnetent_r() functions can fail to open the file. In this
case, errno will be set to the appropriate value.
FILES
This file is the Internet network name database file. Each record in
the file occupies a single line and has three fields: the official net‐
work name, the network number, and alias. The database service selec‐
tion configuration file.
SEE ALSO
Functions: getnetbyaddr(3), getnetbyname(3), getnetent(3).
Files: networks(4), svc.conf(4).
Networks: nis_intro(7).
Standards: standards(5).
Network Programmer's Guide
setnetent(3)