setservent(3)setservent(3)NAME
setservent, setservent_r - Open or rewind the services file
SYNOPSIS
#include <netdb.h>
void setservent(
int stay_open );
[Tru64 UNIX] The following function is supported in order to maintain
backward compatibility with previous versions of the operating system:
int setservent_r(
int stay_open,
struct servent_data *serv_data );
[Tru64 UNIX] The following function is supported in order to maintain
backward compatibility with previous versions of the operating system:
int setservent(
int stay_open );
LIBRARY
Standard C Library (libc)
Curses Library (libcurses)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
setservent(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Indicates when to close the services file. Specifying a value of 0
(zero) causes the file to be closed after each call to the getservent()
function. Specifying a nonzero value allows the file to remain open
after each call. [Tru64 UNIX] Points to a structure where setser‐
vent_r() stores information about the services file.
DESCRIPTION
The setservent() (set service entry) function opens either the local
/etc/services file or the NIS distributed services 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.
NOTES
[Tru64 UNIX] The setservent_r() function is the reentrant version of
the setservent() function. It is supported in order to maintain back‐
ward compatibility with previous versions of the operating system. Upon
successful completion, the setservent_r() function returns a value of 0
(zero). Otherwise, it returns a value of -1.
[Tru64 UNIX] Before calling the setservent_r() function for the first
time, you must zero-fill the servent_data structure. The netdb.h header
file defines the servent_data structure.
RETURN VALUES
Current industry standards for setservent() do not define return val‐
ues.
[Tru64 UNIX] Upon successful completion, the setservent() function
included for backward compatibility returns a 1 for success. Other‐
wise, it returns a value of 0 (zero).
ERRORS
Current industry standards for setservent() do not define error values.
[Tru64 UNIX] If any of the following conditions occurs, the setser‐
vent_r() function sets errno to the corresponding value: If serv_data
is invalid.
In addition, the setservent() and setservent_r() functions can fail to
open the file. In this case, errno will be set to the failure.
FILES
Contains service names. The database service selection configuration
file.
SEE ALSO
Functions: endservent(3), getservbyname(3), getservbyport(3), getser‐
vent(3).
Files: services(4), svc.conf(4).
Networks: nis_intro(7).
Standards: standards(5).
setservent(3)