Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GETRPCENT(3)	       FreeBSD Library Functions Manual		  GETRPCENT(3)

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

SYNOPSIS
     #include <rpc/rpc.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 a line in the rpc program number	database, /etc/rpc:

       struct rpcent {
	       char    *r_name;	       /* name of server for this rpc program */
	       char    **r_aliases;    /* alias	list */
	       int     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 database will not be	closed after each call to getrpcent()
     (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

DIAGNOSTICS
     A NULL pointer is returned	on EOF or error.

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

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

FreeBSD	13.0			 June 5, 2013			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | FILES | DIAGNOSTICS | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getrpcent&sektion=3&manpath=OpenBSD+6.9>

home | help