NOTE: click here if you get an empty page.

GETRPCENT(3)							  GETRPCENT(3)

NAME
       getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

SYNOPSIS
       #include <netdb.h>

       struct rpcent *getrpcent()

       struct rpcent *getrpcbyname(name)
       char *name;

       struct rpcent *getrpcbynumber(number)
       int number;

       setrpcent (stayopen)
       int stayopen;

       endrpcent ()

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

	      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 zero terminated list  of  alternate	 names
				  for the rpc program.
	      r_number		  The rpc program number for this service.

       getrpcent() reads the next line of the file, opening the file if neces-
       sary.

       setrpcent() opens and rewinds the file.	If the stayopen flag  is  non-
       zero,  the  net	data base will not be closed after each call to getrp-
       cent() (either  directly,  or  indirectly  through  one	of  the	 other
       "getrpc" calls).

       endrpcent() closes the file.

       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.

FILES
       /etc/rpc

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

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

DIAGNOSTICS
       A NULL pointer is returned on EOF or error.

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

				  1987-12-14			  GETRPCENT(3)