setprotoent man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

setprotoent(3)							setprotoent(3)

NAME
       setprotoent, setprotoent_r - Open or rewind the protocols file

SYNOPSIS
       #include <netdb.h>

       void setprotoent
	       int stay_open );

       [Tru64  UNIX]  The following function is supported in order to maintain
       backward compatibility with previous versions of the operating  system:
       int setprotoent_r
	       int stay_open,
	       struct protoent_data *proto_data );

       The following definition of the setprotoent() function does not conform
       to current standards and is supported only for  backward	 compatibility
       (see standards(5)): int setprotoent(
	       int stay_open );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       setprotoent():  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 protocols file. Specifying a value of 0
       (zero) causes the file to be closed after  each	call  to  the  setpro‐
       toent() function.  Specifying a nonzero value allows the protocols file
       to remain open after each function.  [Tru64 UNIX]  For  setprotoent_r()
       only,  this points at a structure where setprotoent_r() stores informa‐
       tion about the protocols file.

DESCRIPTION
       The setprotoent() (set protocol entry) function opens either the	 local
       /etc/protocols  file or the NIS distributed protocols file and sets the
       file marker to 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 setprotoent_r() function is the reentrant version  of
       the setprotoent() function.  It is supported in order to maintain back‐
       ward compatibility with previous	 versions  of  the  operating  system.
       Upon  successful	 completion,  the  setprotoent_r()  function returns a
       value of 0 (zero). Otherwise, it returns a value of -1.

       [Tru64 UNIX]  Note that before calling the setprotoent_r() function for
       the  first  time,  you  must zero-fill the protoent_data structure. The
       netdb.h header file defines the protoent_data structure.

RETURN VALUES
       [Tru64 UNIX]  Upon successful completion, the version of	 setprotoent()
       provided	 for  backward compatibility returns a value of 1.  Otherwise,
       it returns a value of 0 (zero).

ERRORS
       Current industry standards do not define error values for  the  setpro‐
       toent() function.

       [Tru64  UNIX]  If  any  of the following conditions occurs, the setpro‐
       toent_r()  function  sets  errno	 to  the  corresponding	  value:   The
       proto_data parameter is invalid.

       In  addition, the setprotoent(), backward compatible version of setpro‐
       toent(), and setprotoent_r() functions can fail to open the  file.   In
       this case, errno will be set to the failure.

FILES
       Contains the protocol names.  The database service selection configura‐
       tion file.

SEE ALSO
       Functions: endprotoent(3), getprotobyname(3), getprotobynumber(3), get‐
       protoent(3).

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

       Networks: nis_intro(7).

       Standards: standards(5).

       Network Programmer's Guide

								setprotoent(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net