getrpcent(3) - NetBSD Manual Pages

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


RETURN VALUES

     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 10.99                    August 16, 2004                   NetBSD 10.99