endnetent man page on OSF1

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

setnetent(3)							  setnetent(3)

NAME
       setnetent, setnetent_r, endnetent, endnetent_r - Open, rewind, or close
       the networks file

SYNOPSIS
       #include <netdb.h>

       void setnetent(
	       int stay_open );

       void endnetent(
	       void );

       [Tru64 UNIX]  The following functions are supported in order  to	 main‐
       tain  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 );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces documented on this reference page conform to industry	 stan‐
       dards 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.

PARAMETERS
       Specifies a value that indicates when to close the networks file. Spec‐
       ifying  a value of 0 (zero) closes the networks file after each call to
       the getnetent() function.  Specifying a nonzero value leaves  the  net‐
       works  database	file  open  after each call.  [Tru64 UNIX]  For setne‐
       tent_r() and endnetent_r() only, this points at a structure where  set‐
       netent_r() and endnetent_r() store information about the networks file.

DESCRIPTION
       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 parame‐
       ter, the connection remains until the endnetent() or  exit()  functions
       are called.

NOTES
       [Tru64  UNIX]  The  setnetent_r()  function is the reentrant version of
       the setnetent() function.  It is supported in order to  maintain	 back‐
       ward 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	 back‐
       ward compatibility with previous versions of the operating system.  The
       netdb.h header file defines the netent_data structure.

RETURN VALUES
       Upon successful completion, the backward compatible version of the set‐
       netent()	 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.

ERRORS
       Current	industry  standards  do not define error values for the setne‐
       tent() and endnetent() functions.

       [Tru64 UNIX]  If any of the following  conditions  occurs,  the	setne‐
       tent_r() function sets errno to the corresponding value: If net_data is
       invalid.

       In addition, the setnetent(), backward  compatible  version  of	setne‐
       tent(), and setnetent_r() functions can fail to open the file.  In this
       case, errno will be set to the appropriate value.

FILES
       This file is the Internet network name database file.  Each  record  in
       the file occupies a single line and has three fields: the official net‐
       work name, the network number, and alias.  The database service	selec‐
       tion configuration file.

SEE ALSO
       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)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

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