Index for Section 3

Alphabetical listing for S

Bottom of page

setservent(3)
NAME
  setservent, setservent_r - Open or rewind the services file

LIBRARY
  Standard C Library (libc.so, libc.a)

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);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  setservent():	 XNS4.0

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

PARAMETERS
  stay_open 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.

  serv_data [Tru64 UNIX]  Points to a structure where setservent_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 backward
  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 values.

  [Tru64 UNIX]	Upon successful completion, the setservent() function
  included for backward compatibility returns a 1 for success.	Otherwise, 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 setservent_r()
  function sets errno to the corresponding value:

  EINVAL    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
  /etc/services
	    Contains service names.

  /etc/svc.conf
	    The database service selection configuration file.

RELATED INFORMATION
  Functions: endservent(3), getservbyname(3), getservbyport(3),
  getservent(3).

  Files: services(4), svc.conf(4).

  Networks: nis_intro(7).

  Standards: standards(5).

Index for Section 3

Alphabetical listing for S

Top of page