GETRPCENT(3)            NetBSD Library Functions Manual           GETRPCENT(3)

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

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <rpc/rpc.h>

     struct rpcent *
     getrpcent(void);

     struct rpcent *
     getrpcbyname(const 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 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 alternative 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 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.

NetBSD 5.0_STABLE               August 16, 2004              NetBSD 5.0_STABLE
