getrpcbynumber man page on Tru64

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

getrpcent(3)							  getrpcent(3)

NAME
       getrpcent, getrpcbynumber, getrpcbyname, setrpcent, endrpcent - get rpc
       entry

SYNOPSIS
       #include </rpc/netdb.h>

       struct rpcent *getrpcent(void ); struct rpcent *getrpcbynumber(int num‐
       ber  );	struct	rpcent	*getrpcbyname(char *name ); void setrpcent(int
       stayopen ); void endrpcent(void );

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

DESCRIPTION
       The getrpcent(), getrpcbynumber(), and getrpcbyname() functions	return
       pointers	 to an object with the following structure containing the bro‐
       ken-out fields of a line in the rpc database:

       struct  rpcent {		      /* see getrpcent(3) */
	       char    *r_name;
	       char    **r_aliases;   /* alias list */
	       int     r_number;      /* rpc program number */ }; struct group
       *getrpcent(), *getrpcbynumber(), *getrpcbyname();

       The  members of this structure are: The name of the rpc.	 A zero-termi‐
       nated list of alternate names for the rpc.  The rpc program number  for
       the rpc.

       If  the	stayopen option on the setrpcent() subroutine is null, the rpc
       database is opened. Otherwise, setrpcent() has the effect of  rewinding
       the rpc database. The endrpcent() subroutine may be called to close the
       rpc file when processing is complete.

       The getrpcent() subroutine simply  reads	 the  next  line  while	 getr‐
       pcbynumber()  and getrpcbyname() search until a matching gid or name is
       found (or until EOF is encountered). The getrpcent() subroutine keeps a
       pointer in the database, allowing successive calls to be used to search
       the entire file.

       A call to setrpcent() must be made before a  while  loop	 using	getrp‐
       cent()  in  order  to perform initialization and an endrpcent() must be
       used after the loop.  Both  getrpcbynumber()  and  getrpcbyname()  make
       calls to setrpcent() and endrpcent().

NOTES
       The  getrpcent(), getrpcbynumber(), and getrpcbyname() functions return
       pointers to thread-specific data. Subsequent calls to  these  functions
       from the same thread overwrite this data.

       If  NIS	(formerly  YP)	is  running,  getrpcent()  does not return the
       entries in any particular order. See the Network	 Administration:  Ser‐
       vices for NIS setup information.

       The  rpc information is stored locally in /etc/rpc or is distributed by
       NIS, or both. To determine which file or files to search, and in	 which
       order, the system uses the switches in the /etc/svc.conf file.

RETURN VALUES
       A null pointer (0) is returned on EOF or error.

FILES
       /etc/rpc

SEE ALSO
       rpc(4), svc.conf(4)

								  getrpcent(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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