endrpcent man page on SuSE

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

GETRPCENT(3)		   Linux Programmer's Manual		  GETRPCENT(3)

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

SYNOPSIS
       #include <netdb.h>

       struct rpcent *getrpcent(void);

       struct rpcent *getrpcbyname(char *name);

       struct rpcent *getrpcbynumber(int number);

       void setrpcent(int stayopen);

       void endrpcent(void);

DESCRIPTION
       getrpcent(), getrpcbyname(), and getrpcbynumber() each return a pointer
       to  an  object  with  the following structure containing the broken-out
       fields of an entry in the RPC program number data base.

	   struct rpcent {
	       char  *r_name;	  /* name of server for this RPC program */
	       char **r_aliases;  /* alias list */
	       long   r_number;	  /* RPC program number */
	   };

       The members of this structure are:

	   r_name      The name of the server for this RPC program.

	   r_aliases   A NULL-terminated list of alternate names for  the  RPC
		       program.

	   r_number    The RPC program number for this service.

       getrpcent()  reads  the	next entry from the database.  A connection is
       opened to the database if necessary.

       setrpcent() function opens a connection to the database, and  sets  the
       next  entry to the first entry.	If stayopen is non-zero, then the con‐
       nection to the database will not be closed between calls to one of  the
       getrpc*() functions.

       The endrpcent() function closes the connection to the database.

       getrpcbyname() and getrpcbynumber() sequentially search from the begin‐
       ning of the file until a matching RPC program name or program number is
       found, or until end-of-file is encountered.

RETURN VALUE
       On  success, getrpcent(), getrpcbyname(), and getrpcbynumber() return a
       pointer toa statically allocated rpcent structure.  A NULL  pointer  is
       returned on EOF or error.

FILES
       /etc/rpc
	      RPC program number database.

CONFORMING TO
       Not in POSIX.1-2001.  Present on the BSDs, Solaris, and many other sys‐
       tems.

BUGS
       All information is contained in a static area so it must be  copied  if
       it is to be saved.

SEE ALSO
       getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)

COLOPHON
       This  page  is  part of release 3.15 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

				  2008-08-19			  GETRPCENT(3)
[top]

List of man pages available for SuSE

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