Index for Section 3

Alphabetical listing for S

Bottom of page

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 standards
  as follows:

  setservent(): XNS4.0, XNS5.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.

SEE ALSO
  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