setnetent, setnetent_r, endnetent, endnetent_r - Open,
rewind, or close the networks file
#include <netdb.h>
void setnetent(
int stay_open );
void endnetent(
void );
[Tru64 UNIX] The following functions are supported in
order to maintain 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 );
Standard C Library (libc)
Interfaces documented on this reference page conform to
industry standards 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.
Specifies a value that indicates when to close the networks
file. Specifying a value of 0 (zero) closes the networks
file after each call to the getnetent() function.
Specifying a nonzero value leaves the networks database
file open after each call. [Tru64 UNIX] For setnetent_r()
and endnetent_r() only, this points at a structure
where setnetent_r() and endnetent_r() store information
about the networks file.
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 parameter, the connection remains until the endnetent()
or exit() functions are called.
[Tru64 UNIX] The setnetent_r() function is the reentrant
version of the setnetent() function. It is supported in
order to maintain backward 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 backward compatibility with previous
versions of the operating system. The netdb.h header file
defines the netent_data structure.
Upon successful completion, the backward compatible version
of the setnetent() 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.
Current industry standards do not define error values for
the setnetent() and endnetent() functions.
[Tru64 UNIX] If any of the following conditions occurs,
the setnetent_r() function sets errno to the corresponding
value: If net_data is invalid.
In addition, the setnetent(), backward compatible version
of setnetent(), and setnetent_r() functions can fail to
open the file. In this case, errno will be set to the
appropriate value.
This file is the Internet network name database file. Each
record in the file occupies a single line and has three
fields: the official network name, the network number, and
alias. The database service selection configuration file.
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)
[ Back ] | 